@oh-my-pi/cli 0.1.0

package/scripts/bump-version.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+set -e
+
+# Bump version across all packages
+# Usage: ./scripts/bump-version.sh <version>
+# Example: ./scripts/bump-version.sh 1.0.0
+
+if [[ -z "$1" ]]; then
+  echo "Usage: $0 <version>"
+  echo "Example: $0 1.0.0"
+  exit 1
+fi
+
+VERSION="$1"
+
+echo "📦 Bumping all packages to v$VERSION..."
+
+# Update root package.json
+echo "  Updating package.json..."
+bun --eval "
+const pkg = require('./package.json');
+pkg.version = '$VERSION';
+require('fs').writeFileSync('package.json', JSON.stringify(pkg, null, '\t') + '\n');
+"
+
+# Update plugins/subagents/package.json
+echo "  Updating plugins/subagents/package.json..."
+bun --eval "
+const pkg = require('./plugins/subagents/package.json');
+pkg.version = '$VERSION';
+require('fs').writeFileSync('plugins/subagents/package.json', JSON.stringify(pkg, null, 2) + '\n');
+"
+
+# Update plugins/metal-theme/package.json
+echo "  Updating plugins/metal-theme/package.json..."
+bun --eval "
+const pkg = require('./plugins/metal-theme/package.json');
+pkg.version = '$VERSION';
+require('fs').writeFileSync('plugins/metal-theme/package.json', JSON.stringify(pkg, null, 2) + '\n');
+"
+
+# Update version in CLI
+echo "  Updating src/cli.ts version..."
+sed -i "s/\.version(\"[^\"]*\")/.version(\"$VERSION\")/" src/cli.ts
+
+echo ""
+echo "✅ All packages bumped to v$VERSION"
+echo ""
+echo "Next steps:"
+echo "  1. git add -A && git commit -m 'chore: bump version to $VERSION'"
+echo "  2. git tag v$VERSION"
+echo "  3. git push && git push --tags"

package/scripts/publish.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+set -e
+
+# Publish all @oh-my-pi packages
+# Usage: ./scripts/publish.sh [--dry-run]
+
+DRY_RUN=""
+if [[ "$1" == "--dry-run" ]]; then
+  DRY_RUN="--dry-run"
+  echo "🔍 Dry run mode - no packages will be published"
+fi
+
+echo "📦 Publishing @oh-my-pi packages..."
+echo ""
+
+# Build first
+echo "🔨 Building CLI..."
+bun run build
+
+# Publish CLI
+echo ""
+echo "📤 Publishing @oh-my-pi/cli..."
+npm publish --access public $DRY_RUN
+
+# Publish plugins
+echo ""
+echo "📤 Publishing @oh-my-pi/subagents..."
+cd plugins/subagents && npm publish --access public $DRY_RUN && cd ../..
+
+echo ""
+echo "📤 Publishing @oh-my-pi/metal-theme..."
+cd plugins/metal-theme && npm publish --access public $DRY_RUN && cd ../..
+
+echo ""
+echo "✅ All packages published!"

package/src/cli.ts

