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

package/dist/log-filter.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/log-filter.test.ts"],
+  "sourcesContent": ["/**\n * log-filter \u7EAF\u51FD\u6570\u8868\u9A71\u52A8\uFF08\u4E0D\u6D4B IO\uFF09\n */\nimport assert from \"node:assert/strict\";\nimport test from \"node:test\";\nimport { compileLogFilterRegex, evaluateLogFilter } from \"./log-filter.js\";\n\nconst entry = (over: Record<string, unknown> = {}) => ({\n  text: \"Player connected: Steve\",\n  source: \"bds\",\n  level: \"info\",\n  ...over,\n});\n\nconst baseCfg = (over: Record<string, unknown> = {}) => ({\n  enabled: true,\n  mode: \"drop\",\n  applyTo: \"display\",\n  rules: [],\n  ...over,\n});\n\ntest(\"enabled=false \u6C38\u4E0D\u4E22\u5F03\", () => {\n  const r = evaluateLogFilter(\n    entry(),\n    baseCfg({\n      enabled: false,\n      mode: \"keep\",\n      rules: [{ sources: [\"bds\"] }],\n    })\n  );\n  assert.equal(r.dropDisplay, false);\n  assert.equal(r.dropDisk, false);\n});\n\ntest(\"drop \u00D7 sources \u547D\u4E2D\u5219\u4E22\u5F03\u5C55\u793A\", () => {\n  const r = evaluateLogFilter(entry(), baseCfg({ rules: [{ sources: [\"bds\", \"pack\"] }] }));\n  assert.equal(r.matched, true);\n  assert.equal(r.dropDisplay, true);\n  assert.equal(r.dropDisk, false);\n});\n\ntest(\"drop \u00D7 sources \u672A\u547D\u4E2D\u5219\u4FDD\u7559\", () => {\n  const r = evaluateLogFilter(entry({ source: \"system\" }), baseCfg({ rules: [{ sources: [\"bds\"] }] }));\n  assert.equal(r.matched, false);\n  assert.equal(r.dropDisplay, false);\n});\n\ntest(\"drop \u00D7 levels\", () => {\n  const hit = evaluateLogFilter(entry({ level: \"debug\" }), baseCfg({ rules: [{ levels: [\"debug\", \"info\"] }] }));\n  const miss = evaluateLogFilter(entry({ level: \"error\" }), baseCfg({ rules: [{ levels: [\"debug\"] }] }));\n  assert.equal(hit.dropDisplay, true);\n  assert.equal(miss.dropDisplay, false);\n});\n\ntest(\"drop \u00D7 contains\uFF08\u5927\u5C0F\u5199\u654F\u611F\uFF09\", () => {\n  const hit = evaluateLogFilter(entry(), baseCfg({ rules: [{ contains: \"Player connected\" }] }));\n  const miss = evaluateLogFilter(entry(), baseCfg({ rules: [{ contains: \"player connected\" }] }));\n  assert.equal(hit.dropDisplay, true);\n  assert.equal(miss.dropDisplay, false);\n});\n\ntest(\"drop \u00D7 regex \u4E0E (?i) \u65D7\u6807\", () => {\n  const hit = evaluateLogFilter(\n    entry({ text: \"GAMERULE keepInventory\" }),\n    baseCfg({ rules: [{ regex: \"(?i)gamerule|syntax error\" }] })\n  );\n  const miss = evaluateLogFilter(entry({ text: \"hello\" }), baseCfg({ rules: [{ regex: \"(?i)gamerule\" }] }));\n  assert.equal(hit.dropDisplay, true);\n  assert.equal(miss.dropDisplay, false);\n  assert.ok(compileLogFilterRegex(\"(?i)ABC\")?.test(\"abc\"));\n  assert.equal(compileLogFilterRegex(\"(\"), null);\n});\n\ntest(\"\u540C\u6761 AND\uFF1Asources + contains \u987B\u540C\u65F6\u6EE1\u8DB3\", () => {\n  const both = evaluateLogFilter(entry(), baseCfg({ rules: [{ sources: [\"bds\"], contains: \"Player\" }] }));\n  const onlySource = evaluateLogFilter(\n    entry({ text: \"nope\" }),\n    baseCfg({ rules: [{ sources: [\"bds\"], contains: \"Player\" }] })\n  );\n  assert.equal(both.dropDisplay, true);\n  assert.equal(onlySource.dropDisplay, false);\n});\n\ntest(\"\u591A\u6761 OR\uFF1A\u4EFB\u4E00\u547D\u4E2D\u5373\u53EF\", () => {\n  const r = evaluateLogFilter(\n    entry({ source: \"pack\", text: \"done\" }),\n    baseCfg({\n      rules: [{ sources: [\"bds\"] }, { sources: [\"pack\"], contains: \"done\" }],\n    })\n  );\n  assert.equal(r.matched, true);\n  assert.equal(r.dropDisplay, true);\n});\n\ntest(\"rule.enabled=false \u8DF3\u8FC7\", () => {\n  const r = evaluateLogFilter(entry(), baseCfg({ rules: [{ enabled: false, sources: [\"bds\"] }] }));\n  assert.equal(r.matched, false);\n  assert.equal(r.dropDisplay, false);\n});\n\ntest(\"keep \u6A21\u5F0F\uFF1A\u4EC5\u4FDD\u7559\u5339\u914D\uFF0C\u672A\u5339\u914D\u4E22\u5F03\", () => {\n  const cfg = baseCfg({\n    mode: \"keep\",\n    rules: [{ levels: [\"error\"] }],\n  });\n  const keep = evaluateLogFilter(entry({ level: \"error\" }), cfg);\n  const drop = evaluateLogFilter(entry({ level: \"info\" }), cfg);\n  assert.equal(keep.dropDisplay, false);\n  assert.equal(drop.dropDisplay, true);\n});\n\ntest(\"applyTo=all \u65F6\u843D\u76D8\u4E0E\u5C55\u793A\u4E00\u5E76\u8FC7\u6EE4\", () => {\n  const r = evaluateLogFilter(\n    entry(),\n    baseCfg({\n      applyTo: \"all\",\n      rules: [{ sources: [\"bds\"] }],\n    })\n  );\n  assert.equal(r.dropDisplay, true);\n  assert.equal(r.dropDisk, true);\n});\n\ntest(\"applyTo=display \u65F6\u4EC5\u5F71\u54CD\u5C55\u793A\", () => {\n  const r = evaluateLogFilter(\n    entry(),\n    baseCfg({\n      applyTo: \"display\",\n      rules: [{ sources: [\"bds\"] }],\n    })\n  );\n  assert.equal(r.dropDisplay, true);\n  assert.equal(r.dropDisk, false);\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/logs.d.ts

@@ -27,9 +27,24 @@ export declare function onLog(fn: (log: UnifiedLog) => void): () => void;
 export declare function getRecentLogs(n: number, levels: LogLevel[], sources: LogSource[]): UnifiedLog[];
 /** 获取全部日志；配置过滤仅影响返回视图（缓冲内可能仍有全量，视 push 时 applyTo） */
 export declare function getAllLogs(): UnifiedLog[];
+/** source → 落盘文件名（含子进程自写） */
+export declare function diskFileForSource(source: string): string;
+/** 解析单行落盘日志；不符格式返回 null */
+export declare function parseDiskLogLine(raw: string): UnifiedLog | null;
+export type ReadDiskLogsOpts = {
+    levels?: LogLevel[];
+    sources?: LogSource[];
+    /** 覆盖日志目录（测试用）；默认 `<ROOT>/.sfmc/logs` */
+    dir?: string;
+};
+/**
+ * 从 `.sfmc/logs/*.log` 读取并解析为 UnifiedLog（按时间升序）。
+ * 供 /logs 筛选窗回放；与内存缓冲无关。
+ */
+export declare function readDiskLogs(opts?: ReadDiskLogsOpts): UnifiedLog[];
 export interface SourceMeta {
     value: string;
-    /** 显示名,尽量 8 宽对齐 */
+    /** 方括号内固定 3 字符，与 [INF] 对齐 */
     name: string;
     paint: (s: string) => string;
 }

package/dist/logs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAQL,KAAK,QAAQ,EACb,KAAK,QAAQ,IAAI,cAAc,EAChC,MAAM,oBAAoB,CAAC;AAU5B,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC;AACtC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAC/B,MAAM,WAAW,UAAW,SAAQ,QAAQ;CAAG;AAE/C,wDAAwD;AACxD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AA+BhG,yBAAyB;AACzB,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CA2C9E;AAED,uBAAuB;AACvB,wBAAgB,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAE/D;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,CAG/F;AAED,qDAAqD;AACrD,wBAAgB,UAAU,IAAI,UAAU,EAAE,CAGzC;AAMD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,WAAW,EAAE,UAAU,EASnC,CAAC;AASF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,GAAG,QAAQ,CAM3D;AAED,oCAAoC;AACpC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEjD;AA+BD,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAQ/C;AAwBD,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAKpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAa7D"}
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAQL,KAAK,QAAQ,EACb,KAAK,QAAQ,IAAI,cAAc,EAChC,MAAM,oBAAoB,CAAC;AAY5B,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC;AACtC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAC/B,MAAM,WAAW,UAAW,SAAQ,QAAQ;CAAG;AAE/C,wDAAwD;AACxD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AA+BhG,yBAAyB;AACzB,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CA2C9E;AAED,uBAAuB;AACvB,wBAAgB,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAE/D;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,CAG/F;AAED,qDAAqD;AACrD,wBAAgB,UAAU,IAAI,UAAU,EAAE,CAGzC;AASD,6BAA6B;AAC7B,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIxD;AAuBD,2BAA2B;AAC3B,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAS/D;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,gBAAqB,GAAG,UAAU,EAAE,CA+BtE;AAMD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,WAAW,EAAE,UAAU,EASnC,CAAC;AASF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,GAAG,QAAQ,CAM3D;AAED,oCAAoC;AACpC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEjD;AA+BD,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAQ/C;AAwBD,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAKpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAa7D"}

package/dist/logs.js

@@ -6,7 +6,9 @@ import {
   parseBdsEmbeddedLevel,
   stripBdsLogPrefix
 } from "@sfmc-bds/sdk/logs";
-import { logFile } from "@sfmc-bds/sdk/node/config";
+import { logFile, logsDir } from "@sfmc-bds/sdk/node/config";
+import fs from "node:fs";
+import path from "node:path";
 import {
   getCompiledLogFilter,
   shouldDropForDisk,
@@ -83,20 +85,84 @@ function getAllLogs() {
   const filter = getCompiledLogFilter();
   return buffer.getAll().filter((l) => !shouldDropForDisplay(l, filter));
 }
+const DISK_LOG_FILES = ["bds", "llbot", "db", "qq", "bds-update", "sfmc"];
+function diskFileForSource(source) {
+  if (source === "update") return "bds-update";
+  if (source === "bds" || source === "llbot" || source === "db" || source === "qq") return source;
+  return "sfmc";
+}
+const DISK_LINE_RE = /^(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}) \[([^\]]+)\] \[(INFO|WARN|ERROR|OK|DEBUG|SUCCESS|FATAL)\]\s?(.*)$/;
+function mapDiskLevelTag(tag) {
+  switch (tag) {
+    case "ERROR":
+    case "FATAL":
+      return "error";
+    case "WARN":
+      return "warn";
+    case "OK":
+    case "SUCCESS":
+      return "success";
+    case "DEBUG":
+      return "debug";
+    default:
+      return "info";
+  }
+}
+function parseDiskLogLine(raw) {
+  const m = DISK_LINE_RE.exec(raw);
+  if (!m) return null;
+  const ts = m[1];
+  const source = m[2].trim();
+  const level = mapDiskLevelTag(m[3]);
+  const body = m[4] ?? "";
+  const time = /* @__PURE__ */ new Date(ts.replace(" ", "T") + "Z");
+  return { time, source, level, text: body };
+}
+function readDiskLogs(opts = {}) {
+  const levels = opts.levels ?? [];
+  const sources = opts.sources ?? [];
+  const dir = opts.dir ?? logsDir(ROOT);
+  const fileNames = /* @__PURE__ */ new Set();
+  if (sources.length === 0) {
+    for (const n of DISK_LOG_FILES) fileNames.add(n);
+  } else {
+    for (const s of sources) fileNames.add(diskFileForSource(s));
+  }
+  const out = [];
+  for (const name of fileNames) {
+    const fp = path.join(dir, name.endsWith(".log") ? name : `${name}.log`);
+    let text;
+    try {
+      text = fs.readFileSync(fp, "utf8");
+    } catch {
+      continue;
+    }
+    for (const raw of text.split(/\r?\n/)) {
+      if (!raw) continue;
+      const entry = parseDiskLogLine(raw);
+      if (!entry) continue;
+      if (sources.length && !sources.includes(entry.source)) continue;
+      if (levels.length && !levels.includes(entry.level)) continue;
+      out.push(entry);
+    }
+  }
+  out.sort((a, b) => a.time.getTime() - b.time.getTime());
+  return out;
+}
 const SOURCE_META = [
-  { value: "bds", name: "BDServer", paint: (s) => c.green(s) },
-  { value: "db", name: "DataBase", paint: (s) => c.blue(s) },
-  { value: "qq", name: "QQBridge", paint: (s) => c.purple(s) },
-  { value: "llbot", name: " LL-BOT ", paint: (s) => c.yellow(s) },
-  { value: "system", name: " SYSTEM ", paint: (s) => c.cyan(s) },
-  { value: "update", name: " UPDATE ", paint: (s) => c.orange(s) },
-  { value: "pack", name: "  PACK  ", paint: (s) => c.purple(s) },
-  { value: "bds-tools", name: "BDSTools", paint: (s) => c.red(s) }
+  { value: "bds", name: "BDS", paint: (s) => c.green(s) },
+  { value: "db", name: "DB ", paint: (s) => c.blue(s) },
+  { value: "qq", name: "QQ ", paint: (s) => c.purple(s) },
+  { value: "llbot", name: "BOT", paint: (s) => c.yellow(s) },
+  { value: "system", name: "SYS", paint: (s) => c.cyan(s) },
+  { value: "update", name: "UPD", paint: (s) => c.orange(s) },
+  { value: "pack", name: "PAK", paint: (s) => c.purple(s) },
+  { value: "bds-tools", name: "TOL", paint: (s) => c.red(s) }
 ];
 function sourceTagPlain(source) {
   const meta = SOURCE_META.find((m) => m.value === source);
   if (meta) return `[${meta.name}]`;
-  return `[${source.padEnd(7).slice(0, 8)}]`;
+  return `[${source.toUpperCase().padEnd(3).slice(0, 3)}]`;
 }
 function formatSourceTag(source) {
   const meta = SOURCE_META.find((m) => m.value === source);
@@ -117,7 +183,7 @@ function inferLevel(text) {
 const LEVEL_TAG_TEXT = {
   error: "[ERR]",
   warn: "[WRN]",
-  success: "[OK]",
+  success: "[SUC]",
   debug: "[DBG]",
   info: "[INF]"
 };
@@ -222,6 +288,7 @@ function wrapSegment(s, cols, startPad, hangIndent) {
 }
 export {
   SOURCE_META,
+  diskFileForSource,
   formatLog,
   formatSourceTag,
   getAllLogs,
@@ -231,7 +298,9 @@ export {
   mapBdsLevelToken,
   onLog,
   parseBdsEmbeddedLevel2 as parseBdsEmbeddedLevel,
+  parseDiskLogLine,
   pushLog,
+  readDiskLogs,
   resolveDisplayLevel,
   stripBdsLogPrefix2 as stripBdsLogPrefix,
   visibleWidth,

package/dist/logs.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/logs.ts"],
-  "sourcesContent": ["/**\n * logs.ts \u2014 sfmc \u4E3B\u8FDB\u7A0B\u7EDF\u4E00\u65E5\u5FD7\u805A\u5408\u5C42\n *\n * \u5185\u90E8\u59D4\u6258 @sfmc-bds/logs \u5171\u4EAB\u5305\u7684 createMemoryBuffer + inferLevel,\n * \u4FDD\u6301\u5411\u540E\u517C\u5BB9\u7684 pushLog / onLog / getAllLogs / getRecentLogs API\n * (services.ts \u6355\u83B7\u5B50\u8FDB\u7A0B stdout \u540E\u8C03\u7528 pushLog \u6C47\u805A\u5230\u6B64)\u3002\n *\n * \u843D\u76D8\u7B56\u7565(\u4E0E\u5B50\u8FDB\u7A0B\u81EA\u5199\u6587\u4EF6\u5206\u5DE5,\u907F\u514D\u91CD\u590D):\n *   - db / qq / update \u2192 \u5B50\u8FDB\u7A0B\u5DF2\u5199 `.sfmc/logs/{db,qq,bds-update}.log`,\u6B64\u5904\u8DF3\u8FC7\n *   - bds / llbot \u2192 `.sfmc/logs/{bds,llbot}.log`(\u5916\u90E8\u8FDB\u7A0B\u65E0\u81EA\u5E26 file sink)\n *   - \u5176\u4F59(system / pack / \u2026) \u2192 `.sfmc/logs/sfmc.log`\n *\n * formatLog \u4FDD\u7559 theme.ts (chalk) \u914D\u8272,\u6BD4\u5171\u4EAB\u5305\u7684\u7EAF ANSI \u7248\u672C\u89C6\u89C9\u66F4\u4E30\u5BCC\u3002\n */\n\nimport {\n  createFileSink,\n  createMemoryBuffer,\n  formatLogLine,\n  inferLevel as sharedInferLevel,\n  parseBdsEmbeddedLevel,\n  stripBdsLogPrefix,\n  type FileSink,\n  type LogEntry,\n  type LogLevel as SharedLogLevel,\n} from \"@sfmc-bds/sdk/logs\";\nimport { logFile } from \"@sfmc-bds/sdk/node/config\";\nimport {\n  getCompiledLogFilter,\n  shouldDropForDisk,\n  shouldDropForDisplay,\n} from \"./log-filter.js\";\nimport { c, highlightLogLine } from \"./theme.js\";\nimport { ROOT } from \"./runtime.js\";\n\nexport type LogLevel = SharedLogLevel;\nexport type LogSource = string;\nexport interface UnifiedLog extends LogEntry {}\n\n/** \u518D\u5BFC\u51FA SDK BDS \u89E3\u6790\uFF08\u6D4B\u8BD5\u4E0E\u8C03\u7528\u65B9\u7EDF\u4E00\u5165\u53E3\uFF0C\u6743\u5A01\u5728 @sfmc-bds/sdk/logs\uFF09 */\nexport { mapBdsLevelToken, parseBdsEmbeddedLevel, stripBdsLogPrefix } from \"@sfmc-bds/sdk/logs\";\n\nconst buffer = createMemoryBuffer(5000);\n\n/** \u5B50\u8FDB\u7A0B\u5DF2\u7528 createNodeServiceLogger \u81EA\u884C\u843D\u76D8\u7684 source */\nconst CHILD_OWNED_SOURCES = new Set([\"db\", \"qq\", \"update\"]);\n\nconst fileSinks = new Map<string, FileSink>();\n\n/** \u89E3\u6790\u672C\u6761\u65E5\u5FD7\u5E94\u5199\u5165\u7684\u6587\u4EF6\u540D(\u4E0D\u542B .log);null \u8868\u793A\u8DF3\u8FC7(\u5B50\u8FDB\u7A0B\u5DF2\u5199) */\nfunction resolveDiskLogName(source: string): string | null {\n  if (CHILD_OWNED_SOURCES.has(source)) return null;\n  if (source === \"bds\" || source === \"llbot\") return source;\n  return \"sfmc\";\n}\n\nfunction sinkFor(source: string): FileSink | null {\n  const name = resolveDiskLogName(source);\n  if (!name) return null;\n  let sink = fileSinks.get(name);\n  if (!sink) {\n    sink = createFileSink(logFile(ROOT, name));\n    fileSinks.set(name, sink);\n  }\n  return sink;\n}\n\nprocess.on(\"exit\", () => {\n  for (const sink of fileSinks.values()) sink.close();\n});\n\n/** \u63A8\u9001\u4E00\u6761\u65E5\u5FD7\u5230\u5185\u5B58\u7F13\u51B2,\u5E76\u6309\u7B56\u7565\u843D\u76D8 */\nexport function pushLog(text: string, source: LogSource, level: LogLevel): void {\n  let body = text;\n  let lvl = level;\n  /* BDS\uFF1A\u5148\u63D0\u53D6\u5185\u5D4C\u7EA7\u522B\uFF0C\u518D\u5265\u6389\u81EA\u5E26\u65F6\u95F4\u6233+\u7B49\u7EA7\uFF0C\u907F\u514D\u5C55\u793A/\u843D\u76D8\u91CD\u590D */\n  if (source === \"bds\") {\n    const embedded = parseBdsEmbeddedLevel(text);\n    if (embedded) lvl = embedded;\n    body = stripBdsLogPrefix(text);\n  }\n\n  const entry: LogEntry = { time: new Date(), text: body, source, level: lvl };\n  const filter = getCompiledLogFilter((src) => {\n    /* \u907F\u514D\u9012\u5F52\uFF1A\u975E\u6CD5\u6B63\u5219\u53EA\u5199\u6587\u4EF6 sink\uFF0C\u4E0D\u7ECF pushLog */\n    try {\n      const sink = sinkFor(\"system\");\n      if (!sink) return;\n      const warn: LogEntry = {\n        time: new Date(),\n        text: `log-filter: invalid regex skipped: ${src}`,\n        source: \"system\",\n        level: \"warn\",\n      };\n      sink.write(warn, formatLogLine(warn, false));\n    } catch {\n      /* ignore */\n    }\n  });\n\n  const dropDisplay = shouldDropForDisplay(entry, filter);\n  const dropDisk = shouldDropForDisk(entry, filter);\n\n  if (!dropDisplay) {\n    buffer.pushDirect(body, source, lvl);\n  }\n\n  if (dropDisk) return;\n  const sink = sinkFor(source);\n  if (!sink) return;\n  try {\n    sink.write(entry, formatLogLine(entry, false));\n  } catch {\n    /* \u843D\u76D8\u5931\u8D25\u4E0D\u963B\u65AD\u4E3B\u6D41\u7A0B */\n  }\n}\n\n/** \u8BA2\u9605\u65B0\u65E5\u5FD7\u4E8B\u4EF6,\u8FD4\u56DE\u53D6\u6D88\u8BA2\u9605\u51FD\u6570 */\nexport function onLog(fn: (log: UnifiedLog) => void): () => void {\n  return buffer.subscribe(fn);\n}\n\n/** \u83B7\u53D6\u6700\u8FD1 n \u6761,\u53EF\u6309 level / source \u8FC7\u6EE4\uFF1B\u518D\u5957\u914D\u7F6E\u8FC7\u6EE4\uFF08display\uFF09 */\nexport function getRecentLogs(n: number, levels: LogLevel[], sources: LogSource[]): UnifiedLog[] {\n  const filter = getCompiledLogFilter();\n  return buffer.getRecent(n, levels, sources).filter((l) => !shouldDropForDisplay(l, filter));\n}\n\n/** \u83B7\u53D6\u5168\u90E8\u65E5\u5FD7\uFF1B\u914D\u7F6E\u8FC7\u6EE4\u4EC5\u5F71\u54CD\u8FD4\u56DE\u89C6\u56FE\uFF08\u7F13\u51B2\u5185\u53EF\u80FD\u4ECD\u6709\u5168\u91CF\uFF0C\u89C6 push \u65F6 applyTo\uFF09 */\nexport function getAllLogs(): UnifiedLog[] {\n  const filter = getCompiledLogFilter();\n  return buffer.getAll().filter((l) => !shouldDropForDisplay(l, filter));\n}\n\n/* ==================================================================\n *  \u6765\u6E90\u6807\u7B7E\u5143\u6570\u636E (\u65B9\u62EC\u53F7\u4E0E\u6587\u5B57\u540C\u8272,\u5BF9\u9F50 levelTag)\n * ================================================================== */\n\nexport interface SourceMeta {\n  value: string;\n  /** \u663E\u793A\u540D,\u5C3D\u91CF 8 \u5BBD\u5BF9\u9F50 */\n  name: string;\n  paint: (s: string) => string;\n}\n\nexport const SOURCE_META: SourceMeta[] = [\n  { value: \"bds\", name: \"BDServer\", paint: (s) => c.green(s) },\n  { value: \"db\", name: \"DataBase\", paint: (s) => c.blue(s) },\n  { value: \"qq\", name: \"QQBridge\", paint: (s) => c.purple(s) },\n  { value: \"llbot\", name: \" LL-BOT \", paint: (s) => c.yellow(s) },\n  { value: \"system\", name: \" SYSTEM \", paint: (s) => c.cyan(s) },\n  { value: \"update\", name: \" UPDATE \", paint: (s) => c.orange(s) },\n  { value: \"pack\", name: \"  PACK  \", paint: (s) => c.purple(s) },\n  { value: \"bds-tools\", name: \"BDSTools\", paint: (s) => c.red(s) },\n];\n\n/** \u6E90\u6807\u7B7E\u65E0\u8272\u6587\u672C\uFF08formatSourceTag / logPrefixWidth \u5171\u7528\uFF09 */\nfunction sourceTagPlain(source: string): string {\n  const meta = SOURCE_META.find((m) => m.value === source);\n  if (meta) return `[${meta.name}]`;\n  return `[${source.padEnd(7).slice(0, 8)}]`;\n}\n\nexport function formatSourceTag(source: string): string {\n  const meta = SOURCE_META.find((m) => m.value === source);\n  const plain = sourceTagPlain(source);\n  if (meta) return meta.paint(plain);\n  return c.bold(plain);\n}\n\n/**\n * \u5C55\u793A\u7528\u7EA7\u522B\uFF1ABDS \u82E5\u4ECD\u5E26\u65F6\u95F4\u6233\u524D\u7F00\u5219\u89E3\u6790\u5185\u5D4C\u7EA7\u522B\uFF1B\u5DF2\u5265\u79BB\uFF08pushLog \u5165\u5E93\uFF09\u5219\u4FE1\u4EFB entry.level\u3002\n * \u7981\u6B62\u5BF9\u6B63\u6587\u505A\u677E\u6563\u5173\u952E\u8BCD\u5339\u914D\uFF08\u4F1A\u628A `[Commands] Error on line` \u8BEF\u5224\u4E3A error\uFF09\u3002\n */\nexport function resolveDisplayLevel(l: UnifiedLog): LogLevel {\n  if (l.source === \"bds\") {\n    const embedded = parseBdsEmbeddedLevel(l.text);\n    if (embedded) return embedded;\n  }\n  return l.level;\n}\n\n/** \u4ECE\u539F\u59CB\u6587\u672C\u63A8\u65AD\u7EA7\u522B\uFF1A\u59D4\u6258\u5171\u4EAB\u5305\uFF08\u5185\u542B BDS \u65F6\u95F4\u6233\u89E3\u6790\uFF09 */\nexport function inferLevel(text: string): LogLevel {\n  return sharedInferLevel(text);\n}\n\n/** \u65E0\u8272\u7EA7\u522B\u6807\u7B7E\u6587\u672C\uFF08\u53EF\u89C1\u5BBD\u5EA6\u6743\u5A01\u6E90\uFF09 */\nconst LEVEL_TAG_TEXT: Record<LogLevel, string> = {\n  error: \"[ERR]\",\n  warn: \"[WRN]\",\n  success: \"[OK]\",\n  debug: \"[DBG]\",\n  info: \"[INF]\",\n};\n\nfunction levelTagPlain(lvl: LogLevel): string {\n  return LEVEL_TAG_TEXT[lvl] ?? LEVEL_TAG_TEXT.info;\n}\n\nfunction levelTag(lvl: LogLevel): string {\n  const text = levelTagPlain(lvl);\n  switch (lvl) {\n    case \"error\":\n      return c.red(text);\n    case \"warn\":\n      return c.yellow(text);\n    case \"success\":\n      return c.green(c.bold(text));\n    case \"debug\":\n      return c.dim(text);\n    default:\n      return c.blue(text);\n  }\n}\n\n/** \u683C\u5F0F\u5316\u65E5\u5FD7\u7528\u4E8E REPL \u5C55\u793A (\u7528 theme.ts chalk \u914D\u8272) */\nexport function formatLog(l: UnifiedLog): string {\n  const ts = c.dim(l.time.toLocaleTimeString());\n  const level = resolveDisplayLevel(l);\n  const lvl = levelTag(level);\n  const src = formatSourceTag(l.source);\n  /* BDS\uFF1A\u53BB\u6389\u81EA\u5E26\u65F6\u95F4\u6233+\u7B49\u7EA7\u524D\u7F00\u540E\u518D\u9AD8\u4EAE\u6B63\u6587\uFF08push \u65F6\u591A\u534A\u5DF2\u5265\u8FC7\uFF0C\u6B64\u5904\u5E42\u7B49\uFF09 */\n  const txt = highlightLogLine(l.source === \"bds\" ? stripBdsLogPrefix(l.text) : l.text);\n  return `${ts} ${src} ${lvl} ${txt}`;\n}\n\n/* ==================================================================\n *  \u8F6F\u6362\u884C: \u8D85\u7EC8\u7AEF\u5BBD\u5EA6\u65F6\u6362\u884C,\u540E\u7EED\u884C\u7F29\u8FDB\u5BF9\u9F50\n * ================================================================== */\n\n/** \u5355\u4E2A\u5B57\u7B26\u5728\u7EC8\u7AEF\u7684\u663E\u793A\u5BBD\u5EA6 (CJK \u5168\u89D2=2, \u5176\u4F59=1) */\nfunction charWidth(ch: string): number {\n  const cp = ch.codePointAt(0) ?? 0;\n  if (\n    cp >= 0x1100 &&\n    (cp <= 0x115f ||\n      (cp >= 0x2e80 && cp <= 0xa4cf && cp !== 0x303f) ||\n      (cp >= 0xac00 && cp <= 0xd7a3) ||\n      (cp >= 0xf900 && cp <= 0xfaff) ||\n      (cp >= 0xfe30 && cp <= 0xfe4f) ||\n      (cp >= 0xff00 && cp <= 0xff60) ||\n      (cp >= 0xffe0 && cp <= 0xffe6) ||\n      (cp >= 0x20000 && cp <= 0x2fffd))\n  )\n    return 2;\n  return 1;\n}\n\n/** \u5B57\u7B26\u4E32\u5728\u7EC8\u7AEF\u7684\u53EF\u89C1\u5BBD\u5EA6 (strip ANSI \u540E\u6309 CJK \u5BBD\u5EA6\u7D2F\u52A0) */\nexport function visibleWidth(s: string): number {\n  const stripped = s.replace(/\\x1b\\[[0-9;]*m/g, \"\");\n  let w = 0;\n  for (const ch of stripped) w += charWidth(ch);\n  return w;\n}\n\n/**\n * \u65E5\u5FD7\u524D\u7F00\u53EF\u89C1\u5BBD\u5EA6(\u65F6\u95F4 + \u6E90 + \u7EA7\u522B + \u5C3E\u7A7A\u683C),\u4F9B\u60AC\u6302\u7F29\u8FDB\u5BF9\u9F50\u6B63\u6587\u8D77\u70B9\u3002\n * \u4E0E formatLog \u62FC\u63A5\u987A\u5E8F\u4FDD\u6301\u4E00\u81F4\uFF08\u5171\u7528 resolveDisplayLevel / sourceTagPlain / levelTagPlain\uFF09\u3002\n */\nexport function logPrefixWidth(l: UnifiedLog): number {\n  const ts = l.time.toLocaleTimeString();\n  const src = sourceTagPlain(l.source);\n  const level = resolveDisplayLevel(l);\n  return visibleWidth(`${ts} ${src} ${levelTagPlain(level)} `);\n}\n\n/**\n * \u6309\u7EC8\u7AEF\u53EF\u89C1\u5BBD\u5EA6\u6362\u884C;\u663E\u5F0F \\\\n \u4E0E\u8F6F\u6362\u884C\u7684\u540E\u7EED\u884C\u4E00\u5F8B\u5DE6\u4FA7\u7F29\u8FDB indent \u5217\u3002\n * \u4FDD\u7559 ANSI:\u6362\u884C\u65F6 reset,\u65B0\u884C\u6062\u590D\u5F53\u524D\u989C\u8272\u72B6\u6001(\u53EF\u591A\u5C42\u53E0\u52A0)\u3002\n * \u5BBD\u5B57\u7B26(CJK)\u6309 2 \u5217;cols \u9884\u7559 1 \u5217,\u907F\u514D Windows Terminal \u8FB9\u754C\u518D\u8F6F\u6298\u5230\u7B2C 0 \u5217\u3002\n */\nexport function wrapLogLine(s: string, indent: number): string {\n  const rawCols = process.stdout.columns || 80;\n  /* \u81F3\u5C11\u7559\u7ED9\u6B63\u6587\u82E5\u5E72\u5217,\u907F\u514D indent >= cols \u65F6\u6B7B\u5FAA\u73AF */\n  const cols = Math.max(rawCols - 1, indent + 4);\n  const segments = s.split(/\\r?\\n/);\n  const out: string[] = [];\n  for (let si = 0; si < segments.length; si++) {\n    const raw = segments[si]!;\n    /* \u663E\u5F0F\u6362\u884C\u6BB5\u53BB\u6389\u6587\u6848\u81EA\u5E26\u7684\u5DE6\u7A7A\u683C,\u7EDF\u4E00\u7531 hang indent \u5BF9\u9F50\u6B63\u6587 */\n    const piece = si === 0 ? raw : raw.replace(/^[ \\t]+/, \"\");\n    out.push(wrapSegment(piece, cols, si === 0 ? 0 : indent, indent));\n  }\n  return out.join(\"\\n\");\n}\n\n/** \u5355\u6BB5(\u65E0\u5185\u5D4C \\\\n)\u8F6F\u6362\u884C;startPad>0 \u8868\u793A\u672C\u6BB5\u5F00\u5934\u5DF2\u5360\u7528\u7684\u5217(\u663E\u5F0F\u6362\u884C\u540E\u7684\u60AC\u6302) */\nfunction wrapSegment(s: string, cols: number, startPad: number, hangIndent: number): string {\n  if (s.length === 0) return startPad > 0 ? \" \".repeat(startPad) : \"\";\n\n  const lines: string[] = [];\n  let cur = startPad > 0 ? \" \".repeat(startPad) : \"\";\n  let w = startPad;\n  /** \u5F53\u524D\u751F\u6548\u7684 ANSI \u5F00\u7801\u6808(\u4E0D\u542B reset),\u6362\u884C\u540E\u91CD\u653E */\n  const ansiStack: string[] = [];\n\n  const resetIfNeeded = (): void => {\n    if (ansiStack.length) cur += \"\\x1b[0m\";\n  };\n  const replayAnsi = (): void => {\n    for (const code of ansiStack) cur += code;\n  };\n\n  let i = 0;\n  while (i < s.length) {\n    const m = /^\\x1b\\[[0-9;]*m/.exec(s.slice(i));\n    if (m) {\n      const code = m[0]!;\n      cur += code;\n      if (code === \"\\x1b[0m\") ansiStack.length = 0;\n      else ansiStack.push(code);\n      i += code.length;\n      continue;\n    }\n\n    const cp = s.codePointAt(i)!;\n    const ch = String.fromCodePoint(cp);\n    const cw = charWidth(ch);\n    const advance = ch.length;\n\n    /* w > startPad:\u5F53\u524D\u884C\u9664\u5DE6\u57AB\u5916\u5DF2\u6709\u5185\u5BB9,\u53EF\u4EE5\u62C6\u884C;\u5426\u5219\u5F3A\u5236\u585E\u5165\u907F\u514D\u6B7B\u5FAA\u73AF */\n    if (w + cw > cols && w > startPad) {\n      resetIfNeeded();\n      lines.push(cur);\n      cur = \" \".repeat(hangIndent);\n      replayAnsi();\n      w = hangIndent;\n      startPad = hangIndent;\n    }\n\n    cur += ch;\n    w += cw;\n    i += advance;\n  }\n\n  if (ansiStack.length) cur += \"\\x1b[0m\";\n  lines.push(cur);\n  return lines.join(\"\\n\");\n}\n\n"],
-  "mappings": "AAeA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA;AAAA,OAIK;AACP,SAAS,eAAe;AACxB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,GAAG,wBAAwB;AACpC,SAAS,YAAY;AAOrB,SAAS,kBAAkB,yBAAAA,wBAAuB,qBAAAC,0BAAyB;AAE3E,MAAM,SAAS,mBAAmB,GAAI;AAGtC,MAAM,sBAAsB,oBAAI,IAAI,CAAC,MAAM,MAAM,QAAQ,CAAC;AAE1D,MAAM,YAAY,oBAAI,IAAsB;AAG5C,SAAS,mBAAmB,QAA+B;AACzD,MAAI,oBAAoB,IAAI,MAAM,EAAG,QAAO;AAC5C,MAAI,WAAW,SAAS,WAAW,QAAS,QAAO;AACnD,SAAO;AACT;AAEA,SAAS,QAAQ,QAAiC;AAChD,QAAM,OAAO,mBAAmB,MAAM;AACtC,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,OAAO,UAAU,IAAI,IAAI;AAC7B,MAAI,CAAC,MAAM;AACT,WAAO,eAAe,QAAQ,MAAM,IAAI,CAAC;AACzC,cAAU,IAAI,MAAM,IAAI;AAAA,EAC1B;AACA,SAAO;AACT;AAEA,QAAQ,GAAG,QAAQ,MAAM;AACvB,aAAW,QAAQ,UAAU,OAAO,EAAG,MAAK,MAAM;AACpD,CAAC;AAGM,SAAS,QAAQ,MAAc,QAAmB,OAAuB;AAC9E,MAAI,OAAO;AACX,MAAI,MAAM;AAEV,MAAI,WAAW,OAAO;AACpB,UAAM,WAAW,sBAAsB,IAAI;AAC3C,QAAI,SAAU,OAAM;AACpB,WAAO,kBAAkB,IAAI;AAAA,EAC/B;AAEA,QAAM,QAAkB,EAAE,MAAM,oBAAI,KAAK,GAAG,MAAM,MAAM,QAAQ,OAAO,IAAI;AAC3E,QAAM,SAAS,qBAAqB,CAAC,QAAQ;AAE3C,QAAI;AACF,YAAMC,QAAO,QAAQ,QAAQ;AAC7B,UAAI,CAACA,MAAM;AACX,YAAM,OAAiB;AAAA,QACrB,MAAM,oBAAI,KAAK;AAAA,QACf,MAAM,sCAAsC,GAAG;AAAA,QAC/C,QAAQ;AAAA,QACR,OAAO;AAAA,MACT;AACA,MAAAA,MAAK,MAAM,MAAM,cAAc,MAAM,KAAK,CAAC;AAAA,IAC7C,QAAQ;AAAA,IAER;AAAA,EACF,CAAC;AAED,QAAM,cAAc,qBAAqB,OAAO,MAAM;AACtD,QAAM,WAAW,kBAAkB,OAAO,MAAM;AAEhD,MAAI,CAAC,aAAa;AAChB,WAAO,WAAW,MAAM,QAAQ,GAAG;AAAA,EACrC;AAEA,MAAI,SAAU;AACd,QAAM,OAAO,QAAQ,MAAM;AAC3B,MAAI,CAAC,KAAM;AACX,MAAI;AACF,SAAK,MAAM,OAAO,cAAc,OAAO,KAAK,CAAC;AAAA,EAC/C,QAAQ;AAAA,EAER;AACF;AAGO,SAAS,MAAM,IAA2C;AAC/D,SAAO,OAAO,UAAU,EAAE;AAC5B;AAGO,SAAS,cAAc,GAAW,QAAoB,SAAoC;AAC/F,QAAM,SAAS,qBAAqB;AACpC,SAAO,OAAO,UAAU,GAAG,QAAQ,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB,GAAG,MAAM,CAAC;AAC5F;AAGO,SAAS,aAA2B;AACzC,QAAM,SAAS,qBAAqB;AACpC,SAAO,OAAO,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB,GAAG,MAAM,CAAC;AACvE;AAaO,MAAM,cAA4B;AAAA,EACvC,EAAE,OAAO,OAAO,MAAM,YAAY,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;AAAA,EAC3D,EAAE,OAAO,MAAM,MAAM,YAAY,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;AAAA,EACzD,EAAE,OAAO,MAAM,MAAM,YAAY,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;AAAA,EAC3D,EAAE,OAAO,SAAS,MAAM,YAAY,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;AAAA,EAC9D,EAAE,OAAO,UAAU,MAAM,YAAY,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;AAAA,EAC7D,EAAE,OAAO,UAAU,MAAM,YAAY,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;AAAA,EAC/D,EAAE,OAAO,QAAQ,MAAM,YAAY,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;AAAA,EAC7D,EAAE,OAAO,aAAa,MAAM,YAAY,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE;AACjE;AAGA,SAAS,eAAe,QAAwB;AAC9C,QAAM,OAAO,YAAY,KAAK,CAAC,MAAM,EAAE,UAAU,MAAM;AACvD,MAAI,KAAM,QAAO,IAAI,KAAK,IAAI;AAC9B,SAAO,IAAI,OAAO,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;AACzC;AAEO,SAAS,gBAAgB,QAAwB;AACtD,QAAM,OAAO,YAAY,KAAK,CAAC,MAAM,EAAE,UAAU,MAAM;AACvD,QAAM,QAAQ,eAAe,MAAM;AACnC,MAAI,KAAM,QAAO,KAAK,MAAM,KAAK;AACjC,SAAO,EAAE,KAAK,KAAK;AACrB;AAMO,SAAS,oBAAoB,GAAyB;AAC3D,MAAI,EAAE,WAAW,OAAO;AACtB,UAAM,WAAW,sBAAsB,EAAE,IAAI;AAC7C,QAAI,SAAU,QAAO;AAAA,EACvB;AACA,SAAO,EAAE;AACX;AAGO,SAAS,WAAW,MAAwB;AACjD,SAAO,iBAAiB,IAAI;AAC9B;AAGA,MAAM,iBAA2C;AAAA,EAC/C,OAAO;AAAA,EACP,MAAM;AAAA,EACN,SAAS;AAAA,EACT,OAAO;AAAA,EACP,MAAM;AACR;AAEA,SAAS,cAAc,KAAuB;AAC5C,SAAO,eAAe,GAAG,KAAK,eAAe;AAC/C;AAEA,SAAS,SAAS,KAAuB;AACvC,QAAM,OAAO,cAAc,GAAG;AAC9B,UAAQ,KAAK;AAAA,IACX,KAAK;AACH,aAAO,EAAE,IAAI,IAAI;AAAA,IACnB,KAAK;AACH,aAAO,EAAE,OAAO,IAAI;AAAA,IACtB,KAAK;AACH,aAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;AAAA,IAC7B,KAAK;AACH,aAAO,EAAE,IAAI,IAAI;AAAA,IACnB;AACE,aAAO,EAAE,KAAK,IAAI;AAAA,EACtB;AACF;AAGO,SAAS,UAAU,GAAuB;AAC/C,QAAM,KAAK,EAAE,IAAI,EAAE,KAAK,mBAAmB,CAAC;AAC5C,QAAM,QAAQ,oBAAoB,CAAC;AACnC,QAAM,MAAM,SAAS,KAAK;AAC1B,QAAM,MAAM,gBAAgB,EAAE,MAAM;AAEpC,QAAM,MAAM,iBAAiB,EAAE,WAAW,QAAQ,kBAAkB,EAAE,IAAI,IAAI,EAAE,IAAI;AACpF,SAAO,GAAG,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG;AACnC;AAOA,SAAS,UAAU,IAAoB;AACrC,QAAM,KAAK,GAAG,YAAY,CAAC,KAAK;AAChC,MACE,MAAM,SACL,MAAM,QACJ,MAAM,SAAU,MAAM,SAAU,OAAO,SACvC,MAAM,SAAU,MAAM,SACtB,MAAM,SAAU,MAAM,SACtB,MAAM,SAAU,MAAM,SACtB,MAAM,SAAU,MAAM,SACtB,MAAM,SAAU,MAAM,SACtB,MAAM,UAAW,MAAM;AAE1B,WAAO;AACT,SAAO;AACT;AAGO,SAAS,aAAa,GAAmB;AAC9C,QAAM,WAAW,EAAE,QAAQ,mBAAmB,EAAE;AAChD,MAAI,IAAI;AACR,aAAW,MAAM,SAAU,MAAK,UAAU,EAAE;AAC5C,SAAO;AACT;AAMO,SAAS,eAAe,GAAuB;AACpD,QAAM,KAAK,EAAE,KAAK,mBAAmB;AACrC,QAAM,MAAM,eAAe,EAAE,MAAM;AACnC,QAAM,QAAQ,oBAAoB,CAAC;AACnC,SAAO,aAAa,GAAG,EAAE,IAAI,GAAG,IAAI,cAAc,KAAK,CAAC,GAAG;AAC7D;AAOO,SAAS,YAAY,GAAW,QAAwB;AAC7D,QAAM,UAAU,QAAQ,OAAO,WAAW;AAE1C,QAAM,OAAO,KAAK,IAAI,UAAU,GAAG,SAAS,CAAC;AAC7C,QAAM,WAAW,EAAE,MAAM,OAAO;AAChC,QAAM,MAAgB,CAAC;AACvB,WAAS,KAAK,GAAG,KAAK,SAAS,QAAQ,MAAM;AAC3C,UAAM,MAAM,SAAS,EAAE;AAEvB,UAAM,QAAQ,OAAO,IAAI,MAAM,IAAI,QAAQ,WAAW,EAAE;AACxD,QAAI,KAAK,YAAY,OAAO,MAAM,OAAO,IAAI,IAAI,QAAQ,MAAM,CAAC;AAAA,EAClE;AACA,SAAO,IAAI,KAAK,IAAI;AACtB;AAGA,SAAS,YAAY,GAAW,MAAc,UAAkB,YAA4B;AAC1F,MAAI,EAAE,WAAW,EAAG,QAAO,WAAW,IAAI,IAAI,OAAO,QAAQ,IAAI;AAEjE,QAAM,QAAkB,CAAC;AACzB,MAAI,MAAM,WAAW,IAAI,IAAI,OAAO,QAAQ,IAAI;AAChD,MAAI,IAAI;AAER,QAAM,YAAsB,CAAC;AAE7B,QAAM,gBAAgB,MAAY;AAChC,QAAI,UAAU,OAAQ,QAAO;AAAA,EAC/B;AACA,QAAM,aAAa,MAAY;AAC7B,eAAW,QAAQ,UAAW,QAAO;AAAA,EACvC;AAEA,MAAI,IAAI;AACR,SAAO,IAAI,EAAE,QAAQ;AACnB,UAAM,IAAI,kBAAkB,KAAK,EAAE,MAAM,CAAC,CAAC;AAC3C,QAAI,GAAG;AACL,YAAM,OAAO,EAAE,CAAC;AAChB,aAAO;AACP,UAAI,SAAS,UAAW,WAAU,SAAS;AAAA,UACtC,WAAU,KAAK,IAAI;AACxB,WAAK,KAAK;AACV;AAAA,IACF;AAEA,UAAM,KAAK,EAAE,YAAY,CAAC;AAC1B,UAAM,KAAK,OAAO,cAAc,EAAE;AAClC,UAAM,KAAK,UAAU,EAAE;AACvB,UAAM,UAAU,GAAG;AAGnB,QAAI,IAAI,KAAK,QAAQ,IAAI,UAAU;AACjC,oBAAc;AACd,YAAM,KAAK,GAAG;AACd,YAAM,IAAI,OAAO,UAAU;AAC3B,iBAAW;AACX,UAAI;AACJ,iBAAW;AAAA,IACb;AAEA,WAAO;AACP,SAAK;AACL,SAAK;AAAA,EACP;AAEA,MAAI,UAAU,OAAQ,QAAO;AAC7B,QAAM,KAAK,GAAG;AACd,SAAO,MAAM,KAAK,IAAI;AACxB;",
+  "sourcesContent": ["/**\n * logs.ts \u2014 sfmc \u4E3B\u8FDB\u7A0B\u7EDF\u4E00\u65E5\u5FD7\u805A\u5408\u5C42\n *\n * \u5185\u90E8\u59D4\u6258 @sfmc-bds/logs \u5171\u4EAB\u5305\u7684 createMemoryBuffer + inferLevel,\n * \u4FDD\u6301\u5411\u540E\u517C\u5BB9\u7684 pushLog / onLog / getAllLogs / getRecentLogs API\n * (services.ts \u6355\u83B7\u5B50\u8FDB\u7A0B stdout \u540E\u8C03\u7528 pushLog \u6C47\u805A\u5230\u6B64)\u3002\n *\n * \u843D\u76D8\u7B56\u7565(\u4E0E\u5B50\u8FDB\u7A0B\u81EA\u5199\u6587\u4EF6\u5206\u5DE5,\u907F\u514D\u91CD\u590D):\n *   - db / qq / update \u2192 \u5B50\u8FDB\u7A0B\u5DF2\u5199 `.sfmc/logs/{db,qq,bds-update}.log`,\u6B64\u5904\u8DF3\u8FC7\n *   - bds / llbot \u2192 `.sfmc/logs/{bds,llbot}.log`(\u5916\u90E8\u8FDB\u7A0B\u65E0\u81EA\u5E26 file sink)\n *   - \u5176\u4F59(system / pack / \u2026) \u2192 `.sfmc/logs/sfmc.log`\n *\n * formatLog \u4FDD\u7559 theme.ts (chalk) \u914D\u8272,\u6BD4\u5171\u4EAB\u5305\u7684\u7EAF ANSI \u7248\u672C\u89C6\u89C9\u66F4\u4E30\u5BCC\u3002\n */\n\nimport {\n  createFileSink,\n  createMemoryBuffer,\n  formatLogLine,\n  inferLevel as sharedInferLevel,\n  parseBdsEmbeddedLevel,\n  stripBdsLogPrefix,\n  type FileSink,\n  type LogEntry,\n  type LogLevel as SharedLogLevel,\n} from \"@sfmc-bds/sdk/logs\";\nimport { logFile, logsDir } from \"@sfmc-bds/sdk/node/config\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  getCompiledLogFilter,\n  shouldDropForDisk,\n  shouldDropForDisplay,\n} from \"./log-filter.js\";\nimport { c, highlightLogLine } from \"./theme.js\";\nimport { ROOT } from \"./runtime.js\";\n\nexport type LogLevel = SharedLogLevel;\nexport type LogSource = string;\nexport interface UnifiedLog extends LogEntry {}\n\n/** \u518D\u5BFC\u51FA SDK BDS \u89E3\u6790\uFF08\u6D4B\u8BD5\u4E0E\u8C03\u7528\u65B9\u7EDF\u4E00\u5165\u53E3\uFF0C\u6743\u5A01\u5728 @sfmc-bds/sdk/logs\uFF09 */\nexport { mapBdsLevelToken, parseBdsEmbeddedLevel, stripBdsLogPrefix } from \"@sfmc-bds/sdk/logs\";\n\nconst buffer = createMemoryBuffer(5000);\n\n/** \u5B50\u8FDB\u7A0B\u5DF2\u7528 createNodeServiceLogger \u81EA\u884C\u843D\u76D8\u7684 source */\nconst CHILD_OWNED_SOURCES = new Set([\"db\", \"qq\", \"update\"]);\n\nconst fileSinks = new Map<string, FileSink>();\n\n/** \u89E3\u6790\u672C\u6761\u65E5\u5FD7\u5E94\u5199\u5165\u7684\u6587\u4EF6\u540D(\u4E0D\u542B .log);null \u8868\u793A\u8DF3\u8FC7(\u5B50\u8FDB\u7A0B\u5DF2\u5199) */\nfunction resolveDiskLogName(source: string): string | null {\n  if (CHILD_OWNED_SOURCES.has(source)) return null;\n  if (source === \"bds\" || source === \"llbot\") return source;\n  return \"sfmc\";\n}\n\nfunction sinkFor(source: string): FileSink | null {\n  const name = resolveDiskLogName(source);\n  if (!name) return null;\n  let sink = fileSinks.get(name);\n  if (!sink) {\n    sink = createFileSink(logFile(ROOT, name));\n    fileSinks.set(name, sink);\n  }\n  return sink;\n}\n\nprocess.on(\"exit\", () => {\n  for (const sink of fileSinks.values()) sink.close();\n});\n\n/** \u63A8\u9001\u4E00\u6761\u65E5\u5FD7\u5230\u5185\u5B58\u7F13\u51B2,\u5E76\u6309\u7B56\u7565\u843D\u76D8 */\nexport function pushLog(text: string, source: LogSource, level: LogLevel): void {\n  let body = text;\n  let lvl = level;\n  /* BDS\uFF1A\u5148\u63D0\u53D6\u5185\u5D4C\u7EA7\u522B\uFF0C\u518D\u5265\u6389\u81EA\u5E26\u65F6\u95F4\u6233+\u7B49\u7EA7\uFF0C\u907F\u514D\u5C55\u793A/\u843D\u76D8\u91CD\u590D */\n  if (source === \"bds\") {\n    const embedded = parseBdsEmbeddedLevel(text);\n    if (embedded) lvl = embedded;\n    body = stripBdsLogPrefix(text);\n  }\n\n  const entry: LogEntry = { time: new Date(), text: body, source, level: lvl };\n  const filter = getCompiledLogFilter((src) => {\n    /* \u907F\u514D\u9012\u5F52\uFF1A\u975E\u6CD5\u6B63\u5219\u53EA\u5199\u6587\u4EF6 sink\uFF0C\u4E0D\u7ECF pushLog */\n    try {\n      const sink = sinkFor(\"system\");\n      if (!sink) return;\n      const warn: LogEntry = {\n        time: new Date(),\n        text: `log-filter: invalid regex skipped: ${src}`,\n        source: \"system\",\n        level: \"warn\",\n      };\n      sink.write(warn, formatLogLine(warn, false));\n    } catch {\n      /* ignore */\n    }\n  });\n\n  const dropDisplay = shouldDropForDisplay(entry, filter);\n  const dropDisk = shouldDropForDisk(entry, filter);\n\n  if (!dropDisplay) {\n    buffer.pushDirect(body, source, lvl);\n  }\n\n  if (dropDisk) return;\n  const sink = sinkFor(source);\n  if (!sink) return;\n  try {\n    sink.write(entry, formatLogLine(entry, false));\n  } catch {\n    /* \u843D\u76D8\u5931\u8D25\u4E0D\u963B\u65AD\u4E3B\u6D41\u7A0B */\n  }\n}\n\n/** \u8BA2\u9605\u65B0\u65E5\u5FD7\u4E8B\u4EF6,\u8FD4\u56DE\u53D6\u6D88\u8BA2\u9605\u51FD\u6570 */\nexport function onLog(fn: (log: UnifiedLog) => void): () => void {\n  return buffer.subscribe(fn);\n}\n\n/** \u83B7\u53D6\u6700\u8FD1 n \u6761,\u53EF\u6309 level / source \u8FC7\u6EE4\uFF1B\u518D\u5957\u914D\u7F6E\u8FC7\u6EE4\uFF08display\uFF09 */\nexport function getRecentLogs(n: number, levels: LogLevel[], sources: LogSource[]): UnifiedLog[] {\n  const filter = getCompiledLogFilter();\n  return buffer.getRecent(n, levels, sources).filter((l) => !shouldDropForDisplay(l, filter));\n}\n\n/** \u83B7\u53D6\u5168\u90E8\u65E5\u5FD7\uFF1B\u914D\u7F6E\u8FC7\u6EE4\u4EC5\u5F71\u54CD\u8FD4\u56DE\u89C6\u56FE\uFF08\u7F13\u51B2\u5185\u53EF\u80FD\u4ECD\u6709\u5168\u91CF\uFF0C\u89C6 push \u65F6 applyTo\uFF09 */\nexport function getAllLogs(): UnifiedLog[] {\n  const filter = getCompiledLogFilter();\n  return buffer.getAll().filter((l) => !shouldDropForDisplay(l, filter));\n}\n\n/* ==================================================================\n *  \u843D\u76D8\u6587\u4EF6\u8BFB\u53D6\uFF08/logs \u7A97\u7528\uFF0C\u4E0D\u8D70\u5185\u5B58\u7F13\u51B2\uFF09\n * ================================================================== */\n\n/** \u4E0E\u843D\u76D8\u7B56\u7565\u5BF9\u5E94\u7684\u6587\u4EF6\u57FA\u540D\uFF08\u4E0D\u542B .log\uFF09 */\nconst DISK_LOG_FILES = [\"bds\", \"llbot\", \"db\", \"qq\", \"bds-update\", \"sfmc\"] as const;\n\n/** source \u2192 \u843D\u76D8\u6587\u4EF6\u540D\uFF08\u542B\u5B50\u8FDB\u7A0B\u81EA\u5199\uFF09 */\nexport function diskFileForSource(source: string): string {\n  if (source === \"update\") return \"bds-update\";\n  if (source === \"bds\" || source === \"llbot\" || source === \"db\" || source === \"qq\") return source;\n  return \"sfmc\";\n}\n\n/** formatLogLine \u65E0\u8272\u884C\uFF1A`YYYY-MM-DD HH:mm:ss [source] [LEVEL] text` */\nconst DISK_LINE_RE =\n  /^(\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}) \\[([^\\]]+)\\] \\[(INFO|WARN|ERROR|OK|DEBUG|SUCCESS|FATAL)\\]\\s?(.*)$/;\n\nfunction mapDiskLevelTag(tag: string): LogLevel {\n  switch (tag) {\n    case \"ERROR\":\n    case \"FATAL\":\n      return \"error\";\n    case \"WARN\":\n      return \"warn\";\n    case \"OK\":\n    case \"SUCCESS\":\n      return \"success\";\n    case \"DEBUG\":\n      return \"debug\";\n    default:\n      return \"info\";\n  }\n}\n\n/** \u89E3\u6790\u5355\u884C\u843D\u76D8\u65E5\u5FD7\uFF1B\u4E0D\u7B26\u683C\u5F0F\u8FD4\u56DE null */\nexport function parseDiskLogLine(raw: string): UnifiedLog | null {\n  const m = DISK_LINE_RE.exec(raw);\n  if (!m) return null;\n  const ts = m[1]!;\n  const source = m[2]!.trim();\n  const level = mapDiskLevelTag(m[3]!);\n  const body = m[4] ?? \"\";\n  const time = new Date(ts.replace(\" \", \"T\") + \"Z\");\n  return { time, source, level, text: body };\n}\n\nexport type ReadDiskLogsOpts = {\n  levels?: LogLevel[];\n  sources?: LogSource[];\n  /** \u8986\u76D6\u65E5\u5FD7\u76EE\u5F55\uFF08\u6D4B\u8BD5\u7528\uFF09\uFF1B\u9ED8\u8BA4 `<ROOT>/.sfmc/logs` */\n  dir?: string;\n};\n\n/**\n * \u4ECE `.sfmc/logs/*.log` \u8BFB\u53D6\u5E76\u89E3\u6790\u4E3A UnifiedLog\uFF08\u6309\u65F6\u95F4\u5347\u5E8F\uFF09\u3002\n * \u4F9B /logs \u7B5B\u9009\u7A97\u56DE\u653E\uFF1B\u4E0E\u5185\u5B58\u7F13\u51B2\u65E0\u5173\u3002\n */\nexport function readDiskLogs(opts: ReadDiskLogsOpts = {}): UnifiedLog[] {\n  const levels = opts.levels ?? [];\n  const sources = opts.sources ?? [];\n  const dir = opts.dir ?? logsDir(ROOT);\n  const fileNames = new Set<string>();\n  if (sources.length === 0) {\n    for (const n of DISK_LOG_FILES) fileNames.add(n);\n  } else {\n    for (const s of sources) fileNames.add(diskFileForSource(s));\n  }\n\n  const out: UnifiedLog[] = [];\n  for (const name of fileNames) {\n    const fp = path.join(dir, name.endsWith(\".log\") ? name : `${name}.log`);\n    let text: string;\n    try {\n      text = fs.readFileSync(fp, \"utf8\");\n    } catch {\n      continue;\n    }\n    for (const raw of text.split(/\\r?\\n/)) {\n      if (!raw) continue;\n      const entry = parseDiskLogLine(raw);\n      if (!entry) continue;\n      if (sources.length && !sources.includes(entry.source)) continue;\n      if (levels.length && !levels.includes(entry.level)) continue;\n      out.push(entry);\n    }\n  }\n  out.sort((a, b) => a.time.getTime() - b.time.getTime());\n  return out;\n}\n\n/* ==================================================================\n *  \u6765\u6E90\u6807\u7B7E\u5143\u6570\u636E (\u65B9\u62EC\u53F7\u4E0E\u6587\u5B57\u540C\u8272,\u5BF9\u9F50 levelTag)\n * ================================================================== */\n\nexport interface SourceMeta {\n  value: string;\n  /** \u65B9\u62EC\u53F7\u5185\u56FA\u5B9A 3 \u5B57\u7B26\uFF0C\u4E0E [INF] \u5BF9\u9F50 */\n  name: string;\n  paint: (s: string) => string;\n}\n\nexport const SOURCE_META: SourceMeta[] = [\n  { value: \"bds\", name: \"BDS\", paint: (s) => c.green(s) },\n  { value: \"db\", name: \"DB \", paint: (s) => c.blue(s) },\n  { value: \"qq\", name: \"QQ \", paint: (s) => c.purple(s) },\n  { value: \"llbot\", name: \"BOT\", paint: (s) => c.yellow(s) },\n  { value: \"system\", name: \"SYS\", paint: (s) => c.cyan(s) },\n  { value: \"update\", name: \"UPD\", paint: (s) => c.orange(s) },\n  { value: \"pack\", name: \"PAK\", paint: (s) => c.purple(s) },\n  { value: \"bds-tools\", name: \"TOL\", paint: (s) => c.red(s) },\n];\n\n/** \u6E90\u6807\u7B7E\u65E0\u8272\u6587\u672C\uFF08formatSourceTag / logPrefixWidth \u5171\u7528\uFF09 */\nfunction sourceTagPlain(source: string): string {\n  const meta = SOURCE_META.find((m) => m.value === source);\n  if (meta) return `[${meta.name}]`;\n  return `[${source.toUpperCase().padEnd(3).slice(0, 3)}]`;\n}\n\nexport function formatSourceTag(source: string): string {\n  const meta = SOURCE_META.find((m) => m.value === source);\n  const plain = sourceTagPlain(source);\n  if (meta) return meta.paint(plain);\n  return c.bold(plain);\n}\n\n/**\n * \u5C55\u793A\u7528\u7EA7\u522B\uFF1ABDS \u82E5\u4ECD\u5E26\u65F6\u95F4\u6233\u524D\u7F00\u5219\u89E3\u6790\u5185\u5D4C\u7EA7\u522B\uFF1B\u5DF2\u5265\u79BB\uFF08pushLog \u5165\u5E93\uFF09\u5219\u4FE1\u4EFB entry.level\u3002\n * \u7981\u6B62\u5BF9\u6B63\u6587\u505A\u677E\u6563\u5173\u952E\u8BCD\u5339\u914D\uFF08\u4F1A\u628A `[Commands] Error on line` \u8BEF\u5224\u4E3A error\uFF09\u3002\n */\nexport function resolveDisplayLevel(l: UnifiedLog): LogLevel {\n  if (l.source === \"bds\") {\n    const embedded = parseBdsEmbeddedLevel(l.text);\n    if (embedded) return embedded;\n  }\n  return l.level;\n}\n\n/** \u4ECE\u539F\u59CB\u6587\u672C\u63A8\u65AD\u7EA7\u522B\uFF1A\u59D4\u6258\u5171\u4EAB\u5305\uFF08\u5185\u542B BDS \u65F6\u95F4\u6233\u89E3\u6790\uFF09 */\nexport function inferLevel(text: string): LogLevel {\n  return sharedInferLevel(text);\n}\n\n/** \u65E0\u8272\u7EA7\u522B\u6807\u7B7E\u6587\u672C\uFF08\u53EF\u89C1\u5BBD\u5EA6\u6743\u5A01\u6E90\uFF1B\u62EC\u53F7\u5185\u5747\u4E3A 3 \u5B57\u7B26\uFF09 */\nconst LEVEL_TAG_TEXT: Record<LogLevel, string> = {\n  error: \"[ERR]\",\n  warn: \"[WRN]\",\n  success: \"[SUC]\",\n  debug: \"[DBG]\",\n  info: \"[INF]\",\n};\n\nfunction levelTagPlain(lvl: LogLevel): string {\n  return LEVEL_TAG_TEXT[lvl] ?? LEVEL_TAG_TEXT.info;\n}\n\nfunction levelTag(lvl: LogLevel): string {\n  const text = levelTagPlain(lvl);\n  switch (lvl) {\n    case \"error\":\n      return c.red(text);\n    case \"warn\":\n      return c.yellow(text);\n    case \"success\":\n      return c.green(c.bold(text));\n    case \"debug\":\n      return c.dim(text);\n    default:\n      return c.blue(text);\n  }\n}\n\n/** \u683C\u5F0F\u5316\u65E5\u5FD7\u7528\u4E8E REPL \u5C55\u793A (\u7528 theme.ts chalk \u914D\u8272) */\nexport function formatLog(l: UnifiedLog): string {\n  const ts = c.dim(l.time.toLocaleTimeString());\n  const level = resolveDisplayLevel(l);\n  const lvl = levelTag(level);\n  const src = formatSourceTag(l.source);\n  /* BDS\uFF1A\u53BB\u6389\u81EA\u5E26\u65F6\u95F4\u6233+\u7B49\u7EA7\u524D\u7F00\u540E\u518D\u9AD8\u4EAE\u6B63\u6587\uFF08push \u65F6\u591A\u534A\u5DF2\u5265\u8FC7\uFF0C\u6B64\u5904\u5E42\u7B49\uFF09 */\n  const txt = highlightLogLine(l.source === \"bds\" ? stripBdsLogPrefix(l.text) : l.text);\n  return `${ts} ${src} ${lvl} ${txt}`;\n}\n\n/* ==================================================================\n *  \u8F6F\u6362\u884C: \u8D85\u7EC8\u7AEF\u5BBD\u5EA6\u65F6\u6362\u884C,\u540E\u7EED\u884C\u7F29\u8FDB\u5BF9\u9F50\n * ================================================================== */\n\n/** \u5355\u4E2A\u5B57\u7B26\u5728\u7EC8\u7AEF\u7684\u663E\u793A\u5BBD\u5EA6 (CJK \u5168\u89D2=2, \u5176\u4F59=1) */\nfunction charWidth(ch: string): number {\n  const cp = ch.codePointAt(0) ?? 0;\n  if (\n    cp >= 0x1100 &&\n    (cp <= 0x115f ||\n      (cp >= 0x2e80 && cp <= 0xa4cf && cp !== 0x303f) ||\n      (cp >= 0xac00 && cp <= 0xd7a3) ||\n      (cp >= 0xf900 && cp <= 0xfaff) ||\n      (cp >= 0xfe30 && cp <= 0xfe4f) ||\n      (cp >= 0xff00 && cp <= 0xff60) ||\n      (cp >= 0xffe0 && cp <= 0xffe6) ||\n      (cp >= 0x20000 && cp <= 0x2fffd))\n  )\n    return 2;\n  return 1;\n}\n\n/** \u5B57\u7B26\u4E32\u5728\u7EC8\u7AEF\u7684\u53EF\u89C1\u5BBD\u5EA6 (strip ANSI \u540E\u6309 CJK \u5BBD\u5EA6\u7D2F\u52A0) */\nexport function visibleWidth(s: string): number {\n  const stripped = s.replace(/\\x1b\\[[0-9;]*m/g, \"\");\n  let w = 0;\n  for (const ch of stripped) w += charWidth(ch);\n  return w;\n}\n\n/**\n * \u65E5\u5FD7\u524D\u7F00\u53EF\u89C1\u5BBD\u5EA6(\u65F6\u95F4 + \u6E90 + \u7EA7\u522B + \u5C3E\u7A7A\u683C),\u4F9B\u60AC\u6302\u7F29\u8FDB\u5BF9\u9F50\u6B63\u6587\u8D77\u70B9\u3002\n * \u4E0E formatLog \u62FC\u63A5\u987A\u5E8F\u4FDD\u6301\u4E00\u81F4\uFF08\u5171\u7528 resolveDisplayLevel / sourceTagPlain / levelTagPlain\uFF09\u3002\n */\nexport function logPrefixWidth(l: UnifiedLog): number {\n  const ts = l.time.toLocaleTimeString();\n  const src = sourceTagPlain(l.source);\n  const level = resolveDisplayLevel(l);\n  return visibleWidth(`${ts} ${src} ${levelTagPlain(level)} `);\n}\n\n/**\n * \u6309\u7EC8\u7AEF\u53EF\u89C1\u5BBD\u5EA6\u6362\u884C;\u663E\u5F0F \\\\n \u4E0E\u8F6F\u6362\u884C\u7684\u540E\u7EED\u884C\u4E00\u5F8B\u5DE6\u4FA7\u7F29\u8FDB indent \u5217\u3002\n * \u4FDD\u7559 ANSI:\u6362\u884C\u65F6 reset,\u65B0\u884C\u6062\u590D\u5F53\u524D\u989C\u8272\u72B6\u6001(\u53EF\u591A\u5C42\u53E0\u52A0)\u3002\n * \u5BBD\u5B57\u7B26(CJK)\u6309 2 \u5217;cols \u9884\u7559 1 \u5217,\u907F\u514D Windows Terminal \u8FB9\u754C\u518D\u8F6F\u6298\u5230\u7B2C 0 \u5217\u3002\n */\nexport function wrapLogLine(s: string, indent: number): string {\n  const rawCols = process.stdout.columns || 80;\n  /* \u81F3\u5C11\u7559\u7ED9\u6B63\u6587\u82E5\u5E72\u5217,\u907F\u514D indent >= cols \u65F6\u6B7B\u5FAA\u73AF */\n  const cols = Math.max(rawCols - 1, indent + 4);\n  const segments = s.split(/\\r?\\n/);\n  const out: string[] = [];\n  for (let si = 0; si < segments.length; si++) {\n    const raw = segments[si]!;\n    /* \u663E\u5F0F\u6362\u884C\u6BB5\u53BB\u6389\u6587\u6848\u81EA\u5E26\u7684\u5DE6\u7A7A\u683C,\u7EDF\u4E00\u7531 hang indent \u5BF9\u9F50\u6B63\u6587 */\n    const piece = si === 0 ? raw : raw.replace(/^[ \\t]+/, \"\");\n    out.push(wrapSegment(piece, cols, si === 0 ? 0 : indent, indent));\n  }\n  return out.join(\"\\n\");\n}\n\n/** \u5355\u6BB5(\u65E0\u5185\u5D4C \\\\n)\u8F6F\u6362\u884C;startPad>0 \u8868\u793A\u672C\u6BB5\u5F00\u5934\u5DF2\u5360\u7528\u7684\u5217(\u663E\u5F0F\u6362\u884C\u540E\u7684\u60AC\u6302) */\nfunction wrapSegment(s: string, cols: number, startPad: number, hangIndent: number): string {\n  if (s.length === 0) return startPad > 0 ? \" \".repeat(startPad) : \"\";\n\n  const lines: string[] = [];\n  let cur = startPad > 0 ? \" \".repeat(startPad) : \"\";\n  let w = startPad;\n  /** \u5F53\u524D\u751F\u6548\u7684 ANSI \u5F00\u7801\u6808(\u4E0D\u542B reset),\u6362\u884C\u540E\u91CD\u653E */\n  const ansiStack: string[] = [];\n\n  const resetIfNeeded = (): void => {\n    if (ansiStack.length) cur += \"\\x1b[0m\";\n  };\n  const replayAnsi = (): void => {\n    for (const code of ansiStack) cur += code;\n  };\n\n  let i = 0;\n  while (i < s.length) {\n    const m = /^\\x1b\\[[0-9;]*m/.exec(s.slice(i));\n    if (m) {\n      const code = m[0]!;\n      cur += code;\n      if (code === \"\\x1b[0m\") ansiStack.length = 0;\n      else ansiStack.push(code);\n      i += code.length;\n      continue;\n    }\n\n    const cp = s.codePointAt(i)!;\n    const ch = String.fromCodePoint(cp);\n    const cw = charWidth(ch);\n    const advance = ch.length;\n\n    /* w > startPad:\u5F53\u524D\u884C\u9664\u5DE6\u57AB\u5916\u5DF2\u6709\u5185\u5BB9,\u53EF\u4EE5\u62C6\u884C;\u5426\u5219\u5F3A\u5236\u585E\u5165\u907F\u514D\u6B7B\u5FAA\u73AF */\n    if (w + cw > cols && w > startPad) {\n      resetIfNeeded();\n      lines.push(cur);\n      cur = \" \".repeat(hangIndent);\n      replayAnsi();\n      w = hangIndent;\n      startPad = hangIndent;\n    }\n\n    cur += ch;\n    w += cw;\n    i += advance;\n  }\n\n  if (ansiStack.length) cur += \"\\x1b[0m\";\n  lines.push(cur);\n  return lines.join(\"\\n\");\n}\n\n"],
+  "mappings": "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",
   "names": ["parseBdsEmbeddedLevel", "stripBdsLogPrefix", "sink"]
 }

package/dist/main.js

@@ -1,29 +1,37 @@
 #!/usr/bin/env node
 import process from "node:process";
-import pkg from "../package.json" with { type: "json" };
-import { cmdLogs, cmdRestart, cmdStart, cmdStartAll, cmdStatus, cmdStop, cmdStopAll, cmdUpdate } from "./commands.js";
-import { getHelp, startRepl } from "./repl.js";
-import { dispatchModuleCommand, isModuleCommand, scanAndWarnUnknown } from "./module-commands.js";
-import { dispatchPacksCommand, isPacksCommand } from "./world-packs.js";
-import { disableRemoteAgent, enrollRemoteAgent, remoteStatus, startRemoteAgent, stopRemoteAgent } from "./remote-agent.js";
-import { cmdLocale } from "./locale-command.js";
+import { mapPacksSubAlias, parseGlobalArgv } from "./argv-parse.js";
+import { cmdRestart, cmdStart, cmdStartAll, cmdStatus, cmdStop, cmdStopAll, cmdUpdate } from "./commands.js";
+import { gateModuleSub, gatePacksSub, gateTopLevel } from "./cli-gate.js";
+import { resolveModuleTopShorthand } from "./command-surface.js";
+import { cmdDebug } from "./debug-command.js";
 import { initLocale, stripLangArgs, t } from "./i18n/index.js";
+import { cmdLocale } from "./locale-command.js";
+import { dispatchModuleCommand, isModuleCommand, scanAndWarnUnknown } from "./module-commands.js";
+import { getHelp, playWelcomeAnimation, startRepl } from "./repl.js";
 import { ROOT } from "./runtime.js";
+import { setArgvDaemonize } from "./services.js";
 import { c } from "./theme.js";
-function printVersion() {
-  console.log(`${c.text(`\u282A\u2841\u286F\u2801`)}
-  ${c.text(`\u2812\u2801\u2803`)}${c.purple(`\u2804`)}
-  ${c.text(`\u2877\u2847\u284E\u2801`)}      ${c.text(`S`)}${c.dim(`cripts`)} ${c.text(`F`)}${c.dim(`or`)} ${c.text(`M`)}${c.dim(`ine`)}${c.text(`c`)}${c.dim(`raft Server`)} v${pkg.version}
-  ${c.text(`\u2803\u2803\u2811\u2802`)}      ${c.dim(`https://github.com/DogeLakeDev/ScriptsForMinecraftServer`)}`);
+import { dispatchPacksCommand, isPacksCommand } from "./world-packs.js";
+const MODE = "argv";
+async function printVersion() {
+  await playWelcomeAnimation();
 }
 function printUsage() {
-  console.log(`${getHelp()}`);
+  console.log(`${getHelp("argv")}`);
+}
+function deny(msg) {
+  console.log(msg);
+  process.exit(1);
 }
 async function main() {
   const stripped = stripLangArgs(process.argv.slice(2));
   initLocale({ root: ROOT, flag: stripped.lang });
-  const args = stripped.args;
-  if (args.length === 0) {
+  const { packsMode, args } = parseGlobalArgv(stripped.args);
+  if (args.length > 0 || packsMode) {
+    setArgvDaemonize(true);
+  }
+  if (args.length === 0 && !packsMode) {
     const { isRuntimeInitialized } = await import("./runtime.js");
     if (!isRuntimeInitialized()) {
       const { runWizard } = await import("./wizard.js");
@@ -33,11 +41,29 @@ async function main() {
     }
     const warn = await scanAndWarnUnknown();
     if (warn) console.log(warn);
-    startRemoteAgent();
     await startRepl();
     return;
   }
+  if (packsMode) {
+    const [subRaw, ...subRest] = args;
+    const sub = mapPacksSubAlias(subRaw);
+    const g = gatePacksSub(sub, MODE);
+    if (g) deny(g);
+    console.log(await dispatchPacksCommand(sub, subRest));
+    process.exit(0);
+  }
   const [cmd, ...rest] = args;
+  if (cmd && !["--help", "-h", "--version", "-v"].includes(cmd)) {
+    const topGate = gateTopLevel(cmd, MODE);
+    if (topGate) deny(topGate);
+  }
+  const moduleSub = resolveModuleTopShorthand(cmd);
+  if (moduleSub) {
+    const g = gateModuleSub(moduleSub, MODE);
+    if (g) deny(g);
+    console.log(await dispatchModuleCommand(moduleSub, rest));
+    process.exit(0);
+  }
   switch (cmd) {
     case "--help":
     case "-h":
@@ -46,21 +72,22 @@ async function main() {
       break;
     case "--version":
     case "-v":
-      printVersion();
+      await printVersion();
       break;
     case "locale":
     case "lang":
       console.log(cmdLocale(rest));
       break;
+    case "debug":
+      console.log(await cmdDebug(rest));
+      break;
     case "status":
-      console.log(cmdStatus());
+      console.log(await cmdStatus());
       break;
     case "logs":
-    case "log": {
-      const out = cmdLogs(rest);
-      if (out) console.log(out);
+    case "log":
+      deny(gateTopLevel("logs", MODE) ?? c.yellow(t("cli.replOnly", { cmd: "logs" })));
       break;
-    }
     case "start":
       if (rest[0] === "-all" || rest[0] === "all" || rest[0] === "--all") {
         console.log(await cmdStartAll());
@@ -95,6 +122,8 @@ async function main() {
     case "packs":
     case "addon": {
       const [sub, ...subRest] = rest;
+      const g = gatePacksSub(sub, MODE);
+      if (g) deny(g);
       console.log(await dispatchPacksCommand(sub, subRest));
       break;
     }
@@ -103,38 +132,18 @@ async function main() {
       await runWizard();
       break;
     }
-    case "remote": {
-      const [subcommand, ...remoteArgs] = rest;
-      if (subcommand === "enroll" && remoteArgs[0] && remoteArgs[1]) {
-        const name = remoteArgs[2] ?? process.env.COMPUTERNAME ?? "sfmc-agent";
-        const agentId = await enrollRemoteAgent(remoteArgs[0], remoteArgs[1], name);
-        console.log(t("remote.enrolled", { id: agentId }));
-        startRemoteAgent();
-        const exit = () => {
-          stopRemoteAgent();
-          process.exit(0);
-        };
-        process.once("SIGINT", exit);
-        process.once("SIGTERM", exit);
-        await new Promise(() => void 0);
-      } else if (subcommand === "status") {
-        console.log(JSON.stringify(remoteStatus(), null, 2));
-      } else if (subcommand === "disable") {
-        disableRemoteAgent();
-        console.log(t("remote.disabled"));
-      } else {
-        console.log(t("remote.usage"));
-      }
-      break;
-    }
     default:
       if (isModuleCommand(cmd)) {
         const [sub, ...subRest] = rest;
+        const g = gateModuleSub(sub, MODE);
+        if (g) deny(g);
         console.log(await dispatchModuleCommand(sub, subRest));
         break;
       }
       if (isPacksCommand(cmd)) {
         const [sub, ...subRest] = rest;
+        const g = gatePacksSub(sub, MODE);
+        if (g) deny(g);
         console.log(await dispatchPacksCommand(sub, subRest));
         break;
       }

package/dist/main.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\nimport process from \"node:process\";\nimport pkg from \"../package.json\" with { type: \"json\" };\nimport { cmdLogs, cmdRestart, cmdStart, cmdStartAll, cmdStatus, cmdStop, cmdStopAll, cmdUpdate } from \"./commands.js\";\nimport { getHelp, startRepl } from \"./repl.js\";\nimport { dispatchModuleCommand, isModuleCommand, scanAndWarnUnknown } from \"./module-commands.js\";\nimport { dispatchPacksCommand, isPacksCommand } from \"./world-packs.js\";\nimport { disableRemoteAgent, enrollRemoteAgent, remoteStatus, startRemoteAgent, stopRemoteAgent } from \"./remote-agent.js\";\nimport { cmdLocale } from \"./locale-command.js\";\nimport { initLocale, stripLangArgs, t } from \"./i18n/index.js\";\nimport { ROOT } from \"./runtime.js\";\nimport { c } from \"./theme.js\";\n\nfunction printVersion(): void {\n  /* \u6B64\u524D\u6A21\u677F\u5B57\u7B26\u4E32\u672A\u5199\u5165 stdout,\u5BFC\u81F4 `sfmc --version` \u65E0\u8F93\u51FA\u3002 */\n  console.log(`${c.text(`\u282A\u2841\u286F\u2801`)}\n  ${c.text(`\u2812\u2801\u2803`)}${c.purple(`\u2804`)}\n  ${c.text(`\u2877\u2847\u284E\u2801`)}      ${c.text(`S`)}${c.dim(`cripts`)} ${c.text(`F`)}${c.dim(`or`)} ${c.text(`M`)}${c.dim(`ine`)}${c.text(`c`)}${c.dim(`raft Server`)} v${pkg.version}\n  ${c.text(`\u2803\u2803\u2811\u2802`)}      ${c.dim(`https://github.com/DogeLakeDev/ScriptsForMinecraftServer`)}`);\n}\n\nfunction printUsage(): void {\n  console.log(`${getHelp()}`);\n}\n\nasync function main(): Promise<void> {\n  const stripped = stripLangArgs(process.argv.slice(2));\n  initLocale({ root: ROOT, flag: stripped.lang });\n  const args = stripped.args;\n\n  if (args.length === 0) {\n    /* \u9996\u6B21\u8FD0\u884C:\u4EE5 runtime.json#initialized_at \u4E3A\u51C6(\u975E db_config \u662F\u5426\u5B58\u5728)\u3002\n     * \u914D\u7F6E\u9AA8\u67B6\u7531 services.ensureJsonConfig \u5728\u542F\u52A8\u65F6\u521B\u5EFA,\u4E0D\u80FD\u518D\u5F53\u300C\u672A\u521D\u59CB\u5316\u300D\u4FE1\u53F7\u3002 */\n    const { isRuntimeInitialized } = await import(\"./runtime.js\");\n    if (!isRuntimeInitialized()) {\n      const { runWizard } = await import(\"./wizard.js\");\n      await runWizard();\n      const { refreshServices } = await import(\"./services.js\");\n      refreshServices();\n    }\n    /* Print yellow warnings for modules from outside the first-party registry.\n     * Best-effort: registry unreachable \u2192 no warning, no failure. */\n    const warn = await scanAndWarnUnknown();\n    if (warn) console.log(warn);\n    startRemoteAgent();\n    await startRepl();\n    return;\n  }\n\n  const [cmd, ...rest] = args;\n\n  switch (cmd) {\n    case \"--help\":\n    case \"-h\":\n    case \"help\":\n      printUsage();\n      break;\n    case \"--version\":\n    case \"-v\":\n      printVersion();\n      break;\n    case \"locale\":\n    case \"lang\":\n      console.log(cmdLocale(rest));\n      break;\n    case \"status\":\n      console.log(cmdStatus());\n      break;\n    case \"logs\":\n    case \"log\": {\n      const out = cmdLogs(rest);\n      if (out) console.log(out);\n      break;\n    }\n    case \"start\":\n      if (rest[0] === \"-all\" || rest[0] === \"all\" || rest[0] === \"--all\") {\n        console.log(await cmdStartAll());\n      } else if (rest[0]) {\n        console.log(await cmdStart(rest[0]));\n      } else {\n        console.log(c.yellow(t(\"svc.start.usage\")));\n      }\n      break;\n    case \"stop\":\n      if (rest[0] === \"-all\" || rest[0] === \"all\" || rest[0] === \"--all\") {\n        console.log(await cmdStopAll());\n      } else if (rest[0]) {\n        console.log(await cmdStop(rest[0]));\n      } else {\n        console.log(c.yellow(t(\"svc.stop.usage\")));\n      }\n      break;\n    case \"restart\":\n      if (rest[0] === \"-all\" || rest[0] === \"all\" || rest[0] === \"--all\") {\n        await cmdStopAll();\n        console.log(await cmdStartAll());\n      } else if (rest[0]) {\n        console.log(await cmdRestart(rest[0]));\n      } else {\n        console.log(c.yellow(t(\"svc.restart.usage\")));\n      }\n      break;\n    case \"update\":\n      console.log(await cmdUpdate(rest));\n      break;\n    case \"packs\":\n    case \"addon\": {\n      const [sub, ...subRest] = rest;\n      console.log(await dispatchPacksCommand(sub, subRest));\n      break;\n    }\n    case \"init\": {\n      const { runWizard } = await import(\"./wizard.js\");\n      await runWizard();\n      break;\n    }\n    case \"remote\": {\n      const [subcommand, ...remoteArgs] = rest;\n      if (subcommand === \"enroll\" && remoteArgs[0] && remoteArgs[1]) {\n        const name = remoteArgs[2] ?? process.env.COMPUTERNAME ?? \"sfmc-agent\";\n        const agentId = await enrollRemoteAgent(remoteArgs[0], remoteArgs[1], name);\n        console.log(t(\"remote.enrolled\", { id: agentId }));\n        startRemoteAgent();\n        const exit = (): void => {\n          stopRemoteAgent();\n          process.exit(0);\n        };\n        process.once(\"SIGINT\", exit);\n        process.once(\"SIGTERM\", exit);\n        /* keep alive so the WS loop can run; ctrl-c exits. */\n        await new Promise(() => undefined);\n      } else if (subcommand === \"status\") {\n        console.log(JSON.stringify(remoteStatus(), null, 2));\n      } else if (subcommand === \"disable\") {\n        disableRemoteAgent();\n        console.log(t(\"remote.disabled\"));\n      } else {\n        console.log(t(\"remote.usage\"));\n      }\n      break;\n    }\n    default:\n      /* module/mod \u522B\u540D\u53EA\u7EF4\u62A4 MODULE_CMD_NAMES,\u907F\u514D main/repl case \u94FE\u6F02\u79FB(OCP)\u3002 */\n      if (isModuleCommand(cmd)) {\n        const [sub, ...subRest] = rest;\n        console.log(await dispatchModuleCommand(sub, subRest));\n        break;\n      }\n      if (isPacksCommand(cmd)) {\n        const [sub, ...subRest] = rest;\n        console.log(await dispatchPacksCommand(sub, subRest));\n        break;\n      }\n      console.log(c.red(t(\"common.unknownCommand\", { cmd: cmd ?? \"\" })));\n      printUsage();\n      process.exit(1);\n  }\n  process.exit(0);\n}\n\nmain().catch((err) => {\n  console.error(c.red(err?.message ? t(\"common.error\", { message: err.message }) : t(\"common.fatal\")));\n  process.exit(1);\n});\n"],
-  "mappings": "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",
+  "sourcesContent": ["#!/usr/bin/env node\nimport process from \"node:process\";\nimport { mapPacksSubAlias, parseGlobalArgv } from \"./argv-parse.js\";\nimport { cmdRestart, cmdStart, cmdStartAll, cmdStatus, cmdStop, cmdStopAll, cmdUpdate } from \"./commands.js\";\nimport { gateModuleSub, gatePacksSub, gateTopLevel } from \"./cli-gate.js\";\nimport { resolveModuleTopShorthand } from \"./command-surface.js\";\nimport { cmdDebug } from \"./debug-command.js\";\nimport { initLocale, stripLangArgs, t } from \"./i18n/index.js\";\nimport { cmdLocale } from \"./locale-command.js\";\nimport { dispatchModuleCommand, isModuleCommand, scanAndWarnUnknown } from \"./module-commands.js\";\nimport { getHelp, playWelcomeAnimation, startRepl } from \"./repl.js\";\nimport { ROOT } from \"./runtime.js\";\nimport { setArgvDaemonize } from \"./services.js\";\nimport { c } from \"./theme.js\";\nimport { dispatchPacksCommand, isPacksCommand } from \"./world-packs.js\";\n\nconst MODE = \"argv\" as const;\n\nasync function printVersion(): Promise<void> {\n  await playWelcomeAnimation();\n}\n\nfunction printUsage(): void {\n  console.log(`${getHelp(\"argv\")}`);\n}\n\nfunction deny(msg: string): never {\n  console.log(msg);\n  process.exit(1);\n}\n\nasync function main(): Promise<void> {\n  const stripped = stripLangArgs(process.argv.slice(2));\n  initLocale({ root: ROOT, flag: stripped.lang });\n  const { packsMode, args } = parseGlobalArgv(stripped.args);\n\n  if (args.length > 0 || packsMode) {\n    setArgvDaemonize(true);\n  }\n\n  if (args.length === 0 && !packsMode) {\n    const { isRuntimeInitialized } = await import(\"./runtime.js\");\n    if (!isRuntimeInitialized()) {\n      const { runWizard } = await import(\"./wizard.js\");\n      await runWizard();\n      const { refreshServices } = await import(\"./services.js\");\n      refreshServices();\n    }\n    const warn = await scanAndWarnUnknown();\n    if (warn) console.log(warn);\n    await startRepl();\n    return;\n  }\n\n  if (packsMode) {\n    const [subRaw, ...subRest] = args;\n    const sub = mapPacksSubAlias(subRaw);\n    const g = gatePacksSub(sub, MODE);\n    if (g) deny(g);\n    console.log(await dispatchPacksCommand(sub, subRest));\n    process.exit(0);\n  }\n\n  const [cmd, ...rest] = args;\n\n  if (cmd && ![\"--help\", \"-h\", \"--version\", \"-v\"].includes(cmd)) {\n    const topGate = gateTopLevel(cmd, MODE);\n    if (topGate) deny(topGate);\n  }\n\n  const moduleSub = resolveModuleTopShorthand(cmd);\n  if (moduleSub) {\n    const g = gateModuleSub(moduleSub, MODE);\n    if (g) deny(g);\n    console.log(await dispatchModuleCommand(moduleSub, rest));\n    process.exit(0);\n  }\n\n  switch (cmd) {\n    case \"--help\":\n    case \"-h\":\n    case \"help\":\n      printUsage();\n      break;\n    case \"--version\":\n    case \"-v\":\n      await printVersion();\n      break;\n    case \"locale\":\n    case \"lang\":\n      console.log(cmdLocale(rest));\n      break;\n    case \"debug\":\n      console.log(await cmdDebug(rest));\n      break;\n    case \"status\":\n      console.log(await cmdStatus());\n      break;\n    case \"logs\":\n    case \"log\":\n      /* channel=repl\uFF1A\u6B63\u5E38\u7531 gateTopLevel \u62E6\u622A\uFF1B\u6B64\u5904\u515C\u5E95 */\n      deny(gateTopLevel(\"logs\", MODE) ?? c.yellow(t(\"cli.replOnly\", { cmd: \"logs\" })));\n      break;\n    case \"start\":\n      if (rest[0] === \"-all\" || rest[0] === \"all\" || rest[0] === \"--all\") {\n        console.log(await cmdStartAll());\n      } else if (rest[0]) {\n        console.log(await cmdStart(rest[0]));\n      } else {\n        console.log(c.yellow(t(\"svc.start.usage\")));\n      }\n      break;\n    case \"stop\":\n      if (rest[0] === \"-all\" || rest[0] === \"all\" || rest[0] === \"--all\") {\n        console.log(await cmdStopAll());\n      } else if (rest[0]) {\n        console.log(await cmdStop(rest[0]));\n      } else {\n        console.log(c.yellow(t(\"svc.stop.usage\")));\n      }\n      break;\n    case \"restart\":\n      if (rest[0] === \"-all\" || rest[0] === \"all\" || rest[0] === \"--all\") {\n        await cmdStopAll();\n        console.log(await cmdStartAll());\n      } else if (rest[0]) {\n        console.log(await cmdRestart(rest[0]));\n      } else {\n        console.log(c.yellow(t(\"svc.restart.usage\")));\n      }\n      break;\n    case \"update\":\n      console.log(await cmdUpdate(rest));\n      break;\n    case \"packs\":\n    case \"addon\": {\n      const [sub, ...subRest] = rest;\n      const g = gatePacksSub(sub, MODE);\n      if (g) deny(g);\n      console.log(await dispatchPacksCommand(sub, subRest));\n      break;\n    }\n    case \"init\": {\n      const { runWizard } = await import(\"./wizard.js\");\n      await runWizard();\n      break;\n    }\n    default:\n      if (isModuleCommand(cmd)) {\n        const [sub, ...subRest] = rest;\n        const g = gateModuleSub(sub, MODE);\n        if (g) deny(g);\n        console.log(await dispatchModuleCommand(sub, subRest));\n        break;\n      }\n      if (isPacksCommand(cmd)) {\n        const [sub, ...subRest] = rest;\n        const g = gatePacksSub(sub, MODE);\n        if (g) deny(g);\n        console.log(await dispatchPacksCommand(sub, subRest));\n        break;\n      }\n      console.log(c.red(t(\"common.unknownCommand\", { cmd: cmd ?? \"\" })));\n      printUsage();\n      process.exit(1);\n  }\n  process.exit(0);\n}\n\nmain().catch((err) => {\n  console.error(c.red(err?.message ? t(\"common.error\", { message: err.message }) : t(\"common.fatal\")));\n  process.exit(1);\n});\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/module-commands.d.ts

@@ -3,43 +3,23 @@
  * already on disk under `modules/packages/<id>/`.
  *
  * 顶层命令别名:`module` / `mod`(由 main.ts / repl.ts 共同识别)。
- *
- * Subcommands:
- *   list                    List every installed module (reads each
- *                           modules/packages/<id>/sapi/manifest.json).
- *                           Marks registry-known modules with `●` and
- *                           modules from an unknown publisher with `?`.
- *   search [id]             拉取 first-party registry 列表;带 id 则查该模块 registry info
- *   info <id>               Show one module's manifest + on-disk fingerprint
- *   verify [id]             Recompute the SHA-256 fingerprint of installed
- *                           modules (id = one; no id = all)
- *   install <id>            Wrapper around `tools/fetch-module.mjs install`.
- *                           If `--from` is omitted, the first-party registry
- *                           is consulted (Tanya7z/sfmc-modules).
- *                           `--link` 透传：dir 源用 junction/symlink（开发期）。
- *   uninstall <id>          Remove packages/<id>/ + catalog/lock via fetch-module
- *   enable <id>             POST /api/sfmc/modules/:id/enable on db-server
- *   disable <id>            POST /api/sfmc/modules/:id/disable on db-server
- *   create                  交互式脚手架（sfmc-modules/packages + 可选 link）
- *   link [id]               无 id：交互选择；有 id：install --link（自动探测旁路 sfmc-modules）
- *   dev                     link + enable + build + deploy 一键本地联调
- *
- * The CLI never connects to the network for local ops.
- * `search`/`install`/`uninstall` 需要网络(或本地 cache / --from)。
- * enable/disable go through db-server REST so module-lock.json stays consistent.
+ * 子命令通道门禁见 command-surface.ts（dispatch 前由 main/repl 判定）。
  */
-/** 顶层命令名(主名 + 短别名),供 HELP / 补全 / 分发共用。 */
+import { type CommandMode } from "./command-surface.js";
+import { type CliResult } from "./cli-result.js";
+/** 顶层命令名(主名 + 短别名),供帮助 / 补全 / 分发共用。 */
 export declare const MODULE_CMD_NAMES: readonly ["module", "mod"];
 export type ModuleCmdName = (typeof MODULE_CMD_NAMES)[number];
 /** 判断是否为 module 顶层命令(含别名);避免 main/repl 再硬编码 case。 */
 export declare function isModuleCommand(cmd: string | undefined): cmd is ModuleCmdName;
-/** 染色后的 HELP 前缀,避免 HELP 硬编码 module/mod。 */
-export declare function paintModuleCmdAlias(paint: (name: string) => string): string;
-/** 对外展示与 Tab 补全用的子命令列表(不含 remove 等同义别名)。 */
-export declare const MODULE_SUBCOMMANDS: readonly ["list", "search", "install", "uninstall", "verify", "info", "enable", "disable", "build", "reload", "create", "link", "dev"];
-import { type CliResult } from "./cli-result.js";
-/** Usage 行主名|别名(与 MODULE_CMD_NAMES 同源,避免与 HELP 漂移)。 */
-export declare function moduleUsage(): string;
+/** 开发者样式子命令（蓝标，非门禁）。 */
+export declare const DEV_ACCENT_MODULE_SUBCOMMANDS: readonly ["build", "reload"];
+/** 当前通道下可见的 module 子命令（自动补全 / usage）。 */
+export declare function getVisibleModuleSubcommands(mode: CommandMode): readonly string[];
+/** sub 是否为开发者蓝标（help 着色）。 */
+export declare function isDeveloperSubcommand(sub: string | undefined): boolean;
+/** Usage 行主名|别名(与 MODULE_CMD_NAMES 同源,避免与帮助文案漂移)。 */
+export declare function moduleUsage(mode?: CommandMode): string;
 export declare function cmdModuleList(_args: string[]): Promise<string>;
 /**
  * Walk `modules/packages/<id>/` and print a one-line yellow warning for each
@@ -59,18 +39,15 @@ export declare function cmdModuleVerify(args: string[]): Promise<string>;
 export declare function cmdModuleEnable(args: string[]): Promise<CliResult>;
 export declare function cmdModuleDisable(args: string[]): Promise<CliResult>;
 export declare function cmdModuleInstall(args: string[]): Promise<string>;
-/**
- * `mod link [id] [--from dir:…]`
- * - 有 id：等价 `install <id> --link`，缺省 --from 时自动拼旁路 packages/<id>
- * - 无 id：进入交互选择（@clack/prompts）
- */
-export declare function cmdModuleLink(args: string[]): Promise<string>;
 export declare function cmdModuleUninstall(args: string[]): Promise<string>;
 /**
  * 统一分发 module/mod 子命令 —— CLI(`main.ts`)与 REPL(`repl.ts`)共用,
- * 避免两处 switch 漂移(例如原先 REPL 缺 enable/disable)。
+ * 避免两处 switch 漂移。
+ *
+ * 通道门禁（argv/repl）由调用方在 dispatch 前经 command-surface 判定；
+ * 本函数只负责子命令路由。`remove` 作为 uninstall 的同义别名保留。
  *
- * `remove` 作为 uninstall 的同义别名保留。
+ * 作者向 test/watch/publish 已迁至 VS Code 扩展与 @sfmc-bds/devkit。
  */
 export declare function dispatchModuleCommand(sub: string | undefined, args: string[]): Promise<string>;
 /** 同步枚举已安装模块 id,供 REPL Tab 补全(不读 fingerprint,尽量轻量)。 */