modsmith 0.6.2 → 0.7.1

package/docs/conformance/README.md

@@ -0,0 +1,62 @@
+# conformance 报告 · 2026-10-29
+
+四个生产包在 `modsmith conformance` 下的离线体检结果（`--server-mods` 对上了同一份服务器指纹）。
+报告是当时的机器产物，JSON 里每条都有 `id / level / subject / message`。
+
+| 包 | 通过 | 警告 | 失败 | 警告说明 |
+|---|---:|---:|---:|---|
+| Farmer's Delight 3.3.6 | 31 | 2 | 0 | 自定义配方类型（无统一 result） |
+| More Delight | 4 | 2 | 0 | manifest 没写 prompt；自定义配方 |
+| Supplementaries 4.0.2 | 16 | 20 | 0 | 自定义序列化器（2 条作物 alias 的 seed 指向自名） |
+| Twilight Forest 4.8.796 | 38 | 13 | 0 | travellers gear / scepter / uncrafting 等自定义配方；manifest 没写 prompt |
+
+**这些警告不是失败**：`craftRecipeViews` 只消费 shaped/shapeless 等标准形状；自定义
+序列化器由 sidesheet/discover 管线处理，不会伪装成“能做”。真正会让机器人做错事的
+项（假空气、楼梯形状、作物可挖、实体/boss）都是 0 fail。
+
+复跑：
+
+```bash
+modsmith conformance mods/<pack>.json --ids mods/<pack>-ids.json \
+  --server-mods mods --json docs/conformance/<pack>.json
+```
+
+只读 live 复核（需要服务器，不写世界）：
+
+```bash
+modsmith conformance mods/twilightforest-1.21.1-4.8.796.json \
+  --ids mods/twilightforest-1.21.1-4.8.796-ids.json \
+  --server-mods mods --live
+```
+
+2026-10-29 实跑结果：`通过 73，警告 13，失败 0`；`ModConform @ 1.21.1 overworld`，
+注册表 523 方块 / 80 实体。
+
+### 写世界采样（RCON，仅测试服）
+
+`--rcon-password` 给了才启用：在 `--x/--y/--z` 附近 forceload、setblock、tp，读真实
+bot 的 `blockAt().shapes`，再还原空气。它补的是离线注入检查看不到的那一层——
+“注册表里形状非空”不等于“客户端真的按这个状态显示”。
+
+```bash
+modsmith conformance mods/<pack>.json --ids mods/<pack>-ids.json \
+  --server-mods mods --live --port 25566 \
+  --rcon-port 25576 --rcon-password <pw> --x 400 --y 100 --z 400
+```
+
+dev 服（FD 3.3.6，2026-10-29）实跑：`通过 40，警告 9，失败 0`，报告见
+[farmers-delight-dev-live.json](farmers-delight-dev-live.json)。采样覆盖 7 个整块 +
+1 个实体（FD 没有楼梯/台阶）。
+
+同一套采样在 Supplementaries dev 包上验证了上下两态（报告未归档，因为该包没有走
+完整 onboard，未注册方块会正常报 R1 fail）：
+
+- `ash_bricks_stairs`：stairs bottom / top 各 `shape 2`，两态形状不同
+- `ash_bricks_slab`：slab bottom / top 各 `shape 1`，两态形状不同
+- 采样会先等 `blockAt().stateId` 进入 `ids` 里对应 `half` / `type` 的集合再读 shape；
+  只等固定 250ms 会把上一态读成当前态，误报“上下相同”
+
+这次采样抓到一个真实的 P0：`templateShapeId` 把状态索引算成了“第一个属性最快变化”，
+而 registry 实际是**最后一个属性最快**。结果 `oak_slab` 的 top 拿到下半砖形状、bottom
+拿到上半砖形状（楼梯同理），且 shape 非空，所有只查非空的检查都放过了。已修复并有
+`test/block-shapes.test.mjs` 的索引顺序回归。

package/docs/conformance/farmers-delight-1.21.1-3.3.6.json

