@auroraflow/code 0.0.19 → 0.0.20

package/README.md

@@ -37,6 +37,9 @@ aurora update-clients
 aurora install codex
 aurora install claude
 aurora install all
+aurora repair codex
+aurora repair claude
+aurora doctor
 ```
 
 ## Commands
@@ -50,6 +53,8 @@ node bin/aurora.js claude
 node bin/aurora.js codex
 node bin/aurora.js install codex
 node bin/aurora.js install claude
+node bin/aurora.js repair codex
+node bin/aurora.js doctor
 node bin/aurora.js install-clients
 node bin/aurora.js update-clients
 node bin/aurora.js status
@@ -59,6 +64,8 @@ Running `aurora` without a subcommand opens an interactive client selector. Use
 Up/Down (or `j`/`k`) and Enter to launch Claude or Codex through Aurora.
 If the selected official client is missing, Aurora prompts to install that
 specific client before launch.
+If the package exists but its command is not usable, Aurora reports a broken
+client state and prompts to repair instead of calling it "not installed".
 
 The launcher stores shared local state under `~/.aurora` and starts a local
 sidecar at `127.0.0.1:17878`. Official clients talk to the sidecar; the sidecar

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auroraflow/code",
-  "version": "0.0.19",
+  "version": "0.0.20",
   "type": "module",
   "description": "Aurora launcher and sidecar for official Codex and Claude Code clients.",
   "repository": {

package/packages/cli/src/index.js

@@ -1,5 +1,5 @@
 import { ensureLayout, readAccount, readState, writeAccount, writeState } from "../../state/src/index.js";
-import { installOfficialClient, officialClientStatus, officialClientStatuses, runClient, updateOfficialClients } from "../../clients/src/index.js";
+import { installOfficialClient, officialClientStatus, officialClientStatuses, repairOfficialClient, runClient, updateOfficialClients } from "../../clients/src/index.js";
 import { ensureSidecarRunning, installSidecarService, sidecarServiceStatus, uninstallSidecarService } from "../../service/src/index.js";
 import { chooseClient, promptChoice, promptFields } from "../../../lib/prompt.js";
 
@@ -28,9 +28,15 @@ export async function runAuroraCLI(argv = process.argv.slice(2)) {
         officialClients: officialClientStatuses()
       }, null, 2));
       return;
+    case "doctor":
+      await doctorCommand();
+      return;
     case "install":
       await installCommand(rest);
       return;
+    case "repair":
+      await repairCommand(rest);
+      return;
     case "install-clients":
     case "install-official-clients":
     case "update-clients":
@@ -93,6 +99,41 @@ async function installCommand(args) {
   }
 }
 
+async function repairCommand(args) {
+  const target = args[0] ?? "";
+  switch (target) {
+    case "codex":
+    case "claude":
+      await repairOfficialClient(target);
+      console.log(JSON.stringify({ officialClients: officialClientStatuses() }, null, 2));
+      return;
+    case "all":
+    case "clients":
+    case "official-clients":
+      await repairOfficialClient("claude");
+      await repairOfficialClient("codex");
+      console.log(JSON.stringify({ officialClients: officialClientStatuses() }, null, 2));
+      return;
+    default:
+      console.error("Usage: aurora repair [codex|claude|all]");
+      process.exit(1);
+  }
+}
+
+async function doctorCommand() {
+  const statuses = officialClientStatuses();
+  console.log(JSON.stringify({ officialClients: statuses }, null, 2));
+  for (const status of statuses) {
+    if (status.state === "broken") {
+      console.error(`\n${status.name} exists but is not usable (${status.problem}).`);
+      console.error(`Repair: aurora repair ${status.id}`);
+      if (process.platform === "win32") {
+        console.error(`If repair reports EBUSY, close ${status.name} and run: taskkill /F /IM ${status.id === "claude" ? "claude.exe" : "codex.exe"}`);
+      }
+    }
+  }
+}
+
 export async function runAuroraClaude(argv = process.argv.slice(2)) {
   await ensureLayout();
   await runClient("claude", argv);
@@ -116,12 +157,22 @@ async function startInteractive(args) {
 async function ensureOfficialClientForInteractive(client) {
   const status = officialClientStatus(client);
   if (status?.installed) return;
-  const action = await promptChoice(`${status?.name ?? client} is not installed`, [
-    { label: `Install ${status?.name ?? client} now`, value: "install" },
+  const broken = status?.state === "broken";
+  const action = await promptChoice(`${status?.name ?? client} ${broken ? "is installed but not usable" : "is not installed"}`, [
+    { label: `${broken ? "Repair" : "Install"} ${status?.name ?? client} now`, value: broken ? "repair" : "install" },
+    { label: "Show fix command", value: "manual" },
     { label: "Exit", value: "exit" }
   ]);
+  if (action === "manual") {
+    const command = broken ? `aurora repair ${client}` : `aurora install ${client}`;
+    throw new Error(`${status?.name ?? client} is required. Run: ${command}`);
+  }
+  if (action === "repair") {
+    await repairOfficialClient(client);
+    return;
+  }
   if (action !== "install") {
-    throw new Error(`${status?.name ?? client} is required. Run: aurora install ${client}`);
+    throw new Error(`${status?.name ?? client} is required. Run: aurora ${broken ? "repair" : "install"} ${client}`);
   }
   await installOfficialClient(client);
 }
@@ -204,6 +255,9 @@ function usage(exitCode) {
   aurora install codex
   aurora install claude
   aurora install all
+  aurora repair codex
+  aurora repair claude
+  aurora doctor
   aurora install-clients
   aurora update-clients
   aurora status

package/packages/clients/src/index.js

@@ -67,14 +67,20 @@ export function officialClientStatuses() {
   return Object.entries(OFFICIAL_CLIENTS).map(([id, client]) => {
     const bin = resolveOfficialClientBin(client.binName);
     const packagePath = officialClientPackageJSONPath(client.packageName);
-    const version = readOfficialClientVersion(bin) ?? (packagePath ? JSON.parse(readFileSync(packagePath, "utf8")).version : null);
+    const binVersion = readOfficialClientVersion(bin);
+    const packageVersion = packagePath ? JSON.parse(readFileSync(packagePath, "utf8")).version : null;
+    const state = bin && binVersion ? "installed" : packagePath ? "broken" : "missing";
     return {
       id,
       name: client.name,
       packageName: client.packageName,
       bin,
-      installed: Boolean(bin),
-      version
+      packagePath,
+      installed: state === "installed",
+      packagePresent: Boolean(packagePath),
+      state,
+      version: binVersion ?? packageVersion,
+      problem: officialClientProblem(state, bin, packagePath)
     };
   });
 }
@@ -88,15 +94,21 @@ export async function installOfficialClients() {
   await installOfficialClient("codex");
 }
 
-export async function installOfficialClient(client) {
+export async function installOfficialClient(client, options = {}) {
   const spec = OFFICIAL_CLIENTS[client];
   if (!spec) throw new Error(`unknown official client: ${client}`);
   const npm = npmCommandSpec();
-  const args = ["install", "-g", `${spec.packageName}@latest`];
-  console.error(`[aurora] installing ${spec.name}: ${npm.command} ${[...npm.args, ...args].join(" ")}`);
+  const args = ["install", "-g"];
+  if (options.repair) args.push("--force");
+  args.push(`${spec.packageName}@latest`);
+  console.error(`[aurora] ${options.repair ? "repairing" : "installing"} ${spec.name}: ${npm.command} ${[...npm.args, ...args].join(" ")}`);
   await spawnAndWait(npm.command, [...npm.args, ...args], { ...process.env });
 }
 
+export async function repairOfficialClient(client) {
+  await installOfficialClient(client, { repair: true });
+}
+
 export function isGlobalNpmLifecycle() {
   return process.env.npm_config_global === "true" || process.env.npm_config_location === "global";
 }
@@ -108,11 +120,14 @@ export function officialClientStatus(client) {
 function officialClientBin(client) {
   const spec = OFFICIAL_CLIENTS[client];
   if (!spec) throw new Error(`unknown official client: ${client}`);
-  const bin = resolveOfficialClientBin(spec.binName);
-  if (!bin) {
+  const status = officialClientStatus(client);
+  if (!status?.installed) {
+    if (status?.state === "broken") {
+      throw new Error(`${spec.name} is installed but not usable. Run: aurora doctor, then aurora repair ${client}`);
+    }
     throw new Error(`${spec.name} is not installed. Run: aurora install ${client}`);
   }
-  return bin;
+  return status.bin;
 }
 
 function resolveOfficialClientBin(binName) {
@@ -139,8 +154,29 @@ function findPathCommand(binName) {
 
 function officialClientPackageJSONPath(packageName) {
   const parts = packageName.startsWith("@") ? packageName.split("/") : [packageName];
-  const packagePath = join(packageRoot, "node_modules", ...parts, "package.json");
-  return existsSync(packagePath) ? packagePath : null;
+  for (const root of officialClientPackageRoots()) {
+    const packagePath = join(root, ...parts, "package.json");
+    if (existsSync(packagePath)) return packagePath;
+  }
+  return null;
+}
+
+function officialClientPackageRoots() {
+  const roots = [join(packageRoot, "node_modules")];
+  const npmBin = findPathCommand("npm");
+  if (npmBin) roots.push(join(dirname(npmBin), "node_modules"));
+  if (process.platform === "win32" && process.env.APPDATA) {
+    roots.push(join(process.env.APPDATA, "npm", "node_modules"));
+  }
+  return [...new Set(roots)];
+}
+
+function officialClientProblem(state, bin, packagePath) {
+  if (state === "installed") return null;
+  if (state === "missing") return "package_not_found";
+  if (!bin) return "package_present_but_command_not_found";
+  if (packagePath) return "command_found_but_version_check_failed";
+  return "unknown";
 }
 
 function readOfficialClientVersion(bin) {