@tenyokjs/devdevian-cli 0.6.0-alpha.1 → 0.6.1-alpha.1

package/README.md

@@ -12,6 +12,22 @@ Login opens a browser. Compare the code shown in the terminal, sign in to Devdev
 
 Version-by-version changes and the customization roadmap: [CLI version history](VERSIONS.md).
 
+## A look inside
+
+Actual CLI captures from isolated demonstration accounts. Your terminal uses your real forum account and permissions.
+
+![Devdevian terminal feed](https://raw.githubusercontent.com/Tenyokj/devdevian/main/public/screenshots/cli-feed.png)
+
+<details>
+<summary>Code review and appearance</summary>
+
+![Side-by-side human code review](https://raw.githubusercontent.com/Tenyokj/devdevian/main/public/screenshots/cli-review.png)
+![Appearance controls](https://raw.githubusercontent.com/Tenyokj/devdevian/main/public/screenshots/cli-appearance.png)
+
+</details>
+
+Run `devdevian --help` for script commands and workspace shortcuts. Interactive help has a large wordmark and selective accents; `NO_COLOR=1` keeps it uncolored, narrow terminals use a compact heading, and redirected output stays plain.
+
 ## Live workspace
 
 The default `devdevian` command and `devdevian tui` open an alternate terminal screen. Navigation, conversations, inline forms, previews and search update in that screen; exiting restores your normal terminal. The blue and purple layout adapts to the terminal size, with compact navigation below 90 columns. Minimum size: 60 columns × 18 rows.

package/VERSIONS.md

@@ -8,6 +8,13 @@ Every published npm artifact has a unique immutable version. We record each vers
 
 **0.6.0 brings Projects and Events into the terminal**, using the same hosted data and permissions as the browser.
 
+## 0.6.1-alpha.1 — A clearer first impression
+
+- Added a large terminal wordmark and selective blue/violet accents to `--help`. Compact terminals, `NO_COLOR`, redirected output and JSON help remain readable without ANSI decoration.
+- Help now points to the interactive Projects/Events commands and actions. CLI documentation includes real terminal captures and install/login/workspace guidance.
+- The website introduces the CLI near the top, with keyboard-accessible screenshot tabs, copyable install/review commands and GitHub documentation links. A cached public-only activity counter updates while visible and respects reduced motion.
+- No schema migration, account/credential change or production-data reset. The CLI package and web/API keep independent versions.
+
 ## 0.6.0-alpha.1 — Projects and Events
 
 - Added paginated catalogs, text search and filter forms. Projects filter by topic, stage, owner and order; Events by topic, calendar date with viewer timezone, upcoming/past, participation and order.

package/bin/devdevian.mjs

@@ -23,6 +23,7 @@ import {
   loadAppearance,
   saveAppearance,
 } from "../lib/appearance.mjs";
+import { renderHelp } from "../lib/help.mjs";
 const version = packageInfo.version;
 const options = {
   host: { type: "string" },
@@ -113,6 +114,9 @@ const help = `Devdevian CLI ${version} · alpha
   devdevian review reopen POST_ID REVIEW_ID
   devdevian communities [--page 2]
 
+  Inside the workspace: /projects, /project ID, /events, /event ID
+  N creates · F filters · E edits your publication · X opens actions
+
   --theme NAME       midnight | nebula | daylight | contrast
   --accent NAME      blue | violet | cyan | rose
   --density NAME     comfortable | compact
@@ -257,7 +261,15 @@ async function login(flags) {
 }
 async function execute(args, flags) {
   if (flags.help) {
-    out(help);
+    process.stdout.write(
+      renderHelp(help, {
+        tty: !!process.stdout.isTTY,
+        columns: process.stdout.columns || 80,
+        noColor:
+          process.env.NO_COLOR !== undefined || process.env.TERM === "dumb",
+        json: !!flags.json,
+      }) + "\n",
+    );
     return;
   }
   if (flags.version) {

package/lib/help.mjs

@@ -0,0 +1,40 @@
+// Static wordmark; no terminal probes, image protocols or account reads.
+const font = {
+  D: ["████ ", "█   █", "█   █", "█   █", "████ "],
+  E: ["█████", "█    ", "████ ", "█    ", "█████"],
+  V: ["█   █", "█   █", "█   █", " █ █ ", "  █  "],
+  I: ["█████", "  █  ", "  █  ", "  █  ", "█████"],
+  A: [" ███ ", "█   █", "█████", "█   █", "█   █"],
+  N: ["█   █", "██  █", "█ █ █", "█  ██", "█   █"],
+};
+export function renderHelp(
+  text,
+  { tty = false, columns = 80, noColor = false, json = false } = {},
+) {
+  if (!tty || json) return text;
+  const paint = (value, color) =>
+    noColor ? value : `\x1b[38;5;${color}m${value}\x1b[0m`;
+  const banner =
+    columns >= 56
+      ? Array.from({ length: 5 }, (_, row) =>
+          paint(
+            [..."DEVDEVIAN"].map((c) => font[c][row]).join(" "),
+            [111, 105, 141, 177, 183][row],
+          ),
+        ).join("\n")
+      : paint("DEVDEVIAN", 141);
+  const content = text
+    .split("\n")
+    .map((line) => {
+      if (line.startsWith("Devdevian CLI")) return paint(line, 183);
+      return line.replace(
+        /^(  devdevian)(\s+[a-z]+(?:\s+(?:open|create|list|comment|thread|reply|resolve|reopen))?)?|(--[a-z][a-z-]*)/g,
+        (match, command, rest) =>
+          command
+            ? paint(command, 111) + (rest ? paint(rest, 183) : "")
+            : paint(match, 147),
+      );
+    })
+    .join("\n");
+  return `\n${banner}\n\n${content}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenyokjs/devdevian-cli",
-  "version": "0.6.0-alpha.1",
+  "version": "0.6.1-alpha.1",
   "description": "Devdevian in your terminal: discussions, questions and human code reviews.",
   "type": "module",
   "bin": {