#!/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);