@oh-my-pi/cli 0.4.0 → 0.5.0

package/src/cli.ts

@@ -1,242 +0,0 @@
-#!/usr/bin/env bun
-
-import { configCommand } from "@omp/commands/config";
-import { createPlugin } from "@omp/commands/create";
-import { runDoctor } from "@omp/commands/doctor";
-import { disablePlugin, enablePlugin } from "@omp/commands/enable";
-import { envCommand } from "@omp/commands/env";
-import { featuresCommand } from "@omp/commands/features";
-import { showInfo } from "@omp/commands/info";
-import { initProject } from "@omp/commands/init";
-import { installPlugin } from "@omp/commands/install";
-import { linkPlugin } from "@omp/commands/link";
-import { listPlugins } from "@omp/commands/list";
-import { showOutdated } from "@omp/commands/outdated";
-import { searchPlugins } from "@omp/commands/search";
-import { uninstallPlugin } from "@omp/commands/uninstall";
-import { updatePlugin } from "@omp/commands/update";
-import { whyFile } from "@omp/commands/why";
-import { withErrorHandling } from "@omp/errors";
-import { checkNpmAvailable } from "@omp/npm";
-import chalk from "chalk";
-import { program } from "commander";
-
-// Check npm availability at startup
-const npmCheck = checkNpmAvailable();
-if (!npmCheck.available) {
-	console.log(chalk.red(npmCheck.error));
-	process.exit(1);
-}
-
-program.name("omp").description("Oh My Pi - Plugin manager for pi configuration").version("0.4.0");
-
-// ============================================================================
-// Core Commands
-// ============================================================================
-
-program
-	.command("install [packages...]")
-	.alias("i")
-	.description("Install plugin(s). No args = install from plugins.json")
-	.addHelpText(
-		"after",
-		`
-Examples:
-  $ omp install @oh-my-pi/subagents             # Install from npm (all features)
-  $ omp install @oh-my-pi/exa[search]           # Install with specific features
-  $ omp install @oh-my-pi/exa[search,websets]   # Multiple features
-  $ omp install @oh-my-pi/exa[*]                # Explicitly all features
-  $ omp install @oh-my-pi/exa[]                 # No optional features (core only)
-  $ omp install @oh-my-pi/subagents@^2.0.0      # Specific version range
-  $ omp install ./local/path                    # Local directory (copies)
-  $ omp install                                 # Install all from plugins.json
-`,
-	)
-	.option("-g, --global", "Install globally to ~/.pi")
-	.option("-l, --local", "Install to project-local .pi/")
-	.option("-S, --save", "Add to plugins.json")
-	.option("-D, --save-dev", "Add as dev dependency")
-	.option("--force", "Overwrite conflicts without prompting")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(installPlugin));
-
-program
-	.command("uninstall <name>")
-	.alias("rm")
-	.description("Remove plugin and its symlinks")
-	.option("-g, --global", "Uninstall from ~/.pi")
-	.option("-l, --local", "Uninstall from project-local .pi/")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(uninstallPlugin));
-
-program
-	.command("update [name]")
-	.alias("up")
-	.description("Update to latest within semver range")
-	.option("-g, --global", "Update global plugins")
-	.option("-l, --local", "Update project-local plugins")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(updatePlugin));
-
-program
-	.command("list")
-	.alias("ls")
-	.description("Show installed plugins")
-	.option("-g, --global", "List global plugins")
-	.option("-l, --local", "List project-local plugins")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(listPlugins));
-
-program
-	.command("link <path>")
-	.description("Symlink local plugin (dev mode)")
-	.addHelpText(
-		"after",
-		`
-Unlike install, link creates a symlink to the original directory,
-so changes are reflected immediately without reinstalling.
-`,
-	)
-	.option("-n, --name <name>", "Custom name for the plugin")
-	.option("-g, --global", "Link globally")
-	.option("-l, --local", "Link to project-local .pi/")
-	.option("--force", "Overwrite existing npm-installed plugin")
-	.action(withErrorHandling(linkPlugin));
-
-// ============================================================================
-// New Commands
-// ============================================================================
-
-program
-	.command("init")
-	.description("Create .pi/plugins.json in current project")
-	.option("--force", "Overwrite existing plugins.json")
-	.action(withErrorHandling(initProject));
-
-program
-	.command("search <query>")
-	.description("Search npm for omp-plugin keyword")
-	.option("--json", "Output as JSON")
-	.option("--limit <n>", "Maximum results to show", "20")
-	.action(
-		withErrorHandling((query, options) => searchPlugins(query, { ...options, limit: parseInt(options.limit, 10) })),
-	);
-
-program
-	.command("info <package>")
-	.description("Show plugin details before install")
-	.option("--json", "Output as JSON")
-	.option("--versions", "Show available versions")
-	.option("--all-versions", "Show all published versions")
-	.action(withErrorHandling(showInfo));
-
-program
-	.command("outdated")
-	.description("List plugins with newer versions")
-	.option("-g, --global", "Check global plugins")
-	.option("-l, --local", "Check project-local plugins")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(showOutdated));
-
-program
-	.command("doctor")
-	.description("Check for broken symlinks, conflicts")
-	.option("-g, --global", "Check global plugins")
-	.option("-l, --local", "Check project-local plugins")
-	.option("--fix", "Attempt to fix issues")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(runDoctor));
-
-program
-	.command("create <name>")
-	.description("Scaffold new plugin from template")
-	.option("-d, --description <desc>", "Plugin description")
-	.option("-a, --author <author>", "Plugin author")
-	.action(withErrorHandling(createPlugin));
-
-program
-	.command("why <file>")
-	.description("Show which plugin installed a file")
-	.option("-g, --global", "Check global plugins")
-	.option("-l, --local", "Check project-local plugins")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(whyFile));
-
-program
-	.command("enable <name>")
-	.description("Enable a disabled plugin")
-	.option("-g, --global", "Target global plugins")
-	.option("-l, --local", "Target project-local plugins")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(enablePlugin));
-
-program
-	.command("disable <name>")
-	.description("Disable plugin without uninstalling")
-	.option("-g, --global", "Target global plugins")
-	.option("-l, --local", "Target project-local plugins")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(disablePlugin));
-
-program
-	.command("features <name>")
-	.description("List or configure plugin features")
-	.addHelpText(
-		"after",
-		`
-Examples:
-  $ omp features @oh-my-pi/exa                     # List available features
-  $ omp features @oh-my-pi/exa --enable websets    # Enable a feature
-  $ omp features @oh-my-pi/exa --disable search    # Disable a feature
-  $ omp features @oh-my-pi/exa --set search,websets # Set exact features
-  $ omp features @oh-my-pi/exa --set '*'           # Enable all features
-  $ omp features @oh-my-pi/exa --set ''            # Disable all optional features
-`,
-	)
-	.option("-g, --global", "Target global plugins")
-	.option("-l, --local", "Target project-local plugins")
-	.option("--enable <features...>", "Enable specific features")
-	.option("--disable <features...>", "Disable specific features")
-	.option("--set <features>", "Set exact feature list (comma-separated, '*' for all, '' for none)")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(featuresCommand));
-
-program
-	.command("config <name> [key] [value]")
-	.description("Get or set plugin configuration variables")
-	.addHelpText(
-		"after",
-		`
-Examples:
-  $ omp config @oh-my-pi/exa                 # List all variables
-  $ omp config @oh-my-pi/exa apiKey          # Get value of apiKey
-  $ omp config @oh-my-pi/exa apiKey sk-xxx   # Set apiKey to sk-xxx
-  $ omp config @oh-my-pi/exa apiKey --delete # Reset apiKey to default
-`,
-	)
-	.option("-g, --global", "Target global plugins")
-	.option("-l, --local", "Target project-local plugins")
-	.option("--delete", "Delete/reset the variable to its default")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(configCommand));
-
-program
-	.command("env")
-	.description("Print plugin environment variables for shell eval")
-	.addHelpText(
-		"after",
-		`
-Examples:
-  $ eval "$(omp env)"              # Load env vars in current shell
-  $ omp env >> ~/.bashrc           # Persist to shell config
-  $ omp env --fish | source        # Fish shell syntax
-  $ omp env --json                 # JSON format for scripts
-`,
-	)
-	.option("-g, --global", "Target global plugins")
-	.option("-l, --local", "Target project-local plugins")
-	.option("--fish", "Output fish shell syntax instead of POSIX")
-	.option("--json", "Output as JSON")
-	.action(withErrorHandling(envCommand));
-
-program.parse();

