@routerlab/cli 0.0.1

package/dist/errors.js

@@ -0,0 +1,32 @@
+// errors.ts — canonical CLI exit codes + a typed error for graceful failures.
+//
+// Exit-code semantics (mirrored in the CLI's README so users can script
+// against them):
+//
+//   0 — success
+//   1 — no candidates pass the filters (engine ran, decided nothing routable)
+//   2 — invalid input (bad flag, malformed value, missing required arg)
+//   3 — downstream error (calibration file malformed, missing file on disk,
+//       provider runner failure, etc.)
+//
+// The CLI never throws raw `Error` to the user. Every user-visible failure
+// is funneled through `CliError`, which carries the exit code and a clean
+// message. `main()` catches and renders.
+export const EXIT_SUCCESS = 0;
+export const EXIT_NO_CANDIDATES = 1;
+export const EXIT_INVALID_INPUT = 2;
+export const EXIT_DOWNSTREAM = 3;
+/**
+ * The one error type the CLI throws for expected, user-facing failures.
+ * Unknown exceptions still bubble up to `main()` and are mapped to
+ * `EXIT_DOWNSTREAM` with the underlying message preserved.
+ */
+export class CliError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "CliError";
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,wEAAwE;AACxE,iBAAiB;AACjB,EAAE;AACF,gBAAgB;AAChB,8EAA8E;AAC9E,wEAAwE;AACxE,4EAA4E;AAC5E,uCAAuC;AACvC,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,yCAAyC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAQjC;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAc;IAE3B,YAAY,IAAiB,EAAE,OAAe;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env bun
+// @routerlab/cli — `route` command entrypoint.
+//
+// This file is the binary's argv shim. Real CLI logic lives in `main.ts`
+// (and the per-subcommand modules) so it can be imported by tests without
+// the side effect of consuming `process.argv`.
+//
+// We exit with `main()`'s return code so shell pipelines see the right
+// status (0 success, 1 no candidates, 2 invalid input, 3 downstream error).
+// See `./errors.ts` for the canonical exit-code definitions.
+import { main } from "./main.js";
+const code = await main({
+    argv: process.argv.slice(2),
+    stdout: process.stdout,
+    stderr: process.stderr,
+    stdin: process.stdin,
+    env: process.env,
+    cwd: process.cwd(),
+});
+process.exit(code);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,+CAA+C;AAC/C,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,+CAA+C;AAC/C,EAAE;AACF,uEAAuE;AACvE,4EAA4E;AAC5E,6DAA6D;AAE7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;CACnB,CAAC,CAAC;AAEH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,33 @@
+import type { Readable, Writable } from "node:stream";
+export interface CliContext {
+    /** argv slice with the binary name and node entry already removed. */
+    argv: readonly string[];
+    /** Where normal output goes. Tests inject a `MemoryStream`. */
+    stdout: Writable;
+    /** Where error and diagnostic output goes. */
+    stderr: Writable;
+    /**
+     * Stdin handle. The `route` subcommand reads from this when `--input`
+     * is not supplied. Tests inject a primed `Readable` to simulate piping.
+     */
+    stdin: Readable;
+    /** Environment snapshot. Used to read `ROUTERLAB_*` overrides. */
+    env: NodeJS.ProcessEnv;
+    /** Working directory. Used to resolve relative `--input` paths. */
+    cwd: string;
+}
+/**
+ * Read stdin to completion as a UTF-8 string.
+ *
+ * Returns an empty string if stdin is a TTY (interactive shell, no pipe)
+ * — that way `route --task=qa --quality-bar=0.85` without `--input` and
+ * without a piped stdin doesn't hang forever waiting on the user.
+ */
+export declare function readStdinToString(stdin: Readable): Promise<string>;
+/**
+ * Convenience: write a string + newline to a stream. Centralizing this
+ * keeps the subcommands free of `\n` boilerplate and lets us swap the
+ * underlying writer (e.g. if we ever want to color-tag stderr).
+ */
+export declare function writeLine(stream: Writable, line: string): void;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,+DAA+D;IAC/D,MAAM,EAAE,QAAQ,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE,QAAQ,CAAC;IACjB;;;OAGG;IACH,KAAK,EAAE,QAAQ,CAAC;IAChB,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBxE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9D"}

package/dist/io.js

