@oh-my-pi/pi-coding-agent 2.3.1337 → 3.1.1337

package/src/discovery/cursor.ts

@@ -0,0 +1,264 @@
+/**
+ * Cursor Provider
+ *
+ * Loads configuration from Cursor's config directories.
+ * Priority: 50 (tool-specific provider)
+ *
+ * Sources:
+ * - User: ~/.cursor
+ * - Project: .cursor/ (walks up from cwd)
+ *
+ * Capabilities:
+ * - mcps: From mcp.json with mcpServers key
+ * - rules: From rules/*.mdc files with MDC frontmatter (description, globs, alwaysApply)
+ * - settings: From settings.json if present
+ * - Legacy: .cursorrules file in project root as a single rule
+ */
+
+import { registerProvider } from "../capability/index";
+import { type MCPServer, mcpCapability } from "../capability/mcp";
+import type { Rule } from "../capability/rule";
+import { ruleCapability } from "../capability/rule";
+import type { Settings } from "../capability/settings";
+import { settingsCapability } from "../capability/settings";
+import type { LoadContext, LoadResult } from "../capability/types";
+import {
+	createSourceMeta,
+	expandEnvVarsDeep,
+	getProjectPath,
+	getUserPath,
+	loadFilesFromDir,
+	parseFrontmatter,
+	parseJSON,
+} from "./helpers";
+
+const PROVIDER_ID = "cursor";
+const DISPLAY_NAME = "Cursor";
+const PRIORITY = 50;
+
+// =============================================================================
+// MCP Servers
+// =============================================================================
+
+function loadMCPServers(ctx: LoadContext): LoadResult<MCPServer> {
+	const items: MCPServer[] = [];
+	const warnings: string[] = [];
+
+	// User-level: ~/.cursor/mcp.json
+	const userPath = getUserPath(ctx, "cursor", "mcp.json");
+	if (userPath && ctx.fs.isFile(userPath)) {
+		const content = ctx.fs.readFile(userPath);
+		if (content) {
+			const parsed = parseJSON<{ mcpServers?: Record<string, unknown> }>(content);
+			if (parsed?.mcpServers) {
+				const servers = expandEnvVarsDeep(parsed.mcpServers);
+				for (const [name, config] of Object.entries(servers)) {
+					const serverConfig = config as Record<string, unknown>;
+					items.push({
+						name,
+						command: serverConfig.command as string | undefined,
+						args: serverConfig.args as string[] | undefined,
+						env: serverConfig.env as Record<string, string> | undefined,
+						url: serverConfig.url as string | undefined,
+						headers: serverConfig.headers as Record<string, string> | undefined,
+						transport: ["stdio", "sse", "http"].includes(serverConfig.type as string)
+							? (serverConfig.type as "stdio" | "sse" | "http")
+							: undefined,
+						_source: createSourceMeta(PROVIDER_ID, userPath, "user"),
+					});
+				}
+			} else {
+				warnings.push(`${userPath}: missing or invalid 'mcpServers' key`);
+			}
+		}
+	}
+
+	// Project-level: .cursor/mcp.json
+	const projectPath = getProjectPath(ctx, "cursor", "mcp.json");
+	if (projectPath && ctx.fs.isFile(projectPath)) {
+		const content = ctx.fs.readFile(projectPath);
+		if (content) {
+			const parsed = parseJSON<{ mcpServers?: Record<string, unknown> }>(content);
+			if (parsed?.mcpServers) {
+				const servers = expandEnvVarsDeep(parsed.mcpServers);
+				for (const [name, config] of Object.entries(servers)) {
+					const serverConfig = config as Record<string, unknown>;
+					items.push({
+						name,
+						command: serverConfig.command as string | undefined,
+						args: serverConfig.args as string[] | undefined,
+						env: serverConfig.env as Record<string, string> | undefined,
+						url: serverConfig.url as string | undefined,
+						headers: serverConfig.headers as Record<string, string> | undefined,
+						transport: ["stdio", "sse", "http"].includes(serverConfig.type as string)
+							? (serverConfig.type as "stdio" | "sse" | "http")
+							: undefined,
+						_source: createSourceMeta(PROVIDER_ID, projectPath, "project"),
+					});
+				}
+			} else {
+				warnings.push(`${projectPath}: missing or invalid 'mcpServers' key`);
+			}
+		}
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Rules
+// =============================================================================
+
+function loadRules(ctx: LoadContext): LoadResult<Rule> {
+	const items: Rule[] = [];
+	const warnings: string[] = [];
+
+	// Legacy: .cursorrules file in project root
+	const legacyPath = ctx.fs.walkUp(".cursorrules", { file: true });
+	if (legacyPath) {
+		const content = ctx.fs.readFile(legacyPath);
+		if (content) {
+			items.push({
+				name: "cursorrules",
+				path: legacyPath,
+				content,
+				_source: createSourceMeta(PROVIDER_ID, legacyPath, "project"),
+			});
+		}
+	}
+
+	// User-level: ~/.cursor/rules/*.mdc
+	const userRulesPath = getUserPath(ctx, "cursor", "rules");
+	if (userRulesPath && ctx.fs.isDir(userRulesPath)) {
+		const result = loadFilesFromDir<Rule>(ctx, userRulesPath, PROVIDER_ID, "user", {
+			extensions: ["mdc", "md"],
+			transform: transformMDCRule,
+		});
+		items.push(...result.items);
+		if (result.warnings) warnings.push(...result.warnings);
+	}
+
+	// Project-level: .cursor/rules/*.mdc
+	const projectRulesPath = getProjectPath(ctx, "cursor", "rules");
+	if (projectRulesPath && ctx.fs.isDir(projectRulesPath)) {
+		const result = loadFilesFromDir<Rule>(ctx, projectRulesPath, PROVIDER_ID, "project", {
+			extensions: ["mdc", "md"],
+			transform: transformMDCRule,
+		});
+		items.push(...result.items);
+		if (result.warnings) warnings.push(...result.warnings);
+	}
+
+	return { items, warnings };
+}
+
+function transformMDCRule(
+	name: string,
+	content: string,
+	path: string,
+	source: ReturnType<typeof createSourceMeta>,
+): Rule {
+	const { frontmatter, body } = parseFrontmatter(content);
+
+	// Extract frontmatter fields
+	const description = typeof frontmatter.description === "string" ? frontmatter.description : undefined;
+	const alwaysApply = frontmatter.alwaysApply === true;
+
+	// Parse globs (can be array or single string)
+	let globs: string[] | undefined;
+	if (Array.isArray(frontmatter.globs)) {
+		globs = frontmatter.globs.filter((g): g is string => typeof g === "string");
+	} else if (typeof frontmatter.globs === "string") {
+		globs = [frontmatter.globs];
+	}
+
+	// Derive name from filename (strip extension)
+	const ruleName = name.replace(/\.(mdc|md)$/, "");
+
+	return {
+		name: ruleName,
+		path,
+		content: body,
+		description,
+		alwaysApply,
+		globs,
+		_source: source,
+	};
+}
+
+// =============================================================================
+// Settings
+// =============================================================================
+
+function loadSettings(ctx: LoadContext): LoadResult<Settings> {
+	const items: Settings[] = [];
+	const warnings: string[] = [];
+
+	// User-level: ~/.cursor/settings.json
+	const userPath = getUserPath(ctx, "cursor", "settings.json");
+	if (userPath && ctx.fs.isFile(userPath)) {
+		const content = ctx.fs.readFile(userPath);
+		if (content) {
+			const parsed = parseJSON<Record<string, unknown>>(content);
+			if (parsed) {
+				items.push({
+					path: userPath,
+					data: parsed,
+					level: "user",
+					_source: createSourceMeta(PROVIDER_ID, userPath, "user"),
+				});
+			} else {
+				warnings.push(`${userPath}: invalid JSON`);
+			}
+		}
+	}
+
+	// Project-level: .cursor/settings.json
+	const projectPath = getProjectPath(ctx, "cursor", "settings.json");
+	if (projectPath && ctx.fs.isFile(projectPath)) {
+		const content = ctx.fs.readFile(projectPath);
+		if (content) {
+			const parsed = parseJSON<Record<string, unknown>>(content);
+			if (parsed) {
+				items.push({
+					path: projectPath,
+					data: parsed,
+					level: "project",
+					_source: createSourceMeta(PROVIDER_ID, projectPath, "project"),
+				});
+			} else {
+				warnings.push(`${projectPath}: invalid JSON`);
+			}
+		}
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Provider Registration
+// =============================================================================
+
+registerProvider(mcpCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load MCP servers from ~/.cursor/mcp.json and .cursor/mcp.json",
+	priority: PRIORITY,
+	load: loadMCPServers,
+});
+
+registerProvider(ruleCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load rules from .cursor/rules/*.mdc and legacy .cursorrules",
+	priority: PRIORITY,
+	load: loadRules,
+});
+
+registerProvider(settingsCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load settings from ~/.cursor/settings.json and .cursor/settings.json",
+	priority: PRIORITY,
+	load: loadSettings,
+});

package/src/discovery/gemini.ts

@@ -0,0 +1,368 @@
+/**
+ * Gemini CLI Provider
+ *
+ * Loads configuration from Gemini CLI's config directories.
+ * Priority: 60 (tool-specific provider)
+ *
+ * Sources:
+ * - User: ~/.gemini
+ * - Project: .gemini/ (walks up from cwd) or GEMINI.md in ancestors
+ *
+ * Capabilities:
+ * - mcps: From settings.json with mcpServers key
+ * - context-files: GEMINI.md files
+ * - system-prompt: system.md files for custom system prompt
+ * - extensions: From extensions/STAR/gemini-extension.json manifests (STAR = wildcard)
+ * - settings: From settings.json
+ */
+
+import { dirname, join, sep } from "node:path";
+import { type ContextFile, contextFileCapability } from "../capability/context-file";
+import { type Extension, type ExtensionManifest, extensionCapability } from "../capability/extension";
+import { registerProvider } from "../capability/index";
+import { type MCPServer, mcpCapability } from "../capability/mcp";
+import { type Settings, settingsCapability } from "../capability/settings";
+import { type SystemPrompt, systemPromptCapability } from "../capability/system-prompt";
+import type { LoadContext, LoadResult } from "../capability/types";
+import { calculateDepth, createSourceMeta, expandEnvVarsDeep, getProjectPath, getUserPath, parseJSON } from "./helpers";
+
+const PROVIDER_ID = "gemini";
+const DISPLAY_NAME = "Gemini CLI";
+const PRIORITY = 60;
+
+// =============================================================================
+// MCP Servers
+// =============================================================================
+
+function loadMCPServers(ctx: LoadContext): LoadResult<MCPServer> {
+	const items: MCPServer[] = [];
+	const warnings: string[] = [];
+
+	// User-level: ~/.gemini/settings.json → mcpServers
+	const userPath = getUserPath(ctx, "gemini", "settings.json");
+	if (userPath && ctx.fs.isFile(userPath)) {
+		const result = loadMCPFromSettings(ctx, userPath, "user");
+		items.push(...result.items);
+		if (result.warnings) warnings.push(...result.warnings);
+	}
+
+	// Project-level: .gemini/settings.json → mcpServers
+	const projectPath = getProjectPath(ctx, "gemini", "settings.json");
+	if (projectPath && ctx.fs.isFile(projectPath)) {
+		const result = loadMCPFromSettings(ctx, projectPath, "project");
+		items.push(...result.items);
+		if (result.warnings) warnings.push(...result.warnings);
+	}
+
+	return { items, warnings };
+}
+
+function loadMCPFromSettings(ctx: LoadContext, path: string, level: "user" | "project"): LoadResult<MCPServer> {
+	const items: MCPServer[] = [];
+	const warnings: string[] = [];
+
+	const content = ctx.fs.readFile(path);
+	if (!content) {
+		warnings.push(`Failed to read ${path}`);
+		return { items, warnings };
+	}
+
+	const parsed = parseJSON<{ mcpServers?: Record<string, unknown> }>(content);
+	if (!parsed) {
+		warnings.push(`Invalid JSON in ${path}`);
+		return { items, warnings };
+	}
+
+	if (!parsed.mcpServers || typeof parsed.mcpServers !== "object") {
+		return { items, warnings };
+	}
+
+	const servers = expandEnvVarsDeep(parsed.mcpServers);
+
+	for (const [name, config] of Object.entries(servers)) {
+		if (!config || typeof config !== "object") {
+			warnings.push(`Invalid config for server "${name}" in ${path}`);
+			continue;
+		}
+
+		const raw = config as Record<string, unknown>;
+
+		items.push({
+			name,
+			command: typeof raw.command === "string" ? raw.command : undefined,
+			args: Array.isArray(raw.args) ? (raw.args as string[]) : undefined,
+			env: raw.env && typeof raw.env === "object" ? (raw.env as Record<string, string>) : undefined,
+			url: typeof raw.url === "string" ? raw.url : undefined,
+			headers: raw.headers && typeof raw.headers === "object" ? (raw.headers as Record<string, string>) : undefined,
+			transport: ["stdio", "sse", "http"].includes(raw.type as string)
+				? (raw.type as "stdio" | "sse" | "http")
+				: undefined,
+			_source: createSourceMeta(PROVIDER_ID, path, level),
+		} as MCPServer);
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Context Files
+// =============================================================================
+
+function loadContextFiles(ctx: LoadContext): LoadResult<ContextFile> {
+	const items: ContextFile[] = [];
+	const warnings: string[] = [];
+
+	// User-level: ~/.gemini/GEMINI.md
+	const userGeminiMd = getUserPath(ctx, "gemini", "GEMINI.md");
+	if (userGeminiMd && ctx.fs.isFile(userGeminiMd)) {
+		const content = ctx.fs.readFile(userGeminiMd);
+		if (content) {
+			items.push({
+				path: userGeminiMd,
+				content,
+				level: "user",
+				_source: createSourceMeta(PROVIDER_ID, userGeminiMd, "user"),
+			});
+		}
+	}
+
+	// Project-level: .gemini/GEMINI.md
+	const projectGeminiMd = getProjectPath(ctx, "gemini", "GEMINI.md");
+	if (projectGeminiMd && ctx.fs.isFile(projectGeminiMd)) {
+		const content = ctx.fs.readFile(projectGeminiMd);
+		if (content) {
+			const projectBase = getProjectPath(ctx, "gemini", "");
+			const depth = projectBase ? calculateDepth(ctx.cwd, projectBase, sep) : 0;
+
+			items.push({
+				path: projectGeminiMd,
+				content,
+				level: "project",
+				depth,
+				_source: createSourceMeta(PROVIDER_ID, projectGeminiMd, "project"),
+			});
+		}
+	}
+
+	// Also check for GEMINI.md in project root (without .gemini directory)
+	const rootGeminiMd = ctx.fs.walkUp("GEMINI.md", { file: true });
+	if (rootGeminiMd) {
+		const content = ctx.fs.readFile(rootGeminiMd);
+		if (content) {
+			// Only add if not already added from .gemini/GEMINI.md
+			const alreadyAdded = items.some((item) => item.path === rootGeminiMd);
+			if (!alreadyAdded) {
+				const fileDir = dirname(rootGeminiMd);
+				const depth = calculateDepth(ctx.cwd, fileDir, sep);
+
+				items.push({
+					path: rootGeminiMd,
+					content,
+					level: "project",
+					depth,
+					_source: createSourceMeta(PROVIDER_ID, rootGeminiMd, "project"),
+				});
+			}
+		}
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Extensions
+// =============================================================================
+
+function loadExtensions(ctx: LoadContext): LoadResult<Extension> {
+	const items: Extension[] = [];
+	const warnings: string[] = [];
+
+	// User-level: ~/.gemini/extensions/*/gemini-extension.json
+	const userExtPath = getUserPath(ctx, "gemini", "extensions");
+	if (userExtPath && ctx.fs.isDir(userExtPath)) {
+		const result = loadExtensionsFromDir(ctx, userExtPath, "user");
+		items.push(...result.items);
+		if (result.warnings) warnings.push(...result.warnings);
+	}
+
+	// Project-level: .gemini/extensions/*/gemini-extension.json
+	const projectExtPath = getProjectPath(ctx, "gemini", "extensions");
+	if (projectExtPath && ctx.fs.isDir(projectExtPath)) {
+		const result = loadExtensionsFromDir(ctx, projectExtPath, "project");
+		items.push(...result.items);
+		if (result.warnings) warnings.push(...result.warnings);
+	}
+
+	return { items, warnings };
+}
+
+function loadExtensionsFromDir(
+	ctx: LoadContext,
+	extensionsDir: string,
+	level: "user" | "project",
+): LoadResult<Extension> {
+	const items: Extension[] = [];
+	const warnings: string[] = [];
+
+	const dirs = ctx.fs.readDir(extensionsDir);
+	for (const dirName of dirs) {
+		const extPath = join(extensionsDir, dirName);
+		if (!ctx.fs.isDir(extPath)) continue;
+
+		const manifestPath = join(extPath, "gemini-extension.json");
+		if (!ctx.fs.isFile(manifestPath)) continue;
+
+		const content = ctx.fs.readFile(manifestPath);
+		if (!content) {
+			warnings.push(`Failed to read ${manifestPath}`);
+			continue;
+		}
+
+		const manifest = parseJSON<ExtensionManifest>(content);
+		if (!manifest) {
+			warnings.push(`Invalid JSON in ${manifestPath}`);
+			continue;
+		}
+
+		items.push({
+			name: manifest.name ?? dirName,
+			path: extPath,
+			manifest,
+			level,
+			_source: createSourceMeta(PROVIDER_ID, manifestPath, level),
+		});
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Settings
+// =============================================================================
+
+function loadSettings(ctx: LoadContext): LoadResult<Settings> {
+	const items: Settings[] = [];
+	const warnings: string[] = [];
+
+	// User-level: ~/.gemini/settings.json
+	const userPath = getUserPath(ctx, "gemini", "settings.json");
+	if (userPath && ctx.fs.isFile(userPath)) {
+		const content = ctx.fs.readFile(userPath);
+		if (content) {
+			const parsed = parseJSON<Record<string, unknown>>(content);
+			if (parsed) {
+				items.push({
+					path: userPath,
+					data: parsed,
+					level: "user",
+					_source: createSourceMeta(PROVIDER_ID, userPath, "user"),
+				});
+			} else {
+				warnings.push(`Invalid JSON in ${userPath}`);
+			}
+		}
+	}
+
+	// Project-level: .gemini/settings.json
+	const projectPath = getProjectPath(ctx, "gemini", "settings.json");
+	if (projectPath && ctx.fs.isFile(projectPath)) {
+		const content = ctx.fs.readFile(projectPath);
+		if (content) {
+			const parsed = parseJSON<Record<string, unknown>>(content);
+			if (parsed) {
+				items.push({
+					path: projectPath,
+					data: parsed,
+					level: "project",
+					_source: createSourceMeta(PROVIDER_ID, projectPath, "project"),
+				});
+			} else {
+				warnings.push(`Invalid JSON in ${projectPath}`);
+			}
+		}
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Provider Registration
+// =============================================================================
+
+registerProvider(mcpCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load MCP servers from ~/.gemini/settings.json and .gemini/settings.json",
+	priority: PRIORITY,
+	load: loadMCPServers,
+});
+
+registerProvider(contextFileCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load GEMINI.md context files",
+	priority: PRIORITY,
+	load: loadContextFiles,
+});
+
+// =============================================================================
+// System Prompt
+// =============================================================================
+
+function loadSystemPrompt(ctx: LoadContext): LoadResult<SystemPrompt> {
+	const items: SystemPrompt[] = [];
+
+	// User-level: ~/.gemini/system.md
+	const userSystemMd = getUserPath(ctx, "gemini", "system.md");
+	if (userSystemMd && ctx.fs.isFile(userSystemMd)) {
+		const content = ctx.fs.readFile(userSystemMd);
+		if (content) {
+			items.push({
+				path: userSystemMd,
+				content,
+				level: "user",
+				_source: createSourceMeta(PROVIDER_ID, userSystemMd, "user"),
+			});
+		}
+	}
+
+	// Project-level: .gemini/system.md
+	const projectSystemMd = getProjectPath(ctx, "gemini", "system.md");
+	if (projectSystemMd && ctx.fs.isFile(projectSystemMd)) {
+		const content = ctx.fs.readFile(projectSystemMd);
+		if (content) {
+			items.push({
+				path: projectSystemMd,
+				content,
+				level: "project",
+				_source: createSourceMeta(PROVIDER_ID, projectSystemMd, "project"),
+			});
+		}
+	}
+
+	return { items, warnings: [] };
+}
+
+registerProvider<SystemPrompt>(systemPromptCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load system.md custom system prompt files",
+	priority: PRIORITY,
+	load: loadSystemPrompt,
+});
+
+registerProvider(extensionCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load extensions from ~/.gemini/extensions/ and .gemini/extensions/",
+	priority: PRIORITY,
+	load: loadExtensions,
+});
+
+registerProvider(settingsCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load settings from ~/.gemini/settings.json and .gemini/settings.json",
+	priority: PRIORITY,
+	load: loadSettings,
+});