offrouter-cli 0.2.1 → 0.3.0

package/src/commands/init.ts

@@ -1,59 +0,0 @@
-import type { Command } from "commander";
-import { detectEnvironment, V1_HONESTY_LINE } from "./detection.js";
-import { writeJson, writeText, type IoStreams } from "./output.js";
-
-export interface CommandContext {
-  env: NodeJS.ProcessEnv;
-  cwd: string;
-  stdout: IoStreams;
-  stderr: IoStreams;
-  /** Read full stdin (injected string in tests, process.stdin otherwise). */
-  readStdin: () => Promise<string>;
-}
-
-export function registerInitCommand(
-  program: Command,
-  ctx: () => CommandContext,
-): void {
-  program
-    .command("init")
-    .description("Detect environment and scaffold OffRouter config")
-    .option("--dry-run", "Report detection without writing config", false)
-    .option("--json", "Emit JSON", false)
-    .action(async (opts: { dryRun?: boolean; json?: boolean }) => {
-      const { env, cwd, stdout } = ctx();
-      const detection = await detectEnvironment({ env, cwd });
-      const dryRun = Boolean(opts.dryRun);
-      const wroteConfig = false;
-
-      if (opts.json) {
-        writeJson(stdout, {
-          dryRun,
-          wroteConfig,
-          honesty: V1_HONESTY_LINE,
-          detection: {
-            harnessProfiles: detection.harnessProfiles,
-            authTiers: detection.authTiers,
-            subscription: detection.subscription,
-            apiKeyReadiness: detection.apiKeyReadiness,
-            localRuntime: detection.localRuntime,
-            limits: detection.limits,
-            lastProviderError: detection.lastProviderError,
-          },
-        });
-        return;
-      }
-
-      writeText(stdout, V1_HONESTY_LINE);
-      writeText(
-        stdout,
-        dryRun
-          ? "Dry run: no config files written."
-          : "Init writing is reserved for a later milestone; use --dry-run for detection.",
-      );
-      writeText(
-        stdout,
-        `Subscription: ${detection.subscription.status}; API-key ready: ${detection.apiKeyReadiness.anyReady}; local: ${detection.localRuntime.health}`,
-      );
-    });
-}

package/src/commands/install.ts

