@ghl-ai/aw 0.1.48-beta.2 → 0.1.49-beta.0

package/commands/push.mjs

@@ -518,6 +518,91 @@ function writeAwDocsLinkSummary(projectRoot, links, publishConfig) {
   }
 }
 
+function normalizeAwDocsRelPath(value) {
+  if (!value) return null;
+  let relPath = String(value).replace(/\\/g, '/').replace(/^\.\//, '');
+  if (relPath.startsWith(`${AW_DOCS_DIR}/`)) relPath = relPath.slice(AW_DOCS_DIR.length + 1);
+  return relPath.replace(/^\/+/, '');
+}
+
+function featureSlugForAwDocsRelPath(relPath) {
+  const normalized = normalizeAwDocsRelPath(relPath);
+  if (!normalized) return null;
+  const parts = normalized.split('/');
+  if (parts[0] !== 'features' || !parts[1]) return null;
+  return parts[1];
+}
+
+function setIfChanged(target, key, value) {
+  if (target[key] === value) return false;
+  target[key] = value;
+  return true;
+}
+
+function inferredMarkdownSourcePath(projectRoot, htmlRelPath) {
+  const sourceRelPath = htmlRelPath.replace(/\.html$/i, '.md');
+  if (sourceRelPath === htmlRelPath) return null;
+  if (!existsSync(join(projectRoot, AW_DOCS_DIR, sourceRelPath))) return null;
+  return `${AW_DOCS_DIR}/${sourceRelPath}`;
+}
+
+function hydrateAwDocsFeatureStateLinks(projectRoot, links, publishConfig) {
+  const htmlLinksByFeature = new Map();
+  for (const link of links) {
+    if (!/\.html$/i.test(link.relPath)) continue;
+    const featureSlug = featureSlugForAwDocsRelPath(link.relPath);
+    if (!featureSlug) continue;
+    const featureLinks = htmlLinksByFeature.get(featureSlug) || [];
+    featureLinks.push(link);
+    htmlLinksByFeature.set(featureSlug, featureLinks);
+  }
+
+  for (const [featureSlug, featureLinks] of htmlLinksByFeature) {
+    const statePath = join(projectRoot, AW_DOCS_DIR, 'features', featureSlug, 'state.json');
+    if (!existsSync(statePath)) continue;
+
+    let state;
+    try {
+      state = JSON.parse(readFileSync(statePath, 'utf8'));
+    } catch (e) {
+      throw new Error(`Invalid ${AW_DOCS_DIR}/features/${featureSlug}/state.json: ${e.message}`);
+    }
+
+    const artifacts = Array.isArray(state.html_companion_artifacts)
+      ? state.html_companion_artifacts
+      : [];
+    let changed = !Array.isArray(state.html_companion_artifacts);
+
+    for (const link of featureLinks) {
+      const htmlPath = `${AW_DOCS_DIR}/${link.relPath}`;
+      const existing = artifacts.find(artifact => normalizeAwDocsRelPath(artifact?.html_path) === link.relPath);
+      const artifact = existing || {};
+      if (!existing) {
+        const sourcePath = inferredMarkdownSourcePath(projectRoot, link.relPath);
+        if (sourcePath) artifact.source_path = sourcePath;
+        artifacts.push(artifact);
+        changed = true;
+      }
+
+      changed = setIfChanged(artifact, 'html_path', htmlPath) || changed;
+      changed = setIfChanged(artifact, 'publish_status', 'published') || changed;
+      changed = setIfChanged(artifact, 'remote_repo', publishConfig.repo) || changed;
+      changed = setIfChanged(artifact, 'remote_branch', publishConfig.branch) || changed;
+      changed = setIfChanged(artifact, 'remote_path', link.publishedPath) || changed;
+      changed = setIfChanged(artifact, 'platform_docs_path', link.publishedPath) || changed;
+      changed = setIfChanged(artifact, 'remote_url', link.remoteUrl) || changed;
+      changed = setIfChanged(artifact, 'teamofone_url', link.remoteUrl) || changed;
+      changed = setIfChanged(artifact, 'github_url', link.repositoryUrl) || changed;
+      changed = setIfChanged(artifact, 'repository_url', link.repositoryUrl) || changed;
+    }
+
+    if (!changed) continue;
+    state.html_companion_artifacts = artifacts;
+    state.updated_at = new Date().toISOString();
+    writeFileSync(statePath, JSON.stringify(state, null, 2) + '\n');
+  }
+}
+
 async function commitAndPushAwDocsRepo(docsRepoDir, { message, branch }) {
   await execFile('git', ['add', '-A'], { cwd: docsRepoDir, encoding: 'utf8' });
   await execFile('git', ['commit', '-m', message], {
@@ -612,6 +697,8 @@ async function publishProjectAwDocs(cwd, home, dryRun, scope = null) {
     return { hasDocs: true, publishedPaths, links };
   }
 
+  hydrateAwDocsFeatureStateLinks(projectRoot, links, publishConfig);
+
   const s = fmt.spinner();
   s.start(`Publishing ${files.length} AW doc${files.length > 1 ? 's' : ''} to ${publishConfig.repo}...`);
   try {

package/constants.mjs

@@ -33,7 +33,7 @@ export const AW_DOCS_BASE_BRANCH = 'master-sync';
 export const AW_DOCS_SEED_BRANCH = process.env.AW_DOCS_SEED_BRANCH || 'scaffold';
 export const AW_DOCS_PUBLISH_DIR = 'aw_docs';
 export const AW_DOCS_PUBLIC_BASE_URL = process.env.AW_DOCS_PUBLIC_BASE_URL || `https://github.com/${AW_DOCS_REPO}/blob/${AW_DOCS_BASE_BRANCH}`;
-export const AW_DOCS_TEAMOFONE_ORIGIN = process.env.AW_DOCS_TEAMOFONE_ORIGIN || 'https://teamofone.msgsndr.net';
+export const AW_DOCS_TEAMOFONE_ORIGIN = process.env.AW_DOCS_TEAMOFONE_ORIGIN || 'https://teamofone.servers.stg.msgsndr.net';
 export const AW_DOCS_TEAMOFONE_BASE_URL = process.env.AW_DOCS_TEAMOFONE_BASE_URL || `${AW_DOCS_TEAMOFONE_ORIGIN}/too/docs/GoHighLevel/ghl-aw-docs`;
 
 export function defaultAwDocsGithubDocsConfig() {

package/integrate.mjs

@@ -649,6 +649,9 @@ No active runs. Use \`/aw:<team>-<command>\` to start a workflow.
   // config.json — registry paths, sync settings
   const configPath = join(awDocsDir, 'config.json');
   const defaultConfig = {
+    docs: {
+      outputMode: 'dual',
+    },
     sync: {
       eager: true,
       batch_threshold: 10,
@@ -668,6 +671,10 @@ No active runs. Use \`/aw:<team>-<command>\` to start a workflow.
       const existing = JSON.parse(readFileSync(configPath, 'utf8'));
       nextConfig = {
         ...existing,
+        docs: {
+          ...defaultConfig.docs,
+          ...(existing.docs || {}),
+        },
         sync: {
           ...defaultConfig.sync,
           ...(existing.sync || {}),

package/package.json

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