@hagicode/hagiscript 0.1.6-dev.39.1.abb22ea → 0.1.6-dev.41.1.c7efd72

package/README.md

@@ -217,7 +217,7 @@ When fallback is triggered, HagiScript logs `Fallback used: ...` during executio
 
 ### Runtime Package Management
 
-`hagiscript runtime` adds a manifest-driven package manager for the broader `hagicode-runtime` contract. By default it loads `runtime/manifest.yaml` from the installed package, resolves the managed runtime root to `~/.hagicode/runtime`, and keeps all mutable state under that root unless `--runtime-root <path>` overrides it for a specific install, deployment mode, or automation run.
+`hagiscript runtime` adds a manifest-driven package manager for the broader `hagicode-runtime` contract. By default it loads `runtime/manifest.yaml` from the installed package, resolves the managed runtime root to `~/.hagicode/runtime`, then splits that managed runtime into a program home and a mutable runtime-data home unless `--runtime-root <path>` overrides the base location for a specific install, deployment mode, or automation run.
 
 ```bash
 hagiscript runtime install
@@ -231,21 +231,51 @@ The packaged runtime manifest aligns its default component boundaries with HagiC
 
 - Node is governed as a Desktop-aligned Node 22 toolchain component.
 - `.NET` is modeled as a Desktop-aligned 10.0 runtime component.
-- Mutable npm packages are installed into a managed prefix under the selected runtime root instead of the immutable Node payload or host-global npm locations.
+- Mutable npm packages, including the managed `pm2` binary, are installed into a managed prefix under the runtime program home instead of the immutable Node payload or host-global npm locations.
 - `code-server` and `omniroute` stay grouped as vendored bundled-runtime components rather than npm-managed packages.
 
 The runtime layout is explicit and stable for downstream consumers:
 
 ```text
 <runtime-root>/
