@bitsocial/bitsocial-cli 0.19.44 → 0.19.46

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.44/src/cli/commands/challenge/install.ts)_
+_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/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.44/src/cli/commands/challenge/list.ts)_
+_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/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.44/src/cli/commands/challenge/remove.ts)_
+_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/challenge/remove.ts)_
 
 ## `bitsocial community create`
 
@@ -400,12 +400,13 @@ Create a community with specific properties. A newly created community will be s
 
 ```
 USAGE
-  $ bitsocial community create --pkcRpcUrl <value> [--privateKeyPath <value>]
+  $ bitsocial community create --pkcRpcUrl <value> [--privateKeyPath <value>] [-f <value>]
 
 FLAGS
-  --pkcRpcUrl=<value>       (required) [default: ws://localhost:9138/] URL to PKC RPC
-  --privateKeyPath=<value>  Private key (PEM) of the community signer that will be used to determine address (if address
-                            is not a domain). If it's not provided then PKC will generate a private key
+  -f, --jsonFile=<value>        Path to a JSON/JSONC file containing create options (supports comments)
+      --pkcRpcUrl=<value>       (required) [default: ws://localhost:9138/] URL to PKC RPC
+      --privateKeyPath=<value>  Private key (PEM) of the community signer that will be used to determine address (if
+                                address is not a domain). If it's not provided then PKC will generate a private key
 
 DESCRIPTION
   Create a community with specific properties. A newly created community will be started after creation and be able to
@@ -415,9 +416,13 @@ EXAMPLES
   Create a community with title 'Hello Plebs' and description 'Welcome'
 
     $ bitsocial community create --title 'Hello Plebs' --description 'Welcome'
+
+  Create a community using options from a JSON/JSONC file
+
+    $ bitsocial community create --jsonFile ./create-options.json
 ```
 
-_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.44/src/cli/commands/community/create.ts)_
+_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/create.ts)_
 
 ## `bitsocial community delete ADDRESSES`
 
@@ -442,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.44/src/cli/commands/community/delete.ts)_
+_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/delete.ts)_
 
 ## `bitsocial community edit ADDRESS`
 
@@ -450,13 +455,14 @@ Edit a community's properties. For a list of properties, visit https://github.co
 
 ```
 USAGE
-  $ bitsocial community edit ADDRESS --pkcRpcUrl <value>
+  $ bitsocial community edit ADDRESS --pkcRpcUrl <value> [-f <value>]
 
 ARGUMENTS
-  ADDRESS  Address of the community to edit
+  ADDRESS  Address of the community to edit. It could be the name domain, or a public key
 
 FLAGS
-  --pkcRpcUrl=<value>  (required) [default: ws://localhost:9138/] URL to PKC RPC
+  -f, --jsonFile=<value>   Path to a JSON/JSONC file containing edit options (supports comments)
+      --pkcRpcUrl=<value>  (required) [default: ws://localhost:9138/] URL to PKC RPC
 
 DESCRIPTION
   Edit a community's properties. For a list of properties, visit https://github.com/pkcprotocol/pkc-js
@@ -468,33 +474,38 @@ EXAMPLES
 
   Add the author address 'esteban.bso' as an admin on the community
 
-    $ bitsocial community edit mysub.bso '--roles["esteban.bso"].role' admin
+    $ bitsocial community edit mycommunity.bso '--roles["esteban.bso"].role' admin
 
   Add two challenges to the community. The first challenge will be a question and answer, and the second will be an
   image captcha
 
-    $ bitsocial community edit mysub.bso --settings.challenges[0].name question \
+    $ bitsocial community edit mycommunity.bso --settings.challenges[0].name question \
       --settings.challenges[0].options.question "what is the password?" --settings.challenges[0].options.answer \
       thepassword --settings.challenges[1].name captcha-canvas-v3
 
   Change the title and description
 
-    $ bitsocial community edit mysub.bso --title "This is the new title" --description "This is the new description"
+    $ bitsocial community edit mycommunity.bso --title "This is the new title" --description "This is the new \
+      description"
 
   Remove a role from a moderator/admin/owner
 
-    $ bitsocial community edit plebbit.bso --roles['rinse12.bso'] null
+    $ bitsocial community edit bitsocial.bso --roles['rinse12.bso'] null
 
   Enable settings.fetchThumbnailUrls to fetch the thumbnail of url submitted by authors
 
-    $ bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls
+    $ bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls
 
   disable settings.fetchThumbnailUrls
 
-    $ bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls=false
+    $ bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls=false
+
+  Edit a community using options from a JSON/JSONC file
+
+    $ 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.44/src/cli/commands/community/edit.ts)_
+_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/edit.ts)_
 
 ## `bitsocial community get [ADDRESS]`
 
@@ -525,7 +536,7 @@ EXAMPLES
   $ bitsocial community get --publicKey 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.44/src/cli/commands/community/get.ts)_
+_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/get.ts)_
 
 ## `bitsocial community list`
 
@@ -548,7 +559,7 @@ EXAMPLES
   $ bitsocial community list
 ```
 
