@ghl-ai/aw 0.1.26-beta.2 → 0.1.26-beta.4

package/cli.mjs

@@ -5,6 +5,7 @@ import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import * as fmt from './fmt.mjs';
 import { chalk } from './fmt.mjs';
+import { checkForUpdate, notifyUpdate } from './update.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const VERSION = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf8')).version;
@@ -127,6 +128,9 @@ function printHelp() {
 export async function run(argv) {
   const { command, args } = parseArgs(argv);
 
+  // Fire background npm version check (runs in parallel with the command)
+  const updateCheck = checkForUpdate();
+
   if (args['--version'] || (!command && args['-v'])) {
     console.log(`aw v${VERSION}`);
     process.exit(0);
@@ -138,8 +142,10 @@ export async function run(argv) {
   }
 
   if (command && COMMANDS[command]) {
+    args._updateCheck = updateCheck;
     const handler = await COMMANDS[command]();
     await handler(args);
+    notifyUpdate(await updateCheck);
     return;
   }
 

package/commands/init.mjs

@@ -17,6 +17,7 @@ import { pullCommand, pullAsync } from './pull.mjs';
 import { linkWorkspace } from '../link.mjs';
 import { generateCommands, copyInstructions, initAwDocs } from '../integrate.mjs';
 import { setupMcp } from '../mcp.mjs';
+import { autoUpdate, promptUpdate } from '../update.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const VERSION = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8')).version;
@@ -251,7 +252,9 @@ export async function initCommand(args) {
       } catch { /* best effort */ }
     }
 
