@oh-my-pi/cli 0.3.0 → 0.5.0

package/src/commands/link.ts

@@ -1,159 +0,0 @@
-import { existsSync } from "node:fs";
-import { mkdir, readFile, rm, symlink, writeFile } from "node:fs/promises";
-import { basename, dirname, join, resolve } from "node:path";
-import { createInterface } from "node:readline";
-import { loadPluginsJson, type PluginPackageJson, savePluginsJson } from "@omp/manifest";
-import { NODE_MODULES_DIR, PROJECT_NODE_MODULES, resolveScope } from "@omp/paths";
-import { createPluginSymlinks } from "@omp/symlinks";
-import chalk from "chalk";
-
-async function confirmCreate(path: string): Promise<boolean> {
-	if (!process.stdin.isTTY || !process.stdout.isTTY) {
-		console.log(chalk.dim("  Non-interactive mode: auto-creating package.json"));
-		return true;
-	}
-
-	const rl = createInterface({ input: process.stdin, output: process.stdout });
-	return new Promise((resolve) => {
-		rl.question(chalk.yellow(`  Create minimal package.json at ${path}? [Y/n] `), (answer) => {
-			rl.close();
-			resolve(answer.toLowerCase() !== "n");
-		});
-	});
-}
-
-export interface LinkOptions {
-	name?: string;
-	global?: boolean;
-	local?: boolean;
-	force?: boolean;
-}
-
-/**
- * Link a local plugin directory for development
- * Creates a symlink in node_modules pointing to the local directory
- */
-export async function linkPlugin(localPath: string, options: LinkOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-	const nodeModules = isGlobal ? NODE_MODULES_DIR : PROJECT_NODE_MODULES;
-
-	// Expand ~ to home directory
-	if (localPath.startsWith("~")) {
-		localPath = join(process.env.HOME || "", localPath.slice(1));
-	}
-	localPath = resolve(localPath);
-
-	// Verify the path exists
-	if (!existsSync(localPath)) {
-		console.log(chalk.red(`Error: Path does not exist: ${localPath}`));
-		process.exitCode = 1;
-		return;
-	}
-
-	// Read package.json from local path
-	let pkgJson: PluginPackageJson;
-	const localPkgJsonPath = join(localPath, "package.json");
-	const localOmpJsonPath = join(localPath, "omp.json");
-
-	if (existsSync(localPkgJsonPath)) {
-		pkgJson = JSON.parse(await readFile(localPkgJsonPath, "utf-8"));
-	} else if (existsSync(localOmpJsonPath)) {
-		// Convert legacy omp.json to package.json format
-		const ompJson = JSON.parse(await readFile(localOmpJsonPath, "utf-8"));
-		pkgJson = {
-			name: ompJson.name || options.name || basename(localPath),
-			version: ompJson.version || "0.0.0-dev",
-			description: ompJson.description,
-			keywords: ["omp-plugin"],
-			omp: {
-				install: ompJson.install,
-			},
-		};
-
-		// Persist the conversion to package.json
-		console.log(chalk.dim("  Converting omp.json to package.json..."));
-		await writeFile(localPkgJsonPath, JSON.stringify(pkgJson, null, 2));
-	} else {
-		// Create minimal package.json so npm operations work correctly
-		console.log(chalk.yellow("  No package.json found in target directory."));
-		const shouldCreate = await confirmCreate(localPkgJsonPath);
-		if (!shouldCreate) {
-			console.log(chalk.yellow("  Aborted: package.json required for linking"));
-			process.exitCode = 1;
-			return;
-		}
-		pkgJson = {
-			name: options.name || basename(localPath),
-			version: "0.0.0-dev",
-			keywords: ["omp-plugin"],
-			omp: {
-				install: [],
-			},
-		};
-		console.log(chalk.dim("  Creating minimal package.json..."));
-		await writeFile(localPkgJsonPath, JSON.stringify(pkgJson, null, 2));
-	}
-
-	const pluginName = options.name || pkgJson.name;
-	const pluginDir = join(nodeModules, pluginName);
-
-	// Check if already installed
-	const pluginsJson = await loadPluginsJson(isGlobal);
-	if (pluginsJson.plugins[pluginName]) {
-		const existingSpec = pluginsJson.plugins[pluginName];
-		const isLinked = existingSpec.startsWith("file:");
-
-		if (isLinked) {
-			console.log(chalk.yellow(`Plugin "${pluginName}" is already linked.`));
-			console.log(chalk.dim(`  Current link: ${existingSpec}`));
-			console.log(chalk.dim("  Re-linking..."));
-			// Continue with the linking process (will overwrite)
-		} else if (options.force) {
-			console.log(chalk.yellow(`Plugin "${pluginName}" is installed from npm. Overwriting with link...`));
-			// Continue with the linking process (will overwrite)
-		} else {
-			console.log(chalk.yellow(`Plugin "${pluginName}" is already installed from npm.`));
-			console.log(chalk.dim("Use omp uninstall first, or specify a different name with -n"));
-			console.log(chalk.dim("Or use --force to overwrite the npm installation"));
-			process.exitCode = 1;
-			return;
-		}
-	}
-
-	try {
-		console.log(chalk.blue(`Linking ${localPath}...`));
-
-		// Create parent directory (handles scoped packages like @org/name)
-		await mkdir(dirname(pluginDir), { recursive: true });
-
-		// Remove existing if present
-		if (existsSync(pluginDir)) {
-			await rm(pluginDir, { force: true, recursive: true });
-		}
-
-		// Create symlink to the plugin directory
-		await symlink(localPath, pluginDir);
-		console.log(chalk.dim(`  Symlinked: ${pluginDir} → ${localPath}`));
-
-		// Update plugins.json with file: protocol
-		pluginsJson.plugins[pluginName] = `file:${localPath}`;
-		await savePluginsJson(pluginsJson, isGlobal);
-
-		// Create symlinks for omp.install entries
-		if (pkgJson.omp?.install?.length) {
-			await createPluginSymlinks(pluginName, pkgJson, isGlobal);
-		}
-
-		console.log(
-			chalk.green(`\n✓ Linked "${pluginName}"${pkgJson.version ? ` v${pkgJson.version}` : ""} (development mode)`),
-		);
-		console.log(chalk.dim("  Changes to the source will be reflected immediately"));
-	} catch (err) {
-		console.log(chalk.red(`Error linking plugin: ${(err as Error).message}`));
-		process.exitCode = 1;
-		// Cleanup on failure
-		try {
-			await rm(pluginDir, { force: true });
-		} catch {}
-	}
-}

