pi-shepherd 0.1.1 → 0.2.0

package/node_modules/@pi-atelier/shared-utils/src/__tests__/project-config-edge.test.ts

@@ -1,138 +0,0 @@
-/**
- * 项目级配置边界情况测试
- * - 文件损坏/空配置/未知字段
- * - 不同项目目录隔离性
- * - 值相同时不报冲突
- * - 类型不匹配的各种情况
- */
-
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-	clearProjectSettingsCache,
-	detectConfigConflicts,
-	getEffectiveConfig,
-	validateConfigSchema,
-} from "../project-config";
-
-const TEST_DIR = join(tmpdir(), "pi-shared-utils-edge-test");
-
-function createProjectSettings(dir: string, content: Record<string, any>) {
-	const piDir = join(dir, ".pi");
-	mkdirSync(piDir, { recursive: true });
-	writeFileSync(join(piDir, "settings.json"), JSON.stringify(content, null, 2));
-}
-
-function cleanupDir(dir: string) {
-	if (existsSync(dir)) rmSync(dir, { recursive: true });
-}
-
-const SETTINGS_PATH = join(require("node:os").homedir(), ".pi/agent/settings.json");
-
-function mockGlobalSettings(content: Record<string, any>) {
-	const original = readFileSync(SETTINGS_PATH, "utf-8");
-	writeFileSync(SETTINGS_PATH, JSON.stringify(content, null, 2));
-	return () => writeFileSync(SETTINGS_PATH, original);
-}
-
-let restoreGlobal: (() => void) | undefined;
-
-describe("边界情况与隔离性", () => {
-	beforeEach(() => {
-		cleanupDir(TEST_DIR);
-		clearProjectSettingsCache();
-		mkdirSync(TEST_DIR, { recursive: true });
-		restoreGlobal = mockGlobalSettings({});
-	});
-	afterEach(() => {
-		restoreGlobal?.();
-		cleanupDir(TEST_DIR);
-	});
-
-	it("项目配置为空对象时不影响默认值", () => {
-		createProjectSettings(TEST_DIR, {
-			context: {},
-		});
-
-		const defaults = { distillThreshold: 5000, agingThreshold: 10 };
-		const result = getEffectiveConfig("context", defaults, TEST_DIR);
-		expect(typeof result.config.distillThreshold).toBe("number");
-		expect(typeof result.config.agingThreshold).toBe("number");
-	});
-
-	it("项目配置文件损坏（无效 JSON）时回退到默认值", () => {
-		const piDir = join(TEST_DIR, ".pi");
-		mkdirSync(piDir, { recursive: true });
-		writeFileSync(join(piDir, "settings.json"), "{ invalid json ");
-
-		const defaults = { distillThreshold: 5000 };
-		const result = getEffectiveConfig("context", defaults, TEST_DIR);
-		expect(result.config.distillThreshold).toBe(5000);
-	});
-
-	it("项目配置含未知字段时保留（不丢弃）", () => {
-		createProjectSettings(TEST_DIR, {
-			context: { distillThreshold: 8000, unknownField: "hello" },
-		});
-
-		const defaults = { distillThreshold: 5000, agingThreshold: 10 };
-		const result = getEffectiveConfig("context", defaults, TEST_DIR);
-		expect(result.config.distillThreshold).toBe(8000);
-		expect(typeof result.config.agingThreshold).toBe("number");
-		expect((result.config as any).unknownField).toBe("hello");
-	});
-
-	it("不同项目目录的配置互不影响", () => {
-		const dirA = join(TEST_DIR, "project-a");
-		const dirB = join(TEST_DIR, "project-b");
-		mkdirSync(dirA, { recursive: true });
-		mkdirSync(dirB, { recursive: true });
-
-		createProjectSettings(dirA, { context: { distillThreshold: 1000 } });
-		createProjectSettings(dirB, { context: { distillThreshold: 2000 } });
-
-		const defaults = { distillThreshold: 5000 };
-		const resultA = getEffectiveConfig("context", defaults, dirA);
-		const resultB = getEffectiveConfig("context", defaults, dirB);
-
-		expect(resultA.config.distillThreshold).toBe(1000);
-		expect(resultB.config.distillThreshold).toBe(2000);
-	});
-
-	it("项目值与全局值相同时不产生冲突", () => {
-		const defaults = { distillThreshold: 5000 };
-		const globalResult = getEffectiveConfig("context", defaults, TEST_DIR);
-
-		createProjectSettings(TEST_DIR, {
-			context: { distillThreshold: globalResult.config.distillThreshold },
-		});
-
-		const conflicts = detectConfigConflicts(TEST_DIR);
-		const contextConflicts = conflicts.filter((c) => c.section === "context" && c.key === "distillThreshold");
-		expect(contextConflicts).toHaveLength(0);
-	});
-
-	it("validateConfigSchema 忽略 defaults 中不存在的字段", () => {
-		createProjectSettings(TEST_DIR, {
-			context: { distillThreshold: 8000, extraField: "surprise" },
-		});
-
-		const errors = validateConfigSchema("context", { distillThreshold: 5000 }, TEST_DIR);
-		expect(errors).toEqual([]);
-	});
-
-	it("数组字段类型不匹配时报错", () => {
-		createProjectSettings(TEST_DIR, {
-			context: { tags: "not-an-array" },
-		});
-
-		const defaults = { tags: ["default"] };
-		const errors = validateConfigSchema("context", defaults, TEST_DIR);
-		expect(errors.length).toBeGreaterThan(0);
-		expect(errors[0].key).toBe("tags");
-		expect(errors[0].expectedType).toBe("array");
-		expect(errors[0].actualType).toBe("string");
-	});
-});

