@latent-space-labs/open-auto-doc 0.5.5 → 0.5.6

package/dist/index.js

@@ -3403,14 +3403,14 @@ function loadTemplates() {
   }
   templatesLoaded = true;
 }
-async function writeContent(contentDir, results, crossRepo, changelogs) {
+async function writeContent(contentDir, results, crossRepo, changelogs, options) {
   loadTemplates();
   await fs23.ensureDir(contentDir);
   if (results.length === 1) {
     const changelog = changelogs?.get(results[0].repoName);
     await writeRepoContent(contentDir, results[0], changelog);
   } else {
-    await writeMultiRepoIndex(contentDir, results);
+    await writeMultiRepoIndex(contentDir, results, options?.repoStatus);
     if (crossRepo && templates["cross-repo"]) {
       await fs23.writeFile(
         path23.join(contentDir, "cross-repo.mdx"),
@@ -3424,7 +3424,7 @@ async function writeContent(contentDir, results, crossRepo, changelogs) {
     }
   }
 }
-async function writeMultiRepoIndex(contentDir, results) {
+async function writeMultiRepoIndex(contentDir, results, repoStatus) {
   const repoCards = results.map((r) => {
     const slug = slugify2(r.repoName);
     const stack = r.architecture.techStack.slice(0, 5).join(", ");
@@ -3433,13 +3433,32 @@ async function writeMultiRepoIndex(contentDir, results) {
       r.components.length > 0 ? `${r.components.length} components` : null,
       r.dataModels.length > 0 ? `${r.dataModels.length} data models` : null
     ].filter(Boolean).join(" \xB7 ");
+    const status = repoStatus?.[r.repoName];
+    const statusParts = [];
+    if (status?.lastAnalyzed) {
+      const date = new Date(status.lastAnalyzed).toLocaleDateString("en-US", {
+        year: "numeric",
+        month: "short",
+        day: "numeric"
+      });
+      statusParts.push(`Last analyzed: ${date}`);
+    }
+    if (status?.ciEnabled) {
+      statusParts.push(`CI: auto-sync on \`${status.ciBranch || "main"}\``);
+    }
+    if (status?.htmlUrl) {
+      statusParts.push(`[GitHub](${status.htmlUrl})`);
+    }
+    const statusLine = statusParts.length > 0 ? `
+
+${statusParts.join(" \xB7 ")}` : "";
     return `### [${r.repoName}](/docs/${slug})
 
 ${r.architecture.summary.split("\n")[0]}
 
 **Stack:** ${stack || "N/A"}${stats ? `
 
-${stats}` : ""}`;
+${stats}` : ""}${statusLine}`;
   }).join("\n\n---\n\n");
   const mdx = `---
 title: Documentation
@@ -4304,7 +4323,20 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
   try {
     genSpinner.start("Writing documentation content...");
     const contentDir = path10.join(outputDir, "content", "docs");
-    await writeContent(contentDir, results, crossRepo);
+    const contentOptions = {};
+    if (results.length > 1) {
+      const repoStatus = {};
+      for (const repo of repos) {
+        const cached = loadCache(cacheDir, repo.name);
+        repoStatus[repo.name] = {
+          htmlUrl: repo.htmlUrl,
+          lastAnalyzed: cached?.timestamp,
+          commitSha: cached?.commitSha
+        };
+      }
+      contentOptions.repoStatus = repoStatus;
+    }
+    await writeContent(contentDir, results, crossRepo, void 0, contentOptions);
     await writeMeta(contentDir, results, crossRepo);
     genSpinner.stop("Documentation content written");
   } catch (err) {
@@ -4356,7 +4388,7 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
       "To start the dev server again"
     );
     p8.outro("Done!");
-    return;
+    process.exit(0);
   }
   if (devServer) {
     killDevServer(devServer);
@@ -4373,9 +4405,9 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
       "Next steps"
     );
     p8.outro("Done!");
-    return;
+    process.exit(0);
   }
-  let vercelDeployed = false;
+  let vercelDeploymentUrl;
   if (wantsVercel && vercelToken) {
     const vercelResult = await deployToVercel({
       token: vercelToken,
@@ -4387,7 +4419,7 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
     });
     if (vercelResult) {
       p8.log.success(`Live at: ${vercelResult.deploymentUrl}`);
-      vercelDeployed = true;
+      vercelDeploymentUrl = vercelResult.deploymentUrl;
     }
   }
   if (wantsCi) {
@@ -4403,12 +4435,27 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
         config,
         branch: ciBranch
       });
+      config.ciEnabled = true;
+      config.ciBranch = ciBranch || "main";
+      try {
+        saveConfig(config);
+      } catch {
+      }
     }
   }
-  if (!vercelDeployed) {
+  const docsRepoUrl = `https://github.com/${deployResult.owner}/${deployResult.repoName}`;
+  if (vercelDeploymentUrl) {
+    p8.note(
+      `Docs repo:  ${docsRepoUrl}
+Live site:  ${vercelDeploymentUrl}`,
+      "Your documentation is ready!"
+    );
+    p8.outro(vercelDeploymentUrl);
+  } else {
     showVercelInstructions(deployResult.owner, deployResult.repoName);
+    p8.outro(`Docs repo: ${docsRepoUrl}`);
   }
-  p8.outro(`Docs repo: https://github.com/${deployResult.owner}/${deployResult.repoName}`);
+  process.exit(0);
 }
 function resolveTemplateDir() {
   const candidates = [
@@ -4650,7 +4697,22 @@ async function generateCommand(options) {
       }
     }
     const contentDir = path11.join(config.outputDir, "content", "docs");
-    await writeContent(contentDir, results, crossRepo, changelogs.size > 0 ? changelogs : void 0);
+    const contentOptions = {};
+    if (results.length > 1) {
+      const repoStatus = {};
+      for (const repo of config.repos) {
+        const cached = loadCache(cacheDir, repo.name);
+        repoStatus[repo.name] = {
+          htmlUrl: repo.htmlUrl,
+          ciEnabled: config.ciEnabled,
+          ciBranch: config.ciBranch,
+          lastAnalyzed: cached?.timestamp,
+          commitSha: cached?.commitSha
+        };
+      }
+      contentOptions.repoStatus = repoStatus;
+    }
+    await writeContent(contentDir, results, crossRepo, changelogs.size > 0 ? changelogs : void 0, contentOptions);
     await writeMeta(contentDir, results, crossRepo, changelogs.size > 0 ? changelogs : void 0);
     try {
       await runBuildCheck({ docsDir: config.outputDir, apiKey, model });
@@ -4663,6 +4725,7 @@ async function generateCommand(options) {
     cleanupClone(clone);
   }
   p9.outro("Done!");
+  process.exit(0);
 }
 
 // src/commands/deploy.ts
@@ -4811,7 +4874,7 @@ async function logoutCommand() {
 
 // src/index.ts
 var program = new Command();
-program.name("open-auto-doc").description("Auto-generate beautiful documentation websites from GitHub repositories using AI").version("0.5.5");
+program.name("open-auto-doc").description("Auto-generate beautiful documentation websites from GitHub repositories using AI").version("0.5.6");
 program.command("init", { isDefault: true }).description("Initialize and generate documentation for your repositories").option("-o, --output <dir>", "Output directory", "docs-site").action(initCommand);
 program.command("generate").description("Regenerate documentation using existing configuration").option("--incremental", "Only re-analyze changed files (uses cached results)").option("--force", "Force full regeneration (ignore cache)").option("--repo <name>", "Only analyze this repo (uses cache for others)").action(generateCommand);
 program.command("deploy").description("Create a GitHub repo for docs and push (connect to Vercel for auto-deploy)").option("-d, --dir <path>", "Docs site directory").action(deployCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@latent-space-labs/open-auto-doc",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "description": "Auto-generate beautiful documentation websites from GitHub repositories using AI",
   "type": "module",
   "bin": {