@f5-sales-demo/xcsh 19.51.2

package/src/discovery/claude.ts

@@ -0,0 +1,543 @@
+/**
+ * xcsh Provider
+ *
+ * Loads configuration from .xcsh directories.
+ * Priority: 80 (tool-specific, below builtin but above shared standards)
+ */
+import * as path from "node:path";
+import { hasFsCode, tryParseJson } from "@f5xc-salesdemos/pi-utils";
+import { registerProvider } from "../capability";
+import { type ContextFile, contextFileCapability } from "../capability/context-file";
+import { type ExtensionModule, extensionModuleCapability } from "../capability/extension-module";
+import { readFile } from "../capability/fs";
+import { type Hook, hookCapability } from "../capability/hook";
+import { type MCPServer, mcpCapability } from "../capability/mcp";
+import { type Settings, settingsCapability } from "../capability/settings";
+import { type Skill, skillCapability } from "../capability/skill";
+import { type SlashCommand, slashCommandCapability } from "../capability/slash-command";
+import { type SystemPrompt, systemPromptCapability } from "../capability/system-prompt";
+import { type CustomTool, toolCapability } from "../capability/tool";
+import type { LoadContext, LoadResult } from "../capability/types";
+import {
+	calculateDepth,
+	createSourceMeta,
+	discoverExtensionModulePaths,
+	expandEnvVarsDeep,
+	getExtensionNameFromPath,
+	loadFilesFromDir,
+	scanSkillsFromDir,
+} from "./helpers";
+
+const PROVIDER_ID = "xcsh";
+const DISPLAY_NAME = "xcsh";
+const PRIORITY = 80;
+const CONFIG_DIR = ".xcsh";
+
+/**
+ * Get user-level .xcsh path.
+ */
+function getUserClaude(ctx: LoadContext): string {
+	return path.join(ctx.home, CONFIG_DIR);
+}
+
+/**
+ * Get project-level .xcsh path (cwd only).
+ */
+function getProjectClaude(ctx: LoadContext): string {
+	return path.join(ctx.cwd, CONFIG_DIR);
+}
+
+function isMissingDirectoryError(error: unknown): boolean {
+	return hasFsCode(error, "ENOENT") || hasFsCode(error, "ENOTDIR");
+}
+
+// =============================================================================
+// MCP Servers
+// =============================================================================
+
+async function loadMCPServers(ctx: LoadContext): Promise<LoadResult<MCPServer>> {
+	const items: MCPServer[] = [];
+	const warnings: string[] = [];
+
+	const userBase = getUserClaude(ctx);
+	const userClaudeJson = path.join(ctx.home, ".xcsh.json");
+	const userMcpJson = path.join(userBase, "mcp.json");
+
+	const projectBase = path.join(ctx.cwd, CONFIG_DIR);
+	const projectMcpJson = path.join(projectBase, ".mcp.json");
+	const projectMcpJsonAlt = path.join(projectBase, "mcp.json");
+
+	const userPaths = [
+		{ path: userClaudeJson, level: "user" as const },
+		{ path: userMcpJson, level: "user" as const },
+	];
+	const projectPaths = [
+		{ path: projectMcpJson, level: "project" as const },
+		{ path: projectMcpJsonAlt, level: "project" as const },
+	];
+
+	const allPaths = [...userPaths, ...projectPaths];
+	const contents = await Promise.all(allPaths.map(({ path }) => readFile(path)));
+
+	const parseMcpServers = (content: string | null, path: string, level: "user" | "project"): MCPServer[] => {
+		if (!content) return [];
+		const json = tryParseJson<{ mcpServers?: Record<string, unknown> }>(content);
+		if (!json?.mcpServers) return [];
+
+		const mcpServers = expandEnvVarsDeep(json.mcpServers);
+		return Object.entries(mcpServers).map(([name, config]) => {
+			const serverConfig = config as Record<string, unknown>;
+			return {
+				name,
+				timeout: typeof serverConfig.timeout === "number" ? serverConfig.timeout : undefined,
+				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: serverConfig.type as "stdio" | "sse" | "http" | undefined,
+				_source: createSourceMeta(PROVIDER_ID, path, level),
+			};
+		});
+	};
+
+	for (let i = 0; i < userPaths.length; i++) {
+		const servers = parseMcpServers(contents[i], userPaths[i].path, userPaths[i].level);
+		if (servers.length > 0) {
+			items.push(...servers);
+			break;
+		}
+	}
+
+	const projectOffset = userPaths.length;
+	for (let i = 0; i < projectPaths.length; i++) {
+		const servers = parseMcpServers(contents[projectOffset + i], projectPaths[i].path, projectPaths[i].level);
+		if (servers.length > 0) {
+			items.push(...servers);
+			break;
+		}
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Context Files (CLAUDE.md)
+// =============================================================================
+
+async function loadContextFiles(ctx: LoadContext): Promise<LoadResult<ContextFile>> {
+	const items: ContextFile[] = [];
+	const warnings: string[] = [];
+
+	const userBase = getUserClaude(ctx);
+	const userClaudeMd = path.join(userBase, "CLAUDE.md");
+
+	const userContent = await readFile(userClaudeMd);
+	if (userContent !== null) {
+		items.push({
+			path: userClaudeMd,
+			content: userContent,
+			level: "user",
+			_source: createSourceMeta(PROVIDER_ID, userClaudeMd, "user"),
+		});
+	}
+
+	const projectBase = getProjectClaude(ctx);
+	const projectClaudeMd = path.join(projectBase, "CLAUDE.md");
+	const projectContent = await readFile(projectClaudeMd);
+	if (projectContent !== null) {
+		const depth = calculateDepth(ctx.cwd, path.dirname(projectBase), path.sep);
+		items.push({
+			path: projectClaudeMd,
+			content: projectContent,
+			level: "project",
+			depth,
+			_source: createSourceMeta(PROVIDER_ID, projectClaudeMd, "project"),
+		});
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Skills
+// =============================================================================
+
+async function loadSkills(ctx: LoadContext): Promise<LoadResult<Skill>> {
+	const userSkillsDir = path.join(getUserClaude(ctx), "skills");
+
+	// Walk up from cwd finding .xcsh/skills/ in ancestors
+	const projectScans: Promise<LoadResult<Skill>>[] = [];
+	let current = ctx.cwd;
+	while (true) {
+		projectScans.push(
+			scanSkillsFromDir(ctx, {
+				dir: path.join(current, CONFIG_DIR, "skills"),
+				providerId: PROVIDER_ID,
+				level: "project",
+			}),
+		);
+		if (current === (ctx.repoRoot ?? ctx.home)) break;
+		const parent = path.dirname(current);
+		if (parent === current) break; // filesystem root
+		current = parent;
+	}
+
+	const [userResult, ...projectResults] = await Promise.allSettled([
+		scanSkillsFromDir(ctx, { dir: userSkillsDir, providerId: PROVIDER_ID, level: "user" }),
+		...projectScans,
+	]);
+
+	const items: Skill[] = [];
+	const warnings: string[] = [];
+
+	if (userResult.status === "fulfilled") {
+		items.push(...userResult.value.items);
+		warnings.push(...(userResult.value.warnings ?? []));
+	} else if (!isMissingDirectoryError(userResult.reason)) {
+		warnings.push(`Failed to scan Claude user skills in ${userSkillsDir}: ${String(userResult.reason)}`);
+	}
+
+	for (const projectResult of projectResults) {
+		if (projectResult.status === "fulfilled") {
+			items.push(...projectResult.value.items);
+			warnings.push(...(projectResult.value.warnings ?? []));
+		} else if (!isMissingDirectoryError(projectResult.reason)) {
+			warnings.push(`Failed to scan Claude project skills: ${String(projectResult.reason)}`);
+		}
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Extension Modules
+// =============================================================================
+
+async function loadExtensionModules(ctx: LoadContext): Promise<LoadResult<ExtensionModule>> {
+	const items: ExtensionModule[] = [];
+	const warnings: string[] = [];
+
+	const userBase = getUserClaude(ctx);
+	const userExtensionsDir = path.join(userBase, "extensions");
+	const projectExtensionsDir = path.join(ctx.cwd, CONFIG_DIR, "extensions");
+
+	const dirsToDiscover: { dir: string; level: "user" | "project" }[] = [
+		{ dir: userExtensionsDir, level: "user" },
+		{ dir: projectExtensionsDir, level: "project" },
+	];
+
+	const pathsByLevel = await Promise.all(
+		dirsToDiscover.map(async ({ dir, level }) => {
+			const paths = await discoverExtensionModulePaths(ctx, dir);
+			return paths.map(extPath => ({ extPath, level }));
+		}),
+	);
+
+	for (const extensions of pathsByLevel) {
+		for (const { extPath, level } of extensions) {
+			items.push({
+				name: getExtensionNameFromPath(extPath),
+				path: extPath,
+				level,
+				_source: createSourceMeta(PROVIDER_ID, extPath, level),
+			});
+		}
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Slash Commands
+// =============================================================================
+
+async function loadSlashCommands(ctx: LoadContext): Promise<LoadResult<SlashCommand>> {
+	const items: SlashCommand[] = [];
+	const warnings: string[] = [];
+
+	const userBase = getUserClaude(ctx);
+	const userCommandsDir = path.join(userBase, "commands");
+
+	const userResult = await loadFilesFromDir<SlashCommand>(ctx, userCommandsDir, PROVIDER_ID, "user", {
+		extensions: ["md"],
+		transform: (name, content, path, source) => {
+			const cmdName = name.replace(/\.md$/, "");
+			return {
+				name: cmdName,
+				path,
+				content,
+				level: "user",
+				_source: source,
+			};
+		},
+	});
+
+	items.push(...userResult.items);
+	if (userResult.warnings) warnings.push(...userResult.warnings);
+
+	const projectCommandsDir = path.join(ctx.cwd, CONFIG_DIR, "commands");
+
+	const projectResult = await loadFilesFromDir<SlashCommand>(ctx, projectCommandsDir, PROVIDER_ID, "project", {
+		extensions: ["md"],
+		transform: (name, content, path, source) => {
+			const cmdName = name.replace(/\.md$/, "");
+			return {
+				name: cmdName,
+				path,
+				content,
+				level: "project",
+				_source: source,
+			};
+		},
+	});
+
+	items.push(...projectResult.items);
+	if (projectResult.warnings) warnings.push(...projectResult.warnings);
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Hooks
+// =============================================================================
+
+async function loadHooks(ctx: LoadContext): Promise<LoadResult<Hook>> {
+	const items: Hook[] = [];
+	const warnings: string[] = [];
+
+	const userBase = getUserClaude(ctx);
+	const userHooksDir = path.join(userBase, "hooks");
+	const projectBase = getProjectClaude(ctx);
+	const projectHooksDir = path.join(projectBase, "hooks");
+
+	const hookTypes = ["pre", "post"] as const;
+
+	const loadTasks: { dir: string; hookType: "pre" | "post"; level: "user" | "project" }[] = [];
+	for (const hookType of hookTypes) {
+		loadTasks.push({ dir: path.join(userHooksDir, hookType), hookType, level: "user" });
+	}
+	for (const hookType of hookTypes) {
+		loadTasks.push({ dir: path.join(projectHooksDir, hookType), hookType, level: "project" });
+	}
+
+	const results = await Promise.all(
+		loadTasks.map(({ dir, hookType, level }) =>
+			loadFilesFromDir<Hook>(ctx, dir, PROVIDER_ID, level, {
+				transform: (name, _content, path, source) => {
+					const toolName = name.replace(/\.(sh|bash|zsh|fish)$/, "");
+					return {
+						name,
+						path,
+						type: hookType,
+						tool: toolName,
+						level,
+						_source: source,
+					};
+				},
+			}),
+		),
+	);
+
+	for (const result of results) {
+		items.push(...result.items);
+		if (result.warnings) warnings.push(...result.warnings);
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Custom Tools
+// =============================================================================
+
+async function loadTools(ctx: LoadContext): Promise<LoadResult<CustomTool>> {
+	const items: CustomTool[] = [];
+	const warnings: string[] = [];
+
+	const userBase = getUserClaude(ctx);
+	const userToolsDir = path.join(userBase, "tools");
+
+	const userResult = await loadFilesFromDir<CustomTool>(ctx, userToolsDir, PROVIDER_ID, "user", {
+		transform: (name, _content, path, source) => {
+			const toolName = name.replace(/\.(ts|js|sh|bash|py)$/, "");
+			return {
+				name: toolName,
+				path,
+				description: `${toolName} custom tool`,
+				level: "user",
+				_source: source,
+			};
+		},
+	});
+
+	items.push(...userResult.items);
+	if (userResult.warnings) warnings.push(...userResult.warnings);
+
+	const projectBase = getProjectClaude(ctx);
+	const projectToolsDir = path.join(projectBase, "tools");
+
+	const projectResult = await loadFilesFromDir<CustomTool>(ctx, projectToolsDir, PROVIDER_ID, "project", {
+		transform: (name, _content, path, source) => {
+			const toolName = name.replace(/\.(ts|js|sh|bash|py)$/, "");
+			return {
+				name: toolName,
+				path,
+				description: `${toolName} custom tool`,
+				level: "project",
+				_source: source,
+			};
+		},
+	});
+
+	items.push(...projectResult.items);
+	if (projectResult.warnings) warnings.push(...projectResult.warnings);
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// System Prompts
+// =============================================================================
+
+async function loadSystemPrompts(ctx: LoadContext): Promise<LoadResult<SystemPrompt>> {
+	const items: SystemPrompt[] = [];
+	const warnings: string[] = [];
+
+	const userBase = getUserClaude(ctx);
+	const userSystemMd = path.join(userBase, "SYSTEM.md");
+
+	const content = await readFile(userSystemMd);
+	if (content !== null) {
+		items.push({
+			path: userSystemMd,
+			content,
+			level: "user",
+			_source: createSourceMeta(PROVIDER_ID, userSystemMd, "user"),
+		});
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Settings
+// =============================================================================
+
+async function loadSettings(ctx: LoadContext): Promise<LoadResult<Settings>> {
+	const items: Settings[] = [];
+	const warnings: string[] = [];
+
+	const userBase = getUserClaude(ctx);
+	const userSettingsJson = path.join(userBase, "settings.json");
+
+	const userContent = await readFile(userSettingsJson);
+	if (userContent) {
+		const data = tryParseJson<Record<string, unknown>>(userContent);
+		if (data) {
+			items.push({
+				path: userSettingsJson,
+				data,
+				level: "user",
+				_source: createSourceMeta(PROVIDER_ID, userSettingsJson, "user"),
+			});
+		} else {
+			warnings.push(`Failed to parse JSON in ${userSettingsJson}`);
+		}
+	}
+
+	const projectBase = getProjectClaude(ctx);
+	const projectSettingsJson = path.join(projectBase, "settings.json");
+	const projectContent = await readFile(projectSettingsJson);
+	if (projectContent) {
+		const data = tryParseJson<Record<string, unknown>>(projectContent);
+		if (data) {
+			items.push({
+				path: projectSettingsJson,
+				data,
+				level: "project",
+				_source: createSourceMeta(PROVIDER_ID, projectSettingsJson, "project"),
+			});
+		} else {
+			warnings.push(`Failed to parse JSON in ${projectSettingsJson}`);
+		}
+	}
+
+	return { items, warnings };
+}
+
+// =============================================================================
+// Provider Registration
+// =============================================================================
+
+registerProvider<MCPServer>(mcpCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load MCP servers from .xcsh.json and .xcsh/mcp.json",
+	priority: PRIORITY,
+	load: loadMCPServers,
+});
+
+registerProvider<ContextFile>(contextFileCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load CLAUDE.md files from .xcsh/ directories",
+	priority: PRIORITY,
+	load: loadContextFiles,
+});
+
+registerProvider<Skill>(skillCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load skills from .xcsh/skills/*/SKILL.md",
+	priority: PRIORITY,
+	load: loadSkills,
+});
+
+registerProvider<ExtensionModule>(extensionModuleCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load extension modules from .xcsh/extensions",
+	priority: PRIORITY,
+	load: loadExtensionModules,
+});
+
+registerProvider<SlashCommand>(slashCommandCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load slash commands from .xcsh/commands/*.md",
+	priority: PRIORITY,
+	load: loadSlashCommands,
+});
+
+registerProvider<Hook>(hookCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load hooks from .xcsh/hooks/pre/ and .xcsh/hooks/post/",
+	priority: PRIORITY,
+	load: loadHooks,
+});
+
+registerProvider<CustomTool>(toolCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load custom tools from .xcsh/tools/",
+	priority: PRIORITY,
+	load: loadTools,
+});
+
+registerProvider<Settings>(settingsCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load settings from .xcsh/settings.json",
+	priority: PRIORITY,
+	load: loadSettings,
+});
+
+registerProvider<SystemPrompt>(systemPromptCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load system prompt from .xcsh/SYSTEM.md",
+	priority: PRIORITY,
+	load: loadSystemPrompts,
+});

package/src/discovery/cline.ts

@@ -0,0 +1,83 @@
+/**
+ * Cline Provider
+ *
+ * Loads rules from .clinerules (can be single file or directory with *.md files).
+ * Project-only (no user-level config).
+ */
+import * as path from "node:path";
+import { registerProvider } from "../capability";
+import { readDirEntries, readFile } from "../capability/fs";
+import type { Rule } from "../capability/rule";
+import { ruleCapability } from "../capability/rule";
+import type { LoadContext, LoadResult } from "../capability/types";
+import { buildRuleFromMarkdown, createSourceMeta, loadFilesFromDir } from "./helpers";
+
+const PROVIDER_ID = "cline";
+const DISPLAY_NAME = "Cline";
+const PRIORITY = 40;
+
+async function findClinerules(startDir: string): Promise<{ path: string; isDir: boolean } | null> {
+	let current = path.resolve(startDir);
+
+	while (true) {
+		const entries = await readDirEntries(current);
+		const entry = entries.find(e => e.name === ".clinerules");
+		if (entry) {
+			return {
+				path: path.resolve(current, ".clinerules"),
+				isDir: entry.isDirectory(),
+			};
+		}
+		const parent = path.dirname(current);
+		if (parent === current) return null;
+		current = parent;
+	}
+}
+
+/**
+ * Load rules from .clinerules
+ */
+async function loadRules(ctx: LoadContext): Promise<LoadResult<Rule>> {
+	const items: Rule[] = [];
+	const warnings: string[] = [];
+
+	// Project-level only (Cline uses root-level .clinerules)
+	const found = await findClinerules(ctx.cwd);
+	if (!found) {
+		return { items, warnings };
+	}
+
+	// Check if .clinerules is a directory or file
+	if (found.isDir) {
+		// Directory format: load all *.md files
+		const result = await loadFilesFromDir(ctx, found.path, PROVIDER_ID, "project", {
+			extensions: ["md"],
+			transform: (name, content, path, source) =>
+				buildRuleFromMarkdown(name, content, path, source, { stripNamePattern: /\.md$/ }),
+		});
+
+		items.push(...result.items);
+		if (result.warnings) warnings.push(...result.warnings);
+	} else {
+		// Single file format
+		const content = await readFile(found.path);
+		if (content === null) {
+			warnings.push(`Failed to read .clinerules at ${found.path}`);
+			return { items, warnings };
+		}
+
+		const source = createSourceMeta(PROVIDER_ID, found.path, "project");
+		items.push(buildRuleFromMarkdown("clinerules.md", content, found.path, source, { ruleName: "clinerules" }));
+	}
+
+	return { items, warnings };
+}
+
+// Register provider
+registerProvider<Rule>(ruleCapability.id, {
+	id: PROVIDER_ID,
+	displayName: DISPLAY_NAME,
+	description: "Load rules from .clinerules (single file or directory)",
+	priority: PRIORITY,
+	load: loadRules,
+});