@ghl-ai/aw 0.1.50-beta.0 → 0.1.50-beta.1

package/commands/init.mjs

@@ -40,6 +40,7 @@ import {
   isValidClone,
   fetchAndMerge,
   addToSparseCheckout,
+  setSparseCheckout,
   addProjectWorktree,
   isWorktree,
   includeToSparsePaths,
@@ -137,6 +138,27 @@ function getSkillInitSpecs(args) {
   }
 }
 
+function skillInitSparsePaths(skillSpecs) {
+  const paths = new Set([
+    DOCS_SOURCE_DIR,
+    AW_DOCS_DIR,
+    RULES_SOURCE_DIR,
+    `${REGISTRY_DIR}/AW-PROTOCOL.md`,
+    `CODEOWNERS`,
+  ]);
+
+  for (const spec of skillSpecs) {
+    paths.add(`${REGISTRY_DIR}/${spec.registryPath}`);
+
+    for (let i = 0; i <= spec.segments.length; i++) {
+      const scope = [spec.namespace, ...spec.segments.slice(0, i)].join('/');
+      paths.add(`${REGISTRY_DIR}/${scope}/references`);
+    }
+  }
+
+  return [...paths];
+}
+
 // ── Ensure ~/.aw/.git/info/exclude has the whitelist block ─────────────
 //
 // Strategy: only .aw_registry/, .aw_rules/, content/, and .aw_docs/ are
