@ghl-ai/aw 0.1.82 → 0.1.83

package/commands/push.mjs

@@ -431,6 +431,10 @@ async function removeTrackedAwSymlink(cloneDir) {
     return false;
   }
 
+  // `.aw` is always kept inside the sparse-checkout cone (see AW_DOCS_CACHE_PATH
+  // in ensureAwDocsRepoClone) so this remove works even on blobless/sparse
+  // clones. Without that, git rejects the rm with "outside sparse-checkout
+  // definition" against repos that track a real .aw/ tree (e.g. ghl-aw-docs).
   await execFile('git', ['rm', '-f', '.aw'], {
     cwd: cloneDir,
     encoding: 'utf8',
@@ -579,6 +583,12 @@ async function getProjectSourceRepo(projectRoot) {
 const AW_DOCS_GIT_ENV = { ...process.env, GIT_TERMINAL_PROMPT: '0', GCM_INTERACTIVE: 'never' };
 const AW_DOCS_CLONE_TIMEOUT_MS = Number(process.env.AW_DOCS_GIT_TIMEOUT_MS) || 180000;
 const AW_DOCS_NET_TIMEOUT_MS = Number(process.env.AW_DOCS_GIT_TIMEOUT_MS) || 120000;
+// `.aw` is always kept in the sparse-checkout cone. The docs repo may track a
+// real `.aw/` tree (e.g. ghl-aw-docs tracks `.aw/.aw_rules/**`), and the
+// cache-management code (removeTrackedAwSymlink, selfHeal*) runs write git ops
+// on `.aw`. Excluding it from the cone makes those ops fail with "outside
+// sparse-checkout definition" and breaks every publish against such a repo.
+const AW_DOCS_CACHE_PATH = '.aw';
 
 async function awDocsSparseEnabled(cloneDir) {
   try {
@@ -615,7 +625,7 @@ async function ensureAwDocsRepoClone(home, publishConfig, sparseIncludePaths = [
       timeout: AW_DOCS_CLONE_TIMEOUT_MS,
     });
     if (wantSparse) {
-      await execFile('git', ['sparse-checkout', 'set', '--cone', ...sparseIncludePaths], {
+      await execFile('git', ['sparse-checkout', 'set', '--cone', ...sparseIncludePaths, AW_DOCS_CACHE_PATH], {
         cwd: cloneDir,
         encoding: 'utf8',
       }).catch(() => { /* sparse unsupported → full checkout below */ });
@@ -651,7 +661,7 @@ async function ensureAwDocsRepoClone(home, publishConfig, sparseIncludePaths = [
   // clones that already use sparse-checkout (i.e. the blobless clones we
   // created) — legacy full clones are left untouched so there is no regression.
   if (wantSparse && await awDocsSparseEnabled(cloneDir)) {
-    await execFile('git', ['sparse-checkout', 'add', ...sparseIncludePaths], {
+    await execFile('git', ['sparse-checkout', 'add', ...sparseIncludePaths, AW_DOCS_CACHE_PATH], {
       cwd: cloneDir,
       encoding: 'utf8',
     }).catch(() => { /* best effort — checkout below still works */ });

package/package.json

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