@faable/faable 3.4.1 → 4.0.0

package/dist/commands/auth/index.js

@@ -1,12 +1,13 @@
+import { accounts, auth_use } from './accounts/index.js';
 import { actions } from './actions/index.js';
 import { clients } from './clients/index.js';
 import { logs } from './logs/index.js';
 import { users } from './users/index.js';
 
 // `faable auth` — management commands for a Faable Auth tenant. Auth: reuses
-// the `faable login` session (or FAABLE_TOKEN); tenant: --auth-url /
-// FAABLE_AUTH_URL (defaults to the Faable tenant host). See
-// src/api/auth_admin.ts.
+// the `faable login` session (or FAABLE_TOKEN); tenant: --account /
+// --auth-url, else the active project's (`faable auth accounts list`). See
+// resolveTenant in src/api/auth_admin.ts.
 const auth = {
     command: 'auth',
     describe: 'Manage Faable Auth (users, actions, clients, audit logs)',
@@ -15,6 +16,8 @@ const auth = {
         .command(actions)
         .command(clients)
         .command(logs)
+        .command(accounts)
+        .command(auth_use)
         .demandCommand(1)
         .showHelpOnFail(false),
     handler: () => { }

package/dist/commands/auth/logs/get.js

@@ -1,7 +1,8 @@
 import { withAuthHints, requireAuthAdmin } from '../../../api/auth_admin.js';
 import { log } from '../../../log.js';
-import { json_option, tenant_options } from '../options.js';
-import { print_json, log_status_badge } from '../render.js';
+import { tenant_options } from '../options.js';
+import { log_status_badge } from '../render.js';
+import { json_option, print_json } from '../../../lib/listing.js';
 
 const logs_get = {
     command: 'get <log_id>',

package/dist/commands/auth/logs/list.js

@@ -1,14 +1,14 @@
 import { withAuthHints, requireAuthAdmin } from '../../../api/auth_admin.js';
 import { log } from '../../../log.js';
-import { json_option, list_options, tenant_options } from '../options.js';
-import { fetch_items } from '../paging.js';
+import { list_options, fetch_page, from_paginator, print_json, table_lines, print, more_hint } from '../../../lib/listing.js';
+import { tenant_options } from '../options.js';
 import { compose_query, term, time_term } from '../query.js';
-import { print_json, log_status_badge, truncate, table_lines } from '../render.js';
+import { log_status_badge, truncate } from '../render.js';
 
 const logs_list = {
     command: 'list',
     describe: 'List and filter audit logs',
-    builder: yargs => json_option(list_options(tenant_options(yargs)))
+    builder: yargs => list_options(tenant_options(yargs))
         .option('query', {
         type: 'string',
         description: 'Raw FaableQL filter (combined with the flags below)'
@@ -60,15 +60,15 @@ const logs_list = {
             time_term('until', args.until)
         ], args.query);
         const api = await requireAuthAdmin(args);
-        const { items, more } = await fetch_items(api.logList({ query, q: args.q, pageSize: args.limit }), args.all);
+        const page = await fetch_page(from_paginator(api.logList({ query, q: args.q })), args);
         if (args.json)
-            return print_json(items);
-        if (items.length === 0) {
+            return print_json(page);
+        if (page.data.length === 0) {
             log.info('📭 No audit log entries match.');
             return;
         }
-        log.info(`📜 ${items.length} entr${items.length === 1 ? 'y' : 'ies'}:`);
-        const rows = items.map(entry => [
+        log.info(`📜 ${page.data.length} entr${page.data.length === 1 ? 'y' : 'ies'}:`);
+        const rows = page.data.map(entry => [
             entry.createdAt ?? '-',
             entry.type ?? '-',
             log_status_badge(entry.status),
@@ -79,11 +79,11 @@ const logs_list = {
             entry.id ?? '-'
         ]);
         for (const line of table_lines(['DATE', 'TYPE', 'STATUS', 'USER', 'MESSAGE', 'ID'], rows)) {
-            log.info(`  ${line}`);
-        }
-        if (more) {
-            log.info('… more results available: raise --limit, use --all, or narrow with --since/--type.');
+            print(line);
         }
+        const hint = more_hint(page);
+        if (hint)
+            log.info(hint);
     })
 };
 

package/dist/commands/auth/options.js

@@ -1,34 +1,11 @@
 const tenant_options = (yargs) => yargs
-    .option('auth-url', {
-    type: 'string',
-    description: 'Auth tenant base URL, e.g. https://<account>.auth.faable.link (env FAABLE_AUTH_URL)'
-})
     .option('account', {
     type: 'string',
-    description: 'Resolve a different account id on the target host (env FAABLE_AUTH_ACCOUNT)'
-});
-const json_option = (yargs) => yargs.option('json', {
-    type: 'boolean',
-    default: false,
-    description: 'Output raw JSON (for scripting)'
-});
-const list_options = (yargs) => yargs
-    .option('limit', {
-    type: 'number',
-    default: 100,
-    description: 'Max items to fetch in one page (1-200)'
-})
-    .option('all', {
-    type: 'boolean',
-    default: false,
-    description: 'Fetch every page (ignores --limit)'
+    description: "Auth tenant id (env FAABLE_AUTH_ACCOUNT). Default: the active project's tenant"
 })
-    .check(argv => {
-    const limit = argv.limit;
-    if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 200)) {
-        throw new Error('--limit must be an integer between 1 and 200');
-    }
-    return true;
+    .option('auth-url', {
+    type: 'string',
+    description: 'Auth tenant base URL, e.g. https://<slug>.auth.faable.link (env FAABLE_AUTH_URL)'
 });
 
-export { json_option, list_options, tenant_options };
+export { tenant_options };

package/dist/commands/auth/render.js

@@ -1,17 +1,5 @@
 // Pure rendering helpers for the `faable auth` read commands.
-const print_json = (data) => {
-    process.stdout.write(JSON.stringify(data, null, 2) + '\n');
-};
-// Left-padded fixed-width table lines. Cells are stringified as-is; column
-// width = max(header, cells).
-const table_lines = (headers, rows) => {
-    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map(r => (r[i] ?? '').length)));
-    const render = (cells) => cells
-        .map((c, i) => (i === cells.length - 1 ? c : (c ?? '').padEnd(widths[i])))
-        .join('  ')
-        .trimEnd();
-    return [render(headers), ...rows.map(render)];
-};
+// JSON output and tables are the listing contract's (src/lib/listing.ts).
 const yes_no = (v) => (v ? '✓' : '-');
 const truncate = (s, max) => {
     if (!s)
@@ -45,4 +33,4 @@ const log_status_badge = (status) => {
     return `${STATUS_ICONS[s] ?? '⚪'} ${s}`;
 };
 
-export { log_status_badge, print_json, table_lines, truncate, when, yes_no };
+export { log_status_badge, truncate, when, yes_no };

package/dist/commands/auth/users/get.js

@@ -1,8 +1,8 @@
 import { withAuthHints, requireAuthAdmin } from '../../../api/auth_admin.js';
 import { log } from '../../../log.js';
-import { json_option, tenant_options } from '../options.js';
-import { fetch_items } from '../paging.js';
-import { print_json, yes_no, when } from '../render.js';
+import { tenant_options } from '../options.js';
+import { json_option, fetch_page, from_paginator, print_json } from '../../../lib/listing.js';
+import { yes_no, when } from '../render.js';
 
 // Identity rows carry the RAW provider access/refresh tokens — strip them
 // before anything (json output included) can print one.
@@ -28,8 +28,8 @@ const users_get = {
         // rarely matches the GitHub handle that owns the deployed repos).
         // Best-effort: a tenant where the session can't read /identity still
         // renders the user card.
-        const identities = await fetch_items(api.identityList({ query: `user:${args.user_id}` }), true)
-            .then(r => r.items.map(i => sanitize_identity(i)))
+        const identities = await fetch_page(from_paginator(api.identityList({ query: `user:${args.user_id}` })), { limit: 200, all: true })
+            .then(r => r.data.map(i => sanitize_identity(i)))
             .catch(() => []);
         // Resolve connection ids to names ("github") once per distinct id.
         const connection_names = new Map();

package/dist/commands/auth/users/import.js

@@ -2,8 +2,8 @@ import { readFile } from 'node:fs/promises';
 import prompts from 'prompts';
 import { withAuthHints, requireAuthAdmin } from '../../../api/auth_admin.js';
 import { log } from '../../../log.js';
-import { json_option, tenant_options } from '../options.js';
-import { print_json } from '../render.js';
+import { tenant_options } from '../options.js';
+import { json_option, print_json } from '../../../lib/listing.js';
 import { SOURCES, ADAPTERS, SOURCE_FORMAT } from './import/adapters.js';
 import { parse_records } from './import/records.js';
 
@@ -149,6 +149,8 @@ const users_import = {
                     email: r.email,
                     status: r.status,
                     user_id: r.user_id,
+                    skipped_identities: r
+                        .skipped_identities,
                     error: r.error
                 });
             }
@@ -169,6 +171,11 @@ const users_import = {
             print_json({ dry_run, summary, results });
         }
         else {
+            const without = results.filter(r => r.skipped_identities?.length);
+            if (without.length) {
+                const names = [...new Set(without.flatMap(r => r.skipped_identities))];
+                log.warn(`⚠️  ${without.length} user(s) imported without their ${names.join(', ')} identity: this tenant has no connection by that name. Create it and re-run with --update-existing, or map it with --map-connection.`);
+            }
             for (const r of results.filter(r => r.status === 'error')) {
                 log.error(`❌ record ${r.record}${r.email ? ` (${r.email})` : ''}: ${r.error?.code} — ${r.error?.message}`);
             }

package/dist/commands/auth/users/list.js

@@ -1,14 +1,14 @@
 import { withAuthHints, requireAuthAdmin } from '../../../api/auth_admin.js';
 import { log } from '../../../log.js';
-import { json_option, list_options, tenant_options } from '../options.js';
+import { list_options, fetch_page, from_paginator, print_json, table_lines, print, more_hint } from '../../../lib/listing.js';
+import { tenant_options } from '../options.js';
 import { compose_query } from '../query.js';
-import { fetch_items } from '../paging.js';
-import { print_json, truncate, yes_no, when, table_lines } from '../render.js';
+import { truncate, yes_no, when } from '../render.js';
 
 const users_list = {
     command: 'list',
     describe: 'List and filter users',
-    builder: yargs => json_option(list_options(tenant_options(yargs)))
+    builder: yargs => list_options(tenant_options(yargs))
         .option('query', {
         type: 'string',
         description: 'FaableQL filter, e.g. "suspended:true email_verified:false" (fields: email, name, phone, suspended, email_verified, country_iso, locale, last_ip)'
@@ -27,15 +27,15 @@ const users_list = {
     handler: withAuthHints(async (args) => {
         const api = await requireAuthAdmin(args);
         const query = compose_query([args.suspended !== undefined && `suspended:${args.suspended}`], args.query);
-        const { items, more } = await fetch_items(api.userList({ query, q: args.q, pageSize: args.limit }), args.all);
+        const page = await fetch_page(from_paginator(api.userList({ query, q: args.q })), args);
         if (args.json)
-            return print_json(items);
-        if (items.length === 0) {
+            return print_json(page);
+        if (page.data.length === 0) {
             log.info('📭 No users match.');
             return;
         }
-        log.info(`👥 ${items.length} user(s):`);
-        const rows = items.map(u => [
+        log.info(`👥 ${page.data.length} user(s):`);
+        const rows = page.data.map(u => [
             u.id ?? '-',
             truncate(u.email, 32),
             truncate(u.name, 24),
@@ -44,11 +44,11 @@ const users_list = {
             when(u.last_login)
         ]);
         for (const line of table_lines(['ID', 'EMAIL', 'NAME', 'VERIFIED', 'SUSPENDED', 'LAST LOGIN'], rows)) {
-            log.info(`  ${line}`);
-        }
-        if (more) {
-            log.info('… more results available: raise --limit, use --all, or refine the filter.');
+            print(line);
         }
+        const hint = more_hint(page);
+        if (hint)
+            log.info(hint);
     })
 };
 

package/dist/commands/auth/users/reinstate.js

@@ -1,8 +1,8 @@
 import prompts from 'prompts';
 import { withAuthHints, requireAuthAdmin } from '../../../api/auth_admin.js';
 import { log } from '../../../log.js';
-import { json_option, tenant_options } from '../options.js';
-import { print_json } from '../render.js';
+import { tenant_options } from '../options.js';
+import { json_option, print_json } from '../../../lib/listing.js';
 import { wants_stdin, read_stdin, parse_user_ids } from './ids.js';
 
 const users_reinstate = {

package/dist/commands/auth/users/suspend.js

@@ -1,8 +1,8 @@
 import prompts from 'prompts';
 import { withAuthHints, requireAuthAdmin } from '../../../api/auth_admin.js';
 import { log } from '../../../log.js';
-import { json_option, tenant_options } from '../options.js';
-import { print_json } from '../render.js';
+import { tenant_options } from '../options.js';
+import { json_option, print_json } from '../../../lib/listing.js';
 import { wants_stdin, read_stdin, parse_user_ids } from './ids.js';
 
 const users_suspend = {

package/dist/commands/deploy/domains/list.js

@@ -1,4 +1,5 @@
 import { requireApi } from '../../../api/context.js';
+import { fetch_page, print_json, print, more_hint, list_options } from '../../../lib/listing.js';
 import { log } from '../../../log.js';
 import { resolve_app_id } from '../resolve_app_id.js';
 import { dns_badge, cname_target } from './format.js';
@@ -6,7 +7,7 @@ import { dns_badge, cname_target } from './format.js';
 const domains_list = {
     command: 'list',
     describe: 'List custom domains of the app',
-    builder: yargs => yargs
+    builder: yargs => list_options(yargs)
         .option('app', {
         alias: 'a',
         type: 'string',
@@ -18,7 +19,10 @@ const domains_list = {
         const ctx = await requireApi();
         const app_id = await resolve_app_id(args.app, ctx.appId, ctx.api);
         const app = await ctx.api.getApp(app_id);
-        const domains = await ctx.api.listDomains(app_id, app.team);
+        const page = await fetch_page(p => ctx.api.listDomainsPage(app_id, app.team, p), args);
+        if (args.json)
+            return print_json(page);
+        const domains = page.data;
         if (domains.length === 0) {
             log.info(`🌐 No custom domains for ${app.name} (${app_id}).`);
             log.info(`Add one with: faable deploy domains add <yourdomain.com>. The app is always live at https://${app.url}.`);
@@ -28,8 +32,11 @@ const domains_list = {
         const width = Math.max(...domains.map(d => d.fqdn.length));
         for (const domain of domains) {
             const tls = domain.tls ? 'tls' : 'no-tls';
-            log.info(`  ${domain.fqdn.padEnd(width)}  ${dns_badge(domain)}  (${tls})`);
+            print(`  ${domain.fqdn.padEnd(width)}  ${dns_badge(domain)}  (${tls})`);
         }
+        const hint = more_hint(page);
+        if (hint)
+            log.info(hint);
         const unverified = domains.filter(d => !d.verified);
         if (unverified.length > 0) {
             log.info(``);

package/dist/commands/deploy/inspect/deployments.js

@@ -1,4 +1,5 @@
 import { requireApi } from '../../../api/context.js';
+import { fetch_page, print_json, print, more_hint, list_options } from '../../../lib/listing.js';
 import { log } from '../../../log.js';
 import { resolve_app_id } from '../resolve_app_id.js';
 import { deployment_row } from './format.js';
@@ -6,34 +7,32 @@ import { deployment_row } from './format.js';
 const deployments = {
     command: 'deployments',
     describe: 'List recent deployments of the app',
-    builder: yargs => yargs
+    builder: yargs => list_options(yargs, { default_limit: 10 })
         .option('app', {
         alias: 'a',
         type: 'string',
         description: 'App Identifier (defaults to the linked app)'
-    })
-        .option('limit', {
-        alias: 'n',
-        type: 'number',
-        default: 10,
-        description: 'How many to show'
     })
         .showHelpOnFail(false),
     handler: async (args) => {
         const ctx = await requireApi();
         const app_id = await resolve_app_id(args.app, ctx.appId, ctx.api);
         const app = await ctx.api.getApp(app_id);
-        const rows = await ctx.api.listDeployments(app_id, app.team);
-        if (rows.length === 0) {
+        const page = await fetch_page(p => ctx.api.listDeploymentsPage(app_id, app.team, p), args);
+        if (args.json)
+            return print_json(page);
+        if (page.data.length === 0) {
             log.info(`📭 ${app.name} has no deployments yet.`);
             return;
         }
-        const shown = rows.slice(0, args.limit ?? 10);
-        log.info(`🚀 Last ${shown.length} deployment(s) of ${app.name}:`);
-        for (const d of shown) {
+        log.info(`🚀 Last ${page.data.length} deployment(s) of ${app.name}:`);
+        for (const d of page.data) {
             const live = d.id === app.status?.deployment ? '  ← live' : '';
-            log.info(`  ${deployment_row(d)}${live}`);
+            print(`  ${deployment_row(d)}${live}`);
         }
+        const hint = more_hint(page);
+        if (hint)
+            log.info(hint);
         log.info(`Full record of one: faable deploy inspect <deployment_id>`);
     }
 };

package/dist/commands/deploy/inspect/list.js

@@ -1,23 +1,32 @@
 import { requireApi } from '../../../api/context.js';
+import { fetch_page, print_json, print, more_hint, list_options } from '../../../lib/listing.js';
 import { log } from '../../../log.js';
 import { phase_badge } from './format.js';
 
 const apps_list = {
     command: 'list',
-    describe: 'List your apps',
-    builder: yargs => yargs.showHelpOnFail(false),
-    handler: async () => {
+    describe: 'List the apps of the active project',
+    builder: yargs => list_options(yargs).showHelpOnFail(false),
+    handler: async (args) => {
         const ctx = await requireApi();
-        const apps = await ctx.api.list();
-        if (apps.length === 0) {
+        // Scoped to the active project when there is one (--project,
+        // FAABLE_PROJECT, `faable project use`); every app you can see otherwise.
+        const page = await fetch_page(p => ctx.api.listApps(p), args);
+        if (args.json)
+            return print_json(page);
+        if (page.data.length === 0) {
             log.info(`📭 No apps yet. Create one in the dashboard (https://dashboard.faable.com) and link your repo.`);
             return;
         }
-        log.info(`📦 ${apps.length} app(s):`);
-        const width = Math.max(...apps.map(a => a.name.length));
-        for (const app of apps) {
-            log.info(`  ${app.name.padEnd(width)}  ${phase_badge(app.status?.phase)}  ${app.id}  https://${app.url}`);
+        const scope = ctx.api.project ? ` in ${ctx.api.project}` : '';
+        log.info(`📦 ${page.data.length} app(s)${scope}:`);
+        const width = Math.max(...page.data.map(a => a.name.length));
+        for (const app of page.data) {
+            print(`  ${app.name.padEnd(width)}  ${phase_badge(app.status?.phase)}  ${app.id}  https://${app.url}`);
         }
+        const hint = more_hint(page);
+        if (hint)
+            log.info(hint);
     }
 };
 

package/dist/commands/deploy/secrets/list.js

@@ -1,4 +1,5 @@
 import { requireApi } from '../../../api/context.js';
+import { print_json, as_list, print, json_option } from '../../../lib/listing.js';
 import { log } from '../../../log.js';
 import { resolve_app_id } from '../resolve_app_id.js';
 import { managed_name, managed_warning } from './managed_names.js';
@@ -7,7 +8,7 @@ import { mask_value } from './mask.js';
 const secrets_list = {
     command: 'list',
     describe: 'List app secrets (values masked by default)',
-    builder: yargs => yargs
+    builder: yargs => json_option(yargs)
         .option('app', {
         alias: 'a',
         type: 'string',
@@ -25,6 +26,14 @@ const secrets_list = {
         const ctx = await requireApi();
         const app_id = await resolve_app_id(args.app, ctx.appId, ctx.api);
         const secrets = await ctx.api.getAppSecrets(app_id);
+        // The whole set in one response (the api doesn't page secrets). Values
+        // stay masked unless --show, in JSON as on screen.
+        if (args.json) {
+            return print_json(as_list(secrets.map(s => ({
+                ...s,
+                value: args.show ? s.value : mask_value(s.value)
+            }))));
+        }
         if (secrets.length === 0) {
             log.info(`🔐 No secrets set for ${app_id}.`);
             return;
@@ -45,7 +54,7 @@ const secrets_list = {
                 : managed.kind === 'reserved'
                     ? '  ⚠️ reserved, ignored at deploy'
                     : '  ⚠️ overrides a platform default';
-            log.info(`  ${secret.name.padEnd(width)}  ${value}${origin}${note}`);
+            print(`  ${secret.name.padEnd(width)}  ${value}${origin}${note}`);
         }
         if (!args.show) {
             log.info(`Use --show to reveal full values.`);

package/dist/commands/deploy/waf/list.js

@@ -1,4 +1,5 @@
 import { requireApi } from '../../../api/context.js';
+import { print_json, print, json_option } from '../../../lib/listing.js';
 import { log } from '../../../log.js';
 import { resolve_app_id } from '../resolve_app_id.js';
 import { format_waf } from './format.js';
@@ -6,7 +7,7 @@ import { format_waf } from './format.js';
 const waf_list = {
     command: 'list',
     describe: 'Show the WAF rules in effect for the app',
-    builder: yargs => yargs
+    builder: yargs => json_option(yargs)
         .option('app', {
         alias: 'a',
         type: 'string',
@@ -19,10 +20,13 @@ const waf_list = {
         const app_id = await resolve_app_id(args.app, ctx.appId, ctx.api);
         const app = await ctx.api.getApp(app_id);
         const waf = await ctx.api.getAppWaf(app_id);
+        // Not a list: the app's WAF is one document (toggle, profiles, rules).
+        if (args.json)
+            return print_json(waf);
         log.info(`🛡️  WAF for ${app.name} (${app_id})`);
         log.info(``);
         for (const line of format_waf(waf))
-            log.info(line);
+            print(line);
     }
 };
 

package/dist/commands/project/index.js

@@ -0,0 +1,95 @@
+import { subject, requireSessionToken } from '../../api/auth_admin.js';
+import { requireApi } from '../../api/context.js';
+import { resolveProjectRef, configuredProject, requireProject, SOURCE_LABEL } from '../../api/project.js';
+import { ContextStore } from '../../lib/ContextStore.js';
+import { fetch_page, print_json, table_lines, print, more_hint, list_options, json_option } from '../../lib/listing.js';
+import { log } from '../../log.js';
+
+const project_list = {
+    command: 'list',
+    describe: 'List your projects',
+    builder: yargs => list_options(yargs)
+        .option('q', {
+        type: 'string',
+        description: 'Search by name, slug or description'
+    })
+        .option('mine', {
+        type: 'boolean',
+        default: false,
+        description: 'Only the projects you own (a staff session otherwise lists every project)'
+    })
+        .showHelpOnFail(false),
+    handler: async (args) => {
+        const { api } = await requireApi();
+        const user_id = args.mine ? subject(await requireSessionToken()) : undefined;
+        if (args.mine && !user_id) {
+            throw new Error('--mine needs a `faable login` session (or FAABLE_TOKEN).');
+        }
+        const page = await fetch_page(p => api.listProjects({ ...p, q: args.q, user_id }), args);
+        if (args.json)
+            return print_json(page);
+        if (page.data.length === 0) {
+            log.info('📭 No projects.');
+            return;
+        }
+        const active = api.project;
+        log.info(`📁 ${page.data.length} project(s):`);
+        for (const line of table_lines(['', 'ID', 'NAME', 'SLUG'], page.data.map(p => [p.id === active ? '*' : '', p.id, p.name, p.slug ?? '-']))) {
+            print(line);
+        }
+        const hint = more_hint(page);
+        if (hint)
+            log.info(hint);
+    }
+};
+const project_use = {
+    command: 'use <project>',
+    describe: 'Set the active project (id, name or slug)',
+    builder: yargs => yargs
+        .positional('project', { type: 'string', demandOption: true })
+        .example('$0 project use project_6a8ebd6160324d4631c12edc', 'By id')
+        .example('$0 project use "Faable Staff"', 'By name')
+        .showHelpOnFail(false),
+    handler: async (args) => {
+        const { api } = await requireApi();
+        const id = await resolveProjectRef(api, args.project);
+        // Fetching it is the membership check: the api 404s a project you can't see.
+        const project = await api.getProject(id);
+        await new ContextStore().update(ctx => ({ ...ctx, project: project.id }));
+        log.info(`✅ Active project: ${project.name} (${project.id})`);
+    }
+};
+const project_current = {
+    command: 'current',
+    describe: 'Show the active project and where it comes from',
+    builder: yargs => json_option(yargs).showHelpOnFail(false),
+    handler: async (args) => {
+        const { api } = await requireApi();
+        const configured = await configuredProject();
+        const { id, source } = await requireProject(api);
+        const project = await api.getProject(id);
+        const out = {
+            id: project.id,
+            name: project.name,
+            slug: project.slug ?? null,
+            source: configured?.source ?? source
+        };
+        if (args.json)
+            return print_json(out);
+        print(`${project.name} (${project.id})`);
+        log.info(`from ${SOURCE_LABEL[out.source]}`);
+    }
+};
+const project = {
+    command: 'project',
+    describe: 'Choose the project the CLI acts on (list, use, current)',
+    builder: yargs => yargs
+        .command(project_list)
+        .command(project_use)
+        .command(project_current)
+        .demandCommand(1)
+        .showHelpOnFail(false),
+    handler: () => { }
+};
+
+export { project };