@ghl-ai/aw 0.1.47-beta.7 → 0.1.47-beta.9

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/push.mjs

@@ -161,6 +161,46 @@ function collectProjectAwDocs(cwd, home) {
   return { projectRoot, files };
 }
 
+function readAwDocsConfig(projectRoot) {
+  const configPath = join(projectRoot, AW_DOCS_DIR, 'config.json');
+  if (!existsSync(configPath)) return {};
+
+  try {
+    return JSON.parse(readFileSync(configPath, 'utf8'));
+  } catch (e) {
+    throw new Error(`Invalid ${AW_DOCS_DIR}/config.json: ${e.message}`);
+  }
+}
+
+function repoCloneUrl(repo) {
+  const value = String(repo || '').trim();
+  if (!value) return AW_DOCS_URL;
+  if (/^(?:https?:\/\/|git@|ssh:\/\/|file:\/\/)/.test(value)) return value;
+  return `https://github.com/${value.replace(/\.git$/, '')}.git`;
+}
+
+function resolveAwDocsPublishConfig(projectRoot) {
+  const config = readAwDocsConfig(projectRoot);
+  const githubDocs = config.sync?.github_docs || {};
+  const repo = process.env.AW_DOCS_REPO || githubDocs.repo || AW_DOCS_REPO;
+  const branch = process.env.AW_DOCS_BASE_BRANCH || githubDocs.branch || AW_DOCS_BASE_BRANCH;
+  const repoUrl = process.env.AW_DOCS_REPO_URL || githubDocs.repo_url || repoCloneUrl(repo);
+  const dest = safePathSegment(process.env.AW_DOCS_PUBLISH_DIR || githubDocs.dest || AW_DOCS_PUBLISH_DIR, AW_DOCS_PUBLISH_DIR);
+  const publicBaseUrl = process.env.AW_DOCS_PUBLIC_BASE_URL
+    || githubDocs.teamofone_base_url
+    || `https://github.com/${String(repo).replace(/\.git$/, '')}/blob/${branch}`;
+
+  return {
+    enabled: githubDocs.enabled !== false,
+    repo,
+    repoUrl,
+    branch,
+    seedBranch: process.env.AW_DOCS_SEED_BRANCH || githubDocs.seed_branch || AW_DOCS_SEED_BRANCH,
+    dest,
+    publicBaseUrl,
+  };
+}
+
 function parseGitHubRepo(remoteUrl) {
   const match = remoteUrl.trim().match(/github\.com[:/]([^/]+)\/(.+?)(?:\.git)?$/);
   if (!match) return null;
@@ -200,11 +240,11 @@ async function getProjectSourceRepo(projectRoot) {
   return `local/${basename(projectRoot)}`;
 }
 
-async function ensureAwDocsRepoClone(home) {
+async function ensureAwDocsRepoClone(home, publishConfig) {
   const cloneDir = process.env.AW_DOCS_WORKTREE || join(home, '.aw-ghl-aw-docs');
 
   if (!existsSync(join(cloneDir, '.git'))) {
-    await execFile('git', ['clone', AW_DOCS_URL, cloneDir], {
+    await execFile('git', ['clone', publishConfig.repoUrl, cloneDir], {
       encoding: 'utf8',
     });
   }
@@ -222,18 +262,18 @@ async function ensureAwDocsRepoClone(home) {
     encoding: 'utf8',
   });
 
-  const hasPublishBranch = await remoteBranchExists(cloneDir, AW_DOCS_BASE_BRANCH);
+  const hasPublishBranch = await remoteBranchExists(cloneDir, publishConfig.branch);
   const checkoutStart = hasPublishBranch
-    ? `origin/${AW_DOCS_BASE_BRANCH}`
-    : `origin/${AW_DOCS_SEED_BRANCH}`;
+    ? `origin/${publishConfig.branch}`
+    : `origin/${publishConfig.seedBranch}`;
 
-  await execFile('git', ['checkout', '-B', AW_DOCS_BASE_BRANCH, checkoutStart], {
+  await execFile('git', ['checkout', '-B', publishConfig.branch, checkoutStart], {
     cwd: cloneDir,
     encoding: 'utf8',
   });
 
   if (hasPublishBranch) {
-    await execFile('git', ['pull', '--ff-only', 'origin', AW_DOCS_BASE_BRANCH], {
+    await execFile('git', ['pull', '--ff-only', 'origin', publishConfig.branch], {
       cwd: cloneDir,
       encoding: 'utf8',
     });
@@ -253,8 +293,14 @@ async function remoteBranchExists(repoDir, branchName) {
   }
 }
 
-function awDocsRemoteUrl(publishedPath) {
-  return `${AW_DOCS_PUBLIC_BASE_URL.replace(/\/$/, '')}/${publishedPath.split('/').map(encodeURIComponent).join('/')}`;
+function awDocsRemoteUrl(publishedPath, publishConfig) {
+  return `${publishConfig.publicBaseUrl.replace(/\/$/, '')}/${publishedPath.split('/').map(encodeURIComponent).join('/')}`;
+}
+
+function awDocsRepositoryUrl(publishedPath, publishConfig) {
+  const repo = String(publishConfig.repo || AW_DOCS_REPO).replace(/\.git$/, '');
+  if (!repo.includes('/')) return awDocsRemoteUrl(publishedPath, publishConfig);
+  return `https://github.com/${repo}/blob/${publishConfig.branch}/${publishedPath.split('/').map(encodeURIComponent).join('/')}`;
 }
 
 function printAwDocsLinks(links, limit = 10) {
@@ -266,12 +312,13 @@ function printAwDocsLinks(links, limit = 10) {
   }
 }
 
-function writeAwDocsLinkSummary(projectRoot, links) {
+function writeAwDocsLinkSummary(projectRoot, links, publishConfig) {
   const summaryPath = join(projectRoot, AW_DOCS_DIR, 'last-publish.json');
   const payload = {
     generatedAt: new Date().toISOString(),
-    branch: AW_DOCS_BASE_BRANCH,
-    repo: AW_DOCS_REPO,
+    branch: publishConfig.branch,
+    repo: publishConfig.repo,
+    targetPath: publishConfig.dest,
     links,
   };
   try {
@@ -281,13 +328,13 @@ function writeAwDocsLinkSummary(projectRoot, links) {
   }
 }
 
-async function commitAndPushAwDocsRepo(docsRepoDir, commitMessage) {
+async function commitAndPushAwDocsRepo(docsRepoDir, { message, branch }) {
   await execFile('git', ['add', '-A'], { cwd: docsRepoDir, encoding: 'utf8' });
-  await execFile('git', ['commit', '-m', commitMessage], {
+  await execFile('git', ['commit', '-m', message], {
     cwd: docsRepoDir,
     encoding: 'utf8',
   });
-  await execFile('git', ['push', '-u', 'origin', `HEAD:${AW_DOCS_BASE_BRANCH}`], {
+  await execFile('git', ['push', '-u', 'origin', `HEAD:${branch}`], {
     cwd: docsRepoDir,
     encoding: 'utf8',
   });
@@ -301,7 +348,7 @@ function titleForAwDoc(relPath) {
   return `${label} ${ext}`;
 }
 
-function updateAwDocsManifest(docsRepoDir, { repoSlug, sourceRepo, githubUsername, docs }) {
+function updateAwDocsManifest(docsRepoDir, { repoSlug, sourceRepo, githubUsername, docs, publishConfig }) {
   const manifestPath = join(docsRepoDir, 'manifest.json');
   const manifest = existsSync(manifestPath)
     ? JSON.parse(readFileSync(manifestPath, 'utf8'))
@@ -320,7 +367,8 @@ function updateAwDocsManifest(docsRepoDir, { repoSlug, sourceRepo, githubUsernam
     docs: docs.map(doc => ({
       relPath: doc.relPath,
       publishedPath: doc.publishedPath,
-      remoteUrl: awDocsRemoteUrl(doc.publishedPath),
+      remoteUrl: awDocsRemoteUrl(doc.publishedPath, publishConfig),
+      repositoryUrl: awDocsRepositoryUrl(doc.publishedPath, publishConfig),
       sha: createHash('sha256').update(readFileSync(join(docsRepoDir, doc.publishedPath))).digest('hex'),
       syncedAt: now,
       title: titleForAwDoc(doc.relPath),
@@ -335,22 +383,29 @@ async function publishProjectAwDocs(cwd, home, dryRun) {
   const { projectRoot, files } = collectProjectAwDocs(cwd, home);
   if (files.length === 0) return { hasDocs: false, publishedPaths: [] };
 
+  const publishConfig = resolveAwDocsPublishConfig(projectRoot);
+  if (!publishConfig.enabled) {
+    fmt.logWarn(`${AW_DOCS_DIR}/config.json sync.github_docs.enabled is false; skipping AW docs publish`);
+    return { hasDocs: true, skipped: true, publishedPaths: [], links: [] };
+  }
+
   const sourceRepo = await getProjectSourceRepo(projectRoot);
   const repoSlug = repoSlugFromSource(sourceRepo, projectRoot);
   const githubUsername = safePathSegment(await getGitHubUser(), 'unknown');
   const docs = files.map(file => ({
     ...file,
-    publishedPath: `${AW_DOCS_PUBLISH_DIR}/${repoSlug}/${githubUsername}/${file.relPath}`,
+    publishedPath: `${publishConfig.dest}/${repoSlug}/${githubUsername}/${file.relPath}`,
   }));
   const publishedPaths = docs.map(doc => doc.publishedPath);
   const links = docs.map(doc => ({
     relPath: doc.relPath,
     publishedPath: doc.publishedPath,
-    remoteUrl: awDocsRemoteUrl(doc.publishedPath),
+    remoteUrl: awDocsRemoteUrl(doc.publishedPath, publishConfig),
+    repositoryUrl: awDocsRepositoryUrl(doc.publishedPath, publishConfig),
   }));
 
   if (dryRun) {
-    fmt.logInfo(`${chalk.bold(files.length)} AW doc${files.length > 1 ? 's' : ''} to publish directly to ${AW_DOCS_REPO}`);
+    fmt.logInfo(`${chalk.bold(files.length)} AW doc${files.length > 1 ? 's' : ''} to publish directly to ${publishConfig.repo}`);
     for (const link of links.slice(0, 40)) {
       fmt.logMessage(`  ${chalk.yellow('AWDOC')}/${link.publishedPath}`);
       fmt.logMessage(`    ${chalk.cyan(link.remoteUrl)}`);
@@ -361,10 +416,10 @@ async function publishProjectAwDocs(cwd, home, dryRun) {
   }
 
   const s = fmt.spinner();
-  s.start(`Publishing ${files.length} AW doc${files.length > 1 ? 's' : ''} to ${AW_DOCS_REPO}...`);
+  s.start(`Publishing ${files.length} AW doc${files.length > 1 ? 's' : ''} to ${publishConfig.repo}...`);
   try {
-    const docsRepoDir = await ensureAwDocsRepoClone(home);
-    rmSync(join(docsRepoDir, AW_DOCS_PUBLISH_DIR, repoSlug, githubUsername), {
+    const docsRepoDir = await ensureAwDocsRepoClone(home, publishConfig);
+    rmSync(join(docsRepoDir, publishConfig.dest, repoSlug, githubUsername), {
       recursive: true,
       force: true,
     });
@@ -373,7 +428,7 @@ async function publishProjectAwDocs(cwd, home, dryRun) {
       mkdirSync(dirname(dest), { recursive: true });
       copyFileSync(doc.absPath, dest);
     }
-    updateAwDocsManifest(docsRepoDir, { repoSlug, sourceRepo, githubUsername, docs });
+    updateAwDocsManifest(docsRepoDir, { repoSlug, sourceRepo, githubUsername, docs, publishConfig });
 
     const { stdout: status } = await execFile('git', ['status', '--porcelain'], {
       cwd: docsRepoDir,
@@ -381,14 +436,17 @@ async function publishProjectAwDocs(cwd, home, dryRun) {
     });
     if (!status.trim()) {
       s.stop('AW docs already up to date');
-      writeAwDocsLinkSummary(projectRoot, links);
+      writeAwDocsLinkSummary(projectRoot, links, publishConfig);
       printAwDocsLinks(links);
       return { hasDocs: true, publishedPaths, links };
     }
 
-    await commitAndPushAwDocsRepo(docsRepoDir, `docs(aw): sync ${repoSlug}/${githubUsername} AW docs`);
-    writeAwDocsLinkSummary(projectRoot, links);
-    s.stop(`Published AW docs to ${AW_DOCS_REPO}`);
+    await commitAndPushAwDocsRepo(docsRepoDir, {
+      message: `docs(aw): sync ${repoSlug}/${githubUsername} AW docs`,
+      branch: publishConfig.branch,
+    });
+    writeAwDocsLinkSummary(projectRoot, links, publishConfig);
+    s.stop(`Published AW docs to ${publishConfig.repo}`);
     printAwDocsLinks(links);
     return { hasDocs: true, publishedPaths, links };
   } catch (e) {

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.43";
+export const AW_ECC_TAG = "v1.4.55";
 
 const MARKETPLACE_NAME = "aw-marketplace";
 const PLUGIN_KEY = `aw@${MARKETPLACE_NAME}`;

package/package.json

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