@knowcode/doc-builder 1.2.7 → 1.2.9

package/CHANGELOG.md

@@ -5,6 +5,36 @@ 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.9] - 2025-07-19
+
+### Added
+- Comprehensive console logging for debugging index.html creation
+- Detailed file existence checks with paths and sizes
+- File copy verification with size comparison
+- List of HTML files found during build and deployment
+- Error handling with detailed error messages
+- Final verification step to confirm index.html exists
+
+### Improved
+- Much more verbose output to help diagnose deployment issues
+- Clear indication of what files are being processed
+- Better error reporting when file operations fail
+
+## [1.2.8] - 2025-07-19
+
+### Changed
+- Removed all JUNO references from documentation and code
+- Renamed `cybersolstice` preset to `notion-inspired`
+- Updated folder descriptions to be more generic
+- Changed default username from 'juno' to 'admin' in preset
+- Removed `juno-docs` binary alias from package.json
+- Updated keywords to remove 'juno' and add 'notion-style'
+- Cleaned up all internal references to use @knowcode/doc-builder
+
+### Fixed
+- Documentation now correctly references @knowcode/doc-builder instead of @juno/doc-builder
+- Updated GitHub URLs to use knowcode organization
+
 ## [1.2.7] - 2025-07-19
 
 ### Added

package/README.md

@@ -32,12 +32,12 @@ No installation needed! Just run:
 
 ```bash
 # Build and deploy to Vercel (default action)
-npx @juno/doc-builder
+npx @knowcode/doc-builder
 
 # Or use specific commands:
-npx @juno/doc-builder build   # Build HTML files only
-npx @juno/doc-builder dev      # Start development server
-npx @juno/doc-builder deploy   # Deploy to Vercel
+npx @knowcode/doc-builder build   # Build HTML files only
+npx @knowcode/doc-builder dev      # Start development server
+npx @knowcode/doc-builder deploy   # Deploy to Vercel
 ```
 
 The default action (no command specified) will build your documentation and deploy it to Vercel.
@@ -47,7 +47,7 @@ The default action (no command specified) will build your documentation and depl
 For faster execution and offline use:
 
 ```bash
-npm install --save-dev @juno/doc-builder
+npm install --save-dev @knowcode/doc-builder
 ```
 
 Then use shorter commands:
