UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

115 lines (111 loc) • 5.22 kB
/** * CLI head: version/help early exits, `ocx ready` pre-parse, and the bounded * Codex-shim auto-restore preflight, in that order (Phase 1 of the CLI * deepening — moved out of src/cli/index.ts). * * `parseCliHead` is pure (no I/O, no process access) so the ordering and the * single-parse contract are unit-testable without a subprocess. `runCli` owns * the exit paths and the shim preflight, then returns the dispatchable head * for the command switch in src/cli/index.ts. */ import { hasHelpFlag, printSubcommandUsage, printUsage, printVersion } from "./help"; import { parseReadyArgs, type ReadyArgs } from "./ready"; import { parseResolveArgs, type ResolveArgs } from "./resolve"; import { parseStopApproval } from "./stop-approval"; import { maybeAutoRestoreCodexShim } from "./codex-shim-autorestore"; export interface CliHead { kind: "version" | "help" | "ready" | "resolve" | "command"; command: string | undefined; args: string[]; /** For kind "help": the subcommand whose usage should print, if any. */ helpTarget?: string; /** Present only for `ready`; undefined when the ready args failed to parse. */ readyArgs?: ReadyArgs; /** Present only for `resolve`; undefined when the resolve args failed to parse. */ resolveArgs?: ResolveArgs; } export function parseCliHead(argv: string[]): CliHead { const command = argv[0]; const args = argv; if (command === "--version" || command === "-v" || command === "version") { return { kind: "version", command, args }; } if (command === undefined || command === "help" || command === "--help" || command === "-h") { // `ocx help <sub>` carries the subcommand; bare/flag help prints the full usage. return { kind: "help", command, args, ...(command === "help" && args[1] ? { helpTarget: args[1] } : {}), }; } if (command !== "help" && hasHelpFlag(args.slice(1))) { // `ocx <cmd> --help|-h|help` prints that command's usage, not the full list. return { kind: "help", command, args, helpTarget: command }; } // P1: pre-parse `ocx ready` and reject invalid arguments with exit 64 BEFORE // maybeAutoRestoreCodexShim (or any discovery/probe/filesystem-capable global // preflight) runs. `ready --help` / `help ready` already exited above, so this // only sees ready args without a help flag. Valid args are stashed so the // switch dispatch can call runReady without a second parse. if (command === "ready") { const parsed = parseReadyArgs(args.slice(1)); if (!parsed.ok) return { kind: "ready", command, args, readyArgs: undefined }; return { kind: "ready", command, args, readyArgs: parsed.args }; } // Same ordering contract as `ready`: `ocx resolve` rejects any argument with exit // 64 BEFORE maybeAutoRestoreCodexShim (or any other preflight with side effects) runs. if (command === "resolve") { const parsed = parseResolveArgs(args.slice(1)); if (!parsed.ok) return { kind: "resolve", command, args, resolveArgs: undefined }; return { kind: "resolve", command, args, resolveArgs: parsed.args }; } return { kind: "command", command, args }; } export async function runCli(argv: string[]): Promise<CliHead> { const head = parseCliHead(argv); switch (head.kind) { case "version": printVersion(); process.exit(0); case "help": { if (head.helpTarget) printSubcommandUsage(head.helpTarget); else printUsage(); process.exit(0); } case "ready": { // Fail-closed impossible-state guard: parseCliHead already ran the // pre-parse before any shim/preflight side effect, so reaching here // without readyArgs means dispatch diverged. Refuse with code 64 and // perform NO I/O (no discovery/probe). if (!head.readyArgs) { console.error("Usage: ocx ready [--json] [--wait [--timeout <seconds>]]"); console.error(" --timeout requires --wait; <seconds> must be a positive integer (1..300)."); console.error(" Default wait timeout is 45 seconds."); process.exit(64); } maybeAutoRestoreCodexShim(head.command, head.args); return head; } case "resolve": { // Fail-closed impossible-state guard, mirroring ready: the pre-parse above already // rejected invalid arguments before any preflight, so a missing resolveArgs means // dispatch diverged. Refuse with code 64 and perform NO I/O. if (!head.resolveArgs) { console.error("Usage: ocx resolve [--json]"); console.error(" --json prints one JSON document: the config home, the effective port,"); console.error(" and the identity-checked liveness verdict."); process.exit(64); } maybeAutoRestoreCodexShim(head.command, head.args); return head; } case "command": if (head.command === "stop" && !parseStopApproval(head.args.slice(1)).ok) { console.error("Usage: ocx stop [--json [--expect-pid <pid> --expect-port <port> --expect-hostname <host> --expect-config-home <home> --expect-cli-version <version> --expect-compatibility-token <hex>]]"); process.exit(64); } maybeAutoRestoreCodexShim(head.command, head.args); return head; } }