@latent-space-labs/open-auto-doc 0.3.9 → 0.4.1

package/dist/index.js

@@ -273,7 +273,8 @@ async function createAndPushDocsRepo(params) {
     owner = selected;
   }
   const isOrg = owner !== username;
-  const defaultName = config?.repos?.[0] ? `${config.repos[0].name}-docs` : "my-project-docs";
+  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,
@@ -1256,6 +1257,258 @@ ${EFFICIENCY_HINTS}`,
     maxTurns: 25
   });
 }
+var configOutputSchema = {
+  type: "object",
+  properties: {
+    configItems: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          name: { type: "string", description: "Config variable or option name" },
+          source: { type: "string", description: "Where this config is defined (e.g. .env, config.ts, process.env)" },
+          type: { type: "string", description: "Data type (string, number, boolean, etc.)" },
+          defaultValue: { type: "string", description: "Default value if any" },
+          required: { type: "boolean", description: "Whether this config is required" },
+          description: { type: "string", description: "What this config option does" },
+          category: { type: "string", description: "Grouping category (e.g. Database, Auth, Feature Flags)" }
+        },
+        required: ["name", "source", "type", "required", "description"]
+      }
+    },
+    configFiles: {
+      type: "array",
+      items: { type: "string" },
+      description: "List of configuration file paths found in the project"
+    },
+    environmentVariables: {
+      type: "array",
+      items: { type: "string" },
+      description: "List of environment variable names used in the project"
+    }
+  },
+  required: ["configItems", "configFiles", "environmentVariables"]
+};
+async function analyzeConfiguration(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse) {
+  const claudeMdContext = staticAnalysis.claudeMd.map((c) => c.content).join("\n\n");
+  return runAgent({
+    onAgentMessage,
+    onToolUse,
+    systemPrompt: `You are a configuration documentation expert. Your job is to find and document every configuration option, environment variable, and feature flag in a codebase.
+Your output must be valid JSON matching the provided schema. No markdown, no explanations outside the JSON.`,
+    prompt: `Analyze this codebase and extract all configuration options and environment variables.
+
+## Architecture Context
+${architecture.summary}
+Tech Stack: ${architecture.techStack.join(", ")}
+${claudeMdContext ? `
+## CLAUDE.md Context
+${claudeMdContext}
+` : ""}
+
+## Instructions
+1. Use Glob to find config files: \`.env*\`, \`config/**\`, \`**/config.*\`, \`**/*.config.*\`, \`**/settings.*\`, \`**/.env.example\`
+2. Use Grep to search for \`process.env\`, \`os.environ\`, \`ConfigService\`, \`@Value\`, \`getenv\`, \`ENV[\`, \`config.\` references
+3. Use Read to examine config files, .env.example files, and files that reference environment variables
+
+For each configuration item:
+- Identify the variable name and where it's defined
+- Determine its type and default value (if any)
+- Note whether it's required for the app to function
+- Write a clear description of what it controls
+- Assign a category (Database, Auth, API Keys, Feature Flags, Server, Logging, etc.)
+
+Also list all config files found and all environment variable names.
+If no configuration is found, return empty arrays.
+${EFFICIENCY_HINTS}`,
+    cwd: repoPath,
+    apiKey,
+    model,
+    outputSchema: configOutputSchema,
+    maxTurns: 30
+  });
+}
+var businessLogicSchema = {
+  type: "object",
+  properties: {
+    domainConcepts: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          name: { type: "string", description: "Domain concept name (e.g. User, Order, Subscription)" },
+          description: { type: "string", description: "What this concept represents in the domain" },
+          relatedFiles: { type: "array", items: { type: "string" }, description: "Key files implementing this concept" }
+        },
+        required: ["name", "description", "relatedFiles"]
+      }
+    },
+    businessRules: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          name: { type: "string", description: "Short name for the business rule" },
+          description: { type: "string", description: "What the rule enforces or ensures" },
+          sourceFiles: { type: "array", items: { type: "string" }, description: "Files containing this rule" },
+          category: { type: "string", description: "Category (Validation, Authorization, Pricing, Workflow, etc.)" }
+        },
+        required: ["name", "description", "sourceFiles"]
+      }
+    },
+    workflows: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          name: { type: "string", description: "Workflow name" },
+          description: { type: "string", description: "What this workflow accomplishes" },
+          steps: { type: "array", items: { type: "string" }, description: "Ordered steps in the workflow" },
+          diagram: {
+            type: "object",
+            properties: {
+              id: { type: "string" },
+              title: { type: "string" },
+              description: { type: "string" },
+              mermaidSyntax: { type: "string" }
+            },
+            required: ["id", "title", "description", "mermaidSyntax"]
+          }
+        },
+        required: ["name", "description", "steps"]
+      }
+    },
+    keyInvariants: {
+      type: "array",
+      items: { type: "string" },
+      description: "Key invariants or constraints the system maintains"
+    }
+  },
+  required: ["domainConcepts", "businessRules", "workflows", "keyInvariants"]
+};
+async function analyzeBusinessLogic(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse) {
+  const claudeMdContext = staticAnalysis.claudeMd.map((c) => c.content).join("\n\n");
+  return runAgent({
+    onAgentMessage,
+    onToolUse,
+    systemPrompt: `You are a domain analysis expert. Your job is to extract the "why" behind the code \u2014 the business rules, domain concepts, workflows, and invariants that shape how the software behaves.
+Focus on rules and logic, not implementation details. Your output must be valid JSON matching the provided schema. No markdown, no explanations outside the JSON.`,
+    prompt: `Analyze this codebase and extract business logic, domain concepts, and workflows.
+
+## Architecture Context
+${architecture.summary}
+Tech Stack: ${architecture.techStack.join(", ")}
+Modules: ${architecture.modules.map((m) => `${m.name}: ${m.description}`).join("\n")}
+${claudeMdContext ? `
+## CLAUDE.md Context
+${claudeMdContext}
+` : ""}
+
+## Instructions
+1. Use Glob to find service, domain, and business logic files: \`**/services/**\`, \`**/domain/**\`, \`**/rules/**\`, \`**/validators/**\`, \`**/policies/**\`, \`**/workflows/**\`, \`**/middleware/**\`
+2. Use Grep to find validation functions, guard clauses, authorization checks, state transitions, business rule comments
+3. Use Read to examine key files and understand the domain logic
+
+**Domain Concepts**: Identify the core entities/concepts of the domain (not just data models, but the ideas the software is built around). Explain what each represents.
+
+**Business Rules**: Find rules encoded in the logic \u2014 validation rules, authorization policies, pricing logic, rate limits, state machine transitions. For each rule, explain what it enforces.
+
+**Workflows**: Identify multi-step processes (e.g. user registration flow, order processing, deployment pipeline). List the steps and optionally generate a Mermaid \`stateDiagram-v2\` for the most important workflow.
+
+**Key Invariants**: List constraints the system must always maintain (e.g. "every order must have a valid customer", "API keys must be hashed before storage").
+
+If this is a library without clear business logic, focus on the design rules and constraints that guide how the library is used.
+${EFFICIENCY_HINTS}`,
+    cwd: repoPath,
+    apiKey,
+    model,
+    outputSchema: businessLogicSchema,
+    maxTurns: 35
+  });
+}
+var errorHandlingSchema = {
+  type: "object",
+  properties: {
+    errorCodes: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          code: { type: "string", description: "Error code identifier" },
+          httpStatus: { type: "number", description: "Associated HTTP status code if applicable" },
+          message: { type: "string", description: "Error message shown to users" },
+          description: { type: "string", description: "Detailed explanation of when and why this error occurs" },
+          sourceFile: { type: "string", description: "File where this error is defined" }
+        },
+        required: ["code", "message", "description"]
+      }
+    },
+    commonErrors: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          error: { type: "string", description: "Error name or symptom" },
+          cause: { type: "string", description: "What causes this error" },
+          solution: { type: "string", description: "How to fix or resolve this error" },
+          category: { type: "string", description: "Category (Setup, Runtime, Configuration, Authentication, etc.)" }
+        },
+        required: ["error", "cause", "solution"]
+      }
+    },
+    errorClasses: {
+      type: "array",
+      items: { type: "string" },
+      description: "Custom error class names defined in the codebase"
+    },
+    debuggingTips: {
+      type: "array",
+      items: { type: "string" },
+      description: "General debugging tips and techniques for this project"
+    }
+  },
+  required: ["errorCodes", "commonErrors", "errorClasses", "debuggingTips"]
+};
+async function analyzeErrorHandling(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse) {
+  const claudeMdContext = staticAnalysis.claudeMd.map((c) => c.content).join("\n\n");
+  return runAgent({
+    onAgentMessage,
+    onToolUse,
+    systemPrompt: `You are an error handling documentation expert. Your job is to find and document all error patterns, error codes, custom error classes, and common failure modes in a codebase. Write troubleshooting guidance that helps developers diagnose and fix issues.
+Your output must be valid JSON matching the provided schema. No markdown, no explanations outside the JSON.`,
+    prompt: `Analyze this codebase and document its error handling patterns and common errors.
+
+## Architecture Context
+${architecture.summary}
+Tech Stack: ${architecture.techStack.join(", ")}
+${claudeMdContext ? `
+## CLAUDE.md Context
+${claudeMdContext}
+` : ""}
+
+## Instructions
+1. Use Grep to find custom Error classes: \`extends Error\`, \`extends BaseError\`, \`class.*Error\`, \`class.*Exception\`
+2. Use Grep to find error code constants: \`ERROR_\`, \`ERR_\`, \`error_code\`, HTTP status codes (\`400\`, \`401\`, \`403\`, \`404\`, \`500\`)
+3. Use Grep to find error handling patterns: \`try.*catch\`, error middleware, \`.catch(\`, \`onError\`, \`handleError\`
+4. Use Read to examine error handling files, middleware, and error class definitions
+
+**Error Codes**: Document any defined error codes with their HTTP status (if applicable), user-facing message, and a detailed description of when they occur.
+
+**Common Errors**: Identify errors developers commonly encounter when setting up, configuring, or using this project. For each, explain the cause and provide a clear solution.
+
+**Error Classes**: List all custom error/exception classes defined in the project.
+
+**Debugging Tips**: Write 3-8 practical debugging tips specific to this project (e.g. "Enable verbose logging by setting LOG_LEVEL=debug", "Check the /health endpoint for service status").
+
+If no error handling patterns are found, return empty arrays with a few general debugging tips.
+${EFFICIENCY_HINTS}`,
+    cwd: repoPath,
+    apiKey,
+    model,
+    outputSchema: errorHandlingSchema,
+    maxTurns: 30
+  });
+}
 var guideOutputSchema = {
   type: "object",
   properties: {
@@ -1417,6 +1670,25 @@ var SECTION_PATTERNS = {
     /setup/i,
     /contributing/i,
     /getting.?started/i
+  ],
+  configuration: [
+    /\.env/i,
+    /config\//i,
+    /settings\//i,
+    /\.config\.(ts|js|mjs|cjs)$/
+  ],
+  businessLogic: [
+    /services?\//i,
+    /domain\//i,
+    /rules?\//i,
+    /validators?\//i,
+    /policies?\//i,
+    /workflows?\//i
+  ],
+  errorHandling: [
+    /errors?\//i,
+    /exceptions?\//i,
+    /middleware\//i
   ]
 };
 function computeDiff(repoPath, fromSha) {
@@ -1448,7 +1720,10 @@ function classifyChanges(entries, staticAnalysis) {
         "components",
         "dataModels",
         "features",
-        "gettingStarted"
+        "gettingStarted",
+        "configuration",
+        "businessLogic",
+        "errorHandling"
       ]),
       fullRegenRequired: true
     };