-    if (!silent) {
+    if (silent) {
+      autoUpdate(await args._updateCheck);
+    } else {
       fmt.outro([
         isNewSubTeam ? `Sub-team ${chalk.cyan(folderName)} added` : 'Sync complete',
         '',
@@ -342,6 +345,9 @@ export async function initCommand(args) {
   };
   saveManifest(manifest);
 
+  // Offer to update if a newer version is available
+  await promptUpdate(await args._updateCheck);
+
   // Done
   fmt.outro([
     'Install complete',

package/commands/pull.mjs

@@ -1,6 +1,6 @@
 // commands/pull.mjs — Pull content from registry
 
-import { mkdirSync, existsSync, readdirSync, copyFileSync, cpSync } from 'node:fs';
+import { mkdirSync, existsSync, readdirSync, copyFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { execSync } from 'node:child_process';
@@ -8,7 +8,7 @@ import * as config from '../config.mjs';
 import * as fmt from '../fmt.mjs';
 import { chalk } from '../fmt.mjs';
 import { sparseCheckout, sparseCheckoutAsync, cleanup, includeToSparsePaths } from '../git.mjs';
-import { REGISTRY_DIR } from '../constants.mjs';
+import { REGISTRY_DIR, DOCS_SOURCE_DIR } from '../constants.mjs';
 import { walkRegistryTree } from '../registry.mjs';
 import { matchesAny } from '../glob.mjs';
 import { computePlan } from '../plan.mjs';
@@ -191,14 +191,11 @@ export async function pullCommand(args) {
       }
     }
 
-    // Bulk-copy docs/ directories (not a TYPE_DIR — raw recursive copy)
-    for (const rd of registryDirs) {
-      const docsDir = join(rd.path, 'docs');
-      if (existsSync(docsDir)) {
-        const dest = join(workspaceDir, rd.name, 'docs');
-        mkdirSync(dest, { recursive: true });
-        cpSync(docsDir, dest, { recursive: true });
-      }
+    // Sync docs from repo content/ into platform/docs/ (markdown only, skip images)
+    const contentSrc = join(tempDir, DOCS_SOURCE_DIR);
+    if (existsSync(contentSrc)) {
+      const docsDest = join(workspaceDir, 'platform', 'docs');
+      copyMarkdownTree(contentSrc, docsDest);
     }
 
     // MCP registration (second-class — skip if not available)
@@ -293,14 +290,11 @@ export async function pullAsync(args) {
       if (existsSync(src)) copyFileSync(src, join(workspaceDir, fname));
     }
 
-    // Bulk-copy docs/ directories (not a TYPE_DIR — raw recursive copy)
-    for (const rd of registryDirs) {
-      const docsDir = join(rd.path, 'docs');
-      if (existsSync(docsDir)) {
-        const dest = join(workspaceDir, rd.name, 'docs');
-        mkdirSync(dest, { recursive: true });
-        cpSync(docsDir, dest, { recursive: true });
-      }
+    // Sync docs from repo content/ into platform/docs/ (markdown only, skip images)
+    const contentSrc = join(tempDir, DOCS_SOURCE_DIR);
+    if (existsSync(contentSrc)) {
+      const docsDest = join(workspaceDir, 'platform', 'docs');
+      copyMarkdownTree(contentSrc, docsDest);
     }
 
     return { pattern, actions, conflictCount };
@@ -315,6 +309,24 @@ function listDirs(dir) {
     .map(d => d.name);
 }
 
+/**
+ * Recursively copy only .md files from src to dest, preserving directory structure.
+ * Skips images and other non-markdown content.
+ */
+function copyMarkdownTree(src, dest) {
+  mkdirSync(dest, { recursive: true });
+  for (const entry of readdirSync(src, { withFileTypes: true })) {
+    if (entry.name.startsWith('.')) continue;
+    const srcPath = join(src, entry.name);
+    const destPath = join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyMarkdownTree(srcPath, destPath);
+    } else if (entry.name.endsWith('.md')) {
+      copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
 function registerMcp(namespace) {
   const mcpUrl = process.env.GHL_MCP_URL;
   if (!mcpUrl) return;

package/constants.mjs

@@ -8,3 +8,6 @@ export const REGISTRY_REPO = 'GoHighLevel/platform-docs';
 
 /** Directory inside the registry repo that holds platform/ and [template]/ */
 export const REGISTRY_DIR = '.aw_registry';
+
+/** Directory in platform-docs repo containing documentation (pulled into platform/docs/) */
+export const DOCS_SOURCE_DIR = 'content';

package/git.mjs

@@ -5,7 +5,7 @@ import { mkdtempSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { tmpdir } from 'node:os';
 import { promisify } from 'node:util';
-import { REGISTRY_BASE_BRANCH, REGISTRY_DIR } from './constants.mjs';
+import { REGISTRY_BASE_BRANCH, REGISTRY_DIR, DOCS_SOURCE_DIR } from './constants.mjs';
 
 const exec = promisify(execCb);
 
@@ -77,6 +77,9 @@ export function cleanup(tempDir) {
 /**
  * Compute sparse checkout paths from include paths.
  * e.g., ["platform", "dev/agents/debugger"] -> [".aw_registry/platform", ".aw_registry/dev/agents/debugger"]
+ *
+ * When "platform" is in the paths, also includes the repo's docs source
+ * directory (content/) so docs are pulled on-the-fly into platform/docs/.
  */
 export function includeToSparsePaths(paths) {
   const result = new Set();
@@ -84,5 +87,8 @@ export function includeToSparsePaths(paths) {
     result.add(`${REGISTRY_DIR}/${p}`);
   }
   result.add(`${REGISTRY_DIR}/AW-PROTOCOL.md`);
+  if (paths.includes('platform')) {
+    result.add(DOCS_SOURCE_DIR);
+  }
   return [...result];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.26-beta.2",
+  "version": "0.1.26-beta.4",
   "description": "Agentic Workspace CLI — pull, push & manage agents, skills and commands from the registry",
   "type": "module",
   "bin": {
@@ -22,7 +22,8 @@
     "paths.mjs",
     "plan.mjs",
     "registry.mjs",
-    "apply.mjs"
+    "apply.mjs",
+    "update.mjs"
   ],
   "engines": {
     "node": ">=18.0.0"

package/update.mjs

@@ -0,0 +1,126 @@
+// update.mjs — Version check + auto-update for @ghl-ai/aw CLI.
+//
+// checkForUpdate()  → fires npm view in background, returns { current, latest, hasUpdate }
+// notifyUpdate(r)   → prints banner if r says update available
+// autoUpdate(r)     → spawns npm install in background (--silent mode)
+// promptUpdate(r)   → asks user interactively (normal init)
+
+import { readFileSync } from 'node:fs';
+import { exec as execCb, execSync, spawn } from 'node:child_process';
+import { promisify } from 'node:util';
+import * as fmt from './fmt.mjs';
+import { chalk } from './fmt.mjs';
+
+const exec = promisify(execCb);
+
+const PKG_NAME = '@ghl-ai/aw';
+
+function getLocalVersion() {
+  try {
+    return JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8')).version;
+  } catch {
+    return '0.0.0';
+  }
+}
+
+function isPrerelease(version) {
+  return /-(alpha|beta|rc|dev|canary)/.test(version);
+}
+
+function compareVersions(a, b) {
+  const pa = a.replace(/^v/, '').split(/[-.]/).map(p => (isNaN(p) ? p : Number(p)));
+  const pb = b.replace(/^v/, '').split(/[-.]/).map(p => (isNaN(p) ? p : Number(p)));
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const va = pa[i] ?? 0;
+    const vb = pb[i] ?? 0;
+    if (typeof va === 'string' || typeof vb === 'string') {
+      const sa = String(va), sb = String(vb);
+      if (sa < sb) return -1;
+      if (sa > sb) return 1;
+    } else {
+      if (va < vb) return -1;
+      if (va > vb) return 1;
+    }
+  }
+  return 0;
+}
+
+/**
+ * Fetch the latest version from npm (non-blocking, 5s timeout).
+ * Call at the start of any command, await at the end.
+ */
+export async function checkForUpdate() {
+  try {
+    const { stdout } = await exec(`npm view ${PKG_NAME} version`, { timeout: 5000 });
+    const latest = stdout.trim();
+    const current = getLocalVersion();
+    return { current, latest, hasUpdate: compareVersions(latest, current) > 0 };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Print a banner nudge if a newer version is available.
+ * Shows for all users (including beta).
+ */
+export function notifyUpdate(result) {
+  if (!result?.hasUpdate) return;
+  const msg = [
+    '',
+    `  ${chalk.bgHex('#FF6B35').bold(' UPDATE ')} New version available: ${chalk.dim(result.current)} → ${chalk.green(result.latest)}`,
+    `  ${chalk.dim('Run')} ${chalk.bold(`npm i -g ${PKG_NAME}`)} ${chalk.dim('to update')}`,
+    '',
+  ].join('\n');
+  console.log(msg);
+}
+
+/**
+ * Auto-update in background (fire-and-forget, detached process).
+ * Used by `aw init --silent`. Skipped for prerelease versions.
+ */
+export function autoUpdate(result) {
+  if (!result?.hasUpdate) return;
+  if (isPrerelease(result.current)) return;
+  try {
+    const child = spawn('npm', ['i', '-g', `${PKG_NAME}@latest`], {
+      detached: true,
+      stdio: 'ignore',
+    });
+    child.unref();
+  } catch { /* best effort */ }
+}
+
+/**
+ * Interactive prompt to update during normal init.
+ * Skipped for prerelease versions.
+ */
+export async function promptUpdate(result) {
+  if (!result?.hasUpdate) return false;
+  if (isPrerelease(result.current)) return false;
+
+  fmt.logWarn(`Update available: ${chalk.dim(result.current)} → ${chalk.green(result.latest)}`);
+
+  const { default: clack } = await import('@clack/prompts');
+  const shouldUpdate = await clack.confirm({
+    message: `Update ${PKG_NAME} to ${result.latest}?`,
+    initialValue: true,
+  });
+
+  if (clack.isCancel(shouldUpdate) || !shouldUpdate) {
+    fmt.logStep(chalk.dim('Skipped update'));
+    return false;
+  }
+
+  const s = fmt.spinner();
+  s.start(`Updating to ${result.latest}...`);
+  try {
+    execSync(`npm i -g ${PKG_NAME}@latest`, { stdio: 'pipe', timeout: 30000 });
+    s.stop(`Updated to ${chalk.green(result.latest)}`);
+    return true;
+  } catch {
+    s.stop(chalk.red('Update failed'));
+    fmt.logWarn(`Manual update: ${chalk.bold(`npm i -g ${PKG_NAME}@latest`)}`);
+    return false;
+  }
+}