@sfmc-bds/cli 0.2.0-beta.1 → 0.2.0-beta.11

package/dist/module-pack-build.js

@@ -0,0 +1,434 @@
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import fs from "node:fs/promises";
+import path from "node:path";
+import process from "node:process";
+import { writeJson } from "@sfmc-bds/sdk/node/config";
+import {
+  BP_NAME,
+  RP_NAME,
+  DEPLOY_CATALOG_NAME,
+  bpOut,
+  bpSrc,
+  rpOut,
+  buildRoot,
+  computeDesiredCatalog,
+  readDeployedCatalog,
+  catalogsEqual,
+  resolveBdsContext,
+  deployedBpDir,
+  formatPackLoadInfo,
+  scanLocalModules
+} from "./pack-lifecycle.js";
+import { ROOT, resolveServiceScript } from "./runtime.js";
+import { c } from "./theme.js";
+import { t } from "./i18n/index.js";
+import { pushLog } from "./logs.js";
+function spawnPackManager(args) {
+  return new Promise((resolve) => {
+    const script = resolveServiceScript("pack-manager");
+    const proc = spawn(process.execPath, [script, ...args], {
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, SFMC_ROOT: ROOT, SFMC_SERVICE: "pack-manager" }
+    });
+    let output = "";
+    proc.stdout?.on("data", (d) => {
+      output += d.toString();
+    });
+    proc.stderr?.on("data", (d) => {
+      output += d.toString();
+    });
+    proc.on("exit", (code) => resolve({ code, output }));
+    proc.on("error", (e) => resolve({ code: 1, output: `${output}${e.message}` }));
+  });
+}
+async function bundleBehaviorPackScript() {
+  const mods = await scanLocalModules();
+  const entries = mods.filter((m) => m.enabled && m.entryPath).map((m) => m.entryPath);
+  const outFile = path.join(bpSrc(), "scripts", "main.js");
+  await fs.mkdir(path.dirname(outFile), { recursive: true });
+  if (entries.length === 0) {
+    await fs.writeFile(outFile, "/* no modules enabled */\n", "utf8");
+    pushLog("no enabled SAPI modules \u2014 empty main.js", "pack", "warn");
+    return;
+  }
+  const { build } = await import("esbuild");
+  const sdkRoot = await resolveSdkRootForEsbuild();
+  await build({
+    entryPoints: entries,
+    outfile: outFile,
+    bundle: true,
+    platform: "neutral",
+    format: "esm",
+    target: "es2022",
+    logLevel: "warning",
+    sourcemap: false,
+    external: ["@minecraft/*"],
+    // BDS host 启动：与 module-loader barrel 分离（DIP），须在模块 register 之前执行
+    banner: {
+      js: 'import { installHostBootstrap } from "@sfmc-bds/sdk/module-loader/install";\ninstallHostBootstrap();\n'
+    },
+    tsconfigRaw: JSON.stringify({
+      compilerOptions: {
+        module: "ESNext",
+        moduleResolution: "bundler",
+        target: "ES2022",
+        strict: true,
+        skipLibCheck: true
+      }
+    }),
+    plugins: [createSdkResolvePlugin(sdkRoot)]
+  });
+  pushLog(`esbuild bundled ${entries.length} entr(y/ies)`, "pack", "info");
+}
+async function resolveSdkRootForEsbuild() {
+  const { resolveSdkPackageRoot } = await import("./runtime.js");
+  return resolveSdkPackageRoot();
+}
+function createSdkResolvePlugin(sdkRoot) {
+  const pkg = JSON.parse(readFileSync(path.join(sdkRoot, "package.json"), "utf8"));
+  const exportsMap = pkg.exports ?? {};
+  function resolveExportSubpath(subpath) {
+    const key = subpath === "" ? "." : `./${subpath}`;
+    const entry = exportsMap[key];
+    if (!entry) return null;
+    const rel = typeof entry === "string" ? entry : entry.import ?? entry.default;
+    if (!rel || typeof rel !== "string") return null;
+    const abs = path.join(sdkRoot, rel);
+    return existsSync(abs) ? abs : null;
+  }
+  return {
+    name: "sfmc-sdk-resolve",
+    setup(build) {
+      build.onResolve({ filter: /^@sfmc(?:-bds)?\/sdk(?:\/|$)/ }, (args) => {
+        const normalized = args.path.replace(/^@sfmc\/sdk/, "@sfmc-bds/sdk");
+        const sub = normalized === "@sfmc-bds/sdk" ? "" : normalized.slice("@sfmc-bds/sdk/".length);
+        const resolved = resolveExportSubpath(sub);
+        if (!resolved) {
+          return {
+            errors: [
+              {
+                text: `Cannot resolve ${args.path} under SDK at ${sdkRoot} (export "./${sub || "."}" missing or file absent; run sdk:build?)`
+              }
+            ]
+          };
+        }
+        return { path: resolved };
+      });
+    }
+  };
+}
+async function spawnAssembleBp(catalog) {
+  const args = [
+    "assemble-bp",
+    "--src",
+    bpSrc(),
+    "--out",
+    bpOut(),
+    "--name",
+    BP_NAME,
+    "--uuid",
+    catalog.bpUuid,
+    "--version",
+    catalog.bpVersion.join(",")
+  ];
+  if (catalog.bpModuleUuid) args.push("--module-uuid", catalog.bpModuleUuid);
+  const r = await spawnPackManager(args);
+  if (r.code === 0) {
+    pushLog(`assembled BP uuid=${catalog.bpUuid}`, "pack", "info");
+  }
+  return r;
+}
+async function spawnAssembleRp(catalog, rpDirs) {
+  if (!catalog.rpUuid || Object.keys(rpDirs).length === 0) {
+    await fs.rm(rpOut(), { recursive: true, force: true });
+    pushLog("no enabled resource packs \u2014 RP skipped", "pack", "info");
+    return { code: 0, output: "[pack-manager] no enabled resource packs \u2014 RP skipped\n" };
+  }
+  const mapFile = path.join(buildRoot(), "rp-map.json");
+  await fs.mkdir(buildRoot(), { recursive: true });
+  await fs.writeFile(mapFile, JSON.stringify(rpDirs), "utf8");
+  const args = [
+    "assemble-rp",
+    "--modules-json",
+    mapFile,
+    "--out",
+    rpOut(),
+    "--name",
+    RP_NAME,
+    "--uuid",
+    catalog.rpUuid,
+    "--version",
+    (catalog.rpVersion ?? [1, 0, 0]).join(",")
+  ];
+  if (catalog.rpModuleUuid) args.push("--module-uuid", catalog.rpModuleUuid);
+  const r = await spawnPackManager(args);
+  if (r.code === 0) {
+    pushLog(
+      `assembled RP uuid=${catalog.rpUuid} (${Object.keys(rpDirs).length} modules)`,
+      "pack",
+      "info"
+    );
+  }
+  return r;
+}
+async function spawnDeploy(catalog) {
+  const { bdsRoot, levelName } = resolveBdsContext();
+  const args = [
+    "deploy",
+    "--bds-root",
+    bdsRoot,
+    "--level",
+    levelName,
+    "--bp-src",
+    bpOut(),
+    "--bp-name",
+    BP_NAME,
+    "--rp-name",
+    RP_NAME
+  ];
+  if (catalog.rpUuid && existsSync(rpOut())) {
+    args.push("--rp-src", rpOut());
+  } else {
+    args.push("--clear-rp");
+  }
+  const r = await spawnPackManager(args);
+  if (r.code === 0) {
+    pushLog(`deployed to worlds/${levelName}`, "pack", "info");
+  }
+  return r;
+}
+async function spawnEnablePacks(catalog) {
+  const { bdsRoot, levelName } = resolveBdsContext();
+  const worldsDir = path.join(bdsRoot, "worlds");
+  let output = "";
+  const bpArgs = [
+    "enable-pack",
+    "--worlds-dir",
+    worldsDir,
+    "--level",
+    levelName,
+    "--kind",
+    "behavior",
+    "--pack-id",
+    catalog.bpUuid,
+    "--version",
+    catalog.bpVersion.join(",")
+  ];
+  const bpR = await spawnPackManager(bpArgs);
+  output += bpR.output;
+  if (bpR.code !== 0) return { code: bpR.code, output };
+  pushLog(
+    `enabled behavior pack ${catalog.bpUuid} in world list`,
+    "pack",
+    "info"
+  );
+  if (catalog.rpUuid && catalog.rpVersion) {
+    const rpArgs = [
+      "enable-pack",
+      "--worlds-dir",
+      worldsDir,
+      "--level",
+      levelName,
+      "--kind",
+      "resource",
+      "--pack-id",
+      catalog.rpUuid,
+      "--version",
+      catalog.rpVersion.join(",")
+    ];
+    const rpR = await spawnPackManager(rpArgs);
+    output += rpR.output;
+    if (rpR.code !== 0) return { code: rpR.code, output };
+    pushLog(
+      `enabled resource pack ${catalog.rpUuid} in world list`,
+      "pack",
+      "info"
+    );
+  }
+  return { code: 0, output };
+}
+async function spawnDisableStale(current, bdsRoot, levelName) {
+  const previous = await collectDeployedPackUuids(bdsRoot, levelName);
+  const worldsDir = path.join(bdsRoot, "worlds");
+  for (const staleRp of previous.rp) {
+    if (staleRp === (current.rpUuid ?? null)) continue;
+    const r = await spawnPackManager([
+      "disable-pack",
+      "--worlds-dir",
+      worldsDir,
+      "--level",
+      levelName,
+      "--kind",
+      "resource",
+      "--pack-id",
+      staleRp,
+      "--version",
+      "1,0,0"
+    ]);
+    if (r.code === 0) {
+      pushLog(`disabled stale resource pack ${staleRp}`, "pack", "info");
+    } else {
+      pushLog(
+        `disable stale RP ${staleRp} failed: ${r.output.trim()}`,
+        "pack",
+        "warn"
+      );
+    }
+  }
+  for (const staleBp of previous.bp) {
+    if (staleBp === current.bpUuid) continue;
+    const r = await spawnPackManager([
+      "disable-pack",
+      "--worlds-dir",
+      worldsDir,
+      "--level",
+      levelName,
+      "--kind",
+      "behavior",
+      "--pack-id",
+      staleBp,
+      "--version",
+      "1,0,0"
+    ]);
+    if (r.code === 0) {
+      pushLog(`disabled stale behavior pack ${staleBp}`, "pack", "info");
+    } else {
+      pushLog(
+        `disable stale BP ${staleBp} failed: ${r.output.trim()}`,
+        "pack",
+        "warn"
+      );
+    }
+  }
+}
+async function collectDeployedPackUuids(bdsRoot, levelName) {
+  const bp = /* @__PURE__ */ new Set();
+  const rp = /* @__PURE__ */ new Set();
+  const cat = readDeployedCatalog(bdsRoot, levelName);
+  if (cat?.bpUuid) bp.add(cat.bpUuid);
+  if (cat?.rpUuid) rp.add(cat.rpUuid);
+  const bpDir = path.join(bdsRoot, "worlds", levelName, "behavior_packs", BP_NAME);
+  const rpDir = path.join(bdsRoot, "worlds", levelName, "resource_packs", RP_NAME);
+  const bpR = await spawnPackManager(["read-manifest", "--pack-dir", bpDir]);
+  if (bpR.code === 0) {
+    try {
+      const j = JSON.parse(bpR.output.trim());
+      if (j?.uuid) bp.add(j.uuid);
+    } catch {
+    }
+  }
+  const rpR = await spawnPackManager(["read-manifest", "--pack-dir", rpDir]);
+  if (rpR.code === 0) {
+    try {
+      const j = JSON.parse(rpR.output.trim());
+      if (j?.uuid) rp.add(j.uuid);
+    } catch {
+    }
+  }
+  return { bp, rp };
+}
+async function spawnEnsurePermission(catalog) {
+  const { bdsRoot } = resolveBdsContext();
+  const r = await spawnPackManager([
+    "ensure-permission",
+    "--bds-root",
+    bdsRoot,
+    "--pack-id",
+    catalog.bpUuid
+  ]);
+  return r;
+}
+async function cmdModuleBuild(_args) {
+  try {
+    const { bdsRoot, levelName } = resolveBdsContext();
+    const deployed = readDeployedCatalog(bdsRoot, levelName);
+    const desired = await computeDesiredCatalog(deployed ? reusePackIds(deployed) : void 0);
+    if (deployed && catalogsEqual(desired, deployed)) {
+      return formatPackLoadInfo(desired, false);
+    }
+    pushLog(
+      `building BP/RP (modules=${Object.keys(desired.modules).length})\u2026`,
+      "pack",
+      "info"
+    );
+    await bundleBehaviorPackScript();
+    const mods = await scanLocalModules();
+    const rpDirs = {};
+    for (const m of mods) {
+      if (!m.enabled || !m.hasResourcePack) continue;
+      rpDirs[m.folderId] = path.join("modules", "packages", m.folderId, "resource_pack");
+    }
+    const bpR = await spawnAssembleBp(desired);
+    if (bpR.code !== 0) return c.red(bpR.output.trim() || `assemble-bp exit ${bpR.code}`);
+    const rpR = await spawnAssembleRp(desired, rpDirs);
+    if (rpR.code !== 0) return c.red(rpR.output.trim() || `assemble-rp exit ${rpR.code}`);
+    desired.generatedAt = Date.now();
+    if (Object.keys(rpDirs).length === 0) {
+      desired.rpUuid = null;
+      desired.rpVersion = null;
+    }
+    writeJson(path.join(bpOut(), DEPLOY_CATALOG_NAME), desired);
+    return c.green(t("pack.built", { path: bpOut() })) + "\n" + formatPackLoadInfo(desired, true);
+  } catch (e) {
+    return c.red(e.message);
+  }
+}
+async function cmdModuleReload(args) {
+  const buildOnly = args.includes("--build-only");
+  const parts = [];
+  const buildMsg = await cmdModuleBuild([]);
+  parts.push(buildMsg.trimEnd());
+  if (buildMsg.startsWith(c.red(""))) return parts.join("\n") + "\n";
+  try {
+    const { bdsRoot, levelName } = resolveBdsContext();
+    const desired = await computeDesiredCatalog();
+    const depR = await spawnDeploy(desired);
+    if (depR.code !== 0) {
+      return parts.join("\n") + "\n" + c.red(depR.output.trim() || `deploy exit ${depR.code}`);
+    }
+    parts.push(depR.output.trimEnd());
+    writeJson(path.join(deployedBpDir(bdsRoot, levelName), DEPLOY_CATALOG_NAME), desired);
+    await spawnDisableStale(desired, bdsRoot, levelName);
+    const enR = await spawnEnablePacks(desired);
+    if (enR.code !== 0) {
+      return parts.join("\n") + "\n" + c.red(enR.output.trim() || `enable-pack exit ${enR.code}`);
+    }
+    parts.push(enR.output.trimEnd());
+    const perR = await spawnEnsurePermission(desired);
+    if (perR.code !== 0) {
+      return parts.join("\n") + "\n" + c.red(perR.output.trim() || `ensure-permission exit ${perR.code}`);
+    }
+    parts.push(perR.output.trimEnd());
+  } catch (e) {
+    return parts.join("\n") + "\n" + c.red(e.message);
+  }
+  if (buildOnly) {
+    parts.push(c.dim(t("reload.buildOnly")));
+    return parts.join("\n") + "\n";
+  }
+  const { isServiceRunning } = await import("./services.js");
+  if (!await isServiceRunning("bds")) {
+    parts.push(c.yellow(t("reload.bdsNotRunning")));
+    return parts.join("\n") + "\n";
+  }
+  const { cmdSend } = await import("./commands.js");
+  parts.push((await cmdSend("bds", "reload")).trimEnd());
+  parts.push(c.green(t("reload.sent")));
+  return parts.join("\n") + "\n";
+}
+function reusePackIds(deployed) {
+  return {
+    bpUuid: deployed.bpUuid,
+    rpUuid: deployed.rpUuid,
+    bpVersion: deployed.bpVersion,
+    rpVersion: deployed.rpVersion,
+    ...deployed.bpModuleUuid ? { bpModuleUuid: deployed.bpModuleUuid } : {},
+    ...deployed.rpModuleUuid ? { rpModuleUuid: deployed.rpModuleUuid } : {}
+  };
+}
+export {
+  cmdModuleBuild,
+  cmdModuleReload
+};
+//# sourceMappingURL=module-pack-build.js.map

