@bitsocial/bitsocial-cli 0.19.46 → 0.19.48

package/README.md

@@ -344,7 +344,7 @@ EXAMPLES
   $ bitsocial challenge install ./my-local-challenge
 ```
 
-_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/challenge/install.ts)_
+_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/challenge/install.ts)_
 
 ## `bitsocial challenge list`
 
@@ -367,7 +367,7 @@ EXAMPLES
   $ bitsocial challenge list -q
 ```
 
-_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/challenge/list.ts)_
+_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/challenge/list.ts)_
 
 ## `bitsocial challenge remove NAME`
 
@@ -392,7 +392,7 @@ EXAMPLES
   $ bitsocial challenge remove @scope/my-challenge
 ```
 
-_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/challenge/remove.ts)_
+_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/challenge/remove.ts)_
 
 ## `bitsocial community create`
 
@@ -422,7 +422,7 @@ EXAMPLES
     $ bitsocial community create --jsonFile ./create-options.json
 ```
 
-_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/create.ts)_
+_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/community/create.ts)_
 
 ## `bitsocial community delete ADDRESSES`
 
@@ -447,7 +447,7 @@ EXAMPLES
   $ bitsocial community delete 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/delete.ts)_
+_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/community/delete.ts)_
 
 ## `bitsocial community edit ADDRESS`
 
@@ -467,10 +467,22 @@ FLAGS
 DESCRIPTION
   Edit a community's properties. For a list of properties, visit https://github.com/pkcprotocol/pkc-js
 
+  Merge behavior with CLI flags:
+  - Objects are merged with the community's current state (new keys are added, existing keys are overwritten).
+  - Arrays are extended: new values are prepended to the existing array.
+  - Setting a value to null removes it (e.g. --roles['mod.bso'] null).
+
+  Merge behavior with --jsonFile:
+  - Objects are merged the same way as CLI flags.
+  - Arrays are replaced entirely (RFC 7396 JSON Merge Patch semantics).
+  - When both --jsonFile and CLI flags are provided, CLI flags take priority.
+
+  For modifying complex settings like challenges, consider using a web UI instead: https://bitsocial.net/apps
+
 EXAMPLES
-  Change the address of the community to a new domain address
+  Change the name of the community
 
-    $ bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --address newAddress.bso
+    $ bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --name newName.bso
 
   Add the author address 'esteban.bso' as an admin on the community
 
@@ -505,7 +517,7 @@ EXAMPLES
     $ bitsocial community edit bitsocial.bso --jsonFile ./edit-options.json
 ```
 
-_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/edit.ts)_
+_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/community/edit.ts)_
 
 ## `bitsocial community get [ADDRESS]`
 
@@ -536,7 +548,7 @@ EXAMPLES
   $ bitsocial community get --publicKey 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/get.ts)_
+_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/community/get.ts)_
 
 ## `bitsocial community list`
 
@@ -559,7 +571,7 @@ EXAMPLES
   $ bitsocial community list
 ```
 
-_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/list.ts)_
+_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/community/list.ts)_
 
 ## `bitsocial community start ADDRESSES`
 
@@ -567,13 +579,14 @@ Start a community
 
 ```
 USAGE
-  $ bitsocial community start ADDRESSES... --pkcRpcUrl <value>
+  $ bitsocial community start ADDRESSES... --pkcRpcUrl <value> [--concurrency <value>]
 
 ARGUMENTS
   ADDRESSES...  Addresses of communities to start. Separated by space
 
 FLAGS
-  --pkcRpcUrl=<value>  (required) [default: ws://localhost:9138/] URL to PKC RPC
+  --concurrency=<value>  [default: 5] Number of communities to start in parallel
+  --pkcRpcUrl=<value>    (required) [default: ws://localhost:9138/] URL to PKC RPC
 
 DESCRIPTION
   Start a community
@@ -586,9 +599,13 @@ EXAMPLES
   Start all communities in your data path
 
     $ bitsocial community start $(bitsocial community list -q)
+
+  Start communities sequentially (no concurrency)
+
+    $ bitsocial community start $(bitsocial community list -q) --concurrency 1
 ```
 
