@oh-my-pi/cli 0.1.0 → 0.3.0

package/plugins/user-prompt/tools/user-prompt/index.ts

@@ -0,0 +1,235 @@
+/**
+ * User Prompt Tool - Ask questions to the user during execution
+ *
+ * Use this tool when you need to ask the user questions during execution.
+ * This allows you to:
+ *   1. Gather user preferences or requirements
+ *   2. Clarify ambiguous instructions
+ *   3. Get decisions on implementation choices as you work
+ *   4. Offer choices to the user about what direction to take
+ *
+ * Usage notes:
+ *   - Users will always be able to select "Other" to provide custom text input
+ *   - Use multi: true to allow multiple answers to be selected for a question
+ *   - If you recommend a specific option, make that the first option in the list
+ *     and add "(Recommended)" at the end of the label
+ */
+
+import { Type } from "@sinclair/typebox";
+import { Text } from "@mariozechner/pi-tui";
+import type { CustomAgentTool, CustomToolFactory, ToolAPI } from "@mariozechner/pi-coding-agent";
+
+// =============================================================================
+// Tool Definition
+// =============================================================================
+
+const OTHER_OPTION = "Other (type your own)";
+
+const OptionItem = Type.Object({
+   label: Type.String({ description: "Display label for this option" }),
+});
+
+const UserPromptParams = Type.Object({
+   question: Type.String({ description: "The question to ask the user" }),
+   options: Type.Array(OptionItem, {
+      description: "Available options for the user to choose from.",
+      minItems: 1,
+   }),
+   multi: Type.Optional(Type.Boolean({
+      description: "Allow multiple options to be selected (default: false)",
+      default: false,
+   })),
+});
+
+interface UserPromptDetails {
+   question: string;
+   options: string[];
+   multi: boolean;
+   selectedOptions: string[];
+   customInput?: string;
+}
+
+const DESCRIPTION = `Use this tool when you need to ask the user questions during execution. This allows you to:
+1. Gather user preferences or requirements
+2. Clarify ambiguous instructions
+3. Get decisions on implementation choices as you work
+4. Offer choices to the user about what direction to take.
+
+Usage notes:
+- Users will always be able to select "Other" to provide custom text input
+- Use multi: true to allow multiple answers to be selected for a question
+- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label
+
+Example usage:
+
+<example>
+assistant: Let me ask which features you want to include.
+assistant: Uses the user_prompt tool:
+{
+  "question": "Which features should I implement?",
+  "options": [
+    {"label": "Authentication"},
+    {"label": "API endpoints"},
+    {"label": "Database models"},
+    {"label": "Unit tests"},
+    {"label": "Documentation"}
+  ],
+  "multi": true
+}
+</example>`;
+
+const factory: CustomToolFactory = (pi: ToolAPI) => {
+   const tool: CustomAgentTool<typeof UserPromptParams, UserPromptDetails> = {
+      name: "user_prompt",
+      label: "User Prompt",
+      description: DESCRIPTION,
+      parameters: UserPromptParams,
+
+      async execute(_toolCallId, params, _signal, _onUpdate) {
+         const { question, options, multi = false } = params;
+         const optionLabels = options.map((o) => o.label);
+
+         if (!pi.hasUI) {
+            return {
+               content: [{ type: "text", text: "Error: User prompt requires interactive mode" }],
+               details: { question, options: optionLabels, multi, selectedOptions: [] },
+            };
+         }
+
+         let selectedOptions: string[] = [];
+         let customInput: string | undefined;
+
+         if (multi) {
+            // Multi-select: show checkboxes in the label to indicate selection state
+            const DONE = "✓ Done selecting";
+            const selected = new Set<string>();
+
+            while (true) {
+               // Build options with checkbox indicators
+               const opts: string[] = [];
+               
+               // Add "Done" option if any selected
+               if (selected.size > 0) {
+                  opts.push(DONE);
+               }
+               
+               // Add all options with [X] or [ ] prefix
+               for (const opt of optionLabels) {
+                  const checkbox = selected.has(opt) ? "[X]" : "[ ]";
+                  opts.push(`${checkbox} ${opt}`);
+               }
+               
+               // Add "Other" option
+               opts.push(OTHER_OPTION);
+
+               const prefix = selected.size > 0 ? `(${selected.size} selected) ` : "";
+               const choice = await pi.ui.select(`${prefix}${question}`, opts);
+
+               if (choice === null || choice === DONE) break;
+               
+               if (choice === OTHER_OPTION) {
+                  const input = await pi.ui.input("Enter your response:");
+                  if (input) customInput = input;
+                  break;
+               }
+               
+               // Toggle selection - extract the actual option name
+               const optMatch = choice.match(/^\[.\] (.+)$/);
+               if (optMatch) {
+                  const opt = optMatch[1];
+                  if (selected.has(opt)) {
+                     selected.delete(opt);
+                  } else {
+                     selected.add(opt);
+                  }
+               }
+            }
+            selectedOptions = Array.from(selected);
+         } else {
+            // Single select with "Other" option
+            const choice = await pi.ui.select(question, [...optionLabels, OTHER_OPTION]);
+            if (choice === OTHER_OPTION) {
+               const input = await pi.ui.input("Enter your response:");
+               if (input) customInput = input;
+            } else if (choice) {
+               selectedOptions = [choice];
+            }
+         }
+
+         const details: UserPromptDetails = {
+            question,
+            options: optionLabels,
+            multi,
+            selectedOptions,
+            customInput,
+         };
+
+         let responseText: string;
+         if (customInput) {
+            responseText = `User provided custom input: ${customInput}`;
+         } else if (selectedOptions.length > 0) {
+            responseText = multi
+               ? `User selected: ${selectedOptions.join(", ")}`
+               : `User selected: ${selectedOptions[0]}`;
+         } else {
+            responseText = "User cancelled the selection";
+         }
+
+         return { content: [{ type: "text", text: responseText }], details };
+      },
+
+      renderCall(args, t) {
+         if (!args.question) {
+            return new Text(t.fg("error", "user_prompt: no question provided"), 0, 0);
+         }
+
+         const multiTag = args.multi ? t.fg("muted", " [multi-select]") : "";
+         let text = t.fg("toolTitle", "? ") + t.fg("accent", args.question) + multiTag;
+
+         if (args.options?.length) {
+            for (const opt of args.options) {
+               text += "\n" + t.fg("dim", "  ○ ") + t.fg("muted", opt.label);
+            }
+            text += "\n" + t.fg("dim", "  ○ ") + t.fg("muted", "Other (custom input)");
+         }
+
+         return new Text(text, 0, 0);
+      },
+
+      renderResult(result, { expanded }, t) {
+         const { details } = result;
+         if (!details) {
+            const txt = result.content[0];
+            return new Text(txt?.type === "text" ? txt.text : "", 0, 0);
+         }
+
+         let text = t.fg("toolTitle", "? ") + t.fg("accent", details.question);
+
+         if (details.customInput) {
+            // Custom input provided
+            text += "\n" + t.fg("dim", "  ⎿ ") + t.fg("success", details.customInput);
+         } else if (details.selectedOptions.length > 0) {
+            // Show only selected options
+            const selected = details.selectedOptions;
+            if (selected.length === 1) {
+               text += "\n" + t.fg("dim", "  ⎿ ") + t.fg("success", selected[0]);
+            } else {
+               // Multiple selections
+               for (let i = 0; i < selected.length; i++) {
+                  const isLast = i === selected.length - 1;
+                  const branch = isLast ? "└─" : "├─";
+                  text += "\n" + t.fg("dim", `  ${branch} `) + t.fg("success", selected[i]);
+               }
+            }
+         } else {
+            text += "\n" + t.fg("dim", "  ⎿ ") + t.fg("warning", "Cancelled");
+         }
+
+         return new Text(text, 0, 0);
+      },
+   };
+
+   return tool;
+};
+
+export default factory;