@@ -360,24 +382,17 @@ export async function initCommand(args) {
   if (isGitNative) {
     const cfg = config.load(GLOBAL_AW_DIR);
 
-    const newSkillTargets = isSkillInit && cfg
-      ? skillTargets.filter(target => !cfg.include.some(pattern => target === pattern || target.startsWith(pattern + '/')))
-      : [];
     const isNewSubTeam = !isSkillInit && folderName && cfg && !cfg.include.includes(folderName);
 
     if (isSkillInit) {
-      if (newSkillTargets.length > 0) {
-        if (!silent) fmt.logStep(`Adding ${chalk.cyan(newSkillTargets.length)} skill${newSkillTargets.length > 1 ? 's' : ''}...`);
-        addToSparseCheckout(AW_HOME, [
-          ...newSkillTargets.map(target => `.aw_registry/${target}`),
-          DOCS_SOURCE_DIR,
-          AW_DOCS_DIR,
-          RULES_SOURCE_DIR,
-          `.aw_registry/AW-PROTOCOL.md`,
-        ]);
-        for (const target of newSkillTargets) config.addPattern(GLOBAL_AW_DIR, target);
-      } else if (!silent) {
-        fmt.logStep('Already initialized — syncing selected skills...');
+      if (!silent) fmt.logStep('Syncing selected skills...');
+      setSparseCheckout(AW_HOME, skillInitSparsePaths(skillSpecs));
+      if (cfg) {
+        config.save(GLOBAL_AW_DIR, {
+          ...cfg,
+          namespace: skillNamespace || cfg.namespace || 'platform',
+          include: skillTargets,
+        });
       }
     } else if (isNewSubTeam) {
       if (!silent) fmt.logStep(`Adding sub-team ${chalk.cyan(folderName)}...`);
@@ -470,7 +485,7 @@ export async function initCommand(args) {
       : linkWorkspace(HOME, awDirForLinks, { silent: true });
     const commands = isSkillInit ? 0 : generateCommands(HOME, { silent: true });
     if (cwd !== HOME) installLocalCommitHook(cwd);
-    if (!silent) fmt.logStep(`IDE wired — ${chalk.bold(symlinks)} ${isSkillInit ? 'skill symlinks' : 'symlinks'} · ${chalk.bold(commands)} commands`);
+    if (!silent) fmt.logStep(`IDE wired — ${chalk.bold(symlinks)} ${isSkillInit ? 'targeted symlinks' : 'symlinks'} · ${chalk.bold(commands)} commands`);
 
     // Write hook manifest after all hook installation is complete
     try { writeHookManifest({ eccVersion: AW_ECC_TAG, awVersion: VERSION }); } catch { /* best effort */ }
@@ -489,7 +504,7 @@ export async function initCommand(args) {
         `⟁  ${isNewSubTeam ? `Sub-team ${chalk.cyan(folderName)} added` : 'Up to date'}`,
         '',
         `  ${chalk.green('✓')} Registry synced`,
-        `  ${chalk.green('✓')} IDE refreshed — ${chalk.bold(symlinks)} ${isSkillInit ? 'skill symlinks' : 'symlinks'} · ${chalk.bold(commands)} commands`,
+        `  ${chalk.green('✓')} IDE refreshed — ${chalk.bold(symlinks)} ${isSkillInit ? 'targeted symlinks' : 'symlinks'} · ${chalk.bold(commands)} commands`,
         removedLegacyStartupFiles.length > 0
           ? `  ${chalk.green('✓')} Removed ${removedLegacyStartupFiles.length} legacy repo startup file${removedLegacyStartupFiles.length > 1 ? 's' : ''}`
           : null,
@@ -524,14 +539,7 @@ export async function initCommand(args) {
 
   // Determine sparse paths
   const sparsePaths = isSkillInit
-    ? [
-        ...skillTargets.map(target => `.aw_registry/${target}`),
-        DOCS_SOURCE_DIR,
-        AW_DOCS_DIR,
-        RULES_SOURCE_DIR,
-        `.aw_registry/AW-PROTOCOL.md`,
-        `CODEOWNERS`,
-      ]
+    ? skillInitSparsePaths(skillSpecs)
     : [`.aw_registry/platform`, DOCS_SOURCE_DIR, AW_DOCS_DIR, RULES_SOURCE_DIR, `.aw_registry/AW-PROTOCOL.md`, `CODEOWNERS`];
   if (!isSkillInit && folderName) {
     sparsePaths.push(`.aw_registry/${folderName}`);
@@ -650,7 +658,7 @@ export async function initCommand(args) {
         linkWorkspace(HOME, awDirForLinks, { silent: true }),
         generateCommands(HOME, { silent: true }),
       ];
-  if (!silent) fmt.logStep(`IDE wired — ${chalk.bold(symlinks)} ${isSkillInit ? 'skill symlinks' : 'symlinks'} · ${chalk.bold(commands)} commands`);
+  if (!silent) fmt.logStep(`IDE wired — ${chalk.bold(symlinks)} ${isSkillInit ? 'targeted symlinks' : 'symlinks'} · ${chalk.bold(commands)} commands`);
 
   // Write hook manifest after all hook installation is complete
   try { writeHookManifest({ eccVersion: AW_ECC_TAG, awVersion: VERSION }); } catch { /* best effort */ }

package/ecc.mjs

@@ -12,7 +12,7 @@ import { applyStoredStartupPreferences } from "./startup.mjs";
 
 const AW_ECC_REPO_SSH = "git@github.com:shreyansh-ghl/aw-ecc.git";
 const AW_ECC_REPO_HTTPS = "https://github.com/shreyansh-ghl/aw-ecc.git";
-export const AW_ECC_TAG = "v1.4.55";
+export const AW_ECC_TAG = "v1.4.61";
 
 const MARKETPLACE_NAME = "aw-marketplace";
 const PLUGIN_KEY = `aw@${MARKETPLACE_NAME}`;

package/git.mjs

@@ -251,6 +251,19 @@ export function addToSparseCheckout(awHome, newPaths) {
   }
 }
 
+/**
+ * Replace the current sparse checkout with an exact path set.
+ */
+export function setSparseCheckout(awHome, sparsePaths) {
+  try {
+    execSync('git sparse-checkout init --no-cone', { cwd: awHome, stdio: 'pipe' });
+    execSync(`git sparse-checkout set ${sparsePaths.map(p => `"${p}"`).join(' ')}`, { cwd: awHome, stdio: 'pipe' });
+    execSync(`git checkout ${REGISTRY_BASE_BRANCH}`, { cwd: awHome, stdio: 'pipe' });
+  } catch (e) {
+    throw new Error(`Failed to set sparse checkout: ${e.message}`);
+  }
+}
+
 /**
  * Mirror the main clone's sparse-checkout paths into a project worktree.
  * The worktree stays on its own branch — only the checked-out file set is updated.

package/link.mjs

@@ -160,11 +160,15 @@ function cleanSkillSymlinks(cwd) {
   for (const ide of IDE_DIRS) {
     const skillsDir = join(cwd, ide, 'skills');
     if (existsSync(skillsDir)) cleanSymlinksRecursive(skillsDir);
+    const referencesDir = join(cwd, ide, 'references');
+    if (existsSync(referencesDir)) cleanSymlinksRecursive(referencesDir);
   }
 
   if (cwd === realHomeDir()) {
     const agentsSkillsDir = join(cwd, '.agents', 'skills');
     if (existsSync(agentsSkillsDir)) cleanSymlinksRecursive(agentsSkillsDir);
+    const agentsReferencesDir = join(cwd, '.agents', 'references');
+    if (existsSync(agentsReferencesDir)) cleanSymlinksRecursive(agentsReferencesDir);
   }
 }
 
@@ -196,6 +200,40 @@ function linkOneSkill(cwd, awDir, target) {
   return created;
 }
 
+function linkReferenceFiles(cwd, awDir, namespaces = null) {
+  const allowedNamespaces = namespaces ? new Set(namespaces) : null;
+  const namespacesToLink = listNamespaceDirs(awDir)
+    .filter(ns => !allowedNamespaces || allowedNamespaces.has(ns));
+  let created = 0;
+
+  for (const ns of namespacesToLink) {
+    for (const { typeDirPath: referencesDir } of findNestedTypeDirs(join(awDir, ns), 'references')) {
+      for (const file of readdirSync(referencesDir).filter(f => !f.startsWith('.'))) {
+        const targetPath = join(referencesDir, file);
+        if (lstatSync(targetPath).isDirectory()) continue;
+
+        for (const ide of IDE_DIRS) {
+          const linkDir = join(cwd, ide, 'references');
+          mkdirSync(linkDir, { recursive: true });
+          const linkPath = join(linkDir, file);
+          const relTarget = relative(linkDir, targetPath);
+          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
+        }
+
+        if (cwd === realHomeDir()) {
+          const agentsReferencesDir = join(cwd, '.agents', 'references');
+          mkdirSync(agentsReferencesDir, { recursive: true });
+          const linkPath = join(agentsReferencesDir, file);
+          const relTarget = relative(agentsReferencesDir, targetPath);
+          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
+        }
+      }
+    }
+  }
+
+  return created;
+}
+
 /**
  * Create/refresh symlinks for specific skills only.
  *
@@ -228,9 +266,10 @@ export function linkSkills(cwd, skillTargets, awDirOverride = null, { silent = f
   for (const target of targets) {
     created += linkOneSkill(cwd, awDir, target);
   }
+  created += linkReferenceFiles(cwd, awDir, targets.map(target => target.namespace));
 
   if (created > 0 && !silent) {
-    fmt.logSuccess(`Linked ${created} skill symlink${created > 1 ? 's' : ''}`);
+    fmt.logSuccess(`Linked ${created} targeted symlink${created > 1 ? 's' : ''}`);
   }
 
   return created;
@@ -344,22 +383,7 @@ export function linkWorkspace(cwd, awDirOverride = null, { silent = false } = {}
 
   // Shared references: flatten namespace references into each IDE's references/
   // so links like ../../references/foo.md continue to work from flattened skill dirs.
-  for (const ns of namespaces) {
-    for (const { typeDirPath: referencesDir } of findNestedTypeDirs(join(awDir, ns), 'references')) {
-      for (const file of readdirSync(referencesDir).filter(f => !f.startsWith('.'))) {
-        const targetPath = join(referencesDir, file);
-        if (lstatSync(targetPath).isDirectory()) continue;
-
-        for (const ide of IDE_DIRS) {
-          const linkDir = join(cwd, ide, 'references');
-          mkdirSync(linkDir, { recursive: true });
-          const linkPath = join(linkDir, file);
-          const relTarget = relative(linkDir, targetPath);
-          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
-        }
-      }
-    }
-  }
+  created += linkReferenceFiles(cwd, awDir);
 
   // Codex per-skill symlinks: ~/.agents/skills/<name> (global only)
   if (cwd === realHomeDir()) {
@@ -376,20 +400,6 @@ export function linkWorkspace(cwd, awDirOverride = null, { silent = false } = {}
         }
       }
     }
-
-    const agentsReferencesDir = join(cwd, '.agents', 'references');
-    for (const ns of namespaces) {
-      for (const { typeDirPath: referencesDir } of findNestedTypeDirs(join(awDir, ns), 'references')) {
-        mkdirSync(agentsReferencesDir, { recursive: true });
-        for (const file of readdirSync(referencesDir).filter(f => !f.startsWith('.'))) {
-          const targetPath = join(referencesDir, file);
-          if (lstatSync(targetPath).isDirectory()) continue;
-          const linkPath = join(agentsReferencesDir, file);
-          const relTarget = relative(agentsReferencesDir, targetPath);
-          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
-        }
-      }
-    }
   }
 
   // Commands: per-file symlinks (recursive for nested domain dirs)

package/package.json

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