package/dist/module-pack-build.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/module-pack-build.ts"],
+  "sourcesContent": ["/**\n * module-pack-build.ts \u2014 `mod build` / `mod reload` \u7684 spawn-based \u5B9E\u73B0\n *\n * CLI \u6D3E\u53D1\u7684 module build / reload \u5B50\u547D\u4EE4\u8D70\u8FD9\u91CC\uFF1Bpack-lifecycle.ts \u4FDD\u7559\n * ensurePacksReady \u542F\u52A8\u94A9\u5B50\u4E0E wizard \u5185\u90E8\u6D88\u8D39\u65B9\u7684 in-process \u5165\u53E3\u3002\n *\n * \u5B9E\u9645\u6587\u4EF6\u5199\u5165\uFF08assemble-bp / assemble-rp / deploy / enable-pack / disable-pack /\n * ensure-permission\uFF09\u901A\u8FC7 spawn bds-tools/cli-pack-manager.ts \u7684 verb \u6267\u884C\uFF1B\n * \u4E0E module install/uninstall\uFF08\u2192 scripts/module-install/fetch-module.mjs\uFF09\u4FDD\u6301\u540C\u4E00\u67B6\u6784\uFF1A\n * CLI \u662F thin wrapper\uFF1B\u5EFA\u4ED3\u811A\u624B\u67B6\u5728 @sfmc-bds/create-module\uFF08npm create\uFF09\u3002\n *\n * \u552F\u4E00\u6743\u5A01\uFF1A\u672C\u6587\u4EF6 = `sfmc mod build|reload` \u7684\u6D3E\u53D1\u5165\u53E3\uFF1B\u5176\u4ED6\u6587\u4EF6\u4E0D\u5F97\u518D\n * \u76F4\u63A5 import pack-lifecycle \u7684 cmdPackBuild / deployPacks\uFF08\u786E\u4FDD\u53EA\u6709\u4E00\u4E2A spawn \u5165\u53E3\uFF09\u3002\n */\nimport { spawn } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { writeJson } from \"@sfmc-bds/sdk/node/config\";\nimport {\n  BP_NAME,\n  RP_NAME,\n  DEPLOY_CATALOG_NAME,\n  bpOut,\n  bpSrc,\n  rpOut,\n  buildRoot,\n  computeDesiredCatalog,\n  readDeployedCatalog,\n  catalogsEqual,\n  resolveBdsContext,\n  deployedBpDir,\n  formatPackLoadInfo,\n  scanLocalModules,\n  type DeployCatalog,\n} from \"./pack-lifecycle.js\";\nimport { ROOT, resolveServiceScript } from \"./runtime.js\";\nimport { c } from \"./theme.js\";\nimport { t } from \"./i18n/index.js\";\nimport { pushLog } from \"./logs.js\";\n\ntype SpawnResult = { code: number | null; output: string };\n\n/** spawn bds-tools/cli-pack-manager.ts \u5B50\u8FDB\u7A0B\uFF1B\u6355\u83B7 stdout+stderr\u3002 */\nfunction spawnPackManager(args: string[]): Promise<SpawnResult> {\n  return new Promise((resolve) => {\n    const script = resolveServiceScript(\"pack-manager\");\n    const proc = spawn(process.execPath, [script, ...args], {\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      env: { ...process.env, SFMC_ROOT: ROOT, SFMC_SERVICE: \"pack-manager\" },\n    });\n    let output = \"\";\n    proc.stdout?.on(\"data\", (d: Buffer) => {\n      output += d.toString();\n    });\n    proc.stderr?.on(\"data\", (d: Buffer) => {\n      output += d.toString();\n    });\n    proc.on(\"exit\", (code) => resolve({ code, output }));\n    proc.on(\"error\", (e) => resolve({ code: 1, output: `${output}${e.message}` }));\n  });\n}\n\n/* esbuild bundle \u2014\u2014 JS bundler \u662F in-process \u5E93\uFF0C\u4E0D\u8D70 spawn\u3002 */\nasync function bundleBehaviorPackScript(): Promise<void> {\n  const mods = await scanLocalModules();\n  const entries = mods.filter((m) => m.enabled && m.entryPath).map((m) => m.entryPath!);\n  const outFile = path.join(bpSrc(), \"scripts\", \"main.js\");\n  await fs.mkdir(path.dirname(outFile), { recursive: true });\n\n  if (entries.length === 0) {\n    await fs.writeFile(outFile, \"/* no modules enabled */\\n\", \"utf8\");\n    pushLog(\"no enabled SAPI modules \u2014 empty main.js\", \"pack\", \"warn\");\n    return;\n  }\n\n  const { build } = await import(\"esbuild\");\n  const sdkRoot = await resolveSdkRootForEsbuild();\n  await build({\n    entryPoints: entries,\n    outfile: outFile,\n    bundle: true,\n    platform: \"neutral\",\n    format: \"esm\",\n    target: \"es2022\",\n    logLevel: \"warning\",\n    sourcemap: false,\n    external: [\"@minecraft/*\"],\n    // BDS host \u542F\u52A8\uFF1A\u4E0E module-loader barrel \u5206\u79BB\uFF08DIP\uFF09\uFF0C\u987B\u5728\u6A21\u5757 register \u4E4B\u524D\u6267\u884C\n    banner: {\n      js: 'import { installHostBootstrap } from \"@sfmc-bds/sdk/module-loader/install\";\\ninstallHostBootstrap();\\n',\n    },\n    tsconfigRaw: JSON.stringify({\n      compilerOptions: {\n        module: \"ESNext\",\n        moduleResolution: \"bundler\",\n        target: \"ES2022\",\n        strict: true,\n        skipLibCheck: true,\n      },\n    }),\n    plugins: [createSdkResolvePlugin(sdkRoot)],\n  });\n  pushLog(`esbuild bundled ${entries.length} entr(y/ies)`, \"pack\", \"info\");\n}\n\nasync function resolveSdkRootForEsbuild(): Promise<string> {\n  const { resolveSdkPackageRoot } = await import(\"./runtime.js\");\n  return resolveSdkPackageRoot();\n}\n\n/** esbuild \u63D2\u4EF6\uFF1A\u89E3\u6790 @sfmc-bds/sdk \u7684 exports \u5B57\u6BB5\uFF08\u4E0E pack-lifecycle.ts \u5185\u90E8\u5B9E\u73B0\u540C\u6B65\uFF09\u3002 */\nfunction createSdkResolvePlugin(sdkRoot: string): import(\"esbuild\").Plugin {\n  const pkg = JSON.parse(readFileSync(path.join(sdkRoot, \"package.json\"), \"utf8\")) as {\n    exports?: Record<string, string | { import?: string; default?: string; types?: string }>;\n  };\n  const exportsMap = pkg.exports ?? {};\n\n  function resolveExportSubpath(subpath: string): string | null {\n    const key = subpath === \"\" ? \".\" : `./${subpath}`;\n    const entry = exportsMap[key];\n    if (!entry) return null;\n    const rel = typeof entry === \"string\" ? entry : (entry.import ?? entry.default);\n    if (!rel || typeof rel !== \"string\") return null;\n    const abs = path.join(sdkRoot, rel);\n    return existsSync(abs) ? abs : null;\n  }\n\n  return {\n    name: \"sfmc-sdk-resolve\",\n    setup(build) {\n      build.onResolve({ filter: /^@sfmc(?:-bds)?\\/sdk(?:\\/|$)/ }, (args) => {\n        const normalized = args.path.replace(/^@sfmc\\/sdk/, \"@sfmc-bds/sdk\");\n        const sub = normalized === \"@sfmc-bds/sdk\" ? \"\" : normalized.slice(\"@sfmc-bds/sdk/\".length);\n        const resolved = resolveExportSubpath(sub);\n        if (!resolved) {\n          return {\n            errors: [\n              {\n                text: `Cannot resolve ${args.path} under SDK at ${sdkRoot} (export \"./${sub || \".\"}\" missing or file absent; run sdk:build?)`,\n              },\n            ],\n          };\n        }\n        return { path: resolved };\n      });\n    },\n  };\n}\n\n/** spawn assemble-bp verb\u3002 */\nasync function spawnAssembleBp(catalog: DeployCatalog): Promise<SpawnResult> {\n  const args = [\n    \"assemble-bp\",\n    \"--src\",\n    bpSrc(),\n    \"--out\",\n    bpOut(),\n    \"--name\",\n    BP_NAME,\n    \"--uuid\",\n    catalog.bpUuid,\n    \"--version\",\n    catalog.bpVersion.join(\",\"),\n  ];\n  if (catalog.bpModuleUuid) args.push(\"--module-uuid\", catalog.bpModuleUuid);\n  const r = await spawnPackManager(args);\n  if (r.code === 0) {\n    pushLog(`assembled BP uuid=${catalog.bpUuid}`, \"pack\", \"info\");\n  }\n  return r;\n}\n\n/** spawn assemble-rp verb\uFF1B\u65E0 RP \u65F6\u6E05\u7406\u65E7\u4EA7\u7269\u3002 */\nasync function spawnAssembleRp(\n  catalog: DeployCatalog,\n  rpDirs: Record<string, string>\n): Promise<SpawnResult> {\n  if (!catalog.rpUuid || Object.keys(rpDirs).length === 0) {\n    await fs.rm(rpOut(), { recursive: true, force: true });\n    pushLog(\"no enabled resource packs \u2014 RP skipped\", \"pack\", \"info\");\n    return { code: 0, output: \"[pack-manager] no enabled resource packs \u2014 RP skipped\\n\" };\n  }\n  const mapFile = path.join(buildRoot(), \"rp-map.json\");\n  await fs.mkdir(buildRoot(), { recursive: true });\n  await fs.writeFile(mapFile, JSON.stringify(rpDirs), \"utf8\");\n  const args = [\n    \"assemble-rp\",\n    \"--modules-json\",\n    mapFile,\n    \"--out\",\n    rpOut(),\n    \"--name\",\n    RP_NAME,\n    \"--uuid\",\n    catalog.rpUuid,\n    \"--version\",\n    (catalog.rpVersion ?? [1, 0, 0]).join(\",\"),\n  ];\n  if (catalog.rpModuleUuid) args.push(\"--module-uuid\", catalog.rpModuleUuid);\n  const r = await spawnPackManager(args);\n  if (r.code === 0) {\n    pushLog(\n      `assembled RP uuid=${catalog.rpUuid} (${Object.keys(rpDirs).length} modules)`,\n      \"pack\",\n      \"info\"\n    );\n  }\n  return r;\n}\n\n/** spawn deploy verb\uFF1B\u65E0 RP \u65F6\u5E26 --clear-rp\u3002 */\nasync function spawnDeploy(catalog: DeployCatalog): Promise<SpawnResult> {\n  const { bdsRoot, levelName } = resolveBdsContext();\n  const args = [\n    \"deploy\",\n    \"--bds-root\",\n    bdsRoot,\n    \"--level\",\n    levelName,\n    \"--bp-src\",\n    bpOut(),\n    \"--bp-name\",\n    BP_NAME,\n    \"--rp-name\",\n    RP_NAME,\n  ];\n  if (catalog.rpUuid && existsSync(rpOut())) {\n    args.push(\"--rp-src\", rpOut());\n  } else {\n    args.push(\"--clear-rp\");\n  }\n  const r = await spawnPackManager(args);\n  if (r.code === 0) {\n    pushLog(`deployed to worlds/${levelName}`, \"pack\", \"info\");\n  }\n  return r;\n}\n\n/** spawn enable-pack verb\uFF1ABP \u5FC5\u987B\uFF0CRP \u4EC5\u5728\u6709 UUID \u65F6\u3002 */\nasync function spawnEnablePacks(catalog: DeployCatalog): Promise<SpawnResult> {\n  const { bdsRoot, levelName } = resolveBdsContext();\n  const worldsDir = path.join(bdsRoot, \"worlds\");\n  let output = \"\";\n  const bpArgs = [\n    \"enable-pack\",\n    \"--worlds-dir\",\n    worldsDir,\n    \"--level\",\n    levelName,\n    \"--kind\",\n    \"behavior\",\n    \"--pack-id\",\n    catalog.bpUuid,\n    \"--version\",\n    catalog.bpVersion.join(\",\"),\n  ];\n  const bpR = await spawnPackManager(bpArgs);\n  output += bpR.output;\n  if (bpR.code !== 0) return { code: bpR.code, output };\n  pushLog(\n    `enabled behavior pack ${catalog.bpUuid} in world list`,\n    \"pack\",\n    \"info\"\n  );\n  if (catalog.rpUuid && catalog.rpVersion) {\n    const rpArgs = [\n      \"enable-pack\",\n      \"--worlds-dir\",\n      worldsDir,\n      \"--level\",\n      levelName,\n      \"--kind\",\n      \"resource\",\n      \"--pack-id\",\n      catalog.rpUuid,\n      \"--version\",\n      catalog.rpVersion.join(\",\"),\n    ];\n    const rpR = await spawnPackManager(rpArgs);\n    output += rpR.output;\n    if (rpR.code !== 0) return { code: rpR.code, output };\n    pushLog(\n      `enabled resource pack ${catalog.rpUuid} in world list`,\n      \"pack\",\n      \"info\"\n    );\n  }\n  return { code: 0, output };\n}\n\n/** spawn disable-pack verb\uFF1A\u6E05\u7406\u8FC7\u671F UUID\uFF08uuid \u8F6E\u6362 / \u4E0D\u518D\u63D0\u4F9B RP\uFF09\u3002 */\nasync function spawnDisableStale(\n  current: DeployCatalog,\n  bdsRoot: string,\n  levelName: string\n): Promise<void> {\n  const previous = await collectDeployedPackUuids(bdsRoot, levelName);\n  const worldsDir = path.join(bdsRoot, \"worlds\");\n  for (const staleRp of previous.rp) {\n    if (staleRp === (current.rpUuid ?? null)) continue;\n    const r = await spawnPackManager([\n      \"disable-pack\",\n      \"--worlds-dir\",\n      worldsDir,\n      \"--level\",\n      levelName,\n      \"--kind\",\n      \"resource\",\n      \"--pack-id\",\n      staleRp,\n      \"--version\",\n      \"1,0,0\",\n    ]);\n    if (r.code === 0) {\n      pushLog(`disabled stale resource pack ${staleRp}`, \"pack\", \"info\");\n    } else {\n      pushLog(\n        `disable stale RP ${staleRp} failed: ${r.output.trim()}`,\n        \"pack\",\n        \"warn\"\n      );\n    }\n  }\n  for (const staleBp of previous.bp) {\n    if (staleBp === current.bpUuid) continue;\n    const r = await spawnPackManager([\n      \"disable-pack\",\n      \"--worlds-dir\",\n      worldsDir,\n      \"--level\",\n      levelName,\n      \"--kind\",\n      \"behavior\",\n      \"--pack-id\",\n      staleBp,\n      \"--version\",\n      \"1,0,0\",\n    ]);\n    if (r.code === 0) {\n      pushLog(`disabled stale behavior pack ${staleBp}`, \"pack\", \"info\");\n    } else {\n      pushLog(\n        `disable stale BP ${staleBp} failed: ${r.output.trim()}`,\n        \"pack\",\n        \"warn\"\n      );\n    }\n  }\n}\n\n/** \u901A\u8FC7 bds-tools \u7684 list-installed + read-manifest \u62FF\u5230 deployed UUID\uFF08spawn\uFF09\u3002 */\nasync function collectDeployedPackUuids(\n  bdsRoot: string,\n  levelName: string\n): Promise<{ bp: Set<string>; rp: Set<string> }> {\n  const bp = new Set<string>();\n  const rp = new Set<string>();\n  const cat = readDeployedCatalog(bdsRoot, levelName);\n  if (cat?.bpUuid) bp.add(cat.bpUuid);\n  if (cat?.rpUuid) rp.add(cat.rpUuid);\n  // \u901A\u8FC7 read-manifest \u770B\u4E16\u754C\u78C1\u76D8 BP/RP manifest \u7684 uuid\uFF0C\u4F5C\u4E3A catalog \u7F3A\u5931\u65F6\u7684\u515C\u5E95\u3002\n  const bpDir = path.join(bdsRoot, \"worlds\", levelName, \"behavior_packs\", BP_NAME);\n  const rpDir = path.join(bdsRoot, \"worlds\", levelName, \"resource_packs\", RP_NAME);\n  const bpR = await spawnPackManager([\"read-manifest\", \"--pack-dir\", bpDir]);\n  if (bpR.code === 0) {\n    try {\n      const j = JSON.parse(bpR.output.trim()) as { uuid?: string } | null;\n      if (j?.uuid) bp.add(j.uuid);\n    } catch {\n      /* ignore */\n    }\n  }\n  const rpR = await spawnPackManager([\"read-manifest\", \"--pack-dir\", rpDir]);\n  if (rpR.code === 0) {\n    try {\n      const j = JSON.parse(rpR.output.trim()) as { uuid?: string } | null;\n      if (j?.uuid) rp.add(j.uuid);\n    } catch {\n      /* ignore */\n    }\n  }\n  return { bp, rp };\n}\n\n/** spawn ensure-permission verb\u3002 */\nasync function spawnEnsurePermission(catalog: DeployCatalog): Promise<SpawnResult> {\n  const { bdsRoot } = resolveBdsContext();\n  const r = await spawnPackManager([\n    \"ensure-permission\",\n    \"--bds-root\",\n    bdsRoot,\n    \"--pack-id\",\n    catalog.bpUuid,\n  ]);\n  return r;\n}\n\n/**\n * `sfmc mod build` \u2014\u2014 \u7EC4\u88C5 BP + RP\uFF08\u4E0D\u90E8\u7F72\uFF09\u3002\n * \u4EC5\u5F53 catalog \u4E0E\u4E16\u754C\u5185\u5DF2\u90E8\u7F72\u4E0D\u4E00\u81F4\u65F6\u6267\u884C\uFF1B\u5426\u5219\u76F4\u63A5\u6253\"\u5DF2\u540C\u6B65\"\u3002\n */\nexport async function cmdModuleBuild(_args: string[]): Promise<string> {\n  try {\n    const { bdsRoot, levelName } = resolveBdsContext();\n    const deployed = readDeployedCatalog(bdsRoot, levelName);\n    const desired = await computeDesiredCatalog(deployed ? reusePackIds(deployed) : undefined);\n\n    if (deployed && catalogsEqual(desired, deployed)) {\n      return formatPackLoadInfo(desired, false);\n    }\n\n    pushLog(\n      `building BP/RP (modules=${Object.keys(desired.modules).length})\u2026`,\n      \"pack\",\n      \"info\"\n    );\n    await bundleBehaviorPackScript();\n\n    const mods = await scanLocalModules();\n    const rpDirs: Record<string, string> = {};\n    for (const m of mods) {\n      if (!m.enabled || !m.hasResourcePack) continue;\n      rpDirs[m.folderId] = path.join(\"modules\", \"packages\", m.folderId, \"resource_pack\");\n    }\n\n    const bpR = await spawnAssembleBp(desired);\n    if (bpR.code !== 0) return c.red(bpR.output.trim() || `assemble-bp exit ${bpR.code}`);\n    const rpR = await spawnAssembleRp(desired, rpDirs);\n    if (rpR.code !== 0) return c.red(rpR.output.trim() || `assemble-rp exit ${rpR.code}`);\n\n    desired.generatedAt = Date.now();\n    if (Object.keys(rpDirs).length === 0) {\n      desired.rpUuid = null;\n      desired.rpVersion = null;\n    }\n    writeJson(path.join(bpOut(), DEPLOY_CATALOG_NAME), desired);\n\n    return c.green(t(\"pack.built\", { path: bpOut() })) + \"\\n\" + formatPackLoadInfo(desired, true);\n  } catch (e) {\n    return c.red((e as Error).message);\n  }\n}\n\n/**\n * `sfmc mod reload [--build-only]` \u2014\u2014 \u7EC4\u88C5 + \u90E8\u7F72 + \u6E05\u7406\u8FC7\u671F + \u5199\u6743\u9650 + \uFF08\u9ED8\u8BA4\uFF09\u53D1 reload \u5230 BDS\u3002\n */\nexport async function cmdModuleReload(args: string[]): Promise<string> {\n  const buildOnly = args.includes(\"--build-only\");\n  const parts: string[] = [];\n\n  const buildMsg = await cmdModuleBuild([]);\n  parts.push(buildMsg.trimEnd());\n  if (buildMsg.startsWith(c.red(\"\"))) return parts.join(\"\\n\") + \"\\n\";\n\n  try {\n    const { bdsRoot, levelName } = resolveBdsContext();\n    const desired = await computeDesiredCatalog();\n\n    const depR = await spawnDeploy(desired);\n    if (depR.code !== 0) {\n      return parts.join(\"\\n\") + \"\\n\" + c.red(depR.output.trim() || `deploy exit ${depR.code}`);\n    }\n    parts.push(depR.output.trimEnd());\n\n    writeJson(path.join(deployedBpDir(bdsRoot, levelName), DEPLOY_CATALOG_NAME), desired);\n\n    await spawnDisableStale(desired, bdsRoot, levelName);\n\n    const enR = await spawnEnablePacks(desired);\n    if (enR.code !== 0) {\n      return parts.join(\"\\n\") + \"\\n\" + c.red(enR.output.trim() || `enable-pack exit ${enR.code}`);\n    }\n    parts.push(enR.output.trimEnd());\n\n    const perR = await spawnEnsurePermission(desired);\n    if (perR.code !== 0) {\n      return parts.join(\"\\n\") + \"\\n\" + c.red(perR.output.trim() || `ensure-permission exit ${perR.code}`);\n    }\n    parts.push(perR.output.trimEnd());\n  } catch (e) {\n    return parts.join(\"\\n\") + \"\\n\" + c.red((e as Error).message);\n  }\n\n  if (buildOnly) {\n    parts.push(c.dim(t(\"reload.buildOnly\")));\n    return parts.join(\"\\n\") + \"\\n\";\n  }\n\n  const { isServiceRunning } = await import(\"./services.js\");\n  if (!(await isServiceRunning(\"bds\"))) {\n    parts.push(c.yellow(t(\"reload.bdsNotRunning\")));\n    return parts.join(\"\\n\") + \"\\n\";\n  }\n  const { cmdSend } = await import(\"./commands.js\");\n  parts.push((await cmdSend(\"bds\", \"reload\")).trimEnd());\n  parts.push(c.green(t(\"reload.sent\")));\n  return parts.join(\"\\n\") + \"\\n\";\n}\n\nfunction reusePackIds(\n  deployed: DeployCatalog\n): Parameters<typeof computeDesiredCatalog>[0] {\n  return {\n    bpUuid: deployed.bpUuid,\n    rpUuid: deployed.rpUuid,\n    bpVersion: deployed.bpVersion,\n    rpVersion: deployed.rpVersion,\n    ...(deployed.bpModuleUuid ? { bpModuleUuid: deployed.bpModuleUuid } : {}),\n    ...(deployed.rpModuleUuid ? { rpModuleUuid: deployed.rpModuleUuid } : {}),\n  };\n}"],
+  "mappings": "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",
+  "names": []
+}