-  bin/
-  config/
-  logs/
-  data/
-  state.json
+  program/
+    bin/
+    npm/
+    components/
+  runtime-data/
+    config/
+    logs/
+    data/
+    components/
+    state.json
 ```
 
-`state.json` is the canonical contract for install, update, remove, and downstream inspection. Use `hagiscript runtime state --json` instead of probing files directly when Desktop, local bootstrap flows, or automation needs to know which components are installed, which managed paths are active, and whether the last lifecycle run succeeded.
+`hagiscript runtime state --json` is the canonical contract for install, update, remove, and downstream inspection. It reports the resolved runtime home, runtime data root, per-component runtime data homes, and derived PM2 homes so Desktop, local bootstrap flows, or automation does not need to probe files directly.
+
+Runtime lifecycle scripts and managed PM2 services receive the same public runtime environment contract:
+
+- `HAGICODE_RUNTIME_HOME` points to the runtime program home.
+- `HAGICODE_RUNTIME_DATA_HOME` points to the current component's writable runtime data home.
+- `PM2_HOME` defaults to a child directory beneath `HAGICODE_RUNTIME_DATA_HOME`.
+- `PATH` is rebuilt so the managed Node runtime, managed npm prefix, and managed wrappers take precedence over the ambient shell environment.
+
+### Managed PM2 Service Commands
+
+`hagiscript pm2` manages the runtime-scoped `omniroute` and `code-server` services through the PM2 binary installed by `hagiscript runtime install`.
+
+```bash
+hagiscript pm2 omniroute start
+hagiscript pm2 omniroute status
+hagiscript pm2 code-server stop
+```
+
+Each PM2 command resolves the runtime manifest first, loads the canonical runtime homes, derives a component-scoped `PM2_HOME`, and executes the managed PM2 binary from `<runtime-home>/npm`. It does not rely on a system PM2 or a system Node on the ambient shell `PATH`.
+
+The packaged `runtime/manifest.yaml` can override:
+
+- runtime-level `paths.runtimeHome`, `paths.runtimeDataRoot`, `paths.componentDataRoot`, and `paths.defaultPm2Home`
+- component-level `runtimeDataDir`
+- service-level `pm2.appName`, `pm2.cwd`, `pm2.script`, `pm2.args`, `pm2.env`, and `pm2.pm2Home`
 
 The package also ships a thin `hagicode-runtime` wrapper binary that delegates to `hagiscript runtime ...` for automation that prefers a runtime-oriented entrypoint:
 

package/README_cn.md

@@ -197,6 +197,61 @@ Changed: 1
 
 如果触发了回退，Hagiscript 会在执行期间输出 `Fallback used: ...`，并在最终摘要中记录 `Fallback detail: ...`，这样 CI 或桌面端自动化就能明确知道哪个镜像失败了、是否切到了官方源，以及官方源重试是否成功。
 
+### Runtime 包管理
+
+`hagiscript runtime` 提供了面向 `hagicode-runtime` 的 manifest 驱动包管理能力。默认情况下，它会加载安装包内置的 `runtime/manifest.yaml`，把托管运行时根目录解析为 `~/.hagicode/runtime`，然后在该根目录下拆分出只读程序目录和可写运行时数据目录；如果某次部署或自动化需要独立路径，可通过 `--runtime-root <path>` 覆盖基础位置。
+
+```bash
+hagiscript runtime install
+hagiscript runtime install --components node,npm-packages --dry-run
+hagiscript runtime update --runtime-root /opt/hagicode/runtime --check-only
+hagiscript runtime remove --components code-server --purge
+hagiscript runtime state --json
+```
+
+默认运行时布局如下：
+
+```text
+<runtime-root>/
+  program/
+    bin/
+    npm/
+    components/
+  runtime-data/
+    config/
+    logs/
+    data/
+    components/
+    state.json
+```
+
+`hagiscript runtime state --json` 是安装、更新、删除与下游诊断的标准状态接口。它会输出解析后的运行时程序目录、运行时数据根目录、组件级 `HAGICODE_RUNTIME_DATA_HOME`，以及派生出的 `PM2_HOME`，下游工具不需要再自己探测文件系统。
+
+运行时脚本和 PM2 托管服务会共享同一套公开环境变量约定：
+
+- `HAGICODE_RUNTIME_HOME`：运行时程序目录
+- `HAGICODE_RUNTIME_DATA_HOME`：当前组件的可写运行时数据目录
+- `PM2_HOME`：默认位于 `HAGICODE_RUNTIME_DATA_HOME` 下的独立子目录
+- `PATH`：优先注入托管 Node 运行时、托管 npm 前缀和托管 wrapper，再继承当前 shell 的 PATH
+
+### PM2 托管服务命令
+
+`hagiscript pm2` 用于管理运行时作用域内的 `omniroute` 和 `code-server` 服务，底层始终调用 `hagiscript runtime install` 安装到托管 npm 前缀中的 PM2。
+
+```bash
+hagiscript pm2 omniroute start
+hagiscript pm2 omniroute status
+hagiscript pm2 code-server stop
+```
+
+每次 PM2 命令都会先解析运行时 manifest，计算规范化的运行时目录和组件数据目录，再以组件级 `PM2_HOME` 和托管 Node-first PATH 调用 `<runtime-home>/npm` 下的 PM2；它不会依赖系统预装的 PM2 或系统 Node。
+
+`runtime/manifest.yaml` 现在支持以下覆盖项：
+
+- 运行时级别：`paths.runtimeHome`、`paths.runtimeDataRoot`、`paths.componentDataRoot`、`paths.defaultPm2Home`
+- 组件级别：`runtimeDataDir`
+- 服务级别：`pm2.appName`、`pm2.cwd`、`pm2.script`、`pm2.args`、`pm2.env`、`pm2.pm2Home`
+
 在 ESM 项目中使用库 API：
 
 ```ts

package/dist/cli.js

@@ -5,6 +5,7 @@ import { Command } from "commander";
 import { createRuntimeInfo, packageVersion } from "./index.js";
 import { registerNpmSyncCommand } from "./commands/npm-sync-commands.js";
 import { registerNodeRuntimeCommands } from "./commands/node-runtime-commands.js";
+import { registerPm2Commands } from "./commands/pm2-commands.js";
 import { registerRuntimeCommands } from "./commands/runtime-commands.js";
 export function createCli() {
     const program = new Command();
@@ -21,6 +22,7 @@ export function createCli() {
     });
     registerNodeRuntimeCommands(program);
     registerNpmSyncCommand(program);