package/node_modules/@pi-atelier/shared-utils/src/__tests__/project-config.test.ts

@@ -1,257 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import {
-	clearProjectSettingsCache,
-	detectConfigConflicts,
-	getEffectiveConfig,
-	validateConfigSchema,
-} from "../project-config";
-import { getDisabledMcpServers, getEnabledTools } from "../project-tools";
-
-const TEST_DIR = join(tmpdir(), "pi-shared-utils-test");
-
-// ── 测试辅助 ────────────────────────────────────────────
-
-function createProjectSettings(dir: string, content: Record<string, any>) {
-	const piDir = join(dir, ".pi");
-	mkdirSync(piDir, { recursive: true });
-	writeFileSync(join(piDir, "settings.json"), JSON.stringify(content, null, 2));
-}
-
-function cleanupDir(dir: string) {
-	if (existsSync(dir)) rmSync(dir, { recursive: true });
-}
-
-const SETTINGS_PATH = join(require("node:os").homedir(), ".pi/agent/settings.json");
-
-/** 临时替换全局 settings.json 内容（用于测试三层合并） */
-function mockGlobalSettings(content: Record<string, any>) {
-	const original = readFileSync(SETTINGS_PATH, "utf-8");
-	writeFileSync(SETTINGS_PATH, JSON.stringify(content, null, 2));
-	return () => writeFileSync(SETTINGS_PATH, original);
-}
-
-// ── 测试 ─────────────────────────────────────────────────
-
-describe("project-config", () => {
-	beforeEach(() => {
-		cleanupDir(TEST_DIR);
-		clearProjectSettingsCache();
-		mkdirSync(TEST_DIR, { recursive: true });
-	});
-	afterEach(() => {
-		cleanupDir(TEST_DIR);
-	});
-
-	describe("getEffectiveConfig", () => {
-		it("无项目配置时返回默认值", () => {
-			const defaults = { threshold: 5000, enabled: true };
-			const result = getEffectiveConfig("nonexistent-section", defaults, TEST_DIR);
-			expect(result.config.threshold).toBe(5000);
-			expect(result.config.enabled).toBe(true);
-		});
-
-		it("项目配置覆盖默认值", () => {
-			createProjectSettings(TEST_DIR, {
-				context: { distillThreshold: 8000 },
-			});
-
-			const defaults = { distillThreshold: 5000, agingThreshold: 20 };
-			const result = getEffectiveConfig("context", defaults, TEST_DIR);
-			expect(result.config.distillThreshold).toBe(8000);
-			expect(result.config.agingThreshold).toBe(20);
-			expect(result.sources.distillThreshold).toBe("project");
-		});
-
-		it("嵌套对象 deep merge", () => {
-			createProjectSettings(TEST_DIR, {
-				retry: { provider: { timeoutMs: 120000 } },
-			});
-
-			const defaults = {
-				enabled: true,
-				maxRetries: 3,
-				provider: { timeoutMs: 600000, maxRetries: 2 },
-			};
-			const result = getEffectiveConfig("retry", defaults, TEST_DIR);
-			expect(result.config.provider.timeoutMs).toBe(120000);
-			expect(result.config.provider.maxRetries).toBe(2);
-			expect(result.config.enabled).toBe(true);
-		});
-	});
-
-	describe("detectConfigConflicts", () => {
-		it("无项目配置时返回空", () => {
-			const conflicts = detectConfigConflicts(TEST_DIR);
-			expect(conflicts).toEqual([]);
-		});
-
-		it("检测到全局与项目值不同的冲突", () => {
-			createProjectSettings(TEST_DIR, {
-				context: { distillThreshold: 500 },
-			});
-
-			const conflicts = detectConfigConflicts(TEST_DIR);
-			// 只检查格式正确，不硬编码全局值
-			if (conflicts.length > 0) {
-				expect(conflicts[0].section).toBe("context");
-				expect(conflicts[0].key).toBe("distillThreshold");
-				expect(conflicts[0].projectValue).toBe(500);
-			}
-		});
-
-		it("跳过 prompts 和 skills 段", () => {
-			createProjectSettings(TEST_DIR, {
-				prompts: ["prompts/"],
-				skills: ["+skills/test/SKILL.md"],
-			});
-
-			const conflicts = detectConfigConflicts(TEST_DIR);
-			expect(conflicts).toEqual([]);
-		});
-	});
-
-	describe("getEnabledTools", () => {
-		it("无项目配置时返回全部工具", () => {
-			const tools = getEnabledTools(["vision_analyze", "payload_analyze", "code_search"], TEST_DIR);
-			expect(tools).toEqual(["vision_analyze", "payload_analyze", "code_search"]);
-		});
-
-		it("禁用指定工具", () => {
-			createProjectSettings(TEST_DIR, {
-				tools: { disabled: ["payload_analyze"] },
-			});
-
-			const tools = getEnabledTools(["vision_analyze", "payload_analyze", "code_search"], TEST_DIR);
-			expect(tools).toEqual(["vision_analyze", "code_search"]);
-		});
-
-		it("额外启用工具", () => {
-			createProjectSettings(TEST_DIR, {
-				tools: { enabled: ["custom_tool"] },
-			});
-
-			const tools = getEnabledTools(["vision_analyze"], TEST_DIR);
-			expect(tools).toContain("vision_analyze");
-			expect(tools).toContain("custom_tool");
-		});
-
-		it("同时禁用和启用", () => {
-			createProjectSettings(TEST_DIR, {
-				tools: { disabled: ["payload_analyze"], enabled: ["custom_tool"] },
-			});
-
-			const tools = getEnabledTools(["vision_analyze", "payload_analyze"], TEST_DIR);
-			expect(tools).toEqual(["vision_analyze", "custom_tool"]);
-		});
-	});
-
-	describe("数组合并策略", () => {
-		it("默认：数组字段被项目级替换", () => {
-			createProjectSettings(TEST_DIR, {
-				test: { items: [4, 5, 6] },
-			});
-
-			const defaults = { items: [1, 2, 3] };
-			const result = getEffectiveConfig("test", defaults, TEST_DIR);
-			expect(result.config.items).toEqual([4, 5, 6]);
-		});
-
-		it("concatMerge 策略：数组字段做追加而非替换", () => {
-			createProjectSettings(TEST_DIR, {
-				shepherd: {
-					rules: [{ comment: "项目规则", hook: "tool_call", tool: "bash", action: "notify", reason: "test" }],
-				},
-			});
-
-			const defaults = {
-				rules: [{ comment: "全局规则", hook: "tool_call", tool: "bash", action: "block", reason: "test" }],
-			};
-			const result = getEffectiveConfig("shepherd", defaults, TEST_DIR, {
-				arrayMerge: "concat",
-			});
-			// 全局 + 项目 追加
-			expect(result.config.rules).toHaveLength(2);
-			expect(result.config.rules[0].comment).toBe("全局规则");
-			expect(result.config.rules[1].comment).toBe("项目规则");
-		});
-
-		it("concatMerge 策略：无项目级配置时不改变数组", () => {
-			const defaults = {
-				rules: [{ comment: "唯一规则" }],
-			};
-			const result = getEffectiveConfig("shepherd", defaults, TEST_DIR, {
-				arrayMerge: "concat",
-			});
-			expect(result.config.rules).toHaveLength(1);
-			expect(result.config.rules[0].comment).toBe("唯一规则");
-		});
-	});
-
-	describe("validateConfigSchema", () => {
-		it("类型一致时无错误", () => {
-			createProjectSettings(TEST_DIR, {
-				context: { distillThreshold: 8000 },
-			});
-
-			const errors = validateConfigSchema("context", { distillThreshold: 5000 }, TEST_DIR);
-			expect(errors).toEqual([]);
-		});
-
-		it("类型不一致时报错", () => {
-			createProjectSettings(TEST_DIR, {
-				context: { distillThreshold: "8000" },
-			});
-
-			const errors = validateConfigSchema("context", { distillThreshold: 5000 }, TEST_DIR);
-			expect(errors.length).toBeGreaterThan(0);
-			expect(errors[0].key).toBe("distillThreshold");
-			expect(errors[0].expectedType).toBe("number");
-			expect(errors[0].actualType).toBe("string");
-		});
-
-		it("无项目配置时无错误", () => {
-			const errors = validateConfigSchema("context", { distillThreshold: 5000 }, TEST_DIR);
-			expect(errors).toEqual([]);
-		});
-
-		it("嵌套对象类型不一致", () => {
-			createProjectSettings(TEST_DIR, {
-				retry: { provider: "not-an-object" },
-			});
-
-			const defaults = { provider: { timeoutMs: 60000 } };
-			const errors = validateConfigSchema("retry", defaults, TEST_DIR);
-			expect(errors.length).toBeGreaterThan(0);
-			expect(errors[0].key).toBe("provider");
-		});
-	});
-
-	describe("getDisabledMcpServers", () => {
-		it("无配置时返回空", () => {
-			const restore = mockGlobalSettings({});
-			try {
-				const disabled = getDisabledMcpServers(TEST_DIR);
-				expect(disabled).toEqual([]);
-			} finally {
-				restore();
-			}
-		});
-
-		it("返回禁用的 MCP 服务器", () => {
-			const restore = mockGlobalSettings({});
-			try {
-				createProjectSettings(TEST_DIR, {
-					mcp: { disabled: ["code-graph", "glm-web-search"] },
-				});
-
-				const disabled = getDisabledMcpServers(TEST_DIR);
-				expect(disabled).toEqual(["code-graph", "glm-web-search"]);
-			} finally {
-				restore();
-			}
-		});
-	});
-});