package/src/commands/config.ts

@@ -1,399 +0,0 @@
-import type { OmpVariable } from "@omp/manifest";
-import { loadPluginsJson, readPluginPackageJson, savePluginsJson } from "@omp/manifest";
-import { resolveScope } from "@omp/paths";
-import chalk from "chalk";
-
-export interface ConfigOptions {
-	global?: boolean;
-	local?: boolean;
-	json?: boolean;
-	delete?: boolean;
-}
-
-/**
- * Collect all variables from a plugin (top-level + enabled features)
- */
-function collectVariables(
-	pkgJson: {
-		omp?: {
-			variables?: Record<string, OmpVariable>;
-			features?: Record<string, { variables?: Record<string, OmpVariable> }>;
-		};
-	},
-	enabledFeatures: string[],
-): Record<string, OmpVariable> {
-	const vars: Record<string, OmpVariable> = {};
-
-	// Top-level variables
-	if (pkgJson.omp?.variables) {
-		Object.assign(vars, pkgJson.omp.variables);
-	}
-
-	// Variables from enabled features
-	if (pkgJson.omp?.features) {
-		for (const fname of enabledFeatures) {
-			const feature = pkgJson.omp.features[fname];
-			if (feature?.variables) {
-				Object.assign(vars, feature.variables);
-			}
-		}
-	}
-
-	return vars;
-}
-
-/**
- * Parse a string value to the appropriate type based on variable definition
- */
-function parseValue(value: string, varDef: OmpVariable): string | number | boolean | string[] {
-	switch (varDef.type) {
-		case "number": {
-			const num = Number(value);
-			if (Number.isNaN(num)) {
-				throw new Error(`Invalid number: ${value}`);
-			}
-			return num;
-		}
-		case "boolean":
-			if (value === "true" || value === "1" || value === "yes") return true;
-			if (value === "false" || value === "0" || value === "no") return false;
-			throw new Error(`Invalid boolean: ${value}. Use true/false, 1/0, or yes/no`);
-		case "string[]":
-			return value
-				.split(",")
-				.map((s) => s.trim())
-				.filter(Boolean);
-		default:
-			return value;
-	}
-}
-
-/**
- * Format a value for display
- */
-function formatValue(value: unknown, varDef: OmpVariable): string {
-	if (value === undefined) {
-		return chalk.dim("(not set)");
-	}
-	if (varDef.type === "string[]" && Array.isArray(value)) {
-		return value.join(", ");
-	}
-	if (typeof value === "string" && varDef.env) {
-		// Mask sensitive values (likely API keys)
-		if (value.length > 8) {
-			return `${value.slice(0, 4)}...${value.slice(-4)}`;
-		}
-	}
-	return String(value);
-}
-
-/**
- * Resolve which features are currently enabled
- *
- * - null/undefined: use plugin defaults (features with default !== false)
- * - ["*"]: explicitly all features
- * - []: no optional features
- * - ["f1", "f2"]: specific features
- */
-function resolveEnabledFeatures(
-	allFeatureNames: string[],
-	storedFeatures: string[] | null | undefined,
-	pluginFeatures: Record<string, { default?: boolean }>,
-): string[] {
-	// Explicit "all features" request
-	if (Array.isArray(storedFeatures) && storedFeatures.includes("*")) return allFeatureNames;
-	// Explicit feature list (including empty array = no features)
-	if (Array.isArray(storedFeatures)) return storedFeatures;
-	// null/undefined = use defaults
-	return Object.entries(pluginFeatures)
-		.filter(([_, f]) => f.default !== false)
-		.map(([name]) => name);
-}
-
-/**
- * List all configurable variables for a plugin
- * omp config @oh-my-pi/exa
- */
-export async function listConfig(name: string, options: ConfigOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-	const pluginsJson = await loadPluginsJson(isGlobal);
-
-	if (!pluginsJson.plugins[name]) {
-		console.log(chalk.yellow(`Plugin "${name}" is not installed.`));
-		process.exitCode = 1;
-		return;
-	}
-
-	const pkgJson = await readPluginPackageJson(name, isGlobal);
-	if (!pkgJson) {
-		console.log(chalk.red(`Could not read package.json for ${name}`));
-		process.exitCode = 1;
-		return;
-	}
-
-	const allFeatureNames = Object.keys(pkgJson.omp?.features || {});
-	const config = pluginsJson.config?.[name];
-	const enabledFeatures = resolveEnabledFeatures(allFeatureNames, config?.features, pkgJson.omp?.features || {});
-	const variables = collectVariables(pkgJson, enabledFeatures);
-
-	if (Object.keys(variables).length === 0) {
-		console.log(chalk.yellow(`Plugin "${name}" has no configurable variables.`));
-		return;
-	}
-
-	const userVars = config?.variables || {};
-
-	if (options.json) {
-		console.log(
-			JSON.stringify(
-				{
-					plugin: name,
-					variables: Object.entries(variables).map(([vname, vdef]) => ({
-						name: vname,
-						type: vdef.type,
-						value: userVars[vname],
-						default: vdef.default,
-						required: vdef.required,
-						env: vdef.env,
-						description: vdef.description,
-					})),
-				},
-				null,
-				2,
-			),
-		);
-		return;
-	}
-
-	console.log(chalk.bold(`\nVariables for ${name}:\n`));
-
-	for (const [vname, vdef] of Object.entries(variables)) {
-		const currentValue = userVars[vname];
-		const hasValue = currentValue !== undefined;
-		const hasDefault = vdef.default !== undefined;
-
-		const icon = hasValue
-			? chalk.green("✓")
-			: hasDefault
-				? chalk.blue("○")
-				: vdef.required
-					? chalk.red("!")
-					: chalk.gray("○");
-		const requiredStr = vdef.required && !hasValue ? chalk.red(" (required)") : "";
-		const envStr = vdef.env ? chalk.dim(` [${vdef.env}]`) : "";
-
-		console.log(`${icon} ${chalk.bold(vname)}${requiredStr}${envStr}`);
-
-		if (vdef.description) {
-			console.log(chalk.dim(`    ${vdef.description}`));
-		}
-
-		console.log(chalk.dim(`    Type: ${vdef.type}`));
-
-		if (hasValue) {
-			console.log(`    Value: ${formatValue(currentValue, vdef)}`);
-		} else if (hasDefault) {
-			console.log(`    Default: ${formatValue(vdef.default, vdef)}`);
-		}
-	}
-
-	console.log();
-	console.log(chalk.dim(`Set a value: omp config ${name} <variable> <value>`));
-	console.log(chalk.dim(`Delete a value: omp config ${name} <variable> --delete`));
-}
-
-/**
- * Get a specific variable value
- * omp config @oh-my-pi/exa apiKey
- */
-export async function getConfig(name: string, key: string, options: ConfigOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-	const pluginsJson = await loadPluginsJson(isGlobal);
-
-	if (!pluginsJson.plugins[name]) {
-		console.log(chalk.yellow(`Plugin "${name}" is not installed.`));
-		process.exitCode = 1;
-		return;
-	}
-
-	const pkgJson = await readPluginPackageJson(name, isGlobal);
-	if (!pkgJson) {
-		console.log(chalk.red(`Could not read package.json for ${name}`));
-		process.exitCode = 1;
-		return;
-	}
-
-	const allFeatureNames = Object.keys(pkgJson.omp?.features || {});
-	const config = pluginsJson.config?.[name];
-	const enabledFeatures = resolveEnabledFeatures(allFeatureNames, config?.features, pkgJson.omp?.features || {});
-	const variables = collectVariables(pkgJson, enabledFeatures);
-
-	const varDef = variables[key];
-	if (!varDef) {
-		console.log(chalk.red(`Unknown variable "${key}".`));
-		console.log(chalk.dim(`Available: ${Object.keys(variables).join(", ") || "(none)"}`));
-		process.exitCode = 1;
-		return;
-	}
-
-	const userValue = config?.variables?.[key];
-	const value = userValue ?? varDef.default;
-
-	if (options.json) {
-		console.log(JSON.stringify({ plugin: name, variable: key, value, default: varDef.default }, null, 2));
-		return;
-	}
-
-	if (value !== undefined) {
-		console.log(formatValue(value, varDef));
-	} else {
-		console.log(chalk.dim("(not set)"));
-	}
-}
-
-/**
- * Set a variable value
- * omp config @oh-my-pi/exa apiKey sk-xxx
- */
-export async function setConfig(name: string, key: string, value: string, options: ConfigOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-	const pluginsJson = await loadPluginsJson(isGlobal);
-
-	if (!pluginsJson.plugins[name]) {
-		console.log(chalk.yellow(`Plugin "${name}" is not installed.`));
-		process.exitCode = 1;
-		return;
-	}
-
-	const pkgJson = await readPluginPackageJson(name, isGlobal);
-	if (!pkgJson) {
-		console.log(chalk.red(`Could not read package.json for ${name}`));
-		process.exitCode = 1;
-		return;
-	}
-
-	const allFeatureNames = Object.keys(pkgJson.omp?.features || {});
-	const config = pluginsJson.config?.[name];
-	const enabledFeatures = resolveEnabledFeatures(allFeatureNames, config?.features, pkgJson.omp?.features || {});
-	const variables = collectVariables(pkgJson, enabledFeatures);
-
-	const varDef = variables[key];
-	if (!varDef) {
-		console.log(chalk.red(`Unknown variable "${key}".`));
-		console.log(chalk.dim(`Available: ${Object.keys(variables).join(", ") || "(none)"}`));
-		process.exitCode = 1;
-		return;
-	}
-
-	// Parse and validate value
-	let parsed: string | number | boolean | string[];
-	try {
-		parsed = parseValue(value, varDef);
-	} catch (err) {
-		console.log(chalk.red((err as Error).message));
-		process.exitCode = 1;
-		return;
-	}
-
-	// Update config
-	if (!pluginsJson.config) pluginsJson.config = {};
-	if (!pluginsJson.config[name]) pluginsJson.config[name] = {};
-	if (!pluginsJson.config[name].variables) pluginsJson.config[name].variables = {};
-
-	pluginsJson.config[name].variables[key] = parsed;
-	await savePluginsJson(pluginsJson, isGlobal);
-
-	console.log(chalk.green(`✓ Set ${name}.${key} = ${JSON.stringify(parsed)}`));
-
-	if (varDef.env) {
-		console.log(chalk.dim(`  Environment variable: ${varDef.env}`));
-		console.log(chalk.dim(`  Export with: omp env`));
-	}
-
-	if (options.json) {
-		console.log(JSON.stringify({ plugin: name, variable: key, value: parsed }, null, 2));
-	}
-}
-
-/**
- * Delete a variable override (revert to default)
- * omp config @oh-my-pi/exa apiKey --delete
- */
-export async function deleteConfig(name: string, key: string, options: ConfigOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-	const pluginsJson = await loadPluginsJson(isGlobal);
-
-	if (!pluginsJson.plugins[name]) {
-		console.log(chalk.yellow(`Plugin "${name}" is not installed.`));
-		process.exitCode = 1;
-		return;
-	}
-
-	const config = pluginsJson.config?.[name];
-	// Check key presence with hasOwnProperty, not truthiness (allows deleting falsy values like false, 0, "", [])
-	if (!config?.variables || !Object.hasOwn(config.variables, key)) {
-		console.log(chalk.yellow(`Variable "${key}" is not set for ${name}.`));
-		return;
-	}
-
-	delete pluginsJson.config![name].variables![key];
-
-	// Clean up empty objects
-	if (Object.keys(pluginsJson.config![name].variables!).length === 0) {
-		delete pluginsJson.config![name].variables;
-	}
-	if (Object.keys(pluginsJson.config![name]).length === 0) {
-		delete pluginsJson.config![name];
-	}
-	if (Object.keys(pluginsJson.config!).length === 0) {
-		delete pluginsJson.config;
-	}
-
-	await savePluginsJson(pluginsJson, isGlobal);
-
-	console.log(chalk.green(`✓ Deleted ${name}.${key} (reverted to default)`));
-
-	if (options.json) {
-		console.log(JSON.stringify({ plugin: name, variable: key, deleted: true }, null, 2));
-	}
-}
-
-/**
- * Main config command handler
- * Routes to list, get, set, or delete based on arguments
- */
-export async function configCommand(
-	name: string,
-	keyOrOptions?: string | ConfigOptions,
-	valueOrOptions?: string | ConfigOptions,
-	options: ConfigOptions = {},
-): Promise<void> {
-	// Handle different argument patterns
-	let key: string | undefined;
-	let value: string | undefined;
-	let opts: ConfigOptions;
-
-	if (typeof keyOrOptions === "object") {
-		// omp config <name> [options]
-		opts = keyOrOptions;
-	} else if (typeof valueOrOptions === "object") {
-		// omp config <name> <key> [options]
-		key = keyOrOptions;
-		opts = valueOrOptions;
-	} else {
-		// omp config <name> <key> <value> [options]
-		key = keyOrOptions;
-		value = valueOrOptions;
-		opts = options;
-	}
-
-	if (!key) {
-		await listConfig(name, opts);
-	} else if (opts.delete) {
-		await deleteConfig(name, key, opts);
-	} else if (value !== undefined) {
-		await setConfig(name, key, value, opts);
-	} else {
-		await getConfig(name, key, opts);
-	}
-}