+    registerPm2Commands(program);
     registerRuntimeCommands(program);
     program.action(() => {
         program.outputHelp();

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,YAAY,CAAC;SAClB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,OAAO,CAAC,cAAc,EAAE,eAAe,EAAE,8BAA8B,CAAC,CAAC;IAE5E,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mCAAmC,CAAC;SAChD,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEL,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAEjC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE;QAClB,OAAO,CAAC,UAAU,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IAC9C,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAC3B,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,eAAe,EAAE,EAAE,CAAC;IACtB,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAChC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,YAAY,CAAC;SAClB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,OAAO,CAAC,cAAc,EAAE,eAAe,EAAE,8BAA8B,CAAC,CAAC;IAE5E,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mCAAmC,CAAC;SAChD,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEL,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAEjC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE;QAClB,OAAO,CAAC,UAAU,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IAC9C,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAC3B,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,eAAe,EAAE,EAAE,CAAC;IACtB,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAChC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/pm2-commands.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerPm2Commands(program: Command): void;

package/dist/commands/pm2-commands.js

@@ -0,0 +1,54 @@
+import { InvalidArgumentError } from "commander";
+import { renderManagedPm2StatusText, runManagedPm2Command, supportedPm2Services } from "../runtime/pm2-manager.js";
+export function registerPm2Commands(program) {
+    program
+        .command("pm2")
+        .description("manage PM2-backed hagicode-runtime services")
+        .argument("<service>", "managed service name", parseManagedPm2Service)
+        .argument("<action>", "pm2 action", parseManagedPm2Action)
+        .option("--from-manifest <path>", "override the default runtime manifest")
+        .option("--runtime-root <path>", "managed runtime root override")
+        .action(async (service, action, options, command) => {
+        try {
+            const result = await runManagedPm2Command({
+                manifestPath: validatePathOption(options.fromManifest, "--from-manifest"),
+                runtimeRoot: validatePathOption(options.runtimeRoot, "--runtime-root"),
+                service,
+                action
+            });
+            process.stdout.write(`${renderManagedPm2StatusText(result)}\n`);
+        }
+        catch (error) {
+            command.error(formatPm2Error(error), { exitCode: 1 });
+        }
+    });
+}
+function parseManagedPm2Service(value) {
+    if (supportedPm2Services.includes(value)) {
+        return value;
+    }
+    throw new InvalidArgumentError(`Unsupported managed PM2 service "${value}". Supported services: ${supportedPm2Services.join(", ")}.`);
+}
+function parseManagedPm2Action(value) {
+    if (value === "start" || value === "stop" || value === "status") {
+        return value;
+    }
+    throw new InvalidArgumentError(`Unsupported PM2 action "${value}". Supported actions: start, stop, status.`);
+}
+function validatePathOption(value, optionName) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new InvalidArgumentError(`${optionName} must be a non-empty path.`);
+    }
+    if (normalized.includes("\0")) {
+        throw new InvalidArgumentError(`${optionName} contains an invalid null byte.`);
+    }
+    return normalized;
+}
+function formatPm2Error(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=pm2-commands.js.map

package/dist/commands/pm2-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm2-commands.js","sourceRoot":"","sources":["../../src/commands/pm2-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EAGrB,MAAM,2BAA2B,CAAA;AAOlC,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,6CAA6C,CAAC;SAC1D,QAAQ,CAAC,WAAW,EAAE,sBAAsB,EAAE,sBAAsB,CAAC;SACrE,QAAQ,CAAC,UAAU,EAAE,YAAY,EAAE,qBAAqB,CAAC;SACzD,MAAM,CAAC,wBAAwB,EAAE,uCAAuC,CAAC;SACzE,MAAM,CAAC,uBAAuB,EAAE,+BAA+B,CAAC;SAChE,MAAM,CACL,KAAK,EACH,OAA8B,EAC9B,MAAwB,EACxB,OAA0B,EAC1B,OAAgB,EAChB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;gBACxC,YAAY,EAAE,kBAAkB,CAAC,OAAO,CAAC,YAAY,EAAE,iBAAiB,CAAC;gBACzE,WAAW,EAAE,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,gBAAgB,CAAC;gBACtE,OAAO;gBACP,MAAM;aACP,CAAC,CAAA;YAEF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,0BAA0B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAA;QACvD,CAAC;IACH,CAAC,CACF,CAAA;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,IAAK,oBAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,KAA8B,CAAA;IACvC,CAAC;IAED,MAAM,IAAI,oBAAoB,CAC5B,oCAAoC,KAAK,0BAA0B,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtG,CAAA;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChE,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,IAAI,oBAAoB,CAC5B,2BAA2B,KAAK,4CAA4C,CAC7E,CAAA;AACH,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAyB,EACzB,UAAkB;IAElB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,oBAAoB,CAAC,GAAG,UAAU,4BAA4B,CAAC,CAAA;IAC3E,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,oBAAoB,CAAC,GAAG,UAAU,iCAAiC,CAAC,CAAA;IAChF,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC/D,CAAC"}

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export { verifyNodeRuntime, type NodeRuntimeVerificationResult } from "./runtime
 export { createNpmSyncPlan, loadNpmSyncManifest, normalizeGlobalInventory, syncNpmGlobals, validateNpmSyncManifest, type InstalledGlobalPackages, type NpmSyncActionKind, type NpmSyncActionResult, type NpmSyncCommandKind, type NpmSyncFallbackEvent, type NpmSyncFallbackPolicy, type NpmSyncManifest, type NpmSyncManifestEntry, type NpmSyncPlannedAction, type NpmSyncRuntimeMetadata, type NpmSyncSummary } from "./runtime/npm-sync.js";
 export { buildToolSyncPackageSet, builtInToolSyncCatalog, normalizeToolSyncEntry, validateToolSyncCatalog, type CustomAgentCliToolInput, type ToolSyncCatalogEntry, type ToolSyncGroupId, type ToolSyncPackageConstraint, type ToolSyncRequirement, type ToolSyncSelection } from "./runtime/tool-sync-catalog.js";
 export { getDefaultRuntimeManifestPath, loadRuntimeManifest, type LoadedRuntimeManifest, type RuntimeComponentDefinition, type RuntimeLifecyclePhase, type RuntimeManifestPaths } from "./runtime/runtime-manifest.js";
-export { defaultRuntimeRoot, getComponentConfigDirectory, getComponentManagedRoot, resolveRuntimePaths, type ResolvedRuntimePaths } from "./runtime/runtime-paths.js";
+export { defaultRuntimeRoot, getComponentConfigDirectory, getComponentLogsDirectory, getComponentManagedRoot, getComponentPm2Home, getComponentRuntimeDataHome, resolveRuntimePaths, type ResolvedRuntimePaths } from "./runtime/runtime-paths.js";
 export { createInitialRuntimeState, mergeRuntimeState, readRuntimeState, writeRuntimeState, type RuntimeComponentState, type RuntimeOperationState, type RuntimeState } from "./runtime/runtime-state.js";
+export { renderManagedPm2StatusText, resolveManagedPm2ServiceDefinition, runManagedPm2Command, supportedPm2Services, type ManagedPm2Action, type ManagedPm2CommandResult, type ManagedPm2CommandOptions, type ManagedPm2ServiceName, type ManagedPm2Status, type ResolvedManagedPm2ServiceDefinition } from "./runtime/pm2-manager.js";
+export { buildManagedRuntimeEnvironment, getManagedNpmBinDirectory, getManagedRuntimePathEntries, prependPathEntries } from "./runtime/runtime-executor.js";
 export { installRuntime, planRuntimeLifecycle, queryRuntimeState, removeRuntime, renderRuntimeStateText, runRuntimeLifecycle, updateRuntime, type RuntimeLifecycleOptions, type RuntimeLifecycleResult, type RuntimePlannedAction, type RuntimeStateReport } from "./runtime/runtime-manager.js";

package/dist/index.js

@@ -12,7 +12,9 @@ export { verifyNodeRuntime } from "./runtime/node-verify.js";
 export { createNpmSyncPlan, loadNpmSyncManifest, normalizeGlobalInventory, syncNpmGlobals, validateNpmSyncManifest } from "./runtime/npm-sync.js";
 export { buildToolSyncPackageSet, builtInToolSyncCatalog, normalizeToolSyncEntry, validateToolSyncCatalog } from "./runtime/tool-sync-catalog.js";
 export { getDefaultRuntimeManifestPath, loadRuntimeManifest } from "./runtime/runtime-manifest.js";
-export { defaultRuntimeRoot, getComponentConfigDirectory, getComponentManagedRoot, resolveRuntimePaths } from "./runtime/runtime-paths.js";
+export { defaultRuntimeRoot, getComponentConfigDirectory, getComponentLogsDirectory, getComponentManagedRoot, getComponentPm2Home, getComponentRuntimeDataHome, resolveRuntimePaths } from "./runtime/runtime-paths.js";
 export { createInitialRuntimeState, mergeRuntimeState, readRuntimeState, writeRuntimeState } from "./runtime/runtime-state.js";
+export { renderManagedPm2StatusText, resolveManagedPm2ServiceDefinition, runManagedPm2Command, supportedPm2Services } from "./runtime/pm2-manager.js";
+export { buildManagedRuntimeEnvironment, getManagedNpmBinDirectory, getManagedRuntimePathEntries, prependPathEntries } from "./runtime/runtime-executor.js";
 export { installRuntime, planRuntimeLifecycle, queryRuntimeState, removeRuntime, renderRuntimeStateText, runRuntimeLifecycle, updateRuntime } from "./runtime/runtime-manager.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,cAAc,EAEf,MAAM,cAAc,CAAC;AAQtB,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,WAAW;QACX,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,YAAY;KACrB,CAAC;AACJ,CAAC;AAED,OAAO,EACL,qCAAqC,EACrC,kBAAkB,EAClB,yBAAyB,EAG1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,uBAAuB,EAYxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EAOxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,EAKpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAIlB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EAKd,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,cAAc,EAEf,MAAM,cAAc,CAAC;AAQtB,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,WAAW;QACX,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,YAAY;KACrB,CAAC;AACJ,CAAC;AAED,OAAO,EACL,qCAAqC,EACrC,kBAAkB,EAClB,yBAAyB,EAG1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,uBAAuB,EAYxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EAOxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,EAKpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAIlB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,0BAA0B,EAC1B,kCAAkC,EAClC,oBAAoB,EACpB,oBAAoB,EAOrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,4BAA4B,EAC5B,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EAKd,MAAM,8BAA8B,CAAC"}