@@ -1510,21 +1785,30 @@ async function analyzeRepository(options) {
   onProgress?.("architecture", "Analyzing architecture with AI...");
   const architecture = await analyzeArchitecture(repoPath, staticAnalysis, apiKey, model, onAgentMessage, onToolUse);
   onProgress?.("architecture", `Identified ${architecture.modules.length} modules, ${architecture.diagrams.length} diagrams`);
-  onProgress?.("details", "Analyzing APIs, components, data models, and features...");
-  const [apiSettled, compSettled, modelSettled, featuresSettled] = await Promise.allSettled([
+  onProgress?.("details", "Analyzing APIs, components, data models, features, config, business logic, errors...");
+  const [apiSettled, compSettled, modelSettled, featuresSettled, configSettled, bizLogicSettled, errorSettled] = await Promise.allSettled([
     analyzeApiEndpoints(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse),
     analyzeComponents(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse),
     analyzeDataModels(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse),
-    analyzeFeatures(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse)
+    analyzeFeatures(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse),
+    analyzeConfiguration(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse),
+    analyzeBusinessLogic(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse),
+    analyzeErrorHandling(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse)
   ]);
   const apiResult = apiSettled.status === "fulfilled" ? apiSettled.value : null;
   const components = compSettled.status === "fulfilled" ? compSettled.value : [];
   const modelResult = modelSettled.status === "fulfilled" ? modelSettled.value : null;
   const features = featuresSettled.status === "fulfilled" ? featuresSettled.value : null;
+  const configuration = configSettled.status === "fulfilled" ? configSettled.value : null;
+  const businessLogic = bizLogicSettled.status === "fulfilled" ? bizLogicSettled.value : null;
+  const errorHandling = errorSettled.status === "fulfilled" ? errorSettled.value : null;
   if (apiSettled.status === "rejected") onProgress?.("details", `API analysis failed (non-fatal): ${apiSettled.reason}`);
   if (compSettled.status === "rejected") onProgress?.("details", `Component analysis failed (non-fatal): ${compSettled.reason}`);
   if (modelSettled.status === "rejected") onProgress?.("details", `Data model analysis failed (non-fatal): ${modelSettled.reason}`);
   if (featuresSettled.status === "rejected") onProgress?.("details", `Features analysis failed (non-fatal): ${featuresSettled.reason}`);
+  if (configSettled.status === "rejected") onProgress?.("details", `Configuration analysis failed (non-fatal): ${configSettled.reason}`);
+  if (bizLogicSettled.status === "rejected") onProgress?.("details", `Business logic analysis failed (non-fatal): ${bizLogicSettled.reason}`);
+  if (errorSettled.status === "rejected") onProgress?.("details", `Error handling analysis failed (non-fatal): ${errorSettled.reason}`);
   const apiEndpoints = apiResult?.endpoints ?? [];
   const dataModels = modelResult?.models ?? [];
   const diagrams = [
@@ -1532,6 +1816,11 @@ async function analyzeRepository(options) {
     ...apiResult?.diagram ? [apiResult.diagram] : [],
     ...modelResult?.diagram ? [modelResult.diagram] : []
   ];
+  if (businessLogic) {
+    for (const workflow of businessLogic.workflows) {
+      if (workflow.diagram) diagrams.push(workflow.diagram);
+    }
+  }
   onProgress?.(
     "details",
     `Found ${apiEndpoints.length} endpoints, ${components.length} components, ${dataModels.length} models, ${diagrams.length} diagrams${features ? `, ${features.features.length} features` : ""}`
@@ -1557,7 +1846,10 @@ async function analyzeRepository(options) {
     components,
     dataModels,
     gettingStarted,
-    diagrams
+    diagrams,
+    configuration,
+    businessLogic,
+    errorHandling
   };
 }
 async function analyzeRepositoryIncremental(options) {
@@ -1619,8 +1911,12 @@ async function analyzeRepositoryIncremental(options) {
   let components = previousResult.components;
   let dataModels = previousResult.dataModels;
   let features = previousResult.features;
+  let configuration = previousResult.configuration;
+  let businessLogic = previousResult.businessLogic;
+  let errorHandling = previousResult.errorHandling;
   let apiDiagram;
   let modelDiagram;
+  const workflowDiagrams = [];
   const prevArchDiagramIds = new Set(previousResult.architecture.diagrams.map((d) => d.id));
   const prevDetailDiagrams = previousResult.diagrams.filter((d) => !prevArchDiagramIds.has(d.id));
   const promises = [];
@@ -1670,6 +1966,42 @@ async function analyzeRepositoryIncremental(options) {
       })
     );
   }
+  if (affected.has("configuration")) {
+    promises.push(
+      analyzeConfiguration(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse).then(
+        (result) => {
+          configuration = result;
+        }
+      ).catch((err) => {
+        onProgress?.("details", `Configuration re-analysis failed (non-fatal): ${err}`);
+      })
+    );
+  }
+  if (affected.has("businessLogic")) {
+    promises.push(
+      analyzeBusinessLogic(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse).then(
+        (result) => {
+          businessLogic = result;
+          for (const workflow of result.workflows) {
+            if (workflow.diagram) workflowDiagrams.push(workflow.diagram);
+          }
+        }
+      ).catch((err) => {
+        onProgress?.("details", `Business logic re-analysis failed (non-fatal): ${err}`);
+      })
+    );
+  }
+  if (affected.has("errorHandling")) {
+    promises.push(
+      analyzeErrorHandling(repoPath, staticAnalysis, architecture, apiKey, model, onAgentMessage, onToolUse).then(
+        (result) => {
+          errorHandling = result;
+        }
+      ).catch((err) => {
+        onProgress?.("details", `Error handling re-analysis failed (non-fatal): ${err}`);
+      })
+    );
+  }
   if (promises.length > 0) {
     onProgress?.("details", "Re-analyzing affected sections...");
     await Promise.all(promises);
@@ -1687,6 +2019,13 @@ async function analyzeRepositoryIncremental(options) {
     const prevModelDiag = prevDetailDiagrams.find((d) => d.id.includes("model") || d.id.includes("er"));
     if (prevModelDiag) diagrams.push(prevModelDiag);
   }
+  if (affected.has("businessLogic")) {
+    diagrams.push(...workflowDiagrams);
+  } else if (businessLogic) {
+    for (const workflow of businessLogic.workflows) {
+      if (workflow.diagram) diagrams.push(workflow.diagram);
+    }
+  }
   let gettingStarted = previousResult.gettingStarted;
   if (affected.has("gettingStarted")) {
     onProgress?.("synthesis", "Re-writing getting started guide...");
@@ -1711,7 +2050,10 @@ async function analyzeRepositoryIncremental(options) {
     components,
     dataModels,
     gettingStarted,
-    diagrams
+    diagrams,
+    configuration,
+    businessLogic,
+    errorHandling
   };
 }
 var crossRepoSchema = {
@@ -1883,7 +2225,7 @@ Only edit files inside content/docs/.`,
     maxTurns: 35
   });
 }
-var CACHE_VERSION = 2;
+var CACHE_VERSION = 3;
 function slugify(name) {
   return name.replace(/[^a-zA-Z0-9_-]/g, "_");
 }
@@ -1912,6 +2254,137 @@ function loadCache(cacheDir, repoSlug) {
     return null;
   }
 }
+function computeChangelog(previous, current, fromCommit, toCommit) {
+  const added = [];
+  const removed = [];
+  const modified = [];
+  diffByKey(
+    previous.apiEndpoints,
+    current.apiEndpoints,
+    (e) => `${e.method} ${e.path}`,
+    (e) => e.description,
+    "API Endpoints",
+    added,
+    removed,
+    modified
+  );
+  diffByKey(
+    previous.components,
+    current.components,
+    (c) => c.name,
+    (c) => c.description,
+    "Components",
+    added,
+    removed,
+    modified
+  );
+  diffByKey(
+    previous.dataModels,
+    current.dataModels,
+    (m) => m.name,
+    (m) => m.description,
+    "Data Models",
+    added,
+    removed,
+    modified
+  );
+  if (previous.configuration && current.configuration) {
+    diffByKey(
+      previous.configuration.configItems,
+      current.configuration.configItems,
+      (c) => c.name,
+      (c) => c.description,
+      "Configuration",
+      added,
+      removed,
+      modified
+    );
+  } else if (current.configuration) {
+    for (const item of current.configuration.configItems) {
+      added.push({ name: item.name, description: item.description, section: "Configuration" });
+    }
+  }
+  if (previous.errorHandling && current.errorHandling) {
+    diffByKey(
+      previous.errorHandling.errorCodes,
+      current.errorHandling.errorCodes,
+      (e) => e.code,
+      (e) => e.description,
+      "Error Codes",
+      added,
+      removed,
+      modified
+    );
+  } else if (current.errorHandling) {
+    for (const item of current.errorHandling.errorCodes) {
+      added.push({ name: item.code, description: item.description, section: "Error Codes" });
+    }
+  }
+  if (previous.businessLogic && current.businessLogic) {
+    diffByKey(
+      previous.businessLogic.domainConcepts,
+      current.businessLogic.domainConcepts,
+      (c) => c.name,
+      (c) => c.description,
+      "Domain Concepts",
+      added,
+      removed,
+      modified
+    );
+  } else if (current.businessLogic) {
+    for (const item of current.businessLogic.domainConcepts) {
+      added.push({ name: item.name, description: item.description, section: "Domain Concepts" });
+    }
+  }
+  if (previous.features && current.features) {
+    diffByKey(
+      previous.features.features,
+      current.features.features,
+      (f) => f.name,
+      (f) => f.description,
+      "Features",
+      added,
+      removed,
+      modified
+    );
+  } else if (current.features) {
+    for (const item of current.features.features) {
+      added.push({ name: item.name, description: item.description, section: "Features" });
+    }
+  }
+  const totalChanges = added.length + removed.length + modified.length;
+  const parts = [];
+  if (added.length > 0) parts.push(`${added.length} added`);
+  if (removed.length > 0) parts.push(`${removed.length} removed`);
+  if (modified.length > 0) parts.push(`${modified.length} modified`);
+  const summary = totalChanges === 0 ? "No documentation changes detected." : `${totalChanges} changes: ${parts.join(", ")}.`;
+  return {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    fromCommit,
+    toCommit,
+    added,
+    removed,
+    modified,
+    summary
+  };
+}
+function diffByKey(previous, current, getKey, getDescription, section, added, removed, modified) {
+  const prevMap = new Map(previous.map((item) => [getKey(item), item]));
+  const currMap = new Map(current.map((item) => [getKey(item), item]));
+  for (const [key, item] of currMap) {
+    const prev = prevMap.get(key);
+    if (!prev) {
+      added.push({ name: key, description: getDescription(item), section });
+    } else if (getDescription(prev) !== getDescription(item)) {
+      modified.push({ name: key, description: getDescription(item), section });
+    }
+  }
+  for (const [key, item] of prevMap) {
+    if (!currMap.has(key)) {
+      removed.push({ name: key, description: getDescription(item), section });
+    }
+  }
+}
 
 // src/actions/build-check.ts
 function runBuild(docsDir) {
@@ -2536,7 +3009,7 @@ function loadTemplates() {
       `Template directory not found. __dirname=${__dirname}, searched: ${templateDirs.join(", ")}`
     );
   }
-  const templateFiles = ["overview", "features", "getting-started", "architecture", "api-endpoint", "component", "data-model", "diagrams", "cross-repo"];
+  const templateFiles = ["overview", "features", "getting-started", "architecture", "api-endpoint", "component", "data-model", "diagrams", "cross-repo", "configuration", "business-logic", "error-handling", "changelog"];
   for (const name of templateFiles) {
     const filePath = path23.join(templateDir, `${name}.hbs`);
     if (fs23.existsSync(filePath)) {
@@ -2548,11 +3021,12 @@ function loadTemplates() {
   }
   templatesLoaded = true;
 }
-async function writeContent(contentDir, results, crossRepo) {
+async function writeContent(contentDir, results, crossRepo, changelogs) {
   loadTemplates();
   await fs23.ensureDir(contentDir);
   if (results.length === 1) {
-    await writeRepoContent(contentDir, results[0]);
+    const changelog = changelogs?.get(results[0].repoName);
+    await writeRepoContent(contentDir, results[0], changelog);
   } else {
     await writeMultiRepoIndex(contentDir, results);
     if (crossRepo && templates["cross-repo"]) {
@@ -2563,7 +3037,8 @@ async function writeContent(contentDir, results, crossRepo) {
     }
     for (const result of results) {
       const repoDir = path23.join(contentDir, slugify2(result.repoName));
-      await writeRepoContent(repoDir, result);
+      const changelog = changelogs?.get(result.repoName);
+      await writeRepoContent(repoDir, result, changelog);
     }
   }
 }
@@ -2595,7 +3070,7 @@ ${repoCards}
 `;
   await fs23.writeFile(path23.join(contentDir, "index.mdx"), escapeMdxOutsideCode(mdx));
 }
-async function writeRepoContent(dir, result) {
+async function writeRepoContent(dir, result, changelog) {
   await fs23.ensureDir(dir);
   const safeResult = result;
   if (templates["overview"]) {
@@ -2661,6 +3136,62 @@ async function writeRepoContent(dir, result) {
       renderTemplate("diagrams", safeResult)
     );
   }
+  if (safeResult.configuration && safeResult.configuration.configItems.length > 0 && templates["configuration"]) {
+    const configByCategory = {};
+    for (const item of safeResult.configuration.configItems) {
+      const cat = item.category || "General";
+      if (!configByCategory[cat]) configByCategory[cat] = [];
+      configByCategory[cat].push(item);
+    }
+    await fs23.writeFile(
+      path23.join(dir, "configuration.mdx"),
+      renderTemplate("configuration", {
+        ...safeResult,
+        configByCategory,
+        configFiles: safeResult.configuration.configFiles,
+        environmentVariables: safeResult.configuration.environmentVariables
+      })
+    );
+  }
+  if (safeResult.businessLogic && templates["business-logic"]) {
+    const bl = safeResult.businessLogic;
+    if (bl.domainConcepts.length > 0 || bl.businessRules.length > 0 || bl.workflows.length > 0) {
+      await fs23.writeFile(
+        path23.join(dir, "business-logic.mdx"),
+        renderTemplate("business-logic", {
+          ...safeResult,
+          domainConcepts: bl.domainConcepts,
+          businessRules: bl.businessRules,
+          workflows: bl.workflows,
+          keyInvariants: bl.keyInvariants
+        })
+      );
+    }
+  }
+  if (safeResult.errorHandling && templates["error-handling"]) {
+    const eh = safeResult.errorHandling;
+    if (eh.errorCodes.length > 0 || eh.commonErrors.length > 0) {
+      await fs23.writeFile(
+        path23.join(dir, "error-handling.mdx"),
+        renderTemplate("error-handling", {
+          ...safeResult,
+          errorCodes: eh.errorCodes,
+          commonErrors: eh.commonErrors,
+          errorClasses: eh.errorClasses,
+          debuggingTips: eh.debuggingTips
+        })
+      );
+    }
+  }
+  if (changelog && templates["changelog"]) {
+    const hasChanges = changelog.added.length > 0 || changelog.removed.length > 0 || changelog.modified.length > 0;
+    if (hasChanges) {
+      await fs23.writeFile(
+        path23.join(dir, "changelog.mdx"),
+        renderTemplate("changelog", { ...safeResult, ...changelog })
+      );
+    }
+  }
 }
 function renderTemplate(name, data) {
   const template = templates[name];
@@ -2786,9 +3317,10 @@ function sanitizeCodeBlocks(mdx) {
 function slugify2(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 }
-async function writeMeta(contentDir, results, crossRepo) {
+async function writeMeta(contentDir, results, crossRepo, changelogs) {
   if (results.length === 1) {
-    await writeRepoMeta(contentDir, results[0]);
+    const changelog = changelogs?.get(results[0].repoName);
+    await writeRepoMeta(contentDir, results[0], changelog);
   } else {
     const pages = ["index"];
     if (crossRepo) pages.push("cross-repo");
@@ -2800,20 +3332,25 @@ async function writeMeta(contentDir, results, crossRepo) {
     );
     for (const result of results) {
       const repoDir = path33.join(contentDir, slugify22(result.repoName));
-      await writeRepoMeta(repoDir, result);
+      const changelog = changelogs?.get(result.repoName);
+      await writeRepoMeta(repoDir, result, changelog);
     }
   }
 }
-async function writeRepoMeta(dir, result) {
+async function writeRepoMeta(dir, result, changelog) {
   await fs33.ensureDir(dir);
   const pages = ["index"];
   if (result.features && result.features.features.length > 0) pages.push("features");
   pages.push("getting-started");
+  if (result.configuration && result.configuration.configItems.length > 0) pages.push("configuration");
+  if (result.businessLogic && (result.businessLogic.domainConcepts.length > 0 || result.businessLogic.businessRules.length > 0 || result.businessLogic.workflows.length > 0)) pages.push("business-logic");
   pages.push("architecture");
   if (result.apiEndpoints.length > 0) pages.push("api");
   if (result.components.length > 0) pages.push("components");
   if (result.dataModels.length > 0) pages.push("data-models");
+  if (result.errorHandling && (result.errorHandling.errorCodes.length > 0 || result.errorHandling.commonErrors.length > 0)) pages.push("error-handling");
   if (result.diagrams && result.diagrams.length > 0) pages.push("diagrams");
+  if (changelog && (changelog.added.length > 0 || changelog.removed.length > 0 || changelog.modified.length > 0)) pages.push("changelog");
   const meta = {
     title: result.repoName,
     pages
@@ -3068,6 +3605,12 @@ function buildRepoSummary(result) {
   if (result.dataModels.length > 0) {
     parts.push(`${result.dataModels.length} model${result.dataModels.length === 1 ? "" : "s"}`);
   }
+  if (result.configuration && result.configuration.configItems.length > 0) {
+    parts.push(`${result.configuration.configItems.length} config${result.configuration.configItems.length === 1 ? "" : "s"}`);
+  }
+  if (result.errorHandling && result.errorHandling.errorCodes.length > 0) {
+    parts.push(`${result.errorHandling.errorCodes.length} error code${result.errorHandling.errorCodes.length === 1 ? "" : "s"}`);
+  }
   return parts.length > 0 ? parts.join(", ") : "Analysis complete";
 }
 
@@ -3094,6 +3637,21 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
   }
   const repos = await pickRepos(token);
   p6.log.info(`Selected ${repos.length} ${repos.length === 1 ? "repository" : "repositories"}`);
+  let projectName;
+  if (repos.length > 1) {
+    const nameInput = await p6.text({
+      message: "What would you like to name this project?",
+      placeholder: "My Project",
+      validate: (v) => {
+        if (!v || v.trim().length === 0) return "Project name is required";
+      }
+    });
+    if (p6.isCancel(nameInput)) {
+      p6.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    projectName = nameInput;
+  }
   let apiKey = getAnthropicKey();
   if (!apiKey) {
     const keyInput = await p6.text({
@@ -3203,7 +3761,9 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
     }
   }
   const outputDir = path9.resolve(options.output || "docs-site");
-  const projectName = results.length === 1 ? results[0].repoName : "My Project";
+  if (!projectName) {
+    projectName = results.length === 1 ? results[0].repoName : "My Project";
+  }
   const genSpinner = p6.spinner();
   try {
     genSpinner.start("Scaffolding documentation site...");
@@ -3234,7 +3794,8 @@ Try reinstalling: npm install -g @latent-space-labs/open-auto-doc`
       cloneUrl: r.cloneUrl,
       htmlUrl: r.htmlUrl
     })),
-    outputDir
+    outputDir,
+    ...projectName !== results[0]?.repoName && { projectName }
   };
   try {
     saveConfig(config);
@@ -3455,6 +4016,7 @@ async function generateCommand(options) {
   const total = clones.length;
   const progressTable = new ProgressTable({ repos: clones.map((c) => c.info.name) });
   progressTable.start();
+  const changelogs = /* @__PURE__ */ new Map();
   const analysisPromises = clones.map(async (cloned) => {
     const repo = config.repos.find((r) => r.name === cloned.info.name);
     const repoName = repo.name;
@@ -3467,8 +4029,8 @@ async function generateCommand(options) {
     progressTable.update(repoName, { status: "active", message: "Starting..." });
     try {
       let result;
+      const cached = loadCache(cacheDir, repo.name);
       if (incremental) {
-        const cached = loadCache(cacheDir, repo.name);
         if (cached) {
           result = await analyzeRepositoryIncremental({
             repoPath: cloned.localPath,
@@ -3503,6 +4065,16 @@ async function generateCommand(options) {
           onToolUse
         });
       }
+      if (cached) {
+        try {
+          const headSha = getHeadSha(cloned.localPath);
+          const changelog = computeChangelog(cached.result, result, cached.commitSha, headSha);
+          if (changelog.added.length > 0 || changelog.removed.length > 0 || changelog.modified.length > 0) {
+            changelogs.set(repoName, changelog);
+          }
+        } catch {
+        }
+      }
       try {
         const headSha = getHeadSha(cloned.localPath);
         saveCache(cacheDir, repo.name, headSha, result);
@@ -3541,8 +4113,8 @@ async function generateCommand(options) {
       }
     }
     const contentDir = path10.join(config.outputDir, "content", "docs");
-    await writeContent(contentDir, results, crossRepo);
-    await writeMeta(contentDir, results, crossRepo);
+    await writeContent(contentDir, results, crossRepo, changelogs.size > 0 ? changelogs : void 0);
+    await writeMeta(contentDir, results, crossRepo, changelogs.size > 0 ? changelogs : void 0);
     try {
       await runBuildCheck({ docsDir: config.outputDir, apiKey, model });
     } catch (err) {
@@ -3682,7 +4254,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.3.9");
+program.name("open-auto-doc").description("Auto-generate beautiful documentation websites from GitHub repositories using AI").version("0.4.1");
 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/templates/mdx/business-logic.hbs

@@ -0,0 +1,83 @@
+---
+title: "Business Logic"
+description: "Domain concepts, business rules, and workflows for {{repoName}}"
+---
+
+# Business Logic & Domain Concepts
+
+{{#if domainConcepts.length}}
+## Domain Concepts
+
+{{#each domainConcepts}}
+### {{this.name}}
+
+{{this.description}}
+
+{{#if this.relatedFiles.length}}
+<details>
+<summary>Related files</summary>
+
+{{#each this.relatedFiles}}
+- `{{this}}`
+{{/each}}
+
+</details>
+{{/if}}
+
+{{/each}}
+{{/if}}
+
+{{#if businessRules.length}}
+## Business Rules
+
+{{#each businessRules}}
+### {{this.name}}
+
+{{this.description}}
+
+{{#if this.category}}**Category:** {{this.category}}{{/if}}
+
+{{#if this.sourceFiles.length}}
+<details>
+<summary>Source files</summary>
+
+{{#each this.sourceFiles}}
+- `{{this}}`
+{{/each}}
+
+</details>
+{{/if}}
+
+{{/each}}
+{{/if}}
+
+{{#if workflows.length}}
+## Workflows
+
+{{#each workflows}}
+### {{this.name}}
+
+{{this.description}}
+
+{{#if this.steps.length}}
+{{#each this.steps}}
+{{@index}}. {{this}}
+{{/each}}
+{{/if}}
+
+{{#if this.diagram}}
+```mermaid
+{{{this.diagram.mermaidSyntax}}}
+```
+{{/if}}
+
+{{/each}}
+{{/if}}
+
+{{#if keyInvariants.length}}
+## Key Invariants
+
+{{#each keyInvariants}}
+- {{this}}
+{{/each}}
+{{/if}}

package/dist/templates/mdx/changelog.hbs

@@ -0,0 +1,36 @@
+---
+title: "What Changed"
+description: "Documentation changelog for {{repoName}}"
+---
+
+# What Changed
+
+{{{summary}}}
+
+**Commit range:** `{{fromCommit}}` → `{{toCommit}}`
+
+**Generated:** {{generatedAt}}
+
+{{#if added.length}}
+## Added
+
+{{#each added}}
+- **{{this.name}}** ({{this.section}}) — {{this.description}}
+{{/each}}
+{{/if}}
+
+{{#if removed.length}}
+## Removed
+
+{{#each removed}}
+- **{{this.name}}** ({{this.section}}) — {{this.description}}
+{{/each}}
+{{/if}}
+
+{{#if modified.length}}
+## Modified
+
+{{#each modified}}
+- **{{this.name}}** ({{this.section}}) — {{this.description}}
+{{/each}}
+{{/if}}

package/dist/templates/mdx/configuration.hbs

@@ -0,0 +1,33 @@
+---
+title: "Configuration Reference"
+description: "Configuration options and environment variables for {{repoName}}"
+---
+
+# Configuration Reference
+
+{{#if configFiles.length}}
+## Configuration Files
+
+{{#each configFiles}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#each configByCategory}}
+## {{@key}}
+
+| Name | Source | Type | Default | Required | Description |
+|------|--------|------|---------|----------|-------------|
+{{#each this}}
+| `{{this.name}}` | `{{pipeEscape this.source}}` | `{{pipeEscape this.type}}` | {{#if this.defaultValue}}`{{pipeEscape this.defaultValue}}`{{else}}-{{/if}} | {{#if this.required}}Yes{{else}}No{{/if}} | {{pipeEscape this.description}} |
+{{/each}}
+
+{{/each}}
+
+{{#if environmentVariables.length}}
+## Environment Variables
+
+{{#each environmentVariables}}
+- `{{this}}`
+{{/each}}
+{{/if}}

package/dist/templates/mdx/error-handling.hbs

@@ -0,0 +1,47 @@
+---
+title: "Error Handling"
+description: "Error codes, troubleshooting, and debugging for {{repoName}}"
+---
+
+# Error Handling & Troubleshooting
+
+{{#if errorClasses.length}}
+## Error Classes
+
+{{#each errorClasses}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if errorCodes.length}}
+## Error Codes
+
+| Code | HTTP Status | Message | Description |
+|------|-------------|---------|-------------|
+{{#each errorCodes}}
+| `{{this.code}}` | {{#if this.httpStatus}}{{this.httpStatus}}{{else}}-{{/if}} | {{pipeEscape this.message}} | {{pipeEscape this.description}} |
+{{/each}}
+{{/if}}
+
+{{#if commonErrors.length}}
+## Common Errors & Solutions
+
+{{#each commonErrors}}
+### {{this.error}}
+
+{{#if this.category}}**Category:** {{this.category}}{{/if}}
+
+**Cause:** {{this.cause}}
+
+**Solution:** {{this.solution}}
+
+{{/each}}
+{{/if}}
+
+{{#if debuggingTips.length}}
+## Debugging Tips
+
+{{#each debuggingTips}}
+- {{this}}
+{{/each}}
+{{/if}}

package/package.json

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