@coderook/cli 0.38.2 → 0.40.0

package/dist/cli/src/settings_commands.js

@@ -0,0 +1,532 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onOff = onOff;
+exports.commandAbout = commandAbout;
+exports.commandLineRules = commandLineRules;
+exports.commandUploadRules = commandUploadRules;
+exports.commandAssistant = commandAssistant;
+exports.commandHandOver = commandHandOver;
+/**
+ * The rest of a project's Settings, from a terminal.
+ *
+ *   cbx about [project] [--name …] [--description …]       General: name, description, address
+ *   cbx line-rules [line] [--protect] [--approvals n] …     Lines & reviews, per line
+ *   cbx upload-rules [--ignore file] [--encrypt off] …     Files & privacy: encrypted upload rules
+ *   cbx assistant [manual|automated] [--review on] …       Automation: the pull-request assistant
+ *   cbx hand-over <user> [project]                          Danger zone: offer the project to somebody
+ *
+ * Each one shows what is set when given nothing to change, because "what is
+ * this set to" is most of what people ask, and changes only what was named.
+ * They call the routes the website's Settings screen calls, so the service
+ * decides who may change what — owners and admins, mostly — and its refusal
+ * is printed as it is.
+ *
+ * AI access is the one setting with no command here that changes it: a
+ * person changes it on the website or in the desktop app (see `cbx ai`).
+ */
+const node_process_1 = __importDefault(require("node:process"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = require("node:readline/promises");
+const api_js_1 = require("./api.js");
+const config_js_1 = require("./config.js");
+const colour_js_1 = require("./colour.js");
+const project_commands_js_1 = require("./project_commands.js");
+function flagText(parsed, ...names) {
+    for (const name of names) {
+        const value = parsed.flags.get(name);
+        if (typeof value === "string")
+            return value;
+    }
+    return undefined;
+}
+/**
+ * `on`/`off` and the other ways people say them. Undefined when the flag was
+ * not given; null when it was given and is neither.
+ */
+function onOff(parsed, name) {
+    const value = parsed.flags.get(name);
+    if (value === undefined)
+        return undefined;
+    if (value === true)
+        return true;
+    const text = value.trim().toLowerCase();
+    if (["on", "true", "yes", "y", "1"].includes(text))
+        return true;
+    if (["off", "false", "no", "n", "0"].includes(text))
+        return false;
+    return null;
+}
+const repositoryRoute = (id) => `/v1/repositories/${encodeURIComponent(id)}`;
+/** General: the project's name, description and address. */
+async function commandAbout(parsed) {
+    const project = await (0, project_commands_js_1.resolveProject)(parsed.positional[0] ?? flagText(parsed, "project"));
+    if (!project)
+        return 1;
+    const change = {};
+    const name = flagText(parsed, "name");
+    if (parsed.flags.has("name")) {
+        if (!name?.trim()) {
+            console.error((0, colour_js_1.red)('Give the new name: --name "Night Owl Diner"'));
+            return 1;
+        }
+        if (name.trim().length > 160) {
+            console.error((0, colour_js_1.red)("A project's name is at most 160 characters."));
+            return 1;
+        }
+        change.displayName = name.trim();
+    }
+    if (parsed.flags.has("description")) {
+        /* An empty description is allowed: it is how one is cleared. */
+        const description = flagText(parsed, "description") ?? "";
+        if (description.trim().length > 1000) {
+            console.error((0, colour_js_1.red)("A description is at most 1000 characters."));
+            return 1;
+        }
+        change.description = description.trim();
+    }
+    if (Object.keys(change).length) {
+        await (0, api_js_1.updateProject)(project.id, change);
+        console.log((0, colour_js_1.green)(`Saved ${change.displayName ?? project.name}.`));
+        console.log("");
+    }
+    const record = await (0, api_js_1.callApi)(repositoryRoute(project.id));
+    const slug = record.slug ?? project.slug;
+    const site = (0, config_js_1.siteOrigin)();
+    const address = record.ownerHandle
+        ? site
+            ? `${site}/${encodeURIComponent(record.ownerHandle)}/${encodeURIComponent(slug)}`
+            : `${record.ownerHandle}/${slug}`
+        : slug;
+    console.log(`  ${(0, colour_js_1.dim)("Name".padEnd(12))} ${(0, colour_js_1.bold)(record.displayName || project.name)}`);
+    console.log(`  ${(0, colour_js_1.dim)("Description".padEnd(12))} ${record.description?.trim() ? record.description.trim() : (0, colour_js_1.dim)("none")}`);
+    console.log(`  ${(0, colour_js_1.dim)("Address".padEnd(12))} ${address}`);
+    console.log(`  ${(0, colour_js_1.dim)("Visibility".padEnd(12))} ${record.visibility ?? project.visibility}`);
+    if (!Object.keys(change).length) {
+        console.log("");
+        console.log((0, colour_js_1.dim)('  Change them: cbx about --name "…" --description "…"'));
+    }
+    return 0;
+}
+function describeLine(line) {
+    const rules = [
+        line.protected ? (0, colour_js_1.green)("protected") : (0, colour_js_1.dim)("not protected"),
+        line.requiredApprovals
+            ? `${line.requiredApprovals} ${line.requiredApprovals === 1 ? "approval" : "approvals"}`
+            : (0, colour_js_1.dim)("no approvals needed"),
+        line.requireCodeOwner ? "code owners must approve" : "",
+    ].filter(Boolean);
+    const lines = [`  ${(0, colour_js_1.accent)(line.name.padEnd(16))} ${rules.join((0, colour_js_1.dim)(" · "))}`];
+    if (line.requiredChecks.length)
+        lines.push(`  ${" ".repeat(16)} ${(0, colour_js_1.dim)("checks:")} ${line.requiredChecks.join(", ")}`);
+    return lines;
+}
+/**
+ * Lines & reviews: protection, approvals, required checks and code owners,
+ * one line at a time. `cbx tracks` lists the lines and is left as it was;
+ * this is where their rules are read and set.
+ */
+async function commandLineRules(parsed) {
+    const project = await (0, project_commands_js_1.resolveProject)(flagText(parsed, "project"));
+    if (!project)
+        return 1;
+    const base = repositoryRoute(project.id);
+    const wanted = parsed.positional[0];
+    const protect = parsed.flags.has("protect");
+    const unprotect = parsed.flags.has("unprotect");
+    if (protect && unprotect) {
+        console.error((0, colour_js_1.red)("Pick one: --protect or --unprotect."));
+        return 1;
+    }
+    let approvals;
+    if (parsed.flags.has("approvals")) {
+        approvals = Number(flagText(parsed, "approvals"));
+        if (!Number.isInteger(approvals) || approvals < 0 || approvals > 10) {
+            console.error((0, colour_js_1.red)("Approvals is a whole number from 0 to 10."));
+            return 1;
+        }
+    }
+    let checks;
+    if (parsed.flags.has("checks")) {
+        const text = (flagText(parsed, "checks") ?? "").trim();
+        checks = text === "none" ? [] : text.split(",").map((one) => one.trim()).filter(Boolean);
+    }
+    const owners = onOff(parsed, "code-owners");
+    if (owners === null) {
+        console.error((0, colour_js_1.red)("--code-owners is on or off."));
+        return 1;
+    }
+    const changing = protect || unprotect || approvals !== undefined || checks !== undefined || owners !== undefined;
+    const { tracks } = await (0, api_js_1.callApi)(`${base}/tracks`);
+    const lines = tracks
+        .filter((track) => (track.kind ?? "line") === "line")
+        .map((track) => ({
+        ...track,
+        requiredApprovals: Number(track.requiredApprovals ?? 0),
+        requiredChecks: Array.isArray(track.requiredChecks) ? track.requiredChecks : [],
+        requireCodeOwner: track.requireCodeOwner === true,
+    }));
+    if (changing && !wanted) {
+        console.error((0, colour_js_1.red)("Which line? cbx line-rules main --protect"));
+        return 1;
+    }
+    const line = wanted ? lines.find((one) => one.name === wanted) : undefined;
+    if (wanted && !line) {
+        console.error((0, colour_js_1.red)(`No line called "${wanted}" on ${project.slug}.`) + (0, colour_js_1.dim)("  cbx tracks lists them."));
+        return 1;
+    }
+    if (changing && line) {
+        const route = `${base}/tracks/${encodeURIComponent(line.name)}`;
+        if (protect || unprotect) {
+            await (0, api_js_1.callApi)(`${route}/protection`, { method: "PUT", body: { protected: protect } });
+        }
+        if (approvals !== undefined) {
+            await (0, api_js_1.callApi)(`${route}/review-policy`, { method: "PUT", body: { requiredApprovals: approvals } });
+        }
+        if (checks !== undefined || owners !== undefined) {
+            await (0, api_js_1.callApi)(`${route}/rules`, {
+                method: "PUT",
+                body: {
+                    ...(checks !== undefined ? { requiredChecks: checks } : {}),
+                    ...(owners !== undefined ? { requireCodeOwner: owners } : {}),
+                },
+            });
+        }
+        const after = (await (0, api_js_1.callApi)(`${base}/tracks`)).tracks.find((one) => one.name === line.name);
+        console.log((0, colour_js_1.green)(`Saved the rules for ${line.name}.`));
+        if (after) {
+            for (const row of describeLine({
+                ...after,
+                requiredApprovals: Number(after.requiredApprovals ?? 0),
+                requiredChecks: Array.isArray(after.requiredChecks) ? after.requiredChecks : [],
+                requireCodeOwner: after.requireCodeOwner === true,
+            }))
+                console.log(row);
+        }
+        return 0;
+    }
+    if (!lines.length) {
+        console.log((0, colour_js_1.dim)(`${project.slug} has no lines yet. The first save creates main.`));
+        return 0;
+    }
+    console.log((0, colour_js_1.bold)(`Rules on ${project.slug}'s lines`));
+    for (const one of line ? [line] : lines)
+        for (const row of describeLine(one))
+            console.log(row);
+    /* The CODEOWNERS the service read, so "code owners must approve" names somebody. */
+    const { rules } = await (0, api_js_1.callApi)(`${base}/code-owners`).catch(() => ({ rules: [] }));
+    console.log("");
+    if (rules.length) {
+        console.log((0, colour_js_1.dim)(`Code owners, from CODEOWNERS on the default line (${rules.length}):`));
+        for (const rule of rules.slice(0, 10))
+            console.log(`  ${rule.pattern.padEnd(24)} ${(0, colour_js_1.dim)(rule.owners.join(" "))}`);
+        if (rules.length > 10)
+            console.log((0, colour_js_1.dim)(`  … and ${rules.length - 10} more`));
+    }
+    else {
+        console.log((0, colour_js_1.dim)("No CODEOWNERS file on the default line, so nobody counts as a code owner."));
+    }
+    console.log("");
+    console.log((0, colour_js_1.dim)("Change one: cbx line-rules main --protect --approvals 1 --checks build,test --code-owners on"));
+    return 0;
+}
+/** A file's text, `none` for empty, or null with the reason printed. */
+function rulesFrom(given, flag) {
+    if (typeof given !== "string" || !given.trim()) {
+        console.error((0, colour_js_1.red)(`--${flag} takes a file of patterns, one per line (or none to clear them).`));
+        return null;
+    }
+    if (given.trim() === "none")
+        return "";
+    const file = node_path_1.default.resolve(given);
+    if (!(0, node_fs_1.existsSync)(file) || !(0, node_fs_1.statSync)(file).isFile()) {
+        console.error((0, colour_js_1.red)(`No file at ${file}. --${flag} reads its patterns from a file.`));
+        return null;
+    }
+    return (0, node_fs_1.readFileSync)(file, "utf8");
+}
+const MIB = 1024 * 1024;
+/**
+ * Files & privacy → Encrypted uploads: what uploads leave out and keep,
+ * whether recognised secret files are encrypted before storage, and the size
+ * that earns a warning. The desktop app and the website's scans read the
+ * same rules.
+ *
+ * The service takes the whole set at once, so what was not named is sent
+ * back exactly as it was read.
+ */
+async function commandUploadRules(parsed) {
+    const project = await (0, project_commands_js_1.resolveProject)(flagText(parsed, "project") ?? parsed.positional[0]);
+    if (!project)
+        return 1;
+    const route = `${repositoryRoute(project.id)}/rules`;
+    const current = await (0, api_js_1.callApi)(route);
+    const next = { ...current };
+    let changed = false;
+    if (parsed.flags.has("ignore")) {
+        const text = rulesFrom(parsed.flags.get("ignore"), "ignore");
+        if (text === null)
+            return 1;
+        next.ignoreRules = text;
+        changed = true;
+    }
+    if (parsed.flags.has("keep")) {
+        const text = rulesFrom(parsed.flags.get("keep"), "keep");
+        if (text === null)
+            return 1;
+        next.keepRules = text;
+        changed = true;
+    }
+    const encrypt = onOff(parsed, "encrypt");
+    const hold = onOff(parsed, "hold-pushes");
+    if (encrypt === null || hold === null) {
+        console.error((0, colour_js_1.red)(`--${encrypt === null ? "encrypt" : "hold-pushes"} is on or off.`));
+        return 1;
+    }
+    if (encrypt !== undefined) {
+        next.encryptSecretFiles = encrypt;
+        changed = true;
+    }
+    if (hold !== undefined) {
+        next.holdPushesForReview = hold;
+        changed = true;
+    }
+    if (parsed.flags.has("warn-large")) {
+        const mib = Number(flagText(parsed, "warn-large"));
+        if (!Number.isFinite(mib) || mib < 0) {
+            console.error((0, colour_js_1.red)("--warn-large is a size in MiB, 0 or more."));
+            return 1;
+        }
+        next.warnLargeFileBytes = Math.round(mib * MIB);
+        changed = true;
+    }
+    if (changed) {
+        await (0, api_js_1.callApi)(route, {
+            method: "PUT",
+            body: {
+                ignoreRules: next.ignoreRules,
+                keepRules: next.keepRules,
+                encryptSecretFiles: next.encryptSecretFiles,
+                holdPushesForReview: next.holdPushesForReview,
+                warnLargeFileBytes: next.warnLargeFileBytes,
+            },
+        });
+        console.log((0, colour_js_1.green)(`Saved ${project.name}'s upload rules. The desktop app and the website's scans use them now.`));
+        console.log("");
+    }
+    const shown = changed ? await (0, api_js_1.callApi)(route) : current;
+    const block = (title, text) => {
+        console.log((0, colour_js_1.dim)(title));
+        const rows = text.split(/\r?\n/).filter((row) => row.trim());
+        if (!rows.length)
+            console.log(`  ${(0, colour_js_1.dim)("none")}`);
+        for (const row of rows)
+            console.log(`  ${row}`);
+    };
+    console.log((0, colour_js_1.bold)(`Upload rules for ${project.slug}`));
+    console.log(`  ${"Encrypt files recognised as secrets".padEnd(38)} ${shown.encryptSecretFiles ? (0, colour_js_1.green)("on") : (0, colour_js_1.red)("off")}`);
+    console.log(`  ${"Warn about files larger than".padEnd(38)} ${Math.round(Number(shown.warnLargeFileBytes) / MIB)} MiB`);
+    console.log(`  ${"Hold pushes below admin for review".padEnd(38)} ${shown.holdPushesForReview ? (0, colour_js_1.green)("on") : (0, colour_js_1.dim)("off")}`);
+    console.log("");
+    block("Ignore rules", shown.ignoreRules ?? "");
+    console.log("");
+    block("Keep rules", shown.keepRules ?? "");
+    if (!changed) {
+        console.log("");
+        console.log((0, colour_js_1.dim)("  Change them: cbx upload-rules --ignore .coderookignore --encrypt on --warn-large 512"));
+    }
+    return 0;
+}
+/* -------------------------------------------------------------- assistant -- */
+const SWITCHES = [
+    ["review", "reviews each pull request"],
+    ["describe", "writes the description"],
+    ["suggest", "suggests changes"],
+    ["change", "makes changes when asked"],
+    ["approve", "approves when it finds nothing"],
+    ["merge", "merges what it approved"],
+];
+/**
+ * Automation → PR assistant: manual (only when somebody asks on a pull
+ * request) or automated, and what it may do on its own. Changing it needs a
+ * repository admin and, for automated, a subscription on the owner's account.
+ */
+async function commandAssistant(parsed) {
+    /* `[mode] [project]`, both optional; a lone word that is not a mode is the project. */
+    const [first, second] = parsed.positional;
+    const isMode = first === "manual" || first === "automated";
+    if (first !== undefined && !isMode && second !== undefined) {
+        console.error((0, colour_js_1.red)(`"${first}" is not a mode. Pick manual or automated.`));
+        return 1;
+    }
+    const mode = isMode ? first : undefined;
+    const project = await (0, project_commands_js_1.resolveProject)(flagText(parsed, "project") ?? (isMode ? second : first));
+    if (!project)
+        return 1;
+    const route = `${repositoryRoute(project.id)}/assistant`;
+    const change = {};
+    if (mode)
+        change.mode = mode;
+    for (const [name] of SWITCHES) {
+        const value = onOff(parsed, name);
+        if (value === null) {
+            console.error((0, colour_js_1.red)(`--${name} is on or off.`));
+            return 1;
+        }
+        if (value !== undefined)
+            change[name] = value;
+    }
+    let answer = await (0, api_js_1.callApi)(route);
+    if (Object.keys(change).length) {
+        /*
+          Said here rather than left to the service, which quietly turns merging
+          off when approving is off: "merge" asked for and not given is worth a
+          sentence, not a surprise later.
+        */
+        const next = { ...answer.settings, ...change };
+        if (next.merge && !next.approve) {
+            console.error((0, colour_js_1.red)("Merging needs approving on too: add --approve on."));
+            return 1;
+        }
+        try {
+            await (0, api_js_1.callApi)(route, { method: "PUT", body: change });
+        }
+        catch (error) {
+            if (error instanceof api_js_1.ServiceError && error.code === "assistant_needs_subscription") {
+                console.error((0, colour_js_1.red)(error.message));
+                console.error((0, colour_js_1.dim)("  Manual mode stays available: cbx assistant manual"));
+                return 1;
+            }
+            throw error;
+        }
+        console.log((0, colour_js_1.green)(`Saved ${project.name}'s pull-request assistant.`));
+        answer = await (0, api_js_1.callApi)(route);
+    }
+    const settings = answer.settings;
+    console.log("");
+    console.log(`${(0, colour_js_1.bold)(project.name)} ${(0, colour_js_1.dim)("pull-request assistant:")} ${(0, colour_js_1.accent)(settings.mode)}` +
+        (0, colour_js_1.dim)(settings.mode === "manual" ? "  (works only when somebody asks on a pull request)" : "  (works on its own)"));
+    for (const [name, meaning] of SWITCHES) {
+        console.log(`  ${name.padEnd(9)} ${settings[name] ? (0, colour_js_1.green)("on ") : (0, colour_js_1.dim)("off")}  ${(0, colour_js_1.dim)(meaning)}`);
+    }
+    console.log("");
+    if (!answer.subscribed) {
+        console.log((0, colour_js_1.dim)("  Automated mode comes with a subscription on the owner's account."));
+    }
+    if (!answer.available) {
+        console.log((0, colour_js_1.dim)("  The assistant is not available on this service right now."));
+    }
+    if (answer.allowance) {
+        console.log((0, colour_js_1.dim)(`  This month: ${answer.allowance.percentUsed}% of the allowance used ` +
+            `(${answer.allowance.reviews} reviews, ${answer.allowance.changes} changes).`));
+    }
+    if (!Object.keys(change).length) {
+        console.log((0, colour_js_1.dim)("  Change it: cbx assistant automated --review on --describe on"));
+    }
+    return 0;
+}
+/** A plain line typed at the terminal. */
+async function typed(question) {
+    const prompt = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
+    const answer = await prompt.question(question);
+    prompt.close();
+    return answer.trim();
+}
+/**
+ * Danger zone → Transfer ownership, and answering an offer.
+ *
+ * An offer, as on the website: nothing moves until the other person accepts,
+ * and it lapses after fourteen days. Once accepted it cannot be undone from
+ * this side, so it asks for TRANSFER to be typed, as the website does, unless
+ * --yes says a script has already decided.
+ */
+async function commandHandOver(parsed) {
+    const first = parsed.positional[0];
+    if (!first) {
+        console.error((0, colour_js_1.red)("To whom? cbx hand-over <username or email> [project]") + (0, colour_js_1.dim)("   (or: cbx hand-over offers)"));
+        return 1;
+    }
+    if (first === "offers") {
+        const { incoming, outgoing } = await (0, api_js_1.callApi)("/v1/account/transfers");
+        if (!incoming.length && !outgoing.length) {
+            console.log((0, colour_js_1.dim)("No projects are being handed to you or by you."));
+            return 0;
+        }
+        const until = (offer) => `until ${new Date(offer.expiresAt).toLocaleDateString()}`;
+        if (incoming.length) {
+            console.log((0, colour_js_1.bold)("Offered to you"));
+            for (const offer of incoming) {
+                console.log(`  ${(0, colour_js_1.accent)(offer.slug.padEnd(24))} from ${offer.fromUsername ?? offer.fromName ?? "?"}  ${(0, colour_js_1.dim)(`${until(offer)}  ${offer.id}`)}`);
+            }
+            console.log((0, colour_js_1.dim)("  Take one: cbx hand-over accept <project>   Turn one down: cbx hand-over decline <project>"));
+        }
+        if (outgoing.length) {
+            if (incoming.length)
+                console.log("");
+            console.log((0, colour_js_1.bold)("Offered by you"));
+            for (const offer of outgoing) {
+                console.log(`  ${(0, colour_js_1.accent)(offer.slug.padEnd(24))} to ${offer.toUsername ?? offer.toName ?? "?"}  ${(0, colour_js_1.dim)(`${until(offer)}  ${offer.id}`)}`);
+            }
+            console.log((0, colour_js_1.dim)("  Withdraw one: cbx hand-over cancel <project>"));
+        }
+        return 0;
+    }
+    if (first === "accept" || first === "decline" || first === "cancel") {
+        const wanted = parsed.positional[1]?.trim();
+        if (!wanted) {
+            console.error((0, colour_js_1.red)(`Which offer? cbx hand-over ${first} <project or offer id>`));
+            return 1;
+        }
+        const { incoming, outgoing } = await (0, api_js_1.callApi)("/v1/account/transfers");
+        const pool = first === "cancel" ? outgoing : incoming;
+        const offer = pool.find((one) => one.id === wanted || one.slug.toLowerCase() === wanted.toLowerCase());
+        if (!offer) {
+            console.error((0, colour_js_1.red)(`No offer ${first === "cancel" ? "from" : "to"} you for ${wanted}.`) + (0, colour_js_1.dim)("  cbx hand-over offers lists them."));
+            return 1;
+        }
+        const route = `/v1/account/transfers/${encodeURIComponent(offer.id)}`;
+        if (first === "accept") {
+            const taken = await (0, api_js_1.callApi)(`${route}/accept`, { method: "POST" });
+            console.log((0, colour_js_1.green)(`${taken.displayName ?? offer.projectName} is yours now.`));
+        }
+        else if (first === "decline") {
+            await (0, api_js_1.callApi)(`${route}/decline`, { method: "POST" });
+            console.log((0, colour_js_1.green)(`Turned down ${offer.projectName}. It stays where it was.`));
+        }
+        else {
+            await (0, api_js_1.callApi)(route, { method: "DELETE" });
+            console.log((0, colour_js_1.green)(`Withdrew the offer of ${offer.projectName}. It stays yours.`));
+        }
+        return 0;
+    }
+    const recipient = first.trim();
+    const project = await (0, project_commands_js_1.resolveProject)(parsed.positional[1] ?? flagText(parsed, "project"));
+    if (!project)
+        return 1;
+    const keepAccess = !parsed.flags.has("drop-access");
+    const sure = parsed.flags.get("yes") === true || parsed.flags.get("y") === true;
+    if (!sure) {
+        if (!node_process_1.default.stdin.isTTY) {
+            console.error((0, colour_js_1.red)(`Handing ${project.name} over needs TRANSFER typed, and nobody is here to type it.`));
+            console.error((0, colour_js_1.dim)("  Run it in a terminal to be asked, or add --yes."));
+            return 1;
+        }
+        console.log(`This offers ${(0, colour_js_1.bold)(project.name)} to ${(0, colour_js_1.bold)(recipient)}.`);
+        console.log((0, colour_js_1.dim)("  Nothing moves until they accept, and the offer lapses after fourteen days."));
+        console.log((0, colour_js_1.dim)("  Once they accept, it is theirs: only they can give it back."));
+        console.log((0, colour_js_1.dim)(keepAccess ? "  You keep admin access afterwards (--drop-access to give it up)." : "  You give up your access the moment they accept."));
+        if ((await typed("Type TRANSFER to offer it: ")) !== "TRANSFER") {
+            console.error((0, colour_js_1.red)("That was not TRANSFER. Nothing was offered."));
+            return 1;
+        }
+    }
+    const offered = await (0, api_js_1.callApi)(`${repositoryRoute(project.id)}/transfer`, { method: "POST", body: { recipient, confirmation: "TRANSFER", keepAccess } });
+    console.log((0, colour_js_1.green)(`${offered.displayName} has been offered to ${offered.owner}.`) +
+        ` It stays yours until they accept` +
+        (keepAccess ? "." : ", and you give up your access when they do."));
+    console.log((0, colour_js_1.dim)(`  The offer lapses on ${new Date(offered.expiresAt).toLocaleDateString()}. Withdraw it: cbx hand-over cancel ${project.slug}`));
+    return 0;
+}

package/dist/cli/src/workspace_command.js

@@ -6,8 +6,11 @@ const promises_1 = require("node:fs/promises");
 const node_readline_1 = require("node:readline");
 const api_js_1 = require("./api.js");
 const config_js_1 = require("./config.js");
+const workspace_machine_js_1 = require("./workspace_machine.js");
 async function commandWorkspace(parsed) {
     const [operation, projectRef, workspace, runId] = parsed.positional;
+    if (operation && workspace_machine_js_1.MACHINE_OPERATIONS.has(operation))
+        return (0, workspace_machine_js_1.commandWorkspaceMachine)(parsed);
     if (!operation || !projectRef)
         throw new Error("Use cbx workspace <operation> <project> [workspace]. See cbx help workspace.");
     const project = await (0, api_js_1.findProject)(projectRef);