modsmith 0.6.2 → 0.7.1

package/src/manifest-io.mjs

@@ -8,7 +8,7 @@ import { mkdirSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 
 /** 写 manifest；键顺序固定，diff 才好看。 */
-const ORDER = ['mod', 'version', 'namespace', 'source', 'blocks', 'items', 'foods', 'crops',
+const ORDER = ['mod', 'version', 'namespace', 'source', 'blocks', 'items', 'foods', 'bosses', 'crops',
   'recipes', 'names', 'containers', 'stations', 'prompt', 'candidates', 'unsupported'];
 
 export function writeManifest(file, manifest) {

package/src/onboard.mjs

@@ -1,5 +1,5 @@
 /**
- * modsmith onboard <jar> —— 把六步串成一条命令：
+ * modsmith onboard <jar> —— 把九步串成一条命令：
  *   inspect → calibrate → probe → verify → recipes → sidecar
  *
  * 每步的产物就是下一步的输入；哪步失败就停在哪（子命令自己 fatal 退出），绝不带病前进。
@@ -25,18 +25,21 @@
  *   resume?: boolean,         // 产物已存在的步骤标记 done（断点续跑）
  *   artifacts?: { manifest?: boolean, ids?: boolean, serverRecipes?: boolean },
  *   dryRecipes?: boolean,     // recipes 步骤不写回（默认写）
+ *   serializers?: string,     // 显式指定自定义序列化器 sidesheet（默认按 manifest.mod 找）
  *   noBuild?: boolean,        // sidecar 不编译
+ *   dump?: string | null,     // registry dump JSON：有就替代 calibrate（秒级）
  * }} opts
  * @returns {{ steps: Array<{id, title, argv: string[], done: boolean, blocked: boolean, reason: string}>, manifestPath: string, idsPath: string }}
  */
 export function onboardPlan(opts) {
   const {
     jar, pack, modsDir = './mods', server = null, skip = [], resume = false,
-    artifacts = {}, dryRecipes = false, noBuild = false,
+    artifacts = {}, dryRecipes = false, serializers = null, noBuild = false, dump = null,
   } = opts;
   const dir = modsDir.replace(/[\\/]+$/, '');
   const manifestPath = `${dir}/${pack}.json`;
   const idsPath = `${dir}/${pack}-ids.json`;
+  const conformancePath = `${dir}/${pack}-conformance.json`;
   // probe --scan-blocks 的证据落在这里，learn --infer 直接吃它。
   const probePath = `${dir}/${pack}-probe.json`;
   const srv = server ?? {};
@@ -64,13 +67,27 @@ export function onboardPlan(opts) {
     return { id, title, argv, done: Boolean(resume && done && !skipped), blocked, reason };
   };
 
+  const idStep = () => (dump
+    ? step('ids', '注册表 dump → ids（秒级）', [
+      'import-dump', dump, '--manifest', manifestPath, '--ids', idsPath,
+      ...(srv.serverMods ? ['--server-mods', String(srv.serverMods)] : []),
+      ...(srv.mcVersion ? ['--mc-version', String(srv.mcVersion)] : []),
+    ], Boolean(artifacts.ids), false)
+    : step('calibrate', '现场量数字 id', ['calibrate', manifestPath, '--ids', idsPath, ...(resume ? ['--resume'] : []), ...serverArgs], Boolean(artifacts.ids), true));
+
   return {
     manifestPath,
     idsPath,
     probePath,
     steps: [
       step('inspect', '静态提取清单', ['inspect', jar, '--out', modsDir, '--pack', pack], Boolean(artifacts.manifest), false),
-      step('calibrate', '现场量数字 id', ['calibrate', manifestPath, '--ids', idsPath, ...(resume ? ['--resume'] : []), ...serverArgs], Boolean(artifacts.ids), true),
+      // 清单先单独过一遍契约；ids 生成后再跑完整三层（含 registry）。
+      step('conformance-manifest', '清单契约检查', ['conformance', manifestPath, '--manifest-only'], false, false),
+      idStep(),
+      // 接包验收：ids 一落地就查 manifest/ids/registry 三层；不过就停，不让 probe
+      // 和 sidecar 继续消费坏数据。离线、不连服务器。
+      step('conformance', '接包验收（离线）', ['conformance', manifestPath, '--ids', idsPath,
+        '--json', conformancePath, ...(srv.serverMods ? ['--server-mods', String(srv.serverMods)] : [])], false, false),
       // --scan-blocks：把候选方块逐个右键一遍，记录开窗行为——这是 learn --infer 的证据。
       step('probe', '实测容器/站点 + 方块扫描', ['probe', manifestPath, '--pack', pack, '--mods-dir', modsDir,
         '--scan-blocks', '--out', probePath, ...serverArgs], Boolean(artifacts.probe), true),
@@ -83,6 +100,7 @@ export function onboardPlan(opts) {
       // --ids-all：同一台服上第二个包翻译时必然碰到别的包的物品（捕获是整服配方）。
       // 只有一份 ids 时它是空操作；多份时按指纹闸拒绝混用不同 jar 组合的量测。
       step('recipes', '服务端真配方翻进清单', ['recipes', manifestPath, '--ids', idsPath, '--ids-all', modsDir,
+        ...(serializers ? ['--serializers', serializers] : []),
         ...(srv.serverMods ? ['--server-mods', String(srv.serverMods)] : []),
         ...(dryRecipes ? [] : ['--write'])], Boolean(artifacts.serverRecipes), false),
       // 推断工作站：规则优先，不需要模型；有 probe 证据就用证据。