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

package/commands/pull.mjs

@@ -1,6 +1,6 @@
 // commands/pull.mjs — Pull content from registry
 
-import { mkdirSync, existsSync, readdirSync, copyFileSync } from 'node:fs';
+import { mkdirSync, existsSync, readdirSync, copyFileSync, cpSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { execSync } from 'node:child_process';
@@ -191,6 +191,16 @@ 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 });
+      }
+    }
+
     // MCP registration (second-class — skip if not available)
     if (cfg.namespace) {
       registerMcp(cfg.namespace);
@@ -283,6 +293,16 @@ 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 });
+      }
+    }
+
     return { pattern, actions, conflictCount };
   } finally {
     cleanup(tempDir);

package/link.mjs

@@ -1,15 +1,19 @@
 // link.mjs — Create symlinks from IDE dirs → .aw_registry/
 
-import { existsSync, lstatSync, mkdirSync, readdirSync, unlinkSync } from 'node:fs';
+import { existsSync, lstatSync, mkdirSync, readdirSync, unlinkSync, symlinkSync } from 'node:fs';
 import { join, relative } from 'node:path';
-import { execSync } from 'node:child_process';
 import { homedir } from 'node:os';
 import * as fmt from './fmt.mjs';
 
+function forceSymlink(target, linkPath) {
+  try { unlinkSync(linkPath); } catch { /* not there yet */ }
+  symlinkSync(target, linkPath);
+}
+
 const IDE_DIRS = ['.claude', '.cursor', '.codex'];
 // Per-file symlink types
 const FILE_TYPES = ['agents'];
-const ALL_KNOWN_TYPES = new Set([...FILE_TYPES, 'skills', 'commands', 'evals']);
+const ALL_KNOWN_TYPES = new Set([...FILE_TYPES, 'skills', 'commands', 'evals', 'docs']);
 
 /**
  * List namespace directories inside .aw_registry/ (skip dotfiles).
@@ -135,10 +139,7 @@ export function linkWorkspace(cwd) {
             const linkPath = join(linkDir, flat);
             const targetPath = join(typeDirPath, file);
             const relTarget = relative(linkDir, targetPath);
-            try {
-              execSync(`ln -sfn "${relTarget}" "${linkPath}"`, { stdio: 'pipe' });
-              created++;
-            } catch { /* best effort */ }
+            try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
           }
         }
       }
@@ -155,10 +156,7 @@ export function linkWorkspace(cwd) {
           const linkPath = join(linkDir, flat);
           const targetPath = join(skillsDir, skill);
           const relTarget = relative(linkDir, targetPath);
-          try {
-            execSync(`ln -sfn "${relTarget}" "${linkPath}"`, { stdio: 'pipe' });
-            created++;
-          } catch { /* best effort */ }
+          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
         }
       }
     }
@@ -178,10 +176,7 @@ export function linkWorkspace(cwd) {
             const linkPath = join(linkDir, flat);
             const targetPath = join(subDir, evalName);
             const relTarget = relative(linkDir, targetPath);
-            try {
-              execSync(`ln -sfn "${relTarget}" "${linkPath}"`, { stdio: 'pipe' });
-              created++;
-            } catch { /* best effort */ }
+            try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
           }
         }
       }
@@ -199,10 +194,7 @@ export function linkWorkspace(cwd) {
           const linkPath = join(agentsSkillsDir, flat);
           const targetPath = join(skillsDir, skill);
           const relTarget = relative(agentsSkillsDir, targetPath);
-          try {
-            execSync(`ln -sfn "${relTarget}" "${linkPath}"`, { stdio: 'pipe' });
-            created++;
-          } catch { /* best effort */ }
+          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
         }
       }
     }
@@ -220,10 +212,7 @@ export function linkWorkspace(cwd) {
           const linkPath = join(linkDir, cmdFileName);
           const targetPath = join(commandsDir, file);
           const relTarget = relative(linkDir, targetPath);
-          try {
-            execSync(`ln -sfn "${relTarget}" "${linkPath}"`, { stdio: 'pipe' });
-            created++;
-          } catch { /* best effort */ }
+          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
         }
       }
     }
@@ -235,13 +224,19 @@ export function linkWorkspace(cwd) {
     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 */ }
+      try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
+    }
+  }
+
+  // Docs: single directory symlink per IDE → .aw_registry/platform/docs
+  const platformDocsDir = join(awDir, 'platform', 'docs');
+  if (existsSync(platformDocsDir)) {
+    for (const ide of IDE_DIRS) {
+      const linkDir = join(cwd, ide);
+      mkdirSync(linkDir, { recursive: true });
+      const linkPath = join(linkDir, 'docs');
+      const relTarget = relative(linkDir, platformDocsDir);
+      try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
     }
   }
 

package/package.json

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

package/registry.mjs

@@ -5,6 +5,7 @@ import { join, relative } from 'node:path';
 import { createHash } from 'node:crypto';
 
 const TYPE_DIRS = new Set(['agents', 'skills', 'commands', 'evals']);
+const SKIP_DIRS = new Set(['docs']);
 
 export function sha256(content) {
   return createHash('sha256').update(content).digest('hex');
@@ -97,7 +98,7 @@ export function walkRegistryTree(baseDir, baseName) {
             });
           }
         }
-      } else if (entry.isDirectory()) {
+      } else if (entry.isDirectory() && !SKIP_DIRS.has(entry.name)) {
         recurse(fullPath, [...pathSegments, entry.name]);
       }
     }