@@ -108,10 +108,10 @@ module.exports = {
 
 ## Presets
 
-Use the `cybersolstice` preset for compatibility with existing JUNO projects:
+Use the `notion-inspired` preset for a clean, modern documentation style:
 
 ```bash
-npx @juno/doc-builder build --preset cybersolstice
+npx @knowcode/doc-builder build --preset notion-inspired
 ```
 
 ## Commands
@@ -133,7 +133,7 @@ Options:
 Examples:
   doc-builder build                        # Build with defaults
   doc-builder build --input docs --output dist
-  doc-builder build --preset cybersolstice # Use JUNO platform preset
+  doc-builder build --preset notion-inspired # Use Notion-inspired preset
   doc-builder build --config my-config.js  # Use custom config
 ```
 
@@ -218,7 +218,7 @@ While developing the doc-builder:
 npm link
 
 # In your other project
-npm link @juno/doc-builder
+npm link @knowcode/doc-builder
 ```
 
 ### Option 2: File Reference
@@ -228,7 +228,7 @@ In your project's `package.json`:
 ```json
 {
   "devDependencies": {
-    "@juno/doc-builder": "file:../path/to/doc-builder"
+    "@knowcode/doc-builder": "file:../path/to/doc-builder"
   }
 }
 ```
@@ -240,7 +240,7 @@ Once published:
 ```json
 {
   "devDependencies": {
-    "@juno/doc-builder": "git+https://github.com/juno/doc-builder.git"
+    "@knowcode/doc-builder": "git+https://github.com/knowcode/doc-builder.git"
   }
 }
 ```

package/assets/css/style.css

@@ -1,4 +1,4 @@
-/* JUNO Documentation - Modern CSS Design System */
+/* Documentation Builder - Modern CSS Design System */
 
 :root {
   /* Color Palette */

package/assets/js/main.js

@@ -1,4 +1,4 @@
-// JUNO Documentation - Main JavaScript
+// Documentation Builder - Main JavaScript
 
 // Preview Banner Management
 // Set up banner state immediately to prevent flash
@@ -1261,7 +1261,6 @@ function generateBreadcrumbs() {
       .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
       .join(' ')
       .replace(/\b(Api|Html|Css|Js|Pdf|Qa|Ai)\b/g, (match) => match.toUpperCase())
-      .replace(/\bJuno\b/g, 'JUNO')
       .replace(/\bReadme\b/g, 'Overview');
     
     // Get appropriate icon based on segment

package/cli.js

@@ -66,7 +66,7 @@ program
   .option('-c, --config <path>', 'path to config file (default: doc-builder.config.js)')
   .option('-i, --input <dir>', 'input directory containing markdown files (default: docs)')
   .option('-o, --output <dir>', 'output directory for HTML files (default: html)')
-  .option('--preset <preset>', 'use a preset configuration (available: cybersolstice)')
+  .option('--preset <preset>', 'use a preset configuration (available: notion-inspired)')
   .option('--legacy', 'use legacy mode for backward compatibility')
   .option('--no-auth', 'disable authentication even if configured')
   .option('--no-changelog', 'disable automatic changelog generation')
@@ -74,7 +74,7 @@ program
 ${chalk.yellow('Examples:')}
   ${chalk.gray('$')} doc-builder build                        ${chalk.gray('# Build with defaults')}
   ${chalk.gray('$')} doc-builder build --input docs --output dist
-  ${chalk.gray('$')} doc-builder build --preset cybersolstice ${chalk.gray('# Use JUNO platform preset')}
+  ${chalk.gray('$')} doc-builder build --preset notion-inspired ${chalk.gray('# Use Notion-inspired preset')}
   ${chalk.gray('$')} doc-builder build --config my-config.js  ${chalk.gray('# Use custom config')}
 `)
   .action(async (options) => {

package/lib/config.js

@@ -49,12 +49,12 @@ const defaultConfig = {
 };
 
 /**
- * Cybersolstice preset - maintains compatibility with existing project
+ * Notion-inspired preset - clean, modern documentation style
  */
-const cybersolsticePreset = {
+const notionInspiredPreset = {
   docsDir: 'docs',
   outputDir: 'html',
-  siteName: 'JUNO Platform',  // Keep original for cybersolstice project
+  siteName: 'Documentation',  // Clean default name
   siteDescription: 'Transforming complex sales through intelligent automation',
   
   features: {
@@ -67,7 +67,7 @@ const cybersolsticePreset = {
   },
   
   auth: {
-    username: 'juno',
+    username: 'admin',
     password: 'docs2025'
   },
   
@@ -78,7 +78,7 @@ const cybersolsticePreset = {
   
   // Folder descriptions from existing code
   folderDescriptions: {
-    'product-roadmap': 'Strategic vision, timeline, and feature planning for the JUNO platform',
+    'product-roadmap': 'Strategic vision, timeline, and feature planning',
     'product-requirements': 'Detailed product specifications, requirements documents, and feature definitions',
     'architecture': 'System design, data flows, and technical infrastructure documentation',
     'system-analysis': 'Comprehensive system analysis, functional requirements, and cross-component documentation',
@@ -143,8 +143,8 @@ async function loadConfig(configPath, options = {}) {
   let config = { ...defaultConfig };
   
   // Apply preset if specified
-  if (options.preset === 'cybersolstice') {
-    config = { ...config, ...cybersolsticePreset };
+  if (options.preset === 'notion-inspired') {
+    config = { ...config, ...notionInspiredPreset };
   }
   
   // Load custom config file if it exists
@@ -251,7 +251,7 @@ async function createDefaultConfig() {
 
 module.exports = {
   defaultConfig,
-  cybersolsticePreset,
+  notionInspiredPreset,
   loadConfig,
   createDefaultConfig
 };

package/lib/core-builder.js

@@ -179,8 +179,8 @@ const folderDescriptions = {
   'bubble': 'Core application platform - business logic, UI/UX, and user workflows',
   'quickbase': 'Database schema, data management, and backend operations',
   'activecampaign': 'Marketing automation integration and lead management system',
-  'juno-signer': 'Document signing service for digital signatures and PDF generation',
-  'juno-api-deprecated': 'Legacy API documentation (deprecated, for reference only)',
+  'doc-signer': 'Document signing service for digital signatures and PDF generation',
+  'api-deprecated': 'Legacy API documentation (deprecated, for reference only)',
   'postman': 'API testing tools, collections, and test automation',
   'mcp': 'Model Context Protocol integration and configuration',
   'team': 'Team structure, roles, and responsibilities',
@@ -188,7 +188,7 @@ const folderDescriptions = {
   'middleware': 'Integration layers and data transformation services',
   'paths': 'User journey flows and process workflows',
   'testing': 'Test strategies, scenarios, and quality assurance processes',
-  'juno-api': 'API documentation and integration guides'
+  'api': 'API documentation and integration guides'
 };
 
 // Build navigation structure with rich functionality
@@ -250,8 +250,8 @@ function buildNavigationStructure(files, currentFile) {
       'bubble': 'fas fa-circle',
       'quickbase': 'fas fa-database',
       'activecampaign': 'fas fa-envelope',
-      'juno-signer': 'fas fa-signature',
-      'juno-api-deprecated': 'fas fa-archive',
+      'doc-signer': 'fas fa-signature',
+      'api-deprecated': 'fas fa-archive',
       'postman': 'fas fa-flask',
       'mcp': 'fas fa-puzzle-piece',
       'team': 'fas fa-users',
@@ -259,7 +259,7 @@ function buildNavigationStructure(files, currentFile) {
       'middleware': 'fas fa-layer-group',
       'paths': 'fas fa-route',
       'testing': 'fas fa-vial',
-      'juno-api': 'fas fa-plug',
+      'api': 'fas fa-plug',
       'documentation-tool': 'fas fa-tools'
     };
     
@@ -358,8 +358,8 @@ function buildNavigationStructure(files, currentFile) {
       'bubble',
       'quickbase',
       'activecampaign',
-      'juno-signer',
-      'juno-api-deprecated',
+      'doc-signer',
+      'api-deprecated',
       'postman',
       'mcp',
       'team',
@@ -460,6 +460,14 @@ async function buildDocumentation(config) {
   const files = await getAllMarkdownFiles(docsDir);
   console.log(chalk.green(`✅ Found ${files.length} markdown files${readmeGenerated ? ' (including auto-generated README)' : ''}`));
   
+  // Log the files found
+  if (files.length > 0) {
+    console.log(chalk.gray('  Found files:'));
+    files.forEach(file => {
+      console.log(chalk.gray(`  - ${file.relativePath} → ${file.urlPath}`));
+    });
+  }
+  
   console.log(chalk.blue('📝 Processing files...'));
   for (const file of files) {
     const outputPath = path.join(outputDir, file.urlPath);
@@ -499,23 +507,71 @@ async function buildDocumentation(config) {
   const indexSourcePath = path.join(outputDir, 'index.html'); // from index.md
   const readmePath = path.join(outputDir, 'README.html');
   
-  console.log(chalk.blue('📄 Checking for index.html creation...'));
-  console.log(chalk.gray(`  - index.html exists: ${fs.existsSync(indexPath)})`));
-  console.log(chalk.gray(`  - README.html exists: ${fs.existsSync(readmePath)})`));
+  console.log(chalk.blue('\n📄 Checking for index.html creation...'));
+  console.log(chalk.gray(`  - Output directory: ${outputDir}`));
+  console.log(chalk.gray(`  - Index path: ${indexPath}`));
+  console.log(chalk.gray(`  - README path: ${readmePath}`));
+  console.log(chalk.gray(`  - index.html exists: ${fs.existsSync(indexPath)}`));
+  console.log(chalk.gray(`  - README.html exists: ${fs.existsSync(readmePath)}`));
+  
+  // List all HTML files in output directory
+  if (fs.existsSync(outputDir)) {
+    const htmlFiles = fs.readdirSync(outputDir).filter(f => f.endsWith('.html'));
+    console.log(chalk.gray(`  - HTML files in output: [${htmlFiles.join(', ')}]`));
+  } else {
+    console.log(chalk.red(`  - ERROR: Output directory does not exist!`));
+  }
   
   if (!fs.existsSync(indexPath)) {
+    console.log(chalk.yellow('⚠️  index.html does not exist, need to create it'));
+    
     if (fs.existsSync(readmePath)) {
-      await fs.copy(readmePath, indexPath);
-      console.log(chalk.green('✅ Created index.html from README.html'));
+      console.log(chalk.blue('  → Found README.html, copying to index.html'));
+      try {
+        await fs.copy(readmePath, indexPath);
+        console.log(chalk.green('✅ Successfully created index.html from README.html'));
+        
+        // Verify the copy worked
+        if (fs.existsSync(indexPath)) {
+          const stats = fs.statSync(indexPath);
+          console.log(chalk.gray(`  - index.html size: ${stats.size} bytes`));
+        } else {
+          console.log(chalk.red('  - ERROR: index.html was not created!'));
+        }
+      } catch (error) {
+        console.log(chalk.red(`  - ERROR copying README.html: ${error.message}`));
+      }
     } else {
       // No README.html, create informative default page
       console.log(chalk.yellow('⚠️  No README.html found, creating default index.html'));
-      const defaultIndex = await createDefaultIndexPage(outputDir, config, packageJson.version);
-      await fs.writeFile(indexPath, defaultIndex);
-      console.log(chalk.green('✅ Created default index.html with instructions'));
+      try {
+        const defaultIndex = await createDefaultIndexPage(outputDir, config, packageJson.version);
+        await fs.writeFile(indexPath, defaultIndex);
+        console.log(chalk.green('✅ Created default index.html with instructions'));
+        
+        // Verify the write worked
+        if (fs.existsSync(indexPath)) {
+          const stats = fs.statSync(indexPath);
+          console.log(chalk.gray(`  - index.html size: ${stats.size} bytes`));
+        } else {
+          console.log(chalk.red('  - ERROR: default index.html was not created!'));
+        }
+      } catch (error) {
+        console.log(chalk.red(`  - ERROR creating default index.html: ${error.message}`));
+      }
     }
   } else {
     console.log(chalk.gray('ℹ️  index.html already exists (likely from index.md)'));
+    const stats = fs.statSync(indexPath);
+    console.log(chalk.gray(`  - Existing index.html size: ${stats.size} bytes`));
+  }
+  
+  // Final verification
+  console.log(chalk.blue('\n📋 Final index.html check:'));
+  if (fs.existsSync(indexPath)) {
+    console.log(chalk.green(`  ✅ index.html exists at: ${indexPath}`));
+  } else {
+    console.log(chalk.red(`  ❌ index.html is MISSING at: ${indexPath}`));
   }
   
   console.log(chalk.green('✅ Documentation build complete!'));

package/lib/deploy.js

@@ -346,17 +346,54 @@ async function prepareDeployment(config) {
   console.log(chalk.blue(`\n📦 Preparing deployment with @knowcode/doc-builder v${packageJson.version}`));
   
   // Create index.html from README.html if needed
+  console.log(chalk.blue('\n📁 Deployment preparation - index.html check:'));
   const indexPath = path.join(outputDir, 'index.html');
-  console.log(chalk.gray(`  - Checking index.html: ${fs.existsSync(indexPath) ? 'exists' : 'missing'}}`));
+  const readmePath = path.join(outputDir, 'README.html');
+  
+  console.log(chalk.gray(`  - Output directory: ${outputDir}`));
+  console.log(chalk.gray(`  - Output dir exists: ${fs.existsSync(outputDir)}`));
+  
+  if (fs.existsSync(outputDir)) {
+    const files = fs.readdirSync(outputDir);
+    const htmlFiles = files.filter(f => f.endsWith('.html'));
+    console.log(chalk.gray(`  - Total files: ${files.length}`));
+    console.log(chalk.gray(`  - HTML files: [${htmlFiles.slice(0, 5).join(', ')}${htmlFiles.length > 5 ? '...' : ''}]`));
+  }
+  
+  console.log(chalk.gray(`  - Checking index.html: ${fs.existsSync(indexPath) ? 'exists' : 'missing'}`));
+  console.log(chalk.gray(`  - Index path: ${indexPath}`));
   
   if (!fs.existsSync(indexPath)) {
-    const readmePath = path.join(outputDir, 'README.html');
-    console.log(chalk.gray(`  - Checking README.html: ${fs.existsSync(readmePath) ? 'exists' : 'missing'}}`));
+    console.log(chalk.yellow('  ⚠️  index.html is missing, attempting to create...'));
+    console.log(chalk.gray(`  - Checking README.html: ${fs.existsSync(readmePath) ? 'exists' : 'missing'}`));
+    console.log(chalk.gray(`  - README path: ${readmePath}`));
     
     if (fs.existsSync(readmePath)) {
       // Copy README.html to index.html for proper root page
-      fs.copyFileSync(readmePath, indexPath);
-      console.log(chalk.green('✅ Created index.html from README.html'));
+      console.log(chalk.blue('  → Copying README.html to index.html...'));
+      try {
+        fs.copyFileSync(readmePath, indexPath);
+        console.log(chalk.green('  ✅ Successfully copied README.html to index.html'));
+        
+        // Verify the copy
+        if (fs.existsSync(indexPath)) {
+          const readmeStats = fs.statSync(readmePath);
+          const indexStats = fs.statSync(indexPath);
+          console.log(chalk.gray(`  - README.html size: ${readmeStats.size} bytes`));
+          console.log(chalk.gray(`  - index.html size: ${indexStats.size} bytes`));
+          
+          if (readmeStats.size === indexStats.size) {
+            console.log(chalk.green('  ✅ File sizes match - copy successful'));
+          } else {
+            console.log(chalk.yellow('  ⚠️  File sizes do not match!'));
+          }
+        } else {
+          console.log(chalk.red('  ❌ ERROR: index.html was not created after copy!'));
+        }
+      } catch (error) {
+        console.log(chalk.red(`  ❌ ERROR copying file: ${error.message}`));
+        console.log(chalk.red(`  - Error stack: ${error.stack}`));
+      }
     } else {
       // If no README.html, find first available HTML file or create informative page
       console.log(chalk.yellow('⚠️  No README.html found, looking for other HTML files...'));
@@ -408,11 +445,24 @@ async function prepareDeployment(config) {
   
   // Final check - log what files exist
   console.log(chalk.blue('\n📁 Final deployment state:'));
+  
+  // Double-check index.html one more time
+  const finalIndexExists = fs.existsSync(indexPath);
+  console.log(chalk[finalIndexExists ? 'green' : 'red'](`  - index.html: ${finalIndexExists ? 'EXISTS' : 'MISSING'}`));
+  
+  if (finalIndexExists) {
+    const stats = fs.statSync(indexPath);
+    console.log(chalk.gray(`  - index.html size: ${stats.size} bytes`));
+    console.log(chalk.gray(`  - index.html modified: ${stats.mtime.toISOString()}`));
+  }
+  
   const finalFiles = fs.readdirSync(outputDir)
     .filter(file => file.endsWith('.html'))
     .slice(0, 5); // Show first 5 HTML files
+  console.log(chalk.gray(`\n  HTML files in ${outputDir}:`));
   finalFiles.forEach(file => {
-    console.log(chalk.gray(`  - ${file}`));
+    const size = fs.statSync(path.join(outputDir, file)).size;
+    console.log(chalk.gray(`  - ${file} (${size} bytes)`));
   });
   if (fs.readdirSync(outputDir).filter(f => f.endsWith('.html')).length > 5) {
     console.log(chalk.gray(`  - ... and ${fs.readdirSync(outputDir).filter(f => f.endsWith('.html')).length - 5} more HTML files`));

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {
     "doc-builder": "./cli.js",
-    "juno-docs": "./cli.js",
     "@knowcode/doc-builder": "./scripts/npx-runner.js"
   },
   "scripts": {
@@ -17,7 +16,8 @@
     "markdown",
     "static-site-generator",
     "vercel",
-    "juno"
+    "notion-style",
+    "doc-builder"
   ],
   "author": "KnowCode",
   "license": "MIT",

package/scripts/setup.js

@@ -1,5 +1,5 @@
 /**
- * Post-install setup script for @juno/doc-builder
+ * Post-install setup script for @knowcode/doc-builder
  * This script runs after npm install to help users get started
  */
 
@@ -52,5 +52,5 @@ if (foundDir) {
   console.log(chalk.yellow(`ℹ️  No docs directory found. Create a 'docs' folder with markdown files to get started.\n`));
 }
 
-console.log(chalk.gray('For more information, visit: https://github.com/juno-platform/doc-builder'));
+console.log(chalk.gray('For more information, visit: https://github.com/knowcode/doc-builder'));
 console.log(chalk.gray('To create a config file, run: doc-builder init --config\n'));