@ghl-ai/aw 0.1.20 → 0.1.22

package/commands/init.mjs

@@ -4,7 +4,7 @@
 // Uses git's built-in template hooks for automatic linking on clone/checkout.
 // Uses IDE tasks for auto-pull on workspace open.
 
-import { mkdirSync, existsSync, writeFileSync, symlinkSync, chmodSync } from 'node:fs';
+import { mkdirSync, existsSync, writeFileSync, symlinkSync, chmodSync, copyFileSync } from 'node:fs';
 import { execSync } from 'node:child_process';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
@@ -111,6 +111,18 @@ function saveManifest(data) {
   writeFileSync(MANIFEST_PATH, JSON.stringify(data, null, 2) + '\n');
 }
 
+// Place AW-PROTOCOL.md at .aw_registry root so any namespace can reference it
+// as .aw_registry/AW-PROTOCOL.md regardless of team name.
+// Source of truth in repo: registry/AW-PROTOCOL.md (mirrors this root placement).
+// After ghl is pulled, ghl/AW-PROTOCOL.md is the local copy we hoist from.
+function hoistProtocol(registryDir) {
+  const src = join(registryDir, 'ghl', 'AW-PROTOCOL.md');
+  const dest = join(registryDir, 'AW-PROTOCOL.md');
+  if (existsSync(src)) {
+    copyFileSync(src, dest);
+  }
+}
+
 export async function initCommand(args) {
   const namespace = args['--namespace'] || null;
   let user = args['--user'] || '';
@@ -139,6 +151,9 @@ export async function initCommand(args) {
     // Pull latest
     pullCommand({ ...args, _positional: [], _workspaceDir: GLOBAL_AW_DIR, '--silent': silent });
 
+    // Hoist AW-PROTOCOL.md to registry root
+    hoistProtocol(GLOBAL_AW_DIR);
+
     // Re-link IDE dirs (idempotent)
     linkWorkspace(HOME);
     generateCommands(HOME);
@@ -190,6 +205,9 @@ export async function initCommand(args) {
   // Step 2: Pull registry content
   pullCommand({ ...args, _positional: ['ghl'], _workspaceDir: GLOBAL_AW_DIR });
 
+  // Hoist AW-PROTOCOL.md to registry root so all namespaces can access it
+  hoistProtocol(GLOBAL_AW_DIR);
+
   if (namespace) {
     pullCommand({ ...args, _positional: ['[template]'], _renameNamespace: namespace, _workspaceDir: GLOBAL_AW_DIR });
   }

package/constants.mjs

@@ -1,7 +1,7 @@
 // constants.mjs — Single source of truth for registry settings.
 
 /** Base branch for PRs and sync checkout */
-export const REGISTRY_BASE_BRANCH = 'master';
+export const REGISTRY_BASE_BRANCH = 'chore/imp-command';
 
 /** Default registry repository */
 export const REGISTRY_REPO = 'GoHighLevel/ghl-agentic-workspace';

package/git.mjs

@@ -58,5 +58,6 @@ export function includeToSparsePaths(paths) {
   // Also fetch root instruction files
   result.add('registry/CLAUDE.md');
   result.add('registry/AGENTS.md');
+  result.add('registry/AW-PROTOCOL.md');
   return [...result];
 }

package/link.mjs

@@ -201,6 +201,22 @@ export function linkWorkspace(cwd) {
     }
   }
 
+  // AW-PROTOCOL.md: symlink into each IDE dir root so commands can always find it
+  const protocolSrc = join(awDir, 'AW-PROTOCOL.md');
+  if (existsSync(protocolSrc)) {
+    for (const ide of IDE_DIRS) {
+      const linkPath = join(cwd, ide, 'AW-PROTOCOL.md');
+      const relTarget = relative(join(cwd, ide), protocolSrc);
+      try {
+        if (existsSync(linkPath) || lstatSync(linkPath).isSymbolicLink()) unlinkSync(linkPath);
+      } catch { /* not there yet */ }
+      try {
+        execSync(`ln -sfn "${relTarget}" "${linkPath}"`, { stdio: 'pipe' });
+        created++;
+      } catch { /* best effort */ }
+    }
+  }
+
   if (created > 0) {
     fmt.logSuccess(`Linked ${created} IDE symlink${created > 1 ? 's' : ''}`);
   }

package/mcp.mjs

@@ -1,4 +1,5 @@
-// mcp.mjs — MCP config generation for all 3 IDEs (init only, never overwrites)
+// mcp.mjs — MCP config generation for Claude Code + Cursor (global ~/ configs)
+// Uses native Streamable HTTP — no bridge process needed.
 
 import { existsSync, writeFileSync, readFileSync, mkdirSync } from 'node:fs';
 import { join, resolve } from 'node:path';
@@ -6,149 +7,102 @@ import { homedir } from 'node:os';
 import * as fmt from './fmt.mjs';
 
 const HOME = homedir();
+const DEFAULT_MCP_URL = 'https://staging.services.leadconnectorhq.com/agentic-workspace/mcp';
 
 /**
  * Auto-detect MCP server paths.
  */
 function detectPaths() {
-  const ghlAiBridge = join(HOME, '.claude', 'ghl-ai-bridge.mjs');
   const gitJenkinsCandidates = [
     join(HOME, 'Documents', 'GitHub', 'git-jenkins-mcp', 'dist', 'index.js'),
     resolve('..', 'git-jenkins-mcp', 'dist', 'index.js'),
   ];
 
   const gitJenkinsPath = gitJenkinsCandidates.find(p => existsSync(p)) || null;
-  const ghlMcpUrl = process.env.GHL_MCP_URL || 'https://ghl-ai-staging.highlevel-staging.com';
+  const ghlMcpUrl = process.env.GHL_MCP_URL || DEFAULT_MCP_URL;
 
-  return {
-    ghlAiBridge: existsSync(ghlAiBridge) ? ghlAiBridge : null,
-    gitJenkinsPath,
-    ghlMcpUrl,
-  };
+  return { gitJenkinsPath, ghlMcpUrl };
 }
 
 /**
- * Setup MCP configs for all IDEs. Only writes if file doesn't exist.
- * Returns list of file paths that were actually created.
+ * Setup MCP configs globally for Claude Code and Cursor.
+ * Merges ghl-ai server into existing configs without overwriting other servers.
+ * Returns list of file paths that were created or updated.
  */
 export function setupMcp(cwd, namespace) {
   const paths = detectPaths();
-  const createdFiles = [];
+  const updatedFiles = [];
 
-  const attempt = (filePath, contentFn, append = false) => {
-    if (writeIfMissing(filePath, contentFn, append)) {
-      createdFiles.push(filePath);
-    }
-  };
-
-  // .claude/settings.local.json
-  attempt(join(cwd, '.claude', 'settings.local.json'), () => {
-    const servers = {};
-    if (paths.ghlAiBridge) {
-      servers['ghl-ai'] = {
-        command: 'node',
-        args: [paths.ghlAiBridge],
-        env: { GHL_MCP_URL: paths.ghlMcpUrl, TEAM_NAME: namespace || '' },
-      };
-    }
-    if (paths.gitJenkinsPath) {
-      servers['git-jenkins'] = { command: 'node', args: [paths.gitJenkinsPath] };
-    }
-    if (Object.keys(servers).length === 0) return null;
-    return JSON.stringify({ mcpServers: servers }, null, 2) + '\n';
-  });
-
-  // .cursor/mcp.json
-  attempt(join(cwd, '.cursor', 'mcp.json'), () => {
-    const servers = {};
-    if (paths.ghlAiBridge) {
-      servers['ghl-ai'] = {
-        command: 'node',
-        args: [paths.ghlAiBridge],
-        env: { GHL_MCP_URL: paths.ghlMcpUrl, TEAM_NAME: namespace || '' },
-      };
-    }
-    if (paths.gitJenkinsPath) {
-      servers['git-jenkins'] = { command: 'node', args: [paths.gitJenkinsPath] };
-    }
-    if (Object.keys(servers).length === 0) return null;
-    return JSON.stringify({ mcpServers: servers }, null, 2) + '\n';
-  });
-
-  // .codex/config.toml — append MCP servers
-  const codexConfig = join(cwd, '.codex', 'config.toml');
-  if (!hasMcpSection(codexConfig)) {
-    attempt(codexConfig, () => {
-      const lines = [];
-      if (paths.ghlAiBridge) {
-        lines.push(
-          '[mcp_servers.ghl-ai]',
-          'command = "node"',
-          `args = ["${paths.ghlAiBridge}"]`,
-          '',
-          '[mcp_servers.ghl-ai.env]',
-          `GHL_MCP_URL = "${paths.ghlMcpUrl}"`,
-          `TEAM_NAME = "${namespace || ''}"`,
-          '',
-        );
-      }
-      if (paths.gitJenkinsPath) {
-        lines.push(
-          '[mcp_servers.git-jenkins]',
-          'command = "node"',
-          `args = ["${paths.gitJenkinsPath}"]`,
-          '',
-        );
-      }
-      if (lines.length === 0) return null;
-      return lines.join('\n');
-    }, true /* append mode */);
-  }
+  const mcpUrl = paths.ghlMcpUrl;
 
-  // mcp.json at project root (Claude Code auto-discovery)
-  attempt(join(cwd, 'mcp.json'), () => {
-    const servers = {};
-    if (paths.ghlAiBridge) {
-      servers['ghl-ai'] = {
-        command: 'node',
-        args: [paths.ghlAiBridge],
-        env: { GHL_MCP_URL: paths.ghlMcpUrl, TEAM_NAME: namespace || '' },
-      };
-    }
-    if (Object.keys(servers).length === 0) return null;
-    return JSON.stringify({ mcpServers: servers }, null, 2) + '\n';
-  });
+  const ghlAiServer = { type: 'url', url: mcpUrl };
+  const gitJenkinsServer = paths.gitJenkinsPath
+    ? { command: 'node', args: [paths.gitJenkinsPath] }
+    : null;
 
-  if (createdFiles.length > 0) {
-    fmt.logSuccess(`Created ${createdFiles.length} MCP config${createdFiles.length > 1 ? 's' : ''}`);
+  // ── Claude Code: ~/.claude/settings.json ──
+  const claudeSettingsPath = join(HOME, '.claude', 'settings.json');
+  if (mergeJsonMcpServer(claudeSettingsPath, 'ghl-ai', ghlAiServer)) {
+    updatedFiles.push(claudeSettingsPath);
+  }
+  if (gitJenkinsServer && mergeJsonMcpServer(claudeSettingsPath, 'git-jenkins', gitJenkinsServer)) {
+    updatedFiles.push(claudeSettingsPath);
   }
 
-  const warnings = [];
-  if (!paths.ghlAiBridge) warnings.push('ghl-ai bridge not found at ~/.claude/ghl-ai-bridge.mjs');
-  if (!paths.gitJenkinsPath) warnings.push('git-jenkins MCP not found');
-  for (const w of warnings) {
-    fmt.logWarn(w);
+  // ── Cursor: ~/.cursor/mcp.json ──
+  const cursorMcpPath = join(HOME, '.cursor', 'mcp.json');
+  if (mergeJsonMcpServer(cursorMcpPath, 'ghl-ai', ghlAiServer)) {
+    updatedFiles.push(cursorMcpPath);
+  }
+  if (gitJenkinsServer && mergeJsonMcpServer(cursorMcpPath, 'git-jenkins', gitJenkinsServer)) {
+    updatedFiles.push(cursorMcpPath);
   }
 
-  return createdFiles;
-}
+  // Deduplicate (claude settings may be added twice if both servers written)
+  const unique = [...new Set(updatedFiles)];
 
-function writeIfMissing(filePath, contentFn, append = false) {
-  if (!append && existsSync(filePath)) return false;
-  const content = contentFn();
-  if (!content) return false;
-  mkdirSync(join(filePath, '..'), { recursive: true });
-  if (append && existsSync(filePath)) {
-    const existing = readFileSync(filePath, 'utf8');
-    writeFileSync(filePath, existing + '\n' + content);
+  if (unique.length > 0) {
+    fmt.logSuccess(`MCP configured in ${unique.map(f => fmt.chalk.cyan(f)).join(', ')}`);
   } else {
-    writeFileSync(filePath, content);
+    fmt.logInfo('MCP servers already configured — no changes needed');
   }
-  return true;
+
+  if (!paths.gitJenkinsPath) {
+    fmt.logWarn('git-jenkins MCP not found — skipped');
+  }
+
+  return unique;
 }
 
-function hasMcpSection(filePath) {
-  if (!existsSync(filePath)) return false;
-  const content = readFileSync(filePath, 'utf8');
-  return content.includes('[mcp_servers');
+/**
+ * Merge an MCP server entry into a JSON config file.
+ * Creates the file if it doesn't exist.
+ * Returns true if the file was modified.
+ */
+function mergeJsonMcpServer(filePath, serverName, serverConfig) {
+  let config = {};
+
+  if (existsSync(filePath)) {
+    try {
+      config = JSON.parse(readFileSync(filePath, 'utf8'));
+    } catch {
+      config = {};
+    }
+  }
+
+  if (!config.mcpServers) {
+    config.mcpServers = {};
+  }
+
+  // Check if already configured with same URL
+  const existing = config.mcpServers[serverName];
+  if (existing && JSON.stringify(existing) === JSON.stringify(serverConfig)) {
+    return false;
+  }
+
+  config.mcpServers[serverName] = serverConfig;
+
+  mkdirSync(join(filePath, '..'), { recursive: true });
+  writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n');
+  return true;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "Agentic Workspace CLI — pull, push & manage agents, skills and commands from the registry",
   "type": "module",
   "bin": {