@lardexx/arenacode 2.5.4 → 2.5.5

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.5",
   "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,7 +137,7 @@ 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()}`));
@@ -160,8 +160,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;
 }
 
@@ -353,13 +355,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 +697,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 +741,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;