@alumbwe/anvil 1.0.9 → 1.0.10

package/README.md

@@ -1,28 +1,38 @@
-# @anvil/cli
-
-A Terminal User Interface (TUI) package built with OpenTUI and React.
+# Anvil CLI
+
+Anvil is a free AI coding assistant for your terminal. It can inspect a
+project, edit files, and run commands while keeping the public product name
+and command as `anvil`.
 
 ## Installation
 
-```bash
-bun install
-```
+```bash
+npm install -g @alumbwe/anvil
+anvil
+```
+
+Anvil runs its bundled application with [Bun](https://bun.sh). Install Bun
+before running the command.
+
+Use your own process environment or a `.env` / `.env.local` file in the
+project you open with Anvil. Environment files are deliberately not embedded
+in the public npm package, so API keys and other secrets stay on your machine.
 
 ## Development
 
 Run the TUI in development mode:
 
-```bash
-bun run dev
-```
+```bash
+bun --cwd cli dev
+```
 
 ## Testing
 
 Run the test suite:
 
-```bash
-bun test
-```
+```bash
+bun test cli/src/utils/__tests__/terminal-command-broker.test.ts
+```
 
 ### Interactive E2E Testing
 
@@ -59,23 +69,14 @@ See [tmux.knowledge.md](tmux.knowledge.md) for comprehensive tmux documentation
 
 Build the package:
 
-```bash
-bun run build
-```
+```bash
+bun run --cwd cli typecheck
+bun run --cwd cli build:npm
+```
 
-## Run
-
-Run the built TUI:
-
-```bash
-bun run start
-```
-
-Or use the binary directly:
-
-```bash
-anvil-tui
-```
+`prepack` rebuilds the npm bundle automatically. The published package includes
+the CommonJS npm launcher, ESM bundle, tree-sitter asset, and vendored ripgrep
+binaries.
 
 ## Features
 

package/bin/anvil.cjs

@@ -6,37 +6,35 @@
  * with the bundled entry point.  When the user has bun installed globally
  * (`npm i -g bun`) the CLI works out of the box.
  */
-const { execFileSync, spawnSync } = require('child_process');
-const path = require('path');
-const fs = require('fs');
+const { spawnSync } = require('child_process')
+const path = require('path')
+const fs = require('fs')
 
-const bundledPath = path.join(__dirname, '..', 'dist', 'bundled.js');
+const bundledPath = path.join(__dirname, '..', 'dist', 'bundled.js')
 
 if (!fs.existsSync(bundledPath)) {
   console.error(
-    'Error: bundled CLI not found at ' + bundledPath + '\n' +
-    'Try reinstalling: npm i -g @alumbwe/anvil',
-  );
-  process.exit(1);
+    'Error: bundled CLI not found at ' +
+      bundledPath +
+      '\n' +
+      'Try reinstalling: npm i -g @alumbwe/anvil',
+  )
+  process.exit(1)
 }
 
-// Try bun first (preferred), then fall back to node.
-function tryRun(cmd, args) {
-  try {
-    const child = spawnSync(cmd, args, { stdio: 'inherit' });
-    if (child.error && child.error.code === 'ENOENT') return false;
-    process.exit(child.status ?? 1);
-  } catch {
-    return false;
-  }
+// bundled.js targets Bun. Running it with Node produces misleading module
+// loader errors, so fail clearly instead of attempting an unsupported fallback.
+const child = spawnSync('bun', [bundledPath, ...process.argv.slice(2)], {
+  stdio: 'inherit',
+})
+if (child.error && child.error.code === 'ENOENT') {
+  console.error(
+    'Error: Bun is required to run Anvil. Install it from https://bun.sh',
+  )
+  process.exit(1)
 }
-
-if (!tryRun('bun', [bundledPath, ...process.argv.slice(2)])) {
-  if (!tryRun('node', [bundledPath, ...process.argv.slice(2)])) {
-    console.error(
-      'Error: neither bun nor node found on PATH.\n' +
-      'Install bun: https://bun.sh',
-    );
-    process.exit(1);
-  }
+if (child.error) {
+  console.error(`Error: unable to start Bun: ${child.error.message}`)
+  process.exit(1)
 }
+process.exit(child.status ?? 1)