pi-shepherd 0.1.0

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

@@ -0,0 +1,119 @@
+/**
+ * settings.ts 写入操作测试（patchSettingsSection, setSettingsValue）
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+const store = vi.hoisted(() => {
+	let content = "";
+	return { get: () => content, set: (v: string) => { content = v; } };
+});
+
+const mockOs = vi.hoisted(() => ({
+	homedir: vi.fn().mockReturnValue("/fake-home"),
+}));
+vi.mock("node:os", () => mockOs);
+
+const mockFs = vi.hoisted(() => ({
+	existsSync: vi.fn(),
+	readFileSync: vi.fn(() => store.get()),
+	writeFileSync: vi.fn((_path: string, data: string) => store.set(data)),
+}));
+vi.mock("node:fs", () => mockFs);
+
+import { patchSettingsSection, setSettingsValue } from "../settings";
+
+beforeEach(() => {
+	vi.clearAllMocks();
+	store.set("");
+});
+
+function mockSettings(content: Record<string, unknown>): void {
+	store.set(JSON.stringify(content));
+	mockFs.existsSync.mockReturnValue(true);
+}
+
+function decodedStorage(): Record<string, unknown> {
+	return JSON.parse(store.get());
+}
+
+// ── patchSettingsSection ────────────────────────────────
+
+describe("patchSettingsSection", () => {
+	it("updates specified fields and persists", () => {
+		mockSettings({ context: { threshold: 5000 } });
+		const result = patchSettingsSection("context", { threshold: 8000 }, { threshold: 5000, active: true });
+		expect(result).toEqual({ threshold: 8000, active: true });
+		expect(decodedStorage().context.threshold).toBe(8000);
+	});
+
+	it("preserves unspecified fields", () => {
+		mockSettings({ context: { threshold: 5000, active: false } });
+		const result = patchSettingsSection("context", { threshold: 10000 }, { threshold: 5000, active: false });
+		expect(result).toEqual({ threshold: 10000, active: false });
+	});
+
+	it("skips patch entries with undefined value", () => {
+		mockSettings({ context: { threshold: 5000 } });
+		const result = patchSettingsSection(
+			"context",
+			{ threshold: 8000, active: undefined },
+			{ threshold: 5000, active: true },
+		);
+		expect(result).toEqual({ threshold: 8000, active: true });
+	});
+
+	it("creates new section when not present", () => {
+		mockSettings({});
+		const result = patchSettingsSection("newSection", { key: "val" }, { key: "" });
+		expect(result).toEqual({ key: "val" });
+		expect(decodedStorage().newSection.key).toBe("val");
+	});
+
+	it("appends trailing newline in written JSON", () => {
+		mockSettings({ context: { threshold: 5000 } });
+		patchSettingsSection("context", { threshold: 9999 }, { threshold: 5000 });
+		expect(store.get().endsWith("\n")).toBe(true);
+	});
+});
+
+// ── setSettingsValue ────────────────────────────────────
+
+describe("setSettingsValue", () => {
+	it("sets value at simple path", () => {
+		mockSettings({});
+		setSettingsValue("recording.enabled", true);
+		expect(decodedStorage().recording.enabled).toBe(true);
+	});
+
+	it("overwrites existing value", () => {
+		mockSettings({ recording: { enabled: false } });
+		setSettingsValue("recording.enabled", true);
+		expect(decodedStorage().recording.enabled).toBe(true);
+	});
+
+	it("creates intermediate objects", () => {
+		mockSettings({});
+		setSettingsValue("deeply.nested.path", 42);
+		expect(decodedStorage().deeply.nested.path).toBe(42);
+	});
+
+	it("replaces non-object with object at intermediate path", () => {
+		mockSettings({ a: "string" });
+		setSettingsValue("a.b.c", 1);
+		expect(decodedStorage().a.b.c).toBe(1);
+	});
+
+	it("appends trailing newline in written JSON", () => {
+		mockSettings({});
+		setSettingsValue("key", "val");
+		expect(store.get().endsWith("\n")).toBe(true);
+	});
+
+	it("preserves other sections when setting a value", () => {
+		mockSettings({ other: { keep: true } });
+		setSettingsValue("new.key", "value");
+		const data = decodedStorage();
+		expect(data.other.keep).toBe(true);
+		expect(data.new.key).toBe("value");
+	});
+});

package/node_modules/@pi-atelier/shared-utils/src/__tests__/tool-output.test.ts

@@ -0,0 +1,145 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+const { mockTruncateHead, mockFormatSize, mockCreateHashObj } = vi.hoisted(() => ({
+	mockTruncateHead: vi.fn(),
+	mockFormatSize: vi.fn((bytes: number) => `${bytes}B`),
+	mockCreateHashObj: {
+		update: vi.fn().mockReturnThis(),
+		digest: vi.fn(() => "a1b2c3d4e5f6g7h8i9j0k1l2"),
+	},
+}));
+
+vi.mock("@earendil-works/pi-coding-agent", () => ({
+	DEFAULT_MAX_LINES: 2000,
+	DEFAULT_MAX_BYTES: 51_200,
+	formatSize: mockFormatSize,
+	truncateHead: mockTruncateHead,
+}));
+
+vi.mock("node:crypto", () => ({
+	createHash: vi.fn(() => mockCreateHashObj),
+}));
+
+import { truncateToolOutput, truncatedResult } from "../tool-output";
+
+const TRUNC = {
+	content: "head",
+	truncated: true,
+	truncatedBy: "lines" as const,
+	totalLines: 200,
+	totalBytes: 100_000,
+	outputLines: 50,
+	outputBytes: 25_000,
+	lastLinePartial: false,
+	firstLineExceedsLimit: false,
+	maxLines: 2000,
+	maxBytes: 51_200,
+};
+
+const UNTRUNC = {
+	content: "full",
+	truncated: false,
+	truncatedBy: null,
+	totalLines: 5,
+	totalBytes: 200,
+	outputLines: 5,
+	outputBytes: 200,
+	lastLinePartial: false,
+	firstLineExceedsLimit: false,
+	maxLines: 2000,
+	maxBytes: 51_200,
+};
+
+beforeEach(() => vi.clearAllMocks());
+
+describe("truncateToolOutput", () => {
+	it("returns untruncated result when content fits limits", () => {
+		mockTruncateHead.mockReturnValue(UNTRUNC);
+		const r = truncateToolOutput("full content");
+		expect(r.truncated).toBe(false);
+		expect(r.content).toBe("full content");
+		expect(r.totalLines).toBe(5);
+		expect(r.totalBytes).toBe(200);
+		expect(r.outputLines).toBe(5);
+		expect(r.outputBytes).toBe(200);
+		expect(r.savedPath).toBeUndefined();
+	});
+
+	it("truncates and writes temp file when content exceeds limits", () => {
+		mockTruncateHead.mockReturnValue(TRUNC);
+		const r = truncateToolOutput("head content only", {
+			toolName: "my-tool",
+			label: "MyTool",
+		});
+		expect(r.truncated).toBe(true);
+		expect(r.content).toContain("[输出已截断: MyTool]");
+		expect(r.content).toContain("提示: 用 read 工具的 offset/limit");
+		expect(r.totalLines).toBe(200);
+		expect(r.totalBytes).toBe(100_000);
+		expect(r.outputLines).toBe(50);
+		expect(r.outputBytes).toBe(25_000);
+		expect(r.savedPath).toBeDefined();
+		expect(r.savedPath).toContain("/pi-tool-output/my-tool-a1b2c3d4e5f6.txt");
+	});
+
+	it("accepts custom maxLines and maxBytes", () => {
+		mockTruncateHead.mockReturnValue({ ...TRUNC, maxLines: 100, maxBytes: 10_000 });
+		truncateToolOutput("text", { maxLines: 100, maxBytes: 10_000 });
+		expect(mockTruncateHead).toHaveBeenCalledWith("text", {
+			maxLines: 100,
+			maxBytes: 10_000,
+		});
+	});
+
+	it("uses default options when none provided", () => {
+		mockTruncateHead.mockReturnValue(UNTRUNC);
+		truncateToolOutput("text");
+		expect(mockTruncateHead).toHaveBeenCalledWith("text", {
+			maxLines: 2000,
+			maxBytes: 51_200,
+		});
+	});
+
+	it("falls back to toolName when label is not provided", () => {
+		mockTruncateHead.mockReturnValue(TRUNC);
+		const r = truncateToolOutput("text", { toolName: "search" });
+		expect(r.content).toContain("[输出已截断: search]");
+	});
+});
+
+describe("truncatedResult", () => {
+	it("returns pi tool format without truncation", () => {
+		mockTruncateHead.mockReturnValue(UNTRUNC);
+		const r = truncatedResult("hello world");
+		expect(r.content).toEqual([{ type: "text", text: "hello world" }]);
+		expect(r.details).toEqual({ truncation: null });
+	});
+
+	it("adds truncation details when truncated", () => {
+		mockTruncateHead.mockReturnValue(TRUNC);
+		const r = truncatedResult("head content only", { toolName: "test" });
+		expect(r.content[0].text).toContain("[输出已截断: test]");
+		expect(r.details.truncation).toEqual({
+			truncated: true,
+			totalLines: 200,
+			totalBytes: 100_000,
+			outputLines: 50,
+			outputBytes: 25_000,
+			savedPath: expect.any(String),
+		});
+	});
+
+	it("merges existingDetails with truncation info", () => {
+		mockTruncateHead.mockReturnValue(TRUNC);
+		const r = truncatedResult("text", {}, { source: "session_search", extra: 42 });
+		expect(r.details.source).toBe("session_search");
+		expect(r.details.extra).toBe(42);
+		expect(r.details.truncation).toBeDefined();
+	});
+
+	it("omits truncation when not truncated", () => {
+		mockTruncateHead.mockReturnValue(UNTRUNC);
+		const r = truncatedResult("hello");
+		expect(r.details.truncation).toBeNull();
+	});
+});

package/node_modules/@pi-atelier/shared-utils/src/agents.ts

@@ -0,0 +1,39 @@
+/**
+ * Agent 发现 — 扫描 ~/.pi/agent/agents/*.md 获取可用子代理列表
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { AGENTS_DIR } from "./paths";
+
+/** 扫描所有可用的 agent 名称 */
+export function discoverAgents(): string[] {
+	if (!fs.existsSync(AGENTS_DIR)) return [];
+	return fs
+		.readdirSync(AGENTS_DIR)
+		.filter((f) => f.endsWith(".md") && !f.startsWith("_"))
+		.map((f) => f.replace(/\.md$/, ""));
+}
+
+/** 获取 agent 的简短描述（从 frontmatter 的 description 字段） */
+export function getAgentDescription(name: string): string {
+	const filePath = path.join(AGENTS_DIR, `${name}.md`);
+	try {
+		const content = fs.readFileSync(filePath, "utf-8");
+		const match = content.match(/^---\n([\s\S]*?)\n---/);
+		if (match) {
+			const descLine = match[1].split("\n").find((l) => l.startsWith("description:"));
+			if (descLine) return descLine.replace(/^description:\s*/, "").trim();
+		}
+	} catch {
+		/* ignore */
+	}
+	return "read, grep, find, ls";
+}
+
+/** 格式化为 description 中的子代理列表文本 */
+export function formatAgentsList(): string {
+	const agents = discoverAgents();
+	if (agents.length === 0) return "(无可用子代理)";
+	return agents.map((a) => `- **${a}**: ${getAgentDescription(a)}`).join("\n");
+}

