#!/usr/bin/env node /** * Schedule Documentation Database Navigation Fix * * User request: "Option 1 now and schedule Option 2 for review this Thursday 9:00am NZ time" * * Issue: /docs.html API only returns 1 document despite 18+ migrations * Documents not appearing in sidebar (deployment-guide, etc.) */ const mongoose = require('mongoose'); const ScheduledTask = require('../src/models/ScheduledTask.model.js'); const MONGODB_URI = 'mongodb://localhost:27017/tractatus_dev'; async function addDocsDbFixTask() { console.log('Scheduling documentation database fix for Thursday 9am NZDT...'); console.log(''); try { await mongoose.connect(MONGODB_URI); // Create due date: Thursday October 30, 2025 at 9:00am NZDT // (4 days from Sunday October 26) const dueDate = new Date('2025-10-30T09:00:00+13:00'); const task = new ScheduledTask({ title: 'Fix Documentation Database Navigation', description: `Debug and fix the recurring documentation database navigation issue. **Problem:** The /docs.html sidebar repeatedly "reverts to a dogs breakfast" - documents disappear from navigation despite being migrated. **Specific Issues:** 1. /api/documents only returns 1 document (should return 18+) 2. Deployment guide not appearing in sidebar despite being in database 3. Publication/visibility status fields may be incorrect 4. Possible conflict between docs.html (card grid) and docs-viewer.html (sidebar viewer) **Root Cause Investigation:** - Check publication status filters in /api/documents route - Verify 'active' and 'published' flags on all DocumentMetadata records - Review query logic in src/routes/docs.routes.js - Test document migration scripts for status field handling **Expected Outcome:** - All 18+ migrated documents appear in /docs.html sidebar - Deployment guide accessible via /docs.html?doc=deployment-guide - Fix is permanent (no more recurring "dogs breakfast" reverts) - Document routing works consistently **Context:** This issue recurs every few days requiring 3+ hours to repair each time. Need permanent architectural fix. **Files to Review:** - src/routes/docs.routes.js (/api/documents endpoint) - src/models/DocumentMetadata.model.js (schema validation) - scripts/migrate-docs-to-db.js (migration logic) - public/docs.html vs public/docs-viewer.html (routing confusion)`, dueDate: dueDate, priority: 'HIGH', category: 'project', recurrence: 'once', assignedTo: 'PM', showInSessionInit: true, reminderDaysBefore: 1, tags: ['database', 'documentation', 'navigation', 'bugfix', 'recurring-issue'], metadata: { source: 'implementer-page-fixes-2025-10-26', complexity: 'medium', impact: 'high', issue_type: 'recurring_bug', user_frustration: 'high', time_cost_per_occurrence: '3_hours', related_files: [ 'src/routes/docs.routes.js', 'src/models/DocumentMetadata.model.js', 'scripts/migrate-docs-to-db.js' ] } }); await task.save(); console.log('✓ Task scheduled successfully!'); console.log(''); console.log('Task Details:'); console.log(` Title: ${task.title}`); console.log(` Due: Thursday, October 30, 2025 at 9:00am NZDT`); console.log(` Priority: ${task.priority}`); console.log(` Category: ${task.category} (project-specific bugfix)`); console.log(''); console.log('This task addresses:'); console.log(' • Recurring documentation navigation failures'); console.log(' • Database query filter issues'); console.log(' • Publication status field validation'); console.log(' • 3+ hours of repeated manual fixes every few days'); console.log(''); console.log('View in calendar: http://localhost:9000/admin/calendar.html'); console.log(''); await mongoose.connection.close(); process.exit(0); } catch (err) { console.error('Error scheduling task:', err.message); await mongoose.connection.close(); process.exit(1); } } addDocsDbFixTask();