@k1e1n04/mav 0.1.0 → 0.1.2

package/README.md

@@ -31,14 +31,33 @@ brew tap k1e1n04/mav https://github.com/k1e1n04/mav.git
 brew install mav
 ```
 
-### npm / pnpm
+### npm
 
 ```bash
 npm install -g @k1e1n04/mav
-# or
+```
+
+Requires Xcode Command Line Tools (macOS) or `build-essential` (Linux) for the native `node-pty` module.
+
+```bash
+# macOS
+xcode-select --install
+
+# Ubuntu / Debian
+sudo apt-get install -y build-essential python3
+```
+
+### pnpm
+
+pnpm v10+ blocks install scripts by default. An extra step is needed after install:
+
+```bash
 pnpm add -g @k1e1n04/mav
+pnpm approve-builds -g   # select node-pty to allow its native build
 ```
 
+> **Tip:** On macOS, Homebrew handles all of this automatically — use it if you prefer a simpler install.
+
 ### Build from Source
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k1e1n04/mav",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Multi-agent view — manage multiple AI CLI sessions in one terminal",
   "type": "module",
   "bin": {
@@ -20,12 +20,14 @@
     "bin/",
     "lua/",
     "plugin/",
+    "scripts/",
     "LICENSE",
     "README.md"
   ],
   "scripts": {
     "build": "tsc && node scripts/postbuild.mjs",
     "dev": "tsx bin/mav.ts",
+    "postinstall": "node scripts/postinstall.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "prepublishOnly": "pnpm test && pnpm build"

package/scripts/postbuild.mjs

@@ -0,0 +1,2 @@
+import { chmodSync } from 'node:fs'
+chmodSync('dist/bin/mav.js', 0o755)

package/scripts/postinstall.mjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+// Rebuild node-pty's native binary if it wasn't built during install.
+// Runs automatically when installed via npm.
+// pnpm v10+ also blocks this script unless approved with `pnpm approve-builds -g`.
+import { execSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { dirname } from 'node:path'
+import { createRequire } from 'node:module'
+
+const require = createRequire(import.meta.url)
+
+function isPtyBuilt() {
+  try {
+    require('node-pty')
+    return true
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e)
+    // Only attempt rebuild when the native binary is missing.
+    return !msg.includes('pty.node')
+  }
+}
+
+if (!isPtyBuilt()) {
+  let ptyDir = null
+  try {
+    ptyDir = dirname(require.resolve('node-pty/package.json'))
+  } catch {
+    // node-pty not resolvable — nothing to do
+  }
+
+  if (ptyDir && existsSync(ptyDir)) {
+    process.stdout.write('[mav] Building node-pty native module...\n')
+    try {
+      execSync('node-gyp rebuild', { cwd: ptyDir, stdio: 'inherit' })
+      process.stdout.write('[mav] node-pty built successfully.\n')
+    } catch {
+      process.stderr.write('[mav] Warning: Could not build node-pty automatically.\n')
+      process.stderr.write('[mav] To fix manually: pnpm rebuild node-pty --global\n')
+      process.stderr.write('[mav] Requires build tools: https://github.com/nodejs/node-gyp#installation\n')
+    }
+  }
+}