@ghl-ai/aw 0.1.44 → 0.1.46

package/c4/templates/scripts/aw-c4-bootstrap.sh

@@ -17,7 +17,8 @@
 #                @ghl-ai/aw@0.1.x for reproducible CI runs.
 set -Eeuo pipefail
 
-: "${GITHUB_PAT:?ERROR: Set GITHUB_PAT in your harness secrets UI before running aw c4}"
+# GitHub auth is resolved inside `aw c4` so GITHUB_PAT, GITHUB_TOKEN, and
+# no-token diagnostics stay centralized in the CLI preflight.
 
 # Ensure npm is on PATH. Cursor Cloud's install shell is non-interactive — nvm
 # is not auto-sourced, and Node may not be pre-installed at all. Walk common
@@ -30,6 +31,7 @@ set -Eeuo pipefail
 #     /usr/local/ or /opt/.
 #   - DEBIAN_FRONTEND=noninteractive prevents debconf prompts from hanging
 #     the apt configure step on a non-TTY shell.
+#   - Run apt-get directly when already root; use sudo only for non-root shells.
 #   - Drop the >/dev/null on apt + NodeSource setup so progress is visible.
 #     The previous "silent + interactive" combination produced the canonical
 #     "looks frozen" symptom in pilot use after Cursor Cloud stopped shipping
