pi-shepherd 0.1.1 → 0.2.0

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

@@ -1,204 +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 {
-	getDisabledMcpServers,
-	getDisabledTools,
-	getEffectiveToolFilter,
-	getEnabledTools,
-	isToolDisabled,
-} from "../project-tools";
-
-const TEST_DIR = join(tmpdir(), "pi-shared-utils-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);
-}
-
-// ── 测试 ─────────────────────────────────────────────────
-
-describe("getDisabledMcpServers — 三层合并", () => {
-	beforeEach(() => {
-		cleanupDir(TEST_DIR);
-		clearProjectSettingsCache();
-		mkdirSync(TEST_DIR, { recursive: true });
-	});
-	afterEach(() => {
-		cleanupDir(TEST_DIR);
-	});
-
-	it("无项目配置时，只返回全局禁用列表", () => {
-		const restore = mockGlobalSettings({ mcp: { disabled: ["global-server"] } });
-		try {
-			const result = getDisabledMcpServers(TEST_DIR);
-			expect(result).toEqual(["global-server"]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("无全局无项目配置时，返回空数组", () => {
-		const restore = mockGlobalSettings({});
-		try {
-			const result = getDisabledMcpServers(TEST_DIR);
-			expect(result).toEqual([]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("全局 + 项目 concat 合并", () => {
-		const restore = mockGlobalSettings({ mcp: { disabled: ["unstable"] } });
-		try {
-			createProjectSettings(TEST_DIR, { mcp: { disabled: ["godot"] } });
-			const result = getDisabledMcpServers(TEST_DIR);
-			expect(result).toEqual(["unstable", "godot"]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("全局和项目有重复时去重", () => {
-		const restore = mockGlobalSettings({ mcp: { disabled: ["shared-server"] } });
-		try {
-			createProjectSettings(TEST_DIR, { mcp: { disabled: ["shared-server", "extra"] } });
-			const result = getDisabledMcpServers(TEST_DIR);
-			expect(result).toEqual(["shared-server", "extra"]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("只有项目级配置时", () => {
-		const restore = mockGlobalSettings({});
-		try {
-			createProjectSettings(TEST_DIR, { mcp: { disabled: ["godot", "glm"] } });
-			const result = getDisabledMcpServers(TEST_DIR);
-			expect(result).toEqual(["godot", "glm"]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("全局禁用 + 项目 enabled 白名单覆盖", () => {
-		const restore = mockGlobalSettings({ mcp: { disabled: ["godot", "code-graph", "glm-web-search"] } });
-		try {
-			// 项目启用 godot，其他保持禁用
-			createProjectSettings(TEST_DIR, { mcp: { enabled: ["godot"] } });
-			const result = getDisabledMcpServers(TEST_DIR);
-			expect(result).toEqual(["code-graph", "glm-web-search"]);
-			expect(result).not.toContain("godot");
-		} finally {
-			restore();
-		}
-	});
-
-	it("全局禁用 + 项目 enabled + 项目 disabled 同时生效", () => {
-		const restore = mockGlobalSettings({ mcp: { disabled: ["godot", "code-graph"] } });
-		try {
-			createProjectSettings(TEST_DIR, {
-				mcp: {
-					enabled: ["godot"], // 启用 godot（从 disabled 中移除）
-					disabled: ["glm-web-search"], // 额外禁用
-				},
-			});
-			const result = getDisabledMcpServers(TEST_DIR);
-			expect(result).toEqual(["code-graph", "glm-web-search"]);
-			expect(result).not.toContain("godot");
-		} finally {
-			restore();
-		}
-	});
-});
-
-describe("getEffectiveToolFilter — 三层合并", () => {
-	beforeEach(() => {
-		cleanupDir(TEST_DIR);
-		clearProjectSettingsCache();
-		mkdirSync(TEST_DIR, { recursive: true });
-	});
-	afterEach(() => {
-		cleanupDir(TEST_DIR);
-	});
-
-	it("无配置时返回空 filter", () => {
-		const filter = getEffectiveToolFilter(TEST_DIR);
-		expect(filter.disabled).toBeUndefined();
-		expect(filter.enabled).toBeUndefined();
-	});
-
-	it("全局 + 项目 concat", () => {
-		const restore = mockGlobalSettings({ tools: { disabled: ["global-tool"] } });
-		try {
-			createProjectSettings(TEST_DIR, { tools: { disabled: ["project-tool"] } });
-			const filter = getEffectiveToolFilter(TEST_DIR);
-			expect(filter.disabled).toEqual(["global-tool", "project-tool"]);
-		} finally {
-			restore();
-		}
-	});
-});
-
-describe("getEnabledTools — 三层合并", () => {
-	beforeEach(() => {
-		cleanupDir(TEST_DIR);
-		clearProjectSettingsCache();
-		mkdirSync(TEST_DIR, { recursive: true });
-	});
-	afterEach(() => {
-		cleanupDir(TEST_DIR);
-	});
-
-	const ALL_TOOLS = ["read", "write", "edit", "bash", "grep", "find"];
-
-	it("无过滤时返回全部工具", () => {
-		const result = getEnabledTools(ALL_TOOLS, TEST_DIR);
-		expect(result).toEqual(ALL_TOOLS);
-	});
-
-	it("全局禁用 + 项目禁用 concat", () => {
-		const restore = mockGlobalSettings({ tools: { disabled: ["bash"] } });
-		try {
-			createProjectSettings(TEST_DIR, { tools: { disabled: ["grep"] } });
-			const result = getEnabledTools(ALL_TOOLS, TEST_DIR);
-			expect(result).toEqual(["read", "write", "edit", "find"]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("全局和项目都禁用同一个工具时去重", () => {
-		const restore = mockGlobalSettings({ tools: { disabled: ["bash"] } });
-		try {
-			createProjectSettings(TEST_DIR, { tools: { disabled: ["bash", "edit"] } });
-			const result = getEnabledTools(ALL_TOOLS, TEST_DIR);
-			expect(result).toEqual(["read", "write", "grep", "find"]);
-		} finally {
-			restore();
-		}
-	});
-
-	it("enabled 补充不在 allTools 里的工具", () => {
-		createProjectSettings(TEST_DIR, { tools: { enabled: ["custom-tool"] } });
-		const result = getEnabledTools(ALL_TOOLS, TEST_DIR);
-		expect(result).toContain("custom-tool");
-	});
-});

package/node_modules/@pi-atelier/shared-utils/src/__tests__/settings-backup-advanced.test.ts

@@ -1,269 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-
-const TEST_DIR = join(tmpdir(), `pi-settings-adv-test-${process.pid}`);
-const TEST_SETTINGS = join(TEST_DIR, "settings.json");
-const TEST_BACKUP_DIR = join(TEST_DIR, "settings-backup");
-
-const { patchSettingsSectionWithBackup, rollbackSettings, listBackups } = await import(
-	"../settings-backup"
-);
-
-function writeTestSettings(content: Record<string, any>) {
-	mkdirSync(TEST_DIR, { recursive: true });
-	writeFileSync(TEST_SETTINGS, JSON.stringify(content, null, 2));
-}
-
-function readTestSettings(): Record<string, any> {
-	if (!existsSync(TEST_SETTINGS)) return {};
-	return JSON.parse(readFileSync(TEST_SETTINGS, "utf-8"));
-}
-
-function cleanupTestDir() {
-	if (existsSync(TEST_DIR)) rmSync(TEST_DIR, { recursive: true });
-}
-
-describe("settings-backup 高级测试", () => {
-	beforeEach(() => {
-		cleanupTestDir();
-		mkdirSync(TEST_DIR, { recursive: true });
-	});
-	afterEach(() => {
-		cleanupTestDir();
-	});
-
-	// ── 并发写入与竞态保护 ────────────────────────
-
-	describe("并发写入与竞态保护", () => {
-		it("快速连续 patch 不同 section 不丢数据", () => {
-			writeTestSettings({ context: { threshold: 100 }, shepherd: { maxWarnings: 5 } });
-
-			patchSettingsSectionWithBackup(
-				"context",
-				{ threshold: 200 },
-				{ threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR, backup: false },
-			);
-			patchSettingsSectionWithBackup(
-				"shepherd",
-				{ maxWarnings: 10 },
-				{ maxWarnings: 5 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR, backup: false },
-			);
-
-			const settings = readTestSettings();
-			expect(settings.context.threshold).toBe(200);
-			expect(settings.shepherd.maxWarnings).toBe(10);
-		});
-
-		it("加锁后重读最新数据 — 保留等锁期间外部修改", () => {
-			writeTestSettings({ context: { threshold: 100 } });
-
-			// 第一次 patch
-			patchSettingsSectionWithBackup(
-				"context",
-				{ threshold: 200 },
-				{ threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR, backup: false },
-			);
-
-			// 模拟外部进程修改：直接写文件加一个新 section
-			const externalData = { ...readTestSettings(), externalSection: { addedByOther: true } };
-			writeFileSync(TEST_SETTINGS, JSON.stringify(externalData, null, 2));
-
-			// 第二次 patch 应该保留外部添加的 section
-			patchSettingsSectionWithBackup(
-				"shepherd",
-				{ maxWarnings: 3 },
-				{ maxWarnings: 5 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR, backup: false },
-			);
-
-			const settings = readTestSettings();
-			expect(settings.context.threshold).toBe(200);
-			expect(settings.shepherd.maxWarnings).toBe(3);
-			expect(settings.externalSection.addedByOther).toBe(true);
-		});
-
-		it("3 个 section 快速连续 patch 全部保留", () => {
-			writeTestSettings({
-				context: { threshold: 100 },
-				shepherd: { maxWarnings: 5 },
-				mcp: { disabled: [] },
-			});
-
-			patchSettingsSectionWithBackup(
-				"context", { threshold: 200 }, { threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR, backup: false },
-			);
-			patchSettingsSectionWithBackup(
-				"shepherd", { maxWarnings: 10 }, { maxWarnings: 5 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR, backup: false },
-			);
-			patchSettingsSectionWithBackup(
-				"mcp", { disabled: ["server-a"] }, { disabled: [] },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR, backup: false },
-			);
-
-			const settings = readTestSettings();
-			expect(settings.context.threshold).toBe(200);
-			expect(settings.shepherd.maxWarnings).toBe(10);
-			expect(settings.mcp.disabled).toEqual(["server-a"]);
-		});
-	});
-
-	// ── 备份内容完整性 ──────────────────────────
-
-	describe("备份内容完整性", () => {
-		it("备份的 JSON 与修改前深度一致", () => {
-			const original = {
-				context: { threshold: 100, name: "test" },
-				deep: { nested: { value: [1, 2, 3] } },
-			};
-			writeTestSettings(original);
-
-			patchSettingsSectionWithBackup(
-				"context",
-				{ threshold: 200 },
-				{ threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR },
-			);
-
-			const backupFiles = readdirSync(TEST_BACKUP_DIR).filter((f) => f.endsWith(".json"));
-			const backupContent = JSON.parse(readFileSync(join(TEST_BACKUP_DIR, backupFiles[0]), "utf-8"));
-
-			expect(backupContent).toEqual(original);
-		});
-
-		it("两次备份内容分别对应各自修改前的状态", async () => {
-			writeTestSettings({ context: { threshold: 100 } });
-
-			patchSettingsSectionWithBackup(
-				"context", { threshold: 200 }, { threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR },
-			);
-			await new Promise((r) => setTimeout(r, 10));
-			patchSettingsSectionWithBackup(
-				"context", { threshold: 300 }, { threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR },
-			);
-
-			const backups = listBackups({ backupDir: TEST_BACKUP_DIR });
-			expect(backups.length).toBe(2);
-
-			// 最新备份（index 0）应该是第二次修改前的状态
-			const backup0 = JSON.parse(readFileSync(backups[0].path, "utf-8"));
-			expect(backup0.context.threshold).toBe(200);
-
-			// 旧备份（index 1）应该是第一次修改前的状态
-			const backup1 = JSON.parse(readFileSync(backups[1].path, "utf-8"));
-			expect(backup1.context.threshold).toBe(100);
-		});
-	});
-
-	// ── 写入格式验证 ──────────────────────────────
-
-	describe("写入格式验证", () => {
-		it("写入的 JSON 格式合法且包含所有字段", () => {
-			writeTestSettings({ context: { threshold: 100 } });
-
-			patchSettingsSectionWithBackup(
-				"context",
-				{ threshold: 200, name: "测试" },
-				{ threshold: 100, name: "" },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR, backup: false },
-			);
-
-			const raw = readFileSync(TEST_SETTINGS, "utf-8");
-			const parsed = JSON.parse(raw);
-			expect(parsed.context.threshold).toBe(200);
-			expect(parsed.context.name).toBe("测试");
-		});
-
-		it("写入后 settings.json 以换行结尾", () => {
-			writeTestSettings({ context: { threshold: 100 } });
-
-			patchSettingsSectionWithBackup(
-				"context", { threshold: 200 }, { threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR, backup: false },
-			);
-
-			const raw = readFileSync(TEST_SETTINGS, "utf-8");
-			expect(raw.endsWith("\n")).toBe(true);
-		});
-	});
-
-	// ── detectConflicts 集成 ──────────────────────
-
-	describe("detectConflicts 集成", () => {
-		it("返回全局与项目级冲突列表", async () => {
-			const { detectConfigConflicts } = await import("../project-config");
-
-			// 创建一个临时项目级配置
-			const projectDir = join(TEST_DIR, "project");
-			const projectSettingsDir = join(projectDir, ".pi");
-			mkdirSync(projectSettingsDir, { recursive: true });
-
-			// 项目级覆盖全局配置（同 key 不同值）
-			writeFileSync(
-				join(projectSettingsDir, "settings.json"),
-				JSON.stringify({ context: { threshold: 999 } }),
-			);
-
-			// detectConfigConflicts 读全局 SETTINGS_PATH，项目级 threshold=999 和全局不同
-			const conflicts = detectConfigConflicts(projectDir);
-
-			// 可能检测到项目级的 context.threshold (999) 和全局不同
-			// 注意：这个测试依赖真实全局配置内容，所以只验证 API 不崩溃
-			expect(Array.isArray(conflicts)).toBe(true);
-		});
-	});
-
-	// ── rollback 到指定备份 ────────────────────────
-
-	describe("rollback 到指定备份", () => {
-		it("默认恢复最近一份备份", async () => {
-			writeTestSettings({ context: { threshold: 100 } });
-
-			patchSettingsSectionWithBackup(
-				"context", { threshold: 200 }, { threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR },
-			);
-			await new Promise((r) => setTimeout(r, 10));
-			patchSettingsSectionWithBackup(
-				"context", { threshold: 300 }, { threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR },
-			);
-
-			// 当前是 300，回滚应该恢复到 200（最近一份备份）
-			rollbackSettings({ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR });
-			expect(readTestSettings().context.threshold).toBe(200);
-		});
-
-		it("手动指定备份文件恢复到更早的状态", async () => {
-			writeTestSettings({ context: { threshold: 100 } });
-
-			patchSettingsSectionWithBackup(
-				"context", { threshold: 200 }, { threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR },
-			);
-			await new Promise((r) => setTimeout(r, 10));
-			patchSettingsSectionWithBackup(
-				"context", { threshold: 300 }, { threshold: 100 },
-				{ settingsPath: TEST_SETTINGS, backupDir: TEST_BACKUP_DIR },
-			);
-
-			const backups = listBackups({ backupDir: TEST_BACKUP_DIR });
-			expect(backups.length).toBe(2);
-
-			// 手动恢复到最早那份（threshold = 100）
-			const oldestBackup = backups[backups.length - 1];
-			const content = readFileSync(oldestBackup.path, "utf-8");
-			writeFileSync(TEST_SETTINGS, content);
-
-			expect(readTestSettings().context.threshold).toBe(100);
-		});
-	});
-});