package/node_modules/@pi-atelier/shared-utils/src/ephemeral.ts

@@ -0,0 +1,42 @@
+/**
+ * 临时提示注入机制（单扩展内使用）
+ *
+ * 提供提示缓冲区（pushHint/drainHints/peekHints）。
+ *
+ * 跨扩展传递提示请用 pi.events.emit("ephemeral:hint")，
+ * 不要依赖本模块的内存变量（jiti 多实例问题）。
+ *
+ * payload 持久化/录制已移到 shepherd 扩展内联处理。
+ */
+
+const _hints: string[] = [];
+const _labels: string[] = [];
+
+/** 推入一条临时提示 */
+export function pushHint(hint: string, label?: string): void {
+	_hints.push(hint);
+	if (label) _labels.push(label);
+}
+
+/** 查看待发送的标签（不消费） */
+export function peekLabels(): string[] {
+	return [..._labels];
+}
+
+/** 缓冲区是否有待发送的提示 */
+export function hasHints(): boolean {
+	return _hints.length > 0;
+}
+
+/** 查看待发送的提示内容（不消费） */
+export function peekHints(): string | null {
+	if (_hints.length === 0) return null;
+	return _hints.join("\n\n");
+}
+
+/** 取出所有待发送的提示，拼接为单条 user message（同时清空 labels） */
+export function drainHints(): string | null {
+	if (_hints.length === 0) return null;
+	_labels.splice(0);
+	return _hints.splice(0).join("\n\n");
+}

