@capuchoo/cli 0.7.0 → 0.9.0

package/README.md

@@ -29,7 +29,7 @@ $ npm install -g @capuchoo/cli
 $ capuchoo COMMAND
 running command...
 $ capuchoo (--version)
-@capuchoo/cli/0.6.0 win32-x64 node-v26.4.0
+@capuchoo/cli/0.9.0 win32-x64 node-v24.20.0
 $ capuchoo --help [COMMAND]
 USAGE
   $ capuchoo COMMAND
@@ -43,9 +43,15 @@ USAGE
 <!-- commands -->
 
 - [`capuchoo app delete [APPID]`](#capuchoo-app-delete-appid)
+- [`capuchoo app grant EMAIL ROLE`](#capuchoo-app-grant-email-role)
 - [`capuchoo app list`](#capuchoo-app-list)
+- [`capuchoo app revoke EMAIL`](#capuchoo-app-revoke-email)
+- [`capuchoo app roles`](#capuchoo-app-roles)
+- [`capuchoo auth issue`](#capuchoo-auth-issue)
+- [`capuchoo auth keys`](#capuchoo-auth-keys)
 - [`capuchoo auth login`](#capuchoo-auth-login)
 - [`capuchoo auth logout`](#capuchoo-auth-logout)
+- [`capuchoo auth revoke ID`](#capuchoo-auth-revoke-id)
 - [`capuchoo auth whoami`](#capuchoo-auth-whoami)
 - [`capuchoo channel create [NAME]`](#capuchoo-channel-create-name)
 - [`capuchoo channel delete [NAME]`](#capuchoo-channel-delete-name)
@@ -57,8 +63,11 @@ USAGE
 - [`capuchoo doctor`](#capuchoo-doctor)
 - [`capuchoo help [COMMAND]`](#capuchoo-help-command)
 - [`capuchoo init`](#capuchoo-init)
+- [`capuchoo menu`](#capuchoo-menu)
 - [`capuchoo org create [NAME]`](#capuchoo-org-create-name)
+- [`capuchoo org invite EMAIL ROLE`](#capuchoo-org-invite-email-role)
 - [`capuchoo org list`](#capuchoo-org-list)
+- [`capuchoo org members`](#capuchoo-org-members)
 - [`capuchoo setup`](#capuchoo-setup)
 - [`capuchoo version bump TYPE`](#capuchoo-version-bump-type)
 - [`capuchoo version sync`](#capuchoo-version-sync)
@@ -85,7 +94,31 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/app/delete.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/app/delete.ts)_
+[src/commands/app/delete.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/app/delete.ts)_
+
+## `capuchoo app grant EMAIL ROLE`
+
+Give someone a role on this app
+
+```
+USAGE
+  $ capuchoo app grant EMAIL ROLE
+
+ARGUMENTS
+  EMAIL  Account to grant
+  ROLE   (admin|developer|tester|viewer) One of admin, developer, tester, viewer
+
+DESCRIPTION
+  Give someone a role on this app
+
+EXAMPLES
+  $ capuchoo app grant dev@company.com developer
+
+  $ capuchoo app grant qa@company.com tester
+```
+
+_See code:
+[src/commands/app/grant.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/app/grant.ts)_
 
 ## `capuchoo app list`
 
@@ -103,11 +136,97 @@ DESCRIPTION
 ```
 
 _See code:
-[src/commands/app/list.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/app/list.ts)_
+[src/commands/app/list.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/app/list.ts)_
+
+## `capuchoo app revoke EMAIL`
+
+Remove someone's role on this app
+
+```
+USAGE
+  $ capuchoo app revoke EMAIL [-y]
+
+ARGUMENTS
+  EMAIL  Account to revoke
+
+FLAGS
+  -y, --yes  Skip the confirmation
+
+DESCRIPTION
+  Remove someone's role on this app
+
+EXAMPLES
+  $ capuchoo app revoke dev@company.com
+```
+
+_See code:
+[src/commands/app/revoke.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/app/revoke.ts)_
+
+## `capuchoo app roles`
+
+Show who can do what on this app
+
+```
+USAGE
+  $ capuchoo app roles
+
+DESCRIPTION
+  Show who can do what on this app
+
+EXAMPLES
+  $ capuchoo app roles
+```
+
+_See code:
+[src/commands/app/roles.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/app/roles.ts)_
+
+## `capuchoo auth issue`
+
+Create an API key, optionally limited to one app and one role
+
+```
+USAGE
+  $ capuchoo auth issue [--name <value>] [--role viewer|tester|developer|admin] [--this-app]
+
+FLAGS
+  --name=<value>   Label shown in capuchoo auth keys
+  --role=<option>  Ceiling on what the key may do: viewer, tester, developer, admin
+                   <options: viewer|tester|developer|admin>
+  --this-app       Restrict the key to the app this directory is linked to
+
+DESCRIPTION
+  Create an API key, optionally limited to one app and one role
+
+EXAMPLES
+  $ capuchoo auth issue --name ci --role developer --this-app
+
+  $ capuchoo auth issue --name readonly --role viewer
+```
+
+_See code:
+[src/commands/auth/issue.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/auth/issue.ts)_
+
+## `capuchoo auth keys`
+
+List the API keys on this account
+
+```
+USAGE
+  $ capuchoo auth keys
+
+DESCRIPTION
+  List the API keys on this account
+
+EXAMPLES
+  $ capuchoo auth keys
+```
+
+_See code:
+[src/commands/auth/keys.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/auth/keys.ts)_
 
 ## `capuchoo auth login`
 
-Store an API key for the Capuchoo backend
+Sign in to a Capuchoo backend
 
 ```
 USAGE
@@ -118,7 +237,7 @@ FLAGS
   -k, --api-key=<value>   API key from Settings > API Keys in the dashboard
 
 DESCRIPTION
-  Store an API key for the Capuchoo backend
+  Sign in to a Capuchoo backend
 
 EXAMPLES
   $ capuchoo auth login
@@ -127,7 +246,7 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/auth/login.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/auth/login.ts)_
+[src/commands/auth/login.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/auth/login.ts)_
 
 ## `capuchoo auth logout`
 
@@ -142,7 +261,31 @@ DESCRIPTION
 ```
 
 _See code:
-[src/commands/auth/logout.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/auth/logout.ts)_
+[src/commands/auth/logout.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/auth/logout.ts)_
+
+## `capuchoo auth revoke ID`
+
+Revoke an API key
+
+```
+USAGE
+  $ capuchoo auth revoke ID [-y]
+
+ARGUMENTS
+  ID  Key id, from capuchoo auth keys
+
+FLAGS
+  -y, --yes  Skip the confirmation
+
+DESCRIPTION
+  Revoke an API key
+
+EXAMPLES
+  $ capuchoo auth revoke <id>
+```
+
+_See code:
+[src/commands/auth/revoke.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/auth/revoke.ts)_
 
 ## `capuchoo auth whoami`
 
@@ -160,7 +303,7 @@ DESCRIPTION
 ```
 
 _See code:
-[src/commands/auth/whoami.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/auth/whoami.ts)_
+[src/commands/auth/whoami.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/auth/whoami.ts)_
 
 ## `capuchoo channel create [NAME]`
 
@@ -191,7 +334,7 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/channel/create.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/channel/create.ts)_
+[src/commands/channel/create.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/channel/create.ts)_
 
 ## `capuchoo channel delete [NAME]`
 
@@ -217,7 +360,7 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/channel/delete.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/channel/delete.ts)_
+[src/commands/channel/delete.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/channel/delete.ts)_
 
 ## `capuchoo channel list`
 
@@ -235,7 +378,7 @@ DESCRIPTION
 ```
 
 _See code:
-[src/commands/channel/list.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/channel/list.ts)_
+[src/commands/channel/list.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/channel/list.ts)_
 
 ## `capuchoo config list`
 
@@ -253,7 +396,7 @@ DESCRIPTION
 ```
 
 _See code:
-[src/commands/config/list.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/config/list.ts)_
+[src/commands/config/list.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/config/list.ts)_
 
 ## `capuchoo config set KEY VALUE`
 
@@ -277,7 +420,7 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/config/set.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/config/set.ts)_
+[src/commands/config/set.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/config/set.ts)_
 
 ## `capuchoo deploy native`
 
@@ -321,7 +464,7 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/deploy/native.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/deploy/native.ts)_
+[src/commands/deploy/native.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/deploy/native.ts)_
 
 ## `capuchoo deploy ota`
 
@@ -358,7 +501,7 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/deploy/ota.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/deploy/ota.ts)_
+[src/commands/deploy/ota.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/deploy/ota.ts)_
 
 ## `capuchoo doctor`
 
@@ -376,7 +519,7 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/doctor.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/doctor.ts)_
+[src/commands/doctor.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/doctor.ts)_
 
 ## `capuchoo help [COMMAND]`
 
@@ -430,7 +573,27 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/init.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/init.ts)_
+[src/commands/init.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/init.ts)_
+
+## `capuchoo menu`
+
+Browse and run commands interactively
+
+```
+USAGE
+  $ capuchoo menu
+
+DESCRIPTION
+  Browse and run commands interactively
+
+EXAMPLES
+  $ capuchoo
+
+  $ capuchoo menu
+```
+
+_See code:
+[src/commands/menu.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/menu.ts)_
 
 ## `capuchoo org create [NAME]`
 
@@ -456,7 +619,32 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/org/create.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/org/create.ts)_
+[src/commands/org/create.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/org/create.ts)_
+
+## `capuchoo org invite EMAIL ROLE`
+
+Add an existing account to an organization
+
+```
+USAGE
+  $ capuchoo org invite EMAIL ROLE [--org <value>]
+
+ARGUMENTS
+  EMAIL  Account to add
+  ROLE   (owner|admin|member) One of owner, admin, member
+
+FLAGS
+  --org=<value>  Organization by name or id
+
+DESCRIPTION
+  Add an existing account to an organization
+
+EXAMPLES
+  $ capuchoo org invite dev@company.com member
+```
+
+_See code:
+[src/commands/org/invite.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/org/invite.ts)_
 
 ## `capuchoo org list`
 
@@ -474,7 +662,28 @@ DESCRIPTION
 ```
 
 _See code:
-[src/commands/org/list.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/org/list.ts)_
+[src/commands/org/list.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/org/list.ts)_
+
+## `capuchoo org members`
+
+List the people in an organization
+
+```
+USAGE
+  $ capuchoo org members [--org <value>]
+
+FLAGS
+  --org=<value>  Organization by name or id
+
+DESCRIPTION
+  List the people in an organization
+
+EXAMPLES
+  $ capuchoo org members
+```
+
+_See code:
+[src/commands/org/members.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/org/members.ts)_
 
 ## `capuchoo setup`
 
@@ -503,7 +712,7 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/setup.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/setup.ts)_
+[src/commands/setup.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/setup.ts)_
 
 ## `capuchoo version bump TYPE`
 
@@ -530,7 +739,7 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/version/bump.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/version/bump.ts)_
+[src/commands/version/bump.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/version/bump.ts)_
 
 ## `capuchoo version sync`
 
@@ -556,5 +765,5 @@ EXAMPLES
 ```
 
 _See code:
-[src/commands/version/sync.ts](https://github.com/aybinv7/capuchoo/blob/v0.6.0/src/commands/version/sync.ts)_
+[src/commands/version/sync.ts](https://github.com/aybinv7/capuchoo/blob/v0.9.0/src/commands/version/sync.ts)_
 <!-- commandsstop -->

package/bin/run.js

@@ -2,4 +2,26 @@
 
 import { execute } from "@oclif/core";
 
+/**
+ * A bare `capuchoo` in a terminal opens the menu.
+ *
+ * oclif's default is to print help and exit, which is a dead end: you read a
+ * list of topics, type one, read another list, type a subcommand, and get
+ * `command channeml not found` for a typo. `menu` is a loop instead.
+ *
+ * Done here rather than with a `commands/index.ts`, which is how oclif is
+ * usually told about a root command - that file makes it treat the whole CLI as
+ * a *single-command* program, and every other command stops resolving with
+ * `MODULE_NOT_FOUND ... Symbol(SINGLE_COMMAND_CLI)`. Injecting the argument
+ * leaves oclif's multi-command resolution alone.
+ *
+ * Only with a real terminal on both ends. A script or CI job that runs
+ * `capuchoo` with no arguments still gets help and exits, rather than blocking
+ * forever on a prompt nothing can answer.
+ */
+const bare = process.argv.length === 2;
+const interactive = process.stdin.isTTY && process.stdout.isTTY;
+
+if (bare && interactive) process.argv.push("menu");
+
 await execute({ dir: import.meta.url });

package/dist/cli/members.d.ts

@@ -0,0 +1,23 @@
+import type { Membership } from "../services/cloud.js";
+/** The email on a membership row, or the raw user id when the join came back empty. */
+export declare function emailOf(member: Membership): string;
+export interface Resolution {
+    ok: boolean;
+    userId?: string;
+    /** What to tell the caller when it failed. */
+    problem?: string;
+}
+/**
+ * Finds a member by email, case-insensitively.
+ *
+ * Resolved from a list the caller already has rather than by asking the server
+ * to look an address up: there is no such endpoint, and adding one would be an
+ * email enumeration surface.
+ */
+export declare function resolveByEmail(members: Membership[], email: string): Resolution;
+/** Rows for a table, widest-email-first so the roles line up. */
+export declare function membershipRows(members: Membership[]): Array<{
+    email: string;
+    role: string;
+}>;
+//# sourceMappingURL=members.d.ts.map

package/dist/cli/members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../src/cli/members.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAElD;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAwB/E;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5F"}

package/dist/cli/members.js

@@ -0,0 +1,38 @@
+/** The email on a membership row, or the raw user id when the join came back empty. */
+export function emailOf(member) {
+    return member.users?.email ?? member.user_id;
+}
+/**
+ * Finds a member by email, case-insensitively.
+ *
+ * Resolved from a list the caller already has rather than by asking the server
+ * to look an address up: there is no such endpoint, and adding one would be an
+ * email enumeration surface.
+ */
+export function resolveByEmail(members, email) {
+    const wanted = email.trim().toLowerCase();
+    if (!wanted)
+        return { ok: false, problem: "An email is required." };
+    const matches = members.filter((member) => emailOf(member).toLowerCase() === wanted);
+    if (matches.length === 0) {
+        const known = members.map(emailOf).sort();
+        return {
+            ok: false,
+            problem: `No member with the email "${email}". ` +
+                (known.length > 0 ? `Present: ${known.join(", ")}.` : "There are none yet."),
+        };
+    }
+    // A duplicate would make the choice arbitrary, and removing the wrong person
+    // is not recoverable from here.
+    if (matches.length > 1) {
+        return { ok: false, problem: `"${email}" matches ${matches.length} members. Resolve by hand.` };
+    }
+    return { ok: true, userId: matches[0].user_id };
+}
+/** Rows for a table, widest-email-first so the roles line up. */
+export function membershipRows(members) {
+    return members
+        .map((member) => ({ email: emailOf(member), role: member.role }))
+        .sort((a, b) => a.email.localeCompare(b.email));
+}
+//# sourceMappingURL=members.js.map

package/dist/cli/members.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.js","sourceRoot":"","sources":["../../src/cli/members.ts"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,MAAM,UAAU,OAAO,CAAC,MAAkB;IACxC,OAAO,MAAM,CAAC,KAAK,EAAE,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC;AAC/C,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAqB,EAAE,KAAa;IACjE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE1C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;IAEpE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;IAErF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EACL,6BAA6B,KAAK,KAAK;gBACvC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC;SAC/E,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,gCAAgC;IAChC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,KAAK,aAAa,OAAO,CAAC,MAAM,4BAA4B,EAAE,CAAC;IAClG,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,OAAO,EAAE,CAAC;AACnD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;SAChE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/cli/menu.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The shape of the interactive menu, built from oclif's command registry so it
+ * cannot drift. Pure, so the entries and their order are testable.
+ */
+export interface MenuCommand {
+    /** oclif command id, e.g. `deploy:ota`. */
+    id: string;
+    /** What to show: the last segment, e.g. `ota`. */
+    label: string;
+    description: string;
+}
+export interface MenuTopic {
+    name: string;
+    description: string;
+    commands: MenuCommand[];
+}
+export interface Menu {
+    /** Commands that live under a topic. */
+    topics: MenuTopic[];
+    /** Commands with no topic, e.g. `doctor`. */
+    commands: MenuCommand[];
+}
+export interface CommandLike {
+    id: string;
+    description?: string | undefined;
+    hidden?: boolean | undefined;
+}
+export interface TopicLike {
+    name: string;
+    description?: string | undefined;
+}
+export declare function buildMenu(input: {
+    commands: CommandLike[];
+    topics: TopicLike[];
+}): Menu;
+/** How many runnable commands the menu offers, for the header line. */
+export declare function menuSize(menu: Menu): number;
+//# sourceMappingURL=menu.d.ts.map

package/dist/cli/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../src/cli/menu.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,IAAI;IACnB,wCAAwC;IACxC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAwBD,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,IAAI,CAwCvF;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE3C"}

package/dist/cli/menu.js

@@ -0,0 +1,62 @@
+/**
+ * The shape of the interactive menu, built from oclif's command registry so it
+ * cannot drift. Pure, so the entries and their order are testable.
+ */
+/** Never offered: `help` duplicates the menu, and the others are the menu. */
+const HIDDEN_IDS = new Set(["", "help", "menu"]);
+/** First-session order; everything else follows alphabetically. */
+const PRIORITY = ["setup", "init", "doctor", "deploy", "channel", "version", "config"];
+function byPriorityThenName(a, b) {
+    const rankA = PRIORITY.indexOf(a);
+    const rankB = PRIORITY.indexOf(b);
+    if (rankA !== -1 && rankB !== -1)
+        return rankA - rankB;
+    if (rankA !== -1)
+        return -1;
+    if (rankB !== -1)
+        return 1;
+    return a.localeCompare(b);
+}
+/** The segment shown in a menu: `deploy:ota` reads as `ota` under `deploy`. */
+function lastSegment(id) {
+    const parts = id.split(":");
+    return parts[parts.length - 1] ?? id;
+}
+export function buildMenu(input) {
+    const visible = input.commands.filter((command) => !command.hidden && !HIDDEN_IDS.has(command.id));
+    const describedTopics = new Map(input.topics.map((topic) => [topic.name, topic.description]));
+    const grouped = new Map();
+    const loose = [];
+    for (const command of visible) {
+        const entry = {
+            id: command.id,
+            label: lastSegment(command.id),
+            description: command.description ?? "",
+        };
+        const topic = command.id.includes(":") ? command.id.split(":")[0] : null;
+        if (topic) {
+            grouped.set(topic, [...(grouped.get(topic) ?? []), entry]);
+        }
+        else {
+            loose.push(entry);
+        }
+    }
+    const topics = [...grouped.entries()]
+        .map(([name, commands]) => ({
+        name,
+        // A topic with no description in package.json still has to read as
+        // something, so it falls back to its own name rather than an empty line.
+        description: describedTopics.get(name) ?? name,
+        commands: commands.sort((a, b) => byPriorityThenName(a.label, b.label)),
+    }))
+        .sort((a, b) => byPriorityThenName(a.name, b.name));
+    return {
+        topics,
+        commands: loose.sort((a, b) => byPriorityThenName(a.label, b.label)),
+    };
+}
+/** How many runnable commands the menu offers, for the header line. */
+export function menuSize(menu) {
+    return menu.commands.length + menu.topics.reduce((total, t) => total + t.commands.length, 0);
+}
+//# sourceMappingURL=menu.js.map

package/dist/cli/menu.js.map

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

package/dist/cli/onboarding.d.ts

@@ -0,0 +1,41 @@
+/** What the CLI can see about this machine and this directory. */
+export interface OnboardingFacts {
+    signedIn: boolean;
+    /** Whether this looks like an application at all - a package.json. */
+    inAppDirectory: boolean;
+    /** Whether .capuchoo/project.json exists. */
+    linked: boolean;
+    updaterInstalled: boolean;
+    /** null when not fetched, or when the backend could not be reached. */
+    channels?: Array<{
+        name: string;
+        servingBundle: boolean;
+    }> | null | undefined;
+}
+export interface NextStep {
+    /** oclif command id. */
+    command: string;
+    label: string;
+    why: string;
+}
+export type Stage = "signed-out" | "not-an-app" | "unlinked" | "incomplete" | "no-channels" | "nothing-served" | "ready";
+export interface OnboardingState {
+    stage: Stage;
+    /** The one thing to do now, or null when there is nothing to recommend. */
+    next: NextStep | null;
+}
+/**
+ * The single next action, so the first thing someone sees is a step rather than
+ * a list to guess from.
+ *
+ * Order is by dependency: nothing can be done unsigned, nothing app-specific
+ * without an app, nothing published without a channel.
+ */
+export declare function resolveOnboarding(facts: OnboardingFacts): OnboardingState;
+/** Commands worth hiding in this state, by oclif id. */
+export declare function hiddenCommands(facts: OnboardingFacts): Set<string>;
+/** A label that reads correctly for the current state, or null to keep the default. */
+export declare function labelFor(command: string, facts: OnboardingFacts): string | null;
+/** Whether only the next step should be offered, rather than the whole menu. */
+export declare function isBlocked(state: OnboardingState): boolean;
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/cli/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/cli/onboarding.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,cAAc,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC/E;AAED,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,KAAK,GACb,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,aAAa,GACb,gBAAgB,GAChB,OAAO,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,2EAA2E;IAC3E,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAsEzE;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,CAQlE;AAED,uFAAuF;AACvF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAI/E;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEzD"}