@hybridlabor-api/aos 4.4.2-beta.5 → 4.4.2-beta.7

package/installer.js

@@ -1,5 +1,20 @@
 #!/usr/bin/env node
 
+// Node compatibility guard -- must run before any require() that could pull
+// in a dependency using the `node:` built-in scheme (@clack/prompts ->
+// @clack/core does `require('node:process')` internally), which only
+// resolves on Node >=14.18/>=16. On an older Node this crashed deep inside
+// that dependency with a bare "Cannot find module 'node:process'" -- no
+// mention of Node version anywhere -- reported from a real Windows machine
+// where the installer couldn't even start. Uses only process.version, a
+// built-in global with no require() of its own, so this check itself runs
+// on any Node version ever shipped.
+const NODE_MAJOR = parseInt(process.version.slice(1).split('.')[0], 10);
+if (Number.isFinite(NODE_MAJOR) && NODE_MAJOR < 20) {
+    console.error(`\nAOS requires Node.js 20 or newer -- this machine has ${process.version}.\nInstall a current Node.js from https://nodejs.org and re-run.\n`);
+    process.exit(1);
+}
+
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
@@ -2237,7 +2252,17 @@ function verifyEcosystemInstallation() {
 function resolveTargetPaths(platformValue, customPaths) {
     let targetSkillDir = globalConfigDir;
     let targetLegacyDir = globalLegacyDir;
-    let targetWorkspaceDir = workspaceDir;
+    // NOT the module-level `workspaceDir` (process.cwd()-based) -- that default
+    // is only correct for the Cursor branch below and the explicit Local
+    // Project Harness selection (platformValue '4' with customPaths), both of
+    // which are genuinely project-scoped by design. For every other platform,
+    // including this function's own top-level default used by the universal
+    // tier ('1'), a global Quick Update inherited a directory relative to
+    // whatever the current working directory happened to be -- silently
+    // harmless when cwd sat under the user's own home dir, but a hard EPERM
+    // crash the one time a Windows user ran npx from C:\Windows\System32
+    // (PowerShell's default start directory, unwritable for a normal user).
+    let targetWorkspaceDir = path.join(homeDir, '.agents', 'workspace_skills');
     let targetMcpDir = path.join(geminiDir, 'config');
     let mcpConfigPath = path.join(targetMcpDir, 'mcp_config.json');
     // Secondary MCP stores that must receive the same servers as mcpConfigPath
@@ -3303,8 +3328,13 @@ function generateAndOpenLaunchpad() {
     if (process.env.SSH_CLIENT || process.env.SSH_TTY) return;
 
     // Local Developer Workflow Guard:
-    // Only generate and open the launchpad if running in a local developer repo environment or explicitly requested
-    const isDevWorkflow = fs.existsSync(path.join(homeDir, 'bdb-dev')) ||
+    // Only generate and open the launchpad if running in a local developer repo environment or explicitly requested.
+    // ~/bdb-dev was the pre-reorg workspace root; the State-0 reorg moved it to
+    // ~/dev/bdb-dev, but this check was never updated -- it has been silently
+    // false on every real dev machine since that reorg. Checking both keeps
+    // this working regardless of which layout a given machine still has.
+    const isDevWorkflow = fs.existsSync(path.join(homeDir, 'dev', 'bdb-dev')) ||
+                          fs.existsSync(path.join(homeDir, 'bdb-dev')) ||
                           process.env.BDB_DEV === '1' ||
                           process.argv.includes('--launchpad') ||
                           process.argv.includes('--dev');
@@ -3464,8 +3494,8 @@ function generateAndOpenLaunchpad() {
         <div class="card-content">
           <div class="card-icon">⚡</div>
           <div class="card-info">
-            <h2>Agent Workspace</h2>
-            <p>Multi-Agent Cockpit & Orchestrator</p>
+            <h2>AO — Agent Orchestrator</h2>
+            <p>Multi-Agent Cockpit & Git-Worktree Orchestration</p>
           </div>
         </div>
         <div class="card-meta">
@@ -3473,6 +3503,19 @@ function generateAndOpenLaunchpad() {
           <span class="status-dot" id="dot-ao" title="Checking..."></span>
         </div>
       </a>
+      <a class="card" href="http://127.0.0.1:9080" target="_blank">
+        <div class="card-content">
+          <div class="card-icon">🌐</div>
+          <div class="card-info">
+            <h2>RemoteOS Gateway</h2>
+            <p>Multi-Cloud Execution & 4-Eyes Approval Gateway</p>
+          </div>
+        </div>
+        <div class="card-meta">
+          <span class="port-pill">:9080</span>
+          <span class="status-dot" id="dot-remote" title="Checking..."></span>
+        </div>
+      </a>
     </div>
     <div class="footer">
       <span>Autostart Daemons • 127.0.0.1</span>
@@ -3486,14 +3529,14 @@ function generateAndOpenLaunchpad() {
         .then(() => dot.classList.add('online'))
         .catch(() => dot.classList.remove('online'));
     }
-    checkHealth('http://127.0.0.1:8088', 'dot-memb');
-    checkHealth('http://127.0.0.1:7781', 'dot-synapse');
-    checkHealth('http://127.0.0.1:3101', 'dot-ao');
-    setInterval(() => {
+    function checkAllHealth() {
       checkHealth('http://127.0.0.1:8088', 'dot-memb');
       checkHealth('http://127.0.0.1:7781', 'dot-synapse');
       checkHealth('http://127.0.0.1:3101', 'dot-ao');
-    }, 5000);
+      checkHealth('http://127.0.0.1:9080', 'dot-remote');
+    }
+    checkAllHealth();
+    setInterval(checkAllHealth, 5000);
   </script>
 </body>
 </html>`;
@@ -3520,6 +3563,47 @@ function generateAndOpenLaunchpad() {
         child.on('error', warnOpenFailed);
         child.unref();
     } catch (e) { warnOpenFailed(e); }
+
+    // Opening it once per install/update isn't the same as being available at
+    // every login -- memB/Synapse/AO all get a real autostart entry for their
+    // own background services, but the dashboard itself (a static file, not
+    // a process) never got the equivalent: something to open it automatically
+    // on login too, not just right after an installer run.
+    if (process.platform === 'darwin') {
+        const plistPath = path.join(homeDir, 'Library', 'LaunchAgents', 'com.bdb.launchpad.plist');
+        const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.bdb.launchpad</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>open</string>
+        <string>${filePath}</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+</dict>
+</plist>`;
+        // Deliberately no KeepAlive: this launches a browser tab, not a
+        // long-running service -- `open` exits the moment it's handed the
+        // file to the browser, and KeepAlive would make launchd treat that
+        // normal exit as a crash to restart, reopening the tab in a loop.
+        try {
+            fs.writeFileSync(plistPath, plistContent);
+            execSync(`launchctl unload "${plistPath}" 2>/dev/null || true`, { stdio: 'ignore' });
+            execSync(`launchctl load -w "${plistPath}" 2>/dev/null || true`, { stdio: 'ignore' });
+        } catch (e) { logDebug(e, 'launchpad autostart plist'); }
+    } else if (process.platform === 'win32') {
+        const startupDir = path.join(process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming'), 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup');
+        const vbsPath = path.join(startupDir, 'com.bdb.launchpad.vbs');
+        const vbsContent = `Set WshShell = CreateObject("WScript.Shell")\r\nWshShell.Run """${filePath}""", 1, False\r\n`;
+        try {
+            fs.mkdirSync(startupDir, { recursive: true });
+            fs.writeFileSync(vbsPath, vbsContent, 'utf-8');
+        } catch (e) { logDebug(e, 'launchpad autostart vbs'); }
+    }
 }
 
 async function universalHarnessSync(primaryMcpConfigPath) {
@@ -3704,12 +3788,17 @@ async function runQuickUpdate(installState) {
 
     console.log('');
     verifyEcosystemInstallation();
+    // Fresh installs open this via universalHarnessSync(); Quick Update never
+    // did, so a dev-workflow machine only ever saw it once, on day one --
+    // every subsequent run is a Quick Update, which is what almost every
+    // real run after the first actually is.
+    generateAndOpenLaunchpad();
 }
 
 
 async function main() {
     const skipIntro = isAutoYes || process.argv.includes('--no-intro') || process.argv.includes('--no-animation');
-    await renderKineticIntro({ rotations: 1, fps: 12.5, skip: skipIntro });
+    await renderKineticIntro({ rotations: 1, fps: 12.5, skip: skipIntro, pkgVersion: pkg.version });
     console.log(buildWordmarkBanner());
 
     const installState = detectInstallState();

package/lib/startup-ui.js

@@ -19,7 +19,7 @@ const BRAND = {
  * Plays the 3D rotating BDB medallion kinetic intro in terminal.
  * Automatically clears frame buffer upon completion for smooth handoff to Clack.
  */
-async function renderKineticIntro({ rotations = 1, fps = 12.5, skip = false } = {}) {
+async function renderKineticIntro({ rotations = 1, fps = 12.5, skip = false, pkgVersion = '4.0.0' } = {}) {
     if (skip || !process.stdout.isTTY) return;
 
     const frames = framesData.ansi;
@@ -27,7 +27,7 @@ async function renderKineticIntro({ rotations = 1, fps = 12.5, skip = false } =
     const totalFrames = Math.round(rotations * frames.length);
 
     // Clear terminal screen and hide cursor for a clean viewport
-    process.stdout.write('\x1b]0;BDB Agent OS · AOS Installer v4.0.0\x07');
+    process.stdout.write(`\x1b]0;BDB Agent OS · AOS Installer v${pkgVersion}\x07`);
     process.stdout.write('\x1b[2J\x1b[H\x1b[?25l');
 
     return new Promise((resolve) => {
@@ -41,7 +41,7 @@ async function renderKineticIntro({ rotations = 1, fps = 12.5, skip = false } =
                 '\x1b[H',
                 ...lines.map(line => '\x1b[2K' + line),
                 '\x1b[2K',
-                `\x1b[2K  ${BRAND.lila}${BRAND.bold}━━━ BDB AGENT OS ━━━${BRAND.reset}  ${BRAND.white}${BRAND.bold}AOS Kernel v4.0.0${BRAND.reset}  ${BRAND.dim}· Initializing runtime...${BRAND.reset}`
+                `\x1b[2K  ${BRAND.lila}${BRAND.bold}━━━ BDB AGENT OS ━━━${BRAND.reset}  ${BRAND.white}${BRAND.bold}AOS Kernel v${pkgVersion}${BRAND.reset}  ${BRAND.dim}· Initializing runtime...${BRAND.reset}`
             ].join('\n');
 
             process.stdout.write(buffer);

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@hybridlabor-api/aos",
-  "version": "4.4.2-beta.5",
+  "version": "4.4.2-beta.7",
   "description": "AOS — A Curated AI AGENT OS. Optimized agent skills and add-ons like memB, OpenWiki, Heimdall Token Saver, and Godmode architectures.",
   "main": "installer.js",
+  "engines": {
+    "node": ">=20"
+  },
   "bin": {
     "aos": "installer.js",
     "bdb-dev-optimized-agent-skills": "installer.js",