fix(bds-tools): 强化 occupancy 单测并同步 lock（超集并行 #85）

保留 #81 扫描不中断契约（try/catch），采用完整+残缺 header 覆盖；
同步 #84 后 package-lock 中 sdk/cli 的 0.2.0-beta.1。

Co-authored-by: Shiroha <Tanya7z@users.noreply.github.com>

Author: cursoragent

bds-tools/src/world-packs.ts

@@ -566,7 +566,8 @@ export type PackInstallPlan =
 
 /**
  * 读单目录占用事实（info 优先，否则 header）。
- * 读失败上抛，由调用方决定跳过或仍占文件夹名（uuid 置空）。
+ * info/header 解析失败返回 null；BOM 已由 readJsonFile 剥离。
+ * 其它异常上抛，由 scanDestOccupancy 决定仍占文件夹名（uuid 置空）。
  */
 export function readPackDirOccupancy(dir: string): {
   uuid: string;
@@ -590,7 +591,7 @@ export function readPackDirOccupancy(dir: string): {
   return null;
 }
 
-/** 扫描 destParent 下含 manifest 的目录占用 */
+/** 扫描 destParent 下含 manifest 的目录占用（占用事实唯一入口：readPackDirOccupancy） */
 export function scanDestOccupancy(destParent: string): DestOccupancy[] {
   const out: DestOccupancy[] = [];
   for (const dir of listPackDirsIn(destParent)) {
@@ -599,7 +600,7 @@ export function scanDestOccupancy(destParent: string): DestOccupancy[] {
       // DRY：单目录占用只走 readPackDirOccupancy，禁止再内联一份 info/header 分支
       facts = readPackDirOccupancy(dir);
     } catch {
-      /* manifest 不可读则占位 uuid 为空 */
+      /* manifest 不可读则占位 uuid 为空（#81 契约：扫描本身不因单目录失败而中断） */
     }
     out.push({
       folderName: path.basename(dir),

bds-tools/world-packs.test.mjs

@@ -283,24 +283,49 @@ describe("world-packs primitives", () => {
     assert.deepEqual(version, [2, 0, 1]);
   });
 
-  it("scanDestOccupancy 走 readPackDirOccupancy（含 kind）", async () => {
-    const { scanDestOccupancy } = await import("./dist/world-packs.js");
-    const parent = path.join(tmp, "occupancy-scan");
-    const dir = path.join(parent, "[BP] Occ");
-    const uuid = "cccccccc-cccc-cccc-cccc-cccccccccccc";
-    writeManifest(dir, {
-      name: "OccPack",
-      uuid,
-      version: [2, 3, 4],
-      type: "data",
+  it("scanDestOccupancy 走 readPackDirOccupancy（完整 + 残缺 header）", async () => {
+    const { scanDestOccupancy, readPackDirOccupancy } = await import("./dist/world-packs.js");
+    const dest = path.join(tmp, "occupancy-dry");
+    const fullDir = path.join(dest, "[RP] Full");
+    writeManifest(fullDir, {
+      name: "Full Pack",
+      uuid: "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
+      version: [2, 1, 0],
+      type: "resources",
     });
-    const rows = scanDestOccupancy(parent);
-    assert.equal(rows.length, 1);
-    assert.equal(rows[0].folderName, "[BP] Occ");
-    assert.equal(rows[0].uuid, uuid);
-    assert.deepEqual(rows[0].version, [2, 3, 4]);
-    assert.equal(rows[0].name, "OccPack");
-    assert.equal(rows[0].kind, "behavior");
+    const partialDir = path.join(dest, "[RP] Partial");
+    fs.mkdirSync(partialDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(partialDir, "manifest.json"),
+      JSON.stringify({
+        format_version: 2,
+        header: {
+          name: "Partial",
+          uuid: "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
+          version: [3, 0, 0],
+        },
+        modules: [],
+      })
+    );
+
+    const fullFacts = readPackDirOccupancy(fullDir);
+    assert.equal(fullFacts?.uuid, "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa");
+    assert.deepEqual(fullFacts?.version, [2, 1, 0]);
+    assert.equal(fullFacts?.name, "Full Pack");
+    assert.equal(fullFacts?.kind, "resource");
+
+    const partialFacts = readPackDirOccupancy(partialDir);
+    assert.equal(partialFacts?.uuid, "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb");
+    assert.deepEqual(partialFacts?.version, [3, 0, 0]);
+    assert.equal(partialFacts?.kind, undefined);
+
+    const occ = scanDestOccupancy(dest);
+    assert.equal(occ.length, 2);
+    const byUuid = new Map(occ.map((o) => [o.uuid, o]));
+    assert.equal(byUuid.get("aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa")?.name, "Full Pack");
+    assert.equal(byUuid.get("aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa")?.kind, "resource");
+    assert.equal(byUuid.get("bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb")?.version?.[0], 3);
+    assert.equal(byUuid.get("bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb")?.name, undefined);
   });
 
   it("decidePackInstallPlan 表驱动", async () => {