@@ -0,0 +1,209 @@
+{
+ "pack": "farmersdelight",
+ "summary": {
+  "pass": 31,
+  "warn": 2,
+  "fail": 0,
+  "total": 33
+ },
+ "checks": [
+  {
+   "id": "M1",
+   "level": "pass",
+   "subject": "manifest",
+   "message": "schema/validate 通过"
+  },
+  {
+   "id": "M6",
+   "level": "warn",
+   "subject": "farmersdelight:cutting",
+   "message": "105 条自定义配方没有统一 result，配方视图不会消费（首条 farmersdelight:cutting/beef）"
+  },
+  {
+   "id": "M6",
+   "level": "warn",
+   "subject": "smithing_trim",
+   "message": "18 条自定义配方没有统一 result，配方视图不会消费（首条 minecraft:sentry_armor_trim_smithing_template_smithing_trim）"
+  },
+  {
+   "id": "M6",
+   "level": "pass",
+   "subject": "recipes",
+   "message": "craftRecipeViews 1027 条"
+  },
+  {
+   "id": "I5",
+   "level": "pass",
+   "subject": "server-mods",
+   "message": "服务器 mods 指纹对得上（7 个文件）"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:beetroot_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:budding_tomatoes",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:cabbage_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:cabbages",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:carrot_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:onion_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:onions",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:potato_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:pumpkin_pie",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:rice",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:rice_bag",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:rice_bale",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:rice_panicles",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:rice_roll_medley_block",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:stuffed_pumpkin_block",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:sweet_berry_cheesecake",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:tomato_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:tomatoes",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:tomatoes_on_rope",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_beetroots",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_cabbages",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_carrots",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_onions",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_potatoes",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_rice",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_tomatoes",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R6",
+   "level": "pass",
+   "subject": "recipes",
+   "message": "1027 条可消费配方"
+  },
+  {
+   "id": "R7",
+   "level": "pass",
+   "subject": "entities",
+   "message": "1 个实体已注入"
+  }
+ ]
+}

package/docs/conformance/farmers-delight-dev-live.json

