@paradigma-inc/flywheel 0.1.84 → 0.1.85

package/README.md

@@ -71,8 +71,34 @@ cargo binstall usage-cli
 pacman -S usage
 ```
 
-Generate the script for your shell and redirect it wherever your shell setup
-loads completions:
+Install generated completions into user-level locations:
+
+```bash
+flywheel completion install bash
+flywheel completion install zsh --update-profile --yes
+flywheel completion install fish
+flywheel completion install powershell --update-profile --yes
+flywheel completion install nu
+flywheel completion install nushell
+```
+
+Remove Flywheel-managed completion files and profile blocks with the matching
+uninstall command:
+
+```bash
+flywheel completion uninstall bash
+flywheel completion uninstall zsh --update-profile --yes
+flywheel completion uninstall fish
+flywheel completion uninstall powershell --update-profile --yes
+flywheel completion uninstall nu
+```
+
+Profile/startup file edits are opt-in. Without `--update-profile`, installation
+writes only the generated completion file. Use `--dry-run` to inspect planned
+changes, `--dir <path>` to choose a destination directory, and `--force` only
+when replacing an existing unmarked completion file.
+
+You can also generate the script for your shell and redirect it yourself:
 
 ```bash
 flywheel completion bash --include-bash-completion-lib > ~/.local/share/bash-completion/completions/flywheel
@@ -83,8 +109,10 @@ flywheel completion nu > ~/.config/nushell/autoload/flywheel.nu
 flywheel completion nushell > ~/.config/nushell/autoload/flywheel.nu
 ```
 
-This command generates scripts only. It does not install completions. It does
-nothing to shell startup files and does not edit shell profiles.
+`flywheel completion <shell>` generates scripts only. It does not install
+completions, touch shell startup files, or edit shell profiles. `flywheel setup`
+also does not install completions; completion installation remains an explicit
+`flywheel completion install <shell>` action.
 
 ## Uninstall
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paradigma-inc/flywheel",
-  "version": "0.1.84",
+  "version": "0.1.85",
   "description": "One-command setup for Flywheel MCP hosts",
   "type": "module",
   "files": [

package/src/cli.mjs

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-import { checkbox, select } from "@inquirer/prompts";
+import { checkbox, confirm, select } from "@inquirer/prompts";
 import ora from "ora";
 import pc from "picocolors";
 import { access, readFile, rm } from "node:fs/promises";
@@ -16,6 +16,10 @@ import {
   normalizeHosts,
 } from "./agents.mjs";
 import { generateCompletionScript } from "./completion.mjs";
+import {
+  installCompletion,
+  uninstallCompletion,
+} from "./completion-install.mjs";
 import {
   readEntryServerUrl,
   readNamedConfigEntry,
@@ -491,6 +495,52 @@ async function runCompletionCommand(shell, options) {
   }
 }
 
+async function runCompletionInstallCommand(shell, options) {
+  try {
+    await installCompletion({
+      shell,
+      dir: options.dir,
+      force: options.force === true,
+      dryRun: options.dryRun === true,
+      updateProfile: options.updateProfile === true,
+      yes: options.yes === true,
+      isInteractive:
+        process.stdin.isTTY === true && process.stdout.isTTY === true,
+      stdout: (chunk) => process.stdout.write(chunk),
+      stderr: (chunk) => process.stderr.write(chunk),
+      confirmProfileUpdate: async ({ message, default: defaultValue }) =>
+        await confirm({ message, default: defaultValue }),
+      generateCompletionScript,
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exitCode = 1;
+  }
+}
+
+async function runCompletionUninstallCommand(shell, options) {
+  try {
+    await uninstallCompletion({
+      shell,
+      dir: options.dir,
+      dryRun: options.dryRun === true,
+      updateProfile: options.updateProfile === true,
+      yes: options.yes === true,
+      isInteractive:
+        process.stdin.isTTY === true && process.stdout.isTTY === true,
+      stdout: (chunk) => process.stdout.write(chunk),
+      stderr: (chunk) => process.stderr.write(chunk),
+      confirmProfileUpdate: async ({ message, default: defaultValue }) =>
+        await confirm({ message, default: defaultValue }),
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exitCode = 1;
+  }
+}
+
 function parseUninstallScope(value) {
   const normalized = String(value || "")
     .trim()
@@ -1162,9 +1212,10 @@ Examples:
 `,
     );
 
-  program
-    .command("completion <shell>")
+  const completionCommand = program
+    .command("completion")
     .description("Generate a shell completion script")
+    .argument("[shell]", "Shell to generate completions for")
     .addHelpText(
       "before",
       `${pc.bold(pc.cyan("✻ Flywheel Completion"))}
@@ -1198,9 +1249,74 @@ Examples:
 `,
     )
     .action(async (shell, options) => {
+      if (!shell) {
+        completionCommand.help();
+        return;
+      }
       await runCompletionCommand(shell, options);
     });
 
+  completionCommand
+    .command("install <shell>")
+    .description("Install generated shell completion scripts")
+    .option("--dir <path>", "Override completion script destination directory")
+    .option("--force", "Replace an existing unmarked destination file")
+    .option("--dry-run", "Print planned changes without writing files")
+    .option("--update-profile", "Allow shell startup/profile file updates")
+    .option("-y, --yes", "Skip confirmation prompts")
+    .addHelpText(
+      "before",
+      `${pc.bold(pc.cyan("✻ Flywheel Completion Install"))}
+
+Install generated Flywheel shell completions to user-level locations.
+Supported shells: ${COMPLETION_SHELL_CHOICES.join(", ")}.
+`,
+    )
+    .addHelpText(
+      "after",
+      `
+Examples:
+  ${pc.green("flywheel completion install bash")}
+  ${pc.green("flywheel completion install zsh --update-profile --yes")}
+  ${pc.green("flywheel completion install fish")}
+  ${pc.green("flywheel completion install powershell --update-profile --yes")}
+  ${pc.green("flywheel completion install nu")}
+`,
+    )
+    .action(async (shell, options) => {
+      await runCompletionInstallCommand(shell, options);
+    });
+
+  completionCommand
+    .command("uninstall <shell>")
+    .description("Uninstall Flywheel-managed shell completion scripts")
+    .option("--dir <path>", "Override completion script destination directory")
+    .option("--dry-run", "Print planned removals without writing files")
+    .option("--update-profile", "Allow shell startup/profile file updates")
+    .option("-y, --yes", "Skip confirmation prompts")
+    .addHelpText(
+      "before",
+      `${pc.bold(pc.cyan("✻ Flywheel Completion Uninstall"))}
+
+Remove only Flywheel-managed shell completion files and profile blocks.
+Supported shells: ${COMPLETION_SHELL_CHOICES.join(", ")}.
+`,
+    )
+    .addHelpText(
+      "after",
+      `
+Examples:
+  ${pc.green("flywheel completion uninstall bash")}
+  ${pc.green("flywheel completion uninstall zsh --update-profile --yes")}
+  ${pc.green("flywheel completion uninstall fish")}
+  ${pc.green("flywheel completion uninstall powershell --update-profile --yes")}
+  ${pc.green("flywheel completion uninstall nu")}
+`,
+    )
+    .action(async (shell, options) => {
+      await runCompletionUninstallCommand(shell, options);
+    });
+
   program
     .command("setup")
     .description("Set up Flywheel for your AI coding host")