-_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/start.ts)_
+_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/community/start.ts)_
 
 ## `bitsocial community stop ADDRESSES`
 
@@ -613,7 +630,7 @@ EXAMPLES
   $ bitsocial community stop Qmb99crTbSUfKXamXwZBe829Vf6w5w5TktPkb6WstC9RFW
 ```
 
-_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/stop.ts)_
+_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/community/stop.ts)_
 
 ## `bitsocial daemon`
 
@@ -654,7 +671,7 @@ EXAMPLES
   $ bitsocial daemon --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY
 ```
 
-_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/daemon.ts)_
+_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/daemon.ts)_
 
 ## `bitsocial help [COMMAND]`
 
@@ -720,7 +737,7 @@ EXAMPLES
   $ bitsocial logs --stdout -f
 ```
 
-_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/logs.ts)_
+_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/logs.ts)_
 
 ## `bitsocial update check`
 
@@ -737,7 +754,7 @@ EXAMPLES
   $ bitsocial update check
 ```
 
-_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/update/check.ts)_
+_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/update/check.ts)_
 
 ## `bitsocial update install [VERSION]`
 
@@ -769,7 +786,7 @@ EXAMPLES
   $ bitsocial update install --no-restart-daemons
 ```
 
-_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/update/install.ts)_
+_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/update/install.ts)_
 
 ## `bitsocial update versions`
 
@@ -791,7 +808,7 @@ EXAMPLES
   $ bitsocial update versions --limit 5
 ```
 
-_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/update/versions.ts)_
+_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.48/src/cli/commands/update/versions.ts)_
 <!-- commandsstop -->
 
 ## Contribution

package/dist/cli/commands/community/edit.js

