@knowcode/doc-builder 1.2.9 → 1.2.10

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to @knowcode/doc-builder will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.10] - 2025-07-19
+
+### Fixed
+- **Critical fix**: Now properly replaces old directory listing index.html files
+- Detects and replaces index.html if it's under 3KB (likely a directory listing)
+- Detects and replaces index.html if it doesn't contain doc-builder markers
+- Fixes the issue where gasworld.vercel.app showed a directory listing instead of documentation
+
+### Added
+- Smart detection of outdated or non-doc-builder index.html files
+- Automatic replacement of directory listing pages with proper documentation
+- Clear logging when replacing an existing index.html file
+
 ## [1.2.9] - 2025-07-19
 
 ### Added

package/lib/core-builder.js

@@ -522,9 +522,28 @@ async function buildDocumentation(config) {
     console.log(chalk.red(`  - ERROR: Output directory does not exist!`));
   }
   
+  // Check if we need to create/replace index.html
+  let shouldCreateIndex = false;
+  
   if (!fs.existsSync(indexPath)) {
     console.log(chalk.yellow('⚠️  index.html does not exist, need to create it'));
-    
+    shouldCreateIndex = true;
+  } else {
+    // Check if existing index.html is likely a directory listing or outdated
+    const indexStats = fs.statSync(indexPath);
+    const indexContent = fs.readFileSync(indexPath, 'utf8');
+    
+    // Check if it's a small file (likely directory listing) or contains directory listing markers
+    if (indexStats.size < 3000 || indexContent.includes('<title>Documentation</title>') && indexContent.includes('<ul>') && !indexContent.includes('class="navigation"')) {
+      console.log(chalk.yellow('⚠️  Existing index.html appears to be a directory listing (size: ' + indexStats.size + ' bytes), will replace it'));
+      shouldCreateIndex = true;
+    } else if (!indexContent.includes('@knowcode/doc-builder')) {
+      console.log(chalk.yellow('⚠️  Existing index.html was not created by doc-builder, will replace it'));
+      shouldCreateIndex = true;
+    }
+  }
+  
+  if (shouldCreateIndex) {
     if (fs.existsSync(readmePath)) {
       console.log(chalk.blue('  → Found README.html, copying to index.html'));
       try {
@@ -561,9 +580,10 @@ async function buildDocumentation(config) {
       }
     }
   } else {
-    console.log(chalk.gray('ℹ️  index.html already exists (likely from index.md)'));
+    console.log(chalk.gray('ℹ️  index.html already exists and appears valid'));
     const stats = fs.statSync(indexPath);
     console.log(chalk.gray(`  - Existing index.html size: ${stats.size} bytes`));
+    console.log(chalk.gray(`  - Keeping existing index.html (likely from index.md or custom page)`));
   }
   
   // Final verification

package/lib/deploy.js

@@ -363,8 +363,27 @@ async function prepareDeployment(config) {
   console.log(chalk.gray(`  - Checking index.html: ${fs.existsSync(indexPath) ? 'exists' : 'missing'}`));
   console.log(chalk.gray(`  - Index path: ${indexPath}`));
   
+  // Check if we need to create/replace index.html
+  let shouldCreateIndex = false;
+  
   if (!fs.existsSync(indexPath)) {
     console.log(chalk.yellow('  ⚠️  index.html is missing, attempting to create...'));
+    shouldCreateIndex = true;
+  } else {
+    // Check if existing index.html needs replacement
+    const indexStats = fs.statSync(indexPath);
+    const indexContent = fs.readFileSync(indexPath, 'utf8');
+    
+    if (indexStats.size < 3000 || (indexContent.includes('<title>Documentation</title>') && indexContent.includes('<ul>') && !indexContent.includes('class="navigation"'))) {
+      console.log(chalk.yellow(`  ⚠️  Existing index.html appears to be a directory listing (${indexStats.size} bytes), will replace`));
+      shouldCreateIndex = true;
+    } else if (!indexContent.includes('@knowcode/doc-builder')) {
+      console.log(chalk.yellow('  ⚠️  Existing index.html was not created by doc-builder, will replace'));
+      shouldCreateIndex = true;
+    }
+  }
+  
+  if (shouldCreateIndex) {
     console.log(chalk.gray(`  - Checking README.html: ${fs.existsSync(readmePath) ? 'exists' : 'missing'}`));
     console.log(chalk.gray(`  - README path: ${readmePath}`));
     
@@ -440,7 +459,9 @@ async function prepareDeployment(config) {
       }
     }
   } else {
-    console.log(chalk.gray('  ✓ index.html already exists'));
+    console.log(chalk.gray('  ✓ index.html already exists and appears valid'));
+    const stats = fs.statSync(indexPath);
+    console.log(chalk.gray(`  - Keeping existing index.html (${stats.size} bytes)`));
   }
   
   // Final check - log what files exist

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.2.9",
+  "version": "1.2.10",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {