@sfmc-bds/devkit 0.1.0-beta.1 → 0.1.0-beta.2

package/README.md

@@ -5,3 +5,10 @@
 ```ts
 import { startModuleWatch, rebuildAndDeploy, scaffoldModule } from "@sfmc-bds/devkit";
 ```
+
+脚手架 CLI：
+
+```bash
+npx sfmc-new-module my-mod --name "我的模块"
+# 或：node node_modules/@sfmc-bds/devkit/scripts/new-module.mjs …
+```

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/paths.ts", "../src/module-root.ts", "../src/sfmc-root.ts", "../src/sfmc-cli.ts", "../src/watch.ts", "../src/scaffold.ts", "../src/rebuild.ts", "../src/module-toggle.ts"],
-  "sourcesContent": ["import path from \"node:path\";\n\n/** \u89E3\u6790 `--from local[:path]` / `dir:` \u6216 cwd \u4E3A\u6A21\u5757\u6839\u3002 */\nexport function resolveLocalModuleRoot(args: { from?: string | null; cwd: string }): string {\n  const raw = (args.from ?? \"\").trim();\n  if (!raw) return path.resolve(args.cwd);\n  if (raw === \"local\") return path.resolve(args.cwd);\n  if (raw.startsWith(\"local:\")) {\n    const p = raw.slice(\"local:\".length).trim();\n    if (!p) return path.resolve(args.cwd);\n    return path.isAbsolute(p) ? path.resolve(p) : path.resolve(args.cwd, p);\n  }\n  if (raw.startsWith(\"dir:\")) {\n    const p = raw.slice(\"dir:\".length).trim();\n    return path.isAbsolute(p) ? path.resolve(p) : path.resolve(args.cwd, p);\n  }\n  return path.resolve(args.cwd);\n}\n", "/**\n * \u6709\u6548\u6A21\u5757\u6839\u5224\u5B9A\uFF08\u6269\u5C55\u4E0E CLI \u5171\u7528\u6743\u5A01\uFF09\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nexport type ModuleRootInfo = {\n  root: string;\n  id: string;\n  name?: string;\n  schemaVersion: number;\n};\n\n/** \u76EE\u5F55\u662F\u5426\u4E3A\u6709\u6548 SFMC \u6A21\u5757\u6839\uFF1Apackage.json + sapi/manifest.json schemaVersion===2 + \u975E\u7A7A id */\nexport function isValidModuleRoot(dir: string): boolean {\n  return readModuleRootInfo(dir) !== null;\n}\n\nexport function readModuleRootInfo(dir: string): ModuleRootInfo | null {\n  const pkg = path.join(dir, \"package.json\");\n  const manifestPath = path.join(dir, \"sapi\", \"manifest.json\");\n  if (!fs.existsSync(pkg) || !fs.existsSync(manifestPath)) return null;\n  try {\n    const m = JSON.parse(fs.readFileSync(manifestPath, \"utf8\")) as {\n      schemaVersion?: number;\n      id?: string;\n      name?: string;\n    };\n    if (m.schemaVersion !== 2) return null;\n    if (typeof m.id !== \"string\" || !m.id.trim()) return null;\n    return {\n      root: path.resolve(dir),\n      id: m.id.trim(),\n      name: typeof m.name === \"string\" ? m.name : undefined,\n      schemaVersion: 2,\n    };\n  } catch {\n    return null;\n  }\n}\n\n/** \u81EA filePath \u5411\u4E0A\u627E\u6700\u8FD1\u6709\u6548\u6A21\u5757\u6839\uFF1B\u627E\u4E0D\u5230\u8FD4\u56DE null */\nexport function findModuleRootFromFile(filePath: string): string | null {\n  let cur = path.dirname(path.resolve(filePath));\n  const root = path.parse(cur).root;\n  while (true) {\n    if (isValidModuleRoot(cur)) return cur;\n    if (cur === root) return null;\n    const parent = path.dirname(cur);\n    if (parent === cur) return null;\n    cur = parent;\n  }\n}\n", "/**\n * SFMC \u5DE5\u4F5C\u76EE\u5F55\u5224\u5B9A\uFF08\u8FD0\u884C\u65F6\u6839\uFF1Aconfigs/\u3001modules/\uFF1B\u4E0D\u662F\u6E90\u7801\u4ED3\u5E93\u6839\uFF09\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\n/** \u76EE\u5F55\u662F\u5426\u4E3A\u6709\u6548 SFMC \u5DE5\u4F5C\u76EE\u5F55\uFF08\u542B configs/ \u4E0E modules/\uFF09\u3002 */\nexport function isValidSfmcRoot(dir: string): boolean {\n  if (!dir || !dir.trim()) return false;\n  const root = path.resolve(dir);\n  try {\n    return (\n      fs.statSync(path.join(root, \"configs\")).isDirectory() &&\n      fs.statSync(path.join(root, \"modules\")).isDirectory()\n    );\n  } catch {\n    return false;\n  }\n}\n", "/**\n * \u89E3\u6790\u5E76 spawn sfmc CLI\u3002\n * CLI \u4E0E SFMC \u5DE5\u4F5C\u76EE\u5F55\u65E0\u5173\uFF1A\u4ECE\u672C\u5305/\u6269\u5C55\u5B89\u88C5\u6811\u3001PATH \u6216\u663E\u5F0F\u914D\u7F6E\u89E3\u6790\uFF1B\n * \u5DE5\u4F5C\u76EE\u5F55\u53EA\u4F5C\u4E3A spawn \u7684 cwd \u4E0E SFMC_ROOT\u3002\n */\n\nimport { spawn } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { isValidSfmcRoot } from \"./sfmc-root.js\";\n\n/** chalk.hex(\"#e06c75\") \u7684\u771F\u5F69\u5E8F\u5217\uFF1BCLI \u5931\u8D25\u6587\u6848\u7ECF c.red() \u5305\u88C5\u3002 */\nconst CLI_ANSI_RED = \"\\u001b[38;2;224;108;117m\";\n\nexport interface ResolveSfmcCliOptions {\n  /** \u663E\u5F0F CLI \u5165\u53E3\uFF08.js/.mjs\uFF09\uFF1B\u4E5F\u53EF\u7528\u73AF\u5883\u53D8\u91CF SFMC_CLI\u3002 */\n  cliPath?: string;\n}\n\nfunction tryRequireCli(from: string): string | null {\n  try {\n    const resolved = createRequire(from).resolve(\"@sfmc-bds/cli/cli\");\n    return fs.existsSync(resolved) ? resolved : null;\n  } catch {\n    return null;\n  }\n}\n\n/** \u81EA PATH \u4E0A\u7684 sfmc \u53EF\u6267\u884C\u6587\u4EF6\u65C1\u89E3\u6790 @sfmc-bds/cli\uFF08npm global / \u672C\u5730 .bin\uFF09\u3002 */\nfunction resolveCliFromPathEnv(): string | null {\n  const pathEnv = process.env.PATH ?? \"\";\n  const names =\n    process.platform === \"win32\" ? [\"sfmc.cmd\", \"sfmc.exe\", \"sfmc.ps1\", \"sfmc\"] : [\"sfmc\"];\n  for (const dir of pathEnv.split(path.delimiter)) {\n    if (!dir) continue;\n    let hit = false;\n    for (const name of names) {\n      if (fs.existsSync(path.join(dir, name))) {\n        hit = true;\n        break;\n      }\n    }\n    if (!hit) continue;\n    const nearCli = path.join(dir, \"..\", \"@sfmc-bds\", \"cli\", \"dist\", \"main.js\");\n    if (fs.existsSync(nearCli)) return nearCli;\n    const nearMeta = path.join(dir, \"..\", \"@sfmc-bds\", \"sfmc\", \"bin\", \"sfmc.mjs\");\n    if (fs.existsSync(nearMeta)) return nearMeta;\n    const fromBin = tryRequireCli(path.join(dir, \"..\", \"package.json\"));\n    if (fromBin) return fromBin;\n  }\n  return null;\n}\n\n/**\n * \u89E3\u6790 sfmc CLI \u811A\u672C\u8DEF\u5F84\u3002\n * \u987A\u5E8F\uFF1A\u663E\u5F0F cliPath / SFMC_CLI \u2192 \u672C\u5305\u5B89\u88C5\u6811\uFF08@sfmc-bds/cli\uFF09\u2192 cwd \u7684 node_modules \u2192 PATH\u3002\n */\nexport function resolveSfmcCli(opts: ResolveSfmcCliOptions = {}): string {\n  const explicit = (opts.cliPath || process.env.SFMC_CLI || \"\").trim();\n  if (explicit) {\n    const p = path.resolve(explicit);\n    if (!fs.existsSync(p)) {\n      throw new Error(`\u6307\u5B9A\u7684 sfmc CLI \u4E0D\u5B58\u5728\uFF1A${p}\uFF08\u68C0\u67E5 SFMC_CLI / sfmc.cliPath\uFF09`);\n    }\n    return p;\n  }\n\n  const here = fileURLToPath(import.meta.url);\n  const fromInstall = tryRequireCli(here);\n  if (fromInstall) return fromInstall;\n\n  const fromCwd = tryRequireCli(path.join(process.cwd(), \"package.json\"));\n  if (fromCwd) return fromCwd;\n\n  const fromPath = resolveCliFromPathEnv();\n  if (fromPath) return fromPath;\n\n  throw new Error(\n    \"\u65E0\u6CD5\u89E3\u6790 sfmc CLI\u3002\u8BF7\u5B89\u88C5 @sfmc-bds/cli\uFF08\u6216\u786E\u4FDD PATH \u4E0A\u6709 sfmc\uFF09\uFF0C\u6216\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF SFMC_CLI / \u6269\u5C55\u914D\u7F6E sfmc.cliPath\u3002\"\n  );\n}\n\nfunction looksLikeCliFailure(output: string): boolean {\n  if (output.includes(CLI_ANSI_RED)) return true;\n  if (/\\[pack-manager\\].*required/.test(output)) return true;\n  if (/^Error:/m.test(output)) return true;\n  return false;\n}\n\nexport interface RunSfmcCliResult {\n  ok: boolean;\n  output: string;\n}\n\nexport interface RunSfmcCliOptions {\n  cliPath?: string;\n}\n\n/** \u5728 SFMC \u5DE5\u4F5C\u76EE\u5F55\u4E0B\u6267\u884C `node <sfmc-cli> ...args`\uFF08env.SFMC_ROOT = \u5DE5\u4F5C\u76EE\u5F55\uFF09\u3002 */\nexport async function runSfmcCli(\n  sfmcRoot: string,\n  args: string[],\n  opts: RunSfmcCliOptions = {}\n): Promise<RunSfmcCliResult> {\n  const root = path.resolve(sfmcRoot);\n  if (!isValidSfmcRoot(root)) {\n    return {\n      ok: false,\n      output: `\u65E0\u6548\u7684 SFMC \u5DE5\u4F5C\u76EE\u5F55\uFF1A${root}\uFF08\u9700\u8981\u542B configs/ \u4E0E modules/\uFF0C\u4E0D\u5FC5\u542B\u6E90\u7801\u4ED3\u5E93\uFF09`,\n    };\n  }\n\n  let script: string;\n  try {\n    script = resolveSfmcCli({ cliPath: opts.cliPath });\n  } catch (e) {\n    return { ok: false, output: e instanceof Error ? e.message : String(e) };\n  }\n\n  const r = await new Promise<{ code: number | null; output: string }>((resolve) => {\n    const proc = spawn(process.execPath, [script, ...args], {\n      cwd: root,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      env: { ...process.env, SFMC_ROOT: root },\n    });\n    let out = \"\";\n    proc.stdout?.on(\"data\", (d) => {\n      out += d.toString();\n    });\n    proc.stderr?.on(\"data\", (d) => {\n      out += d.toString();\n    });\n    proc.on(\"exit\", (code) => resolve({ code, output: out }));\n    proc.on(\"error\", (e) => resolve({ code: 1, output: e.message }));\n  });\n\n  const ok = r.code === 0 && !looksLikeCliFailure(r.output);\n  return { ok, output: r.output };\n}\n", "/**\n * \u76D1\u542C\u6A21\u5757 sapi/src\uFF0C\u9632\u6296\u540E\u56DE\u8C03 onRebuild\uFF08\u7531\u8C03\u7528\u65B9\u6CE8\u5165 rebuildAndDeploy / \u5176\u5B83\uFF09\u3002\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nexport interface ModuleWatchOptions {\n  moduleRoot: string;\n  debounceMs?: number;\n  log?: (line: string) => void;\n  onRebuild: () => Promise<{ ok: boolean; message?: string }>;\n}\n\nexport function startModuleWatch(opts: ModuleWatchOptions): { stop: () => void } {\n  const log = opts.log ?? ((line: string) => console.log(line));\n  const debounceMs = opts.debounceMs ?? 200;\n  const sapiDir = path.join(opts.moduleRoot, \"sapi\");\n  const srcDir = path.join(sapiDir, \"src\");\n\n  if (!fs.existsSync(sapiDir)) {\n    log(`[devkit:watch] \u65E0 sapi \u76EE\u5F55: ${sapiDir}`);\n    return { stop: () => {} };\n  }\n\n  let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  let pending = new Set<string>();\n  let running = false;\n  let stopped = false;\n\n  log(`[devkit:watch] \u76D1\u542C ${opts.moduleRoot}`);\n\n  const runOnce = async () => {\n    if (running || stopped) return;\n    running = true;\n    const changed = [...pending];\n    pending = new Set();\n    const t0 = Date.now();\n    log(`[devkit:watch] rebuild (${changed.length})\u2026`);\n    try {\n      const r = await opts.onRebuild();\n      const ms = Date.now() - t0;\n      if (r.ok) log(`[devkit:watch] ok ${ms}ms`);\n      else log(`[devkit:watch] fail ${ms}ms ${r.message ?? \"\"}`);\n    } catch (e) {\n      log(`[devkit:watch] error ${(e as Error).message}`);\n    } finally {\n      running = false;\n    }\n  };\n\n  const onSrc = (rel: string) => {\n    if (stopped) return;\n    if (rel.includes(\"node_modules\") || rel.includes(\"dist\") || rel.endsWith(\".tgz\")) return;\n    pending.add(rel);\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = setTimeout(() => void runOnce(), debounceMs);\n  };\n\n  const watchers: fs.FSWatcher[] = [];\n  if (fs.existsSync(srcDir)) {\n    try {\n      watchers.push(\n        fs.watch(srcDir, { recursive: true, persistent: true }, (_e, filename) => {\n          if (filename) onSrc(filename.toString());\n        })\n      );\n    } catch {\n      watchers.push(\n        fs.watch(srcDir, { persistent: true }, (_e, filename) => {\n          if (filename) onSrc(filename.toString());\n        })\n      );\n    }\n  }\n\n  const watchMeta = (file: string, kind: string) => {\n    if (!fs.existsSync(file)) return;\n    watchers.push(\n      fs.watch(file, { persistent: true }, (event) => {\n        if (event === \"change\") log(`[devkit:watch] ${kind} \u5DF2\u6539\uFF0C\u9700\u91CD\u542F BDS\uFF08SAPI \u542F\u52A8\u671F\u7F13\u5B58\uFF09`);\n      })\n    );\n  };\n  watchMeta(path.join(sapiDir, \"manifest.json\"), \"manifest\");\n  watchMeta(path.join(sapiDir, \"tsconfig.json\"), \"tsconfig\");\n\n  return {\n    stop() {\n      stopped = true;\n      if (debounceTimer) clearTimeout(debounceTimer);\n      for (const w of watchers) {\n        try {\n          w.close();\n        } catch {\n          /* ignore */\n        }\n      }\n      log(\"[devkit:watch] stopped\");\n    },\n  };\n}\n", "/**\n * \u811A\u624B\u67B6\uFF1A\u59D4\u6258 @sfmc-bds/tools/new-module\uFF08\u6216 monorepo packages/tools/new-module.mjs\uFF09\u3002\n */\n\nimport { spawn } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findMonorepoRoot } from \"@sfmc-bds/sdk/node/config\";\n\nexport interface ScaffoldOptions {\n  /** \u76EE\u6807\u76EE\u5F55\uFF08\u987B\u4E3A\u7A7A\u6216\u53EF\u521B\u5EFA\uFF09\u3002 */\n  targetDir: string;\n  moduleId: string;\n  displayName?: string;\n  official?: boolean;\n}\n\nfunction resolveNewModuleScript(): string {\n  const require = createRequire(import.meta.url);\n  try {\n    return require.resolve(\"@sfmc-bds/tools/new-module.mjs\");\n  } catch {\n    /* monorepo \u56DE\u9000 */\n  }\n  const monoRoot = findMonorepoRoot(process.cwd());\n  const mono = monoRoot\n    ? path.join(monoRoot, \"packages\", \"tools\", \"new-module.mjs\")\n    : path.resolve(process.cwd(), \"packages/tools/new-module.mjs\");\n  if (fs.existsSync(mono)) return mono;\n  throw new Error(\"\u65E0\u6CD5\u89E3\u6790 new-module.mjs\uFF08\u5B89\u88C5 @sfmc-bds/tools \u6216\u5728 monorepo \u6839\u8FD0\u884C\uFF09\");\n}\n\nexport async function scaffoldModule(opts: ScaffoldOptions): Promise<{ ok: boolean; message: string }> {\n  const dir = path.resolve(opts.targetDir);\n  fs.mkdirSync(dir, { recursive: true });\n  const script = resolveNewModuleScript();\n  const args = [script, opts.moduleId];\n  if (opts.displayName) args.push(\"--name\", opts.displayName);\n  if (opts.official) args.push(\"--official\");\n\n  return new Promise((resolve) => {\n    const proc = spawn(process.execPath, args, {\n      cwd: dir,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      env: process.env,\n    });\n    let out = \"\";\n    proc.stdout?.on(\"data\", (d) => {\n      out += d.toString();\n    });\n    proc.stderr?.on(\"data\", (d) => {\n      out += d.toString();\n    });\n    proc.on(\"exit\", (code) => {\n      resolve({\n        ok: code === 0,\n        message: out.trim() || (code === 0 ? `scaffolded ${opts.moduleId}` : `exit ${code}`),\n      });\n    });\n    proc.on(\"error\", (e) => resolve({ ok: false, message: e.message }));\n  });\n}\n", "/**\n * \u7EC4\u88C5\u5E76\u90E8\u7F72\u884C\u4E3A\u5305\uFF1A\u5728 SFMC_ROOT \u4E0B spawn `sfmc mod reload`\n * \uFF08\u4E0E CLI \u540C\u4E00\u5165\u53E3\uFF0C\u5B8C\u6574\u4F20\u53C2\uFF1B\u52FF\u76F4\u63A5\u88F8\u8C03 pack-manager verb\uFF09\u3002\n */\n\nimport { runSfmcCli } from \"./sfmc-cli.js\";\n\nexport interface RebuildOptions {\n  /** SFMC \u5DE5\u4F5C\u76EE\u5F55\uFF08\u542B configs/\u3001modules/\uFF09\u3002 */\n  sfmcRoot: string;\n  /** \u4EC5\u6784\u5EFA\u90E8\u7F72\uFF0C\u4E0D\u5411 BDS \u53D1 reload\uFF08\u5BF9\u5E94 `mod reload --build-only`\uFF09\u3002 */\n  buildOnly?: boolean;\n  /** \u53EF\u9009\uFF1A\u663E\u5F0F sfmc CLI \u5165\u53E3\uFF1B\u9ED8\u8BA4\u7531\u5B89\u88C5\u6811 / PATH / SFMC_CLI \u89E3\u6790\u3002 */\n  cliPath?: string;\n}\n\nexport interface RebuildResult {\n  ok: boolean;\n  output: string;\n}\n\nexport async function rebuildAndDeploy(opts: RebuildOptions): Promise<RebuildResult> {\n  const args = [\"mod\", \"reload\"];\n  if (opts.buildOnly) args.push(\"--build-only\");\n  return runSfmcCli(opts.sfmcRoot, args, { cliPath: opts.cliPath });\n}\n", "/**\n * \u6A21\u5757\u542F\u505C\uFF1Aspawn `sfmc mod enable|disable`\uFF08\u5199 module-lock + best-effort \u70ED\u540C\u6B65\uFF09\u3002\n */\n\nimport { runSfmcCli, type RunSfmcCliResult } from \"./sfmc-cli.js\";\n\nexport interface SetModuleEnabledOptions {\n  /** SFMC \u5DE5\u4F5C\u76EE\u5F55\uFF08\u542B modules/module-lock.json\uFF09\u3002 */\n  sfmcRoot: string;\n  /** \u6A21\u5757 logicalId / folderId / configKey\uFF08\u4E0E CLI `mod enable` \u4E00\u81F4\uFF09\u3002 */\n  moduleId: string;\n  enabled: boolean;\n  /** \u53EF\u9009\uFF1A\u663E\u5F0F sfmc CLI \u5165\u53E3\uFF1B\u9ED8\u8BA4\u7531\u5B89\u88C5\u6811 / PATH / SFMC_CLI \u89E3\u6790\u3002 */\n  cliPath?: string;\n}\n\nexport type SetModuleEnabledResult = RunSfmcCliResult;\n\n/** \u542F\u7528\u6216\u5173\u95ED\u6A21\u5757\uFF08\u4E0E CLI `mod enable|disable` \u540C\u6E90\uFF09\u3002 */\nexport async function setModuleEnabled(opts: SetModuleEnabledOptions): Promise<SetModuleEnabledResult> {\n  const id = String(opts.moduleId || \"\").trim();\n  if (!id) {\n    return { ok: false, output: \"moduleId \u4E3A\u7A7A\" };\n  }\n  const action = opts.enabled ? \"enable\" : \"disable\";\n  return runSfmcCli(opts.sfmcRoot, [\"mod\", action, id], { cliPath: opts.cliPath });\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import path from \"node:path\";\n\n/** \u89E3\u6790 `--from local[:path]` / `dir:` \u6216 cwd \u4E3A\u6A21\u5757\u6839\u3002 */\nexport function resolveLocalModuleRoot(args: { from?: string | null; cwd: string }): string {\n  const raw = (args.from ?? \"\").trim();\n  if (!raw) return path.resolve(args.cwd);\n  if (raw === \"local\") return path.resolve(args.cwd);\n  if (raw.startsWith(\"local:\")) {\n    const p = raw.slice(\"local:\".length).trim();\n    if (!p) return path.resolve(args.cwd);\n    return path.isAbsolute(p) ? path.resolve(p) : path.resolve(args.cwd, p);\n  }\n  if (raw.startsWith(\"dir:\")) {\n    const p = raw.slice(\"dir:\".length).trim();\n    return path.isAbsolute(p) ? path.resolve(p) : path.resolve(args.cwd, p);\n  }\n  return path.resolve(args.cwd);\n}\n", "/**\n * \u6709\u6548\u6A21\u5757\u6839\u5224\u5B9A\uFF08\u6269\u5C55\u4E0E CLI \u5171\u7528\u6743\u5A01\uFF09\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nexport type ModuleRootInfo = {\n  root: string;\n  id: string;\n  name?: string;\n  schemaVersion: number;\n};\n\n/** \u76EE\u5F55\u662F\u5426\u4E3A\u6709\u6548 SFMC \u6A21\u5757\u6839\uFF1Apackage.json + sapi/manifest.json schemaVersion===2 + \u975E\u7A7A id */\nexport function isValidModuleRoot(dir: string): boolean {\n  return readModuleRootInfo(dir) !== null;\n}\n\nexport function readModuleRootInfo(dir: string): ModuleRootInfo | null {\n  const pkg = path.join(dir, \"package.json\");\n  const manifestPath = path.join(dir, \"sapi\", \"manifest.json\");\n  if (!fs.existsSync(pkg) || !fs.existsSync(manifestPath)) return null;\n  try {\n    const m = JSON.parse(fs.readFileSync(manifestPath, \"utf8\")) as {\n      schemaVersion?: number;\n      id?: string;\n      name?: string;\n    };\n    if (m.schemaVersion !== 2) return null;\n    if (typeof m.id !== \"string\" || !m.id.trim()) return null;\n    return {\n      root: path.resolve(dir),\n      id: m.id.trim(),\n      name: typeof m.name === \"string\" ? m.name : undefined,\n      schemaVersion: 2,\n    };\n  } catch {\n    return null;\n  }\n}\n\n/** \u81EA filePath \u5411\u4E0A\u627E\u6700\u8FD1\u6709\u6548\u6A21\u5757\u6839\uFF1B\u627E\u4E0D\u5230\u8FD4\u56DE null */\nexport function findModuleRootFromFile(filePath: string): string | null {\n  let cur = path.dirname(path.resolve(filePath));\n  const root = path.parse(cur).root;\n  while (true) {\n    if (isValidModuleRoot(cur)) return cur;\n    if (cur === root) return null;\n    const parent = path.dirname(cur);\n    if (parent === cur) return null;\n    cur = parent;\n  }\n}\n", "/**\n * SFMC \u5DE5\u4F5C\u76EE\u5F55\u5224\u5B9A\uFF08\u8FD0\u884C\u65F6\u6839\uFF1Aconfigs/\u3001modules/\uFF1B\u4E0D\u662F\u6E90\u7801\u4ED3\u5E93\u6839\uFF09\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\n/** \u76EE\u5F55\u662F\u5426\u4E3A\u6709\u6548 SFMC \u5DE5\u4F5C\u76EE\u5F55\uFF08\u542B configs/ \u4E0E modules/\uFF09\u3002 */\nexport function isValidSfmcRoot(dir: string): boolean {\n  if (!dir || !dir.trim()) return false;\n  const root = path.resolve(dir);\n  try {\n    return (\n      fs.statSync(path.join(root, \"configs\")).isDirectory() &&\n      fs.statSync(path.join(root, \"modules\")).isDirectory()\n    );\n  } catch {\n    return false;\n  }\n}\n", "/**\n * \u89E3\u6790\u5E76 spawn sfmc CLI\u3002\n * CLI \u4E0E SFMC \u5DE5\u4F5C\u76EE\u5F55\u65E0\u5173\uFF1A\u4ECE\u672C\u5305/\u6269\u5C55\u5B89\u88C5\u6811\u3001PATH \u6216\u663E\u5F0F\u914D\u7F6E\u89E3\u6790\uFF1B\n * \u5DE5\u4F5C\u76EE\u5F55\u53EA\u4F5C\u4E3A spawn \u7684 cwd \u4E0E SFMC_ROOT\u3002\n */\n\nimport { spawn } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { isValidSfmcRoot } from \"./sfmc-root.js\";\n\n/** chalk.hex(\"#e06c75\") \u7684\u771F\u5F69\u5E8F\u5217\uFF1BCLI \u5931\u8D25\u6587\u6848\u7ECF c.red() \u5305\u88C5\u3002 */\nconst CLI_ANSI_RED = \"\\u001b[38;2;224;108;117m\";\n\nexport interface ResolveSfmcCliOptions {\n  /** \u663E\u5F0F CLI \u5165\u53E3\uFF08.js/.mjs\uFF09\uFF1B\u4E5F\u53EF\u7528\u73AF\u5883\u53D8\u91CF SFMC_CLI\u3002 */\n  cliPath?: string;\n}\n\nfunction tryRequireCli(from: string): string | null {\n  try {\n    const resolved = createRequire(from).resolve(\"@sfmc-bds/cli/cli\");\n    return fs.existsSync(resolved) ? resolved : null;\n  } catch {\n    return null;\n  }\n}\n\n/** \u81EA PATH \u4E0A\u7684 sfmc \u53EF\u6267\u884C\u6587\u4EF6\u65C1\u89E3\u6790 @sfmc-bds/cli\uFF08npm global / \u672C\u5730 .bin\uFF09\u3002 */\nfunction resolveCliFromPathEnv(): string | null {\n  const pathEnv = process.env.PATH ?? \"\";\n  const names =\n    process.platform === \"win32\" ? [\"sfmc.cmd\", \"sfmc.exe\", \"sfmc.ps1\", \"sfmc\"] : [\"sfmc\"];\n  for (const dir of pathEnv.split(path.delimiter)) {\n    if (!dir) continue;\n    let hit = false;\n    for (const name of names) {\n      if (fs.existsSync(path.join(dir, name))) {\n        hit = true;\n        break;\n      }\n    }\n    if (!hit) continue;\n    const nearCli = path.join(dir, \"..\", \"@sfmc-bds\", \"cli\", \"dist\", \"main.js\");\n    if (fs.existsSync(nearCli)) return nearCli;\n    const nearMeta = path.join(dir, \"..\", \"@sfmc-bds\", \"sfmc\", \"bin\", \"sfmc.mjs\");\n    if (fs.existsSync(nearMeta)) return nearMeta;\n    const fromBin = tryRequireCli(path.join(dir, \"..\", \"package.json\"));\n    if (fromBin) return fromBin;\n  }\n  return null;\n}\n\n/**\n * \u89E3\u6790 sfmc CLI \u811A\u672C\u8DEF\u5F84\u3002\n * \u987A\u5E8F\uFF1A\u663E\u5F0F cliPath / SFMC_CLI \u2192 \u672C\u5305\u5B89\u88C5\u6811\uFF08@sfmc-bds/cli\uFF09\u2192 cwd \u7684 node_modules \u2192 PATH\u3002\n */\nexport function resolveSfmcCli(opts: ResolveSfmcCliOptions = {}): string {\n  const explicit = (opts.cliPath || process.env.SFMC_CLI || \"\").trim();\n  if (explicit) {\n    const p = path.resolve(explicit);\n    if (!fs.existsSync(p)) {\n      throw new Error(`\u6307\u5B9A\u7684 sfmc CLI \u4E0D\u5B58\u5728\uFF1A${p}\uFF08\u68C0\u67E5 SFMC_CLI / sfmc.cliPath\uFF09`);\n    }\n    return p;\n  }\n\n  const here = fileURLToPath(import.meta.url);\n  const fromInstall = tryRequireCli(here);\n  if (fromInstall) return fromInstall;\n\n  const fromCwd = tryRequireCli(path.join(process.cwd(), \"package.json\"));\n  if (fromCwd) return fromCwd;\n\n  const fromPath = resolveCliFromPathEnv();\n  if (fromPath) return fromPath;\n\n  throw new Error(\n    \"\u65E0\u6CD5\u89E3\u6790 sfmc CLI\u3002\u8BF7\u5B89\u88C5 @sfmc-bds/cli\uFF08\u6216\u786E\u4FDD PATH \u4E0A\u6709 sfmc\uFF09\uFF0C\u6216\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF SFMC_CLI / \u6269\u5C55\u914D\u7F6E sfmc.cliPath\u3002\"\n  );\n}\n\nfunction looksLikeCliFailure(output: string): boolean {\n  if (output.includes(CLI_ANSI_RED)) return true;\n  if (/\\[pack-manager\\].*required/.test(output)) return true;\n  if (/^Error:/m.test(output)) return true;\n  return false;\n}\n\nexport interface RunSfmcCliResult {\n  ok: boolean;\n  output: string;\n}\n\nexport interface RunSfmcCliOptions {\n  cliPath?: string;\n}\n\n/** \u5728 SFMC \u5DE5\u4F5C\u76EE\u5F55\u4E0B\u6267\u884C `node <sfmc-cli> ...args`\uFF08env.SFMC_ROOT = \u5DE5\u4F5C\u76EE\u5F55\uFF09\u3002 */\nexport async function runSfmcCli(\n  sfmcRoot: string,\n  args: string[],\n  opts: RunSfmcCliOptions = {}\n): Promise<RunSfmcCliResult> {\n  const root = path.resolve(sfmcRoot);\n  if (!isValidSfmcRoot(root)) {\n    return {\n      ok: false,\n      output: `\u65E0\u6548\u7684 SFMC \u5DE5\u4F5C\u76EE\u5F55\uFF1A${root}\uFF08\u9700\u8981\u542B configs/ \u4E0E modules/\uFF0C\u4E0D\u5FC5\u542B\u6E90\u7801\u4ED3\u5E93\uFF09`,\n    };\n  }\n\n  let script: string;\n  try {\n    script = resolveSfmcCli({ cliPath: opts.cliPath });\n  } catch (e) {\n    return { ok: false, output: e instanceof Error ? e.message : String(e) };\n  }\n\n  const r = await new Promise<{ code: number | null; output: string }>((resolve) => {\n    const proc = spawn(process.execPath, [script, ...args], {\n      cwd: root,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      env: { ...process.env, SFMC_ROOT: root },\n    });\n    let out = \"\";\n    proc.stdout?.on(\"data\", (d) => {\n      out += d.toString();\n    });\n    proc.stderr?.on(\"data\", (d) => {\n      out += d.toString();\n    });\n    proc.on(\"exit\", (code) => resolve({ code, output: out }));\n    proc.on(\"error\", (e) => resolve({ code: 1, output: e.message }));\n  });\n\n  const ok = r.code === 0 && !looksLikeCliFailure(r.output);\n  return { ok, output: r.output };\n}\n", "/**\n * \u76D1\u542C\u6A21\u5757 sapi/src\uFF0C\u9632\u6296\u540E\u56DE\u8C03 onRebuild\uFF08\u7531\u8C03\u7528\u65B9\u6CE8\u5165 rebuildAndDeploy / \u5176\u5B83\uFF09\u3002\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nexport interface ModuleWatchOptions {\n  moduleRoot: string;\n  debounceMs?: number;\n  log?: (line: string) => void;\n  onRebuild: () => Promise<{ ok: boolean; message?: string }>;\n}\n\nexport function startModuleWatch(opts: ModuleWatchOptions): { stop: () => void } {\n  const log = opts.log ?? ((line: string) => console.log(line));\n  const debounceMs = opts.debounceMs ?? 200;\n  const sapiDir = path.join(opts.moduleRoot, \"sapi\");\n  const srcDir = path.join(sapiDir, \"src\");\n\n  if (!fs.existsSync(sapiDir)) {\n    log(`[devkit:watch] \u65E0 sapi \u76EE\u5F55: ${sapiDir}`);\n    return { stop: () => {} };\n  }\n\n  let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  let pending = new Set<string>();\n  let running = false;\n  let stopped = false;\n\n  log(`[devkit:watch] \u76D1\u542C ${opts.moduleRoot}`);\n\n  const runOnce = async () => {\n    if (running || stopped) return;\n    running = true;\n    const changed = [...pending];\n    pending = new Set();\n    const t0 = Date.now();\n    log(`[devkit:watch] rebuild (${changed.length})\u2026`);\n    try {\n      const r = await opts.onRebuild();\n      const ms = Date.now() - t0;\n      if (r.ok) log(`[devkit:watch] ok ${ms}ms`);\n      else log(`[devkit:watch] fail ${ms}ms ${r.message ?? \"\"}`);\n    } catch (e) {\n      log(`[devkit:watch] error ${(e as Error).message}`);\n    } finally {\n      running = false;\n    }\n  };\n\n  const onSrc = (rel: string) => {\n    if (stopped) return;\n    if (rel.includes(\"node_modules\") || rel.includes(\"dist\") || rel.endsWith(\".tgz\")) return;\n    pending.add(rel);\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = setTimeout(() => void runOnce(), debounceMs);\n  };\n\n  const watchers: fs.FSWatcher[] = [];\n  if (fs.existsSync(srcDir)) {\n    try {\n      watchers.push(\n        fs.watch(srcDir, { recursive: true, persistent: true }, (_e, filename) => {\n          if (filename) onSrc(filename.toString());\n        })\n      );\n    } catch {\n      watchers.push(\n        fs.watch(srcDir, { persistent: true }, (_e, filename) => {\n          if (filename) onSrc(filename.toString());\n        })\n      );\n    }\n  }\n\n  const watchMeta = (file: string, kind: string) => {\n    if (!fs.existsSync(file)) return;\n    watchers.push(\n      fs.watch(file, { persistent: true }, (event) => {\n        if (event === \"change\") log(`[devkit:watch] ${kind} \u5DF2\u6539\uFF0C\u9700\u91CD\u542F BDS\uFF08SAPI \u542F\u52A8\u671F\u7F13\u5B58\uFF09`);\n      })\n    );\n  };\n  watchMeta(path.join(sapiDir, \"manifest.json\"), \"manifest\");\n  watchMeta(path.join(sapiDir, \"tsconfig.json\"), \"tsconfig\");\n\n  return {\n    stop() {\n      stopped = true;\n      if (debounceTimer) clearTimeout(debounceTimer);\n      for (const w of watchers) {\n        try {\n          w.close();\n        } catch {\n          /* ignore */\n        }\n      }\n      log(\"[devkit:watch] stopped\");\n    },\n  };\n}\n", "/**\n * \u811A\u624B\u67B6\uFF1A\u59D4\u6258 @sfmc-bds/devkit/scripts/new-module.mjs\u3002\n */\n\nimport { spawn } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findMonorepoRoot } from \"@sfmc-bds/sdk/node/config\";\n\nexport interface ScaffoldOptions {\n  /** \u76EE\u6807\u76EE\u5F55\uFF08\u987B\u4E3A\u7A7A\u6216\u53EF\u521B\u5EFA\uFF09\u3002 */\n  targetDir: string;\n  moduleId: string;\n  displayName?: string;\n  official?: boolean;\n}\n\nfunction resolveNewModuleScript(): string {\n  const require = createRequire(import.meta.url);\n  try {\n    return require.resolve(\"@sfmc-bds/devkit/new-module.mjs\");\n  } catch {\n    /* monorepo \u56DE\u9000 */\n  }\n  const monoRoot = findMonorepoRoot(process.cwd());\n  const mono = monoRoot\n    ? path.join(monoRoot, \"packages\", \"devkit\", \"scripts\", \"new-module.mjs\")\n    : path.resolve(process.cwd(), \"packages/devkit/scripts/new-module.mjs\");\n  if (fs.existsSync(mono)) return mono;\n  throw new Error(\"\u65E0\u6CD5\u89E3\u6790 new-module.mjs\uFF08\u5B89\u88C5 @sfmc-bds/devkit \u6216\u5728 monorepo \u6839\u8FD0\u884C\uFF09\");\n}\n\nexport async function scaffoldModule(opts: ScaffoldOptions): Promise<{ ok: boolean; message: string }> {\n  const dir = path.resolve(opts.targetDir);\n  fs.mkdirSync(dir, { recursive: true });\n  const script = resolveNewModuleScript();\n  const args = [script, opts.moduleId];\n  if (opts.displayName) args.push(\"--name\", opts.displayName);\n  if (opts.official) args.push(\"--official\");\n\n  return new Promise((resolve) => {\n    const proc = spawn(process.execPath, args, {\n      cwd: dir,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      env: process.env,\n    });\n    let out = \"\";\n    proc.stdout?.on(\"data\", (d) => {\n      out += d.toString();\n    });\n    proc.stderr?.on(\"data\", (d) => {\n      out += d.toString();\n    });\n    proc.on(\"exit\", (code) => {\n      resolve({\n        ok: code === 0,\n        message: out.trim() || (code === 0 ? `scaffolded ${opts.moduleId}` : `exit ${code}`),\n      });\n    });\n    proc.on(\"error\", (e) => resolve({ ok: false, message: e.message }));\n  });\n}\n", "/**\n * \u7EC4\u88C5\u5E76\u90E8\u7F72\u884C\u4E3A\u5305\uFF1A\u5728 SFMC_ROOT \u4E0B spawn `sfmc mod reload`\n * \uFF08\u4E0E CLI \u540C\u4E00\u5165\u53E3\uFF0C\u5B8C\u6574\u4F20\u53C2\uFF1B\u52FF\u76F4\u63A5\u88F8\u8C03 pack-manager verb\uFF09\u3002\n */\n\nimport { runSfmcCli } from \"./sfmc-cli.js\";\n\nexport interface RebuildOptions {\n  /** SFMC \u5DE5\u4F5C\u76EE\u5F55\uFF08\u542B configs/\u3001modules/\uFF09\u3002 */\n  sfmcRoot: string;\n  /** \u4EC5\u6784\u5EFA\u90E8\u7F72\uFF0C\u4E0D\u5411 BDS \u53D1 reload\uFF08\u5BF9\u5E94 `mod reload --build-only`\uFF09\u3002 */\n  buildOnly?: boolean;\n  /** \u53EF\u9009\uFF1A\u663E\u5F0F sfmc CLI \u5165\u53E3\uFF1B\u9ED8\u8BA4\u7531\u5B89\u88C5\u6811 / PATH / SFMC_CLI \u89E3\u6790\u3002 */\n  cliPath?: string;\n}\n\nexport interface RebuildResult {\n  ok: boolean;\n  output: string;\n}\n\nexport async function rebuildAndDeploy(opts: RebuildOptions): Promise<RebuildResult> {\n  const args = [\"mod\", \"reload\"];\n  if (opts.buildOnly) args.push(\"--build-only\");\n  return runSfmcCli(opts.sfmcRoot, args, { cliPath: opts.cliPath });\n}\n", "/**\n * \u6A21\u5757\u542F\u505C\uFF1Aspawn `sfmc mod enable|disable`\uFF08\u5199 module-lock + best-effort \u70ED\u540C\u6B65\uFF09\u3002\n */\n\nimport { runSfmcCli, type RunSfmcCliResult } from \"./sfmc-cli.js\";\n\nexport interface SetModuleEnabledOptions {\n  /** SFMC \u5DE5\u4F5C\u76EE\u5F55\uFF08\u542B modules/module-lock.json\uFF09\u3002 */\n  sfmcRoot: string;\n  /** \u6A21\u5757 logicalId / folderId / configKey\uFF08\u4E0E CLI `mod enable` \u4E00\u81F4\uFF09\u3002 */\n  moduleId: string;\n  enabled: boolean;\n  /** \u53EF\u9009\uFF1A\u663E\u5F0F sfmc CLI \u5165\u53E3\uFF1B\u9ED8\u8BA4\u7531\u5B89\u88C5\u6811 / PATH / SFMC_CLI \u89E3\u6790\u3002 */\n  cliPath?: string;\n}\n\nexport type SetModuleEnabledResult = RunSfmcCliResult;\n\n/** \u542F\u7528\u6216\u5173\u95ED\u6A21\u5757\uFF08\u4E0E CLI `mod enable|disable` \u540C\u6E90\uFF09\u3002 */\nexport async function setModuleEnabled(opts: SetModuleEnabledOptions): Promise<SetModuleEnabledResult> {\n  const id = String(opts.moduleId || \"\").trim();\n  if (!id) {\n    return { ok: false, output: \"moduleId \u4E3A\u7A7A\" };\n  }\n  const action = opts.enabled ? \"enable\" : \"disable\";\n  return runSfmcCli(opts.sfmcRoot, [\"mod\", action, id], { cliPath: opts.cliPath });\n}\n"],
+  "mappings": "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",
   "names": ["path", "fs", "path", "fs", "path", "fs", "path", "fs", "path", "spawn", "createRequire", "fs", "path", "require"]
 }