@@ -1,438 +0,0 @@
-/**
- * CLI install / uninstall for harness plugins (Claude / Codex V1).
- */
-import type { Command } from "commander";
-import { loadConfig } from "offrouter-core";
-import {
-  formatInstallDiffText as formatClaudeDiff,
-  installClaudeProfile,
-  listAllowlistedPersonalClaudeProfiles,
-  rollbackClaudeProfile,
-  type ClaudeInstallResult,
-  type ClaudeRollbackResult,
-} from "offrouter-adapter-claude";
-import {
-  formatInstallDiffText as formatCodexDiff,
-  installCodexProfile,
-  listAllowlistedPersonalCodexProfiles,
-  rollbackCodexProfile,
-  type CodexInstallResult,
-  type CodexRollbackResult,
-} from "offrouter-adapter-codex";
-import {
-  formatInstallDiffText as formatGeminiDiff,
-  installGeminiProfile,
-  listAllowlistedPersonalGeminiProfiles,
-  rollbackGeminiProfile,
-  type GeminiInstallResult,
-  type GeminiRollbackResult,
-} from "offrouter-adapter-gemini";
-import {
-  formatInstallDiffText as formatGrokDiff,
-  installGrokProfile,
-  listAllowlistedPersonalGrokProfiles,
-  rollbackGrokProfile,
-  type GrokInstallResult,
-  type GrokRollbackResult,
-} from "offrouter-adapter-grok";
-import type { CommandContext } from "./init.js";
-import { writeJson, writeText } from "./output.js";
-import { honestyForHarness } from "./detection.js";
-import { formatConfigError } from "./config-error.js";
-
-type HarnessKind = "claude" | "codex" | "gemini" | "grok";
-
-type InstallResultUnion =
-  | ClaudeInstallResult
-  | CodexInstallResult
-  | GeminiInstallResult
-  | GrokInstallResult;
-type RollbackResultUnion =
-  | ClaudeRollbackResult
-  | CodexRollbackResult
-  | GeminiRollbackResult
-  | GrokRollbackResult;
-
-function assertHarness(harness: string): HarnessKind {
-  if (
-    harness !== "claude" &&
-    harness !== "codex" &&
-    harness !== "gemini" &&
-    harness !== "grok"
-  ) {
-    throw new Error(
-      `Unsupported harness "${harness}". V1 install currently supports: claude, codex, gemini, grok`,
-    );
-  }
-  return harness;
-}
-
-function harnessLabel(kind: HarnessKind): string {
-  if (kind === "codex") return "Codex";
-  if (kind === "gemini") return "Gemini";
-  if (kind === "grok") return "Grok";
-  return "Claude";
-}
-
-function allowlistedPersonalProfiles(
-  kind: HarnessKind,
-  config: Parameters<typeof listAllowlistedPersonalClaudeProfiles>[0],
-): string[] {
-  if (kind === "codex") return listAllowlistedPersonalCodexProfiles(config);
-  if (kind === "gemini") return listAllowlistedPersonalGeminiProfiles(config);
-  if (kind === "grok") return listAllowlistedPersonalGrokProfiles(config);
-  return listAllowlistedPersonalClaudeProfiles(config);
-}
-
-async function installOne(
-  kind: HarnessKind,
-  args: {
-    profile: string;
-    config: Parameters<typeof installClaudeProfile>[0]["config"];
-    env: NodeJS.ProcessEnv;
-    dryRun: boolean;
-  },
-): Promise<InstallResultUnion> {
-  if (kind === "codex") {
-    return installCodexProfile(args);
-  }
-  if (kind === "gemini") {
-    return installGeminiProfile(args);
-  }
-  if (kind === "grok") {
-    return installGrokProfile(args);
-  }
-  return installClaudeProfile(args);
-}
-
-async function rollbackOne(
-  kind: HarnessKind,
-  args: {
-    profile: string;
-    env: NodeJS.ProcessEnv;
-    dryRun: boolean;
-  },
-): Promise<RollbackResultUnion> {
-  if (kind === "codex") {
-    return rollbackCodexProfile(args);
-  }
-  if (kind === "gemini") {
-    return rollbackGeminiProfile(args);
-  }
-  if (kind === "grok") {
-    return rollbackGrokProfile(args);
-  }
-  return rollbackClaudeProfile(args);
-}
-
-function formatDiff(
-  kind: HarnessKind,
-  results: InstallResultUnion[],
-  headline?: string,
-): string {
-  if (kind === "codex") {
-    return formatCodexDiff(
-      results as unknown as CodexInstallResult[],
-      headline,
-    );
-  }
-  if (kind === "gemini") {
-    return formatGeminiDiff(
-      results as unknown as GeminiInstallResult[],
-      headline,
-    );
-  }
-  if (kind === "grok") {
-    return formatGrokDiff(results as unknown as GrokInstallResult[], headline);
-  }
-  return formatClaudeDiff(
-    results as unknown as ClaudeInstallResult[],
-    headline,
-  );
-}
-
-function resultExitCode(results: Array<{ ok: boolean }>): number {
-  return results.every((r) => r.ok) ? 0 : 1;
-}
-
-export function registerInstallCommand(
-  program: Command,
-  ctx: () => CommandContext,
-): void {
-  const install = program
-    .command("install")
-    .description(
-      "Install OffRouter into an allowlisted personal harness profile",
-    )
-    .option(
-      "--all-personal",
-      "Install into every allowlisted personal harness profile (Claude or Codex)",
-      false,
-    )
-    .option("--dry-run", "Show planned file changes without writing", false)
-    .option("--json", "Emit JSON", false)
-    .argument("[harness]", "Harness kind (V1: claude, codex)", "claude")
-    .option(
-      "--profile <profile>",
-      "Target profile id (e.g. claude-personal, codex-personal). Required unless --all-personal.",
-    )
-    .action(
-      async (
-        harness: string,
-        opts: {
-          profile?: string;
-          allPersonal?: boolean;
-          dryRun?: boolean;
-          json?: boolean;
-        },
-      ) => {
-        const { env, cwd, stdout, stderr } = ctx();
-        let kind: HarnessKind = "claude";
-        try {
-          kind = assertHarness(harness);
-          const config = await loadConfig({ env, workspaceDir: cwd });
-          const dryRun = Boolean(opts.dryRun);
-          const allPersonal = Boolean(opts.allPersonal);
-          const profile = opts.profile?.trim();
-
-          if (allPersonal && profile) {
-            throw new Error(
-              "Use either --profile <id> or --all-personal, not both.",
-            );
-          }
-
-          if (!allPersonal && !profile) {
-            throw new Error(
-              "Provide --profile <id> or --all-personal. Example: offrouter install claude --profile claude-personal --dry-run",
-            );
-          }
-
-          const targets = allPersonal
-            ? allowlistedPersonalProfiles(kind, config)
-            : [profile!];
-
-          const honesty = honestyForHarness(kind);
-          const label = harnessLabel(kind);
-
-          if (targets.length === 0) {
-            const empty: InstallResultUnion[] = [];
-            if (opts.json) {
-              writeJson(stdout, {
-                honesty,
-                dryRun,
-                harness: kind,
-                results: empty,
-                message: `No allowlisted personal ${label} profiles found for install.`,
-              });
-              return;
-            }
-            writeText(stdout, honesty);
-            writeText(
-              stdout,
-              `No allowlisted personal ${label} profiles found for install.`,
-            );
-            return;
-          }
-
-          const results: InstallResultUnion[] = [];
-          for (const target of targets) {
-            results.push(
-              await installOne(kind, { profile: target, config, env, dryRun }),
-            );
-          }
-
-          if (opts.json) {
-            writeJson(stdout, {
-              honesty,
-              dryRun,
-              harness: kind,
-              results,
-            });
-          } else {
-            writeText(stdout, honesty);
-            const headline = allPersonal
-              ? `Install matrix (allowlisted personal ${label} profiles):`
-              : undefined;
-            writeText(stdout, formatDiff(kind, results, headline).trimEnd());
-          }
-
-          if (resultExitCode(results) !== 0) {
-            const failed = results.filter((r) => !r.ok);
-            const msg = failed.map((r) => r.message).join("; ");
-            // Commander exitOverride path
-            const err = new Error(msg) as Error & { exitCode?: number };
-            err.exitCode = 1;
-            throw err;
-          }
-        } catch (err) {
-          if (
-            err &&
-            typeof err === "object" &&
-            "exitCode" in err &&
-            typeof (err as { exitCode: unknown }).exitCode === "number"
-          ) {
-            throw err;
-          }
-          const formatted = formatConfigError(err);
-          const honesty = honestyForHarness(kind);
-          if (opts.json) {
-            writeJson(stdout, {
-              honesty,
-              error: formatted,
-            });
-            const e = new Error(formatted.message) as Error & {
-              exitCode?: number;
-            };
-            e.exitCode = 1;
-            throw e;
-          }
-          writeText(stderr, formatted.message);
-          const e = new Error(formatted.message) as Error & {
-            exitCode?: number;
-          };
-          e.exitCode = 1;
-          throw e;
-        }
-      },
-    );
-
-  // Silence unused local if tree-shaking complains; keep reference stable.
-  void install;
-}
-
-export function registerUninstallCommand(
-  program: Command,
-  ctx: () => CommandContext,
-): void {
-  program
-    .command("uninstall")
-    .description("Uninstall / roll back OffRouter from a harness profile")
-    .argument("[harness]", "Harness kind (V1: claude, codex)", "claude")
-    .option(
-      "--profile <profile>",
-      "Target profile id (e.g. claude-personal, codex-personal)",
-    )
-    .option(
-      "--all-personal",
-      "Uninstall from every allowlisted personal harness profile that has install state",
-      false,
-    )
-    .option("--dry-run", "Show planned rollback without writing", false)
-    .option("--json", "Emit JSON", false)
-    .action(
-      async (
-        harness: string,
-        opts: {
-          profile?: string;
-          allPersonal?: boolean;
-          dryRun?: boolean;
-          json?: boolean;
-        },
-      ) => {
-        const { env, cwd, stdout, stderr } = ctx();
-        let kind: HarnessKind = "claude";
-        try {
-          kind = assertHarness(harness);
-          const config = await loadConfig({ env, workspaceDir: cwd });
-          const dryRun = Boolean(opts.dryRun);
-          const allPersonal = Boolean(opts.allPersonal);
-          const profile = opts.profile?.trim();
-
-          if (allPersonal && profile) {
-            throw new Error(
-              "Use either --profile <id> or --all-personal, not both.",
-            );
-          }
-
-          if (!allPersonal && !profile) {
-            throw new Error(
-              "Provide --profile <id> or --all-personal. Example: offrouter uninstall claude --profile claude-personal",
-            );
-          }
-
-          const targets = allPersonal
-            ? allowlistedPersonalProfiles(kind, config)
-            : [profile!];
-
-          const results: RollbackResultUnion[] = [];
-          for (const target of targets) {
-            results.push(
-              await rollbackOne(kind, { profile: target, env, dryRun }),
-            );
-          }
-
-          // Map rollback results into install-result-like text blocks.
-          const asInstallish: InstallResultUnion[] = results.map((r) => ({
-            ok: r.ok,
-            dryRun: r.dryRun,
-            profile: r.profile,
-            profileDir: r.profileDir,
-            changes: r.changes,
-            message: r.message,
-            errorCode: r.ok
-              ? undefined
-              : r.errorCode === "no_install_state"
-                ? "install_error"
-                : "install_error",
-          }));
-
-          const honesty = honestyForHarness(kind);
-
-          if (opts.json) {
-            writeJson(stdout, {
-              honesty,
-              dryRun,
-              harness: kind,
-              results,
-            });
-          } else {
-            writeText(stdout, honesty);
-            writeText(
-              stdout,
-              formatDiff(kind, asInstallish, "Uninstall / rollback:").trimEnd(),
-            );
-          }
-
-          // Missing state on --all-personal is soft; invalid state/errors fail.
-          const hardFailures = results.filter(
-            (r) =>
-              !r.ok && (!allPersonal || r.errorCode !== "no_install_state"),
-          );
-          if (hardFailures.length > 0) {
-            const msg = hardFailures.map((r) => r.message).join("; ");
-            const err = new Error(msg) as Error & { exitCode?: number };
-            err.exitCode = 1;
-            throw err;
-          }
-        } catch (err) {
-          if (
-            err &&
-            typeof err === "object" &&
-            "exitCode" in err &&
-            typeof (err as { exitCode: unknown }).exitCode === "number"
-          ) {
-            throw err;
-          }
-          const formatted = formatConfigError(err);
-          const honesty = honestyForHarness(kind);
-          if (opts.json) {
-            writeJson(stdout, {
-              honesty,
-              error: formatted,
-            });
-            const e = new Error(formatted.message) as Error & {
-              exitCode?: number;
-            };
-            e.exitCode = 1;
-            throw e;
-          }
-          writeText(stderr, formatted.message);
-          const e = new Error(formatted.message) as Error & {
-            exitCode?: number;
-          };
-          e.exitCode = 1;
-          throw e;
-        }
-      },
-    );
-}