package/dist/runtime/pm2-manager.d.ts

@@ -0,0 +1,54 @@
+import type { CommandRunner } from "./command-launch.js";
+import { type LoadedRuntimeManifest, type RuntimeComponentDefinition } from "./runtime-manifest.js";
+import { type ResolvedRuntimePaths } from "./runtime-paths.js";
+export declare const supportedPm2Services: readonly ["omniroute", "code-server"];
+export type ManagedPm2ServiceName = (typeof supportedPm2Services)[number];
+export type ManagedPm2Action = "start" | "stop" | "status";
+export type ManagedPm2Status = "online" | "stopped" | "errored" | "missing" | "unknown";
+export interface ManagedPm2CommandOptions {
+    manifestPath?: string;
+    runtimeRoot?: string;
+    service: ManagedPm2ServiceName;
+    action: ManagedPm2Action;
+    runner?: CommandRunner;
+}
+export interface ResolvedManagedPm2ServiceDefinition {
+    service: ManagedPm2ServiceName;
+    component: RuntimeComponentDefinition;
+    manifestDir: string;
+    paths: ResolvedRuntimePaths;
+    appName: string;
+    cwd: string;
+    script: string;
+    args: string[];
+    env: Record<string, string>;
+    runtimeHome: string;
+    runtimeDataHome: string;
+    componentRoot: string;
+    componentConfigDir: string;
+    pm2Home: string;
+    pm2Binary: string;
+    nodePath: string;
+}
+export interface ManagedPm2CommandResult {
+    service: ManagedPm2ServiceName;
+    action: ManagedPm2Action;
+    appName: string;
+    cwd: string;
+    script: string;
+    runtimeHome: string;
+    runtimeDataHome: string;
+    pm2Home: string;
+    pm2Binary: string;
+    exists: boolean;
+    status: ManagedPm2Status;
+    pid: number | null;
+    stdout: string;
+    stderr: string;
+}
+export declare class ManagedPm2Error extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare function runManagedPm2Command(options: ManagedPm2CommandOptions): Promise<ManagedPm2CommandResult>;
+export declare function resolveManagedPm2ServiceDefinition(manifest: LoadedRuntimeManifest, paths: ResolvedRuntimePaths, service: ManagedPm2ServiceName): Promise<ResolvedManagedPm2ServiceDefinition>;
+export declare function renderManagedPm2StatusText(result: ManagedPm2CommandResult): string;