package/dist/module-toggle.d.ts

@@ -0,0 +1,33 @@
+/**
+ * module-toggle.ts — 模块启停：本地 lock 权威 + 通知结果信封
+ *
+ * CLI 先写 module-lock.json；db 在线时再 best-effort HTTP 热同步。
+ * 纯函数与 IO 分离，供单测覆盖 resolve / lock patch / 结果判定。
+ */
+import type { ModuleLock } from "@sfmc-bds/sdk/node/config";
+export type ToggleCandidate = {
+    logicalId: string;
+    folderId: string;
+    configKey?: string;
+    canDisable: boolean;
+};
+export type ToggleNotify = {
+    ok: true;
+} | {
+    ok: false;
+    reason: "unreachable" | "http";
+    detail?: string;
+};
+export type ToggleFinalize = {
+    ok: boolean;
+    warnNotify: boolean;
+};
+/** 按 folderId / logicalId / configKey 解析启停目标（与 db resolveModuleByKey 对齐）。 */
+export declare function resolveToggleTarget(query: string, candidates: ToggleCandidate[]): ToggleCandidate | null;
+/** 就地更新 lock 条目（键为 manifest.id / logicalId）。 */
+export declare function applyLockEnabled(lock: ModuleLock, logicalId: string, enabled: boolean): ModuleLock;
+/**
+ * 本地已落盘时，通知失败仍算成功（warnNotify）；本地未写则失败。
+ */
+export declare function finalizeToggle(localWritten: boolean, notify: ToggleNotify): ToggleFinalize;
+//# sourceMappingURL=module-toggle.d.ts.map

