@paradigma-inc/flywheel 0.2.3 → 0.2.5

package/README.md

@@ -24,8 +24,9 @@ The script installs `@paradigma-inc/flywheel@latest` into the managed user
 prefix `${FLYWHEEL_INSTALL_PREFIX:-$HOME/.local}`, adds a marked PATH block
 when needed, and then runs guided `flywheel setup` through the installed binary.
 In an interactive terminal, setup asks whether you want MCP host setup or
-CLI-only setup. You can read the full source at the same URL without piping to
-`sh`.
+CLI-only setup. Setup then asks where to install: Project (this folder) or
+Global (your machine), with Global preselected. You can read the full source
+at the same URL without piping to `sh`.
 
 Prefer the two-step npm recipe? It still works:
 
@@ -186,6 +187,7 @@ Mode behavior:
 If mode is omitted:
 
 - interactive TTY: prompt for `mcp` or `cli` (default `mcp`)
+- location: Where should Flywheel be installed? (default Global)
 - non-interactive: fails with usage error (`exit 2`)
 
 ## Public Base URL Rules
@@ -329,6 +331,7 @@ full details.
 
 - Default scope (no `--project`) is user-level/global.
 - `--project` is the explicit repo-local override.
+- Interactive setup asks for the install location (Global preselected) when `--project` is omitted.
 
 Examples:
 

package/package.json

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

package/src/cli.mjs

@@ -368,9 +368,9 @@ function validateCliModeFlags(options) {
  }
 }
 
-async function runCliModeCommand(options, readStdinAuth) {
+async function runCliModeCommand(options, readStdinAuth, contextScope) {
  validateCliModeFlags(options);
- const scope = options.project ? "project" : "global";
+ const scope = contextScope ?? (options.project ? "project" : "global");
  const baseUrl = normalizeBaseUrl(
   resolveSetupBaseUrl({ explicitBaseUrl: options.baseUrl }),
  );
@@ -450,9 +450,10 @@ async function runSetupCommandViaRouter(options) {
   isInteractive:
    isatty(0) && process.stdout.isTTY === true,
   promptMode: promptSetupMode,
-  runMcpMode: async ({ readStdinAuth }) =>
+  runMcpMode: async ({ readStdinAuth, scope }) =>
    await runMcpModeCommand(options, {
     readStdinAuth,
+    scope,
     force: options.force === true,
     reconcilePriorMode: async ({
      hostNames,
@@ -480,7 +481,8 @@ async function runSetupCommandViaRouter(options) {
      }
     },
    }),
-  runCliMode: async ({ readStdinAuth }) => await runCliModeCommand(options, readStdinAuth),
+  runCliMode: async ({ readStdinAuth, scope }) =>
+   await runCliModeCommand(options, readStdinAuth, scope),
  });
 }
 
@@ -1360,7 +1362,7 @@ Configure the Flywheel CLI, MCP host entries, and bundled skills without changin
   .optionsGroup("Scope:")
   .option(
    "-p, --project",
-   "Configure for current project instead of globally",
+   "Configure for current project instead of globally; setup asks interactively when omitted",
   )
   .option("-y, --yes", "Skip confirmation prompts")
   .optionsGroup("Authentication:")

package/src/setup/command.mjs

@@ -1,6 +1,7 @@
 import { resolveSetupMode } from "./mode.mjs";
 import { recordResolvedMode } from "./resolved-selection-record.mjs";
 import { createSetupStdinAuthReader } from "../setup-auth.mjs";
+import { resolveInteractiveSetupScope } from "./install-scope.mjs";
 
 export async function runSetupRouter(options = {}, deps = {}) {
   const mode = await resolveSetupMode(options, {
@@ -11,10 +12,15 @@ export async function runSetupRouter(options = {}, deps = {}) {
     ? createSetupStdinAuthReader(options, deps.stdin)
     : undefined;
   recordResolvedMode(mode, deps);
+  const scope = await resolveInteractiveSetupScope(options, {
+    allowPrompt: deps.isInteractive === true && options.yes !== true,
+    promptLocation: deps.promptInstallLocation,
+  });
   const context = {
     mode,
     options,
     readStdinAuth,
+    scope,
   };
 
   if (mode === "mcp") {

package/src/setup/install-scope.mjs

@@ -0,0 +1,49 @@
+import { select } from "@inquirer/prompts";
+import pc from "picocolors";
+
+const INSTALL_LOCATION_THEME = {
+  style: {
+    highlight: (text) => pc.green(text),
+    disabledChoice: (text) => ` ${pc.dim("◯")} ${pc.dim(text)}`,
+  },
+};
+
+export function buildInstallLocationPromptConfig() {
+  return {
+    message: "Where should Flywheel be installed?",
+    choices: [
+      {
+        name: "Project (this folder)",
+        value: "project",
+        short: "Project",
+        description:
+          "Files land under the current directory; commit them so teammates get them too.",
+      },
+      {
+        name: "Global (your machine)",
+        value: "global",
+        short: "Global",
+        description: "Available in all your projects on this machine.",
+      },
+    ],
+    default: "global",
+    theme: INSTALL_LOCATION_THEME,
+  };
+}
+
+export async function promptInstallLocation() {
+  return await select(buildInstallLocationPromptConfig());
+}
+
+export async function resolveInteractiveSetupScope(
+  options,
+  { allowPrompt = false, promptLocation = promptInstallLocation } = {},
+) {
+  if (options.project) {
+    return "project";
+  }
+  if (allowPrompt) {
+    return await promptLocation();
+  }
+  return "global";
+}

package/src/setup/modes/mcp-command.mjs

@@ -605,7 +605,7 @@ export async function runMcpModeCommand(options, deps = {}) {
   );
  }
 
- const scope = options.project ? "project" : "global";
+ const scope = deps.scope ?? (options.project ? "project" : "global");
  const baseUrl = normalizeBaseUrl(
   resolveSetupBaseUrl({ explicitBaseUrl: options.baseUrl }),
  );