package/src/cli.ts

@@ -1,30 +1,34 @@
 #!/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";
-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();
-	}
-});
+
+// 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.2.0");
 
 // ============================================================================
 // Core Commands
@@ -38,43 +42,50 @@ program
 		"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
+  $ 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 (default)")
+	.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(installPlugin);
+	.action(withErrorHandling(installPlugin));
 
 program
 	.command("uninstall <name>")
 	.alias("rm")
 	.description("Remove plugin and its symlinks")
-	.option("-g, --global", "Uninstall from ~/.pi (default)")
+	.option("-g, --global", "Uninstall from ~/.pi")
+	.option("-l, --local", "Uninstall from project-local .pi/")
 	.option("--json", "Output as JSON")
-	.action(uninstallPlugin);
+	.action(withErrorHandling(uninstallPlugin));
 
 program
 	.command("update [name]")
 	.alias("up")
 	.description("Update to latest within semver range")
-	.option("-g, --global", "Update global plugins (default)")
+	.option("-g, --global", "Update global plugins")
+	.option("-l, --local", "Update project-local plugins")
 	.option("--json", "Output as JSON")
-	.action(updatePlugin);
+	.action(withErrorHandling(updatePlugin));
 
 program
 	.command("list")
 	.alias("ls")
 	.description("Show installed plugins")