package/dist/module-toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-toggle.d.ts","sourceRoot":"","sources":["../src/module-toggle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,eAAe,GAAG,IAAI,CAQxG;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CASlG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,cAAc,CAI1F"}

package/dist/module-toggle.js

@@ -0,0 +1,28 @@
+function resolveToggleTarget(query, candidates) {
+  const k = String(query || "").trim();
+  if (!k) return null;
+  return candidates.find(
+    (c) => c.folderId === k || c.logicalId === k || c.configKey != null && c.configKey === k
+  ) ?? null;
+}
+function applyLockEnabled(lock, logicalId, enabled) {
+  const modules = lock.modules && typeof lock.modules === "object" ? lock.modules : {};
+  lock.modules = modules;
+  lock.version = typeof lock.version === "number" ? lock.version : 1;
+  modules[logicalId] = {
+    enabled: !!enabled,
+    updatedAt: Date.now()
+  };
+  return lock;
+}
+function finalizeToggle(localWritten, notify) {
+  if (!localWritten) return { ok: false, warnNotify: false };
+  if (notify.ok) return { ok: true, warnNotify: false };
+  return { ok: true, warnNotify: true };
+}
+export {
+  applyLockEnabled,
+  finalizeToggle,
+  resolveToggleTarget
+};
+//# sourceMappingURL=module-toggle.js.map