package/node_modules/@pi-atelier/shared-utils/src/file-lock.ts

@@ -0,0 +1,62 @@
+/**
+ * 文件锁（与 pi 的 proper-lockfile 兼容）
+ *
+ * proper-lockfile 用 mkdir 创建 .lock 目录做互斥，我们复用同一机制。
+ * 锁文件路径 = `${filePath}.lock`（目录），过时判断 = mtime > 10s。
+ *
+ * 这样 shared-utils 的写入和 pi 的 SettingsManager 不会竞态覆盖。
+ */
+
+import { mkdirSync, rmSync, statSync } from "node:fs";
+
+const LOCK_STALE_MS = 10_000;
+const LOCK_MAX_ATTEMPTS = 50;
+const LOCK_RETRY_DELAY_MS = 20;
+
+export function acquireLock(filePath: string): void {
+	const lockDir = `${filePath}.lock`;
+	for (let attempt = 0; attempt < LOCK_MAX_ATTEMPTS; attempt++) {
+		try {
+			mkdirSync(lockDir);
+			return; // 获锁成功
+		} catch (err: unknown) {
+			if (!(err instanceof Error) || (err as NodeJS.ErrnoException).code !== "EEXIST") throw err;
+			// 锁被占 — 检查是否过时
+			try {
+				const stat = statSync(lockDir);
+				if (Date.now() - stat.mtimeMs > LOCK_STALE_MS) {
+					// 过时锁，强制删除后重试
+					rmSync(lockDir, { recursive: true });
+					continue;
+				}
+			} catch {
+				// 锁刚好被释放，重试
+				continue;
+			}
+			// 锁仍有效，等待后重试
+			const start = Date.now();
+			while (Date.now() - start < LOCK_RETRY_DELAY_MS) {
+				// 同步等待（和 pi 的 SettingsManager 一致）
+			}
+		}
+	}
+	throw new Error(`无法获取文件锁: ${lockDir}（尝试 ${LOCK_MAX_ATTEMPTS} 次后超时）`);
+}
+
+export function releaseLock(filePath: string): void {
+	const lockDir = `${filePath}.lock`;
+	try {
+		rmSync(lockDir, { recursive: true });
+	} catch {
+		// 忽略 — 可能已被其他进程清理
+	}
+}
+
+export function withFileLock<T>(filePath: string, fn: () => T): T {
+	acquireLock(filePath);
+	try {
+		return fn();
+	} finally {
+		releaseLock(filePath);
+	}
+}

