@capuchoo/cli 0.2.1 → 0.4.0

package/dist/commands/doctor.js

@@ -0,0 +1,278 @@
+import { canPublishTo, hasEnvironmentMismatch, normaliseProjectConfig, suggestEnvironment, } from "@capuchoo/core";
+import chalk from "chalk";
+import fs from "node:fs";
+import path from "node:path";
+import { BaseCommand } from "../base-command.js";
+import { CloudClient } from "../services/cloud.js";
+import { readProjectConfig, resolveCredentials } from "../utils/config.js";
+/**
+ * Explains why a deploy will not work, before you run one.
+ *
+ * Every check here corresponds to something that has silently failed in this
+ * project: an endpoint pointing at a retired backend, a channel whose
+ * environment disagreed with its name, a channel serving nothing because the
+ * upload never moved its pointer, an app whose flavour env file did not exist.
+ * Each finding names the fix, because a diagnosis you cannot act on is just bad
+ * news.
+ */
+export default class Doctor extends BaseCommand {
+    static description = "Check that this app, its credentials and its channels are usable";
+    static examples = ["<%= config.bin %> doctor"];
+    async run() {
+        const appDir = process.cwd();
+        const findings = [];
+        // --- credentials ---------------------------------------------------------
+        const credentials = resolveCredentials();
+        if (!credentials) {
+            this.report([{ level: "fail", what: "Not signed in", fix: "capuchoo auth login" }]);
+            return;
+        }
+        findings.push({ level: "ok", what: "Endpoint", detail: credentials.endpoint });
+        const cloud = new CloudClient(credentials.endpoint, credentials.apiKey);
+        const profile = await cloud.whoami().catch(() => null);
+        if (!profile) {
+            findings.push({
+                level: "fail",
+                what: "Credentials rejected",
+                detail: `${credentials.endpoint} did not accept the stored API key`,
+                // The endpoint is the likelier culprit: a retired backend answers
+                // /health but validates nothing.
+                fix: `capuchoo config set endpoint <url>   (or capuchoo auth login)`,
+            });
+            this.report(findings);
+            return;
+        }
+        findings.push({ level: "ok", what: "Signed in", detail: profile.user.email });
+        // --- the link between this directory and a cloud app ---------------------
+        // Normalised, not raw: a v1 project.json carries only the cloud identifiers
+        // and every flavour is defaulted at runtime. Reading the raw fields reported
+        // "no flavour configured" for an app that deploys fine.
+        const raw = readProjectConfig(appDir);
+        const project = raw ? normaliseProjectConfig(raw) : null;
+        if (!project) {
+            findings.push({
+                level: "fail",
+                what: "This directory is not linked to an app",
+                fix: "capuchoo init",
+            });
+            this.report(findings);
+            return;
+        }
+        findings.push({
+            level: "ok",
+            what: "Linked",
+            detail: `${project.appName} (${project.appId})`,
+        });
+        // An app-scoped key lists every app the account owns and is refused only by
+        // the endpoints that publish - so without this check the first sign of a
+        // mismatch is a 403 at step 7 of 7, after a full build and zip.
+        if (!canPublishTo(profile, project.cloudAppId)) {
+            const scoped = profile.apps.find((app) => app.id === profile.credential?.app_id);
+            findings.push({
+                level: "fail",
+                what: "This API key cannot publish to this app",
+                detail: scoped
+                    ? `The key is restricted to ${scoped.name} (${scoped.app_id})`
+                    : `The key is restricted to app ${profile.credential?.app_id}`,
+                fix: "capuchoo auth login   (with a key for this app, or an unscoped one)",
+            });
+        }
+        // --- channels ------------------------------------------------------------
+        const channels = await cloud.channels(project.cloudAppId).catch(() => null);
+        if (!channels) {
+            findings.push({
+                level: "fail",
+                what: "The linked cloud app could not be read",
+                detail: `cloudAppId ${project.cloudAppId} - deleted, or belongs to another account`,
+                fix: "capuchoo init --force",
+            });
+            this.report(findings);
+            return;
+        }
+        if (channels.length === 0) {
+            findings.push({
+                level: "fail",
+                what: "No channels",
+                detail: "Nothing can be deployed until a channel exists",
+                fix: "capuchoo channel create staging",
+            });
+        }
+        for (const channel of channels) {
+            if (!channel.environment) {
+                findings.push({
+                    level: "fail",
+                    what: `Channel "${channel.name}" has no environment`,
+                    detail: "The environment is what tells the CLI which flavour to build",
+                    fix: "Recreate it with capuchoo channel create, or set the environment " +
+                        `in the dashboard (suggested: ${suggestEnvironment(channel.name) ?? "prod"})`,
+                });
+                continue;
+            }
+            if (hasEnvironmentMismatch(channel.name, channel.environment)) {
+                findings.push({
+                    level: "warn",
+                    what: `Channel "${channel.name}" is on the ${channel.environment} environment`,
+                    detail: `Devices on it receive ${channel.environment} bundles, built from .env.${channel.environment}`,
+                    fix: `Set it to ${suggestEnvironment(channel.name)} unless that is deliberate`,
+                });
+            }
+            // The pointer that decides what is served. An upload that does not move
+            // it leaves the channel answering "no update" forever.
+            if (!channel.current_version_id) {
+                findings.push({
+                    level: "warn",
+                    what: `Channel "${channel.name}" is serving no bundle`,
+                    detail: "No OTA version is active on it yet",
+                    fix: `capuchoo deploy ota --channel ${channel.name}`,
+                });
+            }
+        }
+        // --- flavours ------------------------------------------------------------
+        const environments = new Set(channels.map((channel) => channel.environment).filter(Boolean));
+        for (const environment of environments) {
+            const flavour = project.flavours[environment];
+            const envFile = path.join(appDir, flavour.envFile);
+            if (!fs.existsSync(envFile)) {
+                findings.push({
+                    level: "fail",
+                    what: `Missing ${flavour.envFile}`,
+                    detail: `A ${environment} deploy reads it for the app id, version and update URL`,
+                    fix: `Create ${flavour.envFile}`,
+                });
+                continue;
+            }
+            const contents = fs.readFileSync(envFile, "utf8");
+            const updateUrl = /^VITE_UPDATE_API_URL=(.*)$/m.exec(contents)?.[1]?.trim();
+            if (!updateUrl) {
+                findings.push({
+                    level: "fail",
+                    what: `${flavour.envFile} has no VITE_UPDATE_API_URL`,
+                    detail: "The app would ship with updates silently disabled",
+                    fix: `Add VITE_UPDATE_API_URL=${credentials.endpoint}`,
+                });
+            }
+            else if (updateUrl.replace(/\/+$/, "") !== credentials.endpoint.replace(/\/+$/, "")) {
+                // Not necessarily wrong - a custom domain in front of the same service
+                // is good practice - but it is the mistake that cost an afternoon.
+                findings.push({
+                    level: "warn",
+                    what: `${flavour.envFile} points at a different host`,
+                    detail: `app: ${updateUrl}   cli: ${credentials.endpoint}`,
+                    fix: "Confirm both reach the same backend",
+                });
+            }
+            else {
+                findings.push({ level: "ok", what: `Flavour ${environment}`, detail: flavour.envFile });
+            }
+        }
+        // --- the app's own wiring ------------------------------------------------
+        const webDir = path.join(appDir, project.webDir ?? "dist");
+        if (!fs.existsSync(webDir)) {
+            findings.push({
+                level: "warn",
+                what: `webDir "${project.webDir}" does not exist yet`,
+                detail: "Fine before the first build; a deploy builds it",
+            });
+        }
+        findings.push(...this.checkRuntimeWiring(appDir));
+        this.report(findings);
+    }
+    /**
+     * Looks for the two calls that decide whether updates work at all.
+     *
+     * Textual, not semantic: this is a hint, not a compiler. Worth doing anyway -
+     * a missing `notifyAppReady()` rolls back working bundles ten seconds after
+     * they install, and that is invisible until it happens on a device.
+     */
+    checkRuntimeWiring(appDir) {
+        const findings = [];
+        const pkgPath = path.join(appDir, "package.json");
+        if (!fs.existsSync(pkgPath))
+            return findings;
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        if (!deps["@capuchoo/updater"]) {
+            findings.push({
+                level: "warn",
+                what: "@capuchoo/updater is not a dependency",
+                detail: "Deploys will work; the app will not check for what they publish",
+                fix: "pnpm add @capuchoo/updater",
+            });
+            return findings;
+        }
+        const sources = this.sourceFiles(path.join(appDir, "src"));
+        const joined = sources.map((file) => fs.readFileSync(file, "utf8")).join("\n");
+        if (!joined.includes("notifyAppReady")) {
+            findings.push({
+                level: "fail",
+                what: "notifyAppReady() is never called",
+                detail: "The plugin rolls back to the previous bundle when it does not hear this " +
+                    "within its timeout - so every update would install and then revert",
+                fix: 'Call it early in main.ts: import { notifyAppReady } from "@capuchoo/updater"',
+            });
+        }
+        else {
+            findings.push({ level: "ok", what: "notifyAppReady() present" });
+        }
+        const capacitorConfig = ["capacitor.config.ts", "capacitor.config.js"]
+            .map((name) => path.join(appDir, name))
+            .find((file) => fs.existsSync(file));
+        if (capacitorConfig) {
+            const config = fs.readFileSync(capacitorConfig, "utf8");
+            if (!config.includes("capuchooUpdaterConfig") && !config.includes("capuchooUpdaterConfig")) {
+                findings.push({
+                    level: "warn",
+                    what: `${path.basename(capacitorConfig)} does not use capuchooUpdaterConfig()`,
+                    detail: "Hand-written plugin config has shipped an empty updateUrl before, which " +
+                        "disables updates without failing",
+                    fix: "plugins.CapacitorUpdater = capuchooUpdaterConfig({ apiUrl, channel })",
+                });
+            }
+            else {
+                findings.push({ level: "ok", what: "Capacitor plugin config" });
+            }
+        }
+        return findings;
+    }
+    /** Shallow-ish walk: enough to find an import, cheap enough to run always. */
+    sourceFiles(dir, depth = 0) {
+        if (depth > 3 || !fs.existsSync(dir))
+            return [];
+        const found = [];
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (entry.name === "node_modules" || entry.name.startsWith("."))
+                continue;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory())
+                found.push(...this.sourceFiles(full, depth + 1));
+            else if (/\.(ts|tsx|js|vue)$/.test(entry.name))
+                found.push(full);
+        }
+        return found;
+    }
+    report(findings) {
+        const mark = { ok: chalk.green("✓"), warn: chalk.yellow("!"), fail: chalk.red("✗") };
+        this.log("");
+        for (const finding of findings) {
+            this.log(`  ${mark[finding.level]} ${finding.what}`);
+            if (finding.detail)
+                this.log(chalk.dim(`      ${finding.detail}`));
+            if (finding.fix)
+                this.log(chalk.cyan(`      → ${finding.fix}`));
+        }
+        const failed = findings.filter((f) => f.level === "fail").length;
+        const warned = findings.filter((f) => f.level === "warn").length;
+        this.log("");
+        if (failed === 0 && warned === 0) {
+            this.log(chalk.green("  Ready to deploy."));
+        }
+        else {
+            this.log(`  ${failed} blocking, ${warned} worth a look. ` +
+                chalk.dim("Fix the blocking ones before deploying."));
+        }
+        this.log("");
+        if (failed > 0)
+            process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/init.d.ts

@@ -4,9 +4,20 @@ export default class Init extends BaseCommand {
     static examples: string[];
     static flags: {
         link: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        create: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "app-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        org: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        channel: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
+    /**
+     * Creates the first channel, because a linked app without one cannot be
+     * deployed to. The environment is chosen explicitly: a channel's name never
+     * decides which flavour it serves.
+     */
+    private offerFirstChannel;
     /** Detects which flavours the project actually has files for. */
     private detectFlavours;
     /** Reads `webDir` out of capacitor.config.* so the CLI zips the right folder. */

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,OAAgB,WAAW,SAC8C;IAEzE,OAAgB,QAAQ,WAA+D;IAEvF,OAAgB,KAAK;;;MAWnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAwI1B,iEAAiE;IACjE,OAAO,CAAC,cAAc;IAatB,iFAAiF;IACjF,OAAO,CAAC,YAAY;YAYN,YAAY;YAqBZ,SAAS;CAiExB"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AASjD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,OAAgB,WAAW,SACgD;IAE3E,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,KAAK;;;;;;;;MAqCnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA8J1B;;;;OAIG;YACW,iBAAiB;IAmE/B,iEAAiE;IACjE,OAAO,CAAC,cAAc;IAatB,iFAAiF;IACjF,OAAO,CAAC,YAAY;YAYN,YAAY;YA2BZ,SAAS;CAoFxB"}

package/dist/commands/init.js

@@ -1,5 +1,5 @@
-import { confirm, input, select } from "@inquirer/prompts";
-import { ENVIRONMENTS, PROJECT_CONFIG_VERSION, canCreateApps, defaultFlavour, isValidBundleId, } from "@capuchoo/core";
+import { askText, confirm, isInteractive, log, selectOne } from "../cli/prompts.js";
+import { ENVIRONMENTS, PROJECT_CONFIG_VERSION, canCreateApps, canPublishTo, defaultFlavour, environmentMismatchWarning, suggestEnvironment, isValidBundleId, } from "@capuchoo/core";
 import { Flags } from "@oclif/core";
 import chalk from "chalk";
 import fs from "node:fs";
@@ -10,13 +10,44 @@ import { projectConfigPath, readProjectConfig, resolveCredentials, writeProjectC
 import AuthLogin from "./auth/login.js";
 import { BaseCommand } from "../base-command.js";
 export default class Init extends BaseCommand {
-    static description = "Link this directory to a Capucho app and write .capucho/project.json";
-    static examples = ["<%= config.bin %> init", "<%= config.bin %> init --link"];
+    static description = "Link this directory to a Capuchoo app and write .capuchoo/project.json";
+    static examples = [
+        "<%= config.bin %> init",
+        "<%= config.bin %> init --link",
+        "<%= config.bin %> init --create",
+        '<%= config.bin %> init --create --name "My App" --app-id com.acme.app --channel staging',
+    ];
     static flags = {
         link: Flags.boolean({
             char: "l",
             default: false,
-            description: "Link an existing app instead of creating one",
+            description: "Link an existing app instead of asking",
+            exclusive: ["create"],
+        }),
+        // Without this, a non-interactive shell could only ever link: the prompt
+        // named --link as its escape hatch and there was no flag for the other half
+        // of the same question.
+        create: Flags.boolean({
+            char: "c",
+            default: false,
+            description: "Create a new app instead of asking",
+            exclusive: ["link"],
+        }),
+        name: Flags.string({
+            description: "Name of the app to create (default: this directory's name)",
+            dependsOn: ["create"],
+        }),
+        // Used by both halves: with --create it is the identifier to register, with
+        // --link the identifier to select. Either way it names the app.
+        "app-id": Flags.string({
+            description: "Bundle identifier of the app, e.g. com.company.app",
+        }),
+        org: Flags.string({
+            description: "Organization to create the app in, by name or id",
+            dependsOn: ["create"],
+        }),
+        channel: Flags.string({
+            description: "Create this channel after linking, e.g. staging",
         }),
         force: Flags.boolean({
             char: "f",
@@ -28,19 +59,16 @@ export default class Init extends BaseCommand {
         const { flags } = await this.parse(Init);
         const appDir = process.cwd();
         this.log("");
-        this.log(chalk.bold("  Initialise Capucho"));
+        this.log(chalk.bold("  Initialise Capuchoo"));
         this.log(chalk.dim(`  ${appDir}`));
         this.log("");
         const existing = readProjectConfig(appDir);
         if (existing && !flags.force) {
             this.log(chalk.yellow("  Already initialised: ") + `${existing.appName} (${existing.appId})`);
-            const action = await select({
-                message: "What now?",
-                choices: [
-                    { name: "Keep it", value: "keep" },
-                    { name: "Re-link to a different app", value: "relink" },
-                ],
-            });
+            const action = await selectOne("What now?", [
+                { value: "keep", label: "Keep it", hint: existing.appId },
+                { value: "relink", label: "Re-link to a different app" },
+            ], "--force");
             if (action === "keep")
                 return;
         }
@@ -67,14 +95,28 @@ export default class Init extends BaseCommand {
         // --- pick or create the app ---------------------------------------------
         const mode = flags.link
             ? "existing"
-            : await select({
-                message: "Link this directory to",
-                choices: [
-                    { name: "An app that already exists", value: "existing" },
-                    { name: "A new app", value: "new" },
-                ],
+            : flags.create
+                ? "new"
+                : await selectOne("Should this directory publish to an existing app, or a new one?", [
+                    { value: "existing", label: "An app that already exists" },
+                    { value: "new", label: "A new app" },
+                ], "--link or --create");
+        const app = mode === "existing"
+            ? await this.linkExisting(cloud, flags["app-id"])
+            : await this.createNew(cloud, {
+                name: flags.name,
+                appId: flags["app-id"],
+                org: flags.org,
             });
-        const app = mode === "existing" ? await this.linkExisting(cloud) : await this.createNew(cloud);
+        // The key that just created or linked this app may not be allowed to publish
+        // to it: an app-scoped key can read every app the account owns. Say so here
+        // rather than let the first deploy discover it after a full build.
+        if (!canPublishTo(profile, app.id)) {
+            this.log("");
+            this.log(chalk.yellow("  The API key in use is restricted to another app, so deploys from here\n" +
+                `  will be refused. Run "capuchoo auth login" with a key for ${app.name}\n` +
+                "  or an unscoped one."));
+        }
         // --- flavours ------------------------------------------------------------
         const flavours = this.detectFlavours(appDir);
         const detected = Object.keys(flavours);
@@ -127,12 +169,55 @@ export default class Init extends BaseCommand {
                 chalk.cyan(`capuchoo deploy ota --channel ${deployable[0].name}`));
         }
         else {
-            this.log(chalk.yellow("  This app has no channel with an environment set yet."));
-            this.log(chalk.dim("  Create one in the dashboard - the environment is what tells the CLI\n" +
-                "  which flavour to build."));
+            // An app with no channel is not deployable, and init already knows it.
+            // Sending people to the dashboard here was the one thing that made setting
+            // an app up a CLI-browser-CLI round trip.
+            await this.offerFirstChannel(cloud, app, flags.channel);
         }
         this.log("");
     }
+    /**
+     * Creates the first channel, because a linked app without one cannot be
+     * deployed to. The environment is chosen explicitly: a channel's name never
+     * decides which flavour it serves.
+     */
+    async offerFirstChannel(cloud, app, requested) {
+        this.log(chalk.yellow("  This app has no channel yet, so nothing can be deployed to it."));
+        this.log(chalk.dim("  A channel's environment is what tells the CLI which flavour to build.\n"));
+        const name = requested?.trim();
+        if (!name && !isInteractive()) {
+            this.log(chalk.dim("  Create one with: ") +
+                chalk.cyan("capuchoo channel create staging") +
+                chalk.dim("   (or pass --channel)"));
+            return;
+        }
+        if (!name) {
+            const create = await confirm("Create one now?", { default: true });
+            if (!create) {
+                this.log(chalk.dim("  Later: ") + chalk.cyan("capuchoo channel create staging"));
+                return;
+            }
+        }
+        const chosen = name ?? (await askText("Channel name", { initial: "staging", flag: "--channel" })).trim();
+        const environment = suggestEnvironment(chosen) ??
+            (await selectOne(`Which flavour should "${chosen}" serve?`, ENVIRONMENTS.map((value) => ({ value, label: value })), "--channel <name> with a name like staging"));
+        const warning = environmentMismatchWarning(chosen, environment);
+        if (warning)
+            log.warn(warning);
+        try {
+            const channel = await cloud.createChannel({ app_id: app.id, name: chosen, environment });
+            this.log("");
+            this.log(`  ${chalk.green("Created channel")} ${channel.name} ${chalk.dim(`(${environment})`)}`);
+            this.log(chalk.dim("  Deploy with: ") + chalk.cyan(`capuchoo deploy ota --channel ${channel.name}`));
+        }
+        catch (error) {
+            // The app and project.json are already correct, so this is a warning and
+            // not a failure - `capuchoo channel create` retries just this step.
+            this.log("");
+            this.log(chalk.yellow(`  The channel could not be created: ${error instanceof Error ? error.message : String(error)}`));
+            this.log(chalk.dim(`  Retry with: capuchoo channel create ${chosen}`));
+        }
+    }
     /** Detects which flavours the project actually has files for. */
     detectFlavours(appDir) {
         const found = {};
@@ -156,23 +241,24 @@ export default class Init extends BaseCommand {
         }
         return "dist";
     }
-    async linkExisting(cloud) {
+    async linkExisting(cloud, wanted) {
         const spinner = ora({ text: "Fetching apps", stream: process.stderr }).start();
         const apps = await cloud.apps();
         spinner.stop();
         if (apps.length === 0) {
-            this.error("This account has no apps yet. Re-run and choose to create one, or " +
-                "create it in the dashboard.");
-        }
-        return select({
-            message: "App",
-            choices: apps.map((app) => ({
-                name: `${app.name} ${chalk.dim(app.app_id)}`,
-                value: app,
-            })),
-        });
+            this.error("This account has no apps yet. Run capuchoo init --create to register one.");
+        }
+        if (wanted) {
+            const match = apps.find((app) => app.app_id === wanted || app.id === wanted);
+            if (!match) {
+                this.error(`No app called "${wanted}" on this account. ` +
+                    `Available: ${apps.map((app) => app.app_id).join(", ")}.`);
+            }
+            return match;
+        }
+        return selectOne("Which app does this directory publish to?", apps.map((app) => ({ value: app, label: app.name, hint: app.app_id })), "--app-id");
     }
-    async createNew(cloud) {
+    async createNew(cloud, given) {
         const spinner = ora({
             text: "Fetching organizations",
             stream: process.stderr,
@@ -186,30 +272,37 @@ export default class Init extends BaseCommand {
                 : "This account is a member, not an owner or admin, of every organization " +
                     "it belongs to, so it cannot create an app. Ask an owner.");
         }
-        const organizationId = allowed.length === 1
-            ? allowed[0].id
-            : await select({
-                message: "Organization",
-                choices: allowed.map((org) => ({
-                    name: `${org.name} ${chalk.dim(`(${org.role})`)}`,
-                    value: org.id,
-                })),
-            });
-        const name = await input({
-            message: "App name",
-            default: path.basename(process.cwd()),
-            validate: (value) => value.trim().length > 0 || "Required",
-        });
-        const appId = await input({
-            message: "Production bundle identifier",
-            validate: (value) => isValidBundleId(value.trim()) ||
-                "Expected something like com.company.app - lower case, at least two segments",
-        });
+        const requested = given.org?.trim().toLowerCase();
+        const chosen = requested
+            ? allowed.find((org) => org.id === given.org?.trim() || org.name.toLowerCase() === requested)
+            : undefined;
+        if (requested && !chosen) {
+            this.error(`No organization called "${given.org}" that this account can create apps in. ` +
+                `Available: ${allowed.map((org) => org.name).join(", ")}.`);
+        }
+        const organizationId = chosen?.id ??
+            (allowed.length === 1
+                ? allowed[0].id
+                : await selectOne("Organization", allowed.map((org) => ({ value: org.id, label: org.name, hint: org.role })), "--org"));
+        const name = given.name?.trim() ||
+            (await askText("App name", {
+                initial: path.basename(process.cwd()),
+                flag: "--name",
+            }));
+        const appId = given.appId?.trim() ||
+            (await askText("Production bundle identifier", {
+                placeholder: "com.company.app",
+                flag: "--app-id",
+                validate: (value) => isValidBundleId(value.trim())
+                    ? undefined
+                    : "Expected something like com.company.app - lower case, at least two segments",
+            }));
+        if (!isValidBundleId(appId)) {
+            this.error(`"${appId}" is not a bundle identifier. Expected something like com.company.app - ` +
+                "lower case, at least two segments.");
+        }
         // Creating an app is the one irreversible thing this command does.
-        const proceed = await confirm({
-            message: `Create "${name}" (${appId})?`,
-            default: true,
-        });
+        const proceed = await confirm(`Create "${name}" (${appId})?`, { default: true });
         if (!proceed)
             this.error("Cancelled.");
         const creating = ora({ text: "Creating app", stream: process.stderr }).start();