-_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.44/src/cli/commands/community/list.ts)_
+_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/list.ts)_
 
 ## `bitsocial community start ADDRESSES`
 
@@ -577,7 +588,7 @@ EXAMPLES
     $ bitsocial community start $(bitsocial community list -q)
 ```
 
-_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.44/src/cli/commands/community/start.ts)_
+_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/start.ts)_
 
 ## `bitsocial community stop ADDRESSES`
 
@@ -602,7 +613,7 @@ EXAMPLES
   $ bitsocial community stop Qmb99crTbSUfKXamXwZBe829Vf6w5w5TktPkb6WstC9RFW
 ```
 
-_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.44/src/cli/commands/community/stop.ts)_
+_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/community/stop.ts)_
 
 ## `bitsocial daemon`
 
@@ -643,7 +654,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.44/src/cli/commands/daemon.ts)_
+_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/daemon.ts)_
 
 ## `bitsocial help [COMMAND]`
 
@@ -671,7 +682,8 @@ View the latest BitSocial daemon log file. By default dumps the full log and exi
 
 ```
 USAGE
-  $ bitsocial logs [-f] [-n <value>] [--since <value>] [--until <value>] [--logPath <value>]
+  $ bitsocial logs [-f] [-n <value>] [--since <value>] [--until <value>] [--logPath <value>] [--stdout |
+    --stderr]
 
 FLAGS
   -f, --follow           Follow log output in real-time (like tail -f)
@@ -679,6 +691,8 @@ FLAGS
       --logPath=<value>  Specify the directory containing log files
       --since=<value>    Show logs since timestamp (ISO 8601, e.g. 2026-01-02T13:23:37Z) or relative time (e.g. 30s,
                          42m, 2h, 1d)
+      --stderr           Show only stderr log entries (output of pkc-logger library)
+      --stdout           Show only stdout log entries
       --until=<value>    Show logs before timestamp (ISO 8601, e.g. 2026-01-02T13:23:37Z) or relative time (e.g. 30s,
                          42m, 2h, 1d)
 
@@ -698,9 +712,15 @@ EXAMPLES
   $ bitsocial logs --since 2026-01-02T13:23:37Z --until 2026-01-02T14:00:00Z
 
   $ bitsocial logs --since 1h -f
+
+  $ bitsocial logs --stdout
+
+  $ bitsocial logs --stderr
+
+  $ bitsocial logs --stdout -f
 ```
 
-_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.44/src/cli/commands/logs.ts)_
+_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/logs.ts)_
 
 ## `bitsocial update check`
 
@@ -717,7 +737,7 @@ EXAMPLES
   $ bitsocial update check
 ```
 
-_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.44/src/cli/commands/update/check.ts)_
+_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/update/check.ts)_
 
 ## `bitsocial update install [VERSION]`
 
@@ -749,7 +769,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.44/src/cli/commands/update/install.ts)_
+_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/update/install.ts)_
 
 ## `bitsocial update versions`
 
@@ -771,7 +791,7 @@ EXAMPLES
   $ bitsocial update versions --limit 5
 ```
 
-_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.44/src/cli/commands/update/versions.ts)_
+_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.46/src/cli/commands/update/versions.ts)_
 <!-- commandsstop -->
 
 ## Contribution

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