package/node_modules/@pi-atelier/shared-utils/src/filter-match.ts

@@ -0,0 +1,100 @@
+/**
+ * 过滤匹配工具 — toolName 前缀/通配符/多值 + file 路径匹配
+ *
+ * 供 session-analyzer 和 context-manager 的 entries/messages 过滤使用。
+ * 零外部依赖，纯逻辑函数。
+ */
+
+// ── globToRegex ──────────────────────────────────────
+
+/** 将简易 glob（只含 *）转为 RegExp。仅处理 *，不处理 ? 和 [] */
+function globToRegex(pattern: string): RegExp {
+	const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+	const starReplaced = escaped.replace(/\*/g, ".*");
+	return new RegExp(`^${starReplaced}$`);
+}
+
+// ── matchToolName ────────────────────────────────────
+
+/**
+ * 工具名匹配，按优先级：
+ * 1. 空/undefined → 不过滤（true）
+ * 2. 含 `|` → 多值 OR，递归每个子串
+ * 3. 含 `*` → glob 匹配
+ * 4. 精确匹配 ===
+ * 5. 前缀匹配 startsWith
+ */
+export function matchToolName(input: string | undefined, toolName: string): boolean {
+	if (!input) return true;
+
+	// 多值 OR
+	if (input.includes("|")) {
+		return input.split("|").some((part) => matchToolName(part.trim(), toolName));
+	}
+
+	// glob 匹配
+	if (input.includes("*")) {
+		return globToRegex(input).test(toolName);
+	}
+
+	// 精确匹配
+	if (input === toolName) return true;
+
+	// 不做裸前缀匹配 — 用户需显式用通配符
+	// 例如 "code_graph*" 而不是 "code_graph"
+	return false;
+}
+
+// ── extractStringValues ──────────────────────────────
+
+/** 从嵌套 JSON 值中递归提取所有 string */
+export function extractStringValues(value: unknown): string[] {
+	if (typeof value === "string") return [value];
+	if (value == null || typeof value !== "object") return [];
+
+	if (Array.isArray(value)) {
+		const result: string[] = [];
+		for (const item of value) {
+			result.push(...extractStringValues(item));
+		}
+		return result;
+	}
+
+	// 普通对象
+	const result: string[] = [];
+	for (const val of Object.values(value as Record<string, unknown>)) {
+		result.push(...extractStringValues(val));
+	}
+	return result;
+}
+
+// ── matchFile ────────────────────────────────────────
+
+/**
+ * 文件路径匹配，候选路径列表中任一命中即可：
+ * 1. 空/undefined → 不过滤（true）
+ * 2. 含 `|` → 多值 OR
+ * 3. 含 `*` → glob 匹配
+ * 4. 子串匹配
+ */
+export function matchFile(input: string | undefined, filePaths: string[]): boolean {
+	if (!input) return true;
+	if (filePaths.length === 0) return false;
+
+	// 多值 OR
+	if (input.includes("|")) {
+		return input.split("|").some((part) => matchFile(part.trim(), filePaths));
+	}
+
+	// 每条候选路径逐一检查
+	for (const fp of filePaths) {
+		// glob
+		if (input.includes("*")) {
+			if (globToRegex(input).test(fp)) return true;
+		} else {
+			// 子串匹配
+			if (fp.includes(input)) return true;
+		}
+	}
+	return false;
+}

