@bitsocial/bitsocial-cli 0.19.41 → 0.19.42

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.41/src/cli/commands/challenge/install.ts)_
+_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/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.41/src/cli/commands/challenge/list.ts)_
+_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/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.41/src/cli/commands/challenge/remove.ts)_
+_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/challenge/remove.ts)_
 
 ## `bitsocial community create`
 
@@ -417,7 +417,7 @@ EXAMPLES
     $ bitsocial community create --title 'Hello Plebs' --description 'Welcome'
 ```
 
-_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/create.ts)_
+_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/community/create.ts)_
 
 ## `bitsocial community delete ADDRESSES`
 
@@ -442,7 +442,7 @@ EXAMPLES
   $ bitsocial community delete 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/delete.ts)_
+_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/community/delete.ts)_
 
 ## `bitsocial community edit ADDRESS`
 
@@ -494,7 +494,7 @@ EXAMPLES
     $ bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls=false
 ```
 
-_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/edit.ts)_
+_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/community/edit.ts)_
 
 ## `bitsocial community get [ADDRESS]`
 
@@ -525,7 +525,7 @@ EXAMPLES
   $ bitsocial community get --publicKey 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/get.ts)_
+_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/community/get.ts)_
 
 ## `bitsocial community list`
 
@@ -548,7 +548,7 @@ EXAMPLES
   $ bitsocial community list
 ```
 
-_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/list.ts)_
+_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/community/list.ts)_
 
 ## `bitsocial community start ADDRESSES`
 
@@ -577,7 +577,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.41/src/cli/commands/community/start.ts)_
+_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/community/start.ts)_
 
 ## `bitsocial community stop ADDRESSES`
 
@@ -602,7 +602,7 @@ EXAMPLES
   $ bitsocial community stop Qmb99crTbSUfKXamXwZBe829Vf6w5w5TktPkb6WstC9RFW
 ```
 
-_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/stop.ts)_
+_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/community/stop.ts)_
 
 ## `bitsocial daemon`
 
@@ -644,7 +644,7 @@ EXAMPLES
   $ bitsocial daemon --chainProviderUrls viem --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY
 ```
 
-_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/daemon.ts)_
+_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/daemon.ts)_
 
 ## `bitsocial help [COMMAND]`
 
@@ -701,7 +701,7 @@ EXAMPLES
   $ bitsocial logs --since 1h -f
 ```
 
-_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/logs.ts)_
+_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/logs.ts)_
 
 ## `bitsocial update check`
 
@@ -718,7 +718,7 @@ EXAMPLES
   $ bitsocial update check
 ```
 
-_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/update/check.ts)_
+_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/update/check.ts)_
 
 ## `bitsocial update install [VERSION]`
 
@@ -747,7 +747,7 @@ EXAMPLES
   $ bitsocial update install --force
 ```
 
-_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/update/install.ts)_
+_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/update/install.ts)_
 
 ## `bitsocial update versions`
 
