@rhythmjs/cli 0.0.10 → 0.0.12

package/README.md

@@ -1,16 +1,16 @@
 # @rhythmjs/cli
 
-CLI command routing on top of `@rhythmjs/rhythm`. `RhythmCli` matches commands against argv positional tokens with a simple linear scan (appropriate for the handful-to-dozens of commands a real CLI has), supports prefixes and nested command groups, and mounts flat into a parent `Rhythm` app via `.use(cli.commands())`, so an unmatched command correctly falls through to whatever's registered after it.
+The command-line layer of Rhythm, the Bun-native backend framework: CLI command routing on top of the `@rhythmjs/rhythm` kernel. `RhythmCli` matches commands against argv positional tokens with a simple linear scan (appropriate for the handful-to-dozens of commands a real CLI has), supports prefixes and nested command groups, and mounts flat into a parent `Rhythm` app via `.use(cli.commands())`, so an unmatched command correctly falls through to whatever's registered after it.
 
-`RhythmCli` is not an app and does not extend `Rhythm` — it is a controller that compiles commands and middleware down to a single middleware (`.commands()`). It shares the core middleware contract (`compose`, `Middleware`, `next(extra)`), but has no `provide()` or `register()`, and it can't be served on its own: a `Rhythm` app is always the host that owns the lifecycle and the adapters.
+`RhythmCli` is not an app and does not extend `Rhythm`; it is a controller that compiles commands and middleware down to a single middleware (`.commands()`). It shares the core middleware contract (`compose`, `Middleware`, `next(extra)`), but has no `provide()` or `register()`, and it can't be served on its own: a `Rhythm` app is always the host that owns the lifecycle.
 
 ## Example
 
 ```ts
 import { Rhythm } from "@rhythmjs/rhythm";
 import { RhythmCli } from "@rhythmjs/cli";
-import { toCliHandler } from "@rhythmjs/cli/adapters/bun";
-import type { RhythmCliContext } from "@rhythmjs/cli/adapters/context";
+import { toCliHandler } from "@rhythmjs/cli/run";
+import type { RhythmCliContext } from "@rhythmjs/cli/context";
 
 const cli = new RhythmCli().command("deploy :environment", (ctx) => {
   ctx.response.print(`deploying to ${ctx.args.environment}`);
@@ -24,28 +24,24 @@ A fuller runnable version, including nested command groups and interactive promp
 
 ## Concepts
 
-- **`ctx.response`** — `print(line)`, `printError(line)`, `exit(code)`, all chainable. Flushed to the console and returned as the process exit code by the adapter.
-- **`ctx.args`** — captured `:name` command tokens, added once a command matches.
-- **`ctx.flags`** — parsed `--foo` / `--foo=bar` / `-f` options. Schema-less: a bare `--foo` is boolean `true`, `--foo bar` takes the next token as its value unless the token itself looks like a flag — same default behavior as `minimist`.
-- **`ctx.stdin`** — a `ReadableStream`, or `null` when stdin is a TTY (nothing piped in).
-- **Interactive prompts** — `createPrompt()` gives `text()`/`confirm()`/`select()`/`multiSelect()` (the latter two support an `allowCustom` option that adds a "type your own" choice). Wire it in via a `.provide()` on the host `Rhythm` app — see the example.
-- **Prefixes compose across nesting** — a child cli mounted into a prefixed parent via `.use(child)` gets the parent's prefix segments joined onto every one of its commands, at any nesting depth. Mounting copies the child's commands and middleware at that moment; commands added to the child afterwards don't appear in the parent, and the child keeps working standalone.
-- **Registration order is execution order** — a `.use()` middleware wraps only the commands registered after it; commands registered before it are untouched, and a matched command that doesn't call `next()` returns without reaching anything registered later. An unmatched command falls through, entry by entry, to the outer `next()`.
-- **A cli is a controller, not a module** — it has no `provide()` or `register()`, and it cannot be `register()`ed into a `Rhythm` app either; `register()` composes `Rhythm` modules only. A cli mounts into an app exactly one way: koa-style, via `.use(cli.commands())`.
+- **`ctx.response`**: `print(line)`, `printError(line)`, `exit(code)`, all chainable. Flushed to the console and returned as the process exit code by the adapter.
+- **`ctx.args`**: captured `:name` command tokens, added once a command matches.
+- **`ctx.flags`**: parsed `--foo` / `--foo=bar` / `-f` options. Schema-less: a bare `--foo` is boolean `true`, `--foo bar` takes the next token as its value unless the token itself looks like a flag, the same default behavior as `minimist`.
+- **`ctx.stdin`**: a `ReadableStream`, or `null` when stdin is a TTY (nothing piped in).
+- **Interactive prompts**: `createPrompt()` gives `text()`/`confirm()`/`select()`/`multiSelect()` (the latter two support an `allowCustom` option that adds a "type your own" choice). Wire it in via a `.provide()` on the host `Rhythm` app; see the example.
+- **Prefixes compose across nesting**: a child cli mounted into a prefixed parent via `.use(child)` gets the parent's prefix segments joined onto every one of its commands, at any nesting depth. Mounting copies the child's commands and middleware at that moment; commands added to the child afterwards don't appear in the parent, and the child keeps working standalone.
+- **Registration order is execution order**: a `.use()` middleware wraps only the commands registered after it; commands registered before it are untouched, and a matched command that doesn't call `next()` returns without reaching anything registered later. An unmatched command falls through, entry by entry, to the outer `next()`.
+- **A cli is a controller, not a module**: it has no `provide()` or `register()`, and it cannot be `register()`ed into a `Rhythm` app either; `register()` composes `Rhythm` modules only. A cli mounts into an app exactly one way: koa-style, via `.use(cli.commands())`.
 
 ## API
 
-- `new RhythmCli(options?)` — `options.prefix` (space-separated, e.g. `"remote"`).
-- `.command(path, ...handlers)` — register a command; `path` is space-separated and may contain `:param` tokens (e.g. `"deploy :environment"`).
-- `.use(fn)` — plain middleware. `.use(child)` — mount a nested `RhythmCli` (prefixes compose).
-- `.commands()` — this CLI as a plain middleware, for mounting into a `Rhythm` app via `.use()`; the cli's only way onto a runtime. Note: mounting a _cli_ into a _cli_ must use `.use(child)`, not `.use(child.commands())` — an opaque middleware can't have the parent's prefix applied to its commands.
-- `toCliHandler(app)` — bridges a `Rhythm` app to `(argv: string[]) => Promise<number>`.
-- `createPrompt()` — a readline-backed `{ text, confirm, select, multiSelect }` prompt, for use inside a `.provide()` on the host app.
+- `new RhythmCli(options?)`: `options.prefix` (space-separated, e.g. `"remote"`).
+- `.command(path, ...handlers)`: register a command; `path` is space-separated and may contain `:param` tokens (e.g. `"deploy :environment"`).
+- `.use(fn)`: plain middleware. `.use(child)`: mount a nested `RhythmCli` (prefixes compose).
+- `.commands()`: this CLI as a plain middleware, for mounting into a `Rhythm` app via `.use()`; the cli's only way onto a runtime. Note: mounting a _cli_ into a _cli_ must use `.use(child)`, not `.use(child.commands())`, because an opaque middleware can't have the parent's prefix applied to its commands.
+- `toCliHandler(app)`: bridges a `Rhythm` app to `(argv: string[]) => Promise<number>`.
+- `createPrompt()`: a `{ text, confirm, select, multiSelect }` prompt reading lines through Bun's async-iterable `console`, for use inside a `.provide()` on the host app.
 
-## Runtime adapters
+## Running on Bun
 
-`RhythmCli` itself is runtime-agnostic; only stdin access and the interactive prompt's I/O touch a specific runtime.
-
-- **`@rhythmjs/cli/adapters/bun`** — uses `Bun.stdin.stream()`, Bun's own native stdin API.
-- **`@rhythmjs/cli/adapters/node`** — the portable version: `process.stdin` + `node:stream`'s `Readable.toWeb()`, and `node:readline` for `createPrompt()`. No Bun-specific API at all.
-- **`@rhythmjs/cli/adapters/deno`** — re-exports the Node adapter unchanged. Deno's Node-compat layer implements `process.stdin`, `Readable.toWeb`/`fromWeb`, and `node:readline`, so the same code works correctly under Deno.
+`@rhythmjs/cli/run` is the runtime half, coupled to Bun on purpose: `toCliHandler(app)` reads piped input through `Bun.stdin.stream()` (a TTY leaves `ctx.stdin` null), and `createPrompt()` reads answer lines through Bun's async-iterable `console`.

package/dist/argv.d.ts

@@ -1,7 +1,5 @@
-//#region src/argv.d.ts
 export interface ParsedArgv {
-  positionals: string[];
-  flags: Record<string, string | boolean>;
+    positionals: string[];
+    flags: Record<string, string | boolean>;
 }
 export declare function parseArgv(argv: readonly string[]): ParsedArgv;
-//#endregion

package/dist/argv.js

@@ -1,47 +1,7 @@
-//#region src/argv.ts
-function parseArgv(argv) {
-	const positionals = [];
-	const flags = {};
-	let rawMode = false;
-	for (let i = 0; i < argv.length; i++) {
-		const token = argv[i];
-		if (rawMode) {
-			positionals.push(token);
-			continue;
-		}
-		if (token === "--") {
-			rawMode = true;
-			continue;
-		}
-		if (token.startsWith("--")) {
-			const eqIndex = token.indexOf("=");
-			if (eqIndex !== -1) {
-				flags[token.slice(2, eqIndex)] = token.slice(eqIndex + 1);
-				continue;
-			}
-			const name = token.slice(2);
-			const next = argv[i + 1];
-			if (next !== void 0 && !next.startsWith("-")) {
-				flags[name] = next;
-				i++;
-			} else flags[name] = true;
-			continue;
-		}
-		if (token.startsWith("-") && token.length > 1) {
-			const name = token.slice(1);
-			const next = argv[i + 1];
-			if (next !== void 0 && !next.startsWith("-")) {
-				flags[name] = next;
-				i++;
-			} else flags[name] = true;
-			continue;
-		}
-		positionals.push(token);
-	}
-	return {
-		positionals,
-		flags
-	};
-}
-//#endregion
-export { parseArgv };
+// @bun
+import {
+  parseArgv2
+} from "./rhythm-cli-qdf1cds9.js";
+export {
+  parseArgv2 as parseArgv
+};

package/dist/context.d.ts

@@ -0,0 +1,14 @@
+export declare class RhythmCliResponse {
+    exitCode: number;
+    stdout: string[];
+    stderr: string[];
+    print(line: string): this;
+    printError(line: string): this;
+    exit(code: number): this;
+}
+export interface RhythmCliContext {
+    readonly argv: readonly string[];
+    readonly flags: Readonly<Record<string, string | boolean>>;
+    readonly stdin: ReadableStream<Uint8Array> | null;
+    readonly response: RhythmCliResponse;
+}

package/dist/context.js

@@ -0,0 +1,7 @@
+// @bun
+import {
+  RhythmCliResponse2
+} from "./rhythm-cli-abdgd67x.js";
+export {
+  RhythmCliResponse2 as RhythmCliResponse
+};

package/dist/prompt.d.ts

@@ -1,2 +1,23 @@
-import { n as RhythmPromptIO, r as createPrompt, t as RhythmPrompt } from "./prompt-DXqXd-xC.js";
-export { RhythmPrompt, RhythmPromptIO, createPrompt };
+export interface RhythmPrompt {
+    text(message: string, options?: {
+        default?: string;
+    }): Promise<string>;
+    confirm(message: string, options?: {
+        default?: boolean;
+    }): Promise<boolean>;
+    select<T extends string>(message: string, choices: readonly T[], options?: {
+        allowCustom?: boolean;
+    }): Promise<T | string>;
+    multiSelect<T extends string>(message: string, choices: readonly T[], options?: {
+        allowCustom?: boolean;
+    }): Promise<(T | string)[]>;
+}
+export interface RhythmPromptIO {
+    ask(this: void, query: string): Promise<string>;
+    write(this: void, text: string): void;
+    close?(this: void): void;
+}
+export declare function createPrompt(io: RhythmPromptIO): {
+    prompt: RhythmPrompt;
+    close: () => void;
+};

package/dist/prompt.js

@@ -1,62 +1,7 @@
-//#region src/prompt.ts
-const CUSTOM_LABEL = "Other (type your own)";
-function createPrompt(io) {
-	const { ask, write } = io;
-	const text = async (message, options) => {
-		const suffix = options?.default ? ` (${options.default})` : "";
-		return (await ask(`${message}${suffix} `)).trim() || options?.default || "";
-	};
-	const confirm = async (message, options) => {
-		const suffix = options?.default === void 0 ? "(y/n)" : options.default ? "(Y/n)" : "(y/N)";
-		while (true) {
-			const answer = (await ask(`${message} ${suffix} `)).trim().toLowerCase();
-			if (!answer && options?.default !== void 0) return options.default;
-			if (answer === "y" || answer === "yes") return true;
-			if (answer === "n" || answer === "no") return false;
-			write("Please answer y or n.\n");
-		}
-	};
-	function listChoices(message, choices, allowCustom) {
-		write(`${message}\n`);
-		choices.forEach((choice, i) => write(`  ${i + 1}) ${choice}\n`));
-		const customIndex = allowCustom ? choices.length + 1 : -1;
-		if (allowCustom) write(`  ${customIndex}) ${CUSTOM_LABEL}\n`);
-		return customIndex;
-	}
-	const select = async (message, choices, options) => {
-		const customIndex = listChoices(message, choices, options?.allowCustom);
-		while (true) {
-			const index = Number(await ask("Enter number: "));
-			if (Number.isInteger(index) && index >= 1 && index <= choices.length) return choices[index - 1];
-			if (index === customIndex) return text("Enter value:");
-			write("Invalid choice, try again.\n");
-		}
-	};
-	const multiSelect = async (message, choices, options) => {
-		const customIndex = listChoices(message, choices, options?.allowCustom);
-		const maxIndex = options?.allowCustom ? customIndex : choices.length;
-		write("(comma-separated numbers, e.g. \"1,3\")\n");
-		while (true) {
-			const raw = await ask("Enter numbers: ");
-			const indices = raw.split(",").map((part) => Number(part.trim())).filter((n) => n !== 0 || raw.trim() === "0");
-			if (!(indices.length > 0 && indices.every((n) => Number.isInteger(n) && n >= 1 && n <= maxIndex))) {
-				write("Invalid choices, try again.\n");
-				continue;
-			}
-			const results = [];
-			for (const n of indices) results.push(n === customIndex ? await text("Enter value:") : choices[n - 1]);
-			return results;
-		}
-	};
-	return {
-		prompt: {
-			text,
-			confirm,
-			select,
-			multiSelect
-		},
-		close: () => io.close?.()
-	};
-}
-//#endregion
-export { createPrompt };
+// @bun
+import {
+  createPrompt2
+} from "./rhythm-cli-28bavedc.js";
+export {
+  createPrompt2 as createPrompt
+};

package/dist/rhythm-cli-28bavedc.js

@@ -0,0 +1,72 @@
+// @bun
+// src/prompt.ts
+var CUSTOM_LABEL = "Other (type your own)";
+function createPrompt2(io) {
+  const { ask, write } = io;
+  const text = async (message, options) => {
+    const suffix = options?.default ? ` (${options.default})` : "";
+    const answer = (await ask(`${message}${suffix} `)).trim();
+    return answer || options?.default || "";
+  };
+  const confirm = async (message, options) => {
+    const suffix = options?.default === undefined ? "(y/n)" : options.default ? "(Y/n)" : "(y/N)";
+    while (true) {
+      const answer = (await ask(`${message} ${suffix} `)).trim().toLowerCase();
+      if (!answer && options?.default !== undefined)
+        return options.default;
+      if (answer === "y" || answer === "yes")
+        return true;
+      if (answer === "n" || answer === "no")
+        return false;
+      write(`Please answer y or n.
+`);
+    }
+  };
+  function listChoices(message, choices, allowCustom) {
+    write(`${message}
+`);
+    choices.forEach((choice, i) => write(`  ${i + 1}) ${choice}
+`));
+    const customIndex = allowCustom ? choices.length + 1 : -1;
+    if (allowCustom)
+      write(`  ${customIndex}) ${CUSTOM_LABEL}
+`);
+    return customIndex;
+  }
+  const select = async (message, choices, options) => {
+    const customIndex = listChoices(message, choices, options?.allowCustom);
+    while (true) {
+      const index = Number(await ask("Enter number: "));
+      if (Number.isInteger(index) && index >= 1 && index <= choices.length)
+        return choices[index - 1];
+      if (index === customIndex)
+        return text("Enter value:");
+      write(`Invalid choice, try again.
+`);
+    }
+  };
+  const multiSelect = async (message, choices, options) => {
+    const customIndex = listChoices(message, choices, options?.allowCustom);
+    const maxIndex = options?.allowCustom ? customIndex : choices.length;
+    write(`(comma-separated numbers, e.g. "1,3")
+`);
+    while (true) {
+      const raw = await ask("Enter numbers: ");
+      const indices = raw.split(",").map((part) => Number(part.trim())).filter((n) => n !== 0 || raw.trim() === "0");
+      const valid = indices.length > 0 && indices.every((n) => Number.isInteger(n) && n >= 1 && n <= maxIndex);
+      if (!valid) {
+        write(`Invalid choices, try again.
+`);
+        continue;
+      }
+      const results = [];
+      for (const n of indices) {
+        results.push(n === customIndex ? await text("Enter value:") : choices[n - 1]);
+      }
+      return results;
+    }
+  };
+  return { prompt: { text, confirm, select, multiSelect }, close: () => io.close?.() };
+}
+
+export { createPrompt2 };

package/dist/rhythm-cli-abdgd67x.js

@@ -0,0 +1,21 @@
+// @bun
+// src/context.ts
+class RhythmCliResponse2 {
+  exitCode = 0;
+  stdout = [];
+  stderr = [];
+  print(line) {
+    this.stdout.push(line);
+    return this;
+  }
+  printError(line) {
+    this.stderr.push(line);
+    return this;
+  }
+  exit(code) {
+    this.exitCode = code;
+    return this;
+  }
+}
+
+export { RhythmCliResponse2 };

package/dist/rhythm-cli-qdf1cds9.js

@@ -0,0 +1,49 @@
+// @bun
+// src/argv.ts
+function parseArgv2(argv) {
+  const positionals = [];
+  const flags = {};
+  let rawMode = false;
+  for (let i = 0;i < argv.length; i++) {
+    const token = argv[i];
+    if (rawMode) {
+      positionals.push(token);
+      continue;
+    }
+    if (token === "--") {
+      rawMode = true;
+      continue;
+    }
+    if (token.startsWith("--")) {
+      const eqIndex = token.indexOf("=");
+      if (eqIndex !== -1) {
+        flags[token.slice(2, eqIndex)] = token.slice(eqIndex + 1);
+        continue;
+      }
+      const name = token.slice(2);
+      const next = argv[i + 1];
+      if (next !== undefined && !next.startsWith("-")) {
+        flags[name] = next;
+        i++;
+      } else {
+        flags[name] = true;
+      }
+      continue;
+    }
+    if (token.startsWith("-") && token.length > 1) {
+      const name = token.slice(1);
+      const next = argv[i + 1];
+      if (next !== undefined && !next.startsWith("-")) {
+        flags[name] = next;
+        i++;
+      } else {
+        flags[name] = true;
+      }
+      continue;
+    }
+    positionals.push(token);
+  }
+  return { positionals, flags };
+}
+
+export { parseArgv2 };

package/dist/rhythm-cli.d.ts

@@ -1,19 +1,17 @@
-import { t as RhythmCliContext } from "./context-DyXPT9sP.js";
-import { DeriveMiddleware, Middleware } from "@rhythmjs/rhythm/types";
-//#region src/rhythm-cli.d.ts
+import type { DeriveMiddleware, Middleware } from "@rhythmjs/rhythm/types";
+import type { RhythmCliContext } from "./context";
 export interface RhythmCliCommandContext {
-  readonly args: Readonly<Record<string, string>>;
+    readonly args: Readonly<Record<string, string>>;
 }
 export interface RhythmCliOptions {
-  prefix?: string;
+    prefix?: string;
 }
 export declare class RhythmCli<TContext extends RhythmCliContext = RhythmCliContext> {
-  #private;
-  constructor(options?: RhythmCliOptions);
-  use<TExtra extends object>(fn: DeriveMiddleware<TContext, TExtra>): RhythmCli<TContext & TExtra>;
-  use(fn: Middleware<TContext>): this;
-  command<TExtra extends object>(path: string, middleware: DeriveMiddleware<TContext & RhythmCliCommandContext, TExtra>, ...handlers: Middleware<TContext & RhythmCliCommandContext & TExtra>[]): this;
-  command(path: string, ...handlers: Middleware<TContext & RhythmCliCommandContext>[]): this;
-  middleware(): Middleware<TContext>;
+    #private;
+    constructor(options?: RhythmCliOptions);
+    use<TExtra extends object>(fn: DeriveMiddleware<TContext, TExtra>): RhythmCli<TContext & TExtra>;
+    use(fn: Middleware<TContext>): this;
+    command<TExtra extends object>(path: string, middleware: DeriveMiddleware<TContext & RhythmCliCommandContext, TExtra>, ...handlers: Middleware<TContext & RhythmCliCommandContext & TExtra>[]): this;
+    command(path: string, ...handlers: Middleware<TContext & RhythmCliCommandContext>[]): this;
+    middleware(): Middleware<TContext>;
 }
-//#endregion

package/dist/rhythm-cli.js

@@ -1,90 +1,90 @@
-import { parseArgv } from "./argv.js";
+// @bun
+import {
+  parseArgv2
+} from "./rhythm-cli-qdf1cds9.js";
+
+// src/rhythm-cli.ts
 import { compose } from "@rhythmjs/rhythm/compose";
-//#region src/rhythm-cli.ts
 function toSegments(command) {
-	return command.trim().split(/\s+/).filter(Boolean);
+  return command.trim().split(/\s+/).filter(Boolean);
 }
 function matchCommand(pattern, positionals) {
-	if (pattern.length !== positionals.length) return null;
-	const params = {};
-	for (let i = 0; i < pattern.length; i++) {
-		const segment = pattern[i];
-		const token = positionals[i];
-		if (segment.startsWith(":")) params[segment.slice(1)] = token;
-		else if (segment !== token) return null;
-	}
-	return params;
+  if (pattern.length !== positionals.length)
+    return null;
+  const params = {};
+  for (let i = 0;i < pattern.length; i++) {
+    const segment = pattern[i];
+    const token = positionals[i];
+    if (segment.startsWith(":")) {
+      params[segment.slice(1)] = token;
+    } else if (segment !== token) {
+      return null;
+    }
+  }
+  return params;
 }
-var RhythmCli = class {
-	#options;
-	#entries = [];
-	constructor(options = {}) {
-		this.#options = options;
-	}
-	get #prefixSegments() {
-		return this.#options.prefix ? toSegments(this.#options.prefix) : [];
-	}
-	use(fn) {
-		if (typeof fn !== "function") throw new TypeError("middleware must be a function!");
-		this.#entries.push({
-			kind: "middleware",
-			fn
-		});
-		return this;
-	}
-	command(path, ...handlers) {
-		this.#entries.push({
-			kind: "command",
-			segments: [...this.#prefixSegments, ...toSegments(path)],
-			handlers
-		});
-		return this;
-	}
-	#compile() {
-		const dispatchFor = (compiled) => {
-			return async (ctx, next) => {
-				const { positionals } = parseArgv(ctx.argv);
-				for (const command of compiled) {
-					const args = matchCommand(command.segments, positionals);
-					if (!args) continue;
-					await command.dispatch({
-						...ctx,
-						args
-					}, next);
-					return;
-				}
-				await next();
-			};
-		};
-		const stack = [];
-		let i = 0;
-		while (i < this.#entries.length) {
-			const entry = this.#entries[i];
-			if (entry.kind === "middleware") {
-				stack.push(entry.fn);
-				i++;
-				continue;
-			}
-			const compiled = [];
-			while (i < this.#entries.length) {
-				const command = this.#entries[i];
-				if (command.kind !== "command") break;
-				compiled.push({
-					segments: command.segments,
-					dispatch: compose(command.handlers)
-				});
-				i++;
-			}
-			stack.push(dispatchFor(compiled));
-		}
-		return compose(stack);
-	}
-	middleware() {
-		const fn = this.#compile();
-		return async (ctx, next) => {
-			await fn(ctx, next);
-		};
-	}
+
+class RhythmCli {
+  #options;
+  #entries = [];
+  constructor(options = {}) {
+    this.#options = options;
+  }
+  get #prefixSegments() {
+    return this.#options.prefix ? toSegments(this.#options.prefix) : [];
+  }
+  use(fn) {
+    if (typeof fn !== "function")
+      throw new TypeError("middleware must be a function!");
+    this.#entries.push({ kind: "middleware", fn });
+    return this;
+  }
+  command(path, ...handlers) {
+    this.#entries.push({ kind: "command", segments: [...this.#prefixSegments, ...toSegments(path)], handlers });
+    return this;
+  }
+  #compile() {
+    const dispatchFor = (compiled) => {
+      return async (ctx, next) => {
+        const { positionals } = parseArgv2(ctx.argv);
+        for (const command of compiled) {
+          const args = matchCommand(command.segments, positionals);
+          if (!args)
+            continue;
+          await command.dispatch({ ...ctx, args }, next);
+          return;
+        }
+        await next();
+      };
+    };
+    const stack = [];
+    let i = 0;
+    while (i < this.#entries.length) {
+      const entry = this.#entries[i];
+      if (entry.kind === "middleware") {
+        stack.push(entry.fn);
+        i++;
+        continue;
+      }
+      const compiled = [];
+      while (i < this.#entries.length) {
+        const command = this.#entries[i];
+        if (command.kind !== "command")
+          break;
+        compiled.push({ segments: command.segments, dispatch: compose(command.handlers) });
+        i++;
+      }
+      stack.push(dispatchFor(compiled));
+    }
+    return compose(stack);
+  }
+  middleware() {
+    const fn = this.#compile();
+    return async (ctx, next) => {
+      await fn(ctx, next);
+    };
+  }
+}
+export {
+  RhythmCli
 };
-//#endregion
-export { RhythmCli };

package/dist/run.d.ts

@@ -0,0 +1,8 @@
+import type { Rhythm } from "@rhythmjs/rhythm";
+import { type RhythmPrompt } from "./prompt";
+import { type RhythmCliContext } from "./context";
+export declare function toCliHandler<TContext extends RhythmCliContext, TProviders extends object = {}>(app: Rhythm<RhythmCliContext, TContext, TProviders>): (argv: string[]) => Promise<number>;
+export declare function createPrompt(): {
+    prompt: RhythmPrompt;
+    close: () => void;
+};

package/dist/run.js

@@ -0,0 +1,48 @@
+// @bun
+import {
+  parseArgv2
+} from "./rhythm-cli-qdf1cds9.js";
+import {
+  createPrompt2
+} from "./rhythm-cli-28bavedc.js";
+import {
+  RhythmCliResponse2
+} from "./rhythm-cli-abdgd67x.js";
+
+// src/run.ts
+function toCliHandler(app) {
+  const run = app.callback();
+  return async (argv) => {
+    const { flags } = parseArgv2(argv);
+    const stdin = process.stdin.isTTY ? null : Bun.stdin.stream();
+    const ctx = await run({ argv, flags, stdin, response: new RhythmCliResponse2 });
+    for (const line of ctx.response.stdout)
+      console.log(line);
+    for (const line of ctx.response.stderr)
+      console.error(line);
+    return ctx.response.exitCode;
+  };
+}
+function defaultPromptIO() {
+  const lines = console[Symbol.asyncIterator]();
+  return {
+    ask: async (query) => {
+      process.stdout.write(query);
+      const { value } = await lines.next();
+      return value ?? "";
+    },
+    write: (text) => {
+      process.stdout.write(text);
+    },
+    close: () => {
+      lines.return?.();
+    }
+  };
+}
+function createPrompt() {
+  return createPrompt2(defaultPromptIO());
+}
+export {
+  createPrompt,
+  toCliHandler
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rhythmjs/cli",
-  "version": "0.0.10",
-  "description": "Command-line argument parsing, prompts, and command routing for the Rhythm middleware kernel.",
+  "version": "0.0.12",
+  "description": "Command-line argument parsing, prompts, and command routing for the Rhythm middleware kernel, running on Bun.",
   "homepage": "https://rhythm.js.org/cli",
   "license": "ISC",
   "repository": {
@@ -27,21 +27,21 @@
       "types": "./dist/prompt.d.ts",
       "default": "./dist/prompt.js"
     },
-    "./adapters/bun": {
-      "types": "./dist/adapters/bun.d.ts",
-      "default": "./dist/adapters/bun.js"
-    },
-    "./adapters/deno": {
-      "types": "./dist/adapters/deno.d.ts",
-      "default": "./dist/adapters/deno.js"
+    "./context": {
+      "types": "./dist/context.d.ts",
+      "default": "./dist/context.js"
     },
-    "./adapters/node": {
-      "types": "./dist/adapters/node.d.ts",
-      "default": "./dist/adapters/node.js"
+    "./run": {
+      "types": "./dist/run.d.ts",
+      "default": "./dist/run.js"
     },
     "./adapters/context": {
-      "types": "./dist/adapters/context.d.ts",
-      "default": "./dist/adapters/context.js"
+      "types": "./dist/context.d.ts",
+      "default": "./dist/context.js"
+    },
+    "./adapters/bun": {
+      "types": "./dist/run.d.ts",
+      "default": "./dist/run.js"
     },
     "./package.json": "./package.json"
   },
@@ -49,15 +49,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@rhythmjs/rhythm": "0.0.10"
+    "@rhythmjs/rhythm": "0.0.12"
   },
   "devDependencies": {
     "@types/bun": "^1.4.2",
     "@types/node": "^26.6.3",
-    "typescript": "^7.0.2",
-    "vite-plus": "^1.0.0"
+    "typescript": "^7.0.2"
   },
   "engines": {
-    "node": ">=20.19.0"
+    "bun": ">=1.2.0"
+  },
+  "scripts": {
+    "build": "bun build src/rhythm-cli.ts src/argv.ts src/prompt.ts src/context.ts src/run.ts --outdir dist --root src --format esm --target bun --packages external --splitting && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
   }
 }

package/dist/adapters/bun.d.ts

@@ -1,10 +0,0 @@
-import { t as RhythmPrompt } from "../prompt-DXqXd-xC.js";
-import { t as RhythmCliContext } from "../context-DyXPT9sP.js";
-import { Rhythm } from "@rhythmjs/rhythm";
-//#region src/adapters/bun.d.ts
-export declare function toCliHandler<TContext extends RhythmCliContext, TProviders extends object = {}>(app: Rhythm<RhythmCliContext, TContext, TProviders>): (argv: string[]) => Promise<number>;
-export declare function createPrompt(): {
-  prompt: RhythmPrompt;
-  close: () => void;
-};
-//#endregion

package/dist/adapters/bun.js

@@ -1,39 +0,0 @@
-import { parseArgv } from "../argv.js";
-import { createPrompt as createPrompt$1 } from "../prompt.js";
-import { RhythmCliResponse } from "./context.js";
-import * as readline from "node:readline";
-//#region src/adapters/bun.ts
-function toCliHandler(app) {
-	const run = app.callback();
-	return async (argv) => {
-		const { flags } = parseArgv(argv);
-		const stdin = process.stdin.isTTY ? null : Bun.stdin.stream();
-		const ctx = await run({
-			argv,
-			flags,
-			stdin,
-			response: new RhythmCliResponse()
-		});
-		for (const line of ctx.response.stdout) console.log(line);
-		for (const line of ctx.response.stderr) console.error(line);
-		return ctx.response.exitCode;
-	};
-}
-function defaultPromptIO(input = process.stdin, output = process.stdout) {
-	const rl = readline.createInterface({
-		input,
-		output
-	});
-	return {
-		ask: (query) => new Promise((resolve) => rl.question(query, resolve)),
-		write: (text) => {
-			output.write(text);
-		},
-		close: () => rl.close()
-	};
-}
-function createPrompt() {
-	return createPrompt$1(defaultPromptIO());
-}
-//#endregion
-export { createPrompt, toCliHandler };

package/dist/adapters/context.d.ts

@@ -1,2 +0,0 @@
-import { n as RhythmCliResponse, t as RhythmCliContext } from "../context-DyXPT9sP.js";
-export { RhythmCliContext, RhythmCliResponse };

package/dist/adapters/context.js

@@ -1,20 +0,0 @@
-//#region src/adapters/context.ts
-var RhythmCliResponse = class {
-	exitCode = 0;
-	stdout = [];
-	stderr = [];
-	print(line) {
-		this.stdout.push(line);
-		return this;
-	}
-	printError(line) {
-		this.stderr.push(line);
-		return this;
-	}
-	exit(code) {
-		this.exitCode = code;
-		return this;
-	}
-};
-//#endregion
-export { RhythmCliResponse };

package/dist/adapters/deno.d.ts

@@ -1,2 +0,0 @@
-import { createPrompt, toCliHandler } from "./node.js";
-export { createPrompt, toCliHandler };

package/dist/adapters/deno.js

@@ -1,2 +0,0 @@
-import { createPrompt, toCliHandler } from "./node.js";
-export { createPrompt, toCliHandler };

package/dist/adapters/node.d.ts

@@ -1,10 +0,0 @@
-import { t as RhythmPrompt } from "../prompt-DXqXd-xC.js";
-import { t as RhythmCliContext } from "../context-DyXPT9sP.js";
-import { Rhythm } from "@rhythmjs/rhythm";
-//#region src/adapters/node.d.ts
-export declare function toCliHandler<TContext extends RhythmCliContext, TProviders extends object = {}>(app: Rhythm<RhythmCliContext, TContext, TProviders>): (argv: string[]) => Promise<number>;
-export declare function createPrompt(): {
-  prompt: RhythmPrompt;
-  close: () => void;
-};
-//#endregion

package/dist/adapters/node.js

@@ -1,40 +0,0 @@
-import { parseArgv } from "../argv.js";
-import { createPrompt as createPrompt$1 } from "../prompt.js";
-import { RhythmCliResponse } from "./context.js";
-import * as readline from "node:readline";
-import { Readable } from "node:stream";
-//#region src/adapters/node.ts
-function toCliHandler(app) {
-	const run = app.callback();
-	return async (argv) => {
-		const { flags } = parseArgv(argv);
-		const stdin = process.stdin.isTTY ? null : Readable.toWeb(process.stdin);
-		const ctx = await run({
-			argv,
-			flags,
-			stdin,
-			response: new RhythmCliResponse()
-		});
-		for (const line of ctx.response.stdout) console.log(line);
-		for (const line of ctx.response.stderr) console.error(line);
-		return ctx.response.exitCode;
-	};
-}
-function defaultPromptIO(input = process.stdin, output = process.stdout) {
-	const rl = readline.createInterface({
-		input,
-		output
-	});
-	return {
-		ask: (query) => new Promise((resolve) => rl.question(query, resolve)),
-		write: (text) => {
-			output.write(text);
-		},
-		close: () => rl.close()
-	};
-}
-function createPrompt() {
-	return createPrompt$1(defaultPromptIO());
-}
-//#endregion
-export { createPrompt, toCliHandler };

package/dist/context-DyXPT9sP.d.ts

@@ -1,17 +0,0 @@
-//#region src/adapters/context.d.ts
-declare class RhythmCliResponse {
-  exitCode: number;
-  stdout: string[];
-  stderr: string[];
-  print(line: string): this;
-  printError(line: string): this;
-  exit(code: number): this;
-}
-interface RhythmCliContext {
-  readonly argv: readonly string[];
-  readonly flags: Readonly<Record<string, string | boolean>>;
-  readonly stdin: ReadableStream<Uint8Array> | null;
-  readonly response: RhythmCliResponse;
-}
-//#endregion
-export { RhythmCliResponse as n, RhythmCliContext as t };

package/dist/prompt-DXqXd-xC.d.ts

@@ -1,26 +0,0 @@
-//#region src/prompt.d.ts
-interface RhythmPrompt {
-  text(message: string, options?: {
-    default?: string;
-  }): Promise<string>;
-  confirm(message: string, options?: {
-    default?: boolean;
-  }): Promise<boolean>;
-  select<T extends string>(message: string, choices: readonly T[], options?: {
-    allowCustom?: boolean;
-  }): Promise<T | string>;
-  multiSelect<T extends string>(message: string, choices: readonly T[], options?: {
-    allowCustom?: boolean;
-  }): Promise<(T | string)[]>;
-}
-interface RhythmPromptIO {
-  ask(this: void, query: string): Promise<string>;
-  write(this: void, text: string): void;
-  close?(this: void): void;
-}
-declare function createPrompt(io: RhythmPromptIO): {
-  prompt: RhythmPrompt;
-  close: () => void;
-};
-//#endregion
-export { RhythmPromptIO as n, createPrompt as r, RhythmPrompt as t };