@@ -0,0 +1,47 @@
+// io.ts — IO seam for the CLI.
+//
+// Every subcommand takes a `CliContext` instead of poking at `process.*`
+// globals directly. This is the seam that makes the CLI fully unit-testable
+// from `bun test` without spawning a child process: tests instantiate a
+// `CliContext` with in-memory streams, pass in argv, and read the captured
+// stdout/stderr after the call returns.
+/**
+ * Read stdin to completion as a UTF-8 string.
+ *
+ * Returns an empty string if stdin is a TTY (interactive shell, no pipe)
+ * — that way `route --task=qa --quality-bar=0.85` without `--input` and
+ * without a piped stdin doesn't hang forever waiting on the user.
+ */
+export async function readStdinToString(stdin) {
+    // Bun's stdin exposes `isTTY` (matches Node), so a TTY-attached caller
+    // doesn't block. Real pipes (`echo "hi" | route ...`) and injected
+    // memory streams in tests both have `isTTY` falsy.
+    const maybeTty = stdin;
+    if (maybeTty.isTTY === true) {
+        return "";
+    }
+    const chunks = [];
+    for await (const chunk of stdin) {
+        if (typeof chunk === "string") {
+            chunks.push(Buffer.from(chunk, "utf8"));
+        }
+        else if (chunk instanceof Uint8Array) {
+            chunks.push(Buffer.from(chunk));
+        }
+        else {
+            // Defensive: shouldn't happen on Node/Bun stdin, but keeps the
+            // function total-typed under `noImplicitAny`.
+            chunks.push(Buffer.from(String(chunk), "utf8"));
+        }
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+/**
+ * Convenience: write a string + newline to a stream. Centralizing this
+ * keeps the subcommands free of `\n` boilerplate and lets us swap the
+ * underlying writer (e.g. if we ever want to color-tag stderr).
+ */
+export function writeLine(stream, line) {
+    stream.write(line + "\n");
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,2EAA2E;AAC3E,wCAAwC;AAsBxC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAe;IACrD,uEAAuE;IACvE,mEAAmE;IACnE,mDAAmD;IACnD,MAAM,QAAQ,GAAG,KAAuC,CAAC;IACzD,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,+DAA+D;YAC/D,8CAA8C;YAC9C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAgB,EAAE,IAAY;IACtD,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,14 @@
+import { type CliContext } from "./io.ts";
+/**
+ * Top-level entry point. Always resolves with an exit code; never throws.
+ *
+ * Lifecycle:
+ *   1. Extract first positional as the subcommand name.
+ *   2. Dispatch to that subcommand's `run*` function with a shifted argv.
+ *   3. Any `CliError` thrown by a subcommand is rendered to stderr with
+ *      its embedded exit code returned verbatim.
+ *   4. Any other exception is mapped to `EXIT_DOWNSTREAM` with the
+ *      original message preserved.
+ */
+export declare function main(ctx: CliContext): Promise<number>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,UAAU,EAAa,MAAM,SAAS,CAAC;AAErD;;;;;;;;;;GAUG;AACH,wBAAsB,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC3D"}

package/dist/main.js

@@ -0,0 +1,64 @@
+// main.ts — top-level CLI dispatcher.
+//
+// Reads the first argv positional, routes it to the matching subcommand
+// module, and converts thrown errors into exit codes. Tests import this
+// function directly (rather than spawning a subprocess) by passing a
+// `CliContext` with in-memory streams.
+//
+// Exit codes are defined in `./errors.ts` and mirrored in the CLI README.
+import { CliError, EXIT_DOWNSTREAM, EXIT_INVALID_INPUT } from "./errors.js";
+import { runEval } from "./commands/eval.js";
+import { runFrontier } from "./commands/frontier.js";
+import { runHelp } from "./commands/help.js";
+import { runModels } from "./commands/models.js";
+import { runRoute } from "./commands/route.js";
+import { runVersion } from "./commands/version.js";
+import { writeLine } from "./io.js";
+/**
+ * Top-level entry point. Always resolves with an exit code; never throws.
+ *
+ * Lifecycle:
+ *   1. Extract first positional as the subcommand name.
+ *   2. Dispatch to that subcommand's `run*` function with a shifted argv.
+ *   3. Any `CliError` thrown by a subcommand is rendered to stderr with
+ *      its embedded exit code returned verbatim.
+ *   4. Any other exception is mapped to `EXIT_DOWNSTREAM` with the
+ *      original message preserved.
+ */
+export async function main(ctx) {
+    const [first, ...rest] = ctx.argv;
+    // No subcommand → show help and exit 0. This is the same behavior as
+    // `git` (interactive shells) and is friendlier than a usage error.
+    if (first === undefined || first === "--help" || first === "-h" || first === "help") {
+        return runHelp({ ...ctx, argv: rest });
+    }
+    const subCtx = { ...ctx, argv: rest };
+    try {
+        switch (first) {
+            case "route":
+                return await runRoute(subCtx);
+            case "frontier":
+                return runFrontier(subCtx);
+            case "models":
+                return runModels(subCtx);
+            case "eval":
+                return await runEval(subCtx);
+            case "version":
+            case "--version":
+            case "-v":
+                return runVersion(subCtx);
+            default:
+                throw new CliError(EXIT_INVALID_INPUT, `unknown subcommand "${first}". Run \`route help\` for usage.`);
+        }
+    }
+    catch (e) {
+        if (e instanceof CliError) {
+            writeLine(ctx.stderr, `error: ${e.message}`);
+            return e.code;
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        writeLine(ctx.stderr, `error: ${msg}`);
+        return EXIT_DOWNSTREAM;
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,qEAAqE;AACrE,uCAAuC;AACvC,EAAE;AACF,0EAA0E;AAE1E,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAmB,SAAS,EAAE,MAAM,SAAS,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,GAAe;IACxC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;IAElC,qEAAqE;IACrE,mEAAmE;IACnE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACpF,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAe,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAElD,IAAI,CAAC;QACH,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,OAAO;gBACV,OAAO,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;YAChC,KAAK,UAAU;gBACb,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;YAC7B,KAAK,QAAQ;gBACX,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;YAC3B,KAAK,MAAM;gBACT,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/B,KAAK,SAAS,CAAC;YACf,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;YAC5B;gBACE,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,uBAAuB,KAAK,kCAAkC,CAC/D,CAAC;QACN,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;YAC1B,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,CAAC,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,EAAE,CAAC,CAAC;QACvC,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,44 @@
+import type { Provider, TaskClass } from "@routerlab/core";
+/**
+ * The value type `node:util`'s `parseArgs` returns per flag. We accept the
+ * full union (including the array case from `multiple: true`, which the
+ * CLI doesn't currently use) so we can swap a flag to multi-value later
+ * without rewriting validators. The validators below all reject arrays
+ * because none of the current flags are multi-value.
+ */
+export type ParsedFlagValue = string | boolean | (string | boolean)[] | undefined;
+/**
+ * Require a string-typed flag value and return it, else throw.
+ */
+export declare function requireString(flag: string, value: ParsedFlagValue): string;
+/**
+ * Parse a `--task=...` value into a `TaskClass`, else throw.
+ */
+export declare function parseTask(value: ParsedFlagValue): TaskClass;
+/**
+ * Parse a `--provider=...` value into a `Provider`, else throw.
+ * Unlike `parseTask` this one is optional because `models` accepts no filter.
+ */
+export declare function parseProviderOptional(value: ParsedFlagValue): Provider | undefined;
+/**
+ * Parse a `--quality-bar=...` value into a [0, 1] number, else throw.
+ *
+ * The engine itself also validates this, but doing it here lets us return
+ * exit code 2 (invalid input) consistently rather than depending on the
+ * engine's exception bubbling up to the catch-all that returns 3.
+ */
+export declare function parseQualityBar(value: ParsedFlagValue): number;
+/**
+ * Parse an optional numeric flag like `--max-cost-usd=0.005`. Returns
+ * `undefined` if the flag is absent.
+ */
+export declare function parseNonNegativeFloatOptional(flag: string, value: ParsedFlagValue): number | undefined;
+/**
+ * Parse an optional positive integer flag like `--n=20`.
+ */
+export declare function parsePositiveIntOptional(flag: string, value: ParsedFlagValue): number | undefined;
+/**
+ * Parse a `--format=table|json` value with a sensible default.
+ */
+export declare function parseFormat(value: ParsedFlagValue, defaultValue?: "table" | "json"): "table" | "json";
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAwB3D;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;AAElF;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,eAAe,GACrB,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,CAS3D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,GACrB,QAAQ,GAAG,SAAS,CAYtB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAgB9D;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,eAAe,GACrB,MAAM,GAAG,SAAS,CAmBpB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,eAAe,GACrB,MAAM,GAAG,SAAS,CAapB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,YAAY,GAAE,OAAO,GAAG,MAAgB,GACvC,OAAO,GAAG,MAAM,CASlB"}

package/dist/parse.js

@@ -0,0 +1,125 @@
+// parse.ts — shared argument validation helpers.
+//
+// Every subcommand parses flags with `node:util` `parseArgs`. The helpers
+// here turn the raw `string | undefined` values into validated, typed
+// values, throwing `CliError(EXIT_INVALID_INPUT, ...)` on bad input.
+//
+// Centralizing the validation keeps the subcommands focused on rendering
+// and ensures the user gets the same error message for the same kind of
+// mistake regardless of which subcommand they're running.
+import { CliError, EXIT_INVALID_INPUT } from "./errors.js";
+const VALID_TASKS = new Set([
+    "qa",
+    "codegen",
+    "summarization",
+    "classification",
+    "reasoning",
+]);
+const VALID_PROVIDERS = new Set([
+    "anthropic",
+    "openai",
+    "google",
+    "groq",
+    "together",
+    "hf",
+    "openrouter",
+]);
+const VALID_FORMATS = new Set(["table", "json"]);
+/**
+ * Require a string-typed flag value and return it, else throw.
+ */
+export function requireString(flag, value) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new CliError(EXIT_INVALID_INPUT, `missing required flag --${flag}`);
+    }
+    return value;
+}
+/**
+ * Parse a `--task=...` value into a `TaskClass`, else throw.
+ */
+export function parseTask(value) {
+    const raw = requireString("task", value);
+    if (!VALID_TASKS.has(raw)) {
+        throw new CliError(EXIT_INVALID_INPUT, `invalid --task "${raw}". Expected one of: ${[...VALID_TASKS].join(", ")}`);
+    }
+    return raw;
+}
+/**
+ * Parse a `--provider=...` value into a `Provider`, else throw.
+ * Unlike `parseTask` this one is optional because `models` accepts no filter.
+ */
+export function parseProviderOptional(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || value.length === 0) {
+        throw new CliError(EXIT_INVALID_INPUT, `--provider expects a value`);
+    }
+    if (!VALID_PROVIDERS.has(value)) {
+        throw new CliError(EXIT_INVALID_INPUT, `invalid --provider "${value}". Expected one of: ${[...VALID_PROVIDERS].join(", ")}`);
+    }
+    return value;
+}
+/**
+ * Parse a `--quality-bar=...` value into a [0, 1] number, else throw.
+ *
+ * The engine itself also validates this, but doing it here lets us return
+ * exit code 2 (invalid input) consistently rather than depending on the
+ * engine's exception bubbling up to the catch-all that returns 3.
+ */
+export function parseQualityBar(value) {
+    const raw = requireString("quality-bar", value);
+    const n = Number(raw);
+    if (!Number.isFinite(n)) {
+        throw new CliError(EXIT_INVALID_INPUT, `invalid --quality-bar "${raw}": not a finite number`);
+    }
+    if (n < 0 || n > 1) {
+        throw new CliError(EXIT_INVALID_INPUT, `invalid --quality-bar "${raw}": must be in [0, 1]`);
+    }
+    return n;
+}
+/**
+ * Parse an optional numeric flag like `--max-cost-usd=0.005`. Returns
+ * `undefined` if the flag is absent.
+ */
+export function parseNonNegativeFloatOptional(flag, value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || value.length === 0) {
+        throw new CliError(EXIT_INVALID_INPUT, `--${flag} expects a value`);
+    }
+    const n = Number(value);
+    if (!Number.isFinite(n)) {
+        throw new CliError(EXIT_INVALID_INPUT, `invalid --${flag} "${value}": not a finite number`);
+    }
+    if (n < 0) {
+        throw new CliError(EXIT_INVALID_INPUT, `invalid --${flag} "${value}": must be non-negative`);
+    }
+    return n;
+}
+/**
+ * Parse an optional positive integer flag like `--n=20`.
+ */
+export function parsePositiveIntOptional(flag, value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || value.length === 0) {
+        throw new CliError(EXIT_INVALID_INPUT, `--${flag} expects a value`);
+    }
+    const n = Number(value);
+    if (!Number.isInteger(n) || n <= 0) {
+        throw new CliError(EXIT_INVALID_INPUT, `invalid --${flag} "${value}": must be a positive integer`);
+    }
+    return n;
+}
+/**
+ * Parse a `--format=table|json` value with a sensible default.
+ */
+export function parseFormat(value, defaultValue = "table") {
+    if (value === undefined)
+        return defaultValue;
+    if (typeof value !== "string" || !VALID_FORMATS.has(value)) {
+        throw new CliError(EXIT_INVALID_INPUT, `invalid --format "${String(value)}". Expected one of: ${[...VALID_FORMATS].join(", ")}`);
+    }
+    return value;
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@routerlab/cli",
+  "version": "0.0.1",
+  "description": "CLI for routerlab — cost-quality routing for LLM APIs.",
+  "license": "Apache-2.0",
+  "author": "Faraazuddin Mohammed",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "route": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/faraa2m/routerlab.git",
+    "directory": "packages/cli"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@routerlab/core": "^0.0.1"
+  }
+}