feat: metadata.tracked 类型、validateConfig 校验与 mergeConfig 深合并

tests/core/config.test.ts

@@ -65,7 +65,9 @@ describe("loadConfig", () => {
     await mkdir(runeDir, { recursive: true });
     await writeFile(
       join(runeDir, "config.yaml"),
-      `stages:
+      `metadata:
+  tracked: false
+stages:
   plan:
     documents:
       - name: spec
@@ -169,6 +171,56 @@ describe("validateConfig", () => {
     };
     expect(() => validateConfig(config)).not.toThrow();
   });
+
+  it("tracked=true 时 plan.documents 必须包含 task 文档", () => {
+    const config: RuneConfig = {
+      stages: {
+        plan: {
+          documents: [{ name: "design", prompt: "生成设计" }],
+        },
+      },
+      metadata: { tracked: true },
+    };
+    expect(() => validateConfig(config)).toThrow(ConfigError);
+  });
+
+  it("tracked=true 且 plan.documents 包含 task 时不报错", () => {
+    const config: RuneConfig = {
+      stages: {
+        plan: {
+          documents: [
+            { name: "design", prompt: "生成设计" },
+            { name: "task", prompt: "生成任务" },
+          ],
+        },
+      },
+      metadata: { tracked: true },
+    };
+    expect(() => validateConfig(config)).not.toThrow();
+  });
+
+  it("tracked=false 时 plan.documents 不包含 task 也不报错", () => {
+    const config: RuneConfig = {
+      stages: {
+        plan: {
+          documents: [{ name: "design", prompt: "生成设计" }],
+        },
+      },
+      metadata: { tracked: false },
+    };
+    expect(() => validateConfig(config)).not.toThrow();
+  });
+
+  it("tracked 未配置时等同于 false，不强制要求 task 文档", () => {
+    const config: RuneConfig = {
+      stages: {
+        plan: {
+          documents: [{ name: "design", prompt: "生成设计" }],
+        },
+      },
+    };
+    expect(() => validateConfig(config)).not.toThrow();
+  });
 });
 
 describe("mergeConfig 保留 metadata", () => {
@@ -191,7 +243,7 @@ describe("mergeConfig 保留 metadata", () => {
     }
   });
 
-  it("无 metadata 时不设置该字段", async () => {
+  it("无 metadata 时保留默认 metadata（tracked: true）", async () => {
     const tmpDir = join(import.meta.dir, "__tmp_config_nometa_test__");
     await mkdir(tmpDir, { recursive: true });
     try {
@@ -199,7 +251,42 @@ describe("mergeConfig 保留 metadata", () => {
       await mkdir(join(tmpDir, ".rune"), { recursive: true });
       await writeFile(configPath, `stages:\n  discuss:\n    prompt: "测试"\n`);
       const config = await loadConfig(tmpDir);
-      expect(config.metadata).toBeUndefined();
+      expect(config.metadata?.tracked).toBe(true);
+    } finally {
+      await rm(tmpDir, { recursive: true, force: true });
+    }
+  });
+
+  it("用户 metadata 与默认 metadata 深合并", async () => {
+    const tmpDir = join(import.meta.dir, "__tmp_config_deep_merge__");
+    await mkdir(tmpDir, { recursive: true });
+    try {
+      const configPath = join(tmpDir, ".rune", "config.yaml");
+      await mkdir(join(tmpDir, ".rune"), { recursive: true });
+      await writeFile(
+        configPath,
+        `metadata:\n  command: "rune"\nstages:\n  discuss:\n    prompt: "测试"\n`,
+      );
+      const config = await loadConfig(tmpDir);
+      expect(config.metadata?.command).toBe("rune");
+      expect(config.metadata?.tracked).toBe(true);
+    } finally {
+      await rm(tmpDir, { recursive: true, force: true });
+    }
+  });
+
+  it("用户 metadata.tracked 显式覆盖默认值", async () => {
+    const tmpDir = join(import.meta.dir, "__tmp_config_tracked_override__");
+    await mkdir(tmpDir, { recursive: true });
+    try {
+      const configPath = join(tmpDir, ".rune", "config.yaml");
+      await mkdir(join(tmpDir, ".rune"), { recursive: true });
+      await writeFile(
+        configPath,
+        `metadata:\n  tracked: false\nstages:\n  discuss:\n    prompt: "测试"\n`,
+      );
+      const config = await loadConfig(tmpDir);
+      expect(config.metadata?.tracked).toBe(false);
     } finally {
       await rm(tmpDir, { recursive: true, force: true });
     }