@coderook/cli 0.35.0 → 0.37.0

package/dist/cli/src/issue_command.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandIssue = commandIssue;
+/**
+ * `cbx issue` — one issue at a time, from the terminal.
+ *
+ *   cbx issue view 12                      the issue, its labels, its timeline and comments
+ *   cbx issue comment 12 -m "…"            reply
+ *   cbx issue close 12 [--reason not-planned | --duplicate-of 9]
+ *   cbx issue reopen 12
+ *   cbx issue label 12 bug,ui [--remove]
+ *   cbx issue assign 12 sam | none
+ *   cbx issue labels [--starter]           the project's labels
+ *   cbx issue rules                        the project's issue rules
+ *
+ * Listing and opening issues stays with `cbx issues` and `cbx issues --new`.
+ * Inside a run, CODEROOK_TOKEN and CODEROOK_PROJECT make these work with no
+ * setup, so a workflow can comment on or label the issue that started it.
+ */
+const api_js_1 = require("./api.js");
+const colour_js_1 = require("./colour.js");
+const project_commands_js_1 = require("./project_commands.js");
+function text(parsed) {
+    const message = parsed.flags.get("m") ?? parsed.flags.get("message");
+    return typeof message === "string" && message.trim() ? message : null;
+}
+function eventLine(event) {
+    const who = event.actor ?? "A rule";
+    const detail = event.detail;
+    switch (event.kind) {
+        case "closed":
+            return `${who} closed it (${String(detail.reason ?? "completed").replace("_", " ")})`;
+        case "marked_duplicate":
+            return `${who} closed it as a duplicate of #${String(detail.duplicateOf)}`;
+        case "reopened":
+            return `${who} reopened it`;
+        case "labeled":
+            return `${who} added ${String(detail.label)}`;
+        case "unlabeled":
+            return `${who} removed ${String(detail.label)}`;
+        case "assigned":
+            return `${who} assigned it`;
+        case "unassigned":
+            return `${who} removed the assignee`;
+        case "renamed":
+            return `${who} renamed it from "${String(detail.from)}"`;
+        case "referenced":
+            return `${who} mentioned it in ${detail.sourceKind === "pull" ? String(detail.reference) : `#${String(detail.number)}`}`;
+        default:
+            return `${who} ${event.kind}`;
+    }
+}
+async function commandIssue(parsed) {
+    const sub = parsed.positional[0] ?? "";
+    const named = parsed.flags.get("project");
+    const project = await (0, project_commands_js_1.resolveProject)(typeof named === "string" ? named : undefined);
+    if (!project)
+        return 1;
+    const base = `/v1/repositories/${encodeURIComponent(project.id)}`;
+    if (sub === "labels") {
+        if (parsed.flags.has("starter")) {
+            const { added } = await (0, api_js_1.callApi)(`${base}/issue-labels/starter`, { method: "POST" });
+            console.log((0, colour_js_1.green)(added ? `Added ${added} labels.` : "The usual labels are already there."));
+        }
+        const { labels } = await (0, api_js_1.callApi)(`${base}/issue-labels`);
+        if (!labels.length) {
+            console.log(`${(0, colour_js_1.bold)(project.slug)} has no labels. ${(0, colour_js_1.dim)("Add the usual set: cbx issue labels --starter")}`);
+            return 0;
+        }
+        for (const label of labels) {
+            console.log(`  ${(0, colour_js_1.accent)(label.name.padEnd(20))} ${(0, colour_js_1.dim)(`${label.colour}  ${label.open} open${label.description ? `  ${label.description}` : ""}`)}`);
+        }
+        return 0;
+    }
+    if (sub === "rules") {
+        const { rules } = await (0, api_js_1.callApi)(`${base}/issue-rules`);
+        if (!rules.length) {
+            console.log(`${(0, colour_js_1.bold)(project.slug)} has no issue rules. ${(0, colour_js_1.dim)("Add them in the project's Settings, under Issue rules.")}`);
+            return 0;
+        }
+        for (const rule of rules) {
+            console.log(`  ${rule.enabled ? (0, colour_js_1.green)("on ") : (0, colour_js_1.dim)("off")} ${(0, colour_js_1.accent)(rule.kind.padEnd(12))} ${(0, colour_js_1.dim)(JSON.stringify(rule.config))}`);
+        }
+        return 0;
+    }
+    const number = Number((parsed.positional[1] ?? "").replace(/^#/, ""));
+    if (!Number.isInteger(number) || number < 1) {
+        console.error((0, colour_js_1.red)(`Which issue? Try: cbx issue ${sub || "view"} 12`));
+        return 1;
+    }
+    const at = `${base}/issues/${number}`;
+    switch (sub) {
+        case "view": {
+            const thread = await (0, api_js_1.callApi)(at);
+            const issue = thread.issue;
+            console.log(`${(0, colour_js_1.bold)(`#${issue.number} ${issue.title}`)}  ${issue.state === "open" ? (0, colour_js_1.green)("open") : (0, colour_js_1.dim)(`closed${issue.closeReason ? ` (${issue.closeReason.replace("_", " ")}${issue.duplicateOf ? ` of #${issue.duplicateOf}` : ""})` : ""}`)}`);
+            if (issue.labels?.length)
+                console.log((0, colour_js_1.dim)(`  labels: ${issue.labels.map((label) => label.name).join(", ")}`));
+            console.log("");
+            console.log(issue.body || (0, colour_js_1.dim)("(no description)"));
+            const stream = [
+                ...thread.comments.map((comment) => ({ at: comment.createdAt, line: `\n${(0, colour_js_1.accent)(comment.automated ? "Project rule" : comment.author.displayName)} ${(0, colour_js_1.dim)(new Date(comment.createdAt).toLocaleString())}\n${comment.body}` })),
+                ...(thread.events ?? []).filter((event) => event.kind !== "opened").map((event) => ({ at: event.createdAt, line: (0, colour_js_1.dim)(`  · ${eventLine(event)}, ${new Date(event.createdAt).toLocaleString()}`) })),
+            ].sort((a, b) => new Date(a.at).getTime() - new Date(b.at).getTime());
+            for (const item of stream)
+                console.log(item.line);
+            return 0;
+        }
+        case "comment": {
+            const body = text(parsed);
+            if (!body) {
+                console.error((0, colour_js_1.red)('Say something: cbx issue comment 12 -m "Fixed in v41"'));
+                return 1;
+            }
+            await (0, api_js_1.callApi)(`${at}/comments`, { method: "POST", body: { body } });
+            console.log((0, colour_js_1.green)(`Replied on #${number}.`));
+            return 0;
+        }
+        case "close": {
+            const duplicate = parsed.flags.get("duplicate-of");
+            const reasonFlag = parsed.flags.get("reason");
+            const reason = typeof duplicate === "string"
+                ? "duplicate"
+                : typeof reasonFlag === "string"
+                    ? reasonFlag.replace("-", "_")
+                    : "completed";
+            if (!["completed", "not_planned", "duplicate"].includes(reason)) {
+                console.error((0, colour_js_1.red)("A reason is completed, not-planned, or --duplicate-of <n>."));
+                return 1;
+            }
+            await (0, api_js_1.callApi)(at, {
+                method: "PATCH",
+                body: {
+                    state: "closed",
+                    reason,
+                    ...(typeof duplicate === "string" ? { duplicateOf: Number(duplicate.replace(/^#/, "")) } : {}),
+                },
+            });
+            const body = text(parsed);
+            if (body)
+                await (0, api_js_1.callApi)(`${at}/comments`, { method: "POST", body: { body } });
+            console.log((0, colour_js_1.green)(`Closed #${number}${reason === "completed" ? "" : ` (${reason.replace("_", " ")})`}.`));
+            return 0;
+        }
+        case "reopen":
+            await (0, api_js_1.callApi)(at, { method: "PATCH", body: { state: "open" } });
+            console.log((0, colour_js_1.green)(`Reopened #${number}.`));
+            return 0;
+        case "label": {
+            const names = (parsed.positional[2] ?? "").split(",").map((one) => one.trim()).filter(Boolean);
+            if (!names.length) {
+                console.error((0, colour_js_1.red)("Which labels? cbx issue label 12 bug,ui"));
+                return 1;
+            }
+            const remove = parsed.flags.has("remove");
+            for (const name of names) {
+                await (0, api_js_1.callApi)(`${at}/labels/${encodeURIComponent(name)}`, { method: remove ? "DELETE" : "PUT" });
+            }
+            console.log((0, colour_js_1.green)(`${remove ? "Removed" : "Added"} ${names.join(", ")} ${remove ? "from" : "on"} #${number}.`));
+            return 0;
+        }
+        case "assign": {
+            const who = (parsed.positional[2] ?? "").replace(/^@/, "").trim();
+            if (!who) {
+                console.error((0, colour_js_1.red)("To whom? cbx issue assign 12 sam  (or none)"));
+                return 1;
+            }
+            let assigneeUserId = null;
+            if (who !== "none") {
+                const { people } = await (0, api_js_1.callApi)(`${base}/assignable`);
+                const person = people.find((one) => (one.username ?? "").toLowerCase() === who.toLowerCase() || one.name.toLowerCase() === who.toLowerCase());
+                if (!person) {
+                    console.error((0, colour_js_1.red)(`${who} is not on ${project.name}. It can go to: ${people.map((one) => one.username ?? one.name).join(", ")}`));
+                    return 1;
+                }
+                assigneeUserId = person.id;
+            }
+            await (0, api_js_1.callApi)(at, { method: "PATCH", body: { assigneeUserId } });
+            console.log((0, colour_js_1.green)(assigneeUserId ? `#${number} is ${who}'s now.` : `#${number} is nobody's now.`));
+            return 0;
+        }
+        default:
+            console.error((0, colour_js_1.red)(`cbx issue has no "${sub}". `) + "Try: view, comment, close, reopen, label, assign, labels, rules");
+            return 1;
+    }
+}

package/dist/cli/src/pr_command.js

@@ -0,0 +1,318 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandPr = commandPr;
+/**
+ * `cbx pr` — a project's pull requests, from the command line.
+ *
+ * A pull request is a proposal: a line offered to another line (`cbx propose`
+ * opens one). This is the rest of what the website's Pull requests tab does —
+ * the list, one pull request's conversation, files and checks, commenting,
+ * reviewing, labels, drafts, closing and reopening, and merging — so the work
+ * can be reviewed without leaving the terminal.
+ */
+const api_js_1 = require("./api.js");
+const colour_js_1 = require("./colour.js");
+const project_commands_js_1 = require("./project_commands.js");
+const flag = (parsed, ...names) => {
+    for (const name of names) {
+        const value = parsed.flags.get(name);
+        if (typeof value === "string")
+            return value;
+    }
+    return undefined;
+};
+function who(person) {
+    if (!person)
+        return "somebody";
+    return person.username ? `@${person.username}` : person.displayName;
+}
+function stateWord(state) {
+    if (state === "open")
+        return (0, colour_js_1.green)("open");
+    if (state === "merged")
+        return (0, colour_js_1.accent)("merged");
+    if (state === "closed")
+        return (0, colour_js_1.red)("closed");
+    return (0, colour_js_1.dim)(state);
+}
+function checksWord(checks) {
+    if (!checks.total)
+        return "";
+    if (checks.failing)
+        return (0, colour_js_1.red)(`✗ ${checks.failing} failing`);
+    if (checks.pending)
+        return (0, colour_js_1.accent)(`● ${checks.pending} running`);
+    return (0, colour_js_1.green)(`✓ ${checks.passing} passing`);
+}
+/** The pull request a person named (M-3, or 3), on the project they named or this folder's. */
+async function find(parsed, at) {
+    const wanted = parsed.positional[at];
+    if (!wanted) {
+        console.error((0, colour_js_1.red)("Which pull request? Name it like M-3."));
+        return null;
+    }
+    const project = await (0, project_commands_js_1.resolveProject)(flag(parsed, "project"));
+    if (!project)
+        return null;
+    const reference = /^\d+$/.test(wanted) ? `M-${wanted}` : wanted.toUpperCase();
+    const { pulls } = await (0, api_js_1.callApi)(`/v1/repositories/${project.id}/pulls?state=all`);
+    const found = pulls.find((one) => one.reference.toUpperCase() === reference);
+    if (!found) {
+        console.error((0, colour_js_1.red)(`${project.name} has no pull request ${reference}.`));
+        return null;
+    }
+    return { id: found.id, reference: found.reference, projectId: project.id };
+}
+async function list(parsed) {
+    const project = await (0, project_commands_js_1.resolveProject)(parsed.positional[1] ?? flag(parsed, "project"));
+    if (!project)
+        return 1;
+    const query = new URLSearchParams();
+    const state = parsed.flags.has("all") ? "all" : (flag(parsed, "state") ?? "open");
+    query.set("state", state);
+    if (parsed.flags.has("mine"))
+        query.set("review", "me");
+    const label = flag(parsed, "label");
+    if (label)
+        query.set("label", label);
+    const author = flag(parsed, "author");
+    if (author)
+        query.set("author", author);
+    const { pulls, counts } = await (0, api_js_1.callApi)(`/v1/repositories/${project.id}/pulls?${query}`);
+    console.log(`${(0, colour_js_1.bold)(project.name)} ${(0, colour_js_1.dim)(`· ${counts.open} open · ${counts.merged} merged · ${counts.closed} closed`)}`);
+    if (!pulls.length) {
+        console.log((0, colour_js_1.dim)(state === "open" ? "  No open pull requests. Offer a line with cbx propose." : "  Nothing here."));
+        return 0;
+    }
+    for (const pull of pulls) {
+        const flags = [
+            checksWord(pull.checks),
+            pull.conflicts ? (0, colour_js_1.accent)(`${pull.conflicts} to settle`) : "",
+            pull.changesRequested ? (0, colour_js_1.red)("changes asked") : pull.approvals ? (0, colour_js_1.green)(`${pull.approvals} approved`) : "",
+            pull.comments ? (0, colour_js_1.dim)(`${pull.comments} comment${pull.comments === 1 ? "" : "s"}`) : "",
+            pull.labels.length ? (0, colour_js_1.dim)(pull.labels.map((one) => one.name).join(", ")) : "",
+        ].filter(Boolean);
+        console.log(`  ${(0, colour_js_1.accent)(pull.reference.padEnd(6))} ${stateWord(pull.state).padEnd(16)} ${pull.title}`);
+        console.log(`         ${(0, colour_js_1.dim)(`${pull.from} → ${pull.into} · ${who(pull.author)}`)}${flags.length ? `  ${flags.join("  ")}` : ""}`);
+    }
+    console.log("");
+    console.log((0, colour_js_1.dim)("  Read one with: cbx pr view M-3"));
+    return 0;
+}
+async function view(parsed) {
+    const found = await find(parsed, 1);
+    if (!found)
+        return 1;
+    const pull = await (0, api_js_1.callApi)(`/v1/merge-tracks/${found.id}/pull`);
+    console.log(`${(0, colour_js_1.accent)(pull.reference)} ${(0, colour_js_1.bold)(pull.title)}  ${stateWord(pull.state)}`);
+    console.log((0, colour_js_1.dim)(`  ${who(pull.author)} wants to merge ${pull.from} into ${pull.into}`));
+    if (pull.labels.length)
+        console.log((0, colour_js_1.dim)(`  Labels: ${pull.labels.map((one) => one.name).join(", ")}`));
+    if (pull.linkedIssues.length)
+        console.log((0, colour_js_1.dim)(`  Closes: ${pull.linkedIssues.map((one) => `#${one.number}`).join(", ")}`));
+    console.log("");
+    console.log(pull.body?.trim() || (0, colour_js_1.dim)("  No description."));
+    console.log("");
+    if (pull.reviews.length || pull.requested.length) {
+        console.log((0, colour_js_1.bold)("Reviews"));
+        for (const review of pull.reviews) {
+            const verdict = review.dismissed
+                ? (0, colour_js_1.accent)("approval no longer counts")
+                : review.verdict === "approve"
+                    ? (0, colour_js_1.green)("approved")
+                    : review.verdict === "request_changes"
+                        ? (0, colour_js_1.red)("asked for changes")
+                        : "commented";
+            console.log(`  ${who(review.reviewer)} ${verdict}${review.body ? (0, colour_js_1.dim)(` — ${review.body}`) : ""}`);
+        }
+        for (const asked of pull.requested.filter((one) => !one.reviewed)) {
+            console.log(`  @${asked.reviewer?.username ?? "somebody"} ${(0, colour_js_1.dim)("asked, not yet reviewed")}`);
+        }
+        console.log("");
+    }
+    if (pull.checks.length) {
+        console.log((0, colour_js_1.bold)("Checks"));
+        for (const check of pull.checks) {
+            const mark = check.state === "passing" ? (0, colour_js_1.green)("✓") : check.state === "failing" ? (0, colour_js_1.red)("✗") : check.state === "skipped" ? (0, colour_js_1.dim)("–") : (0, colour_js_1.accent)("●");
+            console.log(`  ${mark} ${check.name}${check.required ? (0, colour_js_1.dim)(" (required)") : ""}${check.detail ? (0, colour_js_1.dim)(` — ${check.detail}`) : ""}`);
+        }
+        console.log("");
+    }
+    const roots = pull.comments.filter((comment) => !comment.replyTo);
+    if (roots.length) {
+        console.log((0, colour_js_1.bold)("Conversation"));
+        for (const root of roots) {
+            const where = root.path ? (0, colour_js_1.dim)(` on ${root.path}${root.line ? `:${root.line}` : ""}${root.resolved ? " (resolved)" : ""}`) : "";
+            console.log(`  ${who(root.author)}${where}: ${root.body ?? (0, colour_js_1.dim)("(deleted)")}`);
+            for (const reply of pull.comments.filter((comment) => comment.replyTo === root.id)) {
+                console.log(`    ${who(reply.author)}: ${reply.body ?? (0, colour_js_1.dim)("(deleted)")}`);
+            }
+        }
+        console.log("");
+    }
+    if (pull.state === "open" || pull.state === "draft") {
+        if (pull.blockers.length) {
+            console.log((0, colour_js_1.bold)((0, colour_js_1.accent)("Merging is blocked")));
+            for (const blocker of pull.blockers)
+                console.log(`  · ${blocker.text}`);
+        }
+        else {
+            console.log((0, colour_js_1.green)("Ready to merge.") + (0, colour_js_1.dim)(` cbx pr merge ${pull.reference}`));
+        }
+        if (pull.unresolvedThreads)
+            console.log((0, colour_js_1.dim)(`  ${pull.unresolvedThreads} conversation(s) on lines not yet resolved.`));
+    }
+    return 0;
+}
+async function files(parsed) {
+    const found = await find(parsed, 1);
+    if (!found)
+        return 1;
+    const answer = await (0, api_js_1.callApi)(`/v1/merge-tracks/${found.id}/files`);
+    for (const file of answer.files) {
+        const mark = file.kind === "added" ? (0, colour_js_1.green)("A") : file.kind === "removed" ? (0, colour_js_1.red)("D") : (0, colour_js_1.accent)("M");
+        console.log(`  ${mark} ${file.path}${file.viewed ? (0, colour_js_1.dim)("  (viewed)") : ""}`);
+    }
+    console.log((0, colour_js_1.dim)(`  ${answer.files.length} file${answer.files.length === 1 ? "" : "s"} changed`));
+    return 0;
+}
+async function comment(parsed) {
+    const found = await find(parsed, 1);
+    if (!found)
+        return 1;
+    const body = flag(parsed, "message", "m") ?? parsed.positional.slice(2).join(" ");
+    if (!body.trim()) {
+        console.error((0, colour_js_1.red)('Say something: cbx pr comment M-3 -m "Looks good"'));
+        return 1;
+    }
+    const at = flag(parsed, "line");
+    const [path, line] = at ? [at.slice(0, at.lastIndexOf(":")), Number(at.slice(at.lastIndexOf(":") + 1))] : [undefined, undefined];
+    await (0, api_js_1.callApi)(`/v1/merge-tracks/${found.id}/comments`, {
+        method: "POST",
+        body: { body, ...(path && line ? { path, line, side: "new" } : {}) },
+    });
+    console.log(`${(0, colour_js_1.green)("Commented")} on ${found.reference}${path ? ` (${path}:${line})` : ""}.`);
+    return 0;
+}
+async function review(parsed, verdict) {
+    const found = await find(parsed, 1);
+    if (!found)
+        return 1;
+    const body = flag(parsed, "message", "m");
+    if (verdict === "request_changes" && !body) {
+        console.error((0, colour_js_1.red)('Say what needs changing: cbx pr request-changes M-3 -m "…"'));
+        return 1;
+    }
+    await (0, api_js_1.callApi)(`/v1/merge-tracks/${found.id}/review`, { method: "PUT", body: body ? { verdict, body } : { verdict } });
+    console.log(`${verdict === "approve" ? (0, colour_js_1.green)("Approved") : verdict === "request_changes" ? (0, colour_js_1.red)("Asked for changes on") : "Reviewed"} ${found.reference}.`);
+    return 0;
+}
+async function edit(parsed, change, said) {
+    const found = await find(parsed, 1);
+    if (!found)
+        return 1;
+    await (0, api_js_1.callApi)(`/v1/merge-tracks/${found.id}/pull`, { method: "PATCH", body: change });
+    console.log(`${found.reference} ${said}.`);
+    return 0;
+}
+async function commandPr(parsed) {
+    const sub = parsed.positional[0] ?? "list";
+    switch (sub) {
+        case "list":
+            return list(parsed);
+        case "view":
+            return view(parsed);
+        case "files":
+            return files(parsed);
+        case "comment":
+            return comment(parsed);
+        case "approve":
+            return review(parsed, "approve");
+        case "request-changes":
+            return review(parsed, "request_changes");
+        case "ready":
+            return edit(parsed, { draft: false }, "is ready for review");
+        case "draft":
+            return edit(parsed, { draft: true }, "is a draft again");
+        case "title": {
+            const title = flag(parsed, "message", "m") ?? parsed.positional.slice(2).join(" ");
+            if (!title.trim()) {
+                console.error((0, colour_js_1.red)('Give the new title: cbx pr title M-3 "Better title"'));
+                return 1;
+            }
+            return edit(parsed, { title }, "renamed");
+        }
+        case "retarget": {
+            const into = parsed.positional[2];
+            if (!into) {
+                console.error((0, colour_js_1.red)("Into which line? cbx pr retarget M-3 release"));
+                return 1;
+            }
+            return edit(parsed, { into }, `now lands on ${into}`);
+        }
+        case "label": {
+            const found = await find(parsed, 1);
+            if (!found)
+                return 1;
+            const labels = (parsed.positional[2] ?? "").split(",").map((one) => one.trim()).filter(Boolean);
+            const saved = await (0, api_js_1.callApi)(`/v1/merge-tracks/${found.id}/labels`, { method: "PUT", body: { labels } });
+            console.log(`${found.reference} labels: ${saved.labels.join(", ") || (0, colour_js_1.dim)("none")}`);
+            return 0;
+        }
+        case "ask": {
+            const found = await find(parsed, 1);
+            if (!found)
+                return 1;
+            const names = parsed.positional.slice(2).flatMap((one) => one.split(",")).map((one) => one.trim()).filter(Boolean);
+            const asked = await (0, api_js_1.requestReviews)(found.id, names);
+            console.log(`Asked ${asked.map((person) => person.displayName).join(", ") || "nobody new"} to review ${found.reference}.`);
+            return 0;
+        }
+        case "close": {
+            const found = await find(parsed, 1);
+            if (!found)
+                return 1;
+            await (0, api_js_1.cancelMerge)(found.id);
+            console.log(`${found.reference} closed without merging. The line and its saves are untouched.`);
+            return 0;
+        }
+        case "reopen": {
+            const found = await find(parsed, 1);
+            if (!found)
+                return 1;
+            await (0, api_js_1.callApi)(`/v1/merge-tracks/${found.id}/reopen`, { method: "POST" });
+            console.log(`${found.reference} reopened.`);
+            return 0;
+        }
+        case "merge": {
+            const found = await find(parsed, 1);
+            if (!found)
+                return 1;
+            /* --squash lands it as one save, without the line's own saves in the target's history. */
+            const result = parsed.flags.has("squash")
+                ? await (0, api_js_1.callApi)(`/v1/merge-tracks/${encodeURIComponent(found.id)}/apply?squash=true`, { method: "POST" })
+                : await (0, api_js_1.applyMerge)(found.id);
+            console.log(`${(0, colour_js_1.green)(parsed.flags.has("squash") ? "Squashed and merged" : "Merged")} ${found.reference} as version ${result.version.sequence}.` +
+                (result.closedIssues?.length ? ` Closed ${result.closedIssues.map((n) => `#${n}`).join(", ")}.` : ""));
+            return 0;
+        }
+        case "auto-merge": {
+            /* Merge by itself once nothing stands in the way (backend merge_rules.ts); --off stops it. */
+            const found = await find(parsed, 1);
+            if (!found)
+                return 1;
+            const enabled = !parsed.flags.has("off");
+            await (0, api_js_1.callApi)(`/v1/merge-tracks/${encodeURIComponent(found.id)}/auto-merge`, {
+                method: "PUT",
+                body: { enabled, squash: parsed.flags.has("squash") },
+            });
+            console.log(enabled
+                ? `${(0, colour_js_1.green)("Set.")} ${found.reference} merges by itself once nothing stands in the way${parsed.flags.has("squash") ? ", squashed" : ""}.`
+                : `${(0, colour_js_1.green)("Off.")} ${found.reference} waits for somebody to merge it.`);
+            return 0;
+        }
+        default:
+            console.error((0, colour_js_1.red)(`cbx pr has no "${sub}". `) + "See: " + (0, colour_js_1.accent)("cbx help pr"));
+            return 1;
+    }
+}

package/dist/cli/src/private_command.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandPrivate = commandPrivate;
+/**
+ * `cbx private` — files and folders only the project's own people may see.
+ *
+ * Patterns in the shape of a .gitignore, kept on the project rather than in a
+ * file inside it, so they cover every version from the moment they are set,
+ * old ones included, and a save can never undo them. Visitors, the public
+ * API, git clone, zips and Pages leave those files out; members see them.
+ */
+const api_js_1 = require("./api.js");
+const colour_js_1 = require("./colour.js");
+const project_commands_js_1 = require("./project_commands.js");
+async function commandPrivate(parsed) {
+    const sub = parsed.positional[0] ?? "list";
+    const named = parsed.flags.get("project");
+    const project = await (0, project_commands_js_1.resolveProject)(typeof named === "string" ? named : undefined);
+    if (!project)
+        return 1;
+    const current = await (0, api_js_1.getPrivatePaths)(project.id);
+    if (sub === "list") {
+        if (!current.length) {
+            console.log(`Nothing in ${(0, colour_js_1.bold)(project.slug)} is private on its own.`);
+            console.log((0, colour_js_1.dim)(`  Keep files to the project's people: cbx private add "design/" "*.psd"`));
+            return 0;
+        }
+        console.log((0, colour_js_1.bold)(`Private in ${project.slug}`) + (0, colour_js_1.dim)(" — only the project's people see these"));
+        for (const pattern of current)
+            console.log(`  ${pattern}`);
+        return 0;
+    }
+    const given = parsed.positional.slice(1);
+    if (!given.length) {
+        console.error((0, colour_js_1.red)(`Name at least one pattern: cbx private ${sub} "design/"`));
+        return 1;
+    }
+    let next;
+    if (sub === "add") {
+        next = [...current, ...given.filter((one) => !current.includes(one))];
+    }
+    else if (sub === "remove") {
+        const missing = given.filter((one) => !current.includes(one));
+        if (missing.length) {
+            console.error((0, colour_js_1.red)(`Not in the list: ${missing.join(", ")}. See: cbx private list`));
+            return 1;
+        }
+        next = current.filter((one) => !given.includes(one));
+    }
+    else if (sub === "set") {
+        next = given;
+    }
+    else {
+        console.error((0, colour_js_1.red)(`cbx private has no "${sub}". `) + "See: " + (0, colour_js_1.accent)("cbx help private"));
+        return 1;
+    }
+    const saved = await (0, api_js_1.putPrivatePaths)(project.id, next);
+    console.log(`${(0, colour_js_1.green)("Saved.")} ${saved.length ? `Private in ${(0, colour_js_1.bold)(project.slug)}:` : `Nothing in ${project.slug} is private on its own now.`}`);
+    for (const pattern of saved)
+        console.log(`  ${pattern}`);
+    if (sub !== "remove" && saved.length) {
+        console.log((0, colour_js_1.dim)("  Every version obeys this now, old ones included. Members still see everything."));
+    }
+    return 0;
+}

package/dist/cli/src/project_commands.js

@@ -42,7 +42,8 @@ function bytes(value) {
  * its name every time.
  */
 async function resolveProject(reference) {
-    const wanted = reference ?? (await (0, config_js_1.readLink)(node_process_1.default.cwd()))?.slug;
+    /* Inside a run, the project it is running for (CODEROOK_PROJECT, handed to every run). */
+    const wanted = reference ?? (await (0, config_js_1.readLink)(node_process_1.default.cwd()))?.slug ?? node_process_1.default.env.CODEROOK_PROJECT?.trim();
     if (!wanted) {
         console.error((0, colour_js_1.red)("Which project? Name one, or run this inside a linked folder."));
         return null;