@sfmc-bds/cli 0.2.0-beta.5 → 0.2.0-beta.7

package/dist/main.js

@@ -1,29 +1,38 @@
 #!/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,
+  resolveModuleShorthandSub
+} from "./argv-parse.js";
+import { cmdRemote } from "./cmd-remote.js";
+import { cmdRestart, cmdStart, cmdStartAll, cmdStatus, cmdStop, cmdStopAll, cmdUpdate } from "./commands.js";
+import { gateModuleSub, gatePacksSub, gateTopLevel } from "./cli-gate.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 { startRemoteAgent } from "./remote-agent.js";
+import { getHelp, playWelcomeAnimation, startRepl } from "./repl.js";
 import { ROOT } from "./runtime.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) {
     const { isRuntimeInitialized } = await import("./runtime.js");
     if (!isRuntimeInitialized()) {
       const { runWizard } = await import("./wizard.js");
@@ -37,7 +46,26 @@ async function main() {
     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 = resolveModuleShorthandSub(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 +74,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 +124,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 +134,21 @@ 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"));
-      }
+    case "remote":
+      console.log(await cmdRemote(rest, { daemonAfterEnroll: true }));
       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 {\n  mapPacksSubAlias,\n  parseGlobalArgv,\n  resolveModuleShorthandSub,\n} from \"./argv-parse.js\";\nimport { cmdRemote } from \"./cmd-remote.js\";\nimport { cmdRestart, cmdStart, cmdStartAll, cmdStatus, cmdStop, cmdStopAll, cmdUpdate } from \"./commands.js\";\nimport { gateModuleSub, gatePacksSub, gateTopLevel } from \"./cli-gate.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 { startRemoteAgent } from \"./remote-agent.js\";\nimport { getHelp, playWelcomeAnimation, startRepl } from \"./repl.js\";\nimport { ROOT } from \"./runtime.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    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    startRemoteAgent();\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 = resolveModuleShorthandSub(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    case \"remote\":\n      console.log(await cmdRemote(rest, { daemonAfterEnroll: true }));\n      break;\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,31 +3,10 @@
  * 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 判定）。
  */
+import { type CommandMode } from "./command-surface.js";
+import { type CliResult } from "./cli-result.js";
 /** 顶层命令名(主名 + 短别名),供 HELP / 补全 / 分发共用。 */
 export declare const MODULE_CMD_NAMES: readonly ["module", "mod"];
 export type ModuleCmdName = (typeof MODULE_CMD_NAMES)[number];
@@ -35,11 +14,21 @@ export type ModuleCmdName = (typeof MODULE_CMD_NAMES)[number];
 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";
+/** @deprecated 使用 listVisibleModuleSubs(mode)；保留全集供调试。 */
+export declare const ALL_MODULE_SUBCOMMANDS: readonly ["list", "search", "install", "uninstall", "verify", "info", "enable", "disable", "build", "reload"];
+/** 开发者样式子命令（蓝标，非门禁）。 */
+export declare const DEV_ACCENT_MODULE_SUBCOMMANDS: readonly ["build", "reload"];
+/** @deprecated 使用 ALL_MODULE_SUBCOMMANDS 或 listVisibleModuleSubs。 */
+export declare const MODULE_SUBCOMMANDS: readonly ["list", "search", "install", "uninstall", "verify", "info", "enable", "disable", "build", "reload"];
+/** @deprecated 使用 DEV_ACCENT_MODULE_SUBCOMMANDS / isDevAccentModuleSub。 */
+export declare const DEV_MODULE_SUBCOMMANDS: readonly ["build", "reload"];
+export type ModuleSubcommand = (typeof ALL_MODULE_SUBCOMMANDS)[number];
+/** 当前通道下可见的 module 子命令（自动补全 / usage）。 */
+export declare function getVisibleModuleSubcommands(mode: CommandMode): readonly string[];
+/** sub 是否为开发者蓝标（help 着色）。 */
+export declare function isDeveloperSubcommand(sub: string | undefined): boolean;
 /** Usage 行主名|别名(与 MODULE_CMD_NAMES 同源,避免与 HELP 漂移)。 */
-export declare function moduleUsage(): string;
+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 +48,19 @@ 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>;
+export declare function cmdModuleUninstall(args: string[]): Promise<string>;
 /**
- * `mod link [id] [--from dir:…]`
- * - 有 id：等价 `install <id> --link`，缺省 --from 时自动拼旁路 packages/<id>
- * - 无 id：进入交互选择（@clack/prompts）
+ * `sfmc mod test` — 委托模块仓的 test runner（node --test + @sfmc-bds/sdk/testing）。
+ * 解析 --from local[:path] 规则与 watch 一致；缺省 cwd。
+ * 透传 npm test：让模块仓的 `scripts.test` 自己决定怎么跑（node --test / tsx / vitest 等）。
  */
-export declare function cmdModuleLink(args: string[]): Promise<string>;
-export declare function cmdModuleUninstall(args: string[]): Promise<string>;
+export declare function cmdModuleTest(args: string[]): Promise<string>;
 /**
  * 统一分发 module/mod 子命令 —— CLI(`main.ts`)与 REPL(`repl.ts`)共用,
- * 避免两处 switch 漂移(例如原先 REPL 缺 enable/disable)。
+ * 避免两处 switch 漂移。
  *
- * `remove` 作为 uninstall 的同义别名保留。
+ * 通道门禁（external/repl）由调用方在 dispatch 前经 command-surface 判定；
+ * 本函数只负责子命令路由。`remove` 作为 uninstall 的同义别名保留。
  */
 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;AAOH,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAYvE,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,CAE3E;AAED,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,YACjC,MAAM,EACN,QAAQ,EACR,SAAS,EACT,WAAW,EACX,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,SAAS,EACT,OAAO,EACP,QAAQ,CACA,CAAC;AAEX,wBAAwB;AACxB,eAAO,MAAM,6BAA6B,YAAI,OAAO,EAAE,QAAQ,CAAU,CAAC;AAE1E,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,+GAAyB,CAAC;AAEzD,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,8BAAgC,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,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,uDAAuD;AACvD,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;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;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;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2CnE;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyCpG;AAED,uDAAuD;AACvD,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAWrD"}

package/dist/module-commands.js

@@ -1,3 +1,23 @@
+import fs from "node:fs/promises";
+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 {
+  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 {
+  DEFAULT_REGISTRY_REPO,
+  DEFAULT_REGISTRY_TAG,
+  findUnknownModules,
+  resolveRegistryIndex
+} from "./registry.js";
 const MODULE_CMD_NAMES = ["module", "mod"];
 function isModuleCommand(cmd) {
   return !!cmd && MODULE_CMD_NAMES.includes(cmd);
@@ -5,7 +25,7 @@ function isModuleCommand(cmd) {
 function paintModuleCmdAlias(paint) {
   return MODULE_CMD_NAMES.map((name) => paint(name)).join("/");
 }
-const MODULE_SUBCOMMANDS = [
+const ALL_MODULE_SUBCOMMANDS = [
   "list",
   "search",
   "install",
@@ -15,31 +35,21 @@ const MODULE_SUBCOMMANDS = [
   "enable",
   "disable",
   "build",
-  "reload",
-  "create",
-  "link",
-  "dev"
+  "reload"
 ];
-import fs from "node:fs/promises";
-import { existsSync, 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 { 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 {
-  DEFAULT_REGISTRY_REPO,
-  DEFAULT_REGISTRY_TAG,
-  findUnknownModules,
-  resolveRegistryIndex
-} from "./registry.js";
-function moduleUsage() {
+const DEV_ACCENT_MODULE_SUBCOMMANDS = ["build", "reload"];
+const MODULE_SUBCOMMANDS = ALL_MODULE_SUBCOMMANDS;
+const DEV_MODULE_SUBCOMMANDS = DEV_ACCENT_MODULE_SUBCOMMANDS;
+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 +158,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
 `
     );
   }
@@ -297,6 +307,17 @@ async function cmdModuleDisable(args) {
   if (!id) return failResult(c.yellow(t("mod.disable.usage")));
   return postModuleToggle(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);
   const positional = [];
@@ -312,13 +333,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 +364,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"));
@@ -408,6 +404,46 @@ function parseFlags(args) {
   }
   return flags;
 }
+async function cmdModuleTest(args) {
+  let fromRaw = null;
+  const passthrough = [];
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--from") {
+      fromRaw = args[++i] ?? null;
+    } else if (a?.startsWith("--from=")) {
+      fromRaw = a.slice("--from=".length);
+    } else if (a === "--help" || a === "-h") {
+      return c.dim("\u7528\u6CD5: mod test [--from local[:<path>]] [-- <args>]\n  \u900F\u4F20\u7ED9\u6A21\u5757\u4ED3\u7684 npm test\u3002");
+    } else {
+      passthrough.push(a);
+    }
+  }
+  const { resolveLocalModuleRoot } = await import("./module-watch.js");
+  const cwd = resolveLocalModuleRoot({ from: fromRaw, cwd: process.cwd() });
+  if (!existsSync(cwd)) {
+    return c.red(`[mod test] \u8DEF\u5F84\u4E0D\u5B58\u5728: ${cwd}`);
+  }
+  if (!existsSync(path.join(cwd, "package.json"))) {
+    return c.yellow(`[mod test] \u672A\u627E\u5230 package.json: ${cwd}
+  \u63D0\u793A\uFF1A\u8FDB\u5165\u6A21\u5757\u4ED3\u6839\u76EE\u5F55\uFF0C\u6216\u7528 --from local:<path> \u6307\u5411\u3002`);
+  }
+  const isWin = process.platform === "win32";
+  const cmd = isWin ? "cmd.exe" : "npm";
+  const subArgs = isWin ? ["/c", "npm", "test", "--", ...passthrough] : ["test", "--", ...passthrough];
+  return new Promise((resolve) => {
+    const proc = spawn(cmd, subArgs, {
+      cwd,
+      stdio: "inherit",
+      env: process.env
+    });
+    proc.on("exit", (code) => {
+      resolve(code === 0 ? "" : `
+[mod test] exit ${code}`);
+    });
+    proc.on("error", (e) => resolve(c.red(`[mod test] spawn failed: ${e.message}`)));
+  });
+}
 async function dispatchModuleCommand(sub, args) {
   switch (sub) {
     case "list":
@@ -428,22 +464,23 @@ 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);
+      const { cmdModuleReload } = await import("./module-pack-build.js");
+      return cmdModuleReload(args);
+    }
+    case "watch": {
+      const { cmdModuleWatch } = await import("./module-watch.js");
+      return cmdModuleWatch(args);
     }
-    case "create": {
-      const { runModuleCreateWizard } = await import("./module-wizard.js");
-      return runModuleCreateWizard();
+    case "test": {
+      return cmdModuleTest(args);
     }
-    case "link":
-      return cmdModuleLink(args);
-    case "dev": {
-      const { runModuleDevWizard } = await import("./module-wizard.js");
-      return runModuleDevWizard();
+    case "publish": {
+      const { cmdModulePublish } = await import("./module-publish.js");
+      return cmdModulePublish(args);
     }
     default:
       return c.yellow(moduleUsage());
@@ -459,18 +496,23 @@ function listInstalledModuleIdsSync() {
   }
 }
 export {
+  ALL_MODULE_SUBCOMMANDS,
+  DEV_ACCENT_MODULE_SUBCOMMANDS,
+  DEV_MODULE_SUBCOMMANDS,
   MODULE_CMD_NAMES,
   MODULE_SUBCOMMANDS,
   cmdModuleDisable,
   cmdModuleEnable,
   cmdModuleInfo,
   cmdModuleInstall,
-  cmdModuleLink,
   cmdModuleList,
   cmdModuleSearch,
+  cmdModuleTest,
   cmdModuleUninstall,
   cmdModuleVerify,
   dispatchModuleCommand,
+  getVisibleModuleSubcommands,
+  isDeveloperSubcommand,
   isModuleCommand,
   listInstalledModuleIdsSync,
   moduleUsage,