package/node_modules/@pi-atelier/shared-utils/src/index.ts

@@ -0,0 +1,71 @@
+/**
+ * @pi-atelier/shared-utils — barrel export
+ */
+
+export {
+	discoverAgents,
+	formatAgentsList,
+	getAgentDescription,
+} from "./agents";
+export {
+	drainHints,
+	hasHints,
+	peekHints,
+	peekLabels,
+	pushHint,
+} from "./ephemeral";
+export {
+	buildFileName,
+	type MemoryEntry,
+	parseFileName,
+	scanMemoryDir,
+} from "./memory-parser";
+
+export {
+	AGENT_DIR,
+	AGENTS_DIR,
+	GLOBAL_RULES_PATH,
+	MCP_CACHE_PATH,
+	MCP_CONFIG_PATH,
+	MEMORY_DIR,
+	MEMORY_MD_PATH,
+	MODELS_CONFIG_PATH,
+	SETTINGS_PATH,
+} from "./paths";
+export {
+	type ConfigConflict,
+	clearProjectSettingsCache,
+	detectConfigConflicts,
+	type EffectiveConfigResult,
+	getEffectiveConfig,
+	type MergeOptions,
+	type SchemaError,
+	validateConfigSchema,
+} from "./project-config";
+export {
+	getDisabledMcpServers,
+	getDisabledTools,
+	getEnabledTools,
+	isToolDisabled,
+	type ToolFilter,
+} from "./project-tools";
+export {
+	getSettingsSection,
+	getSettingsValue,
+	patchSettingsSection,
+	setSettingsValue,
+} from "./settings";
+export {
+	listBackups,
+	patchSettingsSectionWithBackup,
+	rollbackSettings,
+	type BackupEntry,
+	type PatchBackupOptions,
+	type PatchBackupResult,
+	type RollbackOptions,
+} from "./settings-backup";
+export {
+	matchToolName,
+	matchFile,
+	extractStringValues,
+} from "./filter-match";

package/node_modules/@pi-atelier/shared-utils/src/memory-parser.ts

