switchboard-fyi 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -3,6 +3,15 @@
 All notable Switchboard CLI changes are recorded here. Keep this file in sync
 with the hosted release notes at `https://www.switchboard.fyi/release/latest`.
 
+## 0.2.2 - 2026-05-26
+
+### Fixed
+
+- Regenerated `codex` and `claude` shims now launch Switchboard through stable
+  `switchboard-fyi`/`switchboard` commands before falling back to direct script
+  paths, so Homebrew and npm upgrades no longer leave shims pointing at removed
+  versioned install directories.
+
 ## 0.2.1 - 2026-05-26
 
 ### Changed

package/bin/switchboard.mjs

@@ -42,6 +42,7 @@ const HARNESS_COMMANDS = {
   codex: "codex",
   claude: "claude",
 };
+const SWITCHBOARD_COMMAND_NAMES = ["switchboard-fyi", "switchboard"];
 const SHIM_PATH_START = "# >>> switchboard PATH >>>";
 const SHIM_PATH_END = "# <<< switchboard PATH <<<";
 const COMPONENT_STATUS_IDS = ["claude", "codex", "api"];
@@ -1112,6 +1113,25 @@ function switchboardScriptPath() {
   return path.resolve(decodeURIComponent(new URL(import.meta.url).pathname));
 }
 
+function isVersionedSwitchboardInstallPath(file) {
+  const normalized = String(file || "").split(path.sep).join("/");
+  return (
+    normalized.includes("/Cellar/switchboard-fyi/") ||
+    normalized.includes("/.npm/_npx/") ||
+    normalized.includes("/_npx/")
+  );
+}
+
+function stableSwitchboardCommandPath() {
+  for (const name of SWITCHBOARD_COMMAND_NAMES) {
+    for (const candidate of commandPaths(name)) {
+      if (!candidate || isVersionedSwitchboardInstallPath(candidate)) continue;
+      if (isUsableExecutable(candidate)) return candidate;
+    }
+  }
+  return "";
+}
+
 function readInstallState() {
   try {
     const parsed = JSON.parse(fs.readFileSync(installStatePath(), "utf8"));
@@ -1518,12 +1538,36 @@ function installTargets(argv) {
 function writeHarnessShim(harness, realPath) {
   const commandName = HARNESS_COMMANDS[harness];
   const switchboardCommand = harness === "codex" ? "codex" : "claude-code";
+  const switchboardCommandPath = stableSwitchboardCommandPath();
+  const fallbackNodePath = process.execPath;
+  const fallbackScriptPath = switchboardScriptPath();
   const content = [
     "#!/bin/sh",
     "# switchboard-shim",
     `export SWITCHBOARD_SHIM_HARNESS=${shellQuote(harness)}`,
     `export ${envRealBinaryName(harness)}=${shellQuote(realPath)}`,
-    `exec ${shellQuote(process.execPath)} ${shellQuote(switchboardScriptPath())} ${shellQuote(switchboardCommand)} "$@"`,
+    `SWITCHBOARD_CLI=${shellQuote(switchboardCommandPath)}`,
+    'if [ -n "${SWITCHBOARD_CLI_PATH:-}" ]; then',
+    `  SWITCHBOARD_CLI="$SWITCHBOARD_CLI_PATH"`,
+    "fi",
+    `if [ -n "$SWITCHBOARD_CLI" ] && [ -x "$SWITCHBOARD_CLI" ]; then`,
+    `  exec "$SWITCHBOARD_CLI" ${shellQuote(switchboardCommand)} "$@"`,
+    "fi",
+    `for SWITCHBOARD_CANDIDATE in ${SWITCHBOARD_COMMAND_NAMES.join(" ")}; do`,
+    `  SWITCHBOARD_CLI=$(command -v "$SWITCHBOARD_CANDIDATE" 2>/dev/null || true)`,
+    `  if [ -n "$SWITCHBOARD_CLI" ] && [ -x "$SWITCHBOARD_CLI" ]; then`,
+    `    exec "$SWITCHBOARD_CLI" ${shellQuote(switchboardCommand)} "$@"`,
+    "  fi",
+    "done",
+    `if [ -x ${shellQuote(fallbackNodePath)} ] && [ -f ${shellQuote(fallbackScriptPath)} ]; then`,
+    `  exec ${shellQuote(fallbackNodePath)} ${shellQuote(fallbackScriptPath)} ${shellQuote(switchboardCommand)} "$@"`,
+    "fi",
+    `SWITCHBOARD_NODE=$(command -v node 2>/dev/null || true)`,
+    `if [ -n "$SWITCHBOARD_NODE" ] && [ -f ${shellQuote(fallbackScriptPath)} ]; then`,
+    `  exec "$SWITCHBOARD_NODE" ${shellQuote(fallbackScriptPath)} ${shellQuote(switchboardCommand)} "$@"`,
+    "fi",
+    `echo "Switchboard shim could not find the Switchboard CLI. Reinstall Switchboard, then run \`switchboard install ${harness}\`." >&2`,
+    "exit 127",
     "",
   ].join("\n");
 
@@ -1534,8 +1578,9 @@ function writeHarnessShim(harness, realPath) {
     command: commandName,
     shimPath: shimPath(harness),
     realPath,
-    switchboardScript: switchboardScriptPath(),
-    nodePath: process.execPath,
+    switchboardCommandPath,
+    switchboardScript: fallbackScriptPath,
+    nodePath: fallbackNodePath,
     installedAt: new Date().toISOString(),
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "switchboard-fyi",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Local model-routing CLI for Codex and Claude Code.",
   "license": "MIT",
   "homepage": "https://www.switchboard.fyi",