@ghl-ai/aw 0.1.47-beta.1 → 0.1.47-beta.11

package/cli.mjs

@@ -21,6 +21,7 @@ const COMMANDS = {
   doctor:  () => import('./commands/doctor.mjs').then(m => m.doctorCommand),
   routing: () => import('./commands/startup.mjs').then(m => m.routingCommand),
   startup: () => import('./commands/startup.mjs').then(m => m.startupCommand),
+  mcp:     () => import('./commands/mcp.mjs').then(m => m.mcpCommand),
   search:  () => import('./commands/search.mjs').then(m => m.searchCommand),
   link:    () => import('./commands/link-project.mjs').then(m => m.linkProjectCommand),
   nuke:    () => import('./commands/nuke.mjs').then(m => m.nukeCommand),
@@ -97,6 +98,7 @@ function printHelp() {
 
     sec('Upload'),
     cmd('aw push', 'Push all modified files (creates one PR)'),
+    cmd('aw push --aw-docs-only', 'Publish generated .aw_docs companions and print share links'),
     cmd('aw push <path>', 'Push file, folder, or namespace to registry'),
     cmd('aw push-rules [path]', 'Push platform rules to platform-docs'),
     cmd('aw push --dry-run [path]', 'Preview what would be pushed'),
@@ -109,8 +111,11 @@ function printHelp() {
     cmd('aw doctor', 'Run a health check for routing, MCP, plugin, and AW ECC surfaces'),
     cmd('aw link', 'Link current project as a git worktree (wires IDE symlinks)'),
     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 routing disable', 'Disable default AW router/rules injection globally'),
+    cmd('aw routing enable', 'Re-enable default AW router/rules injection globally'),
+    cmd('aw mcp status', 'Show global AW MCP mode for Claude/Cursor/Codex'),
+    cmd('aw mcp disable', 'Remove AW-managed MCP server across Claude/Cursor/Codex'),
+    cmd('aw mcp enable', 'Restore AW-managed MCP server across Claude/Cursor/Codex'),
     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'),

package/commands/c4.mjs

@@ -24,6 +24,7 @@ import { spawnSync as nodeSpawnSync } from 'node:child_process';
 import { existsSync as fsExistsSync } from 'node:fs';
 import { join } from 'node:path';
 import * as c4Default from '../c4/index.mjs';
+import { isMcpEnabled } from '../mcp.mjs';
 
 /* ─────────────────────────────────────────────────────────────────────────
  * Constants — referenced by self-tests.
@@ -380,7 +381,12 @@ export async function c4Command(rawArgs, overrides = {}) {
   }
 
   // Step 11 — MCP register.
-  safe('registerGhlAiMcp', () => c4.registerGhlAiMcp(harness, home, token), writer);
+  const mcpEnabled = isMcpEnabled(home, env);
+  if (mcpEnabled) {
+    safe('registerGhlAiMcp', () => c4.registerGhlAiMcp(harness, home, token), writer);
+  } else {
+    writer.stdout('[aw-c4] MCP disabled; skipping registerGhlAiMcp\n');
+  }
 
   // Step 12 — slash command surface.
   safe('ensureCommandSurface', () => c4.ensureCommandSurface({ harness, home, eccHome }), writer);
@@ -403,11 +409,13 @@ export async function c4Command(rawArgs, overrides = {}) {
   safe('ensureRepoLocalIgnore', () => c4.ensureRepoLocalIgnore({ cwd, harness }), writer);
 
   // Step 15 — MCP smoke probe (best-effort).
-  const mcpProbe = await safeAsync(
-    'probeMcpServer',
-    () => c4.probeMcpServer({ url: c4.MCP_URL_DEFAULT, token }),
-    writer,
-  );
+  const mcpProbe = mcpEnabled
+    ? await safeAsync(
+      'probeMcpServer',
+      () => c4.probeMcpServer({ url: c4.MCP_URL_DEFAULT, token }),
+      writer,
+    )
+    : null;
 
   // Step 16 — self-tests.
   const self = runSelfTests({ harness, c4, home, awHome, eccHome });

package/commands/doctor.mjs

@@ -209,7 +209,7 @@ function directoryContainsGeneratedRuleFiles(dirPath, extension) {
   try {
     return readdirSync(dirPath, { withFileTypes: true })
       .filter(entry => entry.isFile() && entry.name.endsWith(extension))
-      .some(entry => readText(join(dirPath, entry.name)).startsWith(GENERATED_RULE_HEADER));
+      .some(entry => readText(join(dirPath, entry.name)).includes(GENERATED_RULE_HEADER));
   } catch {
     return false;
   }
@@ -500,7 +500,7 @@ function listGeneratedRuleFiles(dirPath, extension) {
     return readdirSync(dirPath, { withFileTypes: true })
       .filter(entry => entry.isFile() && entry.name.endsWith(extension))
       .map(entry => join(dirPath, entry.name))
-      .filter(filePath => readText(filePath).startsWith(GENERATED_RULE_HEADER));
+      .filter(filePath => readText(filePath).includes(GENERATED_RULE_HEADER));
   } catch {
     return [];
   }

package/commands/init.mjs

@@ -48,7 +48,7 @@ import {
   syncWorktreeSparseCheckout,
   findNearestWorktree,
 } from '../git.mjs';
-import { REGISTRY_DIR, REGISTRY_REPO, REGISTRY_URL, RULES_SOURCE_DIR, RULES_RUNTIME_DIR } from '../constants.mjs';
+import { REGISTRY_DIR, REGISTRY_REPO, REGISTRY_URL, DOCS_SOURCE_DIR, AW_DOCS_DIR, RULES_SOURCE_DIR, RULES_RUNTIME_DIR } from '../constants.mjs';
 import { syncFileTree } from '../file-tree.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -110,8 +110,8 @@ function scaffoldNamespace(awHome, folderName) {
 
 // ── Ensure ~/.aw/.git/info/exclude has the whitelist block ─────────────
 //
-// Strategy: only .aw_registry/, .aw_rules/, content/ are tracked — everything
-// else at the top level of ~/.aw/ is local-only (telemetry/, hooks/, logs,
+// Strategy: only .aw_registry/, .aw_rules/, content/, and .aw_docs/ are
+// tracked — everything else at the top level of ~/.aw/ is local-only (telemetry/, hooks/, logs,
 // .DS_Store, etc.). We write to .git/info/exclude (not tracked .gitignore)
 // so upstream pulls never conflict.
 
@@ -125,6 +125,7 @@ const AW_MANAGED_BLOCK = [
   '!/.aw_registry',
   '!/.aw_rules',
   '!/content',
+  '!/.aw_docs',
   '',
   '# Nested local state within whitelisted dirs',
   '/.aw_registry/.sync-config.json',
@@ -325,7 +326,7 @@ export async function initCommand(args) {
     const isNewSubTeam = folderName && cfg && !cfg.include.includes(folderName);
     if (isNewSubTeam) {
       if (!silent) fmt.logStep(`Adding sub-team ${chalk.cyan(folderName)}...`);
-      const newSparsePaths = [`.aw_registry/${folderName}`, 'content', RULES_SOURCE_DIR];
+      const newSparsePaths = [`.aw_registry/${folderName}`, DOCS_SOURCE_DIR, AW_DOCS_DIR, RULES_SOURCE_DIR];
       addToSparseCheckout(AW_HOME, newSparsePaths);
       config.addPattern(GLOBAL_AW_DIR, folderName);
       scaffoldNamespace(AW_HOME, folderName);
@@ -464,7 +465,7 @@ export async function initCommand(args) {
   }
 
   // Determine sparse paths
-  const sparsePaths = [`.aw_registry/platform`, `content`, RULES_SOURCE_DIR, `.aw_registry/AW-PROTOCOL.md`, `CODEOWNERS`];
+  const sparsePaths = [`.aw_registry/platform`, DOCS_SOURCE_DIR, AW_DOCS_DIR, RULES_SOURCE_DIR, `.aw_registry/AW-PROTOCOL.md`, `CODEOWNERS`];
   if (folderName) {
     sparsePaths.push(`.aw_registry/${folderName}`);
   }

package/commands/mcp.mjs

@@ -0,0 +1,90 @@
+import { homedir } from 'node:os';
+
+import * as fmt from '../fmt.mjs';
+import { chalk } from '../fmt.mjs';
+import {
+  getMcpStatus,
+  removeMcpConfig,
+  saveMcpPreferences,
+  setupMcp,
+} from '../mcp.mjs';
+
+const HOME = homedir();
+
+function isTruthyEnv(value) {
+  return ['1', 'true', 'yes', 'on'].includes(String(value || '').trim().toLowerCase());
+}
+
+export async function mcpCommand(args) {
+  const action = String(args._positional?.[0] || 'status').toLowerCase();
+
+  if (!['status', 'enable', 'disable'].includes(action)) {
+    fmt.cancel(`Unknown MCP action: ${action}. Use: aw mcp status|enable|disable`);
+    return;
+  }
+
+  fmt.intro(`aw mcp ${action}`);
+
+  if (action === 'status') {
+    return renderStatus();
+  }
+
+  if (action === 'disable') {
+    saveMcpPreferences('disabled', HOME);
+    const removed = removeMcpConfig();
+    const status = getMcpStatus(HOME);
+    fmt.outro([
+      '⟁  MCP disabled',
+      '',
+      `  ${chalk.green('✓')} Preference saved: ${chalk.dim(status.preferencesPath.replace(`${HOME}/`, '~/'))}`,
+      `  ${chalk.green('✓')} Removed AW-managed MCP server from ${removed} config file${removed === 1 ? '' : 's'}`,
+    ].join('\n'));
+    return;
+  }
+
+  saveMcpPreferences('enabled', HOME);
+  const silent = !!args['--silent'] || isTruthyEnv(process.env.CI);
+  const updatedFiles = await setupMcp(HOME, null, { silent });
+  const status = getMcpStatus(HOME);
+  if (status.effectiveMode === 'disabled') {
+    fmt.outro([
+      '⟁  MCP preference enabled',
+      '',
+      `  ${chalk.green('✓')} Preference saved: ${chalk.dim(status.preferencesPath.replace(`${HOME}/`, '~/'))}`,
+      `  ${chalk.yellow('!')} ${status.envDisableMcpName}=1 override is still active`,
+    ].join('\n'));
+    return;
+  }
+  fmt.outro([
+    '⟁  MCP enabled',
+    '',
+    `  ${chalk.green('✓')} Preference saved: ${chalk.dim(status.preferencesPath.replace(`${HOME}/`, '~/'))}`,
+    updatedFiles.length > 0
+      ? `  ${chalk.green('✓')} Updated ${updatedFiles.length} MCP config file${updatedFiles.length === 1 ? '' : 's'}`
+      : `  ${chalk.dim('Note:')} MCP config files already up to date`,
+  ].join('\n'));
+}
+
+function renderStatus() {
+  const status = getMcpStatus(HOME);
+  const modeLabel = status.envDisableMcp
+    ? `${status.effectiveMode} (${status.envDisableMcpName}=1 override; saved preference: ${status.mode})`
+    : status.mode;
+
+  fmt.note([
+    `${chalk.dim('mode:')} ${modeLabel}`,
+    `${chalk.dim('prefs:')} ${status.preferencesPath.replace(`${HOME}/`, '~/')}`,
+    `${chalk.dim('claude MCP:')} ${formatHealth(status.claude)}`,
+    `${chalk.dim('cursor MCP:')} ${formatHealth(status.cursor)}`,
+    `${chalk.dim('codex MCP:')} ${formatHealth(status.codex)}`,
+    `${chalk.dim('aw-ecc Codex MCP source:')} ${formatHealth(status.eccCodex)}`,
+  ].join('\n'), 'MCP');
+
+  fmt.outro('⟁  MCP status complete');
+}
+
+function formatHealth(health) {
+  if (!health.present) return 'disabled';
+  if (health.url && health.authorization) return 'enabled';
+  return `incomplete (url=${health.url}, authorization=${health.authorization})`;
+}

package/commands/nuke.mjs

@@ -364,7 +364,7 @@ export async function nukeCommand(args) {
     '',
     `  ${chalk.green('✓')} Generated files cleaned`,
     `  ${chalk.green('✓')} IDE symlinks cleaned`,
-    `  ${chalk.green('✓')} MCP config removed (ghl-ai from ~/.claude.json + ~/.cursor/mcp.json)`,
+    `  ${chalk.green('✓')} MCP config removed (ghl-ai from Claude, Cursor, and Codex configs)`,
     `  ${chalk.green('✓')} aw-ecc engine removed`,
     `  ${chalk.green('✓')} Project worktrees removed`,
     `  ${chalk.green('✓')} Project symlinks cleaned`,

package/commands/pull.mjs

@@ -27,6 +27,7 @@ import {
   REGISTRY_DIR,
   REGISTRY_URL,
   DOCS_SOURCE_DIR,
+  AW_DOCS_DIR,
   RULES_SOURCE_DIR,
   RULES_RUNTIME_DIR,
 } from '../constants.mjs';
@@ -92,7 +93,7 @@ export async function pullCommand(args) {
   // Ensure platform pulls also fetch docs and rules on older installs that
   // pre-date the new sparse-checkout paths.
   if (input === 'platform') {
-    addToSparseCheckout(AW_HOME, [`.aw_registry/platform`, DOCS_SOURCE_DIR, RULES_SOURCE_DIR]);
+    addToSparseCheckout(AW_HOME, [`.aw_registry/platform`, DOCS_SOURCE_DIR, AW_DOCS_DIR, RULES_SOURCE_DIR]);
     if (!cfg.include.includes('platform')) {
       config.addPattern(GLOBAL_AW_DIR, 'platform');
     }
@@ -110,7 +111,7 @@ export async function pullCommand(args) {
     const label = input.split('/').pop();
     if (!cfg.include.includes(input)) {
       log.logStep(`Adding ${chalk.cyan(label)} to sparse checkout...`);
-      addToSparseCheckout(AW_HOME, [sparsePath, DOCS_SOURCE_DIR]);
+      addToSparseCheckout(AW_HOME, [sparsePath, DOCS_SOURCE_DIR, AW_DOCS_DIR]);
       config.addPattern(GLOBAL_AW_DIR, input);
       addedInput = input;
       addedSparsePath = sparsePath;