@hraness/wordcell 0.21.1 → 0.21.2

package/README.md

@@ -18,14 +18,14 @@ The CLI and TypeScript SDK run with Bun. Choose one installation source:
 
 ```sh
 # Canonical, versioned GitHub archive
-bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.21.1/hraness-wordcell-0.21.1.tgz
+bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.21.2/hraness-wordcell-0.21.2.tgz
 wordcell --help
 ```
 
 The same release is mirrored to [npm](https://www.npmjs.com/package/@hraness/wordcell):
 
 ```sh
-npm install --global --ignore-scripts @hraness/wordcell@0.21.1
+npm install --global --ignore-scripts @hraness/wordcell@0.21.2
 wordcell --help
 ```
 
@@ -39,7 +39,7 @@ Install the single public Agent Skill into your choice of compatible agent,
 including Claude Code, Codex, Cursor, or GitHub Copilot:
 
 ```sh
-bunx skills add hraness/wordcell#v0.21.1 --skill wordcell
+bunx skills add hraness/wordcell#v0.21.2 --skill wordcell
 ```
 
 Then ask:
@@ -161,7 +161,7 @@ exist. [Graph queries and proof limits](https://github.com/hraness/wordcell/blob
 Add the same immutable release to a Bun project:
 
 ```sh
-bun add --exact --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.21.1/hraness-wordcell-0.21.1.tgz
+bun add --exact --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.21.2/hraness-wordcell-0.21.2.tgz
 ```
 
 The SDK provides read-only vault sessions, metadata queries, search, graph

package/dist/cli.js

@@ -150,6 +150,18 @@ import {
 import"./index-5n05se68.js";
 import"./index-z1w83f81.js";
 
+// src/cli-intro.ts
+function terminalIntro(terminal) {
+  if (terminal.isTTY !== true || terminal.term === "dumb" || (terminal.columns ?? 80) < 48)
+    return "";
+  return ` .----.  /
+ | ===| /   wordcell
+ | ===|/   Markdown memory for your agents.
+ |____/
+
+`;
+}
+
 // src/cli-program.ts
 import { open } from "fs/promises";
 import { cpus, release, totalmem } from "os";
@@ -3618,6 +3630,8 @@ ${sanitizeTerminalText(usage)}`);
   }
   const command = parsed.value;
   if (command.kind === "help") {
+    if (output === defaultOutput2 && !jsonRequested)
+      output.stdout(terminalIntro({ isTTY: process.stdout.isTTY, columns: process.stdout.columns, term: process.env.TERM }));
     output.stdout(sanitizeTerminalText(usage));
     return 0;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/wordcell",
-  "version": "0.21.1",
+  "version": "0.21.2",
   "description": "A knowledge base for coding agents, built from Markdown, backlinks, semantic search, and Git context.",
   "license": "MIT",
   "type": "module",
@@ -295,6 +295,7 @@
     "src/capture.ts",
     "src/url-intelligence.ts",
     "src/cli.ts",
+    "src/cli-intro.ts",
     "src/cli-program.ts",
     "src/clip/acquire.ts",
     "src/clip/archive-today.ts",

package/skills/wordcell/SKILL.md

@@ -55,7 +55,7 @@ missing:
 ```sh
 command -v wordcell >/dev/null 2>&1 || {
   command -v bun >/dev/null 2>&1 || exit 1
-  bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.21.1/hraness-wordcell-0.21.1.tgz
+  bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.21.2/hraness-wordcell-0.21.2.tgz
 }
 wordcell --help
 ```

package/src/cli-intro.ts

@@ -0,0 +1,5 @@
+/** Compact ASCII identity for interactive root help; never command output. */
+export function terminalIntro(terminal: Readonly<{ isTTY: boolean | undefined; columns: number | undefined; term: string | undefined }>): string {
+  if (terminal.isTTY !== true || terminal.term === "dumb" || (terminal.columns ?? 80) < 48) return "";
+  return " .----.  /\n | ===| /   wordcell\n | ===|/   Markdown memory for your agents.\n |____/\n\n";
+}

package/src/cli-program.ts

@@ -1,3 +1,4 @@
+import { terminalIntro } from "./cli-intro.js";
 import { open } from "node:fs/promises";
 import { cpus, release, totalmem } from "node:os";
 import { relative, resolve } from "node:path";
@@ -3535,6 +3536,7 @@ export async function main(
   }
   const command = parsed.value;
   if (command.kind === "help") {
+    if (output === defaultOutput && !jsonRequested) output.stdout(terminalIntro({ isTTY: process.stdout.isTTY, columns: process.stdout.columns, term: process.env.TERM }));
     output.stdout(sanitizeTerminalText(usage));
     return 0;
   }