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

package/dist/module-commands.js

@@ -1,367 +1,480 @@
-/**
- * sfmc module-commands — runtime CLI for inspecting and managing modules
- * already on disk under `modules/packages/<id>/`.
- *
- * 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 `?`.
- *   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).
- *   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
- *
- * The runtime SEA process never connects to the network. `install`/`uninstall`
- * delegate to `tools/fetch-module.mjs` (install syncs catalog + lock).
- * enable/disable go through db-server REST so module-lock.json stays consistent.
- */
+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 } from "node:fs";
+import { existsSync, readdirSync } from "node:fs";
 import path from "node:path";
-import { createHash } from "node:crypto";
 import { spawn } from "node:child_process";
-import { configPath, readJson } from "@sfmc-bds/sdk/node/config";
+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 } from "./runtime.js";
-import { findUnknownModules } from "./registry.js";
-/** Where modules live on disk. SEA reads this same path at runtime. */
+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() {
+  return t("mod.usage", {
+    cmds: MODULE_CMD_NAMES.join("|"),
+    subs: MODULE_SUBCOMMANDS.join("|")
+  });
+}
 function modulesDir() {
-    return path.join(ROOT, "modules", "packages");
+  return path.join(ROOT, "modules", "packages");
 }
 function fmtBytes(n) {
-    if (n < 1024)
-        return `${n} B`;
-    if (n < 1024 * 1024)
-        return `${(n / 1024).toFixed(1)} KB`;
-    return `${(n / 1024 / 1024).toFixed(2)} MB`;
+  if (n < 1024) return `${n} B`;
+  if (n < 1024 * 1024) return `${(n / 1024).toFixed(1)} KB`;
+  return `${(n / 1024 / 1024).toFixed(2)} MB`;
 }
 function shortHash(h) {
-    return h.slice(0, 8) + "…" + h.slice(-8);
+  return h.slice(0, 8) + "\u2026" + h.slice(-8);
 }
