@w6w/cli 0.6.0 → 0.9.8

package/README.md

@@ -7,7 +7,9 @@ auth, output formatting and exit codes. No business logic, no client-side pollin
 retries. Everything it can do, the HTTP API can do — the CLI just makes it typeable.
 
 - **License:** MIT (see [LICENSE](./LICENSE)).
-- **Version:** `0.1.1`.
+- **Version:** `0.9.7`. Needs Node.js 18 or later.
+- **Guides:** [docs.w6w.io/clients/cli](https://docs.w6w.io/clients/cli/), with a
+  [command reference](https://docs.w6w.io/clients/cli/commands/).
 
 ## Install
 
@@ -16,8 +18,8 @@ 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.
+`@w6w/cli`, `@w6w/sdk`, `@w6w/react` 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
 
@@ -43,28 +45,53 @@ server reachable, which is exactly when people need them most.
 ## Usage
 
 ```bash
-w6w me                        # who am I, and which component versions am I talking to?
+w6w me                        # who am I, and which CLI version is this? (alias: info)
 
 # Discover what you can run — a `conn_…`, `wf_…`, `fn_…` or `ep_…` id.
-w6w connections list
+w6w connections list          # short forms: `w6w conn ls`, `w6w wf ls`, `w6w docs ls`
 w6w workflows list
+w6w functions list
 
 # Run a connection action: a `conn_…` id needs --action.
 w6w run conn_01H… --action send_email --payload '{"to":"a@b.com"}'
 
-# A function or an endpoint runs the same way, with no --action.
-w6w run fn_normalize_address --payload '{"address":"1 Infinite Loop"}'
+# …or name the app, when you have exactly one connection for it.
+w6w run --app sendgrid --action send_email --payload '{"to":"a@b.com"}'
+
+# A Function or an Endpoint runs the same way, with no --action — by id, or by key
+# with an `fn:` / `ep:` / `wf:` prefix.
+w6w run fn_01H… --payload '{"address":"1 Infinite Loop"}'
+w6w run fn:normalize-address --payload '{"address":"1 Infinite Loop"}'
 
 # `w6w run wf_…` dispatches a workflow like anything else and always queues it.
 # `w6w workflows run` is the typed path, and the only one that can wait:
-w6w workflows run wf_01H… --wait
+w6w workflows run wf_01H… --wait --input '{"email":"a@b.com"}'
+w6w workflows cancel run_01H…
 
 # Documents and vars are plain CRUD; the key/name is positional, the rest are flags.
 w6w documents create welcome --content "# Hi"
 w6w vars create greeting --type string --value hello
+
+# Your account's members and invites (writes need the owner or admin role).
+w6w team members
+w6w team invite --email dev@example.com --role member
 ```
 
-Add `--json` to any command for raw JSON instead of a table — the shape to script against.
+Add `--json` to any command for raw JSON instead of a table — the shape to script against. Errors go
+to stderr as `w6w: <message>`; colour is used only on a terminal and is turned off by `--no-color`
+or `NO_COLOR`.
+
+### Known limitations
+
+A few flags that `--help` lists aren't applied yet:
+
+- `functions run` / `endpoints run` read neither `--id-or-key` nor `--inputs` / `--input`, and
+  reject `--payload`. Pass the key positionally, and send input with
+  `w6w run fn:<key> --payload '…'` (or `ep:<key>`).
+- `workflows run` ignores `--var` and `--trigger`.
+- `workflows update` ignores `--if-unmodified-since`, so the save always wins.
+- `team --help` still says the routes return `404`; they are live and work.
+- `functions delete` needs the Function archived first, which the CLI can't do yet.
 
 ## Help
 
@@ -77,18 +104,18 @@ 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`.
+Help is **generated** from the machine-readable surface contract every contract lane implements, 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 | Meaning                                                                                                  |
+| ---- | -------------------------------------------------------------------------------------------------------- |
+| `0`  | Success — including help, and including a _queued_ or _running_ workflow                                 |
+| `1`  | Usage or configuration error — unknown command, missing argument, bad flag or JSON, no base URL or token |
+| `2`  | API error — 4xx/5xx from the server, including auth failure, or the server could not be reached          |
+| `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
@@ -97,18 +124,17 @@ 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.
+contract `endpoints.json`, which sits at the root of this repo, one directory up, and which each
+contract lane'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.
+An operation marked `planned` in that contract is implemented and unit-tested here ahead of its
+server route, and its 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.
+The version is a shared fact across all four packages, 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.

package/dist/mod.js

@@ -51,7 +51,7 @@ export { COMMAND_PATHS, EXIT_CODES, GLOBAL_FLAGS, HELP_TREE } from "./src/help.g
  * The explicit `: string` annotation is required, not decorative: JSR publishes
  * this file as TypeScript source and rejects inferred public types.
  */
-export const VERSION = "0.6.0";
+export const VERSION = "0.9.8";
 /** `w6w help <command>` is accepted as an alias for `w6w <command> --help`. */
 const HELP_COMMAND = "help";
 /**

package/dist/src/commands/functions.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `w6w functions …` — the Function definition lifecycle at the command line.
+ *
+ * Five commands, **one SDK call each**. `functions run` is deliberately NOT
+ * here: it lives in `src/commands/named-run.ts` beside `endpoints run`, because
+ * the two share their whole shape (a name, a JSON input, an unwrapped output)
+ * and splitting them by domain would put one of a matched pair in each file.
+ * The registry is keyed by command path, so a caller sees one `w6w functions`
+ * group either way.
+ *
+ * This group mirrors `w6w workflows` op for op, minus two things the server
+ * does not have on this domain:
+ *
+ * - **No `--project`.** `GET /functions` reads no `?project=` at all, so a flag
+ *   here would be one the server ignores — the same reason `w6w vars` refuses
+ *   it while `w6w documents` takes it.
+ * - **No archive step.** A Function deletes in one call.
+ *
+ * `create` and `update` are the same upsert route: `create` mints the required
+ * `fn_…` id, `update` pins the one you addressed, and `update` is therefore a
+ * FULL REPLACEMENT — `w6w functions get <id> --json` is where the definition to
+ * edit comes from.
+ *
+ * @module
+ */
+import type { CommandRegistry } from "../../mod.ts";
+export declare const FUNCTION_COMMANDS: CommandRegistry;
+//# sourceMappingURL=functions.d.ts.map

package/dist/src/commands/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../src/commands/functions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAkC,eAAe,EAAE,MAAM,cAAc,CAAC;AAoGpF,eAAO,MAAM,iBAAiB,EAAE,eAM/B,CAAC"}

package/dist/src/commands/functions.js

@@ -0,0 +1,121 @@
+/**
+ * `w6w functions …` — the Function definition lifecycle at the command line.
+ *
+ * Five commands, **one SDK call each**. `functions run` is deliberately NOT
+ * here: it lives in `src/commands/named-run.ts` beside `endpoints run`, because
+ * the two share their whole shape (a name, a JSON input, an unwrapped output)
+ * and splitting them by domain would put one of a matched pair in each file.
+ * The registry is keyed by command path, so a caller sees one `w6w functions`
+ * group either way.
+ *
+ * This group mirrors `w6w workflows` op for op, minus two things the server
+ * does not have on this domain:
+ *
+ * - **No `--project`.** `GET /functions` reads no `?project=` at all, so a flag
+ *   here would be one the server ignores — the same reason `w6w vars` refuses
+ *   it while `w6w documents` takes it.
+ * - **No archive step.** A Function deletes in one call.
+ *
+ * `create` and `update` are the same upsert route: `create` mints the required
+ * `fn_…` id, `update` pins the one you addressed, and `update` is therefore a
+ * FULL REPLACEMENT — `w6w functions get <id> --json` is where the definition to
+ * edit comes from.
+ *
+ * @module
+ */
+import { argument, noExtraArguments, requiredFlag, table, usageError } from "./shared.js";
+/**
+ * `--definition <json>` as the object the write routes take.
+ *
+ * The same rule `w6w workflows` applies, and deliberately a second copy rather
+ * than a shared helper: the two groups' definitions are different documents
+ * with different validators, and a shared parser is a seam for one domain's
+ * rules to start describing the other's errors.
+ */
+function definition(context) {
+    const text = requiredFlag(context, "definition", "--definition <json>");
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw usageError(context, "`--definition` must be valid JSON.");
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw usageError(context, "`--definition` must be a JSON object.");
+    }
+    return parsed;
+}
+/** One Function, as a table row. */
+function row(fn) {
+    // `valid` is rendered as a word rather than a boolean: this column answers
+    // "can I run this?", and `false` in a table of ids reads like a missing value.
+    return [fn.id, fn.key, fn.valid ? "runnable" : "draft", fn.updatedAt];
+}
+/** The listing: one line per Function, or a line saying there are none. */
+function renderList(fns, styles) {
+    if (fns.length === 0)
+        return styles.dim("No functions.");
+    return table(["ID", "KEY", "STATE", "UPDATED"], fns.map(row), styles);
+}
+/** One Function in full — the JSON is what the reader came for. */
+function renderDetail(detail, styles) {
+    const key = typeof detail.function.key === "string" ? detail.function.key : "";
+    const state = detail.valid ? "runnable" : "draft";
+    return [
+        `${styles.bold(key)} ${styles.dim(`(${state})`)}`,
+        "",
+        JSON.stringify(detail.function, null, 2),
+    ].join("\n");
+}
+/** The confirmation for a write: what changed, and how to address it next time. */
+function renderSave(verb, saved, styles) {
+    return `${verb} ${styles.bold(saved.key)} ${styles.dim(`(${saved.id})`)}`;
+}
+const list = async (context) => {
+    noExtraArguments(context, 0);
+    const fns = await context.client().functions.list();
+    context.out.emit(fns, (styles) => renderList(fns, styles));
+};
+const get = async (context) => {
+    const id = argument(context, 0, "a function id or key (see: `w6w functions list`)");
+    noExtraArguments(context, 1);
+    const detail = await context.client().functions.get(id);
+    context.out.emit(detail, (styles) => renderDetail(detail, styles));
+};
+const create = async (context) => {
+    noExtraArguments(context, 0);
+    const saved = await context.client().functions.create(definition(context));
+    context.out.emit(saved, (styles) => renderSave("Created", saved, styles));
+};
+const update = async (context) => {
+    const id = argument(context, 0, "a function id or key (see: `w6w functions list`)");
+    noExtraArguments(context, 1);
+    const saved = await context.client().functions.update(id, definition(context));
+    context.out.emit(saved, (styles) => renderSave("Updated", saved, styles));
+};
+/**
+ * `w6w functions delete <id>` — one call, no confirmation prompt.
+ *
+ * Nothing checks for callers first, here or server-side: a Function may be
+ * referenced by an Endpoint, a Workflow step, or another Function's `impl`, and
+ * those references break at call time rather than at delete time. This lane is
+ * non-interactive by construction, so it does not ask — it reports, and the
+ * caller decides before typing it.
+ */
+const remove = async (context) => {
+    const id = argument(context, 0, "a function id or key (see: `w6w functions list`)");
+    noExtraArguments(context, 1);
+    await context.client().functions.delete(id);
+    // `null` rather than the server's `{ok: true}`: the SDK unwraps a delete to
+    // nothing, and `--json` must not invent a body the wrapper does not have.
+    context.out.emit(null, (styles) => styles.dim(`Deleted ${id}.`));
+};
+export const FUNCTION_COMMANDS = {
+    "functions list": list,
+    "functions get": get,
+    "functions create": create,
+    "functions update": update,
+    "functions delete": remove,
+};
+//# sourceMappingURL=functions.js.map

package/dist/src/commands/functions.js.map

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

package/dist/src/commands/index.d.ts

@@ -20,9 +20,11 @@ export { DOCUMENT_COMMANDS } from "./documents.ts";
 export { VAR_COMMANDS } from "./vars.ts";
 export { ME_COMMANDS } from "./me.ts";
 export { CONNECTION_COMMANDS } from "./connections.ts";
+export { FUNCTION_COMMANDS } from "./functions.ts";
 export { NAMED_RUN_COMMANDS } from "./named-run.ts";
 export { WORKFLOW_COMMANDS } from "./workflows.ts";
 export { RUN_COMMANDS } from "./run.ts";
+export { TEAM_COMMANDS } from "./team.ts";
 /** Every wired command, keyed by canonical command path. */
 export declare const COMMANDS: CommandRegistry;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AASpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,EAAE,eAQtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAWpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,EAAE,eAUtB,CAAC"}

package/dist/src/commands/index.js

@@ -19,16 +19,20 @@ import { DOCUMENT_COMMANDS } from "./documents.js";
 import { VAR_COMMANDS } from "./vars.js";
 import { ME_COMMANDS } from "./me.js";
 import { CONNECTION_COMMANDS } from "./connections.js";
+import { FUNCTION_COMMANDS } from "./functions.js";
 import { NAMED_RUN_COMMANDS } from "./named-run.js";
 import { WORKFLOW_COMMANDS } from "./workflows.js";
 import { RUN_COMMANDS } from "./run.js";
+import { TEAM_COMMANDS } from "./team.js";
 export { DOCUMENT_COMMANDS } from "./documents.js";
 export { VAR_COMMANDS } from "./vars.js";
 export { ME_COMMANDS } from "./me.js";
 export { CONNECTION_COMMANDS } from "./connections.js";
+export { FUNCTION_COMMANDS } from "./functions.js";
 export { NAMED_RUN_COMMANDS } from "./named-run.js";
 export { WORKFLOW_COMMANDS } from "./workflows.js";
 export { RUN_COMMANDS } from "./run.js";
+export { TEAM_COMMANDS } from "./team.js";
 /** Every wired command, keyed by canonical command path. */
 export const COMMANDS = {
     ...DOCUMENT_COMMANDS,
@@ -36,7 +40,9 @@ export const COMMANDS = {
     ...ME_COMMANDS,
     ...CONNECTION_COMMANDS,
     ...WORKFLOW_COMMANDS,
+    ...FUNCTION_COMMANDS,
     ...NAMED_RUN_COMMANDS,
     ...RUN_COMMANDS,
+    ...TEAM_COMMANDS,
 };
 //# sourceMappingURL=index.js.map

package/dist/src/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAoB;IACvC,GAAG,iBAAiB;IACpB,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,mBAAmB;IACtB,GAAG,iBAAiB;IACpB,GAAG,kBAAkB;IACrB,GAAG,YAAY;CAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAoB;IACvC,GAAG,iBAAiB;IACpB,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,mBAAmB;IACtB,GAAG,iBAAiB;IACpB,GAAG,iBAAiB;IACpB,GAAG,kBAAkB;IACrB,GAAG,YAAY;IACf,GAAG,aAAa;CACjB,CAAC"}

package/dist/src/commands/team.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `w6w team …` — the caller's account team at the command line.
+ *
+ * Six commands, **one SDK call each**. Nothing here composes two requests,
+ * filters a list or resolves an id by scanning: a wrapper that has to compose
+ * two calls is describing an operation that belongs in the API
+ * (`README.md`, "What a wrapper is"), and the CLI is a wrapper like the other
+ * two.
+ *
+ * Every handler does the same four steps, in order: read its own arguments,
+ * call one method on `client.team`, render, return. Errors are not caught here
+ * — `main()` reports a throw once, on stderr, and maps it to an exit code
+ * through `src/exit.ts`, so an `ApiError` exits 2 and a usage error exits 1
+ * without any command deciding that for itself.
+ *
+ * **No `--project` anywhere in this group.** Team membership is account-wide,
+ * not project-scoped — unlike `w6w documents`, which takes the flag on every
+ * command.
+ *
+ * @module
+ */
+import type { CommandRegistry } from "../../mod.ts";
+/**
+ * The six `w6w team` commands, keyed by the canonical command path.
+ *
+ * The keys are the generated help tree's `path` values joined by a space,
+ * which are `endpoints.json`'s `naming.cli` spellings —
+ * `tests/cmd_team_test.ts` asserts the two sets are the same, so a command
+ * cannot be registered under a name the help does not document, or
+ * documented under a name nothing runs.
+ */
+export declare const TEAM_COMMANDS: CommandRegistry;
+//# sourceMappingURL=team.d.ts.map

package/dist/src/commands/team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../../../src/commands/team.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,cAAc,CAAC;AAuGpE;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,eAO3B,CAAC"}

package/dist/src/commands/team.js

@@ -0,0 +1,125 @@
+/**
+ * `w6w team …` — the caller's account team at the command line.
+ *
+ * Six commands, **one SDK call each**. Nothing here composes two requests,
+ * filters a list or resolves an id by scanning: a wrapper that has to compose
+ * two calls is describing an operation that belongs in the API
+ * (`README.md`, "What a wrapper is"), and the CLI is a wrapper like the other
+ * two.
+ *
+ * Every handler does the same four steps, in order: read its own arguments,
+ * call one method on `client.team`, render, return. Errors are not caught here
+ * — `main()` reports a throw once, on stderr, and maps it to an exit code
+ * through `src/exit.ts`, so an `ApiError` exits 2 and a usage error exits 1
+ * without any command deciding that for itself.
+ *
+ * **No `--project` anywhere in this group.** Team membership is account-wide,
+ * not project-scoped — unlike `w6w documents`, which takes the flag on every
+ * command.
+ *
+ * @module
+ */
+import { argument, noExtraArguments, requiredFlag, table, textFlag } from "./shared.js";
+/** One team member, as a table row. */
+function memberRow(member) {
+    return [member.userId, member.email ?? "—", member.displayName ?? "—", member.role];
+}
+/** The roster: one line per member. There is always at least one — the owner. */
+function renderMembers(members, styles) {
+    return table(["USER ID", "EMAIL", "NAME", "ROLE"], members.map(memberRow), styles);
+}
+const members = async (context) => {
+    noExtraArguments(context, 0);
+    const roster = await context.client().team.members();
+    context.out.emit(roster, (styles) => renderMembers(roster, styles));
+};
+/**
+ * `w6w team invite [--email <email>] [--role <role>]` — both flags optional.
+ *
+ * Omitting `--email` mints an OPEN invite: a shareable link with no target
+ * address. Omitting `--role` leaves it to the server's own default
+ * (`"member"`). The one-time `token`/`redemptionLink` this prints are never
+ * fetchable again — a caller that loses this output has to revoke and
+ * re-invite.
+ */
+const invite = async (context) => {
+    noExtraArguments(context, 0);
+    const input = {};
+    const email = textFlag(context, "email");
+    if (email !== undefined)
+        input.email = email;
+    const role = textFlag(context, "role");
+    if (role !== undefined)
+        input.role = role;
+    const created = await context.client().team.invite(input);
+    context.out.emit(created, (styles) => {
+        const target = created.email ?? styles.dim("(open invite — no target email)");
+        const heading = `Invited ${styles.bold(target)} ${styles.dim(`(${created.id})`)}`;
+        return [heading, `Redemption link: ${created.redemptionLink}`].join("\n");
+    });
+};
+/** `w6w team invites` — the open (pending, unrevoked, unexpired) ones only. */
+const invites = async (context) => {
+    noExtraArguments(context, 0);
+    const pending = await context.client().team.invites();
+    context.out.emit(pending, (styles) => {
+        if (pending.length === 0)
+            return styles.dim("No open invites.");
+        return table(["ID", "EMAIL", "ROLE", "EXPIRES"], pending.map((inv) => [
+            inv.id,
+            inv.email ?? styles.dim("(open)"),
+            inv.role ?? "—",
+            inv.expiresAt ?? "—",
+        ]), styles);
+    });
+};
+/**
+ * `w6w team revoke-invite <id>` — and **nothing on stdout**.
+ *
+ * The server answers `{ok:true}`; the wrapper contract unwraps that to
+ * nothing at all, so the only machine-readable part of the answer is the exit
+ * code. `--json` suppresses the human confirmation, printing an empty stdout
+ * rather than a payload the contract says does not exist.
+ */
+const revokeInvite = async (context) => {
+    const id = argument(context, 0, "an invite id (see: `w6w team invites`)");
+    noExtraArguments(context, 1);
+    await context.client().team.revokeInvite(id);
+    context.out.note(`Revoked ${id}.`);
+};
+/**
+ * `w6w team set-role <userId> --role <role>` — the userId is positional, the
+ * new role is a required flag.
+ */
+const setRole = async (context) => {
+    const userId = argument(context, 0, "a member's user id (see: `w6w team members`)");
+    noExtraArguments(context, 1);
+    const role = requiredFlag(context, "role", "--role <role>");
+    const member = await context.client().team.setRole(userId, role);
+    context.out.emit(member, (styles) => `Set ${styles.bold(member.userId)} to ${styles.bold(member.role)}.`);
+};
+/** `w6w team remove-member <userId>` — and **nothing on stdout**, same shape as `revoke-invite`. */
+const removeMember = async (context) => {
+    const userId = argument(context, 0, "a member's user id (see: `w6w team members`)");
+    noExtraArguments(context, 1);
+    await context.client().team.removeMember(userId);
+    context.out.note(`Removed ${userId}.`);
+};
+/**
+ * The six `w6w team` commands, keyed by the canonical command path.
+ *
+ * The keys are the generated help tree's `path` values joined by a space,
+ * which are `endpoints.json`'s `naming.cli` spellings —
+ * `tests/cmd_team_test.ts` asserts the two sets are the same, so a command
+ * cannot be registered under a name the help does not document, or
+ * documented under a name nothing runs.
+ */
+export const TEAM_COMMANDS = {
+    "team members": members,
+    "team invite": invite,
+    "team invites": invites,
+    "team revoke-invite": revokeInvite,
+    "team set-role": setRole,
+    "team remove-member": removeMember,
+};
+//# sourceMappingURL=team.js.map

package/dist/src/commands/team.js.map

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

package/dist/src/commands/workflows.d.ts

@@ -1,11 +1,28 @@
 /**
- * `w6w workflows …` — list definitions and start runs (D4).
+ * `w6w workflows …` — list definitions, start runs (D4), cancel them, and
+ * edit the definitions themselves.
  *
- * Two commands. `list` exists so a caller can find a `wf_…` id to pass to
+ * Eight commands. `list` exists so a caller can find a `wf_…` id to pass to
  * `w6w run` or to this group's own `run`; `run` is the typed path with
  * `--wait` and `--input`, kept alongside the unified `w6w run` because
  * `?wait=`, `variables`, `trigger` and `input` have no slot in that
- * operation's three-field shape.
+ * operation's three-field shape. `cancel` is addressed by the RUN id `run`
+ * hands back, not by the workflow id every other command here takes.
+ * `get`, `create`, `update`, `archive` and `delete` are the definition
+ * lifecycle.
+ *
+ * **A definition arrives as `--definition <json>`, not `--file <path>`.** This
+ * lane reads no files: `--payload`, `--input` and `--content` are all
+ * command-line strings already, the CLI runs with no `--allow-read`, and
+ * `--definition "$(cat wf.json)"` is one shell idiom rather than a new
+ * permission and a new class of error (missing file, unreadable file, file that
+ * is not JSON) for every command that writes.
+ *
+ * **`create` and `update` are one route.** The server has a single upsert; what
+ * separates the two commands is that `create` mints the required id and
+ * `update` pins the one you addressed. Consequently `update` is a FULL
+ * REPLACEMENT — `w6w workflows get <id> --json` is where the definition to edit
+ * comes from.
  *
  * @module
  */

package/dist/src/commands/workflows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../src/commands/workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAkC,eAAe,EAAE,MAAM,cAAc,CAAC;AA8FpF,eAAO,MAAM,iBAAiB,EAAE,eAG/B,CAAC"}
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../src/commands/workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAkC,eAAe,EAAE,MAAM,cAAc,CAAC;AA2NpF,eAAO,MAAM,iBAAiB,EAAE,eAS/B,CAAC"}