@sfmc-bds/cli 0.2.2 → 0.2.4

package/dist/module-fingerprint.js

@@ -1,6 +1,10 @@
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
+function shouldSkipModuleEntry(parentDirName, name) {
+  if (name.startsWith(".") || name === "node_modules" || name === "dist") return true;
+  return name === "data" && parentDirName === "map-server";
+}
 async function dirFingerprint(rootDir) {
   const hash = createHash("sha256");
   const entries = [];
@@ -9,7 +13,7 @@ async function dirFingerprint(rootDir) {
     const items = await fs.readdir(full, { withFileTypes: true });
     const sorted = items.sort((a, b) => a.name.localeCompare(b.name));
     for (const it of sorted) {
-      if (it.name.startsWith(".") || it.name === "node_modules" || it.name === "dist") continue;
+      if (shouldSkipModuleEntry(path.posix.basename(rel), it.name)) continue;
       const child = rel ? `${rel}/${it.name}` : it.name;
       if (it.isDirectory()) await walk(child);
       else if (it.isFile()) entries.push(child);
@@ -18,7 +22,12 @@ async function dirFingerprint(rootDir) {
   await walk("");
   entries.sort();
   for (const rel of entries) {
-    const data = await fs.readFile(path.join(rootDir, rel));
+    let data;
+    try {
+      data = await fs.readFile(path.join(rootDir, rel));
+    } catch {
+      continue;
+    }
     hash.update(rel.replaceAll("\\", "/"));
     hash.update("\n");
     hash.update(data);
@@ -27,6 +36,7 @@ async function dirFingerprint(rootDir) {
   return hash.digest("hex");
 }
 export {
-  dirFingerprint
+  dirFingerprint,
+  shouldSkipModuleEntry
 };
 //# sourceMappingURL=module-fingerprint.js.map

package/dist/module-fingerprint.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/module-fingerprint.ts"],
-  "sourcesContent": ["/**\n * module-fingerprint.ts \u2014 \u6A21\u5757\u76EE\u5F55 canonical SHA-256\n * (\u4E0E\u539F\u5148 module-commands \u5185 dirFingerprint \u7B97\u6CD5\u4E00\u81F4,\u4F9B catalog / verify \u5171\u7528)\u3002\n */\n\nimport { createHash } from \"node:crypto\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/** Compute the canonical SHA-256 of a module directory (POSIX `find ... | sha256sum` compatible). */\nexport async function dirFingerprint(rootDir: string): Promise<string> {\n  const hash = createHash(\"sha256\");\n  const entries: string[] = [];\n  async function walk(rel: string): Promise<void> {\n    const full = path.join(rootDir, rel);\n    const items = await fs.readdir(full, { withFileTypes: true });\n    const sorted = items.sort((a, b) => a.name.localeCompare(b.name));\n    for (const it of sorted) {\n      if (it.name.startsWith(\".\") || it.name === \"node_modules\" || it.name === \"dist\") continue;\n      const child = rel ? `${rel}/${it.name}` : it.name;\n      if (it.isDirectory()) await walk(child);\n      else if (it.isFile()) entries.push(child);\n    }\n  }\n  await walk(\"\");\n  entries.sort();\n  for (const rel of entries) {\n    const data = await fs.readFile(path.join(rootDir, rel));\n    hash.update(rel.replaceAll(\"\\\\\", \"/\"));\n    hash.update(\"\\n\");\n    hash.update(data);\n    hash.update(\"\\n\");\n  }\n  return hash.digest(\"hex\");\n}\n"],
-  "mappings": "AAKA,SAAS,kBAAkB;AAC3B,OAAO,QAAQ;AACf,OAAO,UAAU;AAGjB,eAAsB,eAAe,SAAkC;AACrE,QAAM,OAAO,WAAW,QAAQ;AAChC,QAAM,UAAoB,CAAC;AAC3B,iBAAe,KAAK,KAA4B;AAC9C,UAAM,OAAO,KAAK,KAAK,SAAS,GAAG;AACnC,UAAM,QAAQ,MAAM,GAAG,QAAQ,MAAM,EAAE,eAAe,KAAK,CAAC;AAC5D,UAAM,SAAS,MAAM,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAChE,eAAW,MAAM,QAAQ;AACvB,UAAI,GAAG,KAAK,WAAW,GAAG,KAAK,GAAG,SAAS,kBAAkB,GAAG,SAAS,OAAQ;AACjF,YAAM,QAAQ,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI,KAAK,GAAG;AAC7C,UAAI,GAAG,YAAY,EAAG,OAAM,KAAK,KAAK;AAAA,eAC7B,GAAG,OAAO,EAAG,SAAQ,KAAK,KAAK;AAAA,IAC1C;AAAA,EACF;AACA,QAAM,KAAK,EAAE;AACb,UAAQ,KAAK;AACb,aAAW,OAAO,SAAS;AACzB,UAAM,OAAO,MAAM,GAAG,SAAS,KAAK,KAAK,SAAS,GAAG,CAAC;AACtD,SAAK,OAAO,IAAI,WAAW,MAAM,GAAG,CAAC;AACrC,SAAK,OAAO,IAAI;AAChB,SAAK,OAAO,IAAI;AAChB,SAAK,OAAO,IAAI;AAAA,EAClB;AACA,SAAO,KAAK,OAAO,KAAK;AAC1B;",
+  "sourcesContent": ["/**\n * module-fingerprint.ts \u2014 \u6A21\u5757\u76EE\u5F55 canonical SHA-256\n * (\u4E0E\u539F\u5148 module-commands \u5185 dirFingerprint \u7B97\u6CD5\u4E00\u81F4,\u4F9B catalog / verify \u5171\u7528)\u3002\n */\n\nimport { createHash } from \"node:crypto\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/**\n * \u6A21\u5757\u76EE\u5F55\u626B\u63CF\u65F6\u8981\u8DF3\u8FC7\u7684\u540D\u5B57\u3002\n * \u4F7F\u7528\u573A\u666F\uFF1A\u6307\u7EB9\u548C\u4F53\u79EF\u7EDF\u8BA1\u5171\u7528\u3002map-server/data \u662F\u5730\u56FE\u5FEB\u7167\uFF0C\u626B\u8FDB\u53BB\u4F1A\u8BA9 CLI \u542F\u52A8\u5361\u6B7B\u3002\n */\nexport function shouldSkipModuleEntry(parentDirName: string, name: string): boolean {\n  if (name.startsWith(\".\") || name === \"node_modules\" || name === \"dist\") return true;\n  return name === \"data\" && parentDirName === \"map-server\";\n}\n\n/** Compute the canonical SHA-256 of a module directory (POSIX `find ... | sha256sum` compatible). */\nexport async function dirFingerprint(rootDir: string): Promise<string> {\n  const hash = createHash(\"sha256\");\n  const entries: string[] = [];\n  async function walk(rel: string): Promise<void> {\n    const full = path.join(rootDir, rel);\n    const items = await fs.readdir(full, { withFileTypes: true });\n    const sorted = items.sort((a, b) => a.name.localeCompare(b.name));\n    for (const it of sorted) {\n      if (shouldSkipModuleEntry(path.posix.basename(rel), it.name)) continue;\n      const child = rel ? `${rel}/${it.name}` : it.name;\n      if (it.isDirectory()) await walk(child);\n      else if (it.isFile()) entries.push(child);\n    }\n  }\n  await walk(\"\");\n  entries.sort();\n  for (const rel of entries) {\n    let data: Buffer;\n    try {\n      data = await fs.readFile(path.join(rootDir, rel));\n    } catch {\n      // \u5355\u4E2A\u6587\u4EF6\u6253\u4E0D\u5F00\u65F6\u8DF3\u8FC7\uFF0C\u907F\u514D\u6574\u6B21\u542F\u52A8\u5931\u8D25\n      continue;\n    }\n    hash.update(rel.replaceAll(\"\\\\\", \"/\"));\n    hash.update(\"\\n\");\n    hash.update(data);\n    hash.update(\"\\n\");\n  }\n  return hash.digest(\"hex\");\n}\n"],
+  "mappings": "AAKA,SAAS,kBAAkB;AAC3B,OAAO,QAAQ;AACf,OAAO,UAAU;AAMV,SAAS,sBAAsB,eAAuB,MAAuB;AAClF,MAAI,KAAK,WAAW,GAAG,KAAK,SAAS,kBAAkB,SAAS,OAAQ,QAAO;AAC/E,SAAO,SAAS,UAAU,kBAAkB;AAC9C;AAGA,eAAsB,eAAe,SAAkC;AACrE,QAAM,OAAO,WAAW,QAAQ;AAChC,QAAM,UAAoB,CAAC;AAC3B,iBAAe,KAAK,KAA4B;AAC9C,UAAM,OAAO,KAAK,KAAK,SAAS,GAAG;AACnC,UAAM,QAAQ,MAAM,GAAG,QAAQ,MAAM,EAAE,eAAe,KAAK,CAAC;AAC5D,UAAM,SAAS,MAAM,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAChE,eAAW,MAAM,QAAQ;AACvB,UAAI,sBAAsB,KAAK,MAAM,SAAS,GAAG,GAAG,GAAG,IAAI,EAAG;AAC9D,YAAM,QAAQ,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI,KAAK,GAAG;AAC7C,UAAI,GAAG,YAAY,EAAG,OAAM,KAAK,KAAK;AAAA,eAC7B,GAAG,OAAO,EAAG,SAAQ,KAAK,KAAK;AAAA,IAC1C;AAAA,EACF;AACA,QAAM,KAAK,EAAE;AACb,UAAQ,KAAK;AACb,aAAW,OAAO,SAAS;AACzB,QAAI;AACJ,QAAI;AACF,aAAO,MAAM,GAAG,SAAS,KAAK,KAAK,SAAS,GAAG,CAAC;AAAA,IAClD,QAAQ;AAEN;AAAA,IACF;AACA,SAAK,OAAO,IAAI,WAAW,MAAM,GAAG,CAAC;AACrC,SAAK,OAAO,IAAI;AAChB,SAAK,OAAO,IAAI;AAChB,SAAK,OAAO,IAAI;AAAA,EAClB;AACA,SAAO,KAAK,OAAO,KAAK;AAC1B;",
   "names": []
 }

package/dist/module-sidecars.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 模块随 BDS 启动的附属进程。
+ * 使用场景：开服前扫描 modules/packages/<id>/sidecar.json。
+ * 目前 Bluemap 用它拉起地图进程；日志正文由脚本打进 BDS，这里只报告启动和退出。
+ */
+/**
+ * 在 BDS 进程拉起之前启动附属进程。
+ * 使用场景：services.ts 里 bds 的 start，在 beforeStart 之后调用。
+ */
+export declare function startModuleSidecars(root: string, log: (line: string, stream: "stdout" | "stderr") => void): Promise<void>;
+/**
+ * 结束本轮由开服拉起的附属进程。
+ * 使用场景：BDS 服务 cleanup 时调用。用户自己另开的地图进程不会被关掉。
+ */
+export declare function stopModuleSidecars(): void;
+//# sourceMappingURL=module-sidecars.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module-sidecars.d.ts","sourceRoot":"","sources":["../src/module-sidecars.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+FH;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,GACvD,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CASzC"}

package/dist/module-sidecars.js

@@ -0,0 +1,116 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import net from "node:net";
+import path from "node:path";
+const children = /* @__PURE__ */ new Map();
+function readJson(file) {
+  try {
+    const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+    return parsed && typeof parsed === "object" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function readPath(source, dotted) {
+  let current = source;
+  for (const part of dotted.split(".")) {
+    if (!current || typeof current !== "object") return void 0;
+    current = current[part];
+  }
+  return current;
+}
+function isEnabled(root, spec) {
+  if (!spec.when || !spec.configFile) return true;
+  const config = readJson(path.join(root, spec.configFile));
+  if (!config) return true;
+  const flag = readPath(config, spec.when);
+  return flag !== false;
+}
+function configuredPort(root, spec) {
+  if (!spec.configFile) return 0;
+  const config = readJson(path.join(root, spec.configFile));
+  const port = config?.port;
+  return typeof port === "number" && port > 0 && port < 65536 ? port : 0;
+}
+function portOpen(port) {
+  if (!port) return Promise.resolve(false);
+  return new Promise((resolve) => {
+    const socket = net.connect({ host: "127.0.0.1", port });
+    const done = (open) => {
+      socket.removeAllListeners();
+      socket.destroy();
+      resolve(open);
+    };
+    socket.once("connect", () => done(true));
+    socket.once("error", () => done(false));
+    socket.setTimeout(500, () => done(false));
+  });
+}
+function loadSpecs(root) {
+  const packagesDir = path.join(root, "modules", "packages");
+  if (!fs.existsSync(packagesDir)) return [];
+  const found = [];
+  for (const entry of fs.readdirSync(packagesDir, { withFileTypes: true })) {
+    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
+    const dir = path.join(packagesDir, entry.name);
+    const file = path.join(dir, "sidecar.json");
+    if (!fs.existsSync(file)) continue;
+    const raw = readJson(file);
+    if (!raw || typeof raw.id !== "string" || typeof raw.entry !== "string") continue;
+    const lock = readJson(path.join(root, "modules", "module-lock.json"));
+    const modules = lock?.modules && typeof lock.modules === "object" ? lock.modules : {};
+    const row = modules[raw.id];
+    const enabled = !row || typeof row !== "object" || row.enabled !== false;
+    if (!enabled) continue;
+    const spec = { id: raw.id, entry: raw.entry };
+    if (typeof raw.configFile === "string") spec.configFile = raw.configFile;
+    if (typeof raw.when === "string") spec.when = raw.when;
+    found.push({ spec, dir });
+  }
+  return found;
+}
+async function startModuleSidecars(root, log) {
+  for (const { spec, dir } of loadSpecs(root)) {
+    if (children.has(spec.id)) continue;
+    if (!isEnabled(root, spec)) continue;
+    const entry = path.join(dir, spec.entry);
+    if (!fs.existsSync(entry)) {
+      log(`[${spec.id}] \u672A\u627E\u5230\u9644\u5C5E\u8FDB\u7A0B\u5165\u53E3: ${entry}`, "stderr");
+      continue;
+    }
+    const port = configuredPort(root, spec);
+    if (await portOpen(port)) {
+      log(`[${spec.id}] \u7AEF\u53E3 ${port} \u5DF2\u5728\u76D1\u542C\uFF0C\u8DF3\u8FC7\u542F\u52A8\u3002`, "stdout");
+      continue;
+    }
+    const child = spawn(process.execPath, [entry], {
+      cwd: dir,
+      env: { ...process.env, SFMC_ROOT: root },
+      windowsHide: true,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    children.set(spec.id, child);
+    log(`[${spec.id}] \u5DF2\u968F\u670D\u52A1\u5668\u542F\u52A8\u9644\u5C5E\u8FDB\u7A0B (PID ${child.pid ?? 0})`, "stdout");
+    child.on("exit", (code) => {
+      if (children.get(spec.id) === child) children.delete(spec.id);
+      log(`[${spec.id}] \u9644\u5C5E\u8FDB\u7A0B\u9000\u51FA (code ${code ?? "?"})`, code === 0 ? "stdout" : "stderr");
+    });
+    child.on("error", (err) => {
+      log(`[${spec.id}] \u9644\u5C5E\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${err.message}`, "stderr");
+    });
+  }
+}
+function stopModuleSidecars() {
+  for (const [id, child] of children) {
+    children.delete(id);
+    try {
+      child.kill();
+    } catch {
+    }
+  }
+}
+export {
+  startModuleSidecars,
+  stopModuleSidecars
+};
+//# sourceMappingURL=module-sidecars.js.map

package/dist/module-sidecars.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/module-sidecars.ts"],
+  "sourcesContent": ["/**\n * \u6A21\u5757\u968F BDS \u542F\u52A8\u7684\u9644\u5C5E\u8FDB\u7A0B\u3002\n * \u4F7F\u7528\u573A\u666F\uFF1A\u5F00\u670D\u524D\u626B\u63CF modules/packages/<id>/sidecar.json\u3002\n * \u76EE\u524D Bluemap \u7528\u5B83\u62C9\u8D77\u5730\u56FE\u8FDB\u7A0B\uFF1B\u65E5\u5FD7\u6B63\u6587\u7531\u811A\u672C\u6253\u8FDB BDS\uFF0C\u8FD9\u91CC\u53EA\u62A5\u544A\u542F\u52A8\u548C\u9000\u51FA\u3002\n */\n\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport net from \"node:net\";\nimport path from \"node:path\";\n\n/** \u6A21\u5757\u5305\u6839\u76EE\u5F55\u91CC\u7684 sidecar.json\u3002 */\ninterface SidecarSpec {\n  id: string;\n  /** \u76F8\u5BF9\u6A21\u5757\u5305\u6839\u76EE\u5F55\u7684 Node \u5165\u53E3\u3002 */\n  entry: string;\n  /** \u76F8\u5BF9 SFMC \u6839\u76EE\u5F55\u7684\u914D\u7F6E\u6587\u4EF6\u3002\u7F3A\u7701\u4E0D\u5224\u65AD\u5F00\u5173\u3002 */\n  configFile?: string;\n  /** \u914D\u7F6E\u91CC\u7684\u70B9\u8DEF\u5F84\u3002\u503C\u4E3A false \u65F6\u4E0D\u542F\u52A8\u3002\u7F3A\u7701\u89C6\u4E3A\u5F00\u542F\u3002 */\n  when?: string;\n}\n\n/** \u672C\u8F6E BDS \u62C9\u8D77\u7684\u9644\u5C5E\u8FDB\u7A0B\u3002\u505C\u670D\u65F6\u53EA\u7ED3\u675F\u8FD9\u4E9B\uFF0C\u4E0D\u78B0\u7528\u6237\u53E6\u5916\u5F00\u7684\u8FDB\u7A0B\u3002 */\nconst children = new Map<string, ChildProcess>();\n\nfunction readJson(file: string): Record<string, unknown> | null {\n  try {\n    const parsed = JSON.parse(fs.readFileSync(file, \"utf8\")) as unknown;\n    return parsed && typeof parsed === \"object\" ? (parsed as Record<string, unknown>) : null;\n  } catch {\n    return null;\n  }\n}\n\n/** \u6CBF\u70B9\u8DEF\u5F84\u53D6\u503C\u3002\u4E2D\u9014\u4E0D\u662F\u5BF9\u8C61\u5219\u8FD4\u56DE undefined\u3002 */\nfunction readPath(source: Record<string, unknown>, dotted: string): unknown {\n  let current: unknown = source;\n  for (const part of dotted.split(\".\")) {\n    if (!current || typeof current !== \"object\") return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n  return current;\n}\n\nfunction isEnabled(root: string, spec: SidecarSpec): boolean {\n  if (!spec.when || !spec.configFile) return true;\n  const config = readJson(path.join(root, spec.configFile));\n  if (!config) return true;\n  const flag = readPath(config, spec.when);\n  return flag !== false;\n}\n\nfunction configuredPort(root: string, spec: SidecarSpec): number {\n  if (!spec.configFile) return 0;\n  const config = readJson(path.join(root, spec.configFile));\n  const port = config?.port;\n  return typeof port === \"number\" && port > 0 && port < 65536 ? port : 0;\n}\n\n/** \u7AEF\u53E3\u5DF2\u6709\u8FDB\u7A0B\u76D1\u542C\u65F6\u4E0D\u518D\u542F\u52A8\u7B2C\u4E8C\u4E2A\u3002 */\nfunction portOpen(port: number): Promise<boolean> {\n  if (!port) return Promise.resolve(false);\n  return new Promise((resolve) => {\n    const socket = net.connect({ host: \"127.0.0.1\", port });\n    const done = (open: boolean) => {\n      socket.removeAllListeners();\n      socket.destroy();\n      resolve(open);\n    };\n    socket.once(\"connect\", () => done(true));\n    socket.once(\"error\", () => done(false));\n    socket.setTimeout(500, () => done(false));\n  });\n}\n\nfunction loadSpecs(root: string): Array<{ spec: SidecarSpec; dir: string }> {\n  const packagesDir = path.join(root, \"modules\", \"packages\");\n  if (!fs.existsSync(packagesDir)) return [];\n  const found: Array<{ spec: SidecarSpec; dir: string }> = [];\n  for (const entry of fs.readdirSync(packagesDir, { withFileTypes: true })) {\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n    const dir = path.join(packagesDir, entry.name);\n    const file = path.join(dir, \"sidecar.json\");\n    if (!fs.existsSync(file)) continue;\n    const raw = readJson(file);\n    if (!raw || typeof raw.id !== \"string\" || typeof raw.entry !== \"string\") continue;\n    const lock = readJson(path.join(root, \"modules\", \"module-lock.json\"));\n    const modules = lock?.modules && typeof lock.modules === \"object\" ? (lock.modules as Record<string, unknown>) : {};\n    const row = modules[raw.id];\n    const enabled = !row || typeof row !== \"object\" || (row as { enabled?: boolean }).enabled !== false;\n    if (!enabled) continue;\n    const spec: SidecarSpec = { id: raw.id, entry: raw.entry };\n    if (typeof raw.configFile === \"string\") spec.configFile = raw.configFile;\n    if (typeof raw.when === \"string\") spec.when = raw.when;\n    found.push({ spec, dir });\n  }\n  return found;\n}\n\n/**\n * \u5728 BDS \u8FDB\u7A0B\u62C9\u8D77\u4E4B\u524D\u542F\u52A8\u9644\u5C5E\u8FDB\u7A0B\u3002\n * \u4F7F\u7528\u573A\u666F\uFF1Aservices.ts \u91CC bds \u7684 start\uFF0C\u5728 beforeStart \u4E4B\u540E\u8C03\u7528\u3002\n */\nexport async function startModuleSidecars(\n  root: string,\n  log: (line: string, stream: \"stdout\" | \"stderr\") => void\n): Promise<void> {\n  for (const { spec, dir } of loadSpecs(root)) {\n    if (children.has(spec.id)) continue;\n    if (!isEnabled(root, spec)) continue;\n    const entry = path.join(dir, spec.entry);\n    if (!fs.existsSync(entry)) {\n      log(`[${spec.id}] \u672A\u627E\u5230\u9644\u5C5E\u8FDB\u7A0B\u5165\u53E3: ${entry}`, \"stderr\");\n      continue;\n    }\n    const port = configuredPort(root, spec);\n    if (await portOpen(port)) {\n      log(`[${spec.id}] \u7AEF\u53E3 ${port} \u5DF2\u5728\u76D1\u542C\uFF0C\u8DF3\u8FC7\u542F\u52A8\u3002`, \"stdout\");\n      continue;\n    }\n    const child = spawn(process.execPath, [entry], {\n      cwd: dir,\n      env: { ...process.env, SFMC_ROOT: root },\n      windowsHide: true,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n    children.set(spec.id, child);\n    log(`[${spec.id}] \u5DF2\u968F\u670D\u52A1\u5668\u542F\u52A8\u9644\u5C5E\u8FDB\u7A0B (PID ${child.pid ?? 0})`, \"stdout\");\n    child.on(\"exit\", (code) => {\n      if (children.get(spec.id) === child) children.delete(spec.id);\n      log(`[${spec.id}] \u9644\u5C5E\u8FDB\u7A0B\u9000\u51FA (code ${code ?? \"?\"})`, code === 0 ? \"stdout\" : \"stderr\");\n    });\n    child.on(\"error\", (err) => {\n      log(`[${spec.id}] \u9644\u5C5E\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${err.message}`, \"stderr\");\n    });\n  }\n}\n\n/**\n * \u7ED3\u675F\u672C\u8F6E\u7531\u5F00\u670D\u62C9\u8D77\u7684\u9644\u5C5E\u8FDB\u7A0B\u3002\n * \u4F7F\u7528\u573A\u666F\uFF1ABDS \u670D\u52A1 cleanup \u65F6\u8C03\u7528\u3002\u7528\u6237\u81EA\u5DF1\u53E6\u5F00\u7684\u5730\u56FE\u8FDB\u7A0B\u4E0D\u4F1A\u88AB\u5173\u6389\u3002\n */\nexport function stopModuleSidecars(): void {\n  for (const [id, child] of children) {\n    children.delete(id);\n    try {\n      child.kill();\n    } catch {\n      /* \u8FDB\u7A0B\u5DF2\u7ECF\u7ED3\u675F\u65F6\u5FFD\u7565\u3002 */\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/repl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAgN9B,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiD1D;AAcD,wBAAgB,OAAO,CAAC,IAAI,GAAE,WAAoB,GAAG,MAAM,CAE1D;AAofD,mCAAmC;AACnC,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAG9D,CAAC;AAmBJ,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAiS/C"}
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"AAcA,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AA+M9B,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiD1D;AAcD,wBAAgB,OAAO,CAAC,IAAI,GAAE,WAAoB,GAAG,MAAM,CAE1D;AAufD,mCAAmC;AACnC,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAG9D,CAAC;AAmBJ,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAkS/C"}

package/dist/repl.js

@@ -13,6 +13,7 @@ import {
   resolvePaletteView
 } from "./command-palette.js";
 import {
+  listNextPaletteTokens,
   listVisiblePacksSubs,
   listVisibleTopLevelNames,
   resolveModuleTopShorthand
@@ -24,7 +25,6 @@ import { t } from "./i18n/index.js";
 import { cmdLocale } from "./locale-command.js";
 import {
   formatLog,
-  getAllLogs,
   logPrefixWidth,
   onLog,
   readDiskLogs,
@@ -47,7 +47,7 @@ import {
   WindowHost
 } from "./repl-windows/index.js";
 import { SEND_TARGET_ORDER, paintSendPrompt, paintSfmcPrompt, plainPrompt } from "./send-target.js";
-import { forceStopAll, onServiceStateChange, queryServicesRuntime, SERVICE_NAMES, stopAll } from "./services.js";
+import { onServiceStateChange, queryServicesRuntime, SERVICE_NAMES } from "./services.js";
 import { c, T } from "./theme.js";
 import { dispatchPacksCommand, isPacksCommand } from "./world-packs.js";
 const REPL_MODE = "repl";
@@ -264,6 +264,8 @@ function getCompletions(parsed) {
     const cmds = getCommands().map((n) => n.startsWith("/") ? n : n);
     return ["/", ...cmds].filter(sw);
   }
+  const paletteNext = listNextPaletteTokens([cmd, ...words.slice(0, argIndex)], REPL_MODE);
+  if (paletteNext && paletteNext.length > 0) return paletteNext.filter(sw);
   switch (cmd) {
     case "logs":
     case "log":
@@ -277,7 +279,7 @@ function getCompletions(parsed) {
       if (argIndex === 0) return SERVICE_NAMES.filter(sw);
       return [];
     case "update":
-      return ["--check-only", "--force", "--channel=release", "--channel=preview"].filter(sw);
+      return ["--check-only", "--force", "--no-start", "--channel=release", "--channel=preview"].filter(sw);
     case "packs":
     case "addon":
       if (argIndex === 0) return [...listVisiblePacksSubs(REPL_MODE)].filter(sw);
@@ -648,9 +650,11 @@ function writeLogLineToTty(wrapped) {
 }
 async function startRepl() {
   let stopping = false;
+  let disconnectDaemon = null;
   const onSigint = () => {
-    stdout.write(c.yellow("\n" + t("repl.forceStop") + "\n"));
-    forceStopAll();
+    stdout.write(c.yellow("\n" + t("repl.detach") + "\n"));
+    disconnectDaemon?.();
+    disconnectDaemon = null;
     process.exit(130);
   };
   const shutdown = async () => {
@@ -658,8 +662,9 @@ async function startRepl() {
     stopping = true;
     process.off("SIGINT", onSigint);
     openLogsWindowHook = null;
-    stdout.write(c.dim(t("repl.stopping") + "\n"));
-    await stopAll();
+    stdout.write(c.dim(t("repl.detach") + "\n"));
+    disconnectDaemon?.();
+    disconnectDaemon = null;
     try {
       setRaw(false);
       stdin.pause();
@@ -669,6 +674,13 @@ async function startRepl() {
     process.exit(0);
   };
   process.on("SIGINT", onSigint);
+  try {
+    const { ensureDaemonSubscription } = await import("./daemon/client.js");
+    disconnectDaemon = await ensureDaemonSubscription();
+  } catch (e) {
+    stdout.write(c.red(t("daemon.connectFailed", { message: e.message })) + "\n");
+    process.exit(1);
+  }
   if (!stdin.isTTY) {
     console.log(c.dim(t("repl.nonInteractive")));
     for await (const line of (await import("node:readline/promises")).createInterface({
@@ -705,24 +717,17 @@ async function startRepl() {
     stdout.write("\x1B[3J");
   }
   function seedWindowBuffer(w) {
+    const f = w.getReplayFilter?.() ?? { levels: [], sources: [] };
+    const disk = readDiskLogs({
+      levels: f.levels,
+      sources: f.sources,
+      limit: 5e3
+    });
     const lines = [];
-    if (w.id === "logs") {
-      const f = w.getReplayFilter?.() ?? { levels: [], sources: [] };
-      const disk = readDiskLogs({
-        levels: f.levels,
-        sources: f.sources
-      });
-      for (const log of disk) {
-        if (!w.acceptLog(log)) continue;
-        const { text, indent } = w.formatLogLine(log);
-        lines.push(wrapLogLine(text, indent));
-      }
-    } else {
-      for (const log of getAllLogs()) {
-        if (!w.acceptLog(log)) continue;
-        const { text, indent } = w.formatLogLine(log);
-        lines.push(wrapLogLine(text, indent));
-      }
+    for (const log of disk) {
+      if (!w.acceptLog(log)) continue;
+      const { text, indent } = w.formatLogLine(log);
+      lines.push(wrapLogLine(text, indent));
     }
     host.setBuffer(w.id, lines);
     return lines;
@@ -734,14 +739,8 @@ async function startRepl() {
       currentRedraw?.();
       return;
     }
-    let lines;
-    if (w.id === "logs") {
-      if (opts?.reseed) host.invalidateBuffer(w.id);
-      lines = host.hasBuffer(w.id) ? host.getBuffer(w.id) : seedWindowBuffer(w);
-    } else {
-      host.invalidateBuffer(w.id);
-      lines = seedWindowBuffer(w);
-    }
+    if (opts?.reseed) host.invalidateBuffer(w.id);
+    const lines = host.hasBuffer(w.id) ? host.getBuffer(w.id) : seedWindowBuffer(w);
     for (const l of lines) stdout.write(l + "\n");
     currentRedraw?.();
   }
@@ -967,6 +966,26 @@ async function execCmd(parts) {
       stdout.write(await cmdUi(args, { block: false }) + "\n");
       break;
     }
+    case "daemon": {
+      const sub = args[0];
+      if (sub === "stop") {
+        const { shutdownDaemon } = await import("./daemon/client.js");
+        const err = await shutdownDaemon();
+        stdout.write((err ? c.red(err) : c.dim(t("daemon.stopped"))) + "\n");
+      } else if (sub === "status" || !sub) {
+        const { readDaemonMeta } = await import("./daemon/paths.js");
+        const { isProcessAlive } = await import("@sfmc-bds/bds-tools/process-probe");
+        const meta2 = readDaemonMeta();
+        if (!meta2 || !await isProcessAlive(meta2.pid)) {
+          stdout.write(c.dim(t("daemon.notRunning")) + "\n");
+        } else {
+          stdout.write(c.green(t("daemon.running", { pid: String(meta2.pid) })) + "\n");
+        }
+      } else {
+        stdout.write(c.yellow(t("daemon.usage") + "\n"));
+      }
+      break;
+    }
     case "init": {
       const wasRaw = stdin.isRaw ?? false;
       setRaw(false);