@sfmc-bds/cli 0.2.0-beta.0 → 0.2.0-beta.10

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": ";AACA,OAAO,aAAa;AACpB,OAAO,SAAS,kBAAkB,KAAK,EAAE,MAAM,OAAO;AACtD,SAAS,SAAS,YAAY,UAAU,aAAa,WAAW,SAAS,YAAY,iBAAiB;AACtG,SAAS,SAAS,iBAAiB;AACnC,SAAS,uBAAuB,iBAAiB,0BAA0B;AAC3E,SAAS,sBAAsB,sBAAsB;AACrD,SAAS,oBAAoB,mBAAmB,cAAc,kBAAkB,uBAAuB;AACvG,SAAS,iBAAiB;AAC1B,SAAS,YAAY,eAAe,SAAS;AAC7C,SAAS,YAAY;AACrB,SAAS,SAAS;AAElB,SAAS,eAAqB;AAE5B,UAAQ,IAAI,GAAG,EAAE,KAAK,0BAAM,CAAC;AAAA,IAC3B,EAAE,KAAK,oBAAK,CAAC,GAAG,EAAE,OAAO,QAAG,CAAC;AAAA,IAC7B,EAAE,KAAK,0BAAM,CAAC,SAAS,EAAE,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,aAAa,CAAC,KAAK,IAAI,OAAO;AAAA,IACpK,EAAE,KAAK,0BAAM,CAAC,SAAS,EAAE,IAAI,0DAA0D,CAAC,EAAE;AAC9F;AAEA,SAAS,aAAmB;AAC1B,UAAQ,IAAI,GAAG,QAAQ,CAAC,EAAE;AAC5B;AAEA,eAAe,OAAsB;AACnC,QAAM,WAAW,cAAc,QAAQ,KAAK,MAAM,CAAC,CAAC;AACpD,aAAW,EAAE,MAAM,MAAM,MAAM,SAAS,KAAK,CAAC;AAC9C,QAAM,OAAO,SAAS;AAEtB,MAAI,KAAK,WAAW,GAAG;AAGrB,UAAM,EAAE,qBAAqB,IAAI,MAAM,OAAO,cAAc;AAC5D,QAAI,CAAC,qBAAqB,GAAG;AAC3B,YAAM,EAAE,UAAU,IAAI,MAAM,OAAO,aAAa;AAChD,YAAM,UAAU;AAChB,YAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,eAAe;AACxD,sBAAgB;AAAA,IAClB;AAGA,UAAM,OAAO,MAAM,mBAAmB;AACtC,QAAI,KAAM,SAAQ,IAAI,IAAI;AAC1B,qBAAiB;AACjB,UAAM,UAAU;AAChB;AAAA,EACF;AAEA,QAAM,CAAC,KAAK,GAAG,IAAI,IAAI;AAEvB,UAAQ,KAAK;AAAA,IACX,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,iBAAW;AACX;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,mBAAa;AACb;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,cAAQ,IAAI,UAAU,IAAI,CAAC;AAC3B;AAAA,IACF,KAAK;AACH,cAAQ,IAAI,UAAU,CAAC;AACvB;AAAA,IACF,KAAK;AAAA,IACL,KAAK,OAAO;AACV,YAAM,MAAM,QAAQ,IAAI;AACxB,UAAI,IAAK,SAAQ,IAAI,GAAG;AACxB;AAAA,IACF;AAAA,IACA,KAAK;AACH,UAAI,KAAK,CAAC,MAAM,UAAU,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,MAAM,SAAS;AAClE,gBAAQ,IAAI,MAAM,YAAY,CAAC;AAAA,MACjC,WAAW,KAAK,CAAC,GAAG;AAClB,gBAAQ,IAAI,MAAM,SAAS,KAAK,CAAC,CAAC,CAAC;AAAA,MACrC,OAAO;AACL,gBAAQ,IAAI,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAAA,MAC5C;AACA;AAAA,IACF,KAAK;AACH,UAAI,KAAK,CAAC,MAAM,UAAU,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,MAAM,SAAS;AAClE,gBAAQ,IAAI,MAAM,WAAW,CAAC;AAAA,MAChC,WAAW,KAAK,CAAC,GAAG;AAClB,gBAAQ,IAAI,MAAM,QAAQ,KAAK,CAAC,CAAC,CAAC;AAAA,MACpC,OAAO;AACL,gBAAQ,IAAI,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAAA,MAC3C;AACA;AAAA,IACF,KAAK;AACH,UAAI,KAAK,CAAC,MAAM,UAAU,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,MAAM,SAAS;AAClE,cAAM,WAAW;AACjB,gBAAQ,IAAI,MAAM,YAAY,CAAC;AAAA,MACjC,WAAW,KAAK,CAAC,GAAG;AAClB,gBAAQ,IAAI,MAAM,WAAW,KAAK,CAAC,CAAC,CAAC;AAAA,MACvC,OAAO;AACL,gBAAQ,IAAI,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;AAAA,MAC9C;AACA;AAAA,IACF,KAAK;AACH,cAAQ,IAAI,MAAM,UAAU,IAAI,CAAC;AACjC;AAAA,IACF,KAAK;AAAA,IACL,KAAK,SAAS;AACZ,YAAM,CAAC,KAAK,GAAG,OAAO,IAAI;AAC1B,cAAQ,IAAI,MAAM,qBAAqB,KAAK,OAAO,CAAC;AACpD;AAAA,IACF;AAAA,IACA,KAAK,QAAQ;AACX,YAAM,EAAE,UAAU,IAAI,MAAM,OAAO,aAAa;AAChD,YAAM,UAAU;AAChB;AAAA,IACF;AAAA,IACA,KAAK,UAAU;AACb,YAAM,CAAC,YAAY,GAAG,UAAU,IAAI;AACpC,UAAI,eAAe,YAAY,WAAW,CAAC,KAAK,WAAW,CAAC,GAAG;AAC7D,cAAM,OAAO,WAAW,CAAC,KAAK,QAAQ,IAAI,gBAAgB;AAC1D,cAAM,UAAU,MAAM,kBAAkB,WAAW,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI;AAC1E,gBAAQ,IAAI,EAAE,mBAAmB,EAAE,IAAI,QAAQ,CAAC,CAAC;AACjD,yBAAiB;AACjB,cAAM,OAAO,MAAY;AACvB,0BAAgB;AAChB,kBAAQ,KAAK,CAAC;AAAA,QAChB;AACA,gBAAQ,KAAK,UAAU,IAAI;AAC3B,gBAAQ,KAAK,WAAW,IAAI;AAE5B,cAAM,IAAI,QAAQ,MAAM,MAAS;AAAA,MACnC,WAAW,eAAe,UAAU;AAClC,gBAAQ,IAAI,KAAK,UAAU,aAAa,GAAG,MAAM,CAAC,CAAC;AAAA,MACrD,WAAW,eAAe,WAAW;AACnC,2BAAmB;AACnB,gBAAQ,IAAI,EAAE,iBAAiB,CAAC;AAAA,MAClC,OAAO;AACL,gBAAQ,IAAI,EAAE,cAAc,CAAC;AAAA,MAC/B;AACA;AAAA,IACF;AAAA,IACA;AAEE,UAAI,gBAAgB,GAAG,GAAG;AACxB,cAAM,CAAC,KAAK,GAAG,OAAO,IAAI;AAC1B,gBAAQ,IAAI,MAAM,sBAAsB,KAAK,OAAO,CAAC;AACrD;AAAA,MACF;AACA,UAAI,eAAe,GAAG,GAAG;AACvB,cAAM,CAAC,KAAK,GAAG,OAAO,IAAI;AAC1B,gBAAQ,IAAI,MAAM,qBAAqB,KAAK,OAAO,CAAC;AACpD;AAAA,MACF;AACA,cAAQ,IAAI,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC;AACjE,iBAAW;AACX,cAAQ,KAAK,CAAC;AAAA,EAClB;AACA,UAAQ,KAAK,CAAC;AAChB;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,MAAM,EAAE,IAAI,KAAK,UAAU,EAAE,gBAAgB,EAAE,SAAS,IAAI,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AACnG,UAAQ,KAAK,CAAC;AAChB,CAAC;",
+  "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,尽量轻量)。 */

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