package/dist/runtime/pm2-manager.js

@@ -0,0 +1,260 @@
+import { access } from "node:fs/promises";
+import { basename, extname, join } from "node:path";
+import process from "node:process";
+import { runCommand } from "./command-launch.js";
+import { buildManagedRuntimeEnvironment, } from "./runtime-executor.js";
+import { getRuntimeExecutablePaths } from "./node-verify.js";
+import { loadRuntimeManifest } from "./runtime-manifest.js";
+import { getComponentConfigDirectory, getComponentManagedRoot, getComponentPm2Home, getComponentRuntimeDataHome, resolveManagedPath, resolveRuntimePaths } from "./runtime-paths.js";
+export const supportedPm2Services = ["omniroute", "code-server"];
+export class ManagedPm2Error extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ManagedPm2Error";
+    }
+}
+export async function runManagedPm2Command(options) {
+    const manifest = await loadRuntimeManifest({ manifestPath: options.manifestPath });
+    const paths = resolveRuntimePaths(manifest, { runtimeRoot: options.runtimeRoot });
+    const definition = await resolveManagedPm2ServiceDefinition(manifest, paths, options.service);
+    const runner = options.runner ?? runCommand;
+    switch (options.action) {
+        case "start":
+            await runPm2(definition, buildPm2StartArgs(definition), runner);
+            return readManagedPm2Status(definition, "start", runner);
+        case "stop":
+            await runPm2(definition, ["stop", definition.appName], runner);
+            return readManagedPm2Status(definition, "stop", runner);
+        case "status":
+            return readManagedPm2Status(definition, "status", runner);
+    }
+}
+export async function resolveManagedPm2ServiceDefinition(manifest, paths, service) {
+    assertSupportedPm2Service(service);
+    const component = manifest.componentMap.get(service);
+    if (!component) {
+        throw new ManagedPm2Error(`Runtime manifest does not define the ${service} service.`);
+    }
+    const componentRoot = getComponentManagedRoot(paths, component.name);
+    const runtimeDataHome = getComponentRuntimeDataHome(paths, component.name, component.runtimeDataDir);
+    const componentConfigDir = getComponentConfigDirectory(paths, component.name, component.runtimeDataDir);
+    const pm2Home = getComponentPm2Home(paths, component.name, component.runtimeDataDir, component.pm2?.pm2Home);
+    const script = resolveManagedPath(component.pm2?.script ?? defaultPm2Script(component.name), componentRoot);
+    const cwd = resolveManagedPath(component.pm2?.cwd ?? ".", componentRoot);
+    const nodePath = getRuntimeExecutablePaths(paths.nodeRuntime).nodePath;
+    const pm2Entrypoint = getManagedPm2Entrypoint(paths.npmPrefix);
+    await Promise.all([
+        validateManagedPath(script, `Managed launcher for ${service} is missing`),
+        validateManagedPath(cwd, `Managed working directory for ${service} is missing`),
+        validateManagedPath(pm2Entrypoint, "Managed PM2 binary is missing. Install the runtime npm-packages component first."),
+        validateManagedPath(nodePath, "Managed Node runtime is missing. Install the runtime node component first.")
+    ]);
+    return {
+        service,
+        component,
+        manifestDir: manifest.manifestDir,
+        paths,
+        appName: component.pm2?.appName ?? `hagicode-${component.name}`,
+        cwd,
+        script,
+        args: component.pm2?.args ?? [],
+        env: component.pm2?.env ?? {},
+        runtimeHome: paths.runtimeHome,
+        runtimeDataHome,
+        componentRoot,
+        componentConfigDir,
+        pm2Home,
+        pm2Binary: pm2Entrypoint,
+        nodePath
+    };
+}
+export function renderManagedPm2StatusText(result) {
+    return [
+        `Service: ${result.service}`,
+        `Action: ${result.action}`,
+        `App: ${result.appName}`,
+        `Status: ${result.status}`,
+        `Runtime home: ${result.runtimeHome}`,
+        `Runtime data home: ${result.runtimeDataHome}`,
+        `PM2 home: ${result.pm2Home}`,
+        `Script: ${result.script}`,
+        `Working directory: ${result.cwd}`,
+        `PM2 binary: ${result.pm2Binary}`,
+        `PID: ${result.pid ?? "n/a"}`
+    ].join("\n");
+}
+function assertSupportedPm2Service(service) {
+    if (supportedPm2Services.includes(service)) {
+        return;
+    }
+    throw new ManagedPm2Error(`Unsupported managed PM2 service "${service}". Supported services: ${supportedPm2Services.join(", ")}.`);
+}
+async function readManagedPm2Status(definition, action, runner) {
+    const result = await runPm2(definition, ["jlist"], runner);
+    const statusEntry = parsePm2Status(result, definition.appName);
+    return {
+        service: definition.service,
+        action,
+        appName: definition.appName,
+        cwd: definition.cwd,
+        script: definition.script,
+        runtimeHome: definition.runtimeHome,
+        runtimeDataHome: definition.runtimeDataHome,
+        pm2Home: definition.pm2Home,
+        pm2Binary: definition.pm2Binary,
+        exists: statusEntry !== null,
+        status: statusEntry?.status ?? "missing",
+        pid: statusEntry?.pid ?? null,
+        stdout: result.stdout,
+        stderr: result.stderr
+    };
+}
+async function runPm2(definition, args, runner) {
+    const env = buildManagedRuntimeEnvironment({
+        component: definition.component,
+        manifest: { manifestDir: definition.manifestDir },
+        paths: definition.paths,
+        componentRoot: definition.componentRoot,
+        componentConfigDir: definition.componentConfigDir,
+        componentDataHome: definition.runtimeDataHome,
+        pm2Home: definition.pm2Home,
+        scriptBasename: basename(definition.script)
+    }, { ...process.env, ...definition.env });
+    return runner(definition.nodePath, [definition.pm2Binary, ...args], {
+        cwd: definition.cwd,
+        env,
+        maxBuffer: 10 * 1024 * 1024
+    });
+}
+function parsePm2Status(result, appName) {
+    const parsed = parsePm2ProcessList(result);
+    if (!Array.isArray(parsed)) {
+        throw new ManagedPm2Error(`Managed PM2 status returned an unexpected payload for ${appName}.`);
+    }
+    const entry = parsed.find((value) => isPm2ProcessRecord(value) && value.name === appName);
+    if (!entry || !isPm2ProcessRecord(entry)) {
+        return null;
+    }
+    return {
+        status: normalizePm2Status(entry.pm2_env?.status),
+        pid: typeof entry.pid === "number" ? entry.pid : null
+    };
+}
+function parsePm2ProcessList(result) {
+    const directCandidates = [result.stdout.trim(), `${result.stdout}\n${result.stderr}`.trim()].filter(Boolean);
+    for (const candidate of directCandidates) {
+        const direct = tryParseJson(candidate);
+        if (Array.isArray(direct)) {
+            return direct;
+        }
+        const extracted = extractPm2JsonArray(candidate);
+        if (Array.isArray(extracted)) {
+            return extracted;
+        }
+    }
+    throw new ManagedPm2Error(`Managed PM2 status returned invalid JSON: ${summarizePm2Output(result)}`);
+}
+function extractPm2JsonArray(output) {
+    for (let index = 0; index < output.length; index += 1) {
+        if (output[index] !== "[") {
+            continue;
+        }
+        const nextNonWhitespace = output.slice(index + 1).match(/\S/u)?.[0];
+        if (nextNonWhitespace !== "{" && nextNonWhitespace !== "]") {
+            continue;
+        }
+        const parsed = tryParseJson(output.slice(index));
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    return null;
+}
+function tryParseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+function summarizePm2Output(result) {
+    return [result.stdout.trim(), result.stderr.trim()]
+        .filter(Boolean)
+        .join(" | ")
+        .slice(0, 400);
+}
+function normalizePm2Status(value) {
+    switch (value) {
+        case "online":
+            return "online";
+        case "stopped":
+            return "stopped";
+        case "errored":
+            return "errored";
+        default:
+            return "unknown";
+    }
+}
+function isPm2ProcessRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function defaultPm2Script(componentName) {
+    switch (componentName) {
+        case "omniroute":
+            return "current/omniroute-launcher.mjs";
+        case "code-server":
+            return "current/code-server-launcher.mjs";
+        default:
+            throw new ManagedPm2Error(`Unsupported PM2 component ${componentName}.`);
+    }
+}
+function toPm2Args(args) {
+    return args.length > 0 ? ["--", ...args] : [];
+}
+function buildPm2StartArgs(definition) {
+    if (isNodeLauncherScript(definition.script)) {
+        return [
+            "start",
+            "node",
+            "--name",
+            definition.appName,
+            "--cwd",
+            definition.cwd,
+            "--interpreter",
+            "none",
+            "--update-env",
+            "--",
+            definition.script,
+            ...definition.args
+        ];
+    }
+    return [
+        "start",
+        definition.script,
+        "--name",
+        definition.appName,
+        "--cwd",
+        definition.cwd,
+        "--update-env",
+        ...toPm2Args(definition.args)
+    ];
+}
+function isNodeLauncherScript(scriptPath) {
+    const extension = extname(scriptPath).toLowerCase();
+    return extension === ".js" || extension === ".mjs" || extension === ".cjs";
+}
+function getManagedPm2Entrypoint(npmPrefix) {
+    return process.platform === "win32"
+        ? join(npmPrefix, "node_modules", "pm2", "bin", "pm2")
+        : join(npmPrefix, "lib", "node_modules", "pm2", "bin", "pm2");
+}
+async function validateManagedPath(pathValue, message) {
+    try {
+        await access(pathValue);
+    }
+    catch (error) {
+        throw new ManagedPm2Error(message, error instanceof Error ? { cause: error } : undefined);
+    }
+}
+//# sourceMappingURL=pm2-manager.js.map

package/dist/runtime/pm2-manager.js.map

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

package/dist/runtime/runtime-executor.d.ts

@@ -13,6 +13,20 @@ export interface RuntimeScriptExecutionContext {
     verbose?: boolean;
     runner?: CommandRunner;
 }
+export interface ManagedRuntimeEnvironmentContext {
+    component: Pick<RuntimeComponentDefinition, "name" | "type" | "version" | "runtimeDataDir">;
+    manifest: Pick<LoadedRuntimeManifest, "manifestDir">;
+    paths: ResolvedRuntimePaths;
+    componentRoot: string;
+    componentConfigDir: string;
+    componentDataHome?: string;
+    componentLogsDir?: string;
+    pm2Home?: string;
+    phase?: string;
+    purge?: boolean;
+    verbose?: boolean;
+    scriptBasename?: string;
+}
 export interface RuntimeScriptExecutionResult {
     command: string;
     args: string[];
@@ -25,3 +39,7 @@ export declare function getRuntimeScriptLaunch(scriptPath: string): {
     command: string;
     args: string[];
 };
+export declare function buildManagedRuntimeEnvironment(context: ManagedRuntimeEnvironmentContext, baseEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function prependPathEntries(env: NodeJS.ProcessEnv, pathEntries: readonly string[]): NodeJS.ProcessEnv;
+export declare function getManagedRuntimePathEntries(paths: ResolvedRuntimePaths): string[];
+export declare function getManagedNpmBinDirectory(npmPrefix: string): string;