@barnaby.build/barnaby 0.0.129 → 0.0.132

package/README.md

@@ -7,6 +7,31 @@ Barnaby is a desktop AI agent orchestrator for **agentic coordination** — conn
 - **API provider**: OpenRouter — free-tier and paid models via API key (ideal when CLI quotas are exhausted)
 - **UI experience**: Split layouts (horizontal, vertical, grid), workspace window, dark/light themes, zoom, activity timeline
 
+## Installation
+
+### Option 1: Download (recommended)
+
+[Download Barnaby](https://github.com/incendiosoftware/Barnaby/releases) — portable `.exe` for Windows. No install required.
+
+### Option 2: npm (requires Node.js 20+)
+
+**Quick run:**
+```bash
+npx '@barnaby.build/barnaby'
+```
+*PowerShell: use single quotes as shown. Bash/zsh: quotes optional.*
+
+**Global install:**
+```bash
+npm install -g '@barnaby.build/barnaby'
+barnaby
+```
+*PowerShell: use single quotes around the package name.*
+
+**Windows (npm install):** A Start menu shortcut is created automatically. Search "Barnaby" in Start. For correct taskbar icon, **pin the shortcut** (right‑click → Pin to taskbar), not the running window.
+
+---
+
 Latest Binary Release  
 [Download Barnaby v0.0.125](https://github.com/incendiosoftware/Barnaby/releases/tag/v0.0.125)
 

package/bin/barnaby.cjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 'use strict'
 
 const { spawn } = require('child_process')

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@barnaby.build/barnaby",
   "productName": "Barnaby",
-  "version": "0.0.129",
+  "version": "0.0.132",
   "main": "dist-electron/main/index.js",
   "bin": {
     "barnaby": "bin/barnaby.cjs"
@@ -11,6 +11,7 @@
     "dist-electron",
     "public",
     "bin",
+    "scripts",
     "package.json"
   ],
   "description": "Barnaby: local agent loops without API keys.",
@@ -26,7 +27,7 @@
   },
   "type": "module",
   "engines": {
-    "node": ">=20 <25"
+    "node": ">=20 <26"
   },
   "scripts": {
     "bump:version": "node scripts/bump-version.mjs",
@@ -44,6 +45,7 @@
     "release:notes": "node scripts/create-release-notes.mjs",
     "release:prepare": "npm run bump:version && npm run release:notes && npm run build:portable:raw",
     "publish": "gh workflow run release.yml -f releasable=true --ref main",
+    "postinstall": "node scripts/shortcut-win.mjs",
     "publish:npm": "npm run build && npm publish",
     "package:win": "npm run build:dist && electron-packager . Barnaby --platform=win32 --arch=x64 --out=release/0.0.1/packaged --overwrite --asar --prune=true --icon=build/icon.png",
     "preview": "vite preview",
@@ -68,6 +70,7 @@
     "@uiw/react-codemirror": "^4.25.4",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^5.3.0",
+    "barnaby": "^0.2.0",
     "electron-updater": "^6.3.9",
     "node-pty": "^1.0.0",
     "react-markdown": "^10.1.0",
@@ -75,6 +78,9 @@
     "react-syntax-highlighter": "^16.1.0",
     "remark-gfm": "^4.0.1"
   },
+  "optionalDependencies": {
+    "electron": "^40.6.0"
+  },
   "devDependencies": {
     "@electron/packager": "^19.0.5",
     "@playwright/test": "^1.48.2",

package/scripts/bump-version.mjs

@@ -0,0 +1,35 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+const root = process.cwd()
+const packageJsonPath = path.join(root, 'package.json')
+const packageLockPath = path.join(root, 'package-lock.json')
+
+function bumpPatch(version) {
+  const parts = String(version).trim().split('.')
+  if (parts.length !== 3) {
+    throw new Error(`Expected semantic version x.y.z, got "${version}"`)
+  }
+  const [major, minor, patch] = parts.map((p) => Number(p))
+  if ([major, minor, patch].some((n) => Number.isNaN(n))) {
+    throw new Error(`Expected numeric semantic version, got "${version}"`)
+  }
+  return `${major}.${minor}.${patch + 1}`
+}
+
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'))
+const currentVersion = packageJson.version
+const nextVersion = bumpPatch(currentVersion)
+packageJson.version = nextVersion
+fs.writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, 'utf8')
+
+if (fs.existsSync(packageLockPath)) {
+  const packageLock = JSON.parse(fs.readFileSync(packageLockPath, 'utf8'))
+  if (typeof packageLock.version === 'string') packageLock.version = nextVersion
+  if (packageLock.packages && packageLock.packages[''] && typeof packageLock.packages[''].version === 'string') {
+    packageLock.packages[''].version = nextVersion
+  }
+  fs.writeFileSync(packageLockPath, `${JSON.stringify(packageLock, null, 2)}\n`, 'utf8')
+}
+
+console.log(`Version bumped: ${currentVersion} -> ${nextVersion}`)

package/scripts/create-release-notes.mjs

@@ -0,0 +1,47 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+const root = process.cwd()
+const packageJsonPath = path.join(root, 'package.json')
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'))
+const version = String(packageJson.version || '').trim()
+
+if (!version) {
+  throw new Error('package.json version is missing.')
+}
+
+const notesFilename = `RELEASE_NOTES_${version}.md`
+const notesPath = path.join(root, notesFilename)
+
+if (fs.existsSync(notesPath)) {
+  console.log(`Release notes already exist: ${notesFilename}`)
+  process.exit(0)
+}
+
+const now = new Date()
+const month = now.toLocaleString('en-US', { month: 'long' })
+const year = now.getFullYear()
+
+const template = `# Barnaby ${version} - Release Notes
+
+**Released:** ${month} ${year}
+
+## Added
+
+- TODO
+
+## Changed
+
+- TODO
+
+## Fixed
+
+- TODO
+
+## Notes
+
+- Artifact: \`release/${version}/Barnaby_${version}_portable.exe\`
+`
+
+fs.writeFileSync(notesPath, template, 'utf8')
+console.log(`Created ${notesFilename}`)

package/scripts/dev-clean.mjs

@@ -0,0 +1,27 @@
+import { execSync } from 'node:child_process'
+
+function run(cmd) {
+  try {
+    execSync(cmd, { stdio: 'pipe', windowsHide: true })
+  } catch {
+    // best effort cleanup only
+  }
+}
+
+if (process.platform === 'win32') {
+  // Free Vite default port if stale process is still attached.
+  run(
+    `powershell -NoProfile -ExecutionPolicy Bypass -Command "$p = netstat -ano | Select-String ':5173' | ForEach-Object { ($_ -split '\\s+')[-1] } | Sort-Object -Unique; foreach ($id in $p) { try { Stop-Process -Id ([int]$id) -Force -ErrorAction Stop } catch {} }"`,
+  )
+
+  // Kill stale Electron instances from this workspace.
+  run(
+    `powershell -NoProfile -ExecutionPolicy Bypass -Command "Get-Process electron -ErrorAction SilentlyContinue | Where-Object { $_.Path -like '*AgentOrchestrator*\\\\node_modules\\\\electron\\\\dist\\\\electron.exe' } | ForEach-Object { try { Stop-Process -Id $_.Id -Force -ErrorAction Stop } catch {} }"`,
+  )
+} else {
+  // Unix-like fallback: free 5173 and terminate matching electron instances.
+  run(`sh -lc "lsof -ti :5173 | xargs -r kill -9"`)
+  run(`sh -lc "ps aux | grep '[e]lectron' | grep 'AgentOrchestrator' | awk '{print $2}' | xargs -r kill -9"`)
+}
+
+console.log('dev-clean completed')

package/scripts/shortcut-win.mjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+/**
+ * Creates a Start menu shortcut for Barnaby on Windows (global install only).
+ * Fixes: (1) App not findable in Windows search (2) Taskbar pinning shows Electron.
+ * Tip: Pin the "Barnaby" shortcut from Start menu to taskbar for correct icon.
+ */
+import { platform } from 'node:os'
+import { existsSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { execSync } from 'node:child_process'
+
+function main() {
+  if (platform() !== 'win32') return
+  if (process.env.npm_config_global !== 'true') return
+
+  const __dirname = dirname(fileURLToPath(import.meta.url))
+  const pkgRoot = join(__dirname, '..')
+
+  // Use node + our script directly (barnaby.cmd may not exist yet when postinstall runs)
+  const barnabyScript = join(pkgRoot, 'bin', 'barnaby.cjs')
+  if (!existsSync(barnabyScript)) return
+  const nodeExe = process.execPath
+
+  const iconPath = [
+  join(pkgRoot, 'dist', 'appicon.png'),
+  join(pkgRoot, 'public', 'appicon.png'),
+  join(pkgRoot, 'dist', 'favicon.ico'),
+  join(pkgRoot, 'public', 'favicon.ico'),
+  join(pkgRoot, 'build', 'icon.png')
+  ].find(existsSync)
+  const startMenuDir = join(process.env.APPDATA || '', 'Microsoft', 'Windows', 'Start Menu', 'Programs')
+  const shortcutPath = join(startMenuDir, 'Barnaby.lnk')
+
+  const ps = `
+$WshShell = New-Object -ComObject WScript.Shell
+$Shortcut = $WshShell.CreateShortcut('${shortcutPath.replace(/'/g, "''")}')
+$Shortcut.TargetPath = '${nodeExe.replace(/'/g, "''")}'
+$Shortcut.Arguments = '${barnabyScript.replace(/'/g, "''")}'
+$Shortcut.WorkingDirectory = '${(process.env.USERPROFILE || '').replace(/'/g, "''")}'
+$Shortcut.Description = 'Barnaby - AI agent IDE'
+${iconPath ? `if (Test-Path '${iconPath.replace(/'/g, "''")}') { $Shortcut.IconLocation = '${iconPath.replace(/'/g, "''")},0' }` : ''}
+$Shortcut.Save()
+  `
+  try {
+    const tmp = join(process.env.TEMP || '', 'barnaby-shortcut.ps1')
+    writeFileSync(tmp, ps.trim(), 'utf8')
+    execSync(`powershell -NoProfile -ExecutionPolicy Bypass -File "${tmp}"`, { stdio: 'pipe' })
+    console.log('[Barnaby] Start menu shortcut created. Pin it to taskbar for the correct icon.')
+  } catch {
+  // Silent fail - shortcut is optional
+}
+}
+
+main()