@coderook/cli 0.44.0 → 0.45.0

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "coderook",
   "displayName": "CodeRook",
   "description": "Save, browse and restore whole-snapshot versions of a project on CodeRook, with cbx or plain git, from Claude Code.",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "author": {
     "name": "ACCA Gaming Productions",
     "url": "https://coderook.com"

package/dist/cli/src/api.js

@@ -427,6 +427,8 @@ async function aiAccess(repositoryId) {
     const allowed = (key) => ai[key] !== false;
     return {
         aiRead: allowed("read"),
+        /* The one answer that starts as no: a service that does not send it has not been asked. */
+        aiTrain: ai.train === true,
         aiDownload: allowed("download"),
         aiContribute: allowed("contribute"),
         aiRequest: allowed("request"),

package/dist/cli/src/cli.js

@@ -33,6 +33,7 @@ const upload_progress_js_1 = require("./upload_progress.js");
 const publish_js_1 = require("./publish.js");
 const attach_command_js_1 = require("./attach_command.js");
 const build_command_js_1 = require("./build_command.js");
+const update_command_js_1 = require("./update_command.js");
 const node_check_js_1 = require("./node_check.js");
 const pages_command_js_1 = require("./pages_command.js");
 const mods_command_js_1 = require("./mods_command.js");
@@ -4050,6 +4051,23 @@ const SPECS = [
         examples: ["claude mcp add coderook -- cbx mcp"],
         run: parsed => parsed.flags.has("workspaces") ? (0, workspace_command_js_1.commandWorkspaceMcp)() : (0, mcp_js_1.commandMcp)(version_js_1.VERSION),
     },
+    {
+        name: "update",
+        aliases: ["upgrade"],
+        group: "Getting started",
+        summary: "install the newest cbx",
+        usage: "update",
+        options: [
+            { flags: "--check", description: "only say whether a newer cbx is out" },
+        ],
+        detail: "Updates cbx itself, not a folder: `cbx get` brings a project's files\n" +
+            "up to date. Asks the npm registry for the newest @coderook/cli and\n" +
+            "installs it the way this copy was installed: globally with npm, or in\n" +
+            "the project whose packages hold it. Through npx there is nothing to\n" +
+            "install. Your folders, sign-in and settings are left as they are.",
+        examples: ["cbx update", "cbx update --check"],
+        run: parsed => (0, update_command_js_1.commandUpdate)(parsed.flags),
+    },
     {
         name: "doctor",
         group: "Getting started",

package/dist/cli/src/project_commands.js

@@ -56,13 +56,19 @@ async function resolveProject(reference) {
     }
     return project;
 }
-/** The four answers, in the order the site shows them. */
+/** The answers, in the order the site shows them. */
 const AI_SWITCHES = [
     [
         "read",
         "aiRead",
         "Can AI read this?",
-        "reading, indexing, summarising and model training",
+        "reading, indexing, summarising and quoting in answers",
+    ],
+    [
+        "train",
+        "aiTrain",
+        "Can AI train on this?",
+        "using what it reads to train a model",
     ],
     [
         "download",
@@ -122,8 +128,8 @@ async function commandAi(parsed) {
         console.log(`  ${(0, colour_js_1.dim)(meaning)}`);
     }
     console.log("");
-    console.log((0, colour_js_1.dim)("Everything is allowed until somebody says otherwise. Reading off is the one"));
-    console.log((0, colour_js_1.dim)("that refuses model training."));
+    console.log((0, colour_js_1.dim)("Everything but training is allowed until somebody says otherwise; training"));
+    console.log((0, colour_js_1.dim)("is refused until the owner allows it, and reading off refuses it too."));
     console.log((0, colour_js_1.dim)("Change these on the website (Settings → Access & AI) or in the desktop app."));
     return 0;
 }

package/dist/cli/src/registry.js

@@ -37,7 +37,7 @@ exports.GROUP_ORDER = [
  * from this list still appears, after the ones that are in it.
  */
 exports.LISTING_ORDER = [
-    "sign-in", "whoami", "sign-out", "doctor", "projects", "clone", "link", "unlink", "import", "transfer",
+    "sign-in", "whoami", "sign-out", "doctor", "update", "projects", "clone", "link", "unlink", "import", "transfer",
     "status", "submit", "diff", "get", "track", "ignore", "licence",
     "init", "save", "log", "restore", "switch", "push", "pull",
     "tracks", "line-rules", "merges", "merge", "propose", "proposals", "pr",

package/dist/cli/src/update_command.js

@@ -0,0 +1,159 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareVersions = compareVersions;
+exports.installKind = installKind;
+exports.projectFolder = projectFolder;
+exports.commandUpdate = commandUpdate;
+/**
+ * `cbx update` — bring this copy of cbx itself up to the newest release.
+ *
+ * Not the folder: `cbx get` (and `cbx pull`) bring a project's files up to
+ * date. This asks the npm registry for the newest @coderook/cli and installs it
+ * the way this copy was installed, because the right command differs:
+ *
+ *   global npm install   npm install -g @coderook/cli@<newest>, run here
+ *   npx                  nothing to install; npx fetches what it is told to
+ *   a project's packages npm install @coderook/cli@<newest> in that project
+ *   anything else        the command to run, printed rather than guessed at
+ *
+ * Every outward call has a deadline, so a registry or npm that never answers
+ * ends in a message instead of a hang.
+ */
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const node_process_1 = __importDefault(require("node:process"));
+const version_js_1 = require("./version.js");
+const PACKAGE = "@coderook/cli";
+/** A release number and nothing else: it is put on an npm command line. */
+const RELEASE = /^\d{1,6}\.\d{1,6}\.\d{1,6}(?:-[0-9A-Za-z.]{1,40})?$/;
+const REGISTRY = "https://registry.npmjs.org/" + PACKAGE.replace("/", "%2F") + "/latest";
+const colour = node_process_1.default.stdout.isTTY && !node_process_1.default.env.NO_COLOR;
+const paint = (code) => (text) => (colour ? `\x1b[${code}m${text}\x1b[0m` : text);
+const dim = paint(2), accent = paint(33), red = paint(31), green = paint(32);
+/** Compares two release numbers (1.2.3, pre-release tags rank below the release). Negative when a is older. */
+function compareVersions(a, b) {
+    const parse = (v) => {
+        const [core = "", pre = ""] = v.trim().replace(/^v/, "").split("-", 2);
+        return { parts: core.split(".").map((n) => Number.parseInt(n, 10) || 0), pre };
+    };
+    const x = parse(a), y = parse(b);
+    for (let i = 0; i < 3; i += 1) {
+        const d = (x.parts[i] ?? 0) - (y.parts[i] ?? 0);
+        if (d)
+            return d;
+    }
+    if (x.pre === y.pre)
+        return 0;
+    if (!x.pre)
+        return 1;
+    if (!y.pre)
+        return -1;
+    return x.pre < y.pre ? -1 : 1;
+}
+/**
+ * How the running copy was installed, from where its files are.
+ * `globalRoot` is `npm root -g` (null when npm could not say).
+ */
+function installKind(script, globalRoot, platform = node_process_1.default.platform) {
+    const norm = (p) => {
+        const s = p.replace(/\\/g, "/").replace(/\/+$/, "");
+        return platform === "win32" ? s.toLowerCase() : s;
+    };
+    const here = norm(script);
+    if (!here.includes("/node_modules/@coderook/cli/"))
+        return "other";
+    if (/\/_npx\//.test(here))
+        return "npx";
+    if (globalRoot && here.startsWith(norm(globalRoot) + "/"))
+        return "global";
+    return "project";
+}
+/** The folder holding the node_modules this copy sits in (for a project install). */
+function projectFolder(script) {
+    const s = script.replace(/\\/g, "/");
+    const at = s.lastIndexOf("/node_modules/@coderook/cli/");
+    return at < 0 ? node_path_1.default.dirname(script) : s.slice(0, at);
+}
+async function newestRelease() {
+    const response = await fetch(REGISTRY, { signal: AbortSignal.timeout(10_000), headers: { accept: "application/json" } });
+    if (!response.ok)
+        throw new Error(`the npm registry answered ${response.status}`);
+    const body = (await response.json());
+    if (typeof body.version !== "string" || !RELEASE.test(body.version))
+        throw new Error("the npm registry gave no usable version");
+    return body.version;
+}
+/** Runs npm with a deadline; output goes to this terminal when `show` is set. */
+function npm(args, options) {
+    return new Promise((resolve) => {
+        /*
+          npm is npm.cmd on Windows, which Node only starts through a shell, and a
+          shell takes one command line rather than an argument list. Every word
+          here is ours or a release number checked by RELEASE, so joining is safe.
+        */
+        const stdio = options.show ? ["inherit", "inherit", "inherit"] : ["ignore", "pipe", "ignore"];
+        const child = node_process_1.default.platform === "win32"
+            ? (0, node_child_process_1.spawn)(["npm", ...args].join(" "), { cwd: options.cwd, shell: true, stdio })
+            : (0, node_child_process_1.spawn)("npm", args, { cwd: options.cwd, stdio });
+        let out = "";
+        child.stdout?.on("data", (chunk) => { out += chunk.toString(); });
+        const timer = setTimeout(() => { child.kill(); resolve({ code: -1, out }); }, options.deadlineMs);
+        child.on("error", () => { clearTimeout(timer); resolve({ code: -2, out }); });
+        child.on("close", (code) => { clearTimeout(timer); resolve({ code: code ?? 1, out }); });
+    });
+}
+async function commandUpdate(flags) {
+    const checkOnly = flags.has("check");
+    let newest;
+    try {
+        newest = await newestRelease();
+    }
+    catch (error) {
+        console.error(red("Could not find out the newest cbx: " + (error instanceof Error ? error.message : String(error)) + "."));
+        console.error(dim("Check the connection and try again. Nothing was changed."));
+        return 1;
+    }
+    const order = compareVersions(version_js_1.VERSION, newest);
+    if (order >= 0) {
+        console.log(green(`cbx ${version_js_1.VERSION} is the newest.`) + (order > 0 ? dim(` (the registry's newest is ${newest})`) : ""));
+        return 0;
+    }
+    console.log(`cbx ${version_js_1.VERSION} is installed; ${accent(newest)} is out.`);
+    let script = node_process_1.default.argv[1] ?? "";
+    try {
+        script = (0, node_fs_1.realpathSync)(script);
+    }
+    catch { /* keep what we were given */ }
+    const root = await npm(["root", "-g"], { show: false, deadlineMs: 20_000 });
+    const kind = installKind(script, root.code === 0 ? root.out.trim() : null);
+    const target = `${PACKAGE}@${newest}`;
+    if (kind === "npx") {
+        console.log(`This copy runs through npx. Ask for the newest each time with ${accent(`npx ${PACKAGE}@latest`)}.`);
+        return 0;
+    }
+    if (kind === "other") {
+        console.log(`This copy was not installed by npm, so install the newest with ${accent(`npm install -g ${target}`)}.`);
+        return 0;
+    }
+    const folder = kind === "project" ? projectFolder(script) : undefined;
+    const args = kind === "global" ? ["install", "-g", target] : ["install", target];
+    if (checkOnly) {
+        console.log(`Update with ${accent("cbx update")}, or ${accent("npm " + args.join(" "))}${folder ? dim(` in ${folder}`) : ""}.`);
+        return 0;
+    }
+    console.log(dim(`Running npm ${args.join(" ")}${folder ? ` in ${folder}` : ""}…`));
+    const result = await npm(args, { show: true, cwd: folder, deadlineMs: 5 * 60_000 });
+    if (result.code !== 0) {
+        console.error(red(result.code === -1 ? "npm did not finish within five minutes." : result.code === -2 ? "npm could not be started." : `npm stopped with code ${result.code}.`));
+        if (kind === "global")
+            console.error(dim("If it was refused for permissions, run the same command from a terminal that can install global packages."));
+        console.error(dim(`Your current cbx ${version_js_1.VERSION} is untouched.`));
+        return 1;
+    }
+    console.log(green(`cbx is now ${newest}.`) + dim(" Your folders, sign-in and settings are as they were."));
+    return 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coderook/cli",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "description": "The command line for CodeRook (coderook.com): version control and project hosting for projects of any size. Every save is a compressed snapshot, private or public, never used to train AI.",
   "license": "Apache-2.0",
   "homepage": "https://coderook.com",