-/** Enumerate every installed module by scanning `modules/packages/<id>/`. */
 async function scanInstalled() {
-    const dir = modulesDir();
-    if (!existsSync(dir))
-        return [];
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-    const out = [];
-    for (const e of entries) {
-        if (!e.isDirectory())
-            continue;
-        const id = e.name;
-        const modPath = path.join(dir, id);
-        const manifestPath = path.join(modPath, "sapi", "manifest.json");
-        let manifest = null;
-        if (existsSync(manifestPath)) {
-            try {
-                manifest = JSON.parse(await fs.readFile(manifestPath, "utf8"));
-            }
-            catch {
-                /* corrupt manifest is not fatal — just skip its fields */
-            }
-        }
-        const { totalBytes, fileCount } = await dirSize(modPath);
-        const fingerprint = await dirFingerprint(modPath);
-        out.push({ id, path: modPath, manifest, totalBytes, fileCount, fingerprint });
+  const dir = modulesDir();
+  if (!existsSync(dir)) return [];
+  const entries = await fs.readdir(dir, { withFileTypes: true });
+  const out = [];
+  for (const e of entries) {
+    if (!e.isDirectory()) continue;
+    const id = e.name;
+    const modPath = path.join(dir, id);
+    const manifestPath = path.join(modPath, "sapi", "manifest.json");
+    let manifest = null;
+    if (existsSync(manifestPath)) {
+      try {
+        manifest = JSON.parse(await fs.readFile(manifestPath, "utf8"));
+      } catch {
+      }
     }
-    out.sort((a, b) => a.id.localeCompare(b.id));
-    return out;
-}
-/** Compute the canonical SHA-256 of a module directory (POSIX `find ... | sha256sum` compatible). */
-async function dirFingerprint(rootDir) {
-    const hash = createHash("sha256");
-    const entries = [];
-    async function walk(rel) {
-        const full = path.join(rootDir, rel);
-        const items = await fs.readdir(full, { withFileTypes: true });
-        const sorted = items.sort((a, b) => a.name.localeCompare(b.name));
-        for (const it of sorted) {
-            const child = rel ? `${rel}/${it.name}` : it.name;
-            if (it.isDirectory())
-                await walk(child);
-            else if (it.isFile())
-                entries.push(child);
-        }
-    }
-    await walk("");
-    entries.sort();
-    for (const rel of entries) {
-        const data = await fs.readFile(path.join(rootDir, rel));
-        hash.update(rel.replaceAll("\\", "/"));
-        hash.update("\n");
-        hash.update(data);
-        hash.update("\n");
-    }
-    return hash.digest("hex");
+    const { totalBytes, fileCount } = await dirSize(modPath);
+    const fingerprint = await dirFingerprint(modPath);
+    out.push({ id, path: modPath, manifest, totalBytes, fileCount, fingerprint });
+  }
+  out.sort((a, b) => a.id.localeCompare(b.id));
+  return out;
 }
 async function dirSize(dir) {
-    let totalBytes = 0;
-    let fileCount = 0;
-    async function walk(p) {
-        for (const e of await fs.readdir(p, { withFileTypes: true })) {
-            const child = path.join(p, e.name);
-            if (e.isDirectory())
-                await walk(child);
-            else if (e.isFile()) {
-                const s = await fs.stat(child);
-                totalBytes += s.size;
-                fileCount++;
-            }
-        }
+  let totalBytes = 0;
+  let fileCount = 0;
+  async function walk(p) {
+    for (const e of await fs.readdir(p, { withFileTypes: true })) {
+      const child = path.join(p, e.name);
+      if (e.isDirectory()) await walk(child);
+      else if (e.isFile()) {
+        const s = await fs.stat(child);
+        totalBytes += s.size;
+        fileCount++;
+      }
     }
-    await walk(dir);
-    return { totalBytes, fileCount };
+  }
+  await walk(dir);
+  return { totalBytes, fileCount };
 }
-/* ─────────────────────────────────────────────────────────────────
- *  list
- * ──────────────────────────────────────────────────────────────── */
-export async function cmdModuleList(_args) {
-    const installed = await scanInstalled();
-    if (installed.length === 0) {
-        return c.dim(`\nNo modules installed. Drop a module folder under ${modulesDir()} or run \`sfmc module install <id>\`.\n`);
-    }
-    const ids = installed.map((m) => m.id);
-    const unknown = new Set(await findUnknownModules(ids));
-    const lines = [c.bold("\nInstalled modules"), c.dim(`  ${modulesDir()}`)];
-    const header = `    ${"id".padEnd(28)}${"files".padEnd(8)}${"size".padEnd(10)}${"routes".padEnd(8)}${"fingerprint"}`;
-    lines.push(c.dim(header));
-    for (const m of installed) {
-        const routeCount = m.manifest?.routes?.length ?? 0;
-        let mark;
-        if (!m.manifest) {
-            mark = c.yellow("○");
-        }
-        else if (unknown.has(m.id)) {
-            mark = c.yellow("?");
-        }
-        else {
-            mark = c.green("●");
-        }
-        lines.push(`  ${mark} ${m.id.padEnd(26)}${String(m.fileCount).padEnd(8)}${fmtBytes(m.totalBytes).padEnd(10)}${String(routeCount).padEnd(8)}${shortHash(m.fingerprint)}`);
+async function cmdModuleList(_args) {
+  const installed = await scanInstalled();
+  if (installed.length === 0) {
+    return c.dim(t("mod.noneInstalled", { dir: modulesDir() }));
+  }
+  const lock = readJson(modulePath(path.join(ROOT, "modules"), "module-lock.json")) ?? {
+    version: 1,
+    modules: {}
+  };
+  const ids = installed.map((m) => m.id);
+  const unknown = new Set(await findUnknownModules(ids));
+  const lines = [c.bold(`
+${t("mod.list.title")}`), c.dim(`  ${modulesDir()}`)];
+  const header = `    ${"id".padEnd(24)}${"state".padEnd(8)}${"files".padEnd(8)}${"size".padEnd(10)}${"fingerprint"}`;
+  lines.push(c.dim(header));
+  for (const m of installed) {
+    const logicalId = typeof m.manifest?.id === "string" && m.manifest.id ? m.manifest.id : m.id;
+    const enabled = lock.modules?.[logicalId]?.enabled === true;
+    const stateCol = (enabled ? c.green("on") : c.dim("off")).padEnd(8);
+    let mark;
+    if (!m.manifest) {
+      mark = c.yellow("\u25CB");
+    } else if (unknown.has(m.id)) {
+      mark = c.yellow("?");
+    } else {
+      mark = enabled ? c.green("\u25CF") : c.dim("\u25CB");
     }
-    return lines.join("\n") + "\n";
+    const idLabel = logicalId !== m.id ? `${m.id}(${logicalId})` : m.id;
+    lines.push(
+      `  ${mark} ${idLabel.padEnd(22)}${stateCol}${String(m.fileCount).padEnd(8)}${fmtBytes(m.totalBytes).padEnd(10)}${shortHash(m.fingerprint)}`
+    );
+  }
+  lines.push(c.dim(`
+  tip: ${MODULE_CMD_NAMES[1] ?? "mod"} enable|disable <logicalId>`));
+  return lines.join("\n") + "\n";
 }
-/**
- * Walk `modules/packages/<id>/` and print a one-line yellow warning for each
- * id that isn't in the first-party registry. Intended for the REPL startup
- * hook so users immediately see modules they installed from somewhere else.
- *
- * Best-effort: registry unreachable → no warning (no false positives).
- */
-export async function scanAndWarnUnknown() {
-    const installed = await scanInstalled();
-    if (installed.length === 0)
-        return "";
-    const unknown = await findUnknownModules(installed.map((m) => m.id));
-    if (unknown.length === 0)
-        return "";
-    const list = unknown.map((id) => `  ${c.yellow("?")} ${id}`).join("\n");
-    return `${c.yellow("[sfmc] modules installed from unknown publisher — verify before use:")}\n${list}\n`;
+async function scanAndWarnUnknown() {
+  const installed = await scanInstalled();
+  if (installed.length === 0) return "";
+  const unknown = await findUnknownModules(installed.map((m) => m.id));
+  if (unknown.length === 0) return "";
+  const list = unknown.map((id) => `  ${c.yellow("?")} ${id}`).join("\n");
+  return `${c.yellow("[sfmc] modules installed from unknown publisher \u2014 verify before use:")}
+${list}
+`;
 }
-/* ─────────────────────────────────────────────────────────────────
- *  info
- * ──────────────────────────────────────────────────────────────── */
-export async function cmdModuleInfo(args) {
-    const id = args[0];
-    if (!id)
-        return c.yellow("Usage: sfmc module info <id>");
-    const all = await scanInstalled();
-    const m = all.find((x) => x.id === id);
-    if (!m)
-        return c.red(`Module ${id} not installed at ${path.join(modulesDir(), id)}`);
-    const lines = [c.bold(`\n${id}`)];
-    lines.push(`  path        : ${m.path}`);
-    lines.push(`  files       : ${m.fileCount}`);
-    lines.push(`  size        : ${fmtBytes(m.totalBytes)}`);
-    lines.push(`  fingerprint : ${m.fingerprint}`);
-    if (m.manifest) {
-        lines.push(`  schemaVer   : ${m.manifest.schemaVersion ?? "(none)"}`);
-        lines.push(`  routes      : ${m.manifest.routes?.length ?? 0}`);
-        if (m.manifest.routes?.length) {
-            for (const r of m.manifest.routes)
-                lines.push(c.dim(`    ${r.method.padEnd(7)} ${r.path.padEnd(36)} ${r.handler}`));
-        }
-        lines.push(`  migrations  : ${m.manifest.migrations?.length ?? 0}`);
-        if (m.manifest.migrations?.length) {
-            for (const mg of m.manifest.migrations)
-                lines.push(c.dim(`    v${mg.version} ${mg.name}`));
-        }
-        if (m.manifest.notes)
-            lines.push(`  notes       : ${c.dim(m.manifest.notes)}`);
+async function cmdModuleSearch(args) {
+  const query = args[0];
+  const { index, stale } = await resolveRegistryIndex({ force: true });
+  const ids = Object.keys(index).sort((a, b) => a.localeCompare(b));
+  if (ids.length === 0) {
+    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
+`
+    );
+  }
+  const staleNote = stale ? c.yellow("  (offline \u2014 showing cached index)\n") : "";
+  if (!query) {
+    const installed = new Set(listInstalledModuleIdsSync());
+    const lines2 = [
+      c.bold(`
+First-party registry (${DEFAULT_REGISTRY_REPO}@${DEFAULT_REGISTRY_TAG}) \u2014 ${ids.length} modules`)
+    ];
+    if (staleNote) lines2.push(staleNote.trimEnd());
+    lines2.push(c.dim(`    ${"id".padEnd(28)}${"source".padEnd(40)}local`));
+    for (const id of ids) {
+      const e = index[id];
+      const src = `${e.repo}@${e.tag}`;
+      const local = installed.has(id) ? c.green("\u25CF") : c.dim("\u25CB");
+      lines2.push(`  ${local} ${id.padEnd(26)}${src.padEnd(40)}${installed.has(id) ? "installed" : ""}`);
     }
-    else {
-        lines.push(c.yellow(`  manifest    : (missing or unreadable)`));
-    }
-    return lines.join("\n") + "\n";
+    lines2.push(c.dim(`
+  tip: sfmc mod search <id>  \u2192 registry info`));
+    lines2.push(c.dim(`       sfmc mod install <id> \u2192 download + catalog sync`));
+    return lines2.join("\n") + "\n";
+  }
+  const entry = index[query];
+  if (!entry) {
+    const hints = ids.filter((id) => id.includes(query) || query.includes(id)).slice(0, 8);
+    const hintBlock = hints.length > 0 ? c.dim(`
+  Did you mean:
+`) + hints.map((h) => `    ${h}`).join("\n") : c.dim(`
+  Known ids: ${ids.slice(0, 12).join(", ")}${ids.length > 12 ? ", \u2026" : ""}`);
+    return c.red(t("mod.notInRegistry", { query })) + hintBlock + "\n";
+  }
+  const installedPath = path.join(modulesDir(), query);
+  const isInstalled = existsSync(installedPath);
+  const lines = [c.bold(`
+${query}`)];
+  if (staleNote) lines.push(staleNote.trimEnd());
+  lines.push(`  registry   : ${DEFAULT_REGISTRY_REPO}@${DEFAULT_REGISTRY_TAG}`);
+  lines.push(`  repo       : ${entry.repo}`);
+  lines.push(`  tag        : ${entry.tag}`);
+  lines.push(`  source     : github:${entry.repo}@${entry.tag}`);
+  lines.push(`  github     : https://github.com/${entry.repo}/tree/${entry.tag}`);
+  lines.push(
+    `  local      : ${isInstalled ? c.green(`installed @ ${installedPath}`) : c.dim("not installed")}`
+  );
+  if (!isInstalled) {
+    lines.push(c.dim(`
+  install: sfmc mod install ${query}`));
+  } else {
+    lines.push(c.dim(`
+  details: sfmc mod info ${query}`));
+  }
+  return lines.join("\n") + "\n";
 }
-/* ─────────────────────────────────────────────────────────────────
- *  verify
- * ──────────────────────────────────────────────────────────────── */
-export async function cmdModuleVerify(args) {
-    const id = args[0];
-    if (id) {
-        const all = await scanInstalled();
-        const m = all.find((x) => x.id === id);
-        if (!m)
-            return c.red(`Module ${id} not installed`);
-        return c.green(`${id} ok\n  fingerprint: ${m.fingerprint}\n`);
+async function cmdModuleInfo(args) {
+  const id = args[0];
+  if (!id) return c.yellow(t("mod.info.usage"));
+  const all = await scanInstalled();
+  const m = all.find((x) => x.id === id);
+  if (!m) return c.red(t("mod.notInstalledAt", { id, path: path.join(modulesDir(), id) }));
+  const lines = [c.bold(`
+${id}`)];
+  lines.push(`  path        : ${m.path}`);
+  lines.push(`  files       : ${m.fileCount}`);
+  lines.push(`  size        : ${fmtBytes(m.totalBytes)}`);
+  lines.push(`  fingerprint : ${m.fingerprint}`);
+  if (m.manifest) {
+    lines.push(`  schemaVer   : ${m.manifest.schemaVersion ?? "(none)"}`);
+    lines.push(`  routes      : ${m.manifest.routes?.length ?? 0}`);
+    if (m.manifest.routes?.length) {
+      for (const r of m.manifest.routes) lines.push(c.dim(`    ${r.method.padEnd(7)} ${r.path.padEnd(36)} ${r.handler}`));
     }
-    const all = await scanInstalled();
-    const lines = [c.bold("\nVerifying installed modules")];
-    for (const m of all) {
-        lines.push(`  ${m.id.padEnd(28)} ${shortHash(m.fingerprint)}`);
+    lines.push(`  migrations  : ${m.manifest.migrations?.length ?? 0}`);
+    if (m.manifest.migrations?.length) {
+      for (const mg of m.manifest.migrations) lines.push(c.dim(`    v${mg.version} ${mg.name}`));
     }
-    if (all.length === 0)
-        lines.push(c.dim("  (none)"));
-    return lines.join("\n") + "\n";
+    if (m.manifest.notes) lines.push(`  notes       : ${c.dim(m.manifest.notes)}`);
+  } else {
+    lines.push(c.yellow(`  manifest    : (missing or unreadable)`));
+  }
+  return lines.join("\n") + "\n";
+}
+async function cmdModuleVerify(args) {
+  const id = args[0];
+  if (id) {
+    const all2 = await scanInstalled();
+    const m = all2.find((x) => x.id === id);
+    if (!m) return c.red(t("mod.notInstalled", { id }));
+    return c.green(t("mod.verifyOk", { id, fp: m.fingerprint }));
+  }
+  const all = await scanInstalled();
+  const lines = [c.bold("\nVerifying installed modules")];
+  for (const m of all) {
+    lines.push(`  ${m.id.padEnd(28)} ${shortHash(m.fingerprint)}`);
+  }
+  if (all.length === 0) lines.push(c.dim("  (none)"));
+  return lines.join("\n") + "\n";
 }
-/* ─────────────────────────────────────────────────────────────────
- *  install  — shells out to tools/fetch-module.mjs
- * ──────────────────────────────────────────────────────────────── */
-/* ───────────────────────────────────────────────────────────────
- *  enable / disable  — talk to db-server over loopback HTTP
- * ─────────────────────────────────────────────────────────────── */
 function readDbConfig() {
-    return (readJson(configPath(ROOT, "db_config.json")) ?? {});
+  return readJson(configPath(ROOT, "db_config.json")) ?? {};
 }
 async function postModuleToggle(id, 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}`;
-    let res;
-    try {
-        res = await fetch(url, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                ...(token ? { Authorization: `Bearer ${token}` } : {}),
-            },
-        });
-    }
-    catch (err) {
-        return c.red(`Cannot reach db-server at ${url}: ${err.message}. Is db-service running? (sfmc> start db)`);
-    }
-    const text = await res.text();
-    let body;
-    try {
-        body = JSON.parse(text);
-    }
-    catch {
-        body = text;
-    }
-    if (!res.ok) {
-        const err = body?.error ?? `HTTP ${res.status}`;
-        return c.red(`${action} ${id} failed: ${err}`);
-    }
-    const ok = body?.success !== false;
-    return ok ? c.green(`${action}d ${id}`) : c.red(`${action} ${id} returned: ${text}`);
+  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}`;
+  let res;
+  try {
+    res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...token ? { Authorization: `Bearer ${token}` } : {}
+      }
+    });
+  } catch (err) {
+    return failResult(
+      c.red(t("mod.dbUnreachable", { url, message: err.message }))
+    );
+  }
+  const text = await res.text();
+  let body;
+  try {
+    body = JSON.parse(text);
+  } catch {
+    body = text;
+  }
+  if (!res.ok) {
+    const err = body?.error ?? `HTTP ${res.status}`;
+    return failResult(c.red(t("mod.toggleFailed", { action, id, err })));
+  }
+  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 })));
+  }
+  return failResult(c.red(t("mod.toggleBadBody", { action, id, text })));
 }
-export async function cmdModuleEnable(args) {
-    const id = args[0];
-    if (!id)
-        return c.yellow("Usage: sfmc module enable <id>");
-    return postModuleToggle(id, "enable");
+async function cmdModuleEnable(args) {
+  const id = args[0];
+  if (!id) return failResult(c.yellow(t("mod.enable.usage")));
+  return postModuleToggle(id, "enable");
 }
-export async function cmdModuleDisable(args) {
-    const id = args[0];
-    if (!id)
-        return c.yellow("Usage: sfmc module disable <id>");
-    return postModuleToggle(id, "disable");
+async function cmdModuleDisable(args) {
+  const id = args[0];
+  if (!id) return failResult(c.yellow(t("mod.disable.usage")));
+  return postModuleToggle(id, "disable");
 }
-/* ───────────────────────────────────────────────────────────────
- *  install  — shells out to tools/fetch-module.mjs
- * ─────────────────────────────────────────────────────────────── */
-export async function cmdModuleInstall(args) {
-    // 支持: install <id> [id2 ...] [--from ...]
-    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]);
+async function cmdModuleInstall(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 (positional.length === 0)
-        return c.yellow("Usage: sfmc module install <id> [id2 ...] [--from <source>]");
-    const fetchScript = path.join(ROOT, "tools", "fetch-module.mjs");
-    if (!existsSync(fetchScript)) {
-        return c.red(`tools/fetch-module.mjs not found at ${fetchScript}`);
+    if (args[i]?.startsWith("--from=") || args[i]?.startsWith("--sha256=")) continue;
+    if (args[i]?.startsWith("--")) continue;
+    positional.push(args[i]);
+  }
+  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"));
     }
-    const sub = ["install", ...positional];
-    if (flags.from)
-        sub.push("--from", flags.from);
-    if (flags.sha256)
-        sub.push("--sha256", flags.sha256);
-    return new Promise((resolve) => {
-        const proc = spawn(process.execPath, [fetchScript, ...sub], { stdio: ["ignore", "pipe", "pipe"] });
-        let out = "";
-        proc.stdout?.on("data", (d) => {
-            out += d.toString();
-        });
-        proc.stderr?.on("data", (d) => {
-            out += d.toString();
-        });
-        proc.on("exit", (code) => {
-            resolve(out + (code === 0 ? "" : `\n[exit ${code}]`));
-        });
-        proc.on("error", (e) => resolve(c.red(`spawn failed: ${e.message}`)));
+    flags.from = positional.length === 1 ? `dir:${packageDirForId(modulesRoot, positional[0])}` : `dir:${path.join(modulesRoot, "packages")}`;
+  }
+  const fetchScript = resolveFetchModule();
+  if (!fetchScript) {
+    return c.red(t("mod.fetchMissing"));
+  }
+  const sub = ["install", ...positional];
+  if (flags.from) sub.push("--from", flags.from);
+  if (flags.sha256) sub.push("--sha256", flags.sha256);
+  if (flags.link) sub.push("--link");
+  return new Promise((resolve) => {
+    const proc = spawn(process.execPath, [fetchScript, ...sub], {
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, SFMC_ROOT: ROOT }
+    });
+    let out = "";
+    proc.stdout?.on("data", (d) => {
+      out += d.toString();
+    });
+    proc.stderr?.on("data", (d) => {
+      out += d.toString();
+    });
+    proc.on("exit", (code) => {
+      resolve(out + (code === 0 ? "" : `
+[exit ${code}]`));
     });
+    proc.on("error", (e) => resolve(c.red(`spawn failed: ${e.message}`)));
+  });
 }
-/* ─────────────────────────────────────────────────────────────────
- *  uninstall
- * ──────────────────────────────────────────────────────────────── */
-export async function cmdModuleUninstall(args) {
-    const id = args[0];
-    if (!id)
-        return c.yellow("Usage: sfmc module uninstall <id>");
-    const fetchScript = path.join(ROOT, "tools", "fetch-module.mjs");
-    if (!existsSync(fetchScript)) {
-        // 回退:仅删目录(旧行为)
-        const target = path.join(modulesDir(), id);
-        if (!existsSync(target))
-            return c.yellow(`Module ${id} not installed (no folder at ${target})`);
-        await fs.rm(target, { recursive: true, force: true });
-        return c.green(`Removed ${id} from ${target}\n`);
+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;
     }
-    return new Promise((resolve) => {
-        const proc = spawn(process.execPath, [fetchScript, "uninstall", id], {
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        let out = "";
-        proc.stdout?.on("data", (d) => {
-            out += d.toString();
-        });
-        proc.stderr?.on("data", (d) => {
-            out += d.toString();
-        });
-        proc.on("exit", (code) => {
-            resolve(out + (code === 0 ? "" : `\n[exit ${code}]`));
-        });
-        proc.on("error", (e) => resolve(c.red(`spawn failed: ${e.message}`)));
+    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"));
+  const fetchScript = resolveFetchModule();
+  if (!fetchScript) {
+    const target = path.join(modulesDir(), id);
+    if (!existsSync(target)) return c.yellow(t("mod.notInstalledFolder", { id, path: target }));
+    await fs.rm(target, { recursive: true, force: true });
+    return c.green(t("mod.removed", { id, path: target }));
+  }
+  return new Promise((resolve) => {
+    const proc = spawn(process.execPath, [fetchScript, "uninstall", id], {
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, SFMC_ROOT: ROOT }
+    });
+    let out = "";
+    proc.stdout?.on("data", (d) => {
+      out += d.toString();
+    });
+    proc.stderr?.on("data", (d) => {
+      out += d.toString();
     });
+    proc.on("exit", (code) => {
+      resolve(out + (code === 0 ? "" : `
+[exit ${code}]`));
+    });
+    proc.on("error", (e) => resolve(c.red(`spawn failed: ${e.message}`)));
+  });
 }
 function parseFlags(args) {
-    const flags = { from: null, sha256: null };
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === "--from")
-            flags.from = args[++i] ?? null;
-        else if (args[i]?.startsWith("--from="))
-            flags.from = args[i].slice("--from=".length);
-        else if (args[i] === "--sha256")
-            flags.sha256 = args[++i] ?? null;
+  const flags = { from: null, sha256: null, link: false };
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--from") flags.from = args[++i] ?? null;
+    else if (args[i]?.startsWith("--from=")) flags.from = args[i].slice("--from=".length);
+    else if (args[i] === "--sha256") flags.sha256 = args[++i] ?? null;
+    else if (args[i]?.startsWith("--sha256=")) flags.sha256 = args[i].slice("--sha256=".length);
+    else if (args[i] === "--link") flags.link = true;
+  }
+  return flags;
+}
+async function dispatchModuleCommand(sub, args) {
+  switch (sub) {
+    case "list":
+      return cmdModuleList(args);
+    case "search":
+      return cmdModuleSearch(args);
+    case "install":
+      return cmdModuleInstall(args);
+    case "uninstall":
+    case "remove":
+      return cmdModuleUninstall(args);
+    case "verify":
+      return cmdModuleVerify(args);
+    case "info":
+      return cmdModuleInfo(args);
+    case "enable":
+      return (await cmdModuleEnable(args)).message;
+    case "disable":
+      return (await cmdModuleDisable(args)).message;
+    case "build": {
+      const { cmdPackBuild } = await import("./pack-lifecycle.js");
+      return (await cmdPackBuild(args)).message;
+    }
+    case "reload": {
+      const { cmdReload } = await import("./commands-reload.js");
+      return cmdReload(args);
     }
-    return flags;
+    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();
+    }
+    default:
+      return c.yellow(moduleUsage());
+  }
+}
+function listInstalledModuleIdsSync() {
+  const dir = modulesDir();
+  if (!existsSync(dir)) return [];
+  try {
+    return readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort((a, b) => a.localeCompare(b));
+  } catch {
+    return [];
+  }
 }
-//# sourceMappingURL=module-commands.js.map
+export {
+  MODULE_CMD_NAMES,
+  MODULE_SUBCOMMANDS,
+  cmdModuleDisable,
+  cmdModuleEnable,
+  cmdModuleInfo,
+  cmdModuleInstall,
+  cmdModuleLink,
+  cmdModuleList,
+  cmdModuleSearch,
+  cmdModuleUninstall,
+  cmdModuleVerify,
+  dispatchModuleCommand,
+  isModuleCommand,
+  listInstalledModuleIdsSync,
+  moduleUsage,
+  paintModuleCmdAlias,
+  scanAndWarnUnknown
+};
+//# sourceMappingURL=module-commands.js.map