#!/usr/bin/env node /** * Reorganize docs.html sidebar - Update document metadata for better UX * * New structure based on audience and expertise level: * - Introduction (1-5): Absolute beginners, all audiences * - Implementation (10-19): Practical/technical for implementers * - Case Studies (20-29): Real-world examples, all audiences * - Business Strategy (30-35): Leaders/decision makers * - Advanced Topics (40-49): Deep technical for experts */ const { MongoClient } = require('mongodb'); require('dotenv').config(); const MONGODB_URI = process.env.MONGODB_URI || 'mongodb://localhost:27017/tractatus_dev'; // Document reorganization mapping // Format: { slug: { order, category, audience, description } } const DOCUMENT_MAPPING = { // INTRODUCTION (1-5) - Absolute beginners, all audiences 'architectural-overview-and-research-status': { order: 1, category: 'introduction', audience: 'general', description: 'Start here - overview of the Tractatus Framework' }, 'core-concepts-of-the-tractatus-framework': { order: 2, category: 'introduction', audience: 'general', description: 'Core concepts and principles' }, 'tractatus-ai-safety-framework-core-values-and-principles': { order: 3, category: 'introduction', audience: 'general', description: 'Values and principles' }, 'technical-architecture': { order: 4, category: 'introduction', audience: 'technical', description: 'System architecture overview' }, 'tractatus-agentic-governance-system-glossary-of-terms': { order: 5, category: 'introduction', audience: 'general', description: 'Glossary and terminology' }, // IMPLEMENTATION (10-19) - Practical/technical for implementers 'implementation-guide': { order: 10, category: 'implementation', audience: 'implementer', description: 'Complete implementation guide' }, 'tractatus-framework-implementation-guide': { order: 11, category: 'implementation', audience: 'implementer', description: 'Implementation guide v1.1 (detailed)' }, 'comparison-matrix-claude-code-claudemd-and-tractatus-framework': { order: 12, category: 'implementation', audience: 'implementer', description: 'Comparing different governance approaches' }, // CASE STUDIES (20-29) - Real-world examples, all audiences 'the-27027-incident-a-case-study-in-pattern-recognition-bias': { order: 20, category: 'case-studies', audience: 'general', description: 'The famous 27027 incident - pattern recognition bias' }, 'our-framework-in-action-detecting-and-correcting-ai-fabrications': { order: 21, category: 'case-studies', audience: 'general', description: 'How Tractatus catches AI fabrications' }, 'when-frameworks-fail-and-why-thats-ok': { order: 22, category: 'case-studies', audience: 'general', description: 'Learning from framework failures' }, 'real-world-ai-governance-a-case-study-in-framework-failure-and-recovery': { order: 23, category: 'case-studies', audience: 'general', description: 'Failure analysis and recovery process' }, 'framework-governance-in-action-pre-publication-security-audit': { order: 24, category: 'case-studies', audience: 'technical', description: 'Security audit before publication' }, 'case-studies-real-world-llm-failure-modes': { order: 25, category: 'case-studies', audience: 'researcher', description: 'Collection of real-world LLM failures' }, // BUSINESS STRATEGY (30-35) - Leaders/decision makers 'ai-governance-business-case-template-tractatus-framework': { order: 30, category: 'business', audience: 'leader', description: 'Business case template for AI governance' } }; async function reorganizeDocuments() { console.log('╔════════════════════════════════════════════════════════════╗'); console.log('║ Reorganizing Documentation Sidebar Structure ║'); console.log('╚════════════════════════════════════════════════════════════╝\n'); const client = new MongoClient(MONGODB_URI); try { await client.connect(); console.log('✓ Connected to MongoDB\n'); const db = client.db(); const documentsCollection = db.collection('documents'); // Get all documents const allDocs = await documentsCollection.find({}).toArray(); console.log(`Found ${allDocs.length} total documents\n`); let updated = 0; let skipped = 0; // Update each mapped document for (const [slug, metadata] of Object.entries(DOCUMENT_MAPPING)) { const doc = allDocs.find(d => d.slug === slug); if (!doc) { console.log(`⚠ Document not found: ${slug}`); skipped++; continue; } const updateFields = { order: metadata.order, category: metadata.category, audience: metadata.audience, updatedAt: new Date() }; await documentsCollection.updateOne( { slug }, { $set: updateFields } ); console.log(`✓ Updated: ${doc.title}`); console.log(` Order: ${metadata.order} | Category: ${metadata.category} | Audience: ${metadata.audience}\n`); updated++; } console.log('\n═══════════════════════════════════════════════════════════\n'); console.log(`✓ Updated: ${updated} documents`); console.log(`⊘ Skipped: ${skipped} documents`); console.log(`\n═══════════════════════════════════════════════════════════\n`); // Show new category distribution console.log('New Category Distribution:\n'); const categories = { introduction: { count: 0, orders: '1-5' }, implementation: { count: 0, orders: '10-19' }, 'case-studies': { count: 0, orders: '20-29' }, business: { count: 0, orders: '30-35' }, advanced: { count: 0, orders: '40-49' } }; Object.values(DOCUMENT_MAPPING).forEach(meta => { if (categories[meta.category]) { categories[meta.category].count++; } }); console.log(` 📘 Introduction (${categories.introduction.count} docs) - Orders ${categories.introduction.orders}`); console.log(` ⚙️ Implementation (${categories.implementation.count} docs) - Orders ${categories.implementation.orders}`); console.log(` 📊 Case Studies (${categories['case-studies'].count} docs) - Orders ${categories['case-studies'].orders}`); console.log(` 💼 Business Strategy (${categories.business.count} docs) - Orders ${categories.business.orders}`); console.log(` 🔬 Advanced Topics (${categories.advanced.count} docs) - Orders ${categories.advanced.orders}`); } catch (error) { console.error('❌ Error:', error.message); process.exit(1); } finally { await client.close(); console.log('\n✓ Database connection closed'); } } // Run reorganizeDocuments().catch(console.error);