package/dist/scaffold.d.ts

@@ -1,5 +1,5 @@
 /**
- * 脚手架：委托 @sfmc-bds/tools/new-module（或 monorepo packages/tools/new-module.mjs）。
+ * 脚手架：委托 @sfmc-bds/devkit/scripts/new-module.mjs。
  */
 export interface ScaffoldOptions {
     /** 目标目录（须为空或可创建）。 */

package/dist/scaffold.js

@@ -1,5 +1,5 @@
 /**
- * 脚手架：委托 @sfmc-bds/tools/new-module（或 monorepo packages/tools/new-module.mjs）。
+ * 脚手架：委托 @sfmc-bds/devkit/scripts/new-module.mjs。
  */
 import { spawn } from "node:child_process";
 import { createRequire } from "node:module";
@@ -9,18 +9,18 @@ import { findMonorepoRoot } from "@sfmc-bds/sdk/node/config";
 function resolveNewModuleScript() {
     const require = createRequire(import.meta.url);
     try {
-        return require.resolve("@sfmc-bds/tools/new-module.mjs");
+        return require.resolve("@sfmc-bds/devkit/new-module.mjs");
     }
     catch {
         /* monorepo 回退 */
     }
     const monoRoot = findMonorepoRoot(process.cwd());
     const mono = monoRoot
-        ? path.join(monoRoot, "packages", "tools", "new-module.mjs")
-        : path.resolve(process.cwd(), "packages/tools/new-module.mjs");
+        ? path.join(monoRoot, "packages", "devkit", "scripts", "new-module.mjs")
+        : path.resolve(process.cwd(), "packages/devkit/scripts/new-module.mjs");
     if (fs.existsSync(mono))
         return mono;
-    throw new Error("无法解析 new-module.mjs（安装 @sfmc-bds/tools 或在 monorepo 根运行）");
+    throw new Error("无法解析 new-module.mjs（安装 @sfmc-bds/devkit 或在 monorepo 根运行）");
 }
 export async function scaffoldModule(opts) {
     const dir = path.resolve(opts.targetDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sfmc-bds/devkit",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.2",
   "description": "SFMC module authoring toolkit — watch, scaffold, rebuild (for VS Code extension & tooling)",
   "type": "module",
   "license": "AGPL-3.0-only",
@@ -14,10 +14,16 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
-    }
+    },
+    "./new-module.mjs": "./scripts/new-module.mjs",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "sfmc-new-module": "./scripts/new-module.mjs"
   },
   "files": [
     "dist",
+    "scripts",
     "README.md"
   ],
   "scripts": {
@@ -26,8 +32,8 @@
   },
   "dependencies": {
     "@sfmc-bds/bds-tools": "^0.2.0-beta.8",
-    "@sfmc-bds/cli": "^0.2.0-beta.8",
-    "@sfmc-bds/tools": "^0.2.0-beta.9"
+    "@sfmc-bds/cli": "^0.2.0-beta.10",
+    "@sfmc-bds/sdk": "^0.2.0-beta.8"
   },
   "publishConfig": {
     "access": "public",

package/scripts/new-module.mjs

@@ -0,0 +1,659 @@
+#!/usr/bin/env node
+// @ts-check
+/**
+ * @sfmc-bds/devkit — 生成最小模块骨架（单包根）
+ *
+ * - 写入 **当前工作目录**（须为空）—— 与 Tanya7z/sfmc-module-template 同构
+ * - 传入 `--root` / `SFMC_MODULES_ROOT` 会直接退出（sfmc-modules 仅为 index）
+ * - `--official` → `@sfmc-bds/module-<id>`；默认 `@CHANGE_ME/sfmc-module-<id>`
+ *
+ * Usage:
+ *   mkdir my-mod && cd my-mod
+ *   node packages/devkit/scripts/new-module.mjs my-mod --name "我的模块"
+ *   npx sfmc-new-module my-mod --name "我的模块"
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+
+/**
+ * @param {string} msg
+ */
+function die(msg, code = 1) {
+  console.error(`[new-module] ${msg}`);
+  process.exit(code);
+}
+
+/**
+ * @param {string | any[]} argv
+ */
+function parseArgs(argv) {
+  /** @type {{ name: string | null, root: string | null, template: string, listTemplates: boolean, official: boolean }} */
+  const flags = { name: null, root: null, template: "minimal", listTemplates: false, official: false };
+  /** @type {string[]} */
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--name") flags.name = argv[++i] ?? null;
+    else if (a === "--root") flags.root = argv[++i] ?? null;
+    else if (a === "--template") flags.template = argv[++i] ?? "minimal";
+    else if (a === "--list-templates") flags.listTemplates = true;
+    else if (a === "--official") flags.official = true;
+    else if (a.startsWith("--name=")) flags.name = a.slice("--name=".length);
+    else if (a.startsWith("--root=")) flags.root = a.slice("--root=".length);
+    else if (a.startsWith("--template=")) flags.template = a.slice("--template=".length);
+    else if (a.startsWith("--")) die(`未知参数: ${a}`);
+    else positional.push(a);
+  }
+  return { flags, positional };
+}
+
+/**
+ * 模板清单 —— 这是 sfmc-modules 可用模板的唯一权威源(OCP)。
+ * 加新模板只需:
+ *   1) 在下方数组里加一条(配合 buildManifest 分支处理)
+ *   2) 在 sfmc CLI 的 i18n 中加 modwiz.tpl.<id> / modwiz.tpl.<id>Hint
+ *
+ * 注意:不在此处放显示文案;本地化由 sfmc i18n 接管,本工具只暴露机器可读清单。
+ *
+ * 输出格式:每行 `<id>` 或 `<id>\tdefault` —— 单源、纯文本、无 JSON 依赖。
+ */
+const TEMPLATES = [
+  { id: "minimal", isDefault: true },
+  { id: "db", isDefault: false },
+];
+
+function emitTemplateList() {
+  for (const tpl of TEMPLATES) {
+    process.stdout.write(`${tpl.id}${tpl.isDefault ? "\tdefault" : ""}\n`);
+  }
+}
+
+/**
+ * @param {string} id
+ */
+function isValidFolderId(id) {
+  return /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(id);
+}
+
+/**
+ * 决定模块骨架落盘位置：写到 cwd（单包根，与 Tanya7z/sfmc-module-template 同构）。
+ * 传入 `--root` / `SFMC_MODULES_ROOT` 会退出。
+ * @param {{ name?: string | null; root: any; template?: string; listTemplates?: boolean; official?: boolean; }} flags
+ */
+function resolveTargetDir(flags) {
+  if (flags.root || process.env.SFMC_MODULES_ROOT) {
+    die(
+      `--root / SFMC_MODULES_ROOT 已移除：sfmc-modules 仅为 index。请在空目录运行本工具生成单包根，或使用 Tanya7z/sfmc-module-template。`
+    );
+  }
+  return path.resolve(process.cwd());
+}
+
+/**
+ * @param {string} folderId
+ * @param {{ official: boolean }} opts
+ */
+function buildPackageJson(folderId, opts) {
+  const base = {
+    name: opts.official ? `@sfmc-bds/module-${folderId}` : `@CHANGE_ME/sfmc-module-${folderId}`,
+    version: "0.1.0",
+    type: "module",
+    description: `SAPI module: ${folderId}`,
+    main: "sapi/src/index.ts",
+    exports: {
+      ".": "./sapi/src/index.ts",
+    },
+    files: ["sapi", "test", "README.md", "LICENSE"],
+  };
+  /* 自包含单包根（与 Tanya7z/sfmc-module-template 同构） */
+  return {
+    ...base,
+    scripts: {
+      build: "npm run typecheck",
+      typecheck: "tsc --noEmit -p sapi/tsconfig.json",
+      test: "node --test --import @sfmc-bds/sdk/testing/minecraft-loader --import tsx/esm test/*.test.ts",
+      lint: 'eslint "sapi/**/*.ts" "test/**/*.ts"',
+      format: "prettier --write .",
+    },
+    devDependencies: {
+      "@minecraft/server": "2.10.0-beta.1.26.40-preview.30",
+      "@minecraft/server-net": "1.0.0-beta.11940b24",
+      "@minecraft/server-ui": "2.2.0-beta.1.26.40-preview.30",
+      "@minecraft/vanilla-data": "1.26.40-preview.30",
+      "@sfmc-bds/eslint-plugin": "^0.1.0",
+      "@sfmc-bds/sdk": "^0.2.0-beta.7",
+      "@types/node": "^22.13.0",
+      "@typescript-eslint/eslint-plugin": "^8.64.0",
+      "@typescript-eslint/parser": "^8.64.0",
+      eslint: "^10.7.0",
+      prettier: "^3.9.5",
+      "prettier-plugin-organize-imports": "^4.3.0",
+      tsx: "^4.19.0",
+      typescript: "^5.6.0",
+    },
+    peerDependencies: { "@sfmc-bds/sdk": ">=0.2.0" },
+    engines: { node: ">=22.13.0" },
+  };
+}
+
+/**
+ * @param {string} folderId
+ * @param {string} displayName
+ * @param {"minimal"|"db"} template
+ * @param {string} schemaRel $schema 相对 sapi/ 的路径（由调用方按落盘位置计算）
+ */
+function buildManifest(folderId, displayName, template, schemaRel) {
+  if (folderId.startsWith("feature-") || folderId.startsWith("core-")) {
+    die(`folder 须为短名（不含 feature-/core- 前缀），例如 area 而非 feature-area`);
+  }
+  const logicalId = `feature-${folderId}`;
+  const configKey = folderId.replace(/-/g, "_");
+  /** @type {Record<string, unknown>} */
+  const base = {
+    $schema: schemaRel,
+    schemaVersion: 2,
+    id: logicalId,
+    name: displayName,
+    type: "feature",
+    configKey,
+    requires: [],
+    permissions: [`config:read:${configKey}`],
+    services: { provides: [], requires: [] },
+    notes: `由 @sfmc-bds/devkit new-module 脚手架生成（template=${template}）`,
+  };
+  if (template === "db") {
+    base.permissions = [`db:read:sfmc_${configKey}`, `db:write:sfmc_${configKey}`, `config:read:${configKey}`];
+    base.notes =
+      `由 @sfmc-bds/devkit new-module 脚手架生成（含 db 权限占位）。` +
+      `请在 sapi/manifest.json 中补全 routes/migrations，并实现 db 表。`;
+  }
+  return base;
+}
+
+/**
+ * 自包含 sapi/tsconfig.json —— 不依赖平台仓 tsconfig.base.json；
+ * SDK 类型由 npm 装入 node_modules/@sfmc-bds/sdk 时随附。
+ */
+function buildTsConfigStandalone() {
+  return {
+    compilerOptions: {
+      module: "nodenext",
+      moduleResolution: "nodenext",
+      target: "es2022",
+      lib: ["es2022"],
+      types: ["node"],
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      noEmit: true,
+      rootDir: "./src",
+    },
+    include: ["src/**/*"],
+  };
+}
+
+function buildRootTsConfig() {
+  return {
+    compilerOptions: {
+      module: "nodenext",
+      moduleResolution: "nodenext",
+      target: "es2022",
+      lib: ["es2022"],
+      types: ["node"],
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      noEmit: true,
+    },
+    include: ["sapi/**/*", "test/**/*"],
+  };
+}
+
+/**
+ * @param {string} folderId
+ * @param {string} displayName
+ * @param {string} pkgName
+ */
+function buildIndexTs(folderId, displayName, pkgName) {
+  const logicalId = `feature-${folderId}`;
+  const perm = folderId.replace(/-/g, "_");
+  return `/**
+ * ${pkgName} — ${displayName}
+ * 由 @sfmc-bds/devkit new-module 脚手架生成。
+ */
+
+import { ModuleRegistry, type ModuleDescriptor } from "@sfmc-bds/sdk/module-loader";
+import { Command, Msg, Permission } from "@sfmc-bds/sdk/sapi/runtime";
+
+/** 与 sapi/manifest.json 的 id 一致（逻辑 id，非文件夹短名）。 */
+export const MODULE_ID = "${logicalId}";
+
+/** 命令权限名。 */
+export const PERM = "${perm}.use";
+
+function registerPermissions(): void {
+  Permission.register(PERM, Permission.Any);
+}
+
+function registerCommands(): void {
+  Command.register(
+    "${perm}",
+    PERM,
+    (player) => {
+      if (!player) return;
+      Msg.info("模块 ${displayName} 已就绪", player);
+    },
+    "${displayName}",
+    MODULE_ID
+  );
+}
+
+function registerEvents(): void {
+  /* 事件订阅放在本阶段，不要放进 init()。 */
+}
+
+function init(): void {
+  /* TODO: 读取 configs/${perm}.json、注册 db 表等 */
+}
+
+function cleanup(): void {
+  /* TODO: 取消事件订阅、关闭 handle、清理定时器。 */
+}
+
+export const DESCRIPTOR: ModuleDescriptor = {
+  id: MODULE_ID,
+  afterWorldLoad: false,
+  lifecycle: {
+    registerPermissions,
+    registerCommands,
+    registerEvents,
+    init,
+    cleanup,
+  },
+};
+
+ModuleRegistry.register(DESCRIPTOR);
+`;
+}
+
+/**
+ * @param {string} folderId
+ * @param {string} displayName
+ */
+function buildExampleTest(folderId, displayName) {
+  const logicalId = `feature-${folderId}`;
+  const cmdName = folderId.replace(/-/g, "_");
+  const readyMsg = `模块 ${displayName} 已就绪`;
+  return `/**
+ * test/${folderId}.test.ts — 模块 lifecycle + 命令冒烟（假引擎）
+ *
+ * 跑法：npm test（SDK minecraft-loader + createSandbox）
+ */
+
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { test } from "node:test";
+import { fileURLToPath } from "node:url";
+import { assertMsg, createSandbox, runCleanup } from "@sfmc-bds/sdk/testing";
+
+import { DESCRIPTOR, MODULE_ID, PERM } from "../sapi/src/index.js";
+
+const MANIFEST_PATH = fileURLToPath(new URL("../sapi/manifest.json", import.meta.url));
+
+function readManifest(): {
+  id: string;
+  configKey: string;
+  permissions?: string[];
+} {
+  return JSON.parse(readFileSync(MANIFEST_PATH, "utf8")) as {
+    id: string;
+    configKey: string;
+    permissions?: string[];
+  };
+}
+
+test("descriptor / MODULE_ID 与 sapi/manifest.json 一致", () => {
+  const manifest = readManifest();
+  assert.equal(DESCRIPTOR.id, MODULE_ID);
+  assert.equal(MODULE_ID, manifest.id, "MODULE_ID 必须等于 manifest.id");
+  assert.equal(DESCRIPTOR.id, manifest.id, "DESCRIPTOR.id 必须等于 manifest.id");
+  assert.equal(MODULE_ID, "${logicalId}");
+  assert.equal(DESCRIPTOR.afterWorldLoad, false);
+  assert.equal(typeof DESCRIPTOR.lifecycle.registerPermissions, "function");
+  assert.equal(typeof DESCRIPTOR.lifecycle.registerCommands, "function");
+  assert.equal(typeof DESCRIPTOR.lifecycle.registerEvents, "function");
+  assert.equal(typeof DESCRIPTOR.lifecycle.init, "function");
+  assert.equal(typeof DESCRIPTOR.lifecycle.cleanup, "function");
+});
+
+test("PERM / 命令名与 manifest.configKey 对齐", () => {
+  const manifest = readManifest();
+  assert.ok(manifest.configKey, "manifest.configKey 必填");
+  assert.equal(PERM, \`\${manifest.configKey}.use\`);
+  assert.ok(
+    Array.isArray(manifest.permissions) &&
+      manifest.permissions.includes(\`config:read:\${manifest.configKey}\`),
+    \`manifest.permissions 应含 config:read:\${manifest.configKey}\`
+  );
+});
+
+test("createSandbox lifecycle 跑通", async (t) => {
+  const sb = await createSandbox({ module: DESCRIPTOR });
+  t.after(() => sb.dispose());
+  assert.ok(sb.world);
+  assert.ok(sb.system);
+});
+
+test("命令 ${cmdName} 触发后，玩家收到 Msg.info", async (t) => {
+  const sb = await createSandbox({ module: DESCRIPTOR });
+  t.after(() => sb.dispose());
+  const player = sb.addPlayer({ id: "tester-1", name: "tester", op: true });
+  await sb.triggerCommand("${cmdName}", player);
+  assert.ok(assertMsg(player, "${readyMsg}", "§"), "玩家 log 应含预期文本");
+  assert.equal(player.log.length, 1);
+  assert.match(player.log[0]!, /^§f\\[\\*\\] /);
+});
+
+test("cleanup 不抛错", async () => {
+  const r = await runCleanup(DESCRIPTOR);
+  assert.equal(r.ok, true, \`cleanup 抛出: \${r.error instanceof Error ? r.error.message : String(r.error)}\`);
+});
+
+test("PERM 格式正确", () => {
+  assert.match(PERM, /^[a-z][a-z0-9_]*\\.use$/);
+});
+`;
+}
+
+/** 与 sfmc-module-template/eslint.config.js 同构 */
+function buildEslintConfigJs() {
+  return `// SFMC 模块 ESLint 配置
+import sfmc from "@sfmc-bds/eslint-plugin";
+import tsPlugin from "@typescript-eslint/eslint-plugin";
+import tsParser from "@typescript-eslint/parser";
+
+export default [
+  {
+    ignores: ["**/dist/**", "**/node_modules/**", "**/build/**", "**/*.d.ts"],
+  },
+  {
+    files: ["sapi/**/*.ts", "test/**/*.ts"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: "module",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin,
+      "@sfmc-bds": sfmc,
+    },
+    rules: {
+      "no-undef": "off",
+      "no-unused-vars": "off",
+      "@typescript-eslint/no-explicit-any": "warn",
+      "@typescript-eslint/no-unused-vars": [
+        "warn",
+        { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
+      ],
+      "@typescript-eslint/ban-ts-comment": "warn",
+      "@typescript-eslint/no-require-imports": "error",
+      ...sfmc.configs.recommended.rules,
+    },
+  },
+  {
+    /* 旧版 eslint-plugin 静态白名单可能未含 testing；测试文件允许 SDK testing 入口 */
+    files: ["test/**/*.ts"],
+    rules: {
+      "@sfmc-bds/no-sdk-private-export": "off",
+    },
+  },
+];
+`;
+}
+
+function buildGitignore() {
+  return `node_modules/
+dist/
+*.tgz
+*.log
+.DS_Store
+.idea/
+`;
+}
+
+function buildPrettierRc() {
+  return {
+    trailingComma: "es5",
+    tabWidth: 2,
+    semi: true,
+    singleQuote: false,
+    bracketSpacing: true,
+    arrowParens: "always",
+    printWidth: 120,
+    endOfLine: "crlf",
+    plugins: ["prettier-plugin-organize-imports"],
+  };
+}
+
+function buildPrettierIgnore() {
+  return `node_modules/
+dist/
+*.tgz
+package-lock.json
+`;
+}
+
+function buildLicense() {
+  return `ISC License
+
+Copyright (c) ${new Date().getFullYear()}, ScriptsForMinecraftServer contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+`;
+}
+
+/**
+ * @param {string} folderId
+ * @param {string} displayName
+ * @param {string} pkgName
+ */
+function buildReadme(folderId, displayName, pkgName) {
+  return `# ${folderId}
+
+${displayName}（\`${pkgName}\`）— SFMC SAPI 模块。
+
+## 最短成功路径
+
+\`\`\`bash
+npm install
+npm run typecheck
+npm test
+npm run lint
+\`\`\`
+
+用 VS Code / Cursor **单独打开本仓根**。推荐扩展：ESLint、Prettier、SFMC Module、Node.js Test Runner。
+
+1. \`npm test\`（假引擎；不依赖 \`sfmc.root\`）
+2. 可视化编排：独立应用 **Sapience**
+3. 真机联调：设 \`sfmc.root\` 为 SFMC **工作目录**（含 \`configs/\`、\`modules/\`），再 Start Watch / Reload to BDS
+4. link：\`sfmc mod install ${folderId} --from dir:<本仓绝对路径> --link\`
+
+| 命令 | 作用 |
+| --- | --- |
+| \`npm run build\` / \`typecheck\` | tsc --noEmit |
+| \`npm test\` | createSandbox + DESCRIPTOR |
+| \`npm run lint\` / \`format\` | ESLint / Prettier |
+
+\`DESCRIPTOR.id\` 须与 \`sapi/manifest.json\` 的 \`id\`（\`feature-${folderId}\`）一致。
+`;
+}
+
+/**
+ * @param {fs.PathOrFileDescriptor} filePath
+ * @param {Record<string, unknown>} data
+ */
+function writeJson(filePath, data) {
+  // @ts-ignore
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, "utf8");
+}
+
+/**
+ * @param {fs.PathOrFileDescriptor} filePath
+ * @param {string | NodeJS.ArrayBufferView<ArrayBufferLike>} content
+ */
+function writeText(filePath, content) {
+  // @ts-ignore
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, content, "utf8");
+}
+
+/**
+ * @param {string} target
+ */
+function writeVscodeWorkspace(target) {
+  writeJson(path.join(target, ".vscode", "extensions.json"), {
+    recommendations: [
+      "dbaeumer.vscode-eslint",
+      "esbenp.prettier-vscode",
+      "sfmc-bds.sfmc-module",
+      "connor4312.nodejs-testing",
+    ],
+  });
+  writeJson(path.join(target, ".vscode", "settings.json"), {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "eslint.useFlatConfig": true,
+    "eslint.validate": ["javascript", "typescript"],
+    "nodejs-testing.include": ["./test"],
+    "nodejs-testing.extensions": [
+      {
+        extensions: ["ts"],
+        parameters: ["--import", "@sfmc-bds/sdk/testing/minecraft-loader", "--import", "tsx/esm"],
+      },
+    ],
+  });
+  writeJson(path.join(target, ".vscode", "launch.json"), {
+    version: "0.2.0",
+    configurations: [
+      {
+        type: "node",
+        request: "launch",
+        name: "Debug Module Tests",
+        runtimeArgs: [
+          "--test",
+          "--import",
+          "@sfmc-bds/sdk/testing/minecraft-loader",
+          "--import",
+          "tsx/esm",
+        ],
+        args: ["${workspaceFolder}/test"],
+        cwd: "${workspaceFolder}",
+        console: "integratedTerminal",
+        sourceMaps: true,
+      },
+    ],
+  });
+  writeJson(path.join(target, ".vscode", "tasks.json"), {
+    version: "2.0.0",
+    tasks: [
+      {
+        type: "npm",
+        script: "typecheck",
+        group: "build",
+        problemMatcher: ["$tsc"],
+        label: "npm: typecheck",
+      },
+      {
+        type: "npm",
+        script: "test",
+        group: { kind: "test", isDefault: true },
+        problemMatcher: [],
+        label: "npm: test",
+      },
+      {
+        type: "npm",
+        script: "lint",
+        problemMatcher: ["$eslint-stylish"],
+        label: "npm: lint",
+      },
+    ],
+  });
+}
+
+function main() {
+  const { flags, positional } = parseArgs(process.argv.slice(2));
+
+  /* 模板清单查询:走 stdout 后立刻退出 —— 主流程不要走到此分支 */
+  if (flags.listTemplates) {
+    emitTemplateList();
+    return;
+  }
+
+  const folderId = positional[0];
+  if (!folderId) {
+    die(
+      "用法: new-module.mjs <id> [--name <名>] [--template minimal|db] [--official]\n" +
+        "  在空目录（单包根）运行；与 Tanya7z/sfmc-module-template 同构。"
+    );
+  }
+  if (!isValidFolderId(folderId)) {
+    die(`id 须为小写 kebab-case，例如 my-mod（收到: ${folderId}）`);
+  }
+  if (folderId.startsWith("feature-") || folderId.startsWith("core-")) {
+    die(`id 须为短名（不含 feature-/core- 前缀），例如 area 而非 feature-area`);
+  }
+  const target = resolveTargetDir(flags);
+  if (fs.existsSync(path.join(target, "sapi")) || fs.existsSync(path.join(target, "package.json"))) {
+    die(`目标已含模块骨架: ${target}（请用空目录）`);
+  }
+
+  const displayName = flags.name?.trim() || folderId;
+  const template = flags.template === "db" ? "db" : "minimal";
+  const official = Boolean(flags.official);
+  const pkgName = official ? `@sfmc-bds/module-${folderId}` : `@CHANGE_ME/sfmc-module-${folderId}`;
+
+  const sapiDir = path.join(target, "sapi");
+  const schemaRel =
+    "https://cdn.jsdelivr.net/gh/DogeLakeDev/ScriptsForMinecraftServer@latest/modules/sdk/%40sfmc-sdk/schemas/sapi-manifest.v2.schema.json";
+
+  writeJson(path.join(target, "package.json"), buildPackageJson(folderId, { official }));
+  writeJson(path.join(sapiDir, "manifest.json"), buildManifest(folderId, displayName, template, schemaRel));
+  writeJson(path.join(sapiDir, "tsconfig.json"), buildTsConfigStandalone());
+  writeJson(path.join(target, "tsconfig.json"), buildRootTsConfig());
+  writeText(path.join(sapiDir, "src", "index.ts"), buildIndexTs(folderId, displayName, pkgName));
+  writeText(path.join(target, "test", `${folderId}.test.ts`), buildExampleTest(folderId, displayName));
+  writeText(path.join(target, "eslint.config.js"), buildEslintConfigJs());
+  writeText(path.join(target, ".gitignore"), buildGitignore());
+  writeJson(path.join(target, ".prettierrc.json"), buildPrettierRc());
+  writeText(path.join(target, ".prettierignore"), buildPrettierIgnore());
+  writeText(path.join(target, "LICENSE"), buildLicense());
+  writeText(path.join(target, "README.md"), buildReadme(folderId, displayName, pkgName));
+  writeVscodeWorkspace(target);
+
+  console.log(`[new-module] 已创建 ${target}`);
+  console.log(`[new-module]   模式: 单包根`);
+  console.log(`[new-module]   npm: ${pkgName}`);
+  console.log(`[new-module]   manifest id: feature-${folderId}`);
+  console.log(`[new-module]   下一步:`);
+  console.log(`[new-module]     npm install && npm run typecheck && npm test && npm run lint`);
+  console.log(
+    `[new-module]     sfmc mod install ${folderId} --from dir:${target} --link  （在 SFMC 工作目录执行）`
+  );
+}
+
+main();