@w6w/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 w6w-io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# @w6w/cli
+
+The `w6w` command-line client for the [w6w](https://w6w.dev) workflow platform.
+
+It is a **thin** client, built on [`@w6w/sdk`](https://www.npmjs.com/package/@w6w/sdk): transport,
+auth, output formatting and exit codes. No business logic, no client-side polling, no hidden
+retries. Everything it can do, the HTTP API can do — the CLI just makes it typeable.
+
+- **License:** MIT (see [LICENSE](./LICENSE)).
+- **Version:** `0.1.0`.
+
+## Install
+
+```bash
+npm install -g @w6w/cli
+w6w --help
+```
+
+`@w6w/cli`, `@w6w/sdk` and the Python `w6w` package share one version number and are released
+together. A given version means the same set of operations in every language.
+
+## Configuration
+
+Two environment variables:
+
+| Variable       | Meaning                                                                                                                         | Required |
+| -------------- | ------------------------------------------------------------------------------------------------------------------------------- | -------- |
+| `W6W_BASE_URL` | The **origin** of your w6w server, e.g. `https://api.example.com`. The API's base path is appended for you — do not include it. | Yes      |
+| `W6W_TOKEN`    | Your API token, sent as `Authorization: Bearer <token>` on every request.                                                       | Yes      |
+
+Both have a flag equivalent, and **a flag always wins over the environment**: `--base-url <url>` and
+`--token <token>`.
+
+```bash
+export W6W_BASE_URL=https://api.example.com
+export W6W_TOKEN=…
+w6w workflows list
+```
+
+`--help` and `--version` deliberately need neither. They resolve with no token configured and no
+server reachable, which is exactly when people need them most.
+
+## Help
+
+Help resolves at three levels, and `-h` is an alias for `--help` at all of them:
+
+```bash
+w6w --help                   # what w6w is, the global flags, the command groups
+w6w documents --help         # the commands in a group
+w6w documents create --help  # arguments, flags, examples
+w6w help documents create    # the same thing, spelled the other way
+```
+
+Help is **generated** from the machine-readable surface contract all three w6w wrappers implement,
+so the CLI cannot document an operation it does not have, or omit one it does. A bare `w6w` prints
+the root help and exits `0`.
+
+## Exit codes
+
+| Code | Meaning                                                                  |
+| ---- | ------------------------------------------------------------------------ |
+| `0`  | Success — including help, and including a _queued_ or _running_ workflow |
+| `1`  | Usage error — unknown command, missing argument, bad flag                |
+| `2`  | API error — 4xx/5xx from the server, including auth failure              |
+| `3`  | Run failure — `--wait` returned a run with status `failed`               |
+
+Code `3` exists so `w6w workflows run --wait` is usable in CI without parsing stdout. Keeping it
+distinct from `2` matters: a failed workflow and an unreachable API demand opposite responses, and a
+script that cannot tell them apart will retry the wrong one.
+
+## The surface
+
+What commands exist is not decided in this repo. It is defined by the shared machine-readable
+contract `endpoints.json`, which sits beside this repo alongside its two sibling wrapper repos and
+which each wrapper's conformance test reads directly — the same file, never a vendored copy. A
+command missing from a wrapper is a failing test, not a preference.
+
+Some operations are marked `planned` in that contract: they are implemented and unit-tested here,
+but the corresponding server route is not live yet, so calling them against a server today returns
+`404`. Their help says so. The marker records **server** readiness, not CLI completeness.
+
+## Versioning
+
+The version is a shared fact across all three wrappers, so a release may go out for this package
+even when nothing in it changed — a divergent version is far more expensive than an empty release.
+
+Below `1.0.0`, **breaking changes may land in a minor bump.** That grace ends at `1.0.0`; do not
+plan around it.
+
+## Development
+
+The gates are Deno tasks. They need no network and no server:
+
+```bash
+deno task gen:help   # regenerate src/help.generated.ts from the shared contract
+deno task check      # typecheck mod.ts, bin/, scripts/, src/ and tests/
+deno task lint
+deno task fmt:check
+deno task test       # every test runs in-process, against no server
+deno task cov        # test with coverage, then report it
+```
+
+`src/help.generated.ts` is generated — never edit it by hand. `deno task test` compares it
+byte-for-byte against a fresh render, so a contract change that was not regenerated fails the suite
+instead of shipping stale help.
+
+Runtime access — argv, environment, exit — lives in exactly one module, `src/runtime.ts`. Everything
+else uses Web-standard globals only, which is what lets the same source run under Deno during
+development and under Node once published. The npm `dist/` build (`npm run build`, i.e.
+`tsc -p tsconfig.build.json`) runs in CI only.

package/dist/bin/w6w.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env -S deno run -A
+/**
+ * The `w6w` binary.
+ *
+ * The only module that touches the real command line and the real process exit,
+ * and it does both through `src/runtime.ts` — so the entire CLI above it stays a
+ * pure function of `(argv, io, options)` and can be tested in-process.
+ *
+ * Its job is wiring, and only wiring: read the host's arguments and environment,
+ * decide whether stdout is a terminal, hand the command registry to `main()`, and
+ * exit with the code it returns. Nothing here decides anything a test cannot.
+ *
+ * Under Deno this file runs directly — `deno run -A bin/w6w.ts …`, or through the
+ * shebang above. For npm it is compiled to `dist/bin/w6w.js`, which is what
+ * `package.json`'s `bin` entry points at.
+ *
+ * Help and `--version` need no permissions beyond writing to stdout, which is why
+ * `deno run --allow-read --allow-env bin/w6w.ts --help` works with no token set
+ * and no server reachable: nothing on those paths constructs a client.
+ */
+export {};
+//# sourceMappingURL=w6w.d.ts.map

package/dist/bin/w6w.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"w6w.d.ts","sourceRoot":"","sources":["../../bin/w6w.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/bin/w6w.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * The `w6w` binary.
+ *
+ * The only module that touches the real command line and the real process exit,
+ * and it does both through `src/runtime.ts` — so the entire CLI above it stays a
+ * pure function of `(argv, io, options)` and can be tested in-process.
+ *
+ * Its job is wiring, and only wiring: read the host's arguments and environment,
+ * decide whether stdout is a terminal, hand the command registry to `main()`, and
+ * exit with the code it returns. Nothing here decides anything a test cannot.
+ *
+ * Under Deno this file runs directly — `deno run -A bin/w6w.ts …`, or through the
+ * shebang above. For npm it is compiled to `dist/bin/w6w.js`, which is what
+ * `package.json`'s `bin` entry points at.
+ *
+ * Help and `--version` need no permissions beyond writing to stdout, which is why
+ * `deno run --allow-read --allow-env bin/w6w.ts --help` works with no token set
+ * and no server reachable: nothing on those paths constructs a client.
+ */
+import { main } from "../mod.js";
+import { COMMANDS } from "../src/commands/index.js";
+import { systemRuntime } from "../src/runtime.js";
+/**
+ * The commands this build can run.
+ *
+ * The registry is assembled in `src/commands/index.ts`, one group at a time, and
+ * this file only hands it over: the entry point owns the wiring and nothing
+ * else. A command in the help tree with no entry in that registry answers with a
+ * usage error saying it is not available in this build, which is a better answer
+ * than a silent success.
+ */
+const commands = COMMANDS;
+/**
+ * Whether stdout is a terminal — the third of the three ways colour turns itself
+ * off (the other two being `--no-color` and `NO_COLOR`).
+ *
+ * A capability probe rather than a runtime assumption, the same shape
+ * `src/runtime.ts` uses, so this file compiles for the npm build (where no Deno
+ * types exist) and runs unchanged under Deno, Node and Bun. Anything it cannot
+ * establish counts as "not a terminal": a pipe is the case where colour actively
+ * corrupts the output, so it is the safe default to assume.
+ */
+function stdoutIsTerminal() {
+    const host = globalThis;
+    const deno = host.Deno?.stdout;
+    if (deno?.isTerminal)
+        return deno.isTerminal();
+    return host.process?.stdout?.isTTY === true;
+}
+const runtime = systemRuntime();
+const code = await main(runtime.args, runtime, {
+    env: runtime.env,
+    isTty: stdoutIsTerminal(),
+    commands,
+});
+runtime.exit(code);
+//# sourceMappingURL=w6w.js.map

package/dist/bin/w6w.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"w6w.js","sourceRoot":"","sources":["../../bin/w6w.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,QAAQ,GAAoB,QAAQ,CAAC;AAE3C;;;;;;;;;GASG;AACH,SAAS,gBAAgB;IACvB,MAAM,IAAI,GAAG,UAGZ,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,IAAI,IAAI,EAAE,UAAU;QAAE,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC/C,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE;IAC7C,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,KAAK,EAAE,gBAAgB,EAAE;IACzB,QAAQ;CACT,CAAC,CAAC;AACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/mod.d.ts

@@ -0,0 +1,131 @@
+/**
+ * `@w6w/cli` — the package barrel and the CLI's programmatic entry point.
+ *
+ * {@linkcode main} is the whole command line, minus the host: it is handed an
+ * argument vector and somewhere to write, and it returns an exit code. It never
+ * reads the real command line and never ends the process — `bin/w6w.ts` does
+ * both, through `src/runtime.ts`. That split is what lets the entire surface,
+ * exit codes included, be exercised in-process by the test suite, against an
+ * injected environment and an injected transport, with no live server anywhere.
+ *
+ * {@linkcode runCli} is its synchronous half: help, `--version` and usage
+ * errors, which by contract resolve with no token configured and no server
+ * reachable. Running a command needs the API and therefore needs `await`, so it
+ * lives on `main` alone.
+ *
+ * The exit codes are the shared surface contract's, generated into
+ * `src/help.generated.ts` rather than restated here:
+ *
+ * | code | meaning |
+ * |---|---|
+ * | 0 | success, including help and a queued/running workflow |
+ * | 1 | usage error |
+ * | 2 | API error (4xx/5xx, including auth failure) |
+ * | 3 | run failure (`--wait` returned status `failed`) |
+ *
+ * @module
+ */
+import type { Invocation } from "./src/args.ts";
+import type { EnvReader } from "./src/client.ts";
+import type { Output } from "./src/output.ts";
+import type { HelpCommand } from "./src/help.generated.ts";
+import type { CliIo } from "./src/runtime.ts";
+import type { FetchLike, W6wClient } from "@w6w/sdk";
+export { parse } from "./src/args.ts";
+export type { FlagSpec, GlobalOptions, Invocation, ParseOptions, ParseResult } from "./src/args.ts";
+export { createClient, ENV_BASE_URL, ENV_TOKEN, envValue, NO_ENV } from "./src/client.ts";
+export type { ClientOptions, EnvReader } from "./src/client.ts";
+export { createOutput, ENV_NO_COLOR, useColor } from "./src/output.ts";
+export type { Output, OutputOptions, Styles } from "./src/output.ts";
+export { EXIT_API_ERROR, EXIT_RUN_FAILURE, EXIT_SUCCESS, EXIT_USAGE, exitCodeFor, } from "./src/exit.ts";
+export { renderCommandHelp, renderGroupHelp, renderHelp, renderRootHelp, resolve, } from "./src/help.ts";
+export type { Resolution } from "./src/help.ts";
+export { systemRuntime } from "./src/runtime.ts";
+export type { CliIo, CliRuntime } from "./src/runtime.ts";
+export { COMMAND_PATHS, EXIT_CODES, GLOBAL_FLAGS, HELP_TREE } from "./src/help.generated.ts";
+export type { HelpCommand, HelpExitCode, HelpGlobalFlag, HelpGroup, HelpParam, HelpTree, } from "./src/help.generated.ts";
+/**
+ * The published version of this package.
+ *
+ * The same string as `deno.json`'s and `package.json`'s `version` and the shared
+ * `VERSION` file beside this repo — the single version all three w6w wrappers
+ * publish under. `tests/help_test.ts` fails if any of those disagree, so it cannot
+ * drift silently. `--version` prints exactly this.
+ *
+ * The explicit `: string` annotation is required, not decorative: JSR publishes
+ * this file as TypeScript source and rejects inferred public types.
+ */
+export declare const VERSION: string;
+/**
+ * What a command handler is handed: the invocation, somewhere to write, and a
+ * way to reach the API.
+ *
+ * The client is a **function**, not a field, and that is the point: it is
+ * constructed on first call and never before, so a command that answers without
+ * the API — and every help path — needs no token and no reachable server.
+ * Calling it twice returns the same client.
+ */
+export interface CommandContext {
+    /** The command this invocation resolved to, straight out of the help tree. */
+    readonly command: HelpCommand;
+    /** The parsed command line: positional arguments, global flags, command flags. */
+    readonly invocation: Invocation;
+    /** The renderer. Every byte a command writes goes through it. */
+    readonly out: Output;
+    /**
+     * The API client, built on first use from the global flags and the
+     * environment.
+     *
+     * @throws {ConfigError} When the base URL or token is missing or unusable.
+     */
+    client(): W6wClient;
+}
+/**
+ * One command's implementation.
+ *
+ * Return nothing for the ordinary success case; return a code only where the
+ * exit-code contract has something to say that "it worked" does not — which is
+ * `--wait` on a run that failed. Get it from {@linkcode exitCodeFor}; never
+ * write the number.
+ *
+ * A handler does not catch its own API errors: {@linkcode main} maps a thrown
+ * error to an exit code and reports it on stderr, once, for every command.
+ */
+export type CommandHandler = (context: CommandContext) => number | void | Promise<number | void>;
+/**
+ * The registry the dispatcher walks, keyed by canonical command path —
+ * `"me"`, `"documents list"`. Aliases resolve to the canonical path before the
+ * lookup, so `w6w info` finds `"me"`.
+ */
+export type CommandRegistry = Record<string, CommandHandler>;
+/** Everything the CLI needs from its host, all of it injectable. */
+export interface CliOptions {
+    /** The environment seam. Defaults to an empty environment. */
+    env?: EnvReader;
+    /** Transport override, handed to the SDK. The test suite's seam. */
+    fetch?: FetchLike;
+    /** Whether stdout is a terminal, for the colour decision. Defaults to `false`. */
+    isTty?: boolean;
+    /** The commands that are wired up. Defaults to none. */
+    commands?: CommandRegistry;
+}
+/**
+ * Runs a command line and returns its exit code. The whole CLI.
+ *
+ * @param argv - The argument vector, with the runtime's own prefix already dropped.
+ * @param io - Where to write. Nothing else is written anywhere.
+ * @param options - The environment, the transport, the terminal, the commands.
+ * @returns The exit code, one of the four the contract declares.
+ */
+export declare function main(argv: string[], io: CliIo, options?: CliOptions): Promise<number>;
+/**
+ * The synchronous half of the command line: help, `--version`, and usage errors.
+ *
+ * Kept because those are exactly the paths that must work with **no token
+ * configured and no server reachable**, and a function that cannot reach the API
+ * is the strongest possible statement of that. A runnable command is not run
+ * here — running one is asynchronous by nature — and comes back as a usage error
+ * pointing at its help. Use {@linkcode main}, which is what the binary calls.
+ */
+export declare function runCli(argv: string[], io: CliIo): number;
+//# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

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

package/dist/mod.js

@@ -0,0 +1,257 @@
+/**
+ * `@w6w/cli` — the package barrel and the CLI's programmatic entry point.
+ *
+ * {@linkcode main} is the whole command line, minus the host: it is handed an
+ * argument vector and somewhere to write, and it returns an exit code. It never
+ * reads the real command line and never ends the process — `bin/w6w.ts` does
+ * both, through `src/runtime.ts`. That split is what lets the entire surface,
+ * exit codes included, be exercised in-process by the test suite, against an
+ * injected environment and an injected transport, with no live server anywhere.
+ *
+ * {@linkcode runCli} is its synchronous half: help, `--version` and usage
+ * errors, which by contract resolve with no token configured and no server
+ * reachable. Running a command needs the API and therefore needs `await`, so it
+ * lives on `main` alone.
+ *
+ * The exit codes are the shared surface contract's, generated into
+ * `src/help.generated.ts` rather than restated here:
+ *
+ * | code | meaning |
+ * |---|---|
+ * | 0 | success, including help and a queued/running workflow |
+ * | 1 | usage error |
+ * | 2 | API error (4xx/5xx, including auth failure) |
+ * | 3 | run failure (`--wait` returned status `failed`) |
+ *
+ * @module
+ */
+import { GLOBAL_FLAG_SPECS, parse } from "./src/args.js";
+import { createClient, NO_ENV } from "./src/client.js";
+import { createOutput } from "./src/output.js";
+import { EXIT_SUCCESS, EXIT_USAGE, exitCodeFor } from "./src/exit.js";
+import { renderCommandHelp, renderGroupHelp, renderHelp, renderRootHelp, resolve, } from "./src/help.js";
+import { HELP_TREE } from "./src/help.generated.js";
+export { parse } from "./src/args.js";
+export { createClient, ENV_BASE_URL, ENV_TOKEN, envValue, NO_ENV } from "./src/client.js";
+export { createOutput, ENV_NO_COLOR, useColor } from "./src/output.js";
+export { EXIT_API_ERROR, EXIT_RUN_FAILURE, EXIT_SUCCESS, EXIT_USAGE, exitCodeFor, } from "./src/exit.js";
+export { renderCommandHelp, renderGroupHelp, renderHelp, renderRootHelp, resolve, } from "./src/help.js";
+export { systemRuntime } from "./src/runtime.js";
+// The four exit codes are re-exported from `src/exit.ts` above, alongside the
+// mapping that produces them — one import for anything to do with an exit code.
+export { COMMAND_PATHS, EXIT_CODES, GLOBAL_FLAGS, HELP_TREE } from "./src/help.generated.js";
+/**
+ * The published version of this package.
+ *
+ * The same string as `deno.json`'s and `package.json`'s `version` and the shared
+ * `VERSION` file beside this repo — the single version all three w6w wrappers
+ * publish under. `tests/help_test.ts` fails if any of those disagree, so it cannot
+ * drift silently. `--version` prints exactly this.
+ *
+ * The explicit `: string` annotation is required, not decorative: JSR publishes
+ * this file as TypeScript source and rejects inferred public types.
+ */
+export const VERSION = "0.1.0";
+/** `w6w help <command>` is accepted as an alias for `w6w <command> --help`. */
+const HELP_COMMAND = "help";
+/**
+ * The flags a command declares for itself, lifted out of the generated help
+ * tree so the parser and the help text cannot disagree about them.
+ *
+ * The flag's spelling is the first token of its help display (`--var
+ * <key=value>` → `--var`, which is not always its contract parameter name), and
+ * a display with nothing after that token is a boolean. Flags that shadow a
+ * global one are dropped: `--json` is already parsed for every command.
+ */
+function commandFlagSpecs(command) {
+    const globals = new Set(GLOBAL_FLAG_SPECS.map((spec) => spec.name));
+    const specs = [];
+    for (const param of command.params) {
+        if (param.kind !== "flag")
+            continue;
+        const [name, ...rest] = param.display.split(" ");
+        if (globals.has(name))
+            continue;
+        specs.push({ name, alias: null, type: rest.length > 0 ? "string" : "boolean" });
+    }
+    return specs;
+}
+/**
+ * Parses an argument vector, giving a resolved command's own flags a second
+ * chance.
+ *
+ * The first pass knows only the global flags, because which command's flags
+ * apply is not known until the command path has been read out of the same
+ * argument vector. So `w6w documents list --project p_1` fails that pass on an
+ * unknown flag — and the failure still carries the command the user was aiming
+ * at, which is exactly what is needed to re-parse with that command's flags
+ * added.
+ *
+ * **When the second pass fails too, its message is the one reported**, not the
+ * first pass's. The second pass ran with strictly more flags known, so it got
+ * further and its complaint is about the flag that is actually wrong; the first
+ * pass's complaint is about the first flag it had not been told about yet, which
+ * by then is usually a perfectly valid one. Reporting the first message names
+ * the wrong flag: `w6w vars create g --type string --value hello --project p`
+ * would answer `unknown flag: --type` — a flag that command declares and
+ * requires — sending the user to fix the one thing that was right.
+ */
+function parseInvocation(argv) {
+    const first = parse(argv);
+    if (first.ok)
+        return first;
+    const resolution = resolve(first.command);
+    if (resolution.kind !== "command")
+        return first;
+    const specs = commandFlagSpecs(resolution.command);
+    if (specs.length === 0)
+        return first;
+    return parse(argv, { flags: specs });
+}
+/**
+ * Answers everything that can be answered without the API, and reports
+ * everything else as a command to run.
+ *
+ * Help and `--version` are answered here, before anything else: they must
+ * resolve with **no token configured and no server reachable**, so nothing on
+ * those paths constructs a client or performs I/O beyond writing to `io`.
+ */
+function route(argv, io) {
+    const done = (code) => ({ kind: "done", code });
+    const result = parseInvocation(argv);
+    if (!result.ok) {
+        io.stderr(`${HELP_TREE.binary}: ${result.message}`);
+        io.stderr("");
+        io.stderr(renderHelp(resolve(result.command)));
+        return done(EXIT_USAGE);
+    }
+    const { command, positionals, globals } = result.invocation;
+    // `w6w help <command>` — the same three levels, reached by the other spelling.
+    if (command[0] === HELP_COMMAND) {
+        const target = [...command.slice(1), ...positionals];
+        const resolution = resolve(target);
+        if (resolution.kind === "unknown") {
+            io.stderr(`${HELP_TREE.binary}: unknown command: ${target.join(" ")}`);
+            io.stderr("");
+            io.stderr(renderHelp(resolution));
+            return done(EXIT_USAGE);
+        }
+        io.stdout(renderHelp(resolution));
+        return done(EXIT_SUCCESS);
+    }
+    if (globals.version) {
+        io.stdout(VERSION);
+        return done(EXIT_SUCCESS);
+    }
+    const resolution = resolve(command);
+    switch (resolution.kind) {
+        // A bare `w6w` prints root help and exits 0 — not an error, not a usage stub.
+        case "root":
+            io.stdout(renderRootHelp());
+            return done(EXIT_SUCCESS);
+        case "unknown":
+            io.stderr(`${HELP_TREE.binary}: unknown command: ${command.join(" ")}`);
+            io.stderr("");
+            io.stderr(renderHelp(resolution));
+            return done(EXIT_USAGE);
+        // A group is never runnable. With --help that is a question, answered on
+        // stdout; without it, it is an incomplete command, answered on stderr.
+        case "group":
+            if (globals.help) {
+                io.stdout(renderGroupHelp(resolution.group));
+                return done(EXIT_SUCCESS);
+            }
+            io.stderr(`${HELP_TREE.binary}: \`${resolution.group.name}\` needs a subcommand`);
+            io.stderr("");
+            io.stderr(renderGroupHelp(resolution.group));
+            return done(EXIT_USAGE);
+        case "command":
+            if (globals.help) {
+                io.stdout(renderCommandHelp(resolution.command));
+                return done(EXIT_SUCCESS);
+            }
+            return { kind: "run", command: resolution.command, invocation: result.invocation };
+    }
+}
+/**
+ * Runs one command and turns whatever happens into an exit code.
+ *
+ * Every command's error handling is here rather than in the command: an error
+ * is reported once, on stderr, and mapped once, through `src/exit.ts`. A
+ * handler that wants a code other than success returns it; a handler that
+ * throws gets the mapping for what it threw.
+ */
+async function dispatch(routed, io, options) {
+    const { globals } = routed.invocation;
+    const out = createOutput(io, {
+        json: globals.json,
+        noColor: globals.noColor,
+        isTty: options.isTty,
+        env: options.env,
+    });
+    const key = routed.command.path.join(" ");
+    const handler = options.commands?.[key];
+    if (!handler) {
+        out.error(`\`${key}\` is not available in this build. ` +
+            `Try \`${HELP_TREE.binary} ${key} --help\`.`);
+        return EXIT_USAGE;
+    }
+    // Built on demand and remembered: a command that never asks for the API never
+    // needs a token, and one that asks twice gets one client, not two.
+    let client = null;
+    const context = {
+        command: routed.command,
+        invocation: routed.invocation,
+        out,
+        client: () => {
+            if (client === null) {
+                client = createClient(globals, options.env ?? NO_ENV, { fetch: options.fetch });
+            }
+            return client;
+        },
+    };
+    try {
+        return (await handler(context)) ?? EXIT_SUCCESS;
+    }
+    catch (error) {
+        // Normalised at the boundary rather than inside the mapping: `throw "boom"`
+        // is legal JavaScript, and a mapping asked to classify a bare string has no
+        // way to tell it from a returned payload — which would make a crash exit 0.
+        const failure = error instanceof Error ? error : new Error(String(error));
+        out.error(failure.message);
+        return exitCodeFor(failure);
+    }
+}
+/**
+ * Runs a command line and returns its exit code. The whole CLI.
+ *
+ * @param argv - The argument vector, with the runtime's own prefix already dropped.
+ * @param io - Where to write. Nothing else is written anywhere.
+ * @param options - The environment, the transport, the terminal, the commands.
+ * @returns The exit code, one of the four the contract declares.
+ */
+export async function main(argv, io, options = {}) {
+    const routed = route(argv, io);
+    if (routed.kind === "done")
+        return routed.code;
+    return await dispatch(routed, io, options);
+}
+/**
+ * The synchronous half of the command line: help, `--version`, and usage errors.
+ *
+ * Kept because those are exactly the paths that must work with **no token
+ * configured and no server reachable**, and a function that cannot reach the API
+ * is the strongest possible statement of that. A runnable command is not run
+ * here — running one is asynchronous by nature — and comes back as a usage error
+ * pointing at its help. Use {@linkcode main}, which is what the binary calls.
+ */
+export function runCli(argv, io) {
+    const routed = route(argv, io);
+    if (routed.kind === "done")
+        return routed.code;
+    const path = routed.command.path.join(" ");
+    io.stderr(`${HELP_TREE.binary}: \`${path}\` needs the API, which this entry point does not reach. ` +
+        `Try \`${HELP_TREE.binary} ${path} --help\`.`);
+    return EXIT_USAGE;
+}
+//# sourceMappingURL=mod.js.map

package/dist/mod.js.map

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