package/dist/module-toggle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/module-toggle.ts"],
+  "sourcesContent": ["/**\n * module-toggle.ts \u2014 \u6A21\u5757\u542F\u505C\uFF1A\u672C\u5730 lock \u6743\u5A01 + \u901A\u77E5\u7ED3\u679C\u4FE1\u5C01\n *\n * CLI \u5148\u5199 module-lock.json\uFF1Bdb \u5728\u7EBF\u65F6\u518D best-effort HTTP \u70ED\u540C\u6B65\u3002\n * \u7EAF\u51FD\u6570\u4E0E IO \u5206\u79BB\uFF0C\u4F9B\u5355\u6D4B\u8986\u76D6 resolve / lock patch / \u7ED3\u679C\u5224\u5B9A\u3002\n */\n\nimport type { ModuleLock } from \"@sfmc-bds/sdk/node/config\";\n\nexport type ToggleCandidate = {\n  logicalId: string;\n  folderId: string;\n  configKey?: string;\n  canDisable: boolean;\n};\n\nexport type ToggleNotify =\n  | { ok: true }\n  | { ok: false; reason: \"unreachable\" | \"http\"; detail?: string };\n\nexport type ToggleFinalize = { ok: boolean; warnNotify: boolean };\n\n/** \u6309 folderId / logicalId / configKey \u89E3\u6790\u542F\u505C\u76EE\u6807\uFF08\u4E0E db resolveModuleByKey \u5BF9\u9F50\uFF09\u3002 */\nexport function resolveToggleTarget(query: string, candidates: ToggleCandidate[]): ToggleCandidate | null {\n  const k = String(query || \"\").trim();\n  if (!k) return null;\n  return (\n    candidates.find(\n      (c) => c.folderId === k || c.logicalId === k || (c.configKey != null && c.configKey === k)\n    ) ?? null\n  );\n}\n\n/** \u5C31\u5730\u66F4\u65B0 lock \u6761\u76EE\uFF08\u952E\u4E3A manifest.id / logicalId\uFF09\u3002 */\nexport function applyLockEnabled(lock: ModuleLock, logicalId: string, enabled: boolean): ModuleLock {\n  const modules = lock.modules && typeof lock.modules === \"object\" ? lock.modules : {};\n  lock.modules = modules;\n  lock.version = typeof lock.version === \"number\" ? lock.version : 1;\n  modules[logicalId] = {\n    enabled: !!enabled,\n    updatedAt: Date.now(),\n  };\n  return lock;\n}\n\n/**\n * \u672C\u5730\u5DF2\u843D\u76D8\u65F6\uFF0C\u901A\u77E5\u5931\u8D25\u4ECD\u7B97\u6210\u529F\uFF08warnNotify\uFF09\uFF1B\u672C\u5730\u672A\u5199\u5219\u5931\u8D25\u3002\n */\nexport function finalizeToggle(localWritten: boolean, notify: ToggleNotify): ToggleFinalize {\n  if (!localWritten) return { ok: false, warnNotify: false };\n  if (notify.ok) return { ok: true, warnNotify: false };\n  return { ok: true, warnNotify: true };\n}\n"],
+  "mappings": "AAuBO,SAAS,oBAAoB,OAAe,YAAuD;AACxG,QAAM,IAAI,OAAO,SAAS,EAAE,EAAE,KAAK;AACnC,MAAI,CAAC,EAAG,QAAO;AACf,SACE,WAAW;AAAA,IACT,CAAC,MAAM,EAAE,aAAa,KAAK,EAAE,cAAc,KAAM,EAAE,aAAa,QAAQ,EAAE,cAAc;AAAA,EAC1F,KAAK;AAET;AAGO,SAAS,iBAAiB,MAAkB,WAAmB,SAA8B;AAClG,QAAM,UAAU,KAAK,WAAW,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU,CAAC;AACnF,OAAK,UAAU;AACf,OAAK,UAAU,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU;AACjE,UAAQ,SAAS,IAAI;AAAA,IACnB,SAAS,CAAC,CAAC;AAAA,IACX,WAAW,KAAK,IAAI;AAAA,EACtB;AACA,SAAO;AACT;AAKO,SAAS,eAAe,cAAuB,QAAsC;AAC1F,MAAI,CAAC,aAAc,QAAO,EAAE,IAAI,OAAO,YAAY,MAAM;AACzD,MAAI,OAAO,GAAI,QAAO,EAAE,IAAI,MAAM,YAAY,MAAM;AACpD,SAAO,EAAE,IAAI,MAAM,YAAY,KAAK;AACtC;",
+  "names": []
+}

