@paradigma-inc/flywheel 0.1.0 → 0.1.1

package/README.md

@@ -27,13 +27,15 @@ npx @paradigma-inc/flywheel setup --base-url https://flywheel-staging.paradigma.
 
 - Staging remains protected by the existing staging password gate in the WebUI.
   The browser auth step must pass that gate before key creation can complete.
-- Setup writes one Flywheel server entry per host+scope. Re-running setup for a
-  different base URL in the same host+scope updates that same entry.
+- Setup writes one Flywheel server entry per host+scope. If a host is already
+  configured, setup leaves that entry in place (Context7-style).
 
 ## Commands
 
 - `setup`: interview + browser auth bridge + idempotent host config writes.
 - `uninstall`: remove Flywheel MCP entries from selected host configs.
+- Add `--yes` to skip interactive prompts in the Flywheel wizard.
+- `npx --yes` only auto-confirms `npx`; it does not imply `flywheel --yes`.
 
 ## Release channels
 
@@ -43,14 +45,6 @@ npx @paradigma-inc/flywheel setup --base-url https://flywheel-staging.paradigma.
 npx @paradigma-inc/flywheel setup
 ```
 
-- Internal staging builds are published to GitHub Packages (`staging` tag) and
-  require npm auth for `npm.pkg.github.com`.
-- Example internal install:
-
-```bash
-npx --registry=https://npm.pkg.github.com @paradigma-inc/flywheel@staging setup
-```
-
 ## Supported hosts
 
 - Codex (`~/.codex/config.toml` or `.codex/config.toml`)

package/package.json

@@ -1,14 +1,25 @@
 {
   "name": "@paradigma-inc/flywheel",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "One-command setup for Flywheel MCP on Codex, Claude Code, and OpenCode",
   "type": "module",
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
   "bin": {
     "flywheel": "bin/flywheel.js"
   },
   "scripts": {
     "test": "node --test tests/*.test.mjs"
   },
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.0",
+    "commander": "^14.0.1",
+    "ora": "^9.0.0",
+    "picocolors": "^1.1.1"
+  },
   "engines": {
     "node": ">=20"
   },

package/src/agents.mjs

@@ -1,97 +1,149 @@
+import { access } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 
 export const SERVER_NAME = "flywheel";
-export const HOSTS = ["codex", "claude", "opencode"];
-
-export const HOST_LABELS = {
-  codex: "Codex",
+export const ALL_HOST_NAMES = ["claude", "opencode", "codex"];
+export const SETUP_HOST_NAMES = {
   claude: "Claude Code",
   opencode: "OpenCode",
+  codex: "Codex",
 };
 
 const HOME = os.homedir();
 
-/**
- * Patterns mirrored from Context7's `setup/agents.ts`.
- */
-export const AGENT_CONFIG = {
-  codex: {
-    configType: "toml",
-    projectPath: path.join(".codex", "config.toml"),
-    globalPath: path.join(HOME, ".codex", "config.toml"),
-    buildEntry: ({ serverUrl, apiKey }) => ({
-      type: "http",
-      url: serverUrl,
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-      },
-    }),
-  },
+const hosts = {
   claude: {
-    configType: "json",
-    projectPath: ".mcp.json",
-    globalPath: path.join(HOME, ".claude.json"),
-    configKey: "mcpServers",
-    buildEntry: ({ serverUrl, apiKey }) => ({
-      type: "http",
-      url: serverUrl,
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-      },
-    }),
+    name: "claude",
+    displayName: "Claude Code",
+    mcp: {
+      configType: "json",
+      projectPaths: [".mcp.json"],
+      globalPaths: [path.join(HOME, ".claude.json")],
+      configKey: "mcpServers",
+      buildEntry: ({ serverUrl, apiKey }) => ({
+        type: "http",
+        url: serverUrl,
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+        },
+      }),
+    },
+    detect: {
+      projectPaths: [".mcp.json", ".claude"],
+      globalPaths: [
+        path.join(HOME, ".claude.json"),
+        path.join(HOME, ".claude"),
+      ],
+    },
   },
   opencode: {
-    configType: "json",
-    projectPath: "opencode.json",
-    globalPath: path.join(HOME, ".config", "opencode", "opencode.json"),
-    configKey: "mcp",
-    buildEntry: ({ serverUrl, apiKey }) => ({
-      type: "remote",
-      url: serverUrl,
-      enabled: true,
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-      },
-    }),
+    name: "opencode",
+    displayName: "OpenCode",
+    mcp: {
+      configType: "json",
+      projectPaths: ["opencode.json", ".opencode.json"],
+      globalPaths: [
+        path.join(HOME, ".config", "opencode", "opencode.json"),
+        path.join(HOME, ".config", "opencode", ".opencode.json"),
+      ],
+      configKey: "mcp",
+      buildEntry: ({ serverUrl, apiKey }) => ({
+        type: "remote",
+        url: serverUrl,
+        enabled: true,
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+        },
+      }),
+    },
+    detect: {
+      projectPaths: ["opencode.json", ".opencode.json"],
+      globalPaths: [path.join(HOME, ".config", "opencode")],
+    },
+  },
+  codex: {
+    name: "codex",
+    displayName: "Codex",
+    mcp: {
+      configType: "toml",
+      projectPaths: [path.join(".codex", "config.toml")],
+      globalPaths: [path.join(HOME, ".codex", "config.toml")],
+      configKey: "mcp_servers",
+      buildEntry: ({ serverUrl, apiKey }) => ({
+        type: "http",
+        url: serverUrl,
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+        },
+      }),
+    },
+    detect: {
+      projectPaths: [".codex", path.join(".codex", "config.toml")],
+      globalPaths: [path.join(HOME, ".codex")],
+    },
   },
 };
 
-export function normalizeScope(scope) {
-  if (scope === "global" || scope === "project") return scope;
-  return "global";
+export function getHost(name) {
+  const host = hosts[name];
+  if (!host) {
+    throw new Error(`Unsupported host: ${name}`);
+  }
+  return host;
 }
 
-export function resolveHostConfigPath(host, scope) {
-  const hostConfig = AGENT_CONFIG[host];
-  if (!hostConfig) {
-    throw new Error(`Unsupported host: ${host}`);
+async function pathExists(filePath) {
+  try {
+    await access(filePath);
+    return true;
+  } catch {
+    return false;
   }
-  if (scope === "project") {
-    return path.join(process.cwd(), hostConfig.projectPath);
+}
+
+export async function detectHosts(scope) {
+  const detected = [];
+  for (const hostName of ALL_HOST_NAMES) {
+    const host = getHost(hostName);
+    const candidates =
+      scope === "global" ? host.detect.globalPaths : host.detect.projectPaths;
+    for (const candidate of candidates) {
+      const fullPath =
+        scope === "global" ? candidate : path.join(process.cwd(), candidate);
+      // eslint-disable-next-line no-await-in-loop
+      if (await pathExists(fullPath)) {
+        detected.push(hostName);
+        break;
+      }
+    }
   }
-  return hostConfig.globalPath;
+  return detected;
+}
+
+export function normalizeScope(scope) {
+  if (scope === "global" || scope === "project") return scope;
+  return "global";
 }
 
 export function normalizeHosts(rawHosts) {
   if (!Array.isArray(rawHosts) || rawHosts.length === 0) {
-    return [...HOSTS];
+    return [...ALL_HOST_NAMES];
   }
   const normalized = [];
   for (const host of rawHosts) {
-    const candidate = String(host || "").trim().toLowerCase();
+    const candidate = String(host || "")
+      .trim()
+      .toLowerCase();
     if (!candidate) continue;
-    if (!HOSTS.includes(candidate)) {
+    if (!ALL_HOST_NAMES.includes(candidate)) {
       throw new Error(
-        `Unsupported host '${candidate}'. Supported: ${HOSTS.join(", ")}`,
+        `Unsupported host '${candidate}'. Supported: ${ALL_HOST_NAMES.join(", ")}`,
       );
     }
     if (!normalized.includes(candidate)) {
       normalized.push(candidate);
     }
   }
-  if (normalized.length === 0) {
-    return [...HOSTS];
-  }
-  return normalized;
+  return normalized.length > 0 ? normalized : [...ALL_HOST_NAMES];
 }