-	.option("-g, --global", "List global plugins (default)")
+	.option("-g, --global", "List global plugins")
+	.option("-l, --local", "List project-local plugins")
 	.option("--json", "Output as JSON")
-	.action(listPlugins);
+	.action(withErrorHandling(listPlugins));
 
 program
 	.command("link <path>")
@@ -87,8 +98,10 @@ so changes are reflected immediately without reinstalling.
 `,
 	)
 	.option("-n, --name <name>", "Custom name for the plugin")
-	.option("-g, --global", "Link globally (default)")
-	.action(linkPlugin);
+	.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
@@ -98,70 +111,132 @@ program
 	.command("init")
 	.description("Create .pi/plugins.json in current project")
 	.option("--force", "Overwrite existing plugins.json")
-	.action(initProject);
+	.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((query, options) => searchPlugins(query, { ...options, limit: parseInt(options.limit, 10) }));
+	.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")
-	.action(showInfo);
+	.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 (default)")
+	.option("-g, --global", "Check global plugins")
+	.option("-l, --local", "Check project-local plugins")
 	.option("--json", "Output as JSON")
-	.action(showOutdated);
+	.action(withErrorHandling(showOutdated));
 
 program
 	.command("doctor")
 	.description("Check for broken symlinks, conflicts")
-	.option("-g, --global", "Check global plugins (default)")
+	.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(runDoctor);
+	.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(createPlugin);
+	.action(withErrorHandling(createPlugin));
 
 program
 	.command("why <file>")
 	.description("Show which plugin installed a file")
-	.option("-g, --global", "Check global plugins (default)")
+	.option("-g, --global", "Check global plugins")
+	.option("-l, --local", "Check project-local plugins")
 	.option("--json", "Output as JSON")
-	.action(whyFile);
+	.action(withErrorHandling(whyFile));
 
 program
 	.command("enable <name>")
 	.description("Enable a disabled plugin")
-	.option("-g, --global", "Target global plugins (default)")
+	.option("-g, --global", "Target global plugins")
+	.option("-l, --local", "Target project-local plugins")
 	.option("--json", "Output as JSON")
-	.action(enablePlugin);
+	.action(withErrorHandling(enablePlugin));
 
 program
 	.command("disable <name>")
 	.description("Disable plugin without uninstalling")
-	.option("-g, --global", "Target global plugins (default)")
+	.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(disablePlugin);
+	.action(withErrorHandling(featuresCommand));
 
 program
-	.command("migrate")
-	.description("Migrate from legacy manifest.json to npm-native format")
-	.action(async () => {
-		await migrateToNpm();
-	});
+	.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();