package/dist/module-toggle.test.js

@@ -0,0 +1,37 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { applyLockEnabled, finalizeToggle, resolveToggleTarget } from "./module-toggle.js";
+const candidates = [
+  { logicalId: "feature-afk", folderId: "afk", configKey: "afk", canDisable: true },
+  { logicalId: "core-gui", folderId: "gui", configKey: "gui", canDisable: false }
+];
+test("resolveToggleTarget\uFF1AfolderId / logicalId / configKey", () => {
+  assert.equal(resolveToggleTarget("afk", candidates)?.logicalId, "feature-afk");
+  assert.equal(resolveToggleTarget("feature-afk", candidates)?.logicalId, "feature-afk");
+  assert.equal(resolveToggleTarget("afk", candidates)?.folderId, "afk");
+  assert.equal(resolveToggleTarget("missing", candidates), null);
+});
+test("resolveToggleTarget\uFF1AcanDisable \u6765\u81EA\u5019\u9009", () => {
+  assert.equal(resolveToggleTarget("gui", candidates)?.canDisable, false);
+  assert.equal(resolveToggleTarget("core-gui", candidates)?.canDisable, false);
+});
+test("applyLockEnabled\uFF1A\u5199\u5165 enabled + updatedAt", () => {
+  const lock = { version: 1, modules: {} };
+  const next = applyLockEnabled(lock, "feature-afk", true);
+  assert.equal(next.modules["feature-afk"]?.enabled, true);
+  assert.equal(typeof next.modules["feature-afk"]?.updatedAt, "number");
+  assert.equal(lock.modules["feature-afk"]?.enabled, true);
+});
+test("finalizeToggle\uFF1A\u672C\u5730\u5DF2\u5199 + \u901A\u77E5\u5931\u8D25 \u2192 ok \u4E14 warn", () => {
+  assert.deepEqual(finalizeToggle(true, { ok: true }), { ok: true, warnNotify: false });
+  assert.deepEqual(finalizeToggle(true, { ok: false, reason: "unreachable" }), {
+    ok: true,
+    warnNotify: true
+  });
+  assert.deepEqual(finalizeToggle(true, { ok: false, reason: "http", detail: "x" }), {
+    ok: true,
+    warnNotify: true
+  });
+  assert.deepEqual(finalizeToggle(false, { ok: true }), { ok: false, warnNotify: false });
+});
+//# sourceMappingURL=module-toggle.test.js.map