@@ -769,7 +769,7 @@ EXAMPLES
   $ bitsocial update versions --limit 5
 ```
 
-_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/update/versions.ts)_
+_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.42/src/cli/commands/update/versions.ts)_
 <!-- commandsstop -->
 
 ## Contribution

package/dist/cli/ascii-banner.d.ts

@@ -0,0 +1 @@
+export declare function printBanner(): void;

package/dist/cli/ascii-banner.js

@@ -0,0 +1,94 @@
+// ASCII banner, edited as two parallel grids.
+//
+// SHAPE holds the raw glyphs (braille art + figlet text). Leave these alone
+// unless you want to change the art itself.
+//
+// COLORS is the paint map. Each character corresponds 1:1 to the character
+// at the same position in SHAPE:
+//   B = blue   (#1a4fd0) — the sphere
+//   S = silver (#e5e7eb) — the rings and the "Bitsocial" text
+//   . = no color (pass the glyph through as-is; use this for spaces)
+//
+// To retouch the art, find a glyph in SHAPE, then flip the character at the
+// same column in the matching COLORS row. A common case: a ring cell came out
+// blue because the sphere mask had more dots there — change its 'B' to 'S'.
+//
+// Both grids MUST have the same number of rows. Each row in COLORS must be at
+// least as wide as the corresponding SHAPE row (extra chars are ignored).
+// Palette sourced from bitsocialnet/bitsocial-web/about/tailwind.config.ts.
+const SHAPE = [
+    "                ⢀⣴⣿⣿⣦⡀                                                                                       ",
+    "                ⣾⣿⠁⠈⣿⣷⡀                                                                                      ",
+    "               ⢸⣿⡇  ⢸⣿⣇                                                                                      ",
+    "             ⢀⣀⣼⣿⣷⣶⣶⣶⣿⣿⣄⡀                                                                                    ",
+    "          ⢀⣠⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣤⡀                                                                                 ",
+    "         ⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣦               888888b.   d8b 888                               d8b          888",
+    "       ⢀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡀             888  \"88b  Y8P 888                               Y8P          888",
+    "  ⣀⣤⣤⣶⣶⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣶⣶⣦⣤⣀        888  .88P      888                                            888",
+    "⣰⣿⡿⠛⠉⠉ ⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿ ⠉⠉⠛⠟⣿⣦      8888888K.  888 888888 .d8888b   .d88b.   .d8888b 888  8888b.  888",
+    "⠻⣷⣦⣤⣀⣀ ⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿ ⢀⣀⣀⣴⣿⠟      888  \"Y88b 888 888    88K      d88\"\"88b d88P\"    888     \"88b 888",
+    "  ⠉⠛⠻⠿⠿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠿⠿⠟⠛⠉        888    888 888 888    \"Y8888b. 888  888 888      888 .d888888 888",
+    "       ⠈⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿              888   d88P 888 Y88b.       X88 Y88..88P Y88b.    888 888  888 888",
+    "         ⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠟               8888888P\"  888  \"Y888  88888P'  \"Y88P\"   \"Y8888P 888 \"Y888888 888",
+    "          ⠈⠻⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⠟⠁                                                                                 ",
+    "             ⠉⠛⢿⣿⣿⣿⣿⣿⣿⣿⠛⠉                                                                                    ",
+    "                ⢸⣿⡆  ⣿⡿                                                                                      ",
+    "                ⠈⢿⣷⡀⣸⣿⠃                                                                                       ",
+    "                 ⠈⠿⣿⡿⠃                                                                                        "
+];
+const COLORS = [
+    "................SSSSSS.......................................................................................",
+    "................SSSSSSS......................................................................................",
+    "...............SSSSSSSS......................................................................................",
+    ".............BBBBBBBBSSBB....................................................................................",
+    "..........BBBBBBBBBBBSSBBBBB.................................................................................",
+    ".........BBBBBBBBBBBBSSBBBBBB...............SSSSSSSS...SSS.SSS...............................SSS..........SSS",
+    ".......BBBBBBBBBBBBBBSSBBBBBBBB.............SSS..SSSS..SSS.SSS...............................SSS..........SSS",
+    "..SSSSSBBBBBBBBBBBBBBSSBBBBBBBBSSSSSSS......SSS..SSSS......SSS............................................SSS",
+    "SSSSSS.BBBBBBBBBBBBBBSSBBBBBBBBSSSSSSS......SSSSSSSSS..SSS.SSSSSS.SSSSSSS...SSSSSS...SSSSSSS.SSS..SSSSSS..SSS",
+    "SSSSSS.BBBBBBBBBBBBBBSSBBBBBBBBSSSSSSS......SSS..SSSSS.SSS.SSS....SSS......SSSSSSSS.SSSSS....SSS.....SSSS.SSS",
+    "..SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS......SSS....SSS.SSS.SSS....SSSSSSSS.SSS..SSS.SSS......SSS.SSSSSSSS.SSS",
+    ".......BBBBBBBBBBBBBBSSBBBBBBBBBBBBBBB......SSS...SSSS.SSS.SSSSS.......SSS.SSSSSSSS.SSSSS....SSS.SSS..SSS.SSS",
+    ".........BBBBBBBBBBBBSSBBBBBBBBB............SSSSSSSSS..SSS..SSSSS..SSSSSSS..SSSSSS...SSSSSSS.SSS.SSSSSSSS.SSS",
+    "..........BBBBBBBBBBBSSBBBBBBB...............................................................................",
+    ".............BBBBBBBBSSBBBB..................................................................................",
+    "...............SSSSSSSSS.....................................................................................",
+    "...............SSSSSSSS......................................................................................",
+    "................SSSSSS......................................................................................."
+];
+const BLUE = "\x1b[38;2;26;79;208m";
+const SILVER = "\x1b[38;2;229;231;235m";
+const RESET = "\x1b[0m";
+function paint(shape, colors) {
+    let out = "";
+    let current = ".";
+    for (let i = 0; i < shape.length; i++) {
+        const glyph = shape[i];
+        const want = colors[i] ?? ".";
+        if (want !== current) {
+            if (current !== ".")
+                out += RESET;
+            if (want === "B")
+                out += BLUE;
+            else if (want === "S")
+                out += SILVER;
+            current = want;
+        }
+        out += glyph;
+    }
+    if (current !== ".")
+        out += RESET;
+    return out;
+}
+function supportsColor() {
+    if (process.env["NO_COLOR"])
+        return false;
+    if (process.env["FORCE_COLOR"])
+        return true;
+    return Boolean(process.stdout.isTTY);
+}
+export function printBanner() {
+    const useColor = supportsColor();
+    const lines = SHAPE.map((row, i) => (useColor ? paint(row, COLORS[i] ?? "") : row));
+    process.stdout.write(lines.join("\n") + "\n\n");
+}

package/dist/cli/commands/daemon.js

@@ -5,6 +5,7 @@ import path from "path";
 import tcpPortUsed from "tcp-port-used";
 import { getLanIpV4Address, PKCLogger, setupDebugLogger, loadKuboConfigFile, parseMultiAddrKuboRpcToUrl, parseMultiAddrIpfsGatewayToUrl } from "../../util.js";
 import { startDaemonServer } from "../../webui/daemon-server.js";
+import { printBanner } from "../ascii-banner.js";
 import { loadChallengesIntoPKC } from "../../challenge-packages/challenge-utils.js";
 import { migrateDataDirectory } from "../../common-utils/data-migration.js";
 import { createBsoResolvers } from "../../common-utils/resolvers.js";
@@ -149,6 +150,7 @@ export default class Daemon extends Command {
         return { logFilePath, stdoutWrite };
     }
     async run() {
+        printBanner();
         // Non-blocking update check — fire-and-forget, won't delay startup
         import("../../update/npm-registry.js")
             .then(({ fetchLatestVersion }) => fetchLatestVersion().then(async (latest) => {

package/dist/cli/hooks/init/banner-hook.d.ts

@@ -0,0 +1,3 @@
+import { Hook } from "@oclif/core";
+declare const hook: Hook<"init">;
+export default hook;

package/dist/cli/hooks/init/banner-hook.js

@@ -0,0 +1,15 @@
+import { printBanner } from "../../ascii-banner.js";
+const hook = async function (opts) {
+    // Skip when --version is being handled by version-hook
+    if (process.argv.includes("--version"))
+        return;
+    // Show banner on bare `bitsocial` invocation (no command, no help flag).
+    // oclif sets opts.id to undefined when no command is matched; argv length > 2
+    // means the user passed flags/args and expects normal command output.
+    const bareInvocation = process.argv.length <= 2;
+    const helpInvocation = !opts.id && (process.argv.includes("--help") || process.argv.includes("-h") || process.argv.includes("help"));
+    if (bareInvocation || helpInvocation) {
+        printBanner();
+    }
+};
+export default hook;

package/oclif.manifest.json

@@ -703,5 +703,5 @@
       ]
     }
   },
-  "version": "0.19.41"
+  "version": "0.19.42"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bitsocial/bitsocial-cli",
-    "version": "0.19.41",
+    "version": "0.19.42",
     "description": "Command line interface to Bitsocial API",
     "types": "./dist/index.d.ts",
     "homepage": "https://github.com/bitsocialnet/bitsocial-cli",
@@ -62,7 +62,8 @@
         },
         "hooks": {
             "init": [
-                "./dist/cli/hooks/init/version-hook"
+                "./dist/cli/hooks/init/version-hook",
+                "./dist/cli/hooks/init/banner-hook"
             ],
             "prerun": [
                 "./dist/cli/hooks/prerun/parse-dynamic-flags-hook"