@oh-my-pi/cli 0.3.0 → 0.5.0

package/src/commands/create.ts

@@ -1,203 +0,0 @@
-import { existsSync } from "node:fs";
-import { mkdir, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-import chalk from "chalk";
-
-export interface CreateOptions {
-	description?: string;
-	author?: string;
-}
-
-const VALID_NPM_CHARS = new Set("abcdefghijklmnopqrstuvwxyz0123456789-_.");
-
-/**
- * Validate that a name conforms to npm naming rules
- */
-function isValidNpmName(name: string): boolean {
-	if (!name || name.length === 0) return false;
-	if (name.startsWith(".") || name.startsWith("_")) return false;
-	if (name.includes(" ")) return false;
-	for (const char of name) {
-		if (!VALID_NPM_CHARS.has(char)) return false;
-	}
-	return true;
-}
-
-/**
- * Normalize a string to be a valid npm package name
- */
-function normalizePluginName(name: string): string {
-	let normalized = name.toLowerCase().split(" ").join("-");
-
-	// Remove invalid characters (keep alphanumeric, -, _, .)
-	normalized = Array.from(normalized)
-		.filter((char) => VALID_NPM_CHARS.has(char))
-		.join("");
-
-	// Can't start with . or _ or -
-	while (normalized.startsWith(".") || normalized.startsWith("_") || normalized.startsWith("-")) {
-		normalized = normalized.slice(1);
-	}
-
-	return normalized;
-}
-
-/**
- * Scaffold a new plugin from template
- */
-export async function createPlugin(name: string, options: CreateOptions = {}): Promise<void> {
-	// Ensure name follows conventions
-	let pluginName = name.startsWith("omp-") ? name : `omp-${name}`;
-
-	// Validate and normalize the plugin name
-	if (!isValidNpmName(pluginName)) {
-		const normalized = normalizePluginName(pluginName);
-		if (!normalized || normalized === "omp-" || normalized === "omp") {
-			console.log(chalk.red(`Error: Invalid plugin name "${name}" cannot be normalized to a valid npm name`));
-			process.exitCode = 1;
-			return;
-		}
-		// Ensure omp- prefix after normalization
-		const finalName = normalized.startsWith("omp-") ? normalized : `omp-${normalized}`;
-		console.log(chalk.yellow(`Invalid plugin name. Normalized to: ${finalName}`));
-		pluginName = finalName;
-	}
-	const pluginDir = pluginName;
-
-	if (existsSync(pluginDir)) {
-		console.log(chalk.red(`Error: Directory ${pluginDir} already exists`));
-		process.exitCode = 1;
-		return;
-	}
-
-	console.log(chalk.blue(`Creating plugin: ${pluginName}...`));
-
-	try {
-		// Create directory structure
-		await mkdir(pluginDir, { recursive: true });
-		await mkdir(join(pluginDir, "agents"), { recursive: true });
-		await mkdir(join(pluginDir, "tools"), { recursive: true });
-		await mkdir(join(pluginDir, "themes"), { recursive: true });
-		await mkdir(join(pluginDir, "commands"), { recursive: true });
-
-		// Create package.json
-		const packageJson = {
-			name: pluginName,
-			version: "0.1.0",
-			description: options.description || `A pi plugin`,
-			keywords: ["omp-plugin"],
-			author: options.author || "",
-			license: "MIT",
-			omp: {
-				install: [],
-			},
-			files: ["agents", "tools", "themes", "commands"],
-		};
-
-		await writeFile(join(pluginDir, "package.json"), JSON.stringify(packageJson, null, 2));
-
-		// Create README.md
-		const readme = `# ${pluginName}
-
-${options.description || "A pi plugin."}
-
-## Installation
-
-\`\`\`bash
-omp install ${pluginName}
-\`\`\`
-
-## Contents
-
-### Agents
-
-Add agent markdown files to \`agents/\` directory.
-
-### Tools
-
-Add tool implementations to \`tools/\` directory.
-
-### Themes
-
-Add theme JSON files to \`themes/\` directory.
-
-### Commands
-
-Add command markdown files to \`commands/\` directory.
-
-## Configuration
-
-Edit \`package.json\` to configure which files are installed:
-
-\`\`\`json
-{
-  "omp": {
-    "install": [
-      { "src": "agents/my-agent.md", "dest": "agent/agents/my-agent.md" },
-      { "src": "tools/my-tool/", "dest": "agent/tools/my-tool/" }
-    ]
-  }
-}
-\`\`\`
-
-## Publishing
-
-1. Update version in package.json
-2. Run \`npm publish\`
-
-Users can then install with: \`omp install ${pluginName}\`
-
-## License
-
-MIT
-`;
-
-		await writeFile(join(pluginDir, "README.md"), readme);
-
-		// Create example agent
-		const exampleAgent = `# Example Agent
-
-This is an example agent for ${pluginName}.
-
-## Description
-
-Describe what this agent does.
-
-## Instructions
-
-Provide instructions for the agent here.
-`;
-
-		await writeFile(join(pluginDir, "agents", "example.md"), exampleAgent);
-
-		// Create .gitignore
-		const gitignore = `node_modules/
-.DS_Store
-*.log
-`;
-		await writeFile(join(pluginDir, ".gitignore"), gitignore);
-
-		console.log(chalk.green(`\n✓ Created plugin at ${pluginDir}/`));
-		console.log();
-		console.log(chalk.dim("Directory structure:"));
-		console.log(chalk.dim(`  ${pluginDir}/`));
-		console.log(chalk.dim("  ├── package.json"));
-		console.log(chalk.dim("  ├── README.md"));
-		console.log(chalk.dim("  ├── .gitignore"));
-		console.log(chalk.dim("  ├── agents/"));
-		console.log(chalk.dim("  │   └── example.md"));
-		console.log(chalk.dim("  ├── tools/"));
-		console.log(chalk.dim("  ├── themes/"));
-		console.log(chalk.dim("  └── commands/"));
-		console.log();
-		console.log(chalk.dim("Next steps:"));
-		console.log(chalk.dim(`  1. cd ${pluginDir}`));
-		console.log(chalk.dim("  2. Add your agents, tools, themes, or commands"));
-		console.log(chalk.dim("  3. Update omp.install in package.json"));
-		console.log(chalk.dim("  4. Test locally: omp link ."));
-		console.log(chalk.dim("  5. Publish: npm publish"));
-	} catch (err) {
-		console.log(chalk.red(`Error creating plugin: ${(err as Error).message}`));
-		process.exitCode = 1;
-	}
-}

package/src/commands/doctor.ts

@@ -1,305 +0,0 @@
-import { existsSync } from "node:fs";
-import { detectAllConflicts, formatConflicts } from "@omp/conflicts";
-import { getInstalledPlugins, loadPluginsJson, readPluginPackageJson, savePluginsJson } from "@omp/manifest";
-import {
-	GLOBAL_PACKAGE_JSON,
-	NODE_MODULES_DIR,
-	PLUGINS_DIR,
-	PROJECT_NODE_MODULES,
-	PROJECT_PLUGINS_JSON,
-	resolveScope,
-} from "@omp/paths";
-import { checkPluginSymlinks, createPluginSymlinks } from "@omp/symlinks";
-import chalk from "chalk";
-
-export interface DoctorOptions {
-	global?: boolean;
-	local?: boolean;
-	fix?: boolean;
-	json?: boolean;
-}
-
-interface DiagnosticResult {
-	check: string;
-	status: "ok" | "warning" | "error";
-	message: string;
-	fix?: string;
-}
-
-/**
- * Run health checks on the plugin system
- */
-export async function runDoctor(options: DoctorOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-	const results: DiagnosticResult[] = [];
-
-	console.log(chalk.blue("Running health checks...\n"));
-
-	// 1. Check plugins directory exists
-	const pluginsDir = isGlobal ? PLUGINS_DIR : ".pi";
-	if (!existsSync(pluginsDir)) {
-		results.push({
-			check: "Plugins directory",
-			status: "warning",
-			message: `${pluginsDir} does not exist`,
-			fix: "Run: omp install <package>",
-		});
-	} else {
-		results.push({
-			check: "Plugins directory",
-			status: "ok",
-			message: pluginsDir,
-		});
-	}
-
-	// 2. Check package.json exists
-	const packageJsonPath = isGlobal ? GLOBAL_PACKAGE_JSON : PROJECT_PLUGINS_JSON;
-	if (!existsSync(packageJsonPath)) {
-		results.push({
-			check: "Package manifest",
-			status: "warning",
-			message: `${packageJsonPath} does not exist`,
-			fix: isGlobal ? "Run: omp install <package>" : "Run: omp init",
-		});
-	} else {
-		results.push({
-			check: "Package manifest",
-			status: "ok",
-			message: packageJsonPath,
-		});
-	}
-
-	// 3. Check node_modules exists
-	const nodeModules = isGlobal ? NODE_MODULES_DIR : PROJECT_NODE_MODULES;
-	if (!existsSync(nodeModules)) {
-		results.push({
-			check: "Node modules",
-			status: "warning",
-			message: `${nodeModules} does not exist`,
-		});
-	} else {
-		results.push({
-			check: "Node modules",
-			status: "ok",
-			message: nodeModules,
-		});
-	}
-
-	// 4. Check each plugin's symlinks
-	const installedPlugins = await getInstalledPlugins(isGlobal);
-	const brokenSymlinks: string[] = [];
-	const missingSymlinks: string[] = [];
-
-	for (const [name, pkgJson] of installedPlugins) {
-		const symlinkStatus = await checkPluginSymlinks(name, pkgJson, isGlobal);
-
-		if (symlinkStatus.broken.length > 0) {
-			brokenSymlinks.push(...symlinkStatus.broken.map((s) => `${name}: ${s}`));
-		}
-		if (symlinkStatus.missing.length > 0) {
-			missingSymlinks.push(...symlinkStatus.missing.map((s) => `${name}: ${s}`));
-		}
-	}
-
-	if (brokenSymlinks.length > 0) {
-		results.push({
-			check: "Broken symlinks",
-			status: "error",
-			message: `${brokenSymlinks.length} broken symlink(s)`,
-			fix: "Run: omp update <plugin> to re-create symlinks",
-		});
-	} else {
-		results.push({
-			check: "Symlinks",
-			status: "ok",
-			message: "All symlinks valid",
-		});
-	}
-
-	if (missingSymlinks.length > 0) {
-		results.push({
-			check: "Missing symlinks",
-			status: "warning",
-			message: `${missingSymlinks.length} expected symlink(s) not found`,
-			fix: "Run: omp update <plugin> to re-create symlinks",
-		});
-	}
-
-	// 5. Check for conflicts
-	const conflicts = detectAllConflicts(installedPlugins);
-	if (conflicts.length > 0) {
-		results.push({
-			check: "Conflicts",
-			status: "warning",
-			message: formatConflicts(conflicts).join("; "),
-		});
-	} else {
-		results.push({
-			check: "Conflicts",
-			status: "ok",
-			message: "No conflicts detected",
-		});
-	}
-
-	// 6. Check for orphaned entries in package.json
-	const pluginsJson = await loadPluginsJson(isGlobal);
-	const orphaned: string[] = [];
-	for (const name of Object.keys(pluginsJson.plugins)) {
-		const pkgJson = await readPluginPackageJson(name, isGlobal);
-		if (!pkgJson) {
-			orphaned.push(name);
-		}
-	}
-
-	if (orphaned.length > 0) {
-		results.push({
-			check: "Orphaned entries",
-			status: "warning",
-			message: `${orphaned.length} plugin(s) in manifest but not in node_modules: ${orphaned.join(", ")}`,
-			fix: "Run: omp install (to reinstall) or remove from manifest",
-		});
-	}
-
-	// 7. Check for missing omp dependencies
-	const missingDeps: string[] = [];
-	for (const [name, pkgJson] of installedPlugins) {
-		if (pkgJson.dependencies) {
-			for (const depName of Object.keys(pkgJson.dependencies)) {
-				const depPkgJson = await readPluginPackageJson(depName, isGlobal);
-				if (!depPkgJson) {
-					// Dependency not found in node_modules
-					// Check if it's supposed to be an omp plugin by looking in the plugins manifest
-					if (pluginsJson.plugins[depName]) {
-						missingDeps.push(`${name} requires ${depName} (not in node_modules)`);
-					}
-				} else if (depPkgJson.omp?.install && depPkgJson.omp.install.length > 0) {
-					// Dependency is an omp plugin (has install entries) and is present - that's fine
-					// But check if it's registered in the plugins manifest
-					if (!pluginsJson.plugins[depName]) {
-						missingDeps.push(`${name} requires omp plugin ${depName} (installed but not in manifest)`);
-					}
-				}
-			}
-		}
-	}
-
-	if (missingDeps.length > 0) {
-		results.push({
-			check: "Missing omp dependencies",
-			status: "warning",
-			message: missingDeps.join("; "),
-			fix: isGlobal ? "Run: npm install in ~/.pi/plugins" : "Run: npm install in .pi",
-		});
-	}
-
-	// Output results
-	if (options.json) {
-		console.log(JSON.stringify({ results }, null, 2));
-		return;
-	}
-
-	for (const result of results) {
-		let icon: string;
-		let color: typeof chalk;
-
-		switch (result.status) {
-			case "ok":
-				icon = "✓";
-				color = chalk.green;
-				break;
-			case "warning":
-				icon = "⚠";
-				color = chalk.yellow;
-				break;
-			case "error":
-				icon = "✗";
-				color = chalk.red;
-				break;
-		}
-
-		console.log(color(`${icon} ${result.check}: `) + result.message);
-
-		if (result.fix && result.status !== "ok") {
-			console.log(chalk.dim(`    ${result.fix}`));
-		}
-	}
-
-	// Summary
-	const errors = results.filter((r) => r.status === "error");
-	const warnings = results.filter((r) => r.status === "warning");
-
-	console.log();
-	if (errors.length === 0 && warnings.length === 0) {
-		console.log(chalk.green("✓ All checks passed!"));
-	} else {
-		if (errors.length > 0) {
-			console.log(chalk.red(`${errors.length} error(s) found`));
-			process.exitCode = 1;
-		}
-		if (warnings.length > 0) {
-			console.log(chalk.yellow(`${warnings.length} warning(s) found`));
-		}
-	}
-
-	// Show broken symlinks details
-	if (brokenSymlinks.length > 0) {
-		console.log(chalk.red("\nBroken symlinks:"));
-		for (const s of brokenSymlinks) {
-			console.log(chalk.dim(`  - ${s}`));
-		}
-	}
-
-	if (missingSymlinks.length > 0) {
-		console.log(chalk.yellow("\nMissing symlinks:"));
-		for (const s of missingSymlinks) {
-			console.log(chalk.dim(`  - ${s}`));
-		}
-	}
-
-	// Apply fixes if --fix flag was passed
-	if (options.fix) {
-		let fixedAnything = false;
-
-		// Fix broken/missing symlinks by re-creating them
-		if (brokenSymlinks.length > 0 || missingSymlinks.length > 0) {
-			console.log(chalk.blue("\nAttempting to fix broken/missing symlinks..."));
-			for (const [name, pkgJson] of installedPlugins) {
-				const symlinkResult = await createPluginSymlinks(name, pkgJson, isGlobal, false);
-				if (symlinkResult.created.length > 0) {
-					fixedAnything = true;
-					console.log(chalk.green(`  ✓ Re-created symlinks for ${name}`));
-				}
-				if (symlinkResult.errors.length > 0) {
-					for (const err of symlinkResult.errors) {
-						console.log(chalk.red(`  ✗ ${name}: ${err}`));
-					}
-				}
-			}
-		}
-
-		// Remove orphaned manifest entries
-		if (orphaned.length > 0) {
-			console.log(chalk.blue("\nRemoving orphaned entries from manifest..."));
-			for (const name of orphaned) {
-				delete pluginsJson.plugins[name];
-				console.log(chalk.green(`  ✓ Removed ${name}`));
-			}
-			await savePluginsJson(pluginsJson, isGlobal);
-			fixedAnything = true;
-		}
-
-		// Conflicts cannot be auto-fixed
-		if (conflicts.length > 0) {
-			console.log(chalk.yellow("\nConflicts cannot be auto-fixed. Please resolve manually:"));
-			for (const conflict of formatConflicts(conflicts)) {
-				console.log(chalk.dim(`  - ${conflict}`));
-			}
-		}
-
-		if (fixedAnything) {
-			console.log(chalk.green("\n✓ Fixes applied. Run 'omp doctor' again to verify."));
-		} else if (conflicts.length === 0) {
-			console.log(chalk.dim("\nNo fixable issues found."));
-		}
-	}
-}

package/src/commands/enable.ts

@@ -1,122 +0,0 @@
-import { loadPluginsJson, readPluginPackageJson, savePluginsJson } from "@omp/manifest";
-import { resolveScope } from "@omp/paths";
-import { checkPluginSymlinks, createPluginSymlinks, removePluginSymlinks } from "@omp/symlinks";
-import chalk from "chalk";
-
-export interface EnableDisableOptions {
-	global?: boolean;
-	local?: boolean;
-	json?: boolean;
-}
-
-/**
- * Enable a disabled plugin (re-create symlinks)
- */
-export async function enablePlugin(name: string, options: EnableDisableOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-
-	const pluginsJson = await loadPluginsJson(isGlobal);
-
-	// Check if plugin exists
-	if (!pluginsJson.plugins[name]) {
-		console.log(chalk.yellow(`Plugin "${name}" is not installed.`));
-		process.exitCode = 1;
-		return;
-	}
-
-	// Check if already enabled
-	if (!pluginsJson.disabled?.includes(name)) {
-		console.log(chalk.yellow(`Plugin "${name}" is already enabled.`));
-		process.exitCode = 1;
-		return;
-	}
-
-	try {
-		// Read package.json
-		const pkgJson = await readPluginPackageJson(name, isGlobal);
-		if (!pkgJson) {
-			console.log(chalk.red(`Could not read package.json for ${name}`));
-			process.exitCode = 1;
-			return;
-		}
-
-		// Check if symlinks are already in place
-		const symlinkStatus = await checkPluginSymlinks(name, pkgJson, isGlobal);
-
-		if (symlinkStatus.valid.length > 0 && symlinkStatus.broken.length === 0 && symlinkStatus.missing.length === 0) {
-			console.log(chalk.yellow(`Plugin "${name}" symlinks are already in place.`));
-		} else {
-			// Re-create symlinks
-			console.log(chalk.blue(`Enabling ${name}...`));
-			await createPluginSymlinks(name, pkgJson, isGlobal);
-		}
-
-		// Remove from disabled list
-		pluginsJson.disabled = pluginsJson.disabled.filter((n) => n !== name);
-		await savePluginsJson(pluginsJson, isGlobal);
-
-		console.log(chalk.green(`✓ Enabled "${name}"`));
-
-		if (options.json) {
-			console.log(JSON.stringify({ name, enabled: true }, null, 2));
-		}
-	} catch (err) {
-		console.log(chalk.red(`Error enabling plugin: ${(err as Error).message}`));
-		process.exitCode = 1;
-	}
-}
-
-/**
- * Disable a plugin (remove symlinks but keep installed)
- */
-export async function disablePlugin(name: string, options: EnableDisableOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-
-	const pluginsJson = await loadPluginsJson(isGlobal);
-
-	// Check if plugin exists
-	if (!pluginsJson.plugins[name]) {
-		console.log(chalk.yellow(`Plugin "${name}" is not installed.`));
-		process.exitCode = 1;
-		return;
-	}
-
-	// Check if already disabled
-	if (pluginsJson.disabled?.includes(name)) {
-		console.log(chalk.yellow(`Plugin "${name}" is already disabled.`));
-		process.exitCode = 1;
-		return;
-	}
-
-	try {
-		// Read package.json
-		const pkgJson = await readPluginPackageJson(name, isGlobal);
-		if (!pkgJson) {
-			console.log(chalk.red(`Could not read package.json for ${name}`));
-			process.exitCode = 1;
-			return;
-		}
-
-		// Remove symlinks
-		console.log(chalk.blue(`Disabling ${name}...`));
-		await removePluginSymlinks(name, pkgJson, isGlobal);
-
-		// Add to disabled list
-		if (!pluginsJson.disabled) {
-			pluginsJson.disabled = [];
-		}
-		pluginsJson.disabled.push(name);
-		await savePluginsJson(pluginsJson, isGlobal);
-
-		console.log(chalk.green(`✓ Disabled "${name}"`));
-		console.log(chalk.dim("  Plugin is still installed, symlinks removed"));
-		console.log(chalk.dim(`  Re-enable with: omp enable ${name}`));
-
-		if (options.json) {
-			console.log(JSON.stringify({ name, enabled: false }, null, 2));
-		}
-	} catch (err) {
-		console.log(chalk.red(`Error disabling plugin: ${(err as Error).message}`));
-		process.exitCode = 1;
-	}
-}

package/src/commands/env.ts

@@ -1,38 +0,0 @@
-import { resolveScope } from "@omp/paths";
-import { generateEnvScript, getEnvJson } from "@omp/runtime";
-import chalk from "chalk";
-
-export interface EnvOptions {
-	global?: boolean;
-	local?: boolean;
-	json?: boolean;
-	fish?: boolean;
-}
-
-/**
- * Output environment variables for plugins
- * omp env                     # Print shell exports (sh/bash/zsh)
- * omp env --fish              # Print fish shell syntax
- * omp env --json              # Print as JSON
- */
-export async function envCommand(options: EnvOptions = {}): Promise<void> {
-	const isGlobal = resolveScope(options);
-
-	if (options.json) {
-		const vars = await getEnvJson(isGlobal);
-		console.log(JSON.stringify(vars, null, 2));
-		return;
-	}
-
-	const shell = options.fish ? "fish" : "sh";
-	const script = await generateEnvScript(isGlobal, shell);
-
-	if (script.length === 0) {
-		console.error(chalk.yellow("No environment variables configured."));
-		console.error(chalk.dim("Set variables with: omp config <plugin> <variable> <value>"));
-		return;
-	}
-
-	// Output script directly (for eval or sourcing)
-	console.log(script);
-}