package/dist/module-toggle.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/module-toggle.test.ts"],
+  "sourcesContent": ["/**\n * module-toggle \u672C\u5730\u5199 lock + \u901A\u77E5\u7ED3\u679C\u4FE1\u5C01\uFF08\u7EAF\u51FD\u6570\uFF09\n */\nimport assert from \"node:assert/strict\";\nimport test from \"node:test\";\nimport { applyLockEnabled, finalizeToggle, resolveToggleTarget } from \"./module-toggle.js\";\n\nconst candidates = [\n  { logicalId: \"feature-afk\", folderId: \"afk\", configKey: \"afk\", canDisable: true },\n  { logicalId: \"core-gui\", folderId: \"gui\", configKey: \"gui\", canDisable: false },\n];\n\ntest(\"resolveToggleTarget\uFF1AfolderId / logicalId / configKey\", () => {\n  assert.equal(resolveToggleTarget(\"afk\", candidates)?.logicalId, \"feature-afk\");\n  assert.equal(resolveToggleTarget(\"feature-afk\", candidates)?.logicalId, \"feature-afk\");\n  assert.equal(resolveToggleTarget(\"afk\", candidates)?.folderId, \"afk\");\n  assert.equal(resolveToggleTarget(\"missing\", candidates), null);\n});\n\ntest(\"resolveToggleTarget\uFF1AcanDisable \u6765\u81EA\u5019\u9009\", () => {\n  assert.equal(resolveToggleTarget(\"gui\", candidates)?.canDisable, false);\n  assert.equal(resolveToggleTarget(\"core-gui\", candidates)?.canDisable, false);\n});\n\ntest(\"applyLockEnabled\uFF1A\u5199\u5165 enabled + updatedAt\", () => {\n  const lock = { version: 1, modules: {} as Record<string, { enabled: boolean; updatedAt?: number }> };\n  const next = applyLockEnabled(lock, \"feature-afk\", true);\n  assert.equal(next.modules[\"feature-afk\"]?.enabled, true);\n  assert.equal(typeof next.modules[\"feature-afk\"]?.updatedAt, \"number\");\n  assert.equal(lock.modules[\"feature-afk\"]?.enabled, true);\n});\n\ntest(\"finalizeToggle\uFF1A\u672C\u5730\u5DF2\u5199 + \u901A\u77E5\u5931\u8D25 \u2192 ok \u4E14 warn\", () => {\n  assert.deepEqual(finalizeToggle(true, { ok: true }), { ok: true, warnNotify: false });\n  assert.deepEqual(finalizeToggle(true, { ok: false, reason: \"unreachable\" }), {\n    ok: true,\n    warnNotify: true,\n  });\n  assert.deepEqual(finalizeToggle(true, { ok: false, reason: \"http\", detail: \"x\" }), {\n    ok: true,\n    warnNotify: true,\n  });\n  assert.deepEqual(finalizeToggle(false, { ok: true }), { ok: false, warnNotify: false });\n});\n"],
+  "mappings": "AAGA,OAAO,YAAY;AACnB,OAAO,UAAU;AACjB,SAAS,kBAAkB,gBAAgB,2BAA2B;AAEtE,MAAM,aAAa;AAAA,EACjB,EAAE,WAAW,eAAe,UAAU,OAAO,WAAW,OAAO,YAAY,KAAK;AAAA,EAChF,EAAE,WAAW,YAAY,UAAU,OAAO,WAAW,OAAO,YAAY,MAAM;AAChF;AAEA,KAAK,6DAAwD,MAAM;AACjE,SAAO,MAAM,oBAAoB,OAAO,UAAU,GAAG,WAAW,aAAa;AAC7E,SAAO,MAAM,oBAAoB,eAAe,UAAU,GAAG,WAAW,aAAa;AACrF,SAAO,MAAM,oBAAoB,OAAO,UAAU,GAAG,UAAU,KAAK;AACpE,SAAO,MAAM,oBAAoB,WAAW,UAAU,GAAG,IAAI;AAC/D,CAAC;AAED,KAAK,gEAAuC,MAAM;AAChD,SAAO,MAAM,oBAAoB,OAAO,UAAU,GAAG,YAAY,KAAK;AACtE,SAAO,MAAM,oBAAoB,YAAY,UAAU,GAAG,YAAY,KAAK;AAC7E,CAAC;AAED,KAAK,0DAA2C,MAAM;AACpD,QAAM,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC,EAA8D;AACnG,QAAM,OAAO,iBAAiB,MAAM,eAAe,IAAI;AACvD,SAAO,MAAM,KAAK,QAAQ,aAAa,GAAG,SAAS,IAAI;AACvD,SAAO,MAAM,OAAO,KAAK,QAAQ,aAAa,GAAG,WAAW,QAAQ;AACpE,SAAO,MAAM,KAAK,QAAQ,aAAa,GAAG,SAAS,IAAI;AACzD,CAAC;AAED,KAAK,iGAA0C,MAAM;AACnD,SAAO,UAAU,eAAe,MAAM,EAAE,IAAI,KAAK,CAAC,GAAG,EAAE,IAAI,MAAM,YAAY,MAAM,CAAC;AACpF,SAAO,UAAU,eAAe,MAAM,EAAE,IAAI,OAAO,QAAQ,cAAc,CAAC,GAAG;AAAA,IAC3E,IAAI;AAAA,IACJ,YAAY;AAAA,EACd,CAAC;AACD,SAAO,UAAU,eAAe,MAAM,EAAE,IAAI,OAAO,QAAQ,QAAQ,QAAQ,IAAI,CAAC,GAAG;AAAA,IACjF,IAAI;AAAA,IACJ,YAAY;AAAA,EACd,CAAC;AACD,SAAO,UAAU,eAAe,OAAO,EAAE,IAAI,KAAK,CAAC,GAAG,EAAE,IAAI,OAAO,YAAY,MAAM,CAAC;AACxF,CAAC;",
+  "names": []
+}

