@bitsocial/bitsocial-cli 0.19.45 → 0.19.47

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.47/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.47/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.47/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.47/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.47/src/cli/commands/community/delete.ts)_
 
 ## `bitsocial community edit ADDRESS`
 
@@ -456,16 +461,28 @@ 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
   Edit a community's properties. For a list of properties, visit https://github.com/pkcprotocol/pkc-js
 
+  Merge behavior with CLI flags:
+  - Objects are merged with the community's current state (new keys are added, existing keys are overwritten).
+  - Arrays are extended: new values are prepended to the existing array.
+  - Setting a value to null removes it (e.g. --roles['mod.bso'] null).
+
+  Merge behavior with --jsonFile:
+  - Objects are merged the same way as CLI flags.
+  - Arrays are replaced entirely (RFC 7396 JSON Merge Patch semantics).
+  - When both --jsonFile and CLI flags are provided, CLI flags take priority.
+
+  For modifying complex settings like challenges, consider using a web UI instead: https://bitsocial.net/apps
+
 EXAMPLES
-  Change the address of the community to a new domain address
+  Change the name of the community
 
-    $ bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --address newAddress.bso
+    $ bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --name newName.bso
 
   Add the author address 'esteban.bso' as an admin on the community
 
@@ -495,12 +512,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.47/src/cli/commands/community/edit.ts)_
 
 ## `bitsocial community get [ADDRESS]`
 
@@ -531,7 +548,7 @@ EXAMPLES
   $ bitsocial community get --publicKey 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/community/get.ts)_
+_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.47/src/cli/commands/community/get.ts)_
 
 ## `bitsocial community list`
 
@@ -554,7 +571,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.47/src/cli/commands/community/list.ts)_
 
 ## `bitsocial community start ADDRESSES`
 
@@ -562,13 +579,14 @@ Start a community
 
 ```
 USAGE
-  $ bitsocial community start ADDRESSES... --pkcRpcUrl <value>
+  $ bitsocial community start ADDRESSES... --pkcRpcUrl <value> [--concurrency <value>]
 
 ARGUMENTS
   ADDRESSES...  Addresses of communities to start. Separated by space
 
 FLAGS
-  --pkcRpcUrl=<value>  (required) [default: ws://localhost:9138/] URL to PKC RPC
+  --concurrency=<value>  [default: 5] Number of communities to start in parallel
+  --pkcRpcUrl=<value>    (required) [default: ws://localhost:9138/] URL to PKC RPC
 
 DESCRIPTION
   Start a community
@@ -581,9 +599,13 @@ EXAMPLES
   Start all communities in your data path
 
     $ bitsocial community start $(bitsocial community list -q)
+
+  Start communities sequentially (no concurrency)
+
+    $ bitsocial community start $(bitsocial community list -q) --concurrency 1
 ```
 
-_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/community/start.ts)_
+_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.47/src/cli/commands/community/start.ts)_
 
 ## `bitsocial community stop ADDRESSES`
 
@@ -608,7 +630,7 @@ EXAMPLES
   $ bitsocial community stop Qmb99crTbSUfKXamXwZBe829Vf6w5w5TktPkb6WstC9RFW
 ```
 
-_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/community/stop.ts)_
+_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.47/src/cli/commands/community/stop.ts)_
 
 ## `bitsocial daemon`
 
@@ -649,7 +671,7 @@ EXAMPLES
   $ bitsocial daemon --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY
 ```
 
-_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/daemon.ts)_
+_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.47/src/cli/commands/daemon.ts)_
 
 ## `bitsocial help [COMMAND]`
 
@@ -677,7 +699,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 +708,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 +729,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.47/src/cli/commands/logs.ts)_
 
 ## `bitsocial update check`
 
@@ -723,7 +754,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.47/src/cli/commands/update/check.ts)_
 
 ## `bitsocial update install [VERSION]`
 
@@ -755,7 +786,7 @@ EXAMPLES
   $ bitsocial update install --no-restart-daemons
 ```
 
-_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/update/install.ts)_
+_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.47/src/cli/commands/update/install.ts)_
 
 ## `bitsocial update versions`
 
@@ -777,7 +808,7 @@ EXAMPLES
   $ bitsocial update versions --limit 5
 ```
 
-_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/update/versions.ts)_
+_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.47/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,12 +1,23 @@
 //@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";
+    static description = `Edit a community's properties. For a list of properties, visit https://github.com/pkcprotocol/pkc-js
+
+Merge behavior with CLI flags:
+  - Objects are merged with the community's current state (new keys are added, existing keys are overwritten).
+  - Arrays are extended: new values are prepended to the existing array.
+  - Setting a value to null removes it (e.g. --roles['mod.bso'] null).
+
+Merge behavior with --jsonFile:
+  - Objects are merged the same way as CLI flags.
+  - Arrays are replaced entirely (RFC 7396 JSON Merge Patch semantics).
+  - When both --jsonFile and CLI flags are provided, CLI flags take priority.
+
+For modifying complex settings like challenges, consider using a web UI instead: https://bitsocial.net/apps`;
     static args = {
         address: Args.string({
             name: "address",
@@ -18,16 +29,13 @@ 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 = [
-        // TODO update this to change the name instead
-        // Also are we testing modifying name properly?
-        // in theory user should not modify address, they should modify name
         {
-            description: "Change the address of the community to a new domain address",
-            command: "bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --address newAddress.bso"
+            description: "Change the name of the community",
+            command: "bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --name newName.bso"
         },
         {
             description: "Add the author address 'esteban.bso' as an admin on the community",
@@ -54,7 +62,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 +73,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 +105,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/community/start.d.ts

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

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

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

package/dist/cli/commands/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>;
 }