@@ -0,0 +1,321 @@
+{
+ "pack": "farmersdelight",
+ "summary": {
+  "pass": 40,
+  "warn": 9,
+  "fail": 0,
+  "total": 49
+ },
+ "checks": [
+  {
+   "id": "M1",
+   "level": "pass",
+   "subject": "manifest",
+   "message": "schema/validate 通过"
+  },
+  {
+   "id": "M1.warn",
+   "level": "warn",
+   "subject": "prompt",
+   "message": "没有 prompt：提示词里只会写「装了 X」"
+  },
+  {
+   "id": "M5",
+   "level": "warn",
+   "subject": "onions",
+   "message": "seed farmersdelight:onions 不在 items 里"
+  },
+  {
+   "id": "M5",
+   "level": "warn",
+   "subject": "cabbages",
+   "message": "seed farmersdelight:cabbages 不在 items 里"
+  },
+  {
+   "id": "M5",
+   "level": "warn",
+   "subject": "tomatoes",
+   "message": "seed farmersdelight:tomatoes 不在 items 里"
+  },
+  {
+   "id": "M6",
+   "level": "warn",
+   "subject": "farmersdelight:cutting",
+   "message": "111 条自定义配方没有统一 result，配方视图不会消费（首条 farmersdelight:cutting/beef）"
+  },
+  {
+   "id": "M6",
+   "level": "warn",
+   "subject": "smithing_trim",
+   "message": "19 条自定义配方没有统一 result，配方视图不会消费（首条 minecraft:sentry_armor_trim_smithing_template_smithing_trim）"
+  },
+  {
+   "id": "M6",
+   "level": "pass",
+   "subject": "recipes",
+   "message": "craftRecipeViews 1267 条"
+  },
+  {
+   "id": "I1",
+   "level": "warn",
+   "subject": "farmersdelight:mug",
+   "message": "manifest 声明了但服务器没有注册这个物品（兼容/技术物品，通常按实测裁剪）"
+  },
+  {
+   "id": "I1",
+   "level": "warn",
+   "subject": "farmersdelight:skillet_cooking",
+   "message": "manifest 声明了但服务器没有注册这个物品（兼容/技术物品，通常按实测裁剪）"
+  },
+  {
+   "id": "I5",
+   "level": "pass",
+   "subject": "server-mods",
+   "message": "服务器 mods 指纹对得上（5 个文件）"
+  },
+  {
+   "id": "I6",
+   "level": "warn",
+   "subject": "ids",
+   "message": "2 项在导入时被剔除（见 ids.failed）"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:beetroot_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:budding_tomatoes",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:cabbage_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:cabbages",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:carrot_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:onion_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:onions",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:potato_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:pumpkin_pie",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:rice",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:rice_bag",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:rice_bale",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:rice_panicles",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:rice_roll_medley_block",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:stuffed_pumpkin_block",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:sweet_berry_cheesecake",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:tomato_crate",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:tomatoes",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:tomatoes_on_rope",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_beetroots",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_cabbages",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_carrots",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_onions",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_potatoes",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_rice",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R4",
+   "level": "pass",
+   "subject": "farmersdelight:wild_tomatoes",
+   "message": "作物可挖"
+  },
+  {
+   "id": "R6",
+   "level": "pass",
+   "subject": "recipes",
+   "message": "1267 条可消费配方"
+  },
+  {
+   "id": "R7",
+   "level": "pass",
+   "subject": "entities",
+   "message": "1 个实体已注入"
+  },
+  {
+   "id": "L2",
+   "level": "pass",
+   "subject": "farmersdelight:acacia_cabinet",
+   "message": "solid full block：已放置，shape 1"
+  },
+  {
+   "id": "L2",
+   "level": "pass",
+   "subject": "farmersdelight:apple_pie",
+   "message": "solid full block：已放置，shape 1"
+  },
+  {
+   "id": "L2",
+   "level": "pass",
+   "subject": "farmersdelight:bamboo_basket",
+   "message": "solid full block：已放置，shape 1"
+  },
+  {
+   "id": "L2",
+   "level": "pass",
+   "subject": "farmersdelight:bamboo_cabinet",
+   "message": "solid full block：已放置，shape 1"
+  },
+  {
+   "id": "L2",
+   "level": "pass",
+   "subject": "farmersdelight:beetroot_crate",
+   "message": "solid full block：已放置，shape 1"
+  },
+  {
+   "id": "L2",
+   "level": "pass",
+   "subject": "farmersdelight:birch_cabinet",
+   "message": "solid full block：已放置，shape 1"
+  },
+  {
+   "id": "L2",
+   "level": "pass",
+   "subject": "farmersdelight:budding_tomatoes",
+   "message": "solid full block：已放置，shape 1"
+  },
+  {
+   "id": "L2",
+   "level": "pass",
+   "subject": "farmersdelight:cabbage_crate",
+   "message": "solid full block：已放置，shape 1"
+  },
+  {
+   "id": "L3",
+   "level": "pass",
+   "subject": "farmersdelight:rotten_tomato",
+   "message": "召唤后 bot.entities 认得出名字"
+  }
+ ],
+ "live": {
+  "username": "ModConformDev",
+  "version": "1.21.1",
+  "dimension": "overworld",
+  "position": {
+   "x": 401,
+   "y": 60,
+   "z": 401
+  }
+ },
+ "registry": {
+  "blocks": 132,
+  "states": 2548,
+  "items": 185,
+  "entities": 1
+ }
+}

package/docs/conformance/moredelight-26.04.30-1.21.json

@@ -0,0 +1,47 @@
+{
+ "pack": "moredelight",
+ "summary": {
+  "pass": 4,
+  "warn": 2,
+  "fail": 0,
+  "total": 6
+ },
+ "checks": [
+  {
+   "id": "M1",
+   "level": "pass",
+   "subject": "manifest",
+   "message": "schema/validate 通过"
+  },
+  {
+   "id": "M1.warn",
+   "level": "warn",
+   "subject": "prompt",
+   "message": "没有 prompt：提示词里只会写「装了 X」"
+  },
+  {
+   "id": "M6",
+   "level": "warn",
+   "subject": "farmersdelight:cutting",
+   "message": "3 条自定义配方没有统一 result，配方视图不会消费（首条 casualness_delight:cutting/diced_potatoes）"
+  },
+  {
+   "id": "M6",
+   "level": "pass",
+   "subject": "recipes",
+   "message": "craftRecipeViews 30 条"
+  },
+  {
+   "id": "I5",
+   "level": "pass",
+   "subject": "server-mods",
+   "message": "服务器 mods 指纹对得上（7 个文件）"
+  },
+  {
+   "id": "R6",
+   "level": "pass",
+   "subject": "recipes",
+   "message": "30 条可消费配方"
+  }
+ ]
+}