@lardexx/arenacode 2.5.4 → 2.5.6

package/README.md

@@ -40,7 +40,9 @@ rebuilt from opencode 1.19.5's own source (`packages/tui/src/component/prompt`,
 `logo.tsx`, `theme/assets/*.json`) and checked against frames captured from the installed binary in a pty.
 
 ```bash
-arenacode            # opens the TUI (the default when stdout is a terminal)
+arenacode            # opens the TUI on a terminal; on the very first run it asks for URL + key first
+arenacode ui         # same thing, explicitly
+arenacode chat       # the plain line-by-line client, if you really want one
 ```
 
 Home screen — two-tone block wordmark, centred prompt, tips, folder and version in the footer:

package/docs/PUBLISHING.md

@@ -1,8 +1,15 @@
 # Publishing
 
-**Live:** [`@lardexx/arenacode@2.5.3`](https://www.npmjs.com/package/@lardexx/arenacode) — 34 files, 226 kB tarball,
+**Live:** [`@lardexx/arenacode@2.5.5`](https://www.npmjs.com/package/@lardexx/arenacode) — 34 files, 226 kB tarball,
 no runtime dependencies. The command stays `arenacode`.
 
+2.5.5 fixes `main()` defaulting the subcommand to `chat`, which sent every bare `arenacode` to the line CLI and
+made the TUI unreachable without typing `ui`; a bare invocation now opens the interface, and on first run the
+interface asks for URL + key instead of printing a dead-end notice.
+
+2.5.4 made the hints launch-aware: run through npx and every message prints the command you can actually paste
+(`npx @lardexx/arenacode init`), plus the one-line way to get the bare `arenacode` command.
+
 ```bash
 npm install -g @lardexx/arenacode     # then: arenacode
 npx @lardexx/arenacode                # or one-shot
@@ -30,6 +37,7 @@ npm itself suggests the escape hatch in that error: publish under a scope. Hence
 | re-publish the same version | ❌ `409 Cannot publish over previously staged version "2.5.2"` |
 | `npm stage list` / `stage approve` | ❌ "No staged versions" / `stage-id must be a valid UUID` — nothing to approve from the CLI |
 | **bump to 2.5.3 and publish** | ✅ `+ @lardexx/arenacode@2.5.3`, `dist-tags.latest = 2.5.3` after ~2 min of async processing |
+| 2.5.4 (npx-aware hints) | ✅ same path, again ~1–2 min of async processing before it appeared |
 
 Two lessons for next time:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lardexx/arenacode",
-  "version": "2.5.4",
+  "version": "2.5.6",
   "description": "Terminal client for ArenaCode: talks to an arena-bridge, streams the Agent Mode timeline, and runs local commands and file operations on your PC. Node port of the ArenaCode desktop client.",
   "license": "MIT",
   "type": "commonjs",

package/src/cli.js

@@ -137,16 +137,17 @@ async function ensureAuth(ctx) {
 // commands
 // --------------------------------------------------------------------------- //
 
-async function cmdInit(flags) {
+async function cmdInit(flags, { tail = true } = {}) {
   banner(VERSION);
   const cfg = readConfig();
   write(c.gray(`  config file: ${configPath()}`));
   write('');
   const url = await ask(`  Bridge URL ${cfg.url ? c.gray(`[${cfg.url}]`) : ''}: `, { default: cfg.url });
   const key = await ask(`  API key ${cfg.key ? c.gray('[configured]') : ''}: `, { default: cfg.key });
-  const folder = await ask(`  Open folder ${c.gray(`[${cfg.folder || process.cwd()}]`)}: `, { default: cfg.folder || process.cwd() });
 
-  const next = { ...cfg, url: String(url).replace(/\/+$/, ''), key: String(key), folder: path.resolve(String(folder) || process.cwd()) };
+  // no folder question: arenacode always works in the directory it was started from
+  const next = { ...cfg, url: String(url).replace(/\/+$/, ''), key: String(key) };
+  delete next.folder;
   const file = writeConfig(next);
   write(`  ${c.green('✓')} saved ${c.gray(file)}`);
 
@@ -160,8 +161,10 @@ async function cmdInit(flags) {
   const auth = await bridge.authCheck();
   if (auth.status === 200) write(`  ${c.green('✓')} API key accepted`);
   else write(c.red(`  ✗ API key rejected: ${(auth.json && auth.json.error) || auth.status}`));
-  write('');
-  write(`  ${c.gray('try:')} arenacode ask "list the files in my folder"`);
+  if (tail) {
+    write('');
+    write(`  ${c.gray('try:')} arenacode ask "list the files in my folder"`);
+  }
   return 0;
 }
 
@@ -182,7 +185,7 @@ function cmdConfig(positional, flags) {
     const name = key;
     const val = rest.join(' ');
     if (!name || val === '') {
-      write(`usage: ${SELF} config set <url|key|folder|lang|mode|pc_access> <value>`);
+      write(`usage: ${SELF} config set <url|key|lang|mode|pc_access> <value>`);
       return 2;
     }
     const patch = {};
@@ -353,13 +356,25 @@ async function cmdAsk(positional, flags) {
 
 /** Full-screen TUI (opencode-style): timeline, input box, dialogs, local cards. */
 async function cmdUi(flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
+  let ctx = context(flags);
   if (!process.stdout.isTTY || !process.stdin.isTTY) {
+    if (!requireUrl(ctx)) return 1;
     write(c.red('  the TUI needs an interactive terminal.'));
     write(c.gray('  inside a script or a pipe use: arenacode ask "…" or arenacode chat'));
     return 1;
   }
+
+  // First run: `arenacode` (or `arenacode ui`) opens the setup here instead of printing two lines
+  // and quitting — the interface is what the user came for, the questions are just the way in.
+  if (!ctx.url) {
+    write('');
+    write(`  ${c.bold('first run')} ${c.gray('· bridge URL and API key (Enter keeps the value in brackets)')}`);
+    write('');
+    await cmdInit(flags, { tail: false });
+    write('');
+    ctx = context(flags);
+    if (!ctx.url) return 1;   // setup was abandoned: nothing to open
+  }
   const { App } = require('./tui/app');
   const app = new App({
     url: ctx.url,
@@ -683,7 +698,10 @@ function help() {
 
 async function main(argv) {
   const { flags, positional } = parseArgs(argv);
-  const [command = 'chat', ...rest] = positional;
+  // No default here: a bare `arenacode` must be distinguishable from `arenacode chat`, because only
+  // the bare form opens the TUI. Defaulting to 'chat' sent every plain invocation to the line CLI.
+  const [first = undefined, ...rest] = positional;
+  const command = first;
 
   if (flags.version || command === 'version') {
     write(VERSION);
@@ -724,13 +742,16 @@ async function main(argv) {
     case 'handshake':
       return cmdHandshake(flags);
     default:
+      if (command === undefined) {
+        // bare invocation: the interface, when there is a terminal to draw it on
+        if (process.stdout.isTTY && process.stdin.isTTY) return cmdUi(flags);
+        help();
+        return 0;
+      }
       if (command.startsWith('-')) {
         // `arenacode "instruction"` convenience form
         return cmdAsk(positional, flags);
       }
-      if ((command === 'chat' || command === undefined) && process.stdout.isTTY && process.stdin.isTTY) {
-        return cmdUi(flags);
-      }
       write(c.red(`  unknown command: ${command}`));
       help();
       return 2;

package/src/config.js

@@ -121,9 +121,12 @@ function resolveKey(cfg, flagKey) {
   return String(flagKey || process.env.ARENACODE_KEY || cfg.key || '').trim();
 }
 
+/**
+ * The folder arenacode works in: the one you launched it from. No stored default, so starting it in
+ * another project just works — `--folder` (or ARENACODE_FOLDER) still forces one.
+ */
 function openFolder(cfg, flagFolder) {
-  const folder = path.resolve(flagFolder || process.env.ARENACODE_FOLDER || cfg.folder || process.cwd());
-  return folder;
+  return path.resolve(flagFolder || process.env.ARENACODE_FOLDER || process.cwd());
 }
 
 module.exports = {

package/src/tui/app.js

@@ -95,7 +95,10 @@ class App {
   // ---------------------------------------------------------------- lifecycle
   async start() {
     this.term.enter();
-    this.term.on('key', (chunk) => this.parser.feed(chunk));
+    this.term.on('key', (chunk) => {
+      this.parser.feed(chunk);
+      this.flush();
+    });
     this.term.on('resize', () => this.invalidate());
     this.running = true;
 
@@ -124,6 +127,14 @@ class App {
     this.dirty = true;
   }
 
+  /**
+   * Keys used to wait for the render loop's next turn (up to 33 ms), which on Windows reads as
+   * lag when tapping through a list. Paint on the keystroke itself and keep the loop as fallback.
+   */
+  flush() {
+    if (this.dirty && !this.rendering) this.render();
+  }
+
   maybeRender() {
     if (this.dirty && !this.rendering) this.render();
   }
@@ -463,7 +474,6 @@ class App {
         if (h) this.push({ kind: 'system', text: `bridge v${h.version} · ${h.executor_mode} · claimable ${h.tasks.claimable}` });
         else this.toast('bridge unreachable', 'error');
       } },
-      { title: 'Bridge workspace files', run: () => this.openFiles() },
       { title: 'Help', hint: 'f1', run: () => this.openHelp() },
       { title: 'Quit', hint: 'ctrl+x q', run: () => this.quit() },
     ].map((cmd) => ({ ...cmd, slash: '/' + cmd.title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/-+$/, ''), group: 'Commands' }));
@@ -474,7 +484,6 @@ class App {
     return [
       { slash: '/new', title: 'Start a new session', hint: 'ctrl+x n', group: 'Session', run: () => this.commands()[1].run() },
       { slash: '/tasks', title: 'Show the task queue', hint: 'ctrl+x l', group: 'Session', run: () => this.openTasks() },
-      { slash: '/files', title: 'Browse the workspace files', hint: '', group: 'Session', run: () => this.openFiles() },
       { slash: '/mode', title: 'Switch agent / plan', hint: 'tab', group: 'Session', run: () => this.commands()[5].run() },
       { slash: '/theme', title: 'Cycle the colour theme', hint: 'ctrl+x t', group: 'Session', run: () => this.commands()[6].run() },
       { slash: '/status', title: 'Ping the bridge', hint: '', group: 'Session', run: () => this.commands()[7].run() },
@@ -1071,12 +1080,11 @@ class App {
   }
 
   modelName() {
-    return (this.state.health && (this.state.health.model || this.state.health.executor)) || 'arenacode';
+    return 'auto';
   }
 
   providerLabel() {
-    const v = (this.state.health && this.state.health.version) || VERSION;
-    return `bridge ${v}`;
+    return 'arena';
   }
 
   statusText() {
@@ -1105,13 +1113,11 @@ class App {
 
     if (this.isHome()) {
       const logo = W2.centerLines(logoLines(t), W);
-      const notify = this.notifyLine(W);
       const blockH = logo.length + 1 + prompt.lines.length + 2 + 1;
       const top = Math.max(1, Math.floor((H - 2 - blockH) / 2));
       for (let i = 0; i < top; i++) frame.push('');
       frame.push(...logo);
       frame.push('');
-      if (notify) frame.push(notify);
       const promptStart = frame.length;
       this._promptTop = promptStart;
       frame.push(...prompt.lines);
@@ -1170,15 +1176,6 @@ class App {
     if (this.dirty) setTimeout(() => this.maybeRender(), 16);
   }
 
-  notifyLine(W) {
-    const t = this.theme;
-    const st = this.state;
-    if (!st.connected) {
-      return W2.notifyLine(t, { width: W, command: '/connect', text: ` bridge offline at ${this.url}` });
-    }
-    return '';
-  }
-
   tipLine(W) {
     const t = this.theme;
     const tips = [

package/src/tui/logo.js

@@ -12,7 +12,7 @@
 const { fgSeq, bgSeq, RESET, tint } = require('./theme');
 
 const LOGO = {
-  left: ['                        ', '█▀▀█ █▀▀█ █▀▀█ █▀▀▄ █▀▀█', '█▀▀█ █▀▀▄ █^^^ █__█ █▀▀█', '▀▀▀▀ ▀~~▀ ▀▀▀▀ ▀~~▀ ▀▀▀▀'],
+  left: ['                        ', ';::█ █▀▀█ █▀▀█ █▀▀▄ ;::█', '█;;█ █▀▀▄ █^^^ █__█ █;;█', '   : ▀~~▀ ▀▀▀▀ ▀~~▀    :'],
   right: ['             ▄     ', '█▀▀▀ █▀▀█ █▀▀█ █▀▀█', '█___ █__█ █__█ █^^^', '▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀'],
 };
 
@@ -33,6 +33,9 @@ function paintLine(line, color, shadow, bold) {
     else if (ch === '^') out += bgFill(shadow, '▀', color, bold);
     else if (ch === '~') out += fgPaint(shadow, '▀', bold);
     else if (ch === ',') out += fgPaint(shadow, '▄', bold);
+    // plain half blocks in the letter colour: lets a glyph put a stroke on only one half of a cell
+    else if (ch === ':') out += fgPaint(color, '▀', bold);
+    else if (ch === ';') out += fgPaint(color, '▄', bold);
     else out += fgPaint(color, ch, bold);
   }
   return out;