package/node_modules/@pi-atelier/shared-utils/src/__tests__/project-tools-mcp.test.ts

@@ -1,189 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { SETTINGS_PATH } from "../paths";
-import { clearProjectSettingsCache } from "../project-config";
-import { getDisabledTools, isToolDisabled } from "../project-tools";
-
-const TEST_DIR = join(tmpdir(), "pi-shared-utils-mcp-tools-test");
-
-// ── 测试辅助 ────────────────────────────────────────────
-
-function createProjectSettings(dir: string, content: Record<string, any>) {
-	const piDir = join(dir, ".pi");
-	mkdirSync(piDir, { recursive: true });
-	writeFileSync(join(piDir, "settings.json"), JSON.stringify(content, null, 2));
-}
-
-function cleanupDir(dir: string) {
-	if (existsSync(dir)) rmSync(dir, { recursive: true });
-}
-
-/** 临时替换全局 settings.json 内容 */
-function mockGlobalSettings(content: Record<string, any>) {
-	const original = readFileSync(SETTINGS_PATH, "utf-8");
-	writeFileSync(SETTINGS_PATH, JSON.stringify(content, null, 2));
-	return () => writeFileSync(SETTINGS_PATH, original);
-}
-
-// ── getDisabledTools ────────────────────────────────────
-
-describe("getDisabledTools — 工具级禁用", () => {
-	beforeEach(() => {
-		cleanupDir(TEST_DIR);
-		clearProjectSettingsCache();
-		mkdirSync(TEST_DIR, { recursive: true });
-	});
-	afterEach(() => {
-		cleanupDir(TEST_DIR);
-	});
-
-	it("无配置时返回空数组", () => {
-		const restore = mockGlobalSettings({});
-		try {
-			const result = getDisabledTools(TEST_DIR);
-			expect(result).toEqual([]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("全局工具级禁用", () => {
-		const restore = mockGlobalSettings({ mcp: { tools: { disabled: ["godot_export_build"] } } });
-		try {
-			const result = getDisabledTools(TEST_DIR);
-			expect(result).toEqual(["godot_export_build"]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("全局 + 项目 concat", () => {
-		const restore = mockGlobalSettings({ mcp: { tools: { disabled: ["godot_export_build"] } } });
-		try {
-			createProjectSettings(TEST_DIR, { mcp: { tools: { disabled: ["godot_launch_editor"] } } });
-			const result = getDisabledTools(TEST_DIR);
-			expect(result).toEqual(["godot_export_build", "godot_launch_editor"]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("项目 enabled 白名单覆盖", () => {
-		const restore = mockGlobalSettings({ mcp: { tools: { disabled: ["godot_export_build", "godot_launch_editor"] } } });
-		try {
-			createProjectSettings(TEST_DIR, { mcp: { tools: { enabled: ["godot_launch_editor"] } } });
-			const result = getDisabledTools(TEST_DIR);
-			expect(result).toEqual(["godot_export_build"]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("去重", () => {
-		const restore = mockGlobalSettings({ mcp: { tools: { disabled: ["godot_export_build"] } } });
-		try {
-			createProjectSettings(TEST_DIR, { mcp: { tools: { disabled: ["godot_export_build"] } } });
-			const result = getDisabledTools(TEST_DIR);
-			expect(result).toEqual(["godot_export_build"]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("与 server 级 disabled 独立", () => {
-		const restore = mockGlobalSettings({ mcp: { disabled: ["godot"], tools: { disabled: ["glm_web_search"] } } });
-		try {
-			const result = getDisabledTools(TEST_DIR);
-			expect(result).toEqual(["glm_web_search"]);
-		} finally {
-			restore();
-		}
-	});
-});
-
-// ── isToolDisabled — glob 匹配 ──────────────────────────
-
-describe("isToolDisabled — glob 匹配", () => {
-	beforeEach(() => {
-		cleanupDir(TEST_DIR);
-		clearProjectSettingsCache();
-		mkdirSync(TEST_DIR, { recursive: true });
-	});
-	afterEach(() => {
-		cleanupDir(TEST_DIR);
-	});
-
-	it("精确匹配", () => {
-		const restore = mockGlobalSettings({ mcp: { tools: { disabled: ["godot_launch_editor"] } } });
-		try {
-			expect(isToolDisabled("godot_launch_editor", TEST_DIR)).toBe(true);
-			expect(isToolDisabled("godot_run_project", TEST_DIR)).toBe(false);
-		} finally {
-			restore();
-		}
-	});
-
-	it("glob * 匹配", () => {
-		const restore = mockGlobalSettings({ mcp: { tools: { disabled: ["godot_export_*"] } } });
-		try {
-			expect(isToolDisabled("godot_export_build", TEST_DIR)).toBe(true);
-			expect(isToolDisabled("godot_export_list_presets", TEST_DIR)).toBe(true);
-			expect(isToolDisabled("godot_run_project", TEST_DIR)).toBe(false);
-		} finally {
-			restore();
-		}
-	});
-
-	it("多个 * 通配符", () => {
-		const restore = mockGlobalSettings({ mcp: { tools: { disabled: ["godot_*_editor"] } } });
-		try {
-			expect(isToolDisabled("godot_launch_editor", TEST_DIR)).toBe(true);
-			expect(isToolDisabled("godot_game_bridge_uninstall", TEST_DIR)).toBe(false);
-		} finally {
-			restore();
-		}
-	});
-
-	it("混合精确和 glob", () => {
-		const restore = mockGlobalSettings({ mcp: { tools: { disabled: ["godot_export_*", "godot_launch_editor"] } } });
-		try {
-			expect(isToolDisabled("godot_export_build", TEST_DIR)).toBe(true);
-			expect(isToolDisabled("godot_launch_editor", TEST_DIR)).toBe(true);
-			expect(isToolDisabled("godot_run_project", TEST_DIR)).toBe(false);
-		} finally {
-			restore();
-		}
-	});
-
-	it("无禁用时全部通过", () => {
-		const restore = mockGlobalSettings({});
-		try {
-			expect(isToolDisabled("godot_anything", TEST_DIR)).toBe(false);
-		} finally {
-			restore();
-		}
-	});
-
-	it("项目级 enabled 覆盖全局 disabled", () => {
-		const restore = mockGlobalSettings({ mcp: { tools: { disabled: ["godot_export_*"] } } });
-		try {
-			createProjectSettings(TEST_DIR, { mcp: { tools: { enabled: ["godot_export_*"] } } });
-			expect(isToolDisabled("godot_export_build", TEST_DIR)).toBe(false);
-		} finally {
-			restore();
-		}
-	});
-
-	it("特殊字符在模式中被正确转义", () => {
-		const restore = mockGlobalSettings({ mcp: { tools: { disabled: ["code_graph_pi-core_*"] } } });
-		try {
-			// "-" 不是 glob 特殊字符，应该精确匹配
-			expect(isToolDisabled("code_graph_pi-core_semantic_code_search", TEST_DIR)).toBe(true);
-			expect(isToolDisabled("code_graph_pi_core_semantic_code_search", TEST_DIR)).toBe(false);
-		} finally {
-			restore();
-		}
-	});
-});