VitePress Sidebar Update - 2026-01-10

Problem

Documentation files in /docs/features subdirectories (frens, safety) were not appearing in the VitePress sidebar on docs.dev.ourlantern.app despite being present in the codebase. Additionally, many governance documents were missing from the sidebar.

Root Cause

The VitePress configuration file (docs/.vitepress/config.mjs) did not include sidebar entries for:

• Frens feature subdirectory (4 markdown files)
• Safety feature subdirectory (2 markdown files)
• 10+ Governance documents (FOUNDATIONAL_PHILOSOPHY, GOVERNANCE_QUICK_REFERENCE, etc.)
• Worklog development history (8 markdown files)

Solution

Updated docs/.vitepress/config.mjs to add missing sidebar sections with proper organization:

Added Sections

1. 🛡️ Safety Mechanics (new section)

   • Quick Start (/features/safety/SAFETY_QUICK_START)
   • Safety Mechanics Overview (/features/safety/SAFETY_MECHANICS)

2. 👥 Frens System (new section)

   • Quick Reference (/features/frens/FRENS_QUICK_REF)
   • Frens System Overview (/features/frens/FRENS_SYSTEM)
   • Implementation Summary (/features/frens/IMPLEMENTATION_SUMMARY)
   • User Flow Integration (/features/frens/USER_FLOW_INTEGRATION)

3. Expanded Governance subsection (reorganized)

   • Quick Reference
   • Governance Overview
   • Foundational Philosophy
   • Immutable Rights
   • Employee Rights Charter
   • Shareholder-Lender Framework
   • Decision-Making Authority
   • Anti-Greed Safeguards
   • Hiring Policy
   • Contractor Pathway
   • Legal Compliance
   • Complete Summary
   • Implementation Summary

4. Separated Security subsection (reorganized)

   • User Security Guide
   • Security Policy
   • Vulnerability Disclosure
   • Incident Response
   • Security Runbooks
   • Security Onboarding

5. 📝 Development Log (new section, collapsed by default)

   • Wave Integration Complete
   • Phase 1 Complete
   • Implementation Summary
   • Location Spoof Bug (2025-01-05)
   • Bug Fixes - Iteration 2
   • Bug Fixes - Lantern Flows
   • Setup Complete
   • Prompts for Bugs

Verification

• ✅ VitePress build completes successfully (npm run docs:build)
• ✅ VitePress dev server starts without errors (npm run docs:dev)
• ✅ JavaScript syntax validation passes
• ✅ All links point to existing markdown files

Files Modified

• docs/.vitepress/config.mjs - Added 4 new sections and reorganized 1 existing section

Next Steps

After deployment to docs.dev.ourlantern.app:

1. Verify all new sections appear in the sidebar
2. Test navigation to each newly added document
3. Confirm search functionality includes new documents
4. Consider adding index pages for major sections if needed

Related Documentation

• VitePress configuration: docs/.vitepress/config.mjs
• Docs deployment guide: docs/engineering/deployment/DOCS_DEPLOYMENT.md
• All feature docs: docs/features/
• Governance docs: docs/governance/
• Development logs: docs/worklog/