@@ -7,6 +7,7 @@ export default class Create extends BaseCommand {
     }[];
     static flags: {
         privateKeyPath: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        jsonFile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

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

@@ -3,7 +3,7 @@ import { Flags } from "@oclif/core";
 import DataObjectParser from "dataobject-parser";
 import fs from "fs";
 import { BaseCommand } from "../../base-command.js";
-import { PKCLogger } from "../../../util.js";
+import { PKCLogger, mergeDeep, parseJsoncFile } from "../../../util.js";
 import * as remeda from "remeda";
 export default class Create extends BaseCommand {
     static description = "Create a community with specific properties. A newly created community will be started after creation and be able to receive publications. For a list of properties, visit https://github.com/pkcprotocol/pkc-js";
@@ -11,12 +11,21 @@ export default class Create extends BaseCommand {
         {
             description: "Create a community with title 'Hello Plebs' and description 'Welcome'",
             command: "<%= config.bin %> <%= command.id %> --title 'Hello Plebs' --description 'Welcome'"
+        },
+        {
+            description: "Create a community using options from a JSON/JSONC file",
+            command: "<%= config.bin %> <%= command.id %> --jsonFile ./create-options.json"
         }
     ];
     static flags = {
         privateKeyPath: Flags.file({
             exists: true,
             description: "Private key (PEM) of the community signer that will be used to determine address (if address is not a domain). If it's not provided then PKC will generate a private key"
+        }),
+        jsonFile: Flags.file({
+            char: "f",
+            exists: true,
+            description: "Path to a JSON/JSONC file containing create options (supports comments)"
         })
     };
     async run() {
@@ -24,7 +33,34 @@ export default class Create extends BaseCommand {
         const log = PKCLogger("bitsocial-cli:commands:community:create");
         log(`flags: `, flags);
         const pkc = await this._connectToPkcRpc(flags.pkcRpcUrl.toString());
-        const createOptions = DataObjectParser.transpose(remeda.omit(flags, ["pkcRpcUrl", "privateKeyPath"]))["_data"];
+        const cliCreateOptions = DataObjectParser.transpose(remeda.omit(flags, ["pkcRpcUrl", "privateKeyPath", "jsonFile"]))["_data"];
+        // Parse JSONC file if provided
+        let jsonFileOptions = {};
+        if (flags.jsonFile) {
+            try {
+                jsonFileOptions = await parseJsoncFile(flags.jsonFile);
+                log("JSONC file options parsed:", jsonFileOptions);
+            }
+            catch (e) {
+                if (e instanceof Error) {
+                    await pkc.destroy();
+                    this.error(e.message);
+                }
+                throw e;
+            }
+        }
+        // Merge: JSON file options first, then CLI flags override
+        let createOptions;
+        if (flags.jsonFile && Object.keys(cliCreateOptions).length > 0) {
+            createOptions = mergeDeep(jsonFileOptions, cliCreateOptions);
+        }
+        else if (flags.jsonFile) {
+            createOptions = jsonFileOptions;
+        }
+        else {
+            createOptions = cliCreateOptions;
+        }
+        log("Final create options:", createOptions);
         if (flags.privateKeyPath)
             try {
                 //@ts-expect-error

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

@@ -4,6 +4,9 @@ export default class Edit extends BaseCommand {
     static args: {
         address: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
+    static flags: {
+        jsonFile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     static examples: {
         description: string;
         command: string;

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

@@ -1,8 +1,8 @@
 //@ts-expect-error
 import DataObjectParser from "dataobject-parser";
-import { Args } from "@oclif/core";
+import { Args, Flags } from "@oclif/core";
 import { BaseCommand } from "../../base-command.js";
-import { PKCLogger, mergeDeep } from "../../../util.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";
@@ -10,37 +10,51 @@ export default class Edit extends BaseCommand {
         address: Args.string({
             name: "address",
             required: true,
-            description: "Address of the community to edit"
+            description: "Address of the community to edit. It could be the name domain, or a public key"
+        })
+    };
+    static flags = {
+        jsonFile: Flags.file({
+            char: "f",
+            exists: true,
+            description: "Path to a JSON/JSONC file containing edit options (supports comments)"
         })
     };
     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: "Add the author address 'esteban.bso' as an admin on the community",
-            command: `bitsocial community edit mysub.bso '--roles["esteban.bso"].role' admin`
+            command: `bitsocial community edit mycommunity.bso '--roles["esteban.bso"].role' admin`
         },
         {
             description: "Add two challenges to the community. The first challenge will be a question and answer, and the second will be an image captcha",
-            command: `bitsocial community edit mysub.bso --settings.challenges[0].name question --settings.challenges[0].options.question "what is the password?" --settings.challenges[0].options.answer thepassword --settings.challenges[1].name captcha-canvas-v3`
+            command: `bitsocial community edit mycommunity.bso --settings.challenges[0].name question --settings.challenges[0].options.question "what is the password?" --settings.challenges[0].options.answer thepassword --settings.challenges[1].name captcha-canvas-v3`
         },
         {
             description: "Change the title and description",
-            command: `bitsocial community edit mysub.bso --title "This is the new title" --description "This is the new description" `
+            command: `bitsocial community edit mycommunity.bso --title "This is the new title" --description "This is the new description" `
         },
         {
             description: "Remove a role from a moderator/admin/owner",
-            command: "bitsocial community edit plebbit.bso --roles['rinse12.bso'] null"
+            command: "bitsocial community edit bitsocial.bso --roles['rinse12.bso'] null"
         },
         {
             description: "Enable settings.fetchThumbnailUrls to fetch the thumbnail of url submitted by authors",
-            command: "bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls"
+            command: "bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls"
         },
         {
             description: "disable settings.fetchThumbnailUrls",
-            command: "bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls=false"
+            command: "bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls=false"
+        },
+        {
+            description: "Edit a community using options from a JSON/JSONC file",
+            command: "bitsocial community edit bitsocial.bso --jsonFile ./edit-options.json"
         }
     ];
     async run() {
@@ -48,17 +62,45 @@ export default class Edit extends BaseCommand {
         const log = PKCLogger("bitsocial-cli:commands:community:edit");
         log(`flags: `, flags);
         const pkc = await this._connectToPkcRpc(flags.pkcRpcUrl.toString());
-        const editOptions = DataObjectParser.transpose(remeda.omit(flags, ["pkcRpcUrl"]))["_data"];
-        log("Edit options parsed:", editOptions);
+        const cliEditOptions = DataObjectParser.transpose(remeda.omit(flags, ["pkcRpcUrl", "jsonFile"]))["_data"];
+        log("CLI edit options parsed:", cliEditOptions);
+        // Parse JSONC file if provided
+        let jsonFileOptions = {};
+        if (flags.jsonFile) {
+            try {
+                jsonFileOptions = await parseJsoncFile(flags.jsonFile);
+                log("JSONC file options parsed:", jsonFileOptions);
+            }
+            catch (e) {
+                if (e instanceof Error) {
+                    this.error(e.message);
+                }
+                throw e;
+            }
+        }
+        // Merge: JSON file options first, then CLI flags override
+        let editOptions;
+        if (flags.jsonFile && Object.keys(cliEditOptions).length > 0) {
+            editOptions = mergeDeep(jsonFileOptions, cliEditOptions);
+        }
+        else if (flags.jsonFile) {
+            editOptions = jsonFileOptions;
+        }
+        else {
+            editOptions = cliEditOptions;
+        }
+        log("Final edit options:", editOptions);
         const localCommunities = pkc.communities;
         if (!localCommunities.includes(args.address))
             this.error("Can't edit a remote community, make sure you're editing a local community");
         try {
             const community = await pkc.createCommunity({ address: args.address });
             const mergedState = remeda.pick(community, remeda.keys.strict(editOptions));
-            const finalMergedState = mergeDeep(mergedState, editOptions);
+            // JSON file edits use RFC 7396 JSON Merge Patch semantics (arrays replace, objects merge).
+            // CLI flag edits use concat semantics (arrays extend with new values).
+            const finalMergedState = mergeDeep(mergedState, editOptions, flags.jsonFile ? "replace" : "concat");
             log("Internal community state after merge:", finalMergedState);
-            await community.edit(finalMergedState);
+            await community.edit(replaceNullWithUndefined(finalMergedState));
             this.log(community.address);
         }
         catch (e) {

package/dist/cli/commands/daemon.js

@@ -96,12 +96,12 @@ export default class Daemon extends Command {
         const stdoutWrite = process.stdout.write.bind(process.stdout);
         const stderrWrite = process.stderr.write.bind(process.stderr);
         const isLogFileOverLimit = () => logFile.bytesWritten > 20000000; // 20mb
-        const writeTimestampedLine = (text) => {
+        const writeTimestampedLine = (text, stream) => {
             if (isLogFileOverLimit())
                 return;
             if (!text || text.trim().length === 0)
                 return;
-            const timestamp = `[${new Date().toISOString()}] `;
+            const timestamp = `[${new Date().toISOString()}] [${stream}] `;
             const lines = text.split("\n");
             const timestamped = lines.map((line, i) => (i === 0 ? timestamp + line : line)).join("\n");
             logFile.write(timestamped);
@@ -115,13 +115,13 @@ export default class Daemon extends Command {
         debugModule.inspectOpts.colors = true;
         debugModule.inspectOpts.hideDate = true;
         debugModule.log = (...args) => {
-            writeTimestampedLine(formatWithOptions({ depth: Logger.inspectOpts?.depth || 10, colors: true }, ...args).trimStart() + EOL);
+            writeTimestampedLine(formatWithOptions({ depth: Logger.inspectOpts?.depth || 10, colors: true }, ...args).trimStart() + EOL, "stderr");
         };
         const asString = (data) => (typeof data === "string" ? data : Buffer.from(data).toString());
         process.stdout.write = (...args) => {
             //@ts-expect-error
             const res = stdoutWrite(...args);
-            writeTimestampedLine(asString(args[0]));
+            writeTimestampedLine(asString(args[0]), "stdout");
             return res;
         };
         process.stderr.write = (...args) => {
@@ -129,7 +129,7 @@ export default class Daemon extends Command {
             // Debug output goes to stderr; we want it in logs only.
             // Real errors are caught by uncaughtException/unhandledRejection handlers
             // which use console.error -> stderr.write -> this override -> log file.
-            writeTimestampedLine(asString(args[0]).trimStart());
+            writeTimestampedLine(asString(args[0]).trimStart(), "stderr");
             return true;
         };
         const log = Logger("bitsocial-cli:daemon");

package/dist/cli/commands/logs.d.ts

@@ -1,6 +1,7 @@
 import { Command } from "@oclif/core";
 interface LogEntry {
     timestamp: Date | null;
+    stream: "stdout" | "stderr" | null;
     lines: string[];
 }
 export default class Logs extends Command {
@@ -11,13 +12,17 @@ export default class Logs extends Command {
         since: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         until: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         logPath: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        stdout: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        stderr: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     static examples: string[];
     private _findLatestLogFile;
     _parseTimestamp(value: string): Date;
     _extractTimestamp(line: string): Date | null;
+    _extractStream(line: string): "stdout" | "stderr" | null;
     _parseLogEntries(content: string): LogEntry[];
     _filterEntries(entries: LogEntry[], since?: Date, until?: Date): LogEntry[];
+    _filterByStream(entries: LogEntry[], stream: "stdout" | "stderr"): LogEntry[];
     _tailEntries(entries: LogEntry[], tailValue: string): LogEntry[];
     run(): Promise<void>;
 }

package/dist/cli/commands/logs.js

@@ -27,6 +27,16 @@ export default class Logs extends Command {
         logPath: Flags.directory({
             description: "Specify the directory containing log files",
             required: false
+        }),
+        stdout: Flags.boolean({
+            description: "Show only stdout log entries",
+            default: false,
+            exclusive: ["stderr"]
+        }),
+        stderr: Flags.boolean({
+            description: "Show only stderr log entries (output of pkc-logger library)",
+            default: false,
+            exclusive: ["stdout"]
         })
     };
     static examples = [
@@ -35,7 +45,10 @@ export default class Logs extends Command {
         "bitsocial logs -n 50",
         "bitsocial logs --since 5m",
         "bitsocial logs --since 2026-01-02T13:23:37Z --until 2026-01-02T14:00:00Z",
-        "bitsocial logs --since 1h -f"
+        "bitsocial logs --since 1h -f",
+        "bitsocial logs --stdout",
+        "bitsocial logs --stderr",
+        "bitsocial logs --stdout -f"
     ];
     async _findLatestLogFile(logPath) {
         let entries;
@@ -76,6 +89,12 @@ export default class Logs extends Command {
             return null;
         return new Date(match[1]);
     }
+    _extractStream(line) {
+        const match = line.match(/^\[\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z\] \[(stdout|stderr)\] /);
+        if (!match)
+            return null;
+        return match[1];
+    }
     _parseLogEntries(content) {
         const lines = content.split("\n");
         const entries = [];
@@ -83,7 +102,8 @@ export default class Logs extends Command {
             const timestamp = this._extractTimestamp(line);
             if (timestamp !== null) {
                 // New timestamped entry
-                entries.push({ timestamp, lines: [line] });
+                const stream = this._extractStream(line);
+                entries.push({ timestamp, stream, lines: [line] });
             }
             else if (entries.length > 0) {
                 // Continuation line — belongs to the previous entry
@@ -91,7 +111,7 @@ export default class Logs extends Command {
             }
             else {
                 // Line before any timestamped entry (legacy/header)
-                entries.push({ timestamp: null, lines: [line] });
+                entries.push({ timestamp: null, stream: null, lines: [line] });
             }
         }
         return entries;
@@ -109,6 +129,9 @@ export default class Logs extends Command {
             return true;
         });
     }
+    _filterByStream(entries, stream) {
+        return entries.filter((entry) => entry.stream === stream);
+    }
     _tailEntries(entries, tailValue) {
         if (tailValue === "all")
             return entries;
@@ -126,33 +149,37 @@ export default class Logs extends Command {
         const latestLogFile = await this._findLatestLogFile(logPath);
         const since = flags.since ? this._parseTimestamp(flags.since) : undefined;
         const until = flags.until ? this._parseTimestamp(flags.until) : undefined;
+        const streamFilter = flags.stdout ? "stdout" : flags.stderr ? "stderr" : undefined;
         if (!flags.follow) {
             const content = await fsPromise.readFile(latestLogFile, "utf-8");
             const entries = this._parseLogEntries(content);
             const filtered = this._filterEntries(entries, since, until);
-            const tailed = this._tailEntries(filtered, flags.tail);
+            const streamFiltered = streamFilter ? this._filterByStream(filtered, streamFilter) : filtered;
+            const tailed = this._tailEntries(streamFiltered, flags.tail);
             const output = tailed.map((e) => e.lines.join("\n")).join("\n");
             if (output)
                 process.stdout.write(output + "\n");
             return;
         }
         // Follow mode: dump existing content (filtered + tailed) then watch for new data
-        const existingContent = await fsPromise.readFile(latestLogFile, "utf-8");
+        let currentLogFile = latestLogFile;
+        const existingContent = await fsPromise.readFile(currentLogFile, "utf-8");
         const entries = this._parseLogEntries(existingContent);
         const filtered = this._filterEntries(entries, since, until);
-        const tailed = this._tailEntries(filtered, flags.tail);
+        const streamFiltered = streamFilter ? this._filterByStream(filtered, streamFilter) : filtered;
+        const tailed = this._tailEntries(streamFiltered, flags.tail);
         const initialOutput = tailed.map((e) => e.lines.join("\n")).join("\n");
         if (initialOutput)
             process.stdout.write(initialOutput + "\n");
-        const stat = await fsPromise.stat(latestLogFile);
+        const stat = await fsPromise.stat(currentLogFile);
         let position = stat.size;
         let pendingBuffer = "";
         // Watch for new data using polling (works across filesystems including Docker volumes)
         const readNewData = async () => {
             try {
-                const currentStat = await fsPromise.stat(latestLogFile);
+                const currentStat = await fsPromise.stat(currentLogFile);
                 if (currentStat.size > position) {
-                    const fd = await fsPromise.open(latestLogFile, "r");
+                    const fd = await fsPromise.open(currentLogFile, "r");
                     const buf = new Uint8Array(currentStat.size - position);
                     const { bytesRead } = await fd.read(buf, 0, buf.length, position);
                     await fd.close();
@@ -166,14 +193,15 @@ export default class Logs extends Command {
                     }
                     pendingBuffer = chunk.slice(lastNewline + 1);
                     const completeText = chunk.slice(0, lastNewline + 1);
-                    if (!since && !until) {
-                        // No time filtering — pass through directly
+                    if (!since && !until && !streamFilter) {
+                        // No filtering — pass through directly
                         process.stdout.write(completeText);
                     }
                     else {
                         const newEntries = this._parseLogEntries(completeText.replace(/\n$/, ""));
                         const filteredNew = this._filterEntries(newEntries, since, until);
-                        const output = filteredNew.map((e) => e.lines.join("\n")).join("\n");
+                        const streamFilteredNew = streamFilter ? this._filterByStream(filteredNew, streamFilter) : filteredNew;
+                        const output = streamFilteredNew.map((e) => e.lines.join("\n")).join("\n");
                         if (output)
                             process.stdout.write(output + "\n");
                     }
@@ -183,14 +211,67 @@ export default class Logs extends Command {
                 // File may have been rotated or deleted
             }
         };
-        fs.watchFile(latestLogFile, { interval: 300 }, readNewData);
+        // Periodically check if a newer log file has appeared (e.g. after daemon restart)
+        const checkForNewLogFile = async () => {
+            try {
+                const newestFile = await this._findLatestLogFile(logPath);
+                if (newestFile === currentLogFile)
+                    return;
+                // Flush any remaining partial line from old file
+                if (pendingBuffer) {
+                    if (!since && !until && !streamFilter) {
+                        process.stdout.write(pendingBuffer + "\n");
+                    }
+                    else {
+                        const pbEntries = this._parseLogEntries(pendingBuffer);
+                        const pbFiltered = this._filterEntries(pbEntries, since, until);
+                        const pbStreamFiltered = streamFilter ? this._filterByStream(pbFiltered, streamFilter) : pbFiltered;
+                        const pbOutput = pbStreamFiltered.map((e) => e.lines.join("\n")).join("\n");
+                        if (pbOutput)
+                            process.stdout.write(pbOutput + "\n");
+                    }
+                }
+                // Switch watchers
+                fs.unwatchFile(currentLogFile, readNewData);
+                currentLogFile = newestFile;
+                pendingBuffer = "";
+                process.stderr.write(`\n--- switched to new log file: ${path.basename(newestFile)} ---\n\n`);
+                // Read and output entire new file content (with filters, no tail limit)
+                const newContent = await fsPromise.readFile(currentLogFile, "utf-8");
+                if (newContent) {
+                    if (!since && !until && !streamFilter) {
+                        process.stdout.write(newContent);
+                    }
+                    else {
+                        const newEntries = this._parseLogEntries(newContent.replace(/\n$/, ""));
+                        const filteredNew = this._filterEntries(newEntries, since, until);
+                        const streamFilteredNew = streamFilter
+                            ? this._filterByStream(filteredNew, streamFilter)
+                            : filteredNew;
+                        const output = streamFilteredNew.map((e) => e.lines.join("\n")).join("\n");
+                        if (output)
+                            process.stdout.write(output + "\n");
+                    }
+                }
+                const newStat = await fsPromise.stat(currentLogFile);
+                position = newStat.size;
+                fs.watchFile(currentLogFile, { interval: 300 }, readNewData);
+            }
+            catch {
+                // Directory listing failed or file disappeared — retry next cycle
+            }
+        };
+        fs.watchFile(currentLogFile, { interval: 300 }, readNewData);
+        const newFileCheckInterval = setInterval(checkForNewLogFile, 3000);
         // Keep the process alive and clean up on exit
         process.on("SIGINT", () => {
-            fs.unwatchFile(latestLogFile, readNewData);
+            clearInterval(newFileCheckInterval);
+            fs.unwatchFile(currentLogFile, readNewData);
             process.exit(0);
         });
         process.on("SIGTERM", () => {
-            fs.unwatchFile(latestLogFile, readNewData);
+            clearInterval(newFileCheckInterval);
+            fs.unwatchFile(currentLogFile, readNewData);
             process.exit(0);
         });
         // Keep process alive

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

@@ -11,4 +11,6 @@ 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

@@ -4,6 +4,11 @@ import tcpPortUsed from "tcp-port-used";
 import { fetchLatestVersion, installGlobal } from "../../../update/npm-registry.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 = {
@@ -122,10 +127,68 @@ 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(() => { });
+        }
+    }
 }

package/dist/cli/hooks/prerun/parse-dynamic-flags-hook.js

@@ -60,6 +60,10 @@ const traverseObjectToSetAsFlagInOclif = (opts, flagsGrouped, path = "") => {
             if (Object.keys(flagsGrouped[flagName]).length !== 0)
                 continue;
         }
+        const fullFlagName = path + flagName;
+        // Skip flags that are already statically declared on the command
+        if (opts.Command.flags && fullFlagName in opts.Command.flags)
+            continue;
         const flagsIndices = Object.assign({}, ...Object.keys(flagsGrouped).map((flag) => ({ [flag]: 0 })));
         const multipleValues = Array.isArray(flagsGrouped[flagName]) && flagsGrouped[flagName].length > 1;
         const parsedValue = flagsGrouped[flagName];
@@ -76,9 +80,18 @@ const traverseObjectToSetAsFlagInOclif = (opts, flagsGrouped, path = "") => {
             });
     }
 };
+// Tracks original static flags per Command class so dynamic flags can be reset across invocations (e.g. in tests)
+const originalStaticFlags = new WeakMap();
 const hook = async function (opts) {
     // Need to parse flag here and add it to opts.Command._flags
     if (opts.Command.id === "community:edit" || opts.Command.id === "community:create" || opts.Command.id === "daemon") {
+        // Snapshot static flags on first run; restore on subsequent runs (test isolation)
+        if (!originalStaticFlags.has(opts.Command)) {
+            originalStaticFlags.set(opts.Command, opts.Command.flags ? { ...opts.Command.flags } : {});
+        }
+        else {
+            opts.Command.flags = { ...originalStaticFlags.get(opts.Command) };
+        }
         // Parse the dynamic flags and add them to opts.Command.flags so that it wouldn't throw
         if (opts.argv.length <= 1)
             return; // if no flags are provided, then we don't need to do anything

package/dist/util.d.ts

@@ -25,8 +25,13 @@ export declare function getLanIpV4Address(): string | undefined;
 export declare function loadKuboConfigFile(pkcDataPath: string): Promise<any | undefined>;
 export declare function parseMultiAddrKuboRpcToUrl(kuboMultiAddrString: string): Promise<import("url").URL>;
 export declare function parseMultiAddrIpfsGatewayToUrl(ipfsGatewaymultiAddrString: string): Promise<import("url").URL>;
+/** Recursively replaces all `null` values with `undefined`.
+ * Used before calling community.edit() since pkc-js expects `undefined` for removal,
+ * but JSON/CLI input produces `null`. */
+export declare function replaceNullWithUndefined(obj: any): any;
 /**
  * Custom merge function that implements CLI-specific merge behavior.
  * This matches the expected behavior from the test suite.
  */
-export declare function mergeDeep(target: any, source: any): any;
+export declare function mergeDeep(target: any, source: any, arrayStrategy?: "concat" | "replace"): any;
+export declare function parseJsoncFile(filePath: string): Promise<Record<string, unknown>>;

package/dist/util.js

@@ -2,6 +2,7 @@ import os from "os";
 import path from "path";
 import fs from "fs";
 import * as fsPromises from "fs/promises";
+import stripJsonComments from "strip-json-comments";
 import PKCLogger from "@pkcprotocol/pkc-logger";
 export { PKCLogger };
 /**
@@ -75,11 +76,28 @@ export async function parseMultiAddrIpfsGatewayToUrl(ipfsGatewaymultiAddrString)
         throw new Error(`Unable to parse IPFS gateway multiaddr: ${ipfsGatewaymultiAddrString}`);
     return new URL(`http://${parsed.host}:${parsed.port}`);
 }
+/** Recursively replaces all `null` values with `undefined`.
+ * Used before calling community.edit() since pkc-js expects `undefined` for removal,
+ * but JSON/CLI input produces `null`. */
+export function replaceNullWithUndefined(obj) {
+    if (obj === null)
+        return undefined;
+    if (Array.isArray(obj))
+        return obj.map(replaceNullWithUndefined);
+    if (typeof obj === "object" && obj.constructor === Object) {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = replaceNullWithUndefined(value);
+        }
+        return result;
+    }
+    return obj;
+}
 /**
  * Custom merge function that implements CLI-specific merge behavior.
  * This matches the expected behavior from the test suite.
  */
-export function mergeDeep(target, source) {
+export function mergeDeep(target, source, arrayStrategy = "concat") {
     function isObject(item) {
         return item && typeof item === "object" && !Array.isArray(item);
     }
@@ -88,6 +106,10 @@ export function mergeDeep(target, source) {
     }
     // Handle arrays with CLI-specific behavior
     if (Array.isArray(target) && Array.isArray(source)) {
+        // RFC 7396 JSON Merge Patch: arrays are replaced entirely
+        if (arrayStrategy === "replace") {
+            return source;
+        }
         // Check if source is sparse (has holes/empty items) - indicates indexed assignment like --rules[2]
         const sourceHasHoles = source.length !== Object.keys(source).length;
         if (sourceHasHoles) {
@@ -97,7 +119,7 @@ export function mergeDeep(target, source) {
             for (let i = 0; i < maxLength; i++) {
                 if (i in source) {
                     if (i in target && isPlainObject(target[i]) && isPlainObject(source[i])) {
-                        result[i] = mergeDeep(target[i], source[i]);
+                        result[i] = mergeDeep(target[i], source[i], arrayStrategy);
                     }
                     else {
                         result[i] = source[i];
@@ -138,10 +160,10 @@ export function mergeDeep(target, source) {
         for (const key in source) {
             if (source.hasOwnProperty(key)) {
                 if (Array.isArray(target[key]) && Array.isArray(source[key])) {
-                    result[key] = mergeDeep(target[key], source[key]);
+                    result[key] = mergeDeep(target[key], source[key], arrayStrategy);
                 }
                 else if (isPlainObject(target[key]) && isPlainObject(source[key])) {
-                    result[key] = mergeDeep(target[key], source[key]);
+                    result[key] = mergeDeep(target[key], source[key], arrayStrategy);
                 }
                 else {
                     result[key] = source[key];
@@ -153,3 +175,21 @@ export function mergeDeep(target, source) {
     // If not both objects/arrays, source takes precedence
     return source;
 }
+export async function parseJsoncFile(filePath) {
+    const fileContent = await fsPromises.readFile(filePath, "utf-8");
+    const stripped = stripJsonComments(fileContent);
+    let parsed;
+    try {
+        parsed = JSON.parse(stripped);
+    }
+    catch (e) {
+        if (e instanceof SyntaxError) {
+            throw new Error(`Invalid JSONC in file ${filePath}: ${e.message}`);
+        }
+        throw e;
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("JSONC file must contain a JSON object (not an array, null, string, or number)");
+    }
+    return parsed;
+}

package/oclif.manifest.json

@@ -72,7 +72,10 @@
         "bitsocial logs -n 50",
         "bitsocial logs --since 5m",
         "bitsocial logs --since 2026-01-02T13:23:37Z --until 2026-01-02T14:00:00Z",
-        "bitsocial logs --since 1h -f"
+        "bitsocial logs --since 1h -f",
+        "bitsocial logs --stdout",
+        "bitsocial logs --stderr",
+        "bitsocial logs --stdout -f"
       ],
       "flags": {
         "follow": {
@@ -114,6 +117,24 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "stdout": {
+          "description": "Show only stdout log entries",
+          "exclusive": [
+            "stderr"
+          ],
+          "name": "stdout",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stderr": {
+          "description": "Show only stderr log entries (output of pkc-logger library)",
+          "exclusive": [
+            "stdout"
+          ],
+          "name": "stderr",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -267,6 +288,10 @@
         {
           "description": "Create a community with title 'Hello Plebs' and description 'Welcome'",
           "command": "<%= config.bin %> <%= command.id %> --title 'Hello Plebs' --description 'Welcome'"
+        },
+        {
+          "description": "Create a community using options from a JSON/JSONC file",
+          "command": "<%= config.bin %> <%= command.id %> --jsonFile ./create-options.json"
         }
       ],
       "flags": {
@@ -285,6 +310,14 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "jsonFile": {
+          "char": "f",
+          "description": "Path to a JSON/JSONC file containing create options (supports comments)",
+          "name": "jsonFile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -350,7 +383,7 @@
       "aliases": [],
       "args": {
         "address": {
-          "description": "Address of the community to edit",
+          "description": "Address of the community to edit. It could be the name domain, or a public key",
           "name": "address",
           "required": true
         }
@@ -363,27 +396,31 @@
         },
         {
           "description": "Add the author address 'esteban.bso' as an admin on the community",
-          "command": "bitsocial community edit mysub.bso '--roles[\"esteban.bso\"].role' admin"
+          "command": "bitsocial community edit mycommunity.bso '--roles[\"esteban.bso\"].role' admin"
         },
         {
           "description": "Add two challenges to the community. The first challenge will be a question and answer, and the second will be an image captcha",
-          "command": "bitsocial community edit mysub.bso --settings.challenges[0].name question --settings.challenges[0].options.question \"what is the password?\" --settings.challenges[0].options.answer thepassword --settings.challenges[1].name captcha-canvas-v3"
+          "command": "bitsocial community edit mycommunity.bso --settings.challenges[0].name question --settings.challenges[0].options.question \"what is the password?\" --settings.challenges[0].options.answer thepassword --settings.challenges[1].name captcha-canvas-v3"
         },
         {
           "description": "Change the title and description",
-          "command": "bitsocial community edit mysub.bso --title \"This is the new title\" --description \"This is the new description\" "
+          "command": "bitsocial community edit mycommunity.bso --title \"This is the new title\" --description \"This is the new description\" "
         },
         {
           "description": "Remove a role from a moderator/admin/owner",
-          "command": "bitsocial community edit plebbit.bso --roles['rinse12.bso'] null"
+          "command": "bitsocial community edit bitsocial.bso --roles['rinse12.bso'] null"
         },
         {
           "description": "Enable settings.fetchThumbnailUrls to fetch the thumbnail of url submitted by authors",
-          "command": "bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls"
+          "command": "bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls"
         },
         {
           "description": "disable settings.fetchThumbnailUrls",
-          "command": "bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls=false"
+          "command": "bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls=false"
+        },
+        {
+          "description": "Edit a community using options from a JSON/JSONC file",
+          "command": "bitsocial community edit bitsocial.bso --jsonFile ./edit-options.json"
         }
       ],
       "flags": {
@@ -395,6 +432,14 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "jsonFile": {
+          "char": "f",
+          "description": "Path to a JSON/JSONC file containing edit options (supports comments)",
+          "name": "jsonFile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -713,5 +758,5 @@
       ]
     }
   },
-  "version": "0.19.44"
+  "version": "0.19.46"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bitsocial/bitsocial-cli",
-    "version": "0.19.44",
+    "version": "0.19.46",
     "description": "Command line interface to Bitsocial API",
     "types": "./dist/index.d.ts",
     "homepage": "https://github.com/bitsocialnet/bitsocial-cli",
@@ -125,6 +125,7 @@
         "exit-hook": "4.0.0",
         "express": "4.19.2",
         "kubo": "0.40.1",
+        "strip-json-comments": "5.0.3",
         "tcp-port-used": "1.0.2",
         "tslib": "2.6.2",
         "typescript": "5.9.3"