@@ -0,0 +1,167 @@
+#!/usr/bin/env bun
+
+import { program } from "commander";
+import { createPlugin } from "./commands/create.js";
+import { runDoctor } from "./commands/doctor.js";
+import { disablePlugin, enablePlugin } from "./commands/enable.js";
+import { showInfo } from "./commands/info.js";
+import { initProject } from "./commands/init.js";
+import { installPlugin } from "./commands/install.js";
+import { linkPlugin } from "./commands/link.js";
+import { listPlugins } from "./commands/list.js";
+import { showOutdated } from "./commands/outdated.js";
+import { searchPlugins } from "./commands/search.js";
+import { uninstallPlugin } from "./commands/uninstall.js";
+import { updatePlugin } from "./commands/update.js";
+import { whyFile } from "./commands/why.js";
+import { checkMigration, migrateToNpm } from "./migrate.js";
+
+program.name("omp").description("Oh My Pi - Plugin manager for pi configuration").version("0.1.0");
+
+// Check for migration on startup (only for commands that need it)
+program.hook("preAction", async (thisCommand) => {
+	const migratingCommands = ["install", "uninstall", "update", "list", "link"];
+	if (migratingCommands.includes(thisCommand.name())) {
+		await checkMigration();
+	}
+});
+
+// ============================================================================
+// 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
+  $ omp install @oh-my-pi/subagents@^2.0.0  # Specific version range
+  $ omp install @myorg/cool-theme           # Scoped package
+  $ omp install ./local/path            # Local directory (copies)
+  $ omp install                         # Install all from plugins.json
+`,
+	)
+	.option("-g, --global", "Install globally to ~/.pi (default)")
+	.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(installPlugin);
+
+program
+	.command("uninstall <name>")
+	.alias("rm")
+	.description("Remove plugin and its symlinks")
+	.option("-g, --global", "Uninstall from ~/.pi (default)")
+	.option("--json", "Output as JSON")
+	.action(uninstallPlugin);
+
+program
+	.command("update [name]")
+	.alias("up")
+	.description("Update to latest within semver range")
+	.option("-g, --global", "Update global plugins (default)")
+	.option("--json", "Output as JSON")
+	.action(updatePlugin);
+
+program
+	.command("list")
+	.alias("ls")
+	.description("Show installed plugins")
+	.option("-g, --global", "List global plugins (default)")
+	.option("--json", "Output as JSON")
+	.action(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 (default)")
+	.action(linkPlugin);
+
+// ============================================================================
+// New Commands
+// ============================================================================
+
+program
+	.command("init")
+	.description("Create .pi/plugins.json in current project")
+	.option("--force", "Overwrite existing plugins.json")
+	.action(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((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")
+	.action(showInfo);
+
+program
+	.command("outdated")
+	.description("List plugins with newer versions")
+	.option("-g, --global", "Check global plugins (default)")
+	.option("--json", "Output as JSON")
+	.action(showOutdated);
+
+program
+	.command("doctor")
+	.description("Check for broken symlinks, conflicts")
+	.option("-g, --global", "Check global plugins (default)")
+	.option("--fix", "Attempt to fix issues")
+	.option("--json", "Output as JSON")
+	.action(runDoctor);
+
+program
+	.command("create <name>")
+	.description("Scaffold new plugin from template")
+	.option("-d, --description <desc>", "Plugin description")
+	.option("-a, --author <author>", "Plugin author")
+	.action(createPlugin);
+
+program
+	.command("why <file>")
+	.description("Show which plugin installed a file")
+	.option("-g, --global", "Check global plugins (default)")
+	.option("--json", "Output as JSON")
+	.action(whyFile);
+
+program
+	.command("enable <name>")
+	.description("Enable a disabled plugin")
+	.option("-g, --global", "Target global plugins (default)")
+	.option("--json", "Output as JSON")
+	.action(enablePlugin);
+
+program
+	.command("disable <name>")
+	.description("Disable plugin without uninstalling")
+	.option("-g, --global", "Target global plugins (default)")
+	.option("--json", "Output as JSON")
+	.action(disablePlugin);
+
+program
+	.command("migrate")
+	.description("Migrate from legacy manifest.json to npm-native format")
+	.action(async () => {
+		await migrateToNpm();
+	});
+
+program.parse();

package/src/commands/create.ts

@@ -0,0 +1,153 @@
+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;
+}
+
+/**
+ * Scaffold a new plugin from template
+ */
+export async function createPlugin(name: string, options: CreateOptions = {}): Promise<void> {
+	// Ensure name follows conventions
+	const pluginName = name.startsWith("omp-") ? name : `omp-${name}`;
+	const pluginDir = pluginName;
+
+	if (existsSync(pluginDir)) {
+		console.log(chalk.red(`Error: Directory ${pluginDir} already exists`));
+		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}`));
+	}
+}

package/src/commands/doctor.ts

@@ -0,0 +1,217 @@
+import { existsSync } from "node:fs";
+import chalk from "chalk";
+import { detectAllConflicts, formatConflicts } from "../conflicts.js";
+import { getInstalledPlugins, loadPluginsJson, readPluginPackageJson } from "../manifest.js";
+import { GLOBAL_PACKAGE_JSON, NODE_MODULES_DIR, PLUGINS_DIR } from "../paths.js";
+import { checkPluginSymlinks } from "../symlinks.js";
+
+export interface DoctorOptions {
+	global?: 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 = options.global !== false;
+	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 : ".pi/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 : ".pi/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",
+		});
+	}
+
+	// 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`));
+		}
+		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}`));
+		}
+	}
+}