@@ -1 +1 @@
-{"version":3,"file":"module-commands.d.ts","sourceRoot":"","sources":["../src/module-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,YAAI,QAAQ,EAAE,KAAK,CAAU,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,IAAI,aAAa,CAE7E;AAED,2CAA2C;AAC3C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAG3E;AAED,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,YAC7B,MAAM,EACN,QAAQ,EACR,SAAS,EACT,WAAW,EACX,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,SAAS,EACT,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,KAAK,CACG,CAAC;AAOX,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAYvE,uDAAuD;AACvD,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAmFD,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkCpE;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAO1D;AAKD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DrE;AAKD,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BnE;AAKD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAerE;AAkDD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAIxE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAIzE;AAKD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDtE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBnE;AAKD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BxE;AAuBD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCpG;AAED,uDAAuD;AACvD,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAWrD"}
+{"version":3,"file":"module-commands.d.ts","sourceRoot":"","sources":["../src/module-commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAmBvE,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,YAAI,QAAQ,EAAE,KAAK,CAAU,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,IAAI,aAAa,CAE7E;AAED,wBAAwB;AACxB,eAAO,MAAM,6BAA6B,YAAI,OAAO,EAAE,QAAQ,CAAU,CAAC;AAE1E,yCAAyC;AACzC,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,MAAM,EAAE,CAEhF;AAED,6BAA6B;AAC7B,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEtE;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,IAAI,GAAE,WAAoB,GAAG,MAAM,CAK9D;AAmFD,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkCpE;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAO1D;AAKD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DrE;AAKD,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BnE;AAKD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAerE;AAqHD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAIxE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAIzE;AAqCD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDtE;AAKD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BxE;AAuBD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoCpG;AAED,uDAAuD;AACvD,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAWrD"}

package/dist/module-commands.js

@@ -1,45 +1,48 @@
-const MODULE_CMD_NAMES = ["module", "mod"];
-function isModuleCommand(cmd) {
-  return !!cmd && MODULE_CMD_NAMES.includes(cmd);
-}
-function paintModuleCmdAlias(paint) {
-  return MODULE_CMD_NAMES.map((name) => paint(name)).join("/");
-}
-const MODULE_SUBCOMMANDS = [
-  "list",
-  "search",
-  "install",
-  "uninstall",
-  "verify",
-  "info",
-  "enable",
-  "disable",
-  "build",
-  "reload",
-  "create",
-  "link",
-  "dev"
-];
 import fs from "node:fs/promises";
-import { existsSync, readdirSync } from "node:fs";
+import { existsSync, lstatSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { spawn } from "node:child_process";
-import { configPath, modulePath, readJson } from "@sfmc-bds/sdk/node/config";
+import {
+  configPath,
+  modulePath,
+  readJson,
+  writeJson
+} from "@sfmc-bds/sdk/node/config";
+import {
+  isDevAccentModuleSub,
+  listVisibleModuleSubs
+} from "./command-surface.js";
 import { failResult, okResult } from "./cli-result.js";
 import { t } from "./i18n/index.js";
 import { c } from "./theme.js";
 import { ROOT, resolveFetchModule } from "./runtime.js";
 import { dirFingerprint } from "./module-fingerprint.js";
+import {
+  applyLockEnabled,
+  finalizeToggle,
+  resolveToggleTarget
+} from "./module-toggle.js";
 import {
   DEFAULT_REGISTRY_REPO,
   DEFAULT_REGISTRY_TAG,
   findUnknownModules,
   resolveRegistryIndex
 } from "./registry.js";
-function moduleUsage() {
+const MODULE_CMD_NAMES = ["module", "mod"];
+function isModuleCommand(cmd) {
+  return !!cmd && MODULE_CMD_NAMES.includes(cmd);
+}
+const DEV_ACCENT_MODULE_SUBCOMMANDS = ["build", "reload"];
+function getVisibleModuleSubcommands(mode) {
+  return listVisibleModuleSubs(mode);
+}
+function isDeveloperSubcommand(sub) {
+  return isDevAccentModuleSub(sub);
+}
+function moduleUsage(mode = "argv") {
   return t("mod.usage", {
     cmds: MODULE_CMD_NAMES.join("|"),
-    subs: MODULE_SUBCOMMANDS.join("|")
+    subs: getVisibleModuleSubcommands(mode).join("|")
   });
 }
 function modulesDir() {
@@ -148,7 +151,7 @@ async function cmdModuleSearch(args) {
     return c.red(
       `
 Registry empty or unreachable (${DEFAULT_REGISTRY_REPO}@${DEFAULT_REGISTRY_TAG}).
-Check network, or install with an explicit source: sfmc mod install <id> --from github:owner/repo@tag
+Check network, or: mod install <id> --from github:owner/repo@tag
 `
     );
   }
@@ -250,11 +253,45 @@ async function cmdModuleVerify(args) {
 function readDbConfig() {
   return readJson(configPath(ROOT, "db_config.json")) ?? {};
 }
-async function postModuleToggle(id, action) {
+function moduleLockPath() {
+  return modulePath(path.join(ROOT, "modules"), "module-lock.json");
+}
+function catalogPathOnDisk() {
+  return modulePath(path.join(ROOT, "modules"), "catalog.json");
+}
+function buildToggleCandidates(installed) {
+  const catalog = readJson(catalogPathOnDisk()) ?? {};
+  const rows = Array.isArray(catalog.modules) ? catalog.modules : [];
+  const byLogical = /* @__PURE__ */ new Map();
+  for (const raw of rows) {
+    if (!raw || typeof raw !== "object") continue;
+    const id = String(raw.id || "").trim();
+    if (id) byLogical.set(id, raw);
+  }
+  return installed.map((m) => {
+    const logicalId = typeof m.manifest?.id === "string" && m.manifest.id ? m.manifest.id : m.id;
+    const raw = byLogical.get(logicalId);
+    const configKeyRaw = raw ? String(raw.configKey || raw.config_key || "").trim() : "";
+    const canDisable = raw ? raw.canDisable !== false : true;
+    const out = { logicalId, folderId: m.id, canDisable };
+    if (configKeyRaw) out.configKey = configKeyRaw;
+    return out;
+  });
+}
+function writeLocalModuleEnabled(logicalId, enabled) {
+  const lockPath = moduleLockPath();
+  const lock = readJson(lockPath) ?? {
+    version: 1,
+    modules: {}
+  };
+  applyLockEnabled(lock, logicalId, enabled);
+  writeJson(lockPath, lock);
+}
+async function notifyDbToggle(logicalId, action) {
   const cfg = readDbConfig();
   const port = cfg.db_port ?? 3001;
   const token = cfg.http_auth || "";
-  const url = `http://127.0.0.1:${port}/api/sfmc/modules/${encodeURIComponent(id)}/${action}`;
+  const url = `http://127.0.0.1:${port}/api/sfmc/modules/${encodeURIComponent(logicalId)}/${action}`;
   let res;
   try {
     res = await fetch(url, {
@@ -265,9 +302,7 @@ async function postModuleToggle(id, action) {
       }
     });
   } catch (err) {
-    return failResult(
-      c.red(t("mod.dbUnreachable", { url, message: err.message }))
-    );
+    return { ok: false, reason: "unreachable", detail: err.message };
   }
   const text = await res.text();
   let body;
@@ -278,24 +313,62 @@ async function postModuleToggle(id, action) {
   }
   if (!res.ok) {
     const err = body?.error ?? `HTTP ${res.status}`;
-    return failResult(c.red(t("mod.toggleFailed", { action, id, err })));
+    return { ok: false, reason: "http", detail: err };
+  }
+  if (body?.success === false) {
+    return { ok: false, reason: "http", detail: text };
+  }
+  return { ok: true };
+}
+async function cmdModuleToggle(query, action) {
+  const installed = await scanInstalled();
+  const target = resolveToggleTarget(query, buildToggleCandidates(installed));
+  if (!target) {
+    return failResult(c.red(t("mod.notInstalled", { id: query })));
+  }
+  if (action === "disable" && !target.canDisable) {
+    return failResult(c.red(t("mod.cannotDisable", { id: target.logicalId })));
+  }
+  const enabled = action === "enable";
+  try {
+    writeLocalModuleEnabled(target.logicalId, enabled);
+  } catch (err) {
+    return failResult(
+      c.red(t("mod.toggleLockFailed", { id: target.logicalId, message: err.message }))
+    );
   }
-  const ok = body?.success !== false;
-  if (ok) {
-    const label = action === "enable" ? t("mod.action.enabled") : t("mod.action.disabled");
-    return okResult(c.green(t("mod.toggleOk", { label, id })));
+  const notify = await notifyDbToggle(target.logicalId, action);
+  const fin = finalizeToggle(true, notify);
+  const label = action === "enable" ? t("mod.action.enabled") : t("mod.action.disabled");
+  const head = c.green(t("mod.toggleOk", { label, id: target.logicalId }));
+  if (!fin.warnNotify) {
+    return okResult(head);
   }
-  return failResult(c.red(t("mod.toggleBadBody", { action, id, text })));
+  const detail = notify.ok === false ? notify.detail ?? notify.reason : "";
+  const warn = c.yellow(t("mod.toggleDbSkipped", { detail }));
+  return okResult(`${head}
+${warn}`);
 }
 async function cmdModuleEnable(args) {
   const id = args[0];
   if (!id) return failResult(c.yellow(t("mod.enable.usage")));
-  return postModuleToggle(id, "enable");
+  return cmdModuleToggle(id, "enable");
 }
 async function cmdModuleDisable(args) {
   const id = args[0];
   if (!id) return failResult(c.yellow(t("mod.disable.usage")));
-  return postModuleToggle(id, "disable");
+  return cmdModuleToggle(id, "disable");
+}
+function validateFromScheme(from) {
+  if (from === "local" || from.startsWith("local:") || from.startsWith("dir:") || from.startsWith("npm:") || from.startsWith("tgz:") || from.startsWith("zip:") || from.startsWith("github:")) {
+    return null;
+  }
+  if (existsSync(from)) {
+    const st = lstatSync(from);
+    if (st.isDirectory()) return null;
+    return `--from \u88F8\u8DEF\u5F84\u987B\u4E3A\u76EE\u5F55\uFF08\u6587\u4EF6\u8BF7\u7528 --from local:<tgz|zip>\uFF09: ${from}`;
+  }
+  return t("mod.fromUnknown", { value: from });
 }
 async function cmdModuleInstall(args) {
   const flags = parseFlags(args);
@@ -312,13 +385,9 @@ async function cmdModuleInstall(args) {
   if (positional.length === 0) {
     return c.yellow(t("mod.install.usage"));
   }
-  if (flags.link && !flags.from) {
-    const { resolveSfmcModulesRoot, packageDirForId } = await import("./sfmc-modules-root.js");
-    const modulesRoot = resolveSfmcModulesRoot();
-    if (!modulesRoot) {
-      return c.red(t("mod.linkNeedsFrom"));
-    }
-    flags.from = positional.length === 1 ? `dir:${packageDirForId(modulesRoot, positional[0])}` : `dir:${path.join(modulesRoot, "packages")}`;
+  if (flags.from) {
+    const err = validateFromScheme(flags.from);
+    if (err) return c.red(err);
   }
   const fetchScript = resolveFetchModule();
   if (!fetchScript) {
@@ -347,27 +416,6 @@ async function cmdModuleInstall(args) {
     proc.on("error", (e) => resolve(c.red(`spawn failed: ${e.message}`)));
   });
 }
-async function cmdModuleLink(args) {
-  const flags = parseFlags(args);
-  const positional = [];
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === "--from" || args[i] === "--sha256") {
-      i++;
-      continue;
-    }
-    if (args[i]?.startsWith("--from=") || args[i]?.startsWith("--sha256=")) continue;
-    if (args[i]?.startsWith("--")) continue;
-    positional.push(args[i]);
-  }
-  if (positional.length === 0) {
-    const { runModuleLinkWizard } = await import("./module-wizard.js");
-    return runModuleLinkWizard();
-  }
-  const id = positional[0];
-  const installArgs = [id, "--link"];
-  if (flags.from) installArgs.push("--from", flags.from);
-  return cmdModuleInstall(installArgs);
-}
 async function cmdModuleUninstall(args) {
   const id = args[0];
   if (!id) return c.yellow(t("mod.uninstall.usage"));
@@ -428,23 +476,19 @@ async function dispatchModuleCommand(sub, args) {
     case "disable":
       return (await cmdModuleDisable(args)).message;
     case "build": {
-      const { cmdPackBuild } = await import("./pack-lifecycle.js");
-      return (await cmdPackBuild(args)).message;
+      const { cmdModuleBuild } = await import("./module-pack-build.js");
+      return cmdModuleBuild(args);
     }
     case "reload": {
-      const { cmdReload } = await import("./commands-reload.js");
-      return cmdReload(args);
-    }
-    case "create": {
-      const { runModuleCreateWizard } = await import("./module-wizard.js");
-      return runModuleCreateWizard();
-    }
-    case "link":
-      return cmdModuleLink(args);
-    case "dev": {
-      const { runModuleDevWizard } = await import("./module-wizard.js");
-      return runModuleDevWizard();
+      const { cmdModuleReload } = await import("./module-pack-build.js");
+      return cmdModuleReload(args);
     }
+    case "test":
+    case "watch":
+    case "publish":
+      return c.yellow(
+        `[mod ${sub}] \u5DF2\u79FB\u81F3 VS Code/Cursor \u6269\u5C55\u300CSFMC Module\u300D\u4E0E @sfmc-bds/devkit\uFF1B\u8FD0\u7EF4\u8BF7\u7528 mod build|reload|install\u3002`
+      );
     default:
       return c.yellow(moduleUsage());
   }
@@ -459,22 +503,22 @@ function listInstalledModuleIdsSync() {
   }
 }
 export {
+  DEV_ACCENT_MODULE_SUBCOMMANDS,
   MODULE_CMD_NAMES,
-  MODULE_SUBCOMMANDS,
   cmdModuleDisable,
   cmdModuleEnable,
   cmdModuleInfo,
   cmdModuleInstall,
-  cmdModuleLink,
   cmdModuleList,
   cmdModuleSearch,
   cmdModuleUninstall,
   cmdModuleVerify,
   dispatchModuleCommand,
+  getVisibleModuleSubcommands,
+  isDeveloperSubcommand,
   isModuleCommand,
   listInstalledModuleIdsSync,
   moduleUsage,
-  paintModuleCmdAlias,
   scanAndWarnUnknown
 };
 //# sourceMappingURL=module-commands.js.map