@@ -5,7 +5,19 @@ import { BaseCommand } from "../../base-command.js";
 import { PKCLogger, mergeDeep, parseJsoncFile, replaceNullWithUndefined } from "../../../util.js";
 import * as remeda from "remeda";
 export default class Edit extends BaseCommand {
-    static description = "Edit a community's properties. For a list of properties, visit https://github.com/pkcprotocol/pkc-js";
+    static description = `Edit a community's properties. For a list of properties, visit https://github.com/pkcprotocol/pkc-js
+
+Merge behavior with CLI flags:
+  - Objects are merged with the community's current state (new keys are added, existing keys are overwritten).
+  - Arrays are extended: new values are prepended to the existing array.
+  - Setting a value to null removes it (e.g. --roles['mod.bso'] null).
+
+Merge behavior with --jsonFile:
+  - Objects are merged the same way as CLI flags.
+  - Arrays are replaced entirely (RFC 7396 JSON Merge Patch semantics).
+  - When both --jsonFile and CLI flags are provided, CLI flags take priority.
+
+For modifying complex settings like challenges, consider using a web UI instead: https://bitsocial.net/apps`;
     static args = {
         address: Args.string({
             name: "address",
@@ -21,12 +33,9 @@ export default class Edit extends BaseCommand {
         })
     };
     static examples = [
-        // TODO update this to change the name instead
-        // Also are we testing modifying name properly?
-        // in theory user should not modify address, they should modify name
         {
-            description: "Change the address of the community to a new domain address",
-            command: "bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --address newAddress.bso"
+            description: "Change the name of the community",
+            command: "bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --name newName.bso"
         },
         {
             description: "Add the author address 'esteban.bso' as an admin on the community",

package/dist/cli/commands/community/start.d.ts

@@ -5,6 +5,9 @@ export default class Start extends BaseCommand {
     static args: {
         addresses: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
+    static flags: {
+        concurrency: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
     static examples: (string | {
         description: string;
         command: string;

package/dist/cli/commands/community/start.js

@@ -1,6 +1,7 @@
 import { PKCLogger } from "../../../util.js";
 import { BaseCommand } from "../../base-command.js";
-import { Args } from "@oclif/core";
+import { Args, Flags } from "@oclif/core";
+import pLimit from "p-limit";
 export default class Start extends BaseCommand {
     static description = "Start a community";
     static strict = false; // To allow for variable length arguments
@@ -11,12 +12,23 @@ export default class Start extends BaseCommand {
             description: "Addresses of communities to start. Separated by space"
         })
     };
+    static flags = {
+        concurrency: Flags.integer({
+            description: "Number of communities to start in parallel",
+            default: 5,
+            min: 0
+        })
+    };
     static examples = [
         "bitsocial community start plebbit.bso",
         "bitsocial community start 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu",
         {
             description: "Start all communities in your data path",
             command: "bitsocial community start $(bitsocial community list -q)"
+        },
+        {
+            description: "Start communities sequentially (no concurrency)",
+            command: "bitsocial community start $(bitsocial community list -q) --concurrency 1"
         }
     ];
     async run() {
@@ -25,8 +37,11 @@ export default class Start extends BaseCommand {
         const log = PKCLogger("bitsocial-cli:commands:community:start");
         log(`addresses: `, addresses);
         log(`flags: `, flags);
+        const concurrency = Math.max(flags.concurrency, 1);
+        const limit = pLimit(concurrency);
         const pkc = await this._connectToPkcRpc(flags.pkcRpcUrl.toString());
-        for (const address of addresses) {
+        const errors = [];
+        const tasks = addresses.map((address) => limit(async () => {
             try {
                 const community = await pkc.createCommunity({ address });
                 await community.start();
@@ -36,11 +51,16 @@ export default class Start extends BaseCommand {
                 const error = e instanceof Error ? e : new Error(typeof e === "string" ? e : JSON.stringify(e));
                 //@ts-expect-error
                 error.details = { ...error.details, address };
+                errors.push({ address, error });
+            }
+        }));
+        await Promise.all(tasks);
+        await pkc.destroy();
+        if (errors.length > 0) {
+            for (const { error } of errors) {
                 console.error(error);
-                await pkc.destroy();
-                this.exit(1);
             }
+            this.exit(1);
         }
-        await pkc.destroy();
     }
 }

package/dist/cli/commands/update/install.d.ts

@@ -11,6 +11,4 @@ export default class Install extends Command {
     static examples: string[];
     run(): Promise<void>;
     private _restartDaemons;
-    private _connectToRpc;
-    private _reportCommunityStatus;
 }

package/dist/cli/commands/update/install.js

@@ -2,13 +2,9 @@ import { Args, Flags, Command } from "@oclif/core";
 import { spawn } from "child_process";
 import tcpPortUsed from "tcp-port-used";
 import { fetchLatestVersion, installGlobal } from "../../../update/npm-registry.js";
+import { fastInstallGlobal } from "../../../update/fast-update.js";
 import { compareVersions } from "../../../update/semver.js";
 import { getAliveDaemonStates } from "../../../common-utils/daemon-state.js";
-import PKC from "@pkcprotocol/pkc-js";
-const getPKCConnectOverride = () => {
-    const globalWithOverride = globalThis;
-    return globalWithOverride.__PKC_RPC_CONNECT_OVERRIDE;
-};
 export default class Install extends Command {
     static description = "Install a specific version of bitsocial from npm";
     static args = {
@@ -95,11 +91,25 @@ export default class Install extends Command {
             return;
         }
         this.log(`Installing bitsocial-cli@${targetVersion}...`);
-        try {
-            await installGlobal(targetVersion);
+        let installed = false;
+        if (!flags.force) {
+            try {
+                installed = await fastInstallGlobal(targetVersion, this.config.root, (msg) => this.log(msg));
+            }
+            catch {
+                installed = false;
+            }
         }
-        catch (err) {
-            this.error(`Update failed: ${err.message}`, { exit: 1 });
+        if (!installed) {
+            if (!flags.force) {
+                this.log("Falling back to full install...");
+            }
+            try {
+                await installGlobal(targetVersion);
+            }
+            catch (err) {
+                this.error(`Update failed: ${err.message}`, { exit: 1 });
+            }
         }
         this.log(`Installed bitsocial v${targetVersion} (was v${current}).`);
         // Restart daemons with the new binary
@@ -127,68 +137,12 @@ export default class Install extends Command {
             const started = await tcpPortUsed.waitUntilUsed(port, 500, 30000).then(() => true).catch(() => false);
             if (started) {
                 this.log(`  Daemon started (port ${port}).`);
-                await this._reportCommunityStatus(d.pkcRpcUrl);
             }
             else {
                 this.warn(`  Daemon may not have started — port ${port} not responding after 30s. Check logs with: bitsocial logs`);
             }
         }
-    }
-    async _connectToRpc(pkcRpcUrl) {
-        const connectOverride = getPKCConnectOverride();
-        if (connectOverride) {
-            return connectOverride(pkcRpcUrl);
-        }
-        const pkc = await PKC({ pkcRpcClientsOptions: [pkcRpcUrl] });
-        const errors = [];
-        pkc.on("error", (err) => {
-            errors.push(err);
-        });
-        await new Promise((resolve) => {
-            const timeout = setTimeout(() => {
-                pkc.removeListener("communitieschange", handler);
-                resolve();
-            }, 20000);
-            const handler = () => {
-                if (pkc.communities.length > 0) {
-                    pkc.removeListener("communitieschange", handler);
-                    clearTimeout(timeout);
-                    resolve();
-                }
-            };
-            pkc.on("communitieschange", handler);
-        });
-        return pkc;
-    }
-    async _reportCommunityStatus(pkcRpcUrl) {
-        let pkc;
-        try {
-            pkc = await this._connectToRpc(pkcRpcUrl);
-            const communities = pkc.communities;
-            if (communities.length === 0)
-                return;
-            const statuses = await Promise.all(communities.map(async (address) => {
-                const community = await pkc.createCommunity({ address });
-                return community.started;
-            }));
-            const startedCount = statuses.filter(Boolean).length;
-            const total = communities.length;
-            if (startedCount === total) {
-                this.log(`  ${startedCount} ${startedCount === 1 ? "community" : "communities"} started.`);
-            }
-            else if (startedCount > 0) {
-                this.log(`  ${startedCount} of ${total} communities started (remaining still loading).`);
-            }
-            else {
-                this.log(`  ${total} ${total === 1 ? "community" : "communities"} in data path (still loading). Check with: bitsocial community list`);
-            }
-        }
-        catch {
-            this.warn("Could not check community status.");
-        }
-        finally {
-            if (pkc)
-                await pkc.destroy().catch(() => { });
-        }
+        this.log("Check community status with: bitsocial community list");
+        this.log("Check logs with: bitsocial logs");
     }
 }

package/dist/update/fast-update.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Attempt a fast update by downloading only the tarball and reusing node_modules/
+ * and dist/webuis/ from the existing install. Falls back (returns false) if
+ * dependencies changed or any step fails.
+ */
+export declare function fastInstallGlobal(version: string, installRoot: string, log: (msg: string) => void): Promise<boolean>;

package/dist/update/fast-update.js

@@ -0,0 +1,182 @@
+import fs from "node:fs/promises";
+import { createHash } from "node:crypto";
+import { createWriteStream } from "node:fs";
+import path from "node:path";
+import { Readable } from "node:stream";
+import { finished as streamFinished } from "node:stream/promises";
+import decompress from "decompress";
+import { runNpmPack, ensureNpmAvailable } from "../challenge-packages/challenge-utils.js";
+import { PACKAGE_NAME } from "./npm-registry.js";
+/**
+ * Attempt a fast update by downloading only the tarball and reusing node_modules/
+ * and dist/webuis/ from the existing install. Falls back (returns false) if
+ * dependencies changed or any step fails.
+ */
+export async function fastInstallGlobal(version, installRoot, log) {
+    const stagingDir = installRoot + ".__fast_update_staging";
+    const backupDir = installRoot + ".__fast_update_backup";
+    // Phase: cleanup leftovers from any interrupted previous fast-update
+    await fs.rm(stagingDir, { recursive: true, force: true });
+    await fs.rm(backupDir, { recursive: true, force: true });
+    let nodeModulesMoved = false;
+    try {
+        // Phase: download tarball
+        await ensureNpmAvailable();
+        await fs.mkdir(stagingDir, { recursive: true });
+        log("Trying fast update...");
+        const tgzPath = await runNpmPack(`${PACKAGE_NAME}@${version}`, stagingDir);
+        // Phase: extract (strip: 1 removes the "package/" prefix in npm tarballs)
+        await decompress(tgzPath, stagingDir, { strip: 1 });
+        await fs.rm(tgzPath);
+        // Phase: compare dependencies
+        const oldPkg = JSON.parse(await fs.readFile(path.join(installRoot, "package.json"), "utf-8"));
+        const newPkg = JSON.parse(await fs.readFile(path.join(stagingDir, "package.json"), "utf-8"));
+        if (JSON.stringify(oldPkg.dependencies) !== JSON.stringify(newPkg.dependencies)) {
+            log("Dependencies changed, falling back to full install.");
+            await fs.rm(stagingDir, { recursive: true, force: true });
+            return false;
+        }
+        // Phase: reuse node_modules from old install (O(1) rename, same filesystem)
+        try {
+            await fs.rename(path.join(installRoot, "node_modules"), path.join(stagingDir, "node_modules"));
+            nodeModulesMoved = true;
+        }
+        catch (err) {
+            if (err.code === "EXDEV") {
+                log("Cross-device rename, falling back to full install.");
+                await fs.rm(stagingDir, { recursive: true, force: true });
+                return false;
+            }
+            throw err;
+        }
+        // Phase: reuse unchanged webuis, download only changed ones
+        const oldWebuis = oldPkg.webuis ?? [];
+        const newWebuis = newPkg.webuis ?? [];
+        const oldWebuisByUrl = new Map(oldWebuis.map((w) => [w.url, w.sha256OfHtmlZip]));
+        // Move the entire dist/webuis/ directory from old install to staging
+        const oldWebuisDir = path.join(installRoot, "dist", "webuis");
+        const newWebuisDir = path.join(stagingDir, "dist", "webuis");
+        let webuisDirMoved = false;
+        try {
+            await fs.access(oldWebuisDir);
+            await fs.rename(oldWebuisDir, newWebuisDir);
+            webuisDirMoved = true;
+        }
+        catch {
+            // webuis dir missing in old install — will create fresh
+        }
+        // Identify which webui entries changed
+        const changedWebuis = newWebuis.filter((w) => oldWebuisByUrl.get(w.url) !== w.sha256OfHtmlZip);
+        if (changedWebuis.length > 0 && webuisDirMoved) {
+            // Delete subdirectories for changed webuis so they get re-downloaded.
+            // We don't know exact dir names, but we can match by repo name from the URL.
+            const existingDirs = await fs.readdir(newWebuisDir, { withFileTypes: true })
+                .catch(() => []);
+            for (const changed of changedWebuis) {
+                const repoName = extractRepoName(changed.url);
+                if (!repoName)
+                    continue;
+                for (const entry of existingDirs) {
+                    if (entry.isDirectory() && entry.name.toLowerCase().includes(repoName.toLowerCase())) {
+                        await fs.rm(path.join(newWebuisDir, entry.name), { recursive: true, force: true });
+                    }
+                }
+            }
+        }
+        // Phase: atomic swap
+        await fs.rename(installRoot, backupDir);
+        await fs.rename(stagingDir, installRoot);
+        nodeModulesMoved = false; // now part of installRoot, no rollback needed
+        // Phase: download changed/missing webuis
+        if (changedWebuis.length > 0 || !webuisDirMoved) {
+            const webuisDir = path.join(installRoot, "dist", "webuis");
+            await fs.mkdir(webuisDir, { recursive: true });
+            const toDownload = !webuisDirMoved ? newWebuis : changedWebuis;
+            if (toDownload.length > 0) {
+                log(`Downloading ${toDownload.length} changed web UI(s)...`);
+                for (const entry of toDownload) {
+                    try {
+                        await downloadWebui(entry, webuisDir, log);
+                    }
+                    catch (err) {
+                        log(`Warning: failed to download ${entry.url}: ${err.message}`);
+                    }
+                }
+            }
+        }
+        // Phase: cleanup backup
+        await fs.rm(backupDir, { recursive: true, force: true });
+        return true;
+    }
+    catch (err) {
+        // Rollback: restore node_modules if we moved it out
+        if (nodeModulesMoved) {
+            try {
+                await fs.rename(path.join(stagingDir, "node_modules"), path.join(installRoot, "node_modules"));
+            }
+            catch {
+                // best-effort
+            }
+        }
+        // If installRoot was renamed to backup but staging didn't land, restore it
+        try {
+            await fs.access(installRoot);
+        }
+        catch {
+            try {
+                await fs.rename(backupDir, installRoot);
+            }
+            catch {
+                // best-effort
+            }
+        }
+        await fs.rm(stagingDir, { recursive: true, force: true });
+        log(`Fast update failed: ${err.message}`);
+        return false;
+    }
+}
+/** Extract repo name from a GitHub release URL (e.g. "seedit" from ".../plebbit/seedit/releases/tag/v0.5.10") */
+function extractRepoName(url) {
+    const match = url.match(/github\.com\/[^/]+\/([^/]+)\/releases\/tag\//);
+    return match?.[1];
+}
+/** Download a single webui entry — mirrors the logic in bin/postinstall.js */
+async function downloadWebui(entry, webuisDir, log) {
+    const match = entry.url.match(/github\.com\/([^/]+\/[^/]+)\/releases\/tag\/(.+)$/);
+    if (!match)
+        throw new Error(`Could not parse GitHub release URL: ${entry.url}`);
+    const [, ownerRepo, tag] = match;
+    const githubToken = process.env["GITHUB_TOKEN"];
+    const headers = {};
+    if (githubToken)
+        headers["authorization"] = `Bearer ${githubToken}`;
+    const releaseReq = await fetch(`https://api.github.com/repos/${ownerRepo}/releases/tags/${tag}`, { headers });
+    if (!releaseReq.ok)
+        throw new Error(`Failed to fetch release ${ownerRepo}@${tag}, status ${releaseReq.status}`);
+    const release = await releaseReq.json();
+    const htmlZipAsset = release.assets.find((asset) => asset.name.includes("html"));
+    if (!htmlZipAsset)
+        throw new Error(`No HTML zip asset in ${ownerRepo}@${tag}`);
+    const zipfilePath = path.join(webuisDir, htmlZipAsset.name);
+    const downloadReq = await fetch(htmlZipAsset["browser_download_url"], { headers });
+    if (!downloadReq.ok || !downloadReq.body)
+        throw new Error(`Failed to download ${htmlZipAsset.name}, status ${downloadReq.status}`);
+    const writer = createWriteStream(zipfilePath);
+    await streamFinished(Readable.fromWeb(downloadReq.body).pipe(writer));
+    writer.close();
+    // Verify SHA-256 checksum
+    const fileBuffer = await fs.readFile(zipfilePath);
+    const actualHash = createHash("sha256").update(fileBuffer).digest("hex");
+    if (actualHash !== entry.sha256OfHtmlZip) {
+        await fs.rm(zipfilePath);
+        throw new Error(`SHA-256 mismatch for ${htmlZipAsset.name}! Expected: ${entry.sha256OfHtmlZip}, Actual: ${actualHash}`);
+    }
+    await decompress(zipfilePath, webuisDir);
+    await fs.rm(zipfilePath);
+    // Rename index.html to prevent access to unconfigured version
+    const extractedDirName = htmlZipAsset.name.replace(".zip", "");
+    const indexPath = path.join(webuisDir, extractedDirName, "index.html");
+    const backupPath = path.join(webuisDir, extractedDirName, "index_backup_no_rpc.html");
+    await fs.rename(indexPath, backupPath);
+    log(`Downloaded ${ownerRepo}@${tag}`);
+}

package/dist/update/npm-registry.d.ts

@@ -1,3 +1,4 @@
+export declare const PACKAGE_NAME = "@bitsocial/bitsocial-cli";
 /** Query npm registry for the latest published version. */
 export declare function fetchLatestVersion(): Promise<string>;
 /** Query npm registry for all published versions (oldest-first). */

package/dist/update/npm-registry.js

@@ -1,6 +1,6 @@
 import { spawn } from "child_process";
 import { getNpmCliPath, getNpmEnv, ensureNpmAvailable } from "../challenge-packages/challenge-utils.js";
-const PACKAGE_NAME = "@bitsocial/bitsocial-cli";
+export const PACKAGE_NAME = "@bitsocial/bitsocial-cli";
 function runNpmView(args) {
     return new Promise(async (resolve, reject) => {
         const npmCliPath = await getNpmCliPath();

package/oclif.manifest.json

@@ -388,11 +388,11 @@
           "required": true
         }
       },
-      "description": "Edit a community's properties. For a list of properties, visit https://github.com/pkcprotocol/pkc-js",
+      "description": "Edit a community's properties. For a list of properties, visit https://github.com/pkcprotocol/pkc-js\n\nMerge behavior with CLI flags:\n  - Objects are merged with the community's current state (new keys are added, existing keys are overwritten).\n  - Arrays are extended: new values are prepended to the existing array.\n  - Setting a value to null removes it (e.g. --roles['mod.bso'] null).\n\nMerge behavior with --jsonFile:\n  - Objects are merged the same way as CLI flags.\n  - Arrays are replaced entirely (RFC 7396 JSON Merge Patch semantics).\n  - When both --jsonFile and CLI flags are provided, CLI flags take priority.\n\nFor modifying complex settings like challenges, consider using a web UI instead: https://bitsocial.net/apps",
       "examples": [
         {
-          "description": "Change the address of the community to a new domain address",
-          "command": "bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --address newAddress.bso"
+          "description": "Change the name of the community",
+          "command": "bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --name newName.bso"
         },
         {
           "description": "Add the author address 'esteban.bso' as an admin on the community",
@@ -576,6 +576,10 @@
         {
           "description": "Start all communities in your data path",
           "command": "bitsocial community start $(bitsocial community list -q)"
+        },
+        {
+          "description": "Start communities sequentially (no concurrency)",
+          "command": "bitsocial community start $(bitsocial community list -q) --concurrency 1"
         }
       ],
       "flags": {
@@ -587,6 +591,14 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "concurrency": {
+          "description": "Number of communities to start in parallel",
+          "name": "concurrency",
+          "default": 5,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -758,5 +770,5 @@
       ]
     }
   },
-  "version": "0.19.46"
+  "version": "0.19.48"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bitsocial/bitsocial-cli",
-    "version": "0.19.46",
+    "version": "0.19.48",
     "description": "Command line interface to Bitsocial API",
     "types": "./dist/index.d.ts",
     "homepage": "https://github.com/bitsocialnet/bitsocial-cli",
@@ -118,13 +118,14 @@
         "@oclif/plugin-help": "6.2.36",
         "@oclif/plugin-not-found": "3.2.73",
         "@oclif/table": "0.5.1",
-        "@pkcprotocol/pkc-js": "0.0.17",
+        "@pkcprotocol/pkc-js": "0.0.19",
         "dataobject-parser": "1.2.22",
         "decompress": "4.2.1",
         "env-paths": "2.2.1",
         "exit-hook": "4.0.0",
         "express": "4.19.2",
         "kubo": "0.40.1",
+        "p-limit": "7.3.0",
         "strip-json-comments": "5.0.3",
         "tcp-port-used": "1.0.2",
         "tslib": "2.6.2",