@@ -0,0 +1,96 @@
+/**
+ * Memory Parser — 共享的记忆文件名解析与目录扫描
+ *
+ * 文件名格式：topic--kw1,kw2,kw3,kw4,kw5.md
+ *   -- 分隔 topic 和关键词
+ *   ,  分隔关键词
+ *
+ * 被 memory 扩展和 smart-context 扩展共同使用。
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+// ── 类型定义 ─────────────────────────────────────────────
+
+export interface MemoryEntry {
+	name: string;
+	file: string;
+	description: string;
+	lines: number;
+	scope: "L1" | "L2";
+	topic: string;
+	keywords: string[];
+}
+
+// ── 文件名解析 ───────────────────────────────────────────
+
+/** 从文件名解析 topic 和 keywords
+ *
+ * 格式：topic--kw1,kw2,kw3.md
+ * 无 -- 时 topic = basename（兼容旧格式）
+ */
+export function parseFileName(fileName: string): { topic: string; keywords: string[] } {
+	if (fileName == null) return { topic: "", keywords: [] };
+	const base = fileName.replace(/\.md$/, "");
+	const idx = base.indexOf("--");
+	if (idx === -1) {
+		return { topic: base, keywords: [] };
+	}
+	const topic = base.substring(0, idx);
+	const kwStr = base.substring(idx + 2);
+	const keywords = kwStr ? kwStr.split(",") : [];
+	return { topic, keywords };
+}
+
+/** 生成文件名：topic--kw1,kw2,...md */
+export function buildFileName(topic: string, keywords: string[]): string {
+	const kwPart = keywords.length > 0 ? keywords.join(",") : "";
+	const base = kwPart ? `${topic}--${kwPart}` : topic;
+	return `${base}.md`;
+}
+
+// ── 目录扫描 ─────────────────────────────────────────────
+
+/** 扫描目录下的记忆文件，从文件名解析 topic + keywords */
+export function scanMemoryDir(dir: string, scope: "L1" | "L2"): MemoryEntry[] {
+	const entries: MemoryEntry[] = [];
+	if (!fs.existsSync(dir)) return entries;
+
+	const files = fs
+		.readdirSync(dir)
+		.filter((f) => f.endsWith(".md") && f !== "MEMORY.md")
+		.sort();
+
+	for (const file of files) {
+		const filePath = path.join(dir, file);
+		try {
+			const content = fs.readFileSync(filePath, "utf-8");
+			const lines = content.split("\n").length;
+			const titleLine = content.split("\n").find((l) => l.startsWith("# "));
+			const description = titleLine?.replace(/^#\s+/, "") || "";
+			const parsed = parseFileName(file);
+			entries.push({
+				name: file.replace(".md", ""),
+				file,
+				description,
+				lines,
+				scope,
+				topic: parsed.topic,
+				keywords: parsed.keywords,
+			});
+		} catch {
+			entries.push({
+				name: file.replace(".md", ""),
+				file,
+				description: "(读取失败)",
+				lines: 0,
+				scope,
+				topic: parseFileName(file).topic,
+				keywords: parseFileName(file).keywords,
+			});
+		}
+	}
+
+	return entries;
+}

package/node_modules/@pi-atelier/shared-utils/src/paths.ts

@@ -0,0 +1,23 @@
+/**
+ * 共享路径常量
+ *
+ * 统一管理 ~/.pi/agent 下所有路径，支持 PI_AGENT_DIR 环境变量覆盖。
+ * 用 `||` 确保空字符串也会回退到默认值。
+ */
+
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+/** 统一的 agent 目录路径 */
+export const AGENT_DIR = process.env.PI_AGENT_DIR || join(homedir(), ".pi/agent");
+
+// ── 常用路径常量 ──────────────────────────────────────────
+
+export const SETTINGS_PATH = join(AGENT_DIR, "settings.json");
+export const MODELS_CONFIG_PATH = join(AGENT_DIR, "models.json");
+export const MEMORY_MD_PATH = join(AGENT_DIR, "MEMORY.md");
+export const MEMORY_DIR = join(AGENT_DIR, "memory");
+export const MCP_CONFIG_PATH = join(AGENT_DIR, "mcp.json");
+export const MCP_CACHE_PATH = join(AGENT_DIR, "mcp-cache.json");
+export const AGENTS_DIR = join(AGENT_DIR, "agents");
+export const GLOBAL_RULES_PATH = join(AGENT_DIR, "extensions/shepherd/rules.json");