@bitsocial/bitsocial-cli 0.19.45 → 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.45/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.45/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.45/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.45/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.45/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`
 
@@ -456,7 +461,7 @@ ARGUMENTS
   ADDRESS  Address of the community to edit. It could be the name domain, or a public key
 
 FLAGS
-  -f, --jsonFile=<value>   Path to a JSON file containing edit options
+  -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
@@ -495,12 +500,12 @@ EXAMPLES
 
     $ bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls=false
 
-  Edit a community using options from a JSON file
+  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.45/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]`
 
@@ -531,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.45/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`
 
@@ -554,7 +559,7 @@ EXAMPLES
   $ bitsocial community list
 ```
 
-_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/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`
 
@@ -583,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.45/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`
 
@@ -608,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.45/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`
 
@@ -649,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.45/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]`
 
@@ -677,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)
@@ -685,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)
 
@@ -704,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.45/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`
 
@@ -723,7 +737,7 @@ EXAMPLES
   $ bitsocial update check
 ```
 
-_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/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]`
 
@@ -755,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.45/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`
 
@@ -777,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.45/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.js

@@ -1,9 +1,8 @@
 //@ts-expect-error
 import DataObjectParser from "dataobject-parser";
 import { Args, Flags } from "@oclif/core";
-import fs from "fs";
 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";
@@ -18,7 +17,7 @@ export default class Edit extends BaseCommand {
         jsonFile: Flags.file({
             char: "f",
             exists: true,
-            description: "Path to a JSON file containing edit options"
+            description: "Path to a JSON/JSONC file containing edit options (supports comments)"
         })
     };
     static examples = [
@@ -54,7 +53,7 @@ export default class Edit extends BaseCommand {
             command: "bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls=false"
         },
         {
-            description: "Edit a community using options from a JSON file",
+            description: "Edit a community using options from a JSON/JSONC file",
             command: "bitsocial community edit bitsocial.bso --jsonFile ./edit-options.json"
         }
     ];
@@ -65,21 +64,16 @@ export default class Edit extends BaseCommand {
         const pkc = await this._connectToPkcRpc(flags.pkcRpcUrl.toString());
         const cliEditOptions = DataObjectParser.transpose(remeda.omit(flags, ["pkcRpcUrl", "jsonFile"]))["_data"];
         log("CLI edit options parsed:", cliEditOptions);
-        // Parse JSON file if provided
+        // Parse JSONC file if provided
         let jsonFileOptions = {};
         if (flags.jsonFile) {
             try {
-                const fileContent = await fs.promises.readFile(flags.jsonFile, "utf-8");
-                const parsed = JSON.parse(fileContent);
-                if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-                    this.error("JSON file must contain a JSON object (not an array, null, string, or number)");
-                }
-                jsonFileOptions = parsed;
-                log("JSON file options parsed:", jsonFileOptions);
+                jsonFileOptions = await parseJsoncFile(flags.jsonFile);
+                log("JSONC file options parsed:", jsonFileOptions);
             }
             catch (e) {
-                if (e instanceof SyntaxError) {
-                    this.error(`Invalid JSON in file ${flags.jsonFile}: ${e.message}`);
+                if (e instanceof Error) {
+                    this.error(e.message);
                 }
                 throw e;
             }
@@ -102,9 +96,11 @@ export default class Edit extends BaseCommand {
         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.js

@@ -144,15 +144,19 @@ export default class Install extends Command {
         pkc.on("error", (err) => {
             errors.push(err);
         });
-        await new Promise((resolve, reject) => {
+        await new Promise((resolve) => {
             const timeout = setTimeout(() => {
-                const lastError = errors[errors.length - 1];
-                reject(lastError ?? new Error(`Timed out waiting for RPC server at ${pkcRpcUrl} to respond`));
-            }, 20000);
-            pkc.once("communitieschange", () => {
-                clearTimeout(timeout);
+                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;
     }

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,
@@ -386,7 +419,7 @@
           "command": "bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls=false"
         },
         {
-          "description": "Edit a community using options from a JSON file",
+          "description": "Edit a community using options from a JSON/JSONC file",
           "command": "bitsocial community edit bitsocial.bso --jsonFile ./edit-options.json"
         }
       ],
@@ -402,7 +435,7 @@
         },
         "jsonFile": {
           "char": "f",
-          "description": "Path to a JSON file containing edit options",
+          "description": "Path to a JSON/JSONC file containing edit options (supports comments)",
           "name": "jsonFile",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -725,5 +758,5 @@
       ]
     }
   },
-  "version": "0.19.45"
+  "version": "0.19.46"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bitsocial/bitsocial-cli",
-    "version": "0.19.45",
+    "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"