package/src/commands/list.ts

@@ -1,186 +0,0 @@
-import { loadPluginsJson, readPluginPackageJson } from "@omp/manifest";
-import { resolveScope } from "@omp/paths";
-import chalk from "chalk";
-
-export interface ListOptions {
-	global?: boolean;
-	local?: boolean;
-	json?: boolean;
-}
-
-/**
- * Known file categories with their patterns and display info
- */
-interface FileCategory {
-	pattern: RegExp;
-	label: string;
-	color: (s: string) => string;
-	extractName: (dest: string) => string;
-}
-
-const FILE_CATEGORIES: FileCategory[] = [
-	{
-		pattern: /^agent\/tools\/([^/]+)\//,
-		label: "Tools",
-		color: chalk.cyan,
-		extractName: (dest) => dest.match(/^agent\/tools\/([^/]+)\//)?.[1] || dest,
-	},
-	{
-		pattern: /^agent\/agents\/(.+)\.md$/,
-		label: "Agents",
-		color: chalk.magenta,
-		extractName: (dest) => dest.match(/^agent\/agents\/(.+)\.md$/)?.[1] || dest,
-	},
-	{
-		pattern: /^agent\/commands\/(.+)\.md$/,
-		label: "Commands",
-		color: chalk.yellow,
-		extractName: (dest) => dest.match(/^agent\/commands\/(.+)\.md$/)?.[1] || dest,
-	},
-	{
-		pattern: /^agent\/themes\/(.+)\.json$/,
-		label: "Themes",
-		color: chalk.green,
-		extractName: (dest) => dest.match(/^agent\/themes\/(.+)\.json$/)?.[1] || dest,
-	},
-	{
-		pattern: /^agent\/prompts?\//,
-		label: "Prompts",
-		color: chalk.blue,
-		extractName: (dest) => dest.split("/").pop()?.replace(/\.[^.]+$/, "") || dest,
-	},
-	{
-		pattern: /^agent\/hooks?\//,
-		label: "Hooks",
-		color: chalk.red,
-		extractName: (dest) => dest.split("/").pop()?.replace(/\.[^.]+$/, "") || dest,
-	},
-];
-
-/**
- * Categorize installed files into known categories
- */
-function categorizeFiles(files: string[]): { categorized: Map<string, string[]>; uncategorized: string[] } {
-	const categorized = new Map<string, string[]>();
-	const uncategorized: string[] = [];
-
-	for (const file of files) {
-		let matched = false;
-		for (const category of FILE_CATEGORIES) {
-			if (category.pattern.test(file)) {
-				const name = category.extractName(file);
-				const existing = categorized.get(category.label) || [];
-				if (!existing.includes(name)) {
-					existing.push(name);
-					categorized.set(category.label, existing);
-				}
-				matched = true;
-				break;
-			}
-		}
-		if (!matched) {
-			uncategorized.push(file);
-		}
-	}
-
-	return { categorized, uncategorized };
-}
-
-/**
- * Format categorized files for display
- */
-function formatContributes(files: string[]): string[] {
-	const { categorized, uncategorized } = categorizeFiles(files);
-	const lines: string[] = [];
-
-	if (categorized.size > 0 || uncategorized.length > 0) {
-		lines.push(`    ${chalk.white("Contributes:")}`);
-
-		for (const category of FILE_CATEGORIES) {
-			const items = categorized.get(category.label);
-			if (items && items.length > 0) {
-				const count = category.color(`${items.length}`);
-				const names = items.map((n) => chalk.dim(n)).join(chalk.dim(", "));
-				lines.push(`      ${chalk.green("+")} ${category.label} (${count}): ${names}`);
-			}
-		}
-
-		if (uncategorized.length > 0) {
-			const count = chalk.gray(`${uncategorized.length}`);
-			const names = uncategorized.map((n) => chalk.dim(n)).join(chalk.dim(", "));
-			lines.push(`      ${chalk.green("+")} Files (${count}): ${names}`);
-		}
-	}
-
-	return lines;
-}
-
-/**
- * List all installed plugins
- */
-export async function listPlugins(options: ListOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-	const pluginsJson = await loadPluginsJson(isGlobal);
-	const pluginNames = Object.keys(pluginsJson.plugins);
-
-	if (pluginNames.length === 0) {
-		console.log(chalk.yellow("No plugins installed."));
-		console.log(chalk.dim("Install one with: omp install <package>"));
-		process.exitCode = 1;
-		return;
-	}
-
-	if (options.json) {
-		const plugins: Record<string, unknown> = {};
-		for (const name of pluginNames) {
-			const pkgJson = await readPluginPackageJson(name, isGlobal);
-			const disabled = pluginsJson.disabled?.includes(name) || false;
-			plugins[name] = {
-				version: pkgJson?.version || pluginsJson.plugins[name],
-				description: pkgJson?.description,
-				disabled,
-				files: pkgJson?.omp?.install?.map((e) => e.dest) || [],
-			};
-		}
-		console.log(JSON.stringify({ plugins }, null, 2));
-		return;
-	}
-
-	const location = isGlobal ? "~/.pi/plugins" : ".pi";
-	console.log(chalk.bold(`Installed plugins (${pluginNames.length}) [${location}]:\n`));
-
-	for (const name of pluginNames.sort()) {
-		const pkgJson = await readPluginPackageJson(name, isGlobal);
-		const specifier = pluginsJson.plugins[name];
-		const isLocal = specifier.startsWith("file:");
-		const disabled = pluginsJson.disabled?.includes(name);
-		const isMissing = !pkgJson;
-
-		const version = pkgJson?.version ? chalk.dim(`v${pkgJson.version}`) : chalk.dim(`(${specifier})`);
-		const localBadge = isLocal ? chalk.cyan(" (local)") : "";
-		const disabledBadge = disabled ? chalk.yellow(" (disabled)") : "";
-		const missingBadge = isMissing ? chalk.red(" (missing)") : "";
-		const icon = disabled ? chalk.gray("○") : isMissing ? chalk.red("✗") : chalk.green("◆");
-
-		console.log(`${icon} ${chalk.bold(name)} ${version}${localBadge}${disabledBadge}${missingBadge}`);
-
-		if (pkgJson?.description) {
-			console.log(chalk.dim(`    ${pkgJson.description}`));
-		}
-
-		if (isLocal) {
-			const localPath = specifier.replace("file:", "");
-			console.log(chalk.dim(`    Path: ${localPath}`));
-		}
-
-		if (pkgJson?.omp?.install?.length) {
-			const files = pkgJson.omp.install.map((e) => e.dest);
-			const contributeLines = formatContributes(files);
-			for (const line of contributeLines) {
-				console.log(line);
-			}
-		}
-
-		console.log();
-	}
-}

package/src/commands/outdated.ts

@@ -1,87 +0,0 @@
-import { loadPluginsJson } from "@omp/manifest";
-import { npmOutdated } from "@omp/npm";
-import { PLUGINS_DIR, resolveScope } from "@omp/paths";
-import chalk from "chalk";
-
-export interface OutdatedOptions {
-	global?: boolean;
-	local?: boolean;
-	json?: boolean;
-}
-
-/**
- * List plugins with newer versions available
- */
-export async function showOutdated(options: OutdatedOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-	const prefix = isGlobal ? PLUGINS_DIR : ".pi";
-
-	console.log(chalk.blue("Checking for outdated plugins..."));
-
-	try {
-		const outdated = await npmOutdated(prefix);
-		const pluginsJson = await loadPluginsJson(isGlobal);
-
-		// Filter to only show plugins we manage AND are not local
-		const managedOutdated = Object.entries(outdated).filter(([name]) => {
-			const specifier = pluginsJson.plugins[name];
-			if (!specifier) return false; // Not in our manifest
-			if (specifier.startsWith("file:")) return false; // Local plugin, skip
-			return true;
-		});
-
-		if (managedOutdated.length === 0) {
-			console.log(chalk.green("\n✓ All plugins are up to date!"));
-			return;
-		}
-
-		if (options.json) {
-			const result = Object.fromEntries(managedOutdated);
-			console.log(JSON.stringify({ outdated: result }, null, 2));
-			return;
-		}
-
-		console.log(chalk.bold(`\nOutdated plugins (${managedOutdated.length}):\n`));
-
-		// Header
-		console.log(
-			chalk.dim("  Package".padEnd(30)) +
-				chalk.dim("Current".padEnd(15)) +
-				chalk.dim("Wanted".padEnd(15)) +
-				chalk.dim("Latest"),
-		);
-
-		for (const [name, versions] of managedOutdated) {
-			const current = versions.current || "?";
-			const wanted = versions.wanted || "?";
-			const latest = versions.latest || "?";
-
-			const hasMinorUpdate = wanted !== current;
-			const hasMajorUpdate = latest !== wanted;
-
-			const wantedColor = hasMinorUpdate ? chalk.yellow : chalk.dim;
-			const latestColor = hasMajorUpdate ? chalk.red : wantedColor;
-
-			console.log(
-				`  ${chalk.white(name.padEnd(28))}` +
-					`${chalk.dim(current.padEnd(15))}` +
-					`${wantedColor(wanted.padEnd(15))}` +
-					`${latestColor(latest)}`,
-			);
-		}
-
-		// Note about local plugins excluded from check
-		const localPlugins = Object.entries(pluginsJson.plugins).filter(([_, spec]) => spec.startsWith("file:"));
-		if (localPlugins.length > 0) {
-			console.log(chalk.dim(`\nNote: ${localPlugins.length} local plugin(s) excluded from check`));
-		}
-
-		console.log();
-		console.log(chalk.dim("Update with: omp update [package]"));
-		console.log(chalk.dim("  - 'wanted' = latest within semver range"));
-		console.log(chalk.dim("  - 'latest' = latest available version"));
-	} catch (err) {
-		console.log(chalk.red(`Error checking outdated: ${(err as Error).message}`));
-		process.exitCode = 1;
-	}
-}

package/src/commands/search.ts

@@ -1,77 +0,0 @@
-import { npmSearch } from "@omp/npm";
-import chalk from "chalk";
-
-function truncate(str: string, maxLen: number): string {
-	if (!str || str.length <= maxLen) return str;
-	return `${str.slice(0, maxLen - 3)}...`;
-}
-
-export interface SearchOptions {
-	json?: boolean;
-	limit?: number;
-}
-
-/**
- * Search npm for plugins with omp-plugin keyword
- */
-export async function searchPlugins(query: string, options: SearchOptions = {}): Promise<void> {
-	console.log(chalk.blue(`Searching npm for "${query}" with omp-plugin keyword...`));
-
-	try {
-		const results = await npmSearch(query, "omp-plugin");
-
-		if (results.length === 0) {
-			console.log(chalk.yellow("\nNo plugins found."));
-			console.log(chalk.dim("Try a different search term, or search without keyword:"));
-			console.log(chalk.dim("  npm search omp-plugin"));
-			process.exitCode = 1;
-			return;
-		}
-
-		const limit = options.limit || 20;
-		const displayResults = results.slice(0, limit);
-
-		if (options.json) {
-			console.log(JSON.stringify({ results: displayResults }, null, 2));
-			return;
-		}
-
-		console.log(chalk.bold(`\nFound ${results.length} plugin(s):\n`));
-
-		for (const result of displayResults) {
-			console.log(chalk.green("◆ ") + chalk.bold(result.name) + chalk.dim(` v${result.version}`));
-
-			if (result.description) {
-				console.log(chalk.dim(`    ${truncate(result.description, 100)}`));
-			}
-
-			if (result.keywords?.length) {
-				const otherKeywords = result.keywords.filter((k) => k !== "omp-plugin");
-				if (otherKeywords.length > 0) {
-					console.log(chalk.dim(`    tags: ${otherKeywords.join(", ")}`));
-				}
-			}
-
-			console.log();
-		}
-
-		if (results.length > limit) {
-			console.log(chalk.dim(`... and ${results.length - limit} more. Use --limit to see more.`));
-		}
-
-		console.log(chalk.dim("Install with: omp install <package-name>"));
-	} catch (err) {
-		const error = err as Error;
-		if (
-			error.message.includes("ENOTFOUND") ||
-			error.message.includes("ETIMEDOUT") ||
-			error.message.includes("EAI_AGAIN")
-		) {
-			console.log(chalk.red("\nNetwork error: Unable to reach npm registry."));
-			console.log(chalk.dim("  Check your internet connection and try again."));
-		} else {
-			console.log(chalk.red(`\nSearch failed: ${error.message}`));
-		}
-		process.exitCode = 1;
-	}
-}

package/src/commands/uninstall.ts

@@ -1,124 +0,0 @@
-import { existsSync } from "node:fs";
-import { rm } from "node:fs/promises";
-import { join } from "node:path";
-import { createInterface } from "node:readline";
-import { getInstalledPlugins, loadPluginsJson, readPluginPackageJson, savePluginsJson } from "@omp/manifest";
-import { npmUninstall } from "@omp/npm";
-import { NODE_MODULES_DIR, PLUGINS_DIR, PROJECT_NODE_MODULES, resolveScope } from "@omp/paths";
-import { removePluginSymlinks } from "@omp/symlinks";
-import chalk from "chalk";
-
-export interface UninstallOptions {
-	global?: boolean;
-	local?: boolean;
-	json?: boolean;
-}
-
-/**
- * Uninstall a plugin
- */
-export async function uninstallPlugin(name: string, options: UninstallOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-	const prefix = isGlobal ? PLUGINS_DIR : ".pi";
-	const nodeModules = isGlobal ? NODE_MODULES_DIR : PROJECT_NODE_MODULES;
-
-	// Check if plugin is installed
-	const pluginsJson = await loadPluginsJson(isGlobal);
-	if (!pluginsJson.plugins[name]) {
-		console.log(chalk.yellow(`Plugin "${name}" is not installed.`));
-		process.exitCode = 1;
-		return;
-	}
-
-	try {
-		console.log(chalk.blue(`Uninstalling ${name}...`));
-
-		// 1. Read package.json for omp.install entries before uninstalling
-		const pkgJson = await readPluginPackageJson(name, isGlobal);
-
-		// Check for shared dependencies
-		if (pkgJson?.dependencies) {
-			const allPlugins = await getInstalledPlugins(isGlobal);
-			const sharedDeps: string[] = [];
-
-			for (const depName of Object.keys(pkgJson.dependencies)) {
-				for (const [otherName, otherPkgJson] of allPlugins) {
-					if (otherName !== name && otherPkgJson.dependencies?.[depName]) {
-						sharedDeps.push(`${depName} (also used by ${otherName})`);
-						break;
-					}
-				}
-			}
-
-			if (sharedDeps.length > 0) {
-				console.log(chalk.yellow("\n⚠ Warning: This plugin shares dependencies with other plugins:"));
-				for (const dep of sharedDeps) {
-					console.log(chalk.dim(`  - ${dep}`));
-				}
-				console.log(chalk.dim("  These dependencies will remain installed."));
-			}
-		}
-
-		// 2. Remove symlinks
-		if (pkgJson) {
-			const result = await removePluginSymlinks(name, pkgJson, isGlobal);
-
-			if (result.skippedNonSymlinks.length > 0) {
-				console.log(chalk.yellow("\nThe following files are not symlinks and were not removed:"));
-				for (const file of result.skippedNonSymlinks) {
-					console.log(chalk.dim(`  - ${file}`));
-				}
-
-				if (process.stdin.isTTY && process.stdout.isTTY) {
-					const rl = createInterface({ input: process.stdin, output: process.stdout });
-					const answer = await new Promise<string>((resolve) => {
-						rl.question(chalk.yellow("Delete these files anyway? [y/N] "), (ans) => {
-							rl.close();
-							resolve(ans);
-						});
-					});
-
-					if (answer.toLowerCase() === "y") {
-						for (const file of result.skippedNonSymlinks) {
-							await rm(file, { force: true, recursive: true });
-							console.log(chalk.dim(`  Deleted: ${file}`));
-						}
-					}
-				}
-			}
-		}
-
-		// 3. npm uninstall
-		try {
-			await npmUninstall([name], prefix);
-		} catch (_err) {
-			// Package might have been installed via file: protocol
-			// Try to remove manually from node_modules
-			const pluginDir = join(nodeModules, name);
-			if (existsSync(pluginDir)) {
-				await rm(pluginDir, { recursive: true, force: true });
-			}
-		}
-
-		// 4. Update plugins.json/package.json
-		delete pluginsJson.plugins[name];
-		// Also remove from disabled list if present
-		if (pluginsJson.disabled) {
-			pluginsJson.disabled = pluginsJson.disabled.filter((n) => n !== name);
-		}
-		await savePluginsJson(pluginsJson, isGlobal);
-
-		console.log(chalk.green(`✓ Uninstalled "${name}"`));
-
-		if (options.json) {
-			console.log(JSON.stringify({ name, success: true }, null, 2));
-		}
-	} catch (err) {
-		console.log(chalk.red(`Error uninstalling plugin: ${(err as Error).message}`));
-		process.exitCode = 1;
-
-		if (options.json) {
-			console.log(JSON.stringify({ name, success: false, error: (err as Error).message }, null, 2));
-		}
-	}
-}