@latent-space-labs/open-auto-doc 0.5.2 → 0.5.4

package/dist/index.js

@@ -10,6 +10,7 @@ import net from "net";
 import path10 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { spawn } from "child_process";
+import { Octokit as Octokit4 } from "@octokit/rest";
 
 // src/auth/device-flow.ts
 import * as p from "@clack/prompts";
@@ -258,48 +259,58 @@ function getGitHubUsername(octokit) {
   return octokit.rest.users.getAuthenticated().then((res) => res.data.login);
 }
 async function createAndPushDocsRepo(params) {
-  const { token, docsDir, config } = params;
+  const { token, docsDir, config, preCollected } = params;
   const octokit = new Octokit2({ auth: token });
   const username = await getGitHubUsername(octokit);
-  let orgs = [];
-  try {
-    const { data } = await octokit.rest.orgs.listForAuthenticatedUser({ per_page: 100 });
-    orgs = data;
-  } catch {
-  }
-  const ownerOptions = [
-    { value: username, label: username, hint: "Personal account" },
-    ...orgs.map((org) => ({ value: org.login, label: org.login, hint: "Organization" }))
-  ];
-  let owner = username;
-  if (ownerOptions.length > 1) {
-    const selected = await p3.select({
-      message: "Where should the docs repo be created?",
-      options: ownerOptions
+  let owner;
+  let repoName;
+  let visibility;
+  if (preCollected) {
+    owner = preCollected.owner;
+    repoName = preCollected.repoName;
+    visibility = preCollected.visibility;
+  } else {
+    let orgs = [];
+    try {
+      const { data } = await octokit.rest.orgs.listForAuthenticatedUser({ per_page: 100 });
+      orgs = data;
+    } catch {
+    }
+    const ownerOptions = [
+      { value: username, label: username, hint: "Personal account" },
+      ...orgs.map((org) => ({ value: org.login, label: org.login, hint: "Organization" }))
+    ];
+    owner = username;
+    if (ownerOptions.length > 1) {
+      const selected = await p3.select({
+        message: "Where should the docs repo be created?",
+        options: ownerOptions
+      });
+      if (p3.isCancel(selected)) return null;
+      owner = selected;
+    }
+    const isOrg2 = owner !== username;
+    const slug = config?.projectName ? config.projectName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "") : config?.repos?.[0]?.name;
+    const defaultName = slug ? `${slug}-docs` : "my-project-docs";
+    repoName = await p3.text({
+      message: "Name for the docs GitHub repo:",
+      initialValue: defaultName,
+      validate: (v) => {
+        if (!v || v.length === 0) return "Repo name is required";
+        if (!/^[a-zA-Z0-9._-]+$/.test(v)) return "Invalid repo name";
+      }
+    });
+    if (p3.isCancel(repoName)) return null;
+    visibility = await p3.select({
+      message: "Repository visibility:",
+      options: [
+        { value: "public", label: "Public" },
+        { value: "private", label: "Private" }
+      ]
     });
-    if (p3.isCancel(selected)) return null;
-    owner = selected;
+    if (p3.isCancel(visibility)) return null;
   }
   const isOrg = owner !== username;
-  const slug = config?.projectName ? config.projectName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "") : config?.repos?.[0]?.name;
-  const defaultName = slug ? `${slug}-docs` : "my-project-docs";
-  const repoName = await p3.text({
-    message: "Name for the docs GitHub repo:",
-    initialValue: defaultName,
-    validate: (v) => {
-      if (!v || v.length === 0) return "Repo name is required";
-      if (!/^[a-zA-Z0-9._-]+$/.test(v)) return "Invalid repo name";
-    }
-  });
-  if (p3.isCancel(repoName)) return null;
-  const visibility = await p3.select({
-    message: "Repository visibility:",
-    options: [
-      { value: "public", label: "Public" },
-      { value: "private", label: "Private" }
-    ]
-  });
-  if (p3.isCancel(visibility)) return null;
   const spinner9 = p3.spinner();
   spinner9.start(`Creating GitHub repo ${owner}/${repoName}...`);
   let repoUrl;
@@ -309,7 +320,8 @@ async function createAndPushDocsRepo(params) {
         org: owner,
         name: repoName,
         private: visibility === "private",
-        description: "Auto-generated documentation site",
+        description: "Documentation auto-generated by https://www.openautodoc.com",
+        homepage: "https://www.openautodoc.com",
         auto_init: false
       });
       repoUrl = data.clone_url;
@@ -318,7 +330,8 @@ async function createAndPushDocsRepo(params) {
       const { data } = await octokit.rest.repos.createForAuthenticatedUser({
         name: repoName,
         private: visibility === "private",
-        description: "Auto-generated documentation site",
+        description: "Documentation auto-generated by https://www.openautodoc.com",
+        homepage: "https://www.openautodoc.com",
         auto_init: false
       });
       repoUrl = data.clone_url;
@@ -438,8 +451,18 @@ async function authenticateVercel() {
     }
     p4.log.warn("Saved Vercel token is invalid.");
   }
-  p4.log.info(
-    "Create a Vercel token at: https://vercel.com/account/tokens"
+  p4.note(
+    [
+      "To create a Vercel access token:",
+      "",
+      "  1. Go to https://vercel.com/account/settings/tokens",
+      "  2. Click 'Create Token'",
+      "  3. Enter a name (e.g., 'open-auto-doc')",
+      "  4. Select the scope (your personal account or a team)",
+      "  5. Set an expiration (or no expiration for convenience)",
+      "  6. Click 'Create Token' and copy the value"
+    ].join("\n"),
+    "Vercel Token Required"
   );
   const tokenInput = await p4.text({
     message: "Enter your Vercel token",
@@ -469,29 +492,32 @@ async function authenticateVercel() {
 }
 async function deployToVercel(params) {
   const { token, githubOwner, githubRepo, docsDir, config } = params;
-  const { data: userData } = await vercelFetch(
-    "/v2/user",
-    token
-  );
-  const userId = userData.user?.id;
-  const { data: teamsData } = await vercelFetch(
-    "/v2/teams",
-    token
-  );
-  const teams = teamsData.teams ?? [];
   let teamId;
-  if (teams.length > 0) {
-    const scopeOptions = [
-      { value: "__personal__", label: userData.user?.username ?? "Personal", hint: "Personal account" },
-      ...teams.map((t) => ({ value: t.id, label: t.name || t.slug, hint: "Team" }))
-    ];
-    const selectedScope = await p4.select({
-      message: "Which Vercel scope should own this project?",
-      options: scopeOptions
-    });
-    if (p4.isCancel(selectedScope)) return null;
-    if (selectedScope !== "__personal__") {
-      teamId = selectedScope;
+  if (params.scope) {
+    teamId = params.scope.teamId;
+  } else {
+    const { data: userData } = await vercelFetch(
+      "/v2/user",
+      token
+    );
+    const { data: teamsData } = await vercelFetch(
+      "/v2/teams",
+      token
+    );
+    const teams = teamsData.teams ?? [];
+    if (teams.length > 0) {
+      const scopeOptions = [
+        { value: "__personal__", label: userData.user?.username ?? "Personal", hint: "Personal account" },
+        ...teams.map((t) => ({ value: t.id, label: t.name || t.slug, hint: "Team" }))
+      ];
+      const selectedScope = await p4.select({
+        message: "Which Vercel scope should own this project?",
+        options: scopeOptions
+      });
+      if (p4.isCancel(selectedScope)) return null;
+      if (selectedScope !== "__personal__") {
+        teamId = selectedScope;
+      }
     }
   }
   const spinner9 = p4.spinner();
@@ -543,6 +569,29 @@ async function deployToVercel(params) {
   const projectId = project.id;
   const projectName = project.name;
   spinner9.stop(`Created Vercel project: ${projectName}`);
+  spinner9.start("Triggering first deployment...");
+  const { ok: deployOk } = await vercelFetch(
+    "/v13/deployments",
+    token,
+    {
+      method: "POST",
+      teamId,
+      body: {
+        name: projectName,
+        project: projectId,
+        target: "production",
+        gitSource: {
+          type: "github",
+          org: githubOwner,
+          repo: githubRepo,
+          ref: "main"
+        }
+      }
+    }
+  );
+  if (!deployOk) {
+    spinner9.message("Waiting for deployment...");
+  }
   spinner9.start("Waiting for first deployment...");
   const maxWaitMs = 5 * 60 * 1e3;
   const pollIntervalMs = 5e3;
@@ -2802,18 +2851,24 @@ async function createCiWorkflow(params) {
     return createCiWorkflowsMultiRepo({
       token,
       config,
-      docsRepoUrl
+      docsRepoUrl,
+      branch: params.branch
     });
   }
   const relativeOutputDir = path7.relative(gitRoot, path7.resolve(outputDir));
   p6.log.info(`Docs repo: ${docsRepoUrl}`);
   p6.log.info(`Output directory: ${relativeOutputDir}`);
-  const branch = await p6.text({
-    message: "Which branch should trigger doc updates?",
-    initialValue: "main",
-    validate: (v) => v.length === 0 ? "Branch name is required" : void 0
-  });
-  if (p6.isCancel(branch)) return null;
+  let branch;
+  if (params.branch) {
+    branch = params.branch;
+  } else {
+    branch = await p6.text({
+      message: "Which branch should trigger doc updates?",
+      initialValue: "main",
+      validate: (v) => v.length === 0 ? "Branch name is required" : void 0
+    });
+    if (p6.isCancel(branch)) return null;
+  }
   const workflowDir = path7.join(gitRoot, ".github", "workflows");
   const workflowPath = path7.join(workflowDir, "update-docs.yml");
   fs7.mkdirSync(workflowDir, { recursive: true });
@@ -2850,12 +2905,17 @@ async function createCiWorkflowsMultiRepo(params) {
   const octokit = new Octokit3({ auth: token });
   p6.log.info(`Setting up CI for ${config.repos.length} repositories`);
   p6.log.info(`Docs repo: ${docsRepoUrl}`);
-  const branch = await p6.text({
-    message: "Which branch should trigger doc updates?",
-    initialValue: "main",
-    validate: (v) => v.length === 0 ? "Branch name is required" : void 0
-  });
-  if (p6.isCancel(branch)) return null;
+  let branch;
+  if (params.branch) {
+    branch = params.branch;
+  } else {
+    branch = await p6.text({
+      message: "Which branch should trigger doc updates?",
+      initialValue: "main",
+      validate: (v) => v.length === 0 ? "Branch name is required" : void 0
+    });
+    if (p6.isCancel(branch)) return null;
+  }
   const createdRepos = [];
   const workflowPath = ".github/workflows/update-docs.yml";
   for (const repo of config.repos) {
@@ -3011,19 +3071,18 @@ import * as p7 from "@clack/prompts";
 import fs8 from "fs";
 import path8 from "path";
 var MCP_SERVER_KEY = "project-docs";
-function getMcpConfig() {
+function getMcpConfig(docsDir) {
   return {
     command: "npx",
-    args: ["-y", "@latent-space-labs/open-auto-doc-mcp", "--project-dir", "."]
+    args: ["-y", "@latent-space-labs/open-auto-doc-mcp", "--project-dir", docsDir]
   };
 }
 async function setupMcpConfig(opts) {
-  const cacheDir = path8.join(opts.outputDir, ".autodoc-cache");
-  if (!fs8.existsSync(cacheDir)) {
-    p7.log.warn("No analysis cache found \u2014 skipping MCP setup. Run setup-mcp after generating docs.");
-    return;
-  }
-  writeMcpJson(process.cwd());
+  const absOutputDir = path8.resolve(opts.outputDir);
+  writeMcpJson(process.cwd(), absOutputDir);
+  writeMcpJson(absOutputDir, absOutputDir);
+  addMcpScript(absOutputDir);
+  showMcpInstructions(absOutputDir);
 }
 async function setupMcpCommand() {
   p7.intro("open-auto-doc \u2014 MCP Server Setup");
@@ -3047,11 +3106,48 @@ Run \`open-auto-doc init\` or \`open-auto-doc generate\` first.`
     p7.log.error("Cache directory exists but contains no analysis files.");
     process.exit(1);
   }
-  writeMcpJson(process.cwd());
+  const absOutputDir = path8.resolve(config.outputDir);
+  writeMcpJson(process.cwd(), absOutputDir);
+  writeMcpJson(absOutputDir, absOutputDir);
+  addMcpScript(absOutputDir);
+  showMcpInstructions(absOutputDir);
+  p7.outro("Open Claude Code in this project to start using the tools.");
+}
+function writeMcpJson(projectRoot, docsDir) {
+  const mcpPath = path8.join(projectRoot, ".mcp.json");
+  const relDocsDir = path8.relative(projectRoot, docsDir);
+  const isSubdir = !relDocsDir.startsWith("..") && !path8.isAbsolute(relDocsDir);
+  const configDocsDir = isSubdir ? `./${relDocsDir}` : docsDir;
+  let existing = {};
+  if (fs8.existsSync(mcpPath)) {
+    try {
+      existing = JSON.parse(fs8.readFileSync(mcpPath, "utf-8"));
+    } catch {
+    }
+  }
+  const mcpServers = existing.mcpServers ?? {};
+  mcpServers[MCP_SERVER_KEY] = getMcpConfig(configDocsDir);
+  const merged = { ...existing, mcpServers };
+  fs8.writeFileSync(mcpPath, JSON.stringify(merged, null, 2) + "\n");
+  p7.log.step(`Wrote ${mcpPath}`);
+}
+function addMcpScript(docsDir) {
+  const pkgPath = path8.join(docsDir, "package.json");
+  if (!fs8.existsSync(pkgPath)) return;
+  try {
+    const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
+    pkg.scripts = pkg.scripts ?? {};
+    pkg.scripts.mcp = "npx -y @latent-space-labs/open-auto-doc-mcp --project-dir .";
+    fs8.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    p7.log.step(`Added 'mcp' script to ${pkgPath}`);
+  } catch {
+  }
+}
+function showMcpInstructions(docsDir) {
   p7.log.success("MCP server configured!");
   p7.note(
     [
-      "The following tools are now available in Claude Code:",
+      "The following tools are now available:",
       "",
       "  get_project_overview    \u2014 Project summary and tech stack",
       "  search_documentation    \u2014 Full-text search across all docs",
@@ -3062,24 +3158,31 @@ Run \`open-auto-doc init\` or \`open-auto-doc generate\` first.`
       "  get_diagram             \u2014 Mermaid diagrams",
       "  get_business_rules      \u2014 Domain concepts and workflows"
     ].join("\n"),
-    "Available MCP tools"
+    "Available MCP Tools"
+  );
+  p7.note(
+    [
+      "A .mcp.json file has been written to your project.",
+      "Claude Code will automatically detect it.",
+      "",
+      "To use from another project, add this to its .mcp.json:",
+      "",
+      `  {`,
+      `    "mcpServers": {`,
+      `      "project-docs": {`,
+      `        "command": "npx",`,
+      `        "args": ["-y", "@latent-space-labs/open-auto-doc-mcp",`,
+      `                 "--project-dir", "${docsDir}"]`,
+      `      }`,
+      `    }`,
+      `  }`,
+      "",
+      "Or run the MCP server directly from the docs directory:",
+      "",
+      `  cd ${docsDir} && npm run mcp`
+    ].join("\n"),
+    "How to Connect"
   );
-  p7.outro("Open Claude Code in this project to start using the tools.");
-}
-function writeMcpJson(projectRoot) {
-  const mcpPath = path8.join(projectRoot, ".mcp.json");
-  let existing = {};
-  if (fs8.existsSync(mcpPath)) {
-    try {
-      existing = JSON.parse(fs8.readFileSync(mcpPath, "utf-8"));
-    } catch {
-    }
-  }
-  const mcpServers = existing.mcpServers ?? {};
-  mcpServers[MCP_SERVER_KEY] = getMcpConfig();
-  const merged = { ...existing, mcpServers };
-  fs8.writeFileSync(mcpPath, JSON.stringify(merged, null, 2) + "\n");
-  p7.log.step(`Wrote ${path8.relative(projectRoot, mcpPath)}`);
 }
 
 // ../generator/dist/index.js
@@ -3961,6 +4064,146 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
     process.exit(0);
   }
   p8.log.info(`Using ${model}`);
+  const shouldSetupMcp = await p8.confirm({
+    message: "Set up MCP server so Claude Code can query your docs?"
+  });
+  const wantsMcp = !p8.isCancel(shouldSetupMcp) && shouldSetupMcp;
+  const shouldDeploy = await p8.confirm({
+    message: "Would you like to deploy your docs to GitHub?"
+  });
+  const wantsDeploy = !p8.isCancel(shouldDeploy) && shouldDeploy;
+  let deployConfig;
+  let vercelToken = null;
+  let vercelScope;
+  let wantsVercel = false;
+  let wantsCi = false;
+  let ciBranch;
+  if (wantsDeploy) {
+    const octokit = new Octokit4({ auth: token });
+    let username;
+    try {
+      const { data } = await octokit.rest.users.getAuthenticated();
+      username = data.login;
+    } catch {
+      p8.log.error("Failed to fetch GitHub user info.");
+      process.exit(1);
+    }
+    let orgs = [];
+    try {
+      const { data } = await octokit.rest.orgs.listForAuthenticatedUser({ per_page: 100 });
+      orgs = data;
+    } catch {
+    }
+    const ownerOptions = [
+      { value: username, label: username, hint: "Personal account" },
+      ...orgs.map((org) => ({ value: org.login, label: org.login, hint: "Organization" }))
+    ];
+    let owner = username;
+    if (ownerOptions.length > 1) {
+      const selected = await p8.select({
+        message: "Where should the docs repo be created?",
+        options: ownerOptions
+      });
+      if (p8.isCancel(selected)) {
+        p8.cancel("Operation cancelled");
+        process.exit(0);
+      }
+      owner = selected;
+    }
+    const slug = projectName ? projectName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "") : repos[0]?.name;
+    const defaultName = slug ? `${slug}-docs` : "my-project-docs";
+    const repoNameInput = await p8.text({
+      message: "Name for the docs GitHub repo:",
+      initialValue: defaultName,
+      validate: (v) => {
+        if (!v || v.length === 0) return "Repo name is required";
+        if (!/^[a-zA-Z0-9._-]+$/.test(v)) return "Invalid repo name";
+      }
+    });
+    if (p8.isCancel(repoNameInput)) {
+      p8.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    const visibilityInput = await p8.select({
+      message: "Repository visibility:",
+      options: [
+        { value: "public", label: "Public" },
+        { value: "private", label: "Private" }
+      ]
+    });
+    if (p8.isCancel(visibilityInput)) {
+      p8.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    deployConfig = {
+      owner,
+      repoName: repoNameInput,
+      visibility: visibilityInput
+    };
+    const shouldDeployVercel = await p8.confirm({
+      message: "Would you like to deploy to Vercel? (auto-deploys on every push)"
+    });
+    wantsVercel = !p8.isCancel(shouldDeployVercel) && shouldDeployVercel;
+    if (wantsVercel) {
+      vercelToken = await authenticateVercel();
+      if (vercelToken) {
+        try {
+          const teamsRes = await fetch("https://api.vercel.com/v2/teams", {
+            headers: { Authorization: `Bearer ${vercelToken}` }
+          });
+          const teamsData = await teamsRes.json();
+          const teams = teamsData?.teams ?? [];
+          if (teams.length > 0) {
+            const userRes = await fetch("https://api.vercel.com/v2/user", {
+              headers: { Authorization: `Bearer ${vercelToken}` }
+            });
+            const userData = await userRes.json();
+            const vercelUsername = userData?.user?.username ?? "Personal";
+            const scopeOptions = [
+              { value: "__personal__", label: vercelUsername, hint: "Personal account" },
+              ...teams.map((t) => ({ value: t.id, label: t.name || t.slug, hint: "Team" }))
+            ];
+            const selectedScope = await p8.select({
+              message: "Which Vercel scope should own this project?",
+              options: scopeOptions
+            });
+            if (p8.isCancel(selectedScope)) {
+              p8.cancel("Operation cancelled");
+              process.exit(0);
+            }
+            vercelScope = {
+              teamId: selectedScope === "__personal__" ? void 0 : selectedScope
+            };
+          } else {
+            vercelScope = { teamId: void 0 };
+          }
+        } catch {
+          vercelScope = { teamId: void 0 };
+        }
+      } else {
+        wantsVercel = false;
+      }
+    }
+    const shouldSetupCi = await p8.confirm({
+      message: "Would you like to set up CI to auto-update docs on every push?"
+    });
+    wantsCi = !p8.isCancel(shouldSetupCi) && shouldSetupCi;
+    if (wantsCi) {
+      const branchInput = await p8.text({
+        message: "Which branch should trigger doc updates?",
+        initialValue: "main",
+        validate: (v) => v.length === 0 ? "Branch name is required" : void 0
+      });
+      if (p8.isCancel(branchInput)) {
+        p8.cancel("Operation cancelled");
+        process.exit(0);
+      }
+      ciBranch = branchInput;
+    }
+  }
+  p8.log.step("All configured! Starting analysis and generation...");
+  const outputDir = path10.resolve(options.output || "docs-site");
+  const cacheDir = path10.join(outputDir, ".autodoc-cache");
   const cloneSpinner = p8.spinner();
   cloneSpinner.start(`Cloning ${repos.length} repositories...`);
   const clones = [];
@@ -3998,6 +4241,11 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
           progressTable.update(repoName, { activity: formatToolActivity(event) });
         }
       });
+      try {
+        const headSha = getHeadSha(cloned.localPath);
+        saveCache(cacheDir, repoName, headSha, result);
+      } catch {
+      }
       progressTable.update(repoName, { status: "done", summary: buildRepoSummary(result) });
       return { repo: repoName, result };
     } catch (err) {
@@ -4033,7 +4281,6 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
       p8.log.warn(`Cross-repo error: ${err instanceof Error ? err.message : err}`);
     }
   }
-  const outputDir = path10.resolve(options.output || "docs-site");
   if (!projectName) {
     projectName = results.length === 1 ? results[0].repoName : "My Project";
   }
@@ -4081,10 +4328,7 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
     p8.log.warn(`Build check skipped: ${err instanceof Error ? err.message : err}`);
   }
   p8.log.success("Documentation generated successfully!");
-  const shouldSetupMcp = await p8.confirm({
-    message: "Set up MCP server so Claude Code can query your docs?"
-  });
-  if (!p8.isCancel(shouldSetupMcp) && shouldSetupMcp) {
+  if (wantsMcp) {
     await setupMcpConfig({ outputDir });
   }
   let devServer;
@@ -4097,10 +4341,7 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
     p8.log.warn("Could not start preview server. You can run it manually:");
     p8.log.info(`  cd ${path10.relative(process.cwd(), outputDir)} && npm run dev`);
   }
-  const shouldDeploy = await p8.confirm({
-    message: "Would you like to deploy your docs to GitHub?"
-  });
-  if (p8.isCancel(shouldDeploy) || !shouldDeploy) {
+  if (!wantsDeploy || !deployConfig) {
     if (devServer) {
       killDevServer(devServer);
     }
@@ -4117,7 +4358,8 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
   const deployResult = await createAndPushDocsRepo({
     token,
     docsDir: outputDir,
-    config
+    config,
+    preCollected: deployConfig
   });
   if (!deployResult) {
     p8.note(
@@ -4128,51 +4370,35 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
     return;
   }
   let vercelDeployed = false;
-  const shouldDeployVercel = await p8.confirm({
-    message: "Would you like to deploy to Vercel? (auto-deploys on every push)"
-  });
-  if (!p8.isCancel(shouldDeployVercel) && shouldDeployVercel) {
-    const vercelToken = await authenticateVercel();
-    if (vercelToken) {
-      const vercelResult = await deployToVercel({
-        token: vercelToken,
-        githubOwner: deployResult.owner,
-        githubRepo: deployResult.repoName,
-        docsDir: outputDir,
-        config
-      });
-      if (vercelResult) {
-        p8.log.success(`Live at: ${vercelResult.deploymentUrl}`);
-        vercelDeployed = true;
-      }
+  if (wantsVercel && vercelToken) {
+    const vercelResult = await deployToVercel({
+      token: vercelToken,
+      githubOwner: deployResult.owner,
+      githubRepo: deployResult.repoName,
+      docsDir: outputDir,
+      config,
+      scope: vercelScope
+    });
+    if (vercelResult) {
+      p8.log.success(`Live at: ${vercelResult.deploymentUrl}`);
+      vercelDeployed = true;
     }
   }
-  const shouldSetupCi = await p8.confirm({
-    message: "Would you like to set up CI to auto-update docs on every push?"
-  });
-  if (p8.isCancel(shouldSetupCi) || !shouldSetupCi) {
-    if (!vercelDeployed) {
-      showVercelInstructions(deployResult.owner, deployResult.repoName);
-    }
-    p8.outro(`Docs repo: https://github.com/${deployResult.owner}/${deployResult.repoName}`);
-    return;
-  }
-  const gitRoot = getGitRoot();
-  if (!gitRoot) {
-    p8.log.warn("Not in a git repository \u2014 skipping CI setup. Run `open-auto-doc setup-ci` from your project root later.");
-    if (!vercelDeployed) {
-      showVercelInstructions(deployResult.owner, deployResult.repoName);
+  if (wantsCi) {
+    const gitRoot = getGitRoot();
+    if (!gitRoot) {
+      p8.log.warn("Not in a git repository \u2014 skipping CI setup. Run `open-auto-doc setup-ci` from your project root later.");
+    } else {
+      await createCiWorkflow({
+        gitRoot,
+        docsRepoUrl: deployResult.repoUrl,
+        outputDir,
+        token,
+        config,
+        branch: ciBranch
+      });
     }
-    p8.outro(`Docs repo: https://github.com/${deployResult.owner}/${deployResult.repoName}`);
-    return;
   }
-  const ciResult = await createCiWorkflow({
-    gitRoot,
-    docsRepoUrl: deployResult.repoUrl,
-    outputDir,
-    token,
-    config
-  });
   if (!vercelDeployed) {
     showVercelInstructions(deployResult.owner, deployResult.repoName);
   }
@@ -4579,7 +4805,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.2");
+program.name("open-auto-doc").description("Auto-generate beautiful documentation websites from GitHub repositories using AI").version("0.5.4");
 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/dist/site-template/README.md

@@ -0,0 +1,3 @@
+# {{projectName}}
+
+Documentation auto-generated by [Open Auto Doc](https://www.openautodoc.com).

package/package.json

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