@hybridlabor-api/aos 4.0.0 → 4.0.2

package/assets/header-builder-prompt.md

@@ -0,0 +1,37 @@
+# AOS Header Banner — Regeneration Prompt
+
+Reference for regenerating `assets/header-v4.jpg` (or its successor) via
+Nano Banana / Gemini image generation on a future version bump. Update the
+version string in the prompt and re-run rather than re-deriving the brand
+rules from scratch.
+
+## Brand constraints (from `~/dev/assets/bdb-brand/bdbagentOS/00_MASTER_BRANDING_SPEC.md`)
+
+- Dominant colors: Obsidian Black (`#0a0a0a` / `#141414`) and Base White (`#FFFFFF`).
+- Accent: Vibrant Orchid / Lila (`#9b30c4`) and Deep Plum (`#51116F`) — sparingly (rings, glow, gradient details), never the dominant fill.
+- Strict prohibitions: no mint/cyan, no rainbow/multi-hue gradients, no heartbeat lines, no heavy glassmorphism/blur, no ambient glow halos.
+- No personal names, studio names, or attribution baked into the image — product-level branding only.
+- Target dimensions: 1376x768 (16:9-ish wide banner, matches GitHub README width).
+
+## Working prompt (used for v4.0.0)
+
+> A wide banner image, 1376x768, pure black background (#0a0a0a). On the
+> left: the bold white wordmark "AOS" in a large, heavy sans-serif font,
+> with a smaller white subtitle "BDB AGENT OS" beneath it, and below that
+> a small rounded pill/badge containing the text "CORE KERNEL · AOS · v4.0.0"
+> in white on a dark badge. On the right: an abstract network/graph made of
+> glossy hexagonal nodes (mix of black and white hexagons, beveled/glossy
+> material) connected by thin magenta/lila (#9b30c4) lines, with a subtle
+> lila glow ring around some of the outer nodes. No other colors — strictly
+> black, white, and the lila accent. No text other than what's specified.
+> Clean, professional, high-contrast — not glassy/blurred, not a rainbow
+> gradient.
+
+## Notes for next regeneration
+
+- Keep the wordmark + hexagon-network composition (echoes the dispatcher-
+  graph architecture) unless the product story changes.
+- Only the version string in the badge needs updating for a routine bump.
+- Re-verify the output against the prohibitions above before committing —
+  Nano Banana can drift toward its default glow/gradient aesthetic if the
+  constraints aren't repeated explicitly.

package/installer.js

@@ -44,8 +44,14 @@ const {
     log
 } = clack;
 
+const {
+    renderKineticIntro,
+    buildHeroHeader,
+    buildTelemetryCard
+} = require('./lib/startup-ui.js');
+
 const pkgPath = path.join(__dirname, 'package.json');
-let pkg = { name: '@hybridlabor-api/bdb-dev-optimized-agent-skills', version: '3.9.6-beta' };
+let pkg = { name: '@hybridlabor-api/aos', version: '4.0.0' };
 if (fs.existsSync(pkgPath)) {
     try { pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8')); } catch (e) { logDebug(e, 'operation'); }
 }
@@ -56,12 +62,6 @@ const colors = {
     cyan: "\x1b[36m",
     purple: "\x1b[38;2;157;78;221m",
     purpleBold: "\x1b[1;\x1b[38;2;157;78;221m",
-    // v3.13 "NODEFORGE" release identity. The wordmark itself is drawn with a
-    // per-column pink -> yellow -> amethyst gradient computed in buildBanner();
-    // these named constants cover the surrounding chrome (divider, tagline) and
-    // the animation effects. Deliberately distinct from the purple/cyan beta
-    // banner so a push to `latest` is visually obvious, not just a
-    // version-number diff someone has to notice on their own.
     amethyst: "\x1b[38;2;155;89;182m",
     beige: "\x1b[38;2;222;202;168m",
     bannerWhite: "\x1b[38;2;255;255;255m",
@@ -1256,59 +1256,44 @@ async function installOpenWikiDaemon(apiKey, targetSkillDir, openwikiEnv = {}) {
     });
 }
 
-const GLITCH_CHARS = ['!', '@', '#', '$', '%', '^', '&', '*', '█', '▓', '▒', '░', '▄', '▀', '▌', '▐', '▆', '▇'];
+// Wordmark banner. Rendered after the kinetic intro finishes, before the
+// hero header -- the user wanted both kept, not one replacing the other.
+// Built programmatically rather than stored as an escaped string literal:
+// the wordmark carries a per-column pink -> yellow -> amethyst gradient,
+// which needs a truecolor escape emitted per character run.
+const BANNER_WORDMARK = [
+    "█████▄ ████▄  █████▄   ▄████▄  ▄████  ██████ ███  ██ ██████   ▄████▄ ▄█████ ",
+    "██▄▄██ ██  ██ ██▄▄██   ██▄▄██ ██  ▄▄▄ ██▄▄   ██ ▀▄██   ██     ██  ██ ▀▀▀▄▄▄ ",
+    "██▄▄█▀ ████▀  ██▄▄█▀   ██  ██  ▀███▀  ██▄▄▄▄ ██   ██   ██     ▀████▀ █████▀"
+];
 
-async function glitchBanner(bannerStr) {
-    if (!process.stdout.isTTY) return;
+function buildWordmarkBanner() {
+    const pink = [236, 72, 153];
+    const yellow = [255, 208, 66];
+    const amethystRgb = [155, 89, 182];
+    const lerp = (a, b, t) => a.map((v, i) => Math.round(v + (b[i] - v) * t));
+    const gradientAt = (t) => (t < 0.5 ? lerp(pink, yellow, t * 2) : lerp(yellow, amethystRgb, (t - 0.5) * 2));
 
-    const lines = bannerStr.split('\n');
-    const lineCount = lines.length;
-    
-    console.log(bannerStr);
-    
-    try {
-        process.stdout.write('\x1B[?25l');
-        const duration = 800;
-        const fps = 15;
-        const frameTime = Math.floor(1000 / fps);
-        const frames = Math.floor(duration / frameTime);
-        
-        for (let i = 0; i < frames; i++) {
-            readline.moveCursor(process.stdout, 0, -lineCount);
-            
-            const glitchedLines = lines.map(line => {
-                if (line.trim().length === 0) return line;
-                
-                let out = '';
-                let inEscape = false;
-                for (let j = 0; j < line.length; j++) {
-                    const c = line[j];
-                    if (c === '\x1B') inEscape = true;
-                    
-                    if (inEscape) {
-                        out += c;
-                        if (c === 'm') inEscape = false;
-                    } else {
-                        if (c !== ' ' && Math.random() < 0.05) {
-                            const gChar = GLITCH_CHARS[Math.floor(Math.random() * GLITCH_CHARS.length)];
-                            out += `${colors.magenta}${gChar}${colors.reset}`;
-                        } else {
-                            out += c;
-                        }
-                    }
-                }
-                return out;
-            });
-            
-            process.stdout.write(glitchedLines.join('\n') + '\n');
-            await new Promise(r => setTimeout(r, frameTime));
+    const width = Math.max(...BANNER_WORDMARK.map((l) => l.length));
+    const wordmark = BANNER_WORDMARK.map((line) => {
+        let out = '';
+        let lastCode = null;
+        for (let i = 0; i < line.length; i++) {
+            const ch = line[i];
+            if (ch === ' ') { out += ch; continue; }
+            const [r, g, b] = gradientAt(i / (width - 1));
+            const code = `\x1b[38;2;${r};${g};${b}m`;
+            if (code !== lastCode) { out += code; lastCode = code; }
+            out += ch;
         }
-        
-        readline.moveCursor(process.stdout, 0, -lineCount);
-        readline.clearScreenDown(process.stdout);
-    } finally {
-        process.stdout.write('\x1B[?25h');
-    }
+        return out + colors.reset;
+    }).join('\n');
+
+    const label = ' N O D E F O R G E ';
+    const fill = width - label.length;
+    const divider = '─'.repeat(Math.floor(fill / 2)) + label + '─'.repeat(fill - Math.floor(fill / 2));
+
+    return `${colors.bold}\n${wordmark}\n\n${colors.beige}${divider}${colors.reset}`;
 }
 
 async function runTopologyAnimation(backgroundTask, label) {
@@ -1495,20 +1480,35 @@ async function installMemB(interactive) {
                 ? path.join(membDir, '.venv', 'Scripts', 'python.exe')
                 : path.join(membDir, '.venv', 'bin', 'python');
 
+            let createdViaUv = false;
             if (!fs.existsSync(venvPython)) {
                 try {
                     execSync(`uv venv --seed .venv`, { cwd: membDir, stdio: 'ignore' });
+                    createdViaUv = true;
                 } catch (e1) {
                     execSync(`${pythonCmd} -m venv .venv`, { cwd: membDir, stdio: 'ignore' });
                 }
             }
 
-            const pipViaPython = `"${venvPython}" -m pip`;
-            runPipWithRetry(`${pipViaPython} install --upgrade setuptools --timeout 30 --no-input`, { cwd: membDir, stdio: 'ignore' }, 'pip setuptools for memB standalone', 2, 120000);
-            runPipWithRetry(`${pipViaPython} install -r requirements.txt --timeout 30 --no-input`, { cwd: membDir, stdio: 'inherit' }, 'pip install for memB standalone', 2, 900000);
+            // `uv venv --seed` is supposed to seed pip/setuptools/wheel into the venv, but
+            // this has been observed to silently under-deliver (venv created, pip missing) --
+            // when that happens every `-m pip install` call below fails with "No module named
+            // pip". `uv pip install --python <venv>` never needs pip present in the venv at
+            // all, so prefer it whenever uv itself is on PATH, regardless of which tool
+            // actually created the venv -- it's a strictly more reliable install path.
+            let hasUv = createdViaUv;
+            if (!hasUv) {
+                try { execSync('uv --version', { stdio: 'ignore' }); hasUv = true; } catch (e) { hasUv = false; }
+            }
+            const uvInstall = (pkgsArg) => `uv pip install --python "${venvPython}" ${pkgsArg}`;
+            const pipInstall = (pkgsArg) => `"${venvPython}" -m pip install ${pkgsArg} --timeout 30 --no-input`;
+            const installCmd = (pkgsArg) => hasUv ? uvInstall(pkgsArg) : pipInstall(pkgsArg);
+
+            runPipWithRetry(installCmd('--upgrade setuptools'), { cwd: membDir, stdio: 'ignore' }, 'pip setuptools for memB standalone', 2, 120000);
+            runPipWithRetry(installCmd('-r requirements.txt'), { cwd: membDir, stdio: 'inherit' }, 'pip install for memB standalone', 2, 900000);
 
             if (installWebUI && fs.existsSync(serverPy)) {
-                runPipWithRetry(`${pipViaPython} install fastapi uvicorn --timeout 30 --no-input`, { cwd: membDir, stdio: 'ignore' }, 'pip fastapi+uvicorn for memB WebUI', 2, 120000);
+                runPipWithRetry(installCmd('fastapi uvicorn'), { cwd: membDir, stdio: 'ignore' }, 'pip fastapi+uvicorn for memB WebUI', 2, 120000);
             }
         } catch (e) {
             log.warn(`Failed memB standalone venv setup: ${e.message}`);
@@ -1624,6 +1624,8 @@ async function installSynapse() {
     <array>
         ${binaryPath.endsWith('.js') ? `<string>/usr/local/bin/node</string>\n        <string>${binaryPath}</string>` : `<string>${binaryPath}</string>`}
         <string>serve</string>
+        <string>--port</string>
+        <string>7781</string>
     </array>
     <key>WorkingDirectory</key>
     <string>${synapseDir}</string>
@@ -1657,7 +1659,7 @@ async function installSynapse() {
             const stdoutLog = path.join(synapseLogDir, 'daemon.stdout.log');
             const stderrLog = path.join(synapseLogDir, 'daemon.stderr.log');
             const batPath = path.join(synapseLogDir, 'run-synapse.bat');
-            const runCmd = binaryPath.endsWith('.js') ? `node "${binaryPath}" serve` : `"${binaryPath}" serve`;
+            const runCmd = binaryPath.endsWith('.js') ? `node "${binaryPath}" serve --port 7781` : `"${binaryPath}" serve --port 7781`;
             // WshShell.Run has no stdout/stderr redirection of its own, so a crash on launch
             // (e.g. a missing dependency the binary shells out to) used to die silently with
             // nothing to diagnose short of reading source — route through a .bat wrapper that
@@ -1678,7 +1680,7 @@ async function installSynapse() {
                 if (isListening) {
                     log.success('Synapse 3D Windows Background Service registered & started (Port 7781)');
                 } else {
-                    log.warn(`Synapse 3D Windows daemon did not respond on Port 7781 within timeout. Check ${stderrLog} for the actual error (e.g. a missing 'go' on PATH) before assuming it's just slow to start.`);
+                    log.warn(`Synapse 3D Windows daemon did not respond on Port 7781 within timeout. Check ${stderrLog} for the actual error before assuming it's just slow to start.`);
                 }
             } catch (e) { logDebug(e, 'windows synapse daemon setup'); }
         }
@@ -1904,7 +1906,7 @@ function verifyEcosystemInstallation() {
         { name: '4. bdb-dev-creator-extension', pkg: '@hybridlabor-api/bdb-dev-creator-extension', paths: [path.join(moduleBasePath(), 'bdb-dev-creator-extension')] },
         { name: '5. bdb-os-remote', pkg: '@hybridlabor-api/bdb-os-remote', paths: [path.join(moduleBasePath(), 'bdb-os-remote')] },
         { name: '6. bdb-dev-tool-installer', pkg: '@hybridlabor-api/bdb-dev-tool-installer', paths: [path.join(moduleBasePath(), 'bdb-dev-tool-installer')] },
-        { name: '7. bdb-dev-optimized-agent-skills', pkg: '@hybridlabor-api/bdb-dev-optimized-agent-skills', paths: [srcDir] }
+        { name: '7. aos (bdb agent os)', pkg: '@hybridlabor-api/aos', paths: [srcDir] }
     ];
 
     for (const mod of modules) {
@@ -3268,6 +3270,20 @@ async function runQuickUpdate(installState) {
     syncSkillsToGlobalHarnesses(excludeSkills);
     s.stop('Skills refreshed');
 
+    // OpenWiki setup only ever ran on a brand-new install (main()'s fresh-install
+    // branch below) -- an existing install running Quick Update never got offered
+    // it and never had its daemon schedule refreshed. promptCredentials() already
+    // detects an existing key and collapses to a single "keep existing" prompt in
+    // that case, so this is a no-op confirm for anyone already configured and a
+    // real one-time offer for anyone who isn't (including installs from before
+    // this feature existed).
+    if (!isAutoYes) {
+        const creds = await promptCredentials(paths.targetMcpDir);
+        if (creds !== BACK) {
+            await installOpenWikiDaemon(creds.gemini, paths.targetSkillDir, { provider: creds.openwikiProvider, model: creds.openwikiModel, baseUrl: creds.openwikiBaseUrl });
+        }
+    }
+
     const modulesToUpdate = installState.installedModules || [];
     for (const subId of modulesToUpdate) {
         if (subId === 'synapse') await installSynapse();
@@ -3294,61 +3310,24 @@ async function runQuickUpdate(installState) {
 }
 
 
-// v3.13 "NODEFORGE" release banner. Built programmatically rather than stored
-// as one giant escaped string literal: the wordmark carries a per-column
-// pink -> yellow -> amethyst gradient, which needs a truecolor escape emitted
-// per character run. Hand-maintaining that as literal text would be
-// unreadable and near-impossible to edit safely.
-//
-// Width discipline: every rendered line stays <= 76 visible columns (the
-// wordmark's natural width), so the banner never wraps on an 80-column
-// terminal -- the same class of terminal-width bug this release already fixed
-// elsewhere. Changing the font means re-checking that number.
-const BANNER_WORDMARK = [
-    "█████▄ ████▄  █████▄   ▄████▄  ▄████  ██████ ███  ██ ██████   ▄████▄ ▄█████ ",
-    "██▄▄██ ██  ██ ██▄▄██   ██▄▄██ ██  ▄▄▄ ██▄▄   ██ ▀▄██   ██     ██  ██ ▀▀▀▄▄▄ ",
-    "██▄▄█▀ ████▀  ██▄▄█▀   ██  ██  ▀███▀  ██▄▄▄▄ ██   ██   ██     ▀████▀ █████▀"
-];
-
-function buildBanner() {
-    const pink = [236, 72, 153];
-    const yellow = [255, 208, 66];
-    const amethystRgb = [155, 89, 182];
-    const lerp = (a, b, t) => a.map((v, i) => Math.round(v + (b[i] - v) * t));
-    const gradientAt = (t) => (t < 0.5 ? lerp(pink, yellow, t * 2) : lerp(yellow, amethystRgb, (t - 0.5) * 2));
-
-    const width = Math.max(...BANNER_WORDMARK.map((l) => l.length));
-    const wordmark = BANNER_WORDMARK.map((line) => {
-        let out = '';
-        let lastCode = null;
-        for (let i = 0; i < line.length; i++) {
-            const ch = line[i];
-            if (ch === ' ') { out += ch; continue; }
-            const [r, g, b] = gradientAt(i / (width - 1));
-            const code = `\x1b[38;2;${r};${g};${b}m`;
-            if (code !== lastCode) { out += code; lastCode = code; }
-            out += ch;
-        }
-        return out + colors.reset;
-    }).join('\n');
-
-    const label = ' N O D E F O R G E ';
-    const fill = width - label.length;
-    const divider = '─'.repeat(Math.floor(fill / 2)) + label + '─'.repeat(fill - Math.floor(fill / 2));
-
-    const tagline = 'BDB AGENT OS · CORE KERNEL · AOS -  v4.0.0';
-    const taglinePad = ' '.repeat(Math.max(0, Math.floor((width - tagline.length) / 2)));
+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 });
+    console.log(buildWordmarkBanner());
 
-    return `${colors.bold}\n${wordmark}\n\n`
-        + `${colors.beige}${divider}${colors.reset}\n\n`
-        + `${colors.bannerWhite}${colors.bold}${taglinePad}${tagline}${colors.reset}`;
-}
+    const installState = detectInstallState();
+    const detections = detectPlatforms();
 
-async function main() {
-    const banner = buildBanner();
+    // Fast local daemon checks (150ms budget)
+    const aoOnline = await verifyDaemonListening(3101, 'AO Daemon', 150);
+    const remoteOsOnline = await verifyDaemonListening(9080, 'RemoteOS', 150);
+    const daemonStatus = [
+        { name: 'AO Orchestrator', port: 3101, online: aoOnline },
+        { name: 'RemoteOS Gateway', port: 9080, online: remoteOsOnline }
+    ];
 
-    await glitchBanner(banner);
-    intro(banner);
+    intro(buildHeroHeader(pkg.version));
+    console.log(buildTelemetryCard({ installState, detections, daemonStatus }));
 
     if (DRY_RUN) {
         log.warn('DRY-RUN MODE active - no files will be modified, no commands executed.');
@@ -3362,8 +3341,6 @@ async function main() {
         log.warn(`Update available: v${pkg.version} ➔ v${latest} — run: npx ${pkg.name}@latest`);
     }
 
-    const installState = detectInstallState();
-
     // Initialize session manifest – all copyDirRecursiveSync calls from here
     // forward will use manifest-aware writes automatically.
     initSessionManifest(installState.installManifest, [
@@ -3387,28 +3364,22 @@ async function main() {
     }
 
     if (installState.isInstalled && !isAutoYes) {
-        if (installState.updateAvailable) {
-            log.warn(`BDB AGENT OS installation detected: v${installState.localVersion} ➔ v${installState.currentVersion}`);
-        } else {
-            log.success(`BDB AGENT OS is already up to date (v${installState.currentVersion}).`);
-        }
-
         const options = installState.updateAvailable
             ? [
-                { value: 'quick', label: `⚡ Quick Update (v${installState.localVersion} ➔ v${installState.currentVersion}) – refresh skills & daemons, keep settings` },
-                { value: 'project', label: '📁 Drop Local Project Harness (in current directory)' },
-                { value: 'reconfigure', label: '🛠️ Full re-installation / re-configuration' },
+                { value: 'quick', label: `⚡ Quick Update (v${installState.localVersion} ➔ v${installState.currentVersion})`, hint: 'refresh skills, templates & daemons' },
+                { value: 'project', label: '📁 Drop Local Project Harness', hint: 'copy dispatcher contract to cwd' },
+                { value: 'reconfigure', label: '🛠️ Reconfigure System', hint: 'change targets, tier or options' },
                 { value: 'cancel', label: '❌ Exit' }
               ]
             : [
-                { value: 'project', label: '📁 Drop Local Project Harness (in current directory)' },
-                { value: 'reconfigure', label: '🛠️ Re-configuration / switch tier (Pro vs Basic)' },
-                { value: 'quick', label: '🔄 Repair / force reinstall all skills' },
+                { value: 'project', label: '📁 Drop Local Project Harness', hint: 'copy dispatcher contract to cwd' },
+                { value: 'quick', label: '🔄 Verify & Refresh All Skills', hint: 're-sync and health check' },
+                { value: 'reconfigure', label: '🛠️ Reconfigure System', hint: 'switch tier or targets' },
                 { value: 'cancel', label: '❌ Exit' }
               ];
 
         const action = pick(await select({
-            message: 'BDB OS maintenance:',
+            message: 'Select an operation:',
             options,
             initialValue: options[0].value
         }));
@@ -3429,26 +3400,18 @@ async function main() {
         }
     }
 
-    const detections = detectPlatforms();
-    if (detections.length > 0) {
-        log.info('Detected Agent Environments on this system:');
-        detections.forEach(d => log.message(`${d.name} (${d.path})`));
-    } else {
-        log.message('No active agent config directories auto-detected in standard locations.');
-    }
-
     const detectedNames = detections.map(d => d.name).join(', ');
     const platformOptions = [
-        { value: '9', label: 'Local Project Harness', hint: 'copy dispatcher contract to current project' },
         { value: '0', label: '🌐 Universal Agent Harness', hint: detections.length > 0 ? `sync ALL detected: ${detectedNames}` : 'sync across ALL AI platforms' },
         { value: '1', label: 'Google Antigravity', hint: '~/.gemini/config/skills' },
         { value: '2', label: 'Claude Desktop / Claude Code', hint: '~/.claude/skills' },
         { value: '3', label: 'Cursor / Generic IDE (project-local)', hint: '.cursor/' },
-        { value: '4', label: 'Custom Installation (specify paths manually)' },
         { value: '5', label: 'ChatGPT Codex CLI', hint: '~/.codex/skills' },
         { value: '6', label: 'Windsurf IDE', hint: '~/.windsurf' },
         { value: '7', label: 'Roo Code / Cline / VS Code', hint: '~/.roo' },
-        { value: '8', label: 'Aider CLI', hint: '~/.aider' }
+        { value: '8', label: 'Aider CLI', hint: '~/.aider' },
+        { value: '9', label: '📁 Local Project Harness', hint: 'copy dispatcher contract to current project' },
+        { value: '4', label: '⚙️ Custom Installation', hint: 'specify paths manually' }
     ];
 
     let tier = '1';

package/lib/startup-ui.js

@@ -0,0 +1,137 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const framesData = require('../assets/bdb-ascii-frames.js');
+
+// BDB Master Branding Design Tokens (00_MASTER_BRANDING_SPEC.md)
+const BRAND = {
+    lila: "\x1b[38;2;155;48;196m",     // #9b30c4 Vibrant Orchid
+    lilaDark: "\x1b[38;2;81;17;111m",   // #51116F Deep Plum
+    white: "\x1b[38;2;255;255;255m",   // #FFFFFF Base White
+    dim: "\x1b[38;2;115;115;125m",     // #73737D Muted / Telemetry Dim
+    emerald: "\x1b[38;2;16;185;129m",  // Status Success
+    amber: "\x1b[38;2;245;158;11m",    // Status Warning
+    reset: "\x1b[0m",
+    bold: "\x1b[1m"
+};
+
+/**
+ * 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 } = {}) {
+    if (skip || !process.stdout.isTTY) return;
+
+    const frames = framesData.ansi;
+    const tickMs = Math.round(1000 / fps);
+    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[2J\x1b[H\x1b[?25l');
+
+    return new Promise((resolve) => {
+        let currentFrame = 0;
+
+        const timer = setInterval(() => {
+            const frame = frames[currentFrame % frames.length];
+            const lines = frame.split('\n');
+
+            const buffer = [
+                '\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}`
+            ].join('\n');
+
+            process.stdout.write(buffer);
+            currentFrame++;
+
+            if (currentFrame >= totalFrames) {
+                clearInterval(timer);
+
+                // Cleanly clear the animation lines so Clack has a fresh, tidy viewport
+                process.stdout.write('\x1b[2J\x1b[H\x1b[?25h\x1b[0m');
+                resolve();
+            }
+        }, tickMs);
+    });
+}
+
+/**
+ * Builds the executive, studio-grade hero header for Clack intro.
+ */
+function buildHeroHeader(pkgVersion = '4.0.0') {
+    const title = `${BRAND.lila}${BRAND.bold}BDB AGENT OS${BRAND.reset} ${BRAND.dim}·${BRAND.reset} ${BRAND.white}${BRAND.bold}CORE KERNEL${BRAND.reset} ${BRAND.dim}·${BRAND.reset} ${BRAND.lila}${BRAND.bold}AOS${BRAND.reset} ${BRAND.dim}-  v${pkgVersion}${BRAND.reset}`;
+    const subtitle = `${BRAND.dim}Multi-Agent Skill & Power-Up Ecosystem · Claude, Antigravity, Codex, Cursor & more${BRAND.reset}`;
+    const sysInfo = `${BRAND.dim}Host: ${os.type()} ${os.arch()} · Node ${process.version} · PID ${process.pid}${BRAND.reset}`;
+
+    return `${title}\n│  ${subtitle}\n│  ${sysInfo}`;
+}
+
+/**
+ * Formats a clean pre-flight telemetry card to display before user choices.
+ */
+function buildTelemetryCard({ installState, detections, daemonStatus = [] }) {
+    const lines = [];
+    const G = BRAND.dim + '│' + BRAND.reset;
+    lines.push(`${G}`);
+    lines.push(`${G}  ${BRAND.bold}${BRAND.white}System Pre-Flight Telemetry${BRAND.reset}`);
+
+    // 1. Agent Platforms
+    const SHORT_NAMES = {
+        'Google Antigravity': 'Antigravity',
+        'ChatGPT Codex CLI': 'Codex CLI',
+        'Claude Code CLI': 'Claude Code',
+        'Roo Code / Cline / VS Code': 'Roo / Cline',
+        'Aider CLI': 'Aider',
+        'OpenCode CLI': 'OpenCode',
+        'Cursor / Generic IDE': 'Cursor',
+        'Windsurf IDE': 'Windsurf'
+    };
+
+    if (detections && detections.length > 0) {
+        const platformBadges = detections.map(d => `${BRAND.emerald}✔${BRAND.reset} ${BRAND.white}${SHORT_NAMES[d.name] || d.name}${BRAND.reset}`);
+        const maxPerRow = 4;
+        const rows = [];
+        for (let i = 0; i < platformBadges.length; i += maxPerRow) {
+            rows.push(platformBadges.slice(i, i + maxPerRow).join('   '));
+        }
+        lines.push(`${G}  ${BRAND.lila}├─${BRAND.reset} ${BRAND.dim}Agent Platforms:${BRAND.reset}  ${rows[0]}`);
+        for (let i = 1; i < rows.length; i++) {
+            lines.push(`${G}                    ${rows[i]}`);
+        }
+    } else {
+        lines.push(`${G}  ${BRAND.lila}├─${BRAND.reset} ${BRAND.dim}Agent Platforms:${BRAND.reset}  ${BRAND.dim}None auto-detected (universal harness mode available)${BRAND.reset}`);
+    }
+
+    // 2. Local Fleet Daemons
+    if (daemonStatus && daemonStatus.length > 0) {
+        const daemonBadges = daemonStatus
+            .map(d => `${d.online ? BRAND.emerald + '✔' : BRAND.dim + '○'} ${BRAND.white}${d.name}${BRAND.reset} ${BRAND.dim}(:${d.port})${BRAND.reset}`)
+            .join('   ');
+        lines.push(`${G}  ${BRAND.lila}├─${BRAND.reset} ${BRAND.dim}Fleet Daemons:${BRAND.reset}    ${daemonBadges}`);
+    }
+
+    // 3. Installation State
+    if (installState) {
+        if (installState.isInstalled) {
+            const versionStatus = installState.updateAvailable
+                ? `${BRAND.amber}v${installState.localVersion}${BRAND.reset} ➔ ${BRAND.emerald}${BRAND.bold}v${installState.currentVersion}${BRAND.reset} ${BRAND.amber}(Update Available)${BRAND.reset}`
+                : `${BRAND.emerald}✔${BRAND.reset} ${BRAND.white}v${installState.currentVersion}${BRAND.reset} ${BRAND.dim}(Current & Up-to-date)${BRAND.reset}`;
+            lines.push(`${G}  ${BRAND.lila}└─${BRAND.reset} ${BRAND.dim}Kernel State:${BRAND.reset}     ${versionStatus}`);
+        } else {
+            lines.push(`${G}  ${BRAND.lila}└─${BRAND.reset} ${BRAND.dim}Kernel State:${BRAND.reset}     ${BRAND.lila}Fresh Installation${BRAND.reset} ${BRAND.dim}(v${installState.currentVersion || '4.0.0'})${BRAND.reset}`);
+        }
+    }
+    lines.push(`${G}`);
+
+    return lines.join('\n');
+}
+
+module.exports = {
+    BRAND,
+    renderKineticIntro,
+    buildHeroHeader,
+    buildTelemetryCard
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hybridlabor-api/aos",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "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",
   "bin": {
@@ -24,6 +24,7 @@
   "files": [
     "installer.js",
     "bin/",
+    "lib/",
     "mcp_config.json",
     "GEMINI.md",
     "CODEX.md",