@@ -57,15 +59,28 @@ ensure_npm() {
     fi
   done
 
-  if command -v sudo >/dev/null 2>&1 && command -v apt-get >/dev/null 2>&1; then
+  if command -v apt-get >/dev/null 2>&1; then
     echo "[aw-c4-bootstrap] npm not found; installing Node 20 via NodeSource (1-2 min over corporate proxy)"
     export DEBIAN_FRONTEND=noninteractive
-    if ! timeout 180 bash -c 'curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -'; then
+    node_setup_command='curl -fsSL https://deb.nodesource.com/setup_20.x | bash -'
+    apt_install_command=(apt-get install -y nodejs)
+    current_uid="$(id -u 2>/dev/null || printf '1')"
+    if [ "$current_uid" != "0" ]; then
+      if command -v sudo >/dev/null 2>&1; then
+        node_setup_command='curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -'
+        apt_install_command=(sudo -E apt-get install -y nodejs)
+      else
+        echo "[aw-c4-bootstrap] FATAL: apt-get is available, but sudo is not, and the current user is not root" >&2
+        echo "[aw-c4-bootstrap]        Run as root, install sudo, or preinstall Node 20+ in the harness snapshot." >&2
+        exit 1
+      fi
+    fi
+    if ! timeout 180 bash -c "$node_setup_command"; then
       echo "[aw-c4-bootstrap] FATAL: NodeSource setup script timed out or failed after 180s" >&2
       echo "[aw-c4-bootstrap]        Preinstall Node 20+ in the agent snapshot, or check proxy reachability." >&2
       exit 1
     fi
-    if ! timeout 180 sudo -E apt-get install -y nodejs; then
+    if ! timeout 180 "${apt_install_command[@]}"; then
       echo "[aw-c4-bootstrap] FATAL: apt-get install nodejs timed out or failed after 180s" >&2
       exit 1
     fi

package/cli.mjs

@@ -26,6 +26,7 @@ const COMMANDS = {
   nuke:    () => import('./commands/nuke.mjs').then(m => m.nukeCommand),
   daemon:  () => import('./commands/daemon.mjs').then(m => m.daemonCommand),
   telemetry: () => import('./commands/telemetry.mjs').then(m => m.telemetryCommand),
+  integrations: () => import('./commands/integrations.mjs').then(m => m.integrationsCommand),
   'slack-sim': () => import('./commands/slack-sim.mjs').then(m => m.slackSimCommand),
   c4:      () => import('./commands/c4.mjs').then(m => m.c4Command),
   'init-repo': () => import('./commands/init-repo.mjs').then(m => m.initRepoCommand),
@@ -82,8 +83,9 @@ function printHelp() {
   const sec = (title) => `\n  ${chalk.bold.underline(title)}`;
   const help = [
     sec('Setup'),
-    cmd('aw init', 'Initialize workspace (platform/ only)'),
+    cmd('aw init', 'Initialize workspace (auto-installs suggested integrations)'),
     cmd('aw init --namespace <team/sub-team>', 'Add a team namespace (optional)'),
+    cmd('aw init --no-integrations', 'Skip integration setup (Codex, Caveman, Graphify, etc)'),
     `  ${chalk.dim('Teams: platform, revex, mobile, commerce, leadgen, crm, marketplace, ai')}`,
     `  ${chalk.dim('Example: aw init --namespace revex/courses')}`,
     cmd('aw init-repo', 'Scaffold cloud-bootstrap files (idempotent, --dry-run/--force/--diff)'),
@@ -109,6 +111,10 @@ function printHelp() {
     cmd('aw routing status', 'Show global AW session-routing mode for Claude/Cursor/Codex'),
     cmd('aw routing disable', 'Disable automatic AW session routing globally'),
     cmd('aw routing enable', 'Re-enable automatic AW session routing globally'),
+    cmd('aw integrations', 'Manage third-party integrations (Codex, Caveman, etc)'),
+    cmd('aw integrations add <key>', 'Install a specific tool (e.g. codex, caveman)'),
+    cmd('aw integrations remove <key>', 'Remove a tool'),
+    cmd('aw integrations bundle <name>', 'Install a preset bundle'),
     cmd('aw drop <path>', 'Stop syncing or delete local content'),
     cmd('aw nuke', 'Remove entire .aw_registry/ & start fresh'),
     cmd('aw daemon install', 'Auto-pull on a schedule (macOS launchd / Linux cron)'),

package/commands/init.mjs

@@ -34,6 +34,7 @@ import { loadConfig as ensureTelemetryConfig } from '../telemetry.mjs';
 import { installAwEcc, AW_ECC_TAG } from '../ecc.mjs';
 import { removeWorkspaceHookDefaults } from '../codex.mjs';
 import { readHookManifest, pruneStaleHooks, writeHookManifest } from '../hook-cleanup.mjs';
+import { promptAndInstall, autoInstallIntegrations } from '../integrations.mjs';
 import {
   initPersistentClone,
   isValidClone,
@@ -212,6 +213,7 @@ export async function initCommand(args) {
   let namespace = args['--namespace'] || null;
   let user = args['--user'] || '';
   const silent = args['--silent'] === true;
+  const skipIntegrations = args['--no-integrations'] === true;
 
   // In silent mode, suppress ALL fmt output and show a single spinner.
   // setSilent(true) makes every fmt.* call a no-op — internal functions
@@ -414,6 +416,12 @@ export async function initCommand(args) {
     // Write hook manifest after all hook installation is complete
     try { writeHookManifest({ eccVersion: AW_ECC_TAG, awVersion: VERSION }); } catch { /* best effort */ }
 
+    // Auto-install suggested integrations (Codex, Caveman, Graphify, etc) - unless --no-integrations
+    let installedIntegrations = [];
+    if (!silent && !skipIntegrations && !isNewSubTeam) {
+      installedIntegrations = await autoInstallIntegrations(freshCfg?.namespace || team, { silent });
+    }
+
     if (silent) {
       if (silentSpinner) { silentSpinner.stop('Done'); setSilent(false); }
       autoUpdate(await args._updateCheck);
@@ -427,6 +435,7 @@ export async function initCommand(args) {
           ? `  ${chalk.green('✓')} Removed ${removedLegacyStartupFiles.length} legacy repo startup file${removedLegacyStartupFiles.length > 1 ? 's' : ''}`
           : null,
         cwd !== HOME && isWorktree(join(cwd, '.aw')) ? `  ${chalk.green('✓')} Project linked` : null,
+        installedIntegrations.length > 0 ? `  ${chalk.green('✓')} Integrations: ${installedIntegrations.join(', ')}` : null,
       ].filter(Boolean).join('\n'));
     }
     return;
@@ -574,6 +583,12 @@ export async function initCommand(args) {
   // Ensure telemetry config exists (generates machine_id on first run)
   ensureTelemetryConfig();
 
+  // Auto-install suggested integrations (Codex, Caveman, Graphify, etc) - unless --no-integrations
+  let installedIntegrations = [];
+  if (!silent && !skipIntegrations) {
+    installedIntegrations = await autoInstallIntegrations(team, { silent });
+  }
+
   // Offer to update if a newer version is available
   if (!silent) await promptUpdate(await args._updateCheck);
 
@@ -593,10 +608,12 @@ export async function initCommand(args) {
     hooksInstalled ? `  ${chalk.green('✓')} Git hooks: auto-sync on pull/clone (core.hooksPath)` : null,
     `  ${chalk.green('✓')} IDE task: auto-sync on workspace open`,
     cwd !== HOME && isWorktree(join(cwd, '.aw')) ? `  ${chalk.green('✓')} Linked in current project` : null,
+    installedIntegrations.length > 0 ? `  ${chalk.green('✓')} Integrations: ${installedIntegrations.join(', ')}` : null,
     '',
     `  ${chalk.dim('Existing repos:')} ${chalk.bold('cd <project> && aw link')}`,
     `  ${chalk.dim('New clones:')}     auto-linked via git hook`,
     `  ${chalk.dim('Update:')}         ${chalk.bold('aw init')} ${chalk.dim('(or auto on pull/IDE open)')}`,
+    `  ${chalk.dim('Integrations:')}   ${chalk.bold('aw integrations')} ${chalk.dim('(manage Codex, Caveman, etc)')}`,
     `  ${chalk.dim('Uninstall:')}      ${chalk.bold('aw nuke')}`,
   ].filter(Boolean).join('\n'));
 }

package/commands/integrations.mjs

@@ -0,0 +1,254 @@
+// commands/integrations.mjs — CLI command: aw integrations add/remove/list/bundle
+
+import * as p from '@clack/prompts';
+import * as fmt from '../fmt.mjs';
+import { chalk } from '../fmt.mjs';
+import {
+  INTEGRATIONS,
+  BUNDLES,
+  installIntegration,
+  removeIntegration,
+  getInstalledList,
+} from '../integrations.mjs';
+
+export async function integrationsCommand(args) {
+  const subcommand = args._positional[0];
+
+  switch (subcommand) {
+    case 'add':
+      return cmdAdd(args);
+    case 'remove':
+      return cmdRemove(args);
+    case 'bundle':
+      return cmdBundle(args);
+    case 'list':
+    case undefined:
+      return cmdList();
+    default:
+      fmt.cancel(`Unknown subcommand: ${subcommand}`);
+  }
+}
+
+// ────────────────────────────────────────────────────────────────────────────────
+// aw integrations list
+// ────────────────────────────────────────────────────────────────────────────────
+
+async function cmdList() {
+  fmt.banner('Integrations', {
+    icon: '🔗',
+    subtitle: '  Available tools and MCP servers',
+  });
+
+  const installed = getInstalledList();
+
+  // Group by type
+  const plugins = Object.entries(INTEGRATIONS).filter(
+    ([, i]) => i.type === 'plugin'
+  );
+  const remoteRcps = Object.entries(INTEGRATIONS).filter(
+    ([, i]) => i.type === 'remote-mcp'
+  );
+  const universalInstallers = Object.entries(INTEGRATIONS).filter(
+    ([, i]) => i.type === 'universal-installer'
+  );
+  const pythonClis = Object.entries(INTEGRATIONS).filter(
+    ([, i]) => i.type === 'python-cli'
+  );
+
+  const typeIcon = (type) =>
+    type === 'plugin' ? '🔌' : type === 'remote-mcp' ? '🌐' : type === 'universal-installer' ? '🪨' : '⚙️';
+
+  // Installed section
+  if (installed.length > 0) {
+    fmt.logMessage(`\n${chalk.bold.underline('Installed')}`);
+    for (const key of installed) {
+      const integration = INTEGRATIONS[key];
+      if (!integration) continue;
+      fmt.logSuccess(`  ${typeIcon(integration.type)} ${integration.label}`);
+    }
+  }
+
+  // Available Plugins
+  fmt.logMessage(`\n${chalk.bold.underline('Available Plugins')}`);
+  for (const [key, integration] of plugins) {
+    if (!installed.includes(key)) {
+      fmt.logMessage(
+        `  🔌 ${integration.label.padEnd(25)} — ${integration.description}`
+      );
+    }
+  }
+
+  // Available Remote MCPs
+  fmt.logMessage(`\n${chalk.bold.underline('Available Remote MCPs')}`);
+  for (const [key, integration] of remoteRcps) {
+    if (!installed.includes(key)) {
+      fmt.logMessage(
+        `  🌐 ${integration.label.padEnd(25)} — ${integration.description}`
+      );
+    }
+  }
+
+  // Universal Installers
+  if (universalInstallers.length > 0) {
+    fmt.logMessage(`\n${chalk.bold.underline('Universal Tools')}`);
+    for (const [key, integration] of universalInstallers) {
+      if (!installed.includes(key)) {
+        fmt.logMessage(
+          `  🪨 ${integration.label.padEnd(25)} — ${integration.description}`
+        );
+      }
+    }
+  }
+
+  // Python CLIs
+  if (pythonClis.length > 0) {
+    fmt.logMessage(`\n${chalk.bold.underline('Available Python Tools')}`);
+    for (const [key, integration] of pythonClis) {
+      if (!installed.includes(key)) {
+        fmt.logMessage(
+          `  🐍 ${integration.label.padEnd(25)} — ${integration.description}`
+        );
+      }
+    }
+  }
+
+  // Bundles
+  fmt.logMessage(`\n${chalk.bold.underline('Bundles')}`);
+  for (const [bundleKey, bundle] of Object.entries(BUNDLES)) {
+    fmt.logMessage(
+      `  📦 ${bundle.label.padEnd(25)} — ${bundle.description}`
+    );
+    fmt.logMessage(
+      `     Includes: ${bundle.includes.map((k) => INTEGRATIONS[k].label).join(', ')}`
+    );
+  }
+
+  fmt.logMessage(`\n${chalk.dim('Commands:')}`);
+  fmt.logMessage(`  aw integrations add <key>      Install a specific tool`);
+  fmt.logMessage(`  aw integrations remove <key>   Remove a tool`);
+  fmt.logMessage(`  aw integrations bundle <name>  Install a preset bundle`);
+}
+
+// ────────────────────────────────────────────────────────────────────────────────
+// aw integrations add <key>
+// ────────────────────────────────────────────────────────────────────────────────
+
+async function cmdAdd(args) {
+  const key = args._positional[1];
+
+  if (!key) {
+    fmt.cancel('Usage: aw integrations add <key>');
+  }
+
+  if (!INTEGRATIONS[key]) {
+    // Suggest similar keys
+    const available = Object.keys(INTEGRATIONS);
+    fmt.cancel(
+      [
+        `Unknown integration: ${chalk.red(key)}`,
+        '',
+        `Available: ${available.join(', ')}`,
+      ].join('\n')
+    );
+  }
+
+  const integration = INTEGRATIONS[key];
+  fmt.intro(`Installing ${integration.label}`);
+
+  const success = await installIntegration(key, { silent: false });
+
+  if (success) {
+    fmt.outro(`✓ ${integration.label} installed successfully`);
+  } else {
+    fmt.cancel(`Failed to install ${integration.label}`);
+  }
+}
+
+// ────────────────────────────────────────────────────────────────────────────────
+// aw integrations remove <key>
+// ────────────────────────────────────────────────────────────────────────────────
+
+async function cmdRemove(args) {
+  const key = args._positional[1];
+
+  if (!key) {
+    fmt.cancel('Usage: aw integrations remove <key>');
+  }
+
+  if (!INTEGRATIONS[key]) {
+    const available = Object.keys(INTEGRATIONS);
+    fmt.cancel(
+      [
+        `Unknown integration: ${chalk.red(key)}`,
+        '',
+        `Available: ${available.join(', ')}`,
+      ].join('\n')
+    );
+  }
+
+  const integration = INTEGRATIONS[key];
+  fmt.intro(`Removing ${integration.label}`);
+
+  const success = await removeIntegration(key, { silent: false });
+
+  if (success) {
+    fmt.outro(`✓ ${integration.label} removed successfully`);
+  } else {
+    fmt.cancel(`Failed to remove ${integration.label}`);
+  }
+}
+
+// ────────────────────────────────────────────────────────────────────────────────
+// aw integrations bundle <bundleName>
+// ────────────────────────────────────────────────────────────────────────────────
+
+async function cmdBundle(args) {
+  const bundleName = args._positional[1];
+
+  if (!bundleName) {
+    fmt.cancel('Usage: aw integrations bundle <name>');
+  }
+
+  if (!BUNDLES[bundleName]) {
+    const available = Object.keys(BUNDLES);
+    fmt.cancel(
+      [
+        `Unknown bundle: ${chalk.red(bundleName)}`,
+        '',
+        `Available: ${available.join(', ')}`,
+      ].join('\n')
+    );
+  }
+
+  const bundle = BUNDLES[bundleName];
+  fmt.intro(`Installing bundle: ${bundle.label}`);
+
+  fmt.logMessage(`${bundle.description}\n`);
+  fmt.logMessage(`Includes:`);
+  for (const key of bundle.includes) {
+    const integration = INTEGRATIONS[key];
+    fmt.logMessage(`  • ${integration.label}`);
+  }
+
+  const confirm = await p.default.confirm({
+    message: `Continue installing ${bundle.includes.length} tool(s)?`,
+    initialValue: true,
+  });
+
+  if (p.default.isCancel(confirm) || !confirm) {
+    fmt.cancel('Cancelled');
+  }
+
+  fmt.logMessage('');
+
+  // Install all
+  let successCount = 0;
+  for (const key of bundle.includes) {
+    const success = await installIntegration(key, { silent: false });
+    if (success) successCount++;
+  }
+
+  fmt.outro(
+    `✓ Bundle installation complete (${successCount}/${bundle.includes.length} installed)`
+  );
+}