package/dist/node-service-probe.d.ts

@@ -0,0 +1,18 @@
+/**
+ * node-service-probe.ts — 按入口脚本探测 / 终止「外部」node 服务（db / qq）
+ *
+ * CLI 未托管（无 ChildProcess 句柄）时，stop/restart 仍须能杀干净，避免双实例。
+ */
+/** 可按脚本路径杀的 node 服务 */
+export type NodeServiceName = "db" | "qq";
+/** cmdline 匹配用稳定子串（跨 monorepo / npm 布局） */
+export declare const SCRIPT_HINT: Record<NodeServiceName, string>;
+/**
+ * 查找匹配入口脚本的存活 PID（不含当前 CLI 进程）。
+ */
+export declare function findNodeServicePids(service: NodeServiceName): Promise<number[]>;
+/**
+ * 终止匹配脚本的全部外部实例；返回尝试杀掉的 PID 列表。
+ */
+export declare function killNodeServiceByScript(service: NodeServiceName): Promise<number[]>;
+//# sourceMappingURL=node-service-probe.d.ts.map

package/dist/node-service-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-service-probe.d.ts","sourceRoot":"","sources":["../src/node-service-probe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,uBAAuB;AACvB,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C,2CAA2C;AAC3C,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAGvD,CAAC;AAuDF;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOrF;AAUD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBzF"}