mdboard 1.2.0 → 1.3.0

package/src/cli/sync.js

@@ -0,0 +1,194 @@
+/**
+ * mdboard — Consistency checker
+ *
+ * Detects dangling references and inconsistencies in the project model.
+ * With --fix, auto-corrects fixable issues.
+ *
+ * Usage:
+ *   mdboard sync          Report issues
+ *   mdboard sync --fix    Auto-fix fixable issues
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { buildModel } = require('./cli');
+const { updateMarkdownFile } = require('../core/scanner');
+
+/**
+ * Run consistency checks on the project model.
+ *
+ * @param {string} projectDir - Workspace root directory
+ * @param {{ fix?: boolean }} opts - Options
+ */
+function runSync(projectDir, opts) {
+  const fix = opts && opts.fix;
+  const { model, config, projectPath } = buildModel(projectDir);
+
+  const issues = [];
+
+  const taskIds = new Set(model.tasks.map(t => t.id));
+  const sprintIds = new Set(model.sprints.map(s => s.id));
+  const epicIds = new Set(model.epics.map(e => e.id));
+  const milestoneIds = new Set(model.milestones.map(m => m.id));
+
+  // 1. sprint.features[] references tasks that don't exist
+  for (const sprint of model.sprints) {
+    if (!sprint.features || !Array.isArray(sprint.features)) continue;
+    const missing = sprint.features.filter(f => !taskIds.has(f));
+    if (missing.length > 0) {
+      issues.push({
+        type: 'error',
+        fixable: true,
+        message: `Sprint ${sprint.id}: features[] references missing tasks: ${missing.join(', ')}`,
+        fix: () => {
+          const newFeatures = sprint.features.filter(f => taskIds.has(f));
+          updateMarkdownFile(projectPath, sprint._file, { features: newFeatures });
+        },
+      });
+    }
+  }
+
+  // 2. task.sprint references sprint that doesn't exist
+  for (const task of model.tasks) {
+    if (!task.sprint) continue;
+    if (!sprintIds.has(task.sprint)) {
+      issues.push({
+        type: 'error',
+        fixable: true,
+        message: `Task ${task.id}: sprint "${task.sprint}" does not exist`,
+        fix: () => {
+          updateMarkdownFile(projectPath, task._file, { sprint: null });
+        },
+      });
+    }
+  }
+
+  // 3. epic.dependencies[] references epics that don't exist
+  for (const epic of model.epics) {
+    if (!epic.dependencies || !Array.isArray(epic.dependencies)) continue;
+    const missing = epic.dependencies.filter(d => !epicIds.has(d));
+    if (missing.length > 0) {
+      issues.push({
+        type: 'error',
+        fixable: true,
+        message: `Epic ${epic.id}: dependencies[] references missing epics: ${missing.join(', ')}`,
+        fix: () => {
+          const newDeps = epic.dependencies.filter(d => epicIds.has(d));
+          updateMarkdownFile(projectPath, epic._file, { dependencies: newDeps });
+        },
+      });
+    }
+  }
+
+  // 4. milestone.tracks[] references milestones that don't exist
+  for (const ms of model.milestones) {
+    if (!ms.tracks || !Array.isArray(ms.tracks)) continue;
+    const missing = ms.tracks.filter(t => {
+      // tracks can reference source:MS-ID format
+      if (String(t).includes(':')) {
+        const parts = String(t).split(':');
+        const refId = parts[1];
+        return !model.milestones.some(m => m.id === t || m._originalId === refId || m.id === refId);
+      }
+      return !milestoneIds.has(t);
+    });
+    if (missing.length > 0) {
+      issues.push({
+        type: 'warning',
+        fixable: false,
+        message: `Milestone ${ms.id}: tracks[] references missing milestones: ${missing.join(', ')}`,
+      });
+    }
+  }
+
+  // 5. Duplicate IDs in the same collection
+  const collections = [
+    { name: 'tasks', items: model.tasks },
+    { name: 'milestones', items: model.milestones },
+    { name: 'epics', items: model.epics },
+    { name: 'sprints', items: model.sprints },
+  ];
+
+  for (const col of collections) {
+    const seen = new Map();
+    for (const item of col.items) {
+      if (!item.id) continue;
+      if (seen.has(item.id)) {
+        issues.push({
+          type: 'error',
+          fixable: false,
+          message: `Duplicate ${col.name.slice(0, -1)} ID "${item.id}": ${seen.get(item.id)} and ${item._file}`,
+        });
+      } else {
+        seen.set(item.id, item._file);
+      }
+    }
+  }
+
+  // 6. Tasks under epic directory without epic README.md
+  const msDir = config.entities.milestone.dir;
+  const epicDir = config.entities.epic.dir;
+  const taskDir = config.entities.task.dir;
+
+  for (const task of model.tasks) {
+    if (!task._epic || !task._milestone) continue;
+    const epicReadmePath = path.join(projectPath, msDir, task._milestone, epicDir, task._epic, 'README.md');
+    if (!fs.existsSync(epicReadmePath)) {
+      issues.push({
+        type: 'warning',
+        fixable: false,
+        message: `Task ${task.id}: parent epic directory "${task._epic}" has no README.md`,
+      });
+    }
+  }
+
+  // 7. Sprints under milestone without milestone README.md
+  for (const sprint of model.sprints) {
+    if (!sprint._milestone) continue;
+    const msReadmePath = path.join(projectPath, msDir, sprint._milestone, 'README.md');
+    if (!fs.existsSync(msReadmePath)) {
+      issues.push({
+        type: 'warning',
+        fixable: false,
+        message: `Sprint ${sprint.id}: parent milestone directory "${sprint._milestone}" has no README.md`,
+      });
+    }
+  }
+
+  // Report
+  if (issues.length === 0) {
+    console.log('\n  mdboard sync — No issues found.\n');
+    return;
+  }
+
+  const errors = issues.filter(i => i.type === 'error');
+  const warnings = issues.filter(i => i.type === 'warning');
+  const fixable = issues.filter(i => i.fixable);
+
+  console.log('');
+  for (const issue of issues) {
+    const prefix = issue.type === 'error' ? '  ERROR' : '  WARN ';
+    const suffix = issue.fixable ? ' [fixable]' : '';
+    console.log(`${prefix}: ${issue.message}${suffix}`);
+  }
+  console.log('');
+
+  if (fix && fixable.length > 0) {
+    for (const issue of fixable) {
+      issue.fix();
+    }
+    console.log(`  mdboard sync --fix — Fixed ${fixable.length} issue${fixable.length > 1 ? 's' : ''}.`);
+    if (warnings.length > 0) {
+      console.log(`  ${warnings.length} warning${warnings.length > 1 ? 's' : ''} remain (not auto-fixable).`);
+    }
+    console.log('');
+  } else {
+    console.log(`  mdboard sync — ${issues.length} issue${issues.length > 1 ? 's' : ''} (${errors.length} error${errors.length > 1 ? 's' : ''}, ${warnings.length} warning${warnings.length > 1 ? 's' : ''}).${fixable.length > 0 ? ` ${fixable.length} fixable.` : ''}`);
+    if (fixable.length > 0) {
+      console.log('  Run `mdboard sync --fix` to auto-correct.');
+    }
+    console.log('');
+  }
+}
+
+module.exports = { runSync };

package/src/cli/theme.js

@@ -0,0 +1,142 @@
+/**
+ * mdboard theme — Set or list available themes
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const THEME_IDS = [
+  'default-dark',
+  'linear-dark', 'linear-light',
+  'jira-dark', 'jira-light',
+  'catppuccin-mocha', 'catppuccin-latte',
+  'ayu-dark', 'ayu-light',
+  'tokyo-night', 'tokyo-night-storm',
+  'notion-light', 'notion-dark',
+  'github-dark', 'github-light',
+  'dracula', 'nord',
+  'solarized-dark', 'solarized-light',
+  'one-dark',
+  'gruvbox-dark',
+];
+
+const THEME_NAMES = {
+  'default-dark': 'Default Dark',
+  'linear-dark': 'Linear Dark', 'linear-light': 'Linear Light',
+  'jira-dark': 'Jira Dark', 'jira-light': 'Jira Light',
+  'catppuccin-mocha': 'Catppuccin Mocha', 'catppuccin-latte': 'Catppuccin Latte',
+  'ayu-dark': 'Ayu Dark', 'ayu-light': 'Ayu Light',
+  'tokyo-night': 'Tokyo Night', 'tokyo-night-storm': 'Tokyo Night Storm',
+  'notion-light': 'Notion Light', 'notion-dark': 'Notion Dark',
+  'github-dark': 'GitHub Dark', 'github-light': 'GitHub Light',
+  'dracula': 'Dracula', 'nord': 'Nord',
+  'solarized-dark': 'Solarized Dark', 'solarized-light': 'Solarized Light',
+  'one-dark': 'One Dark',
+  'gruvbox-dark': 'Gruvbox Dark',
+};
+
+const THEME_VARS = {
+  'default-dark': {bg:'#0A0A0B',surface:'#141415',surface2:'#1A1A1C',border:'#232326',border2:'#2E2E33',text:'#E8E8ED',text2:'#8B8B93',text3:'#5A5A63',accent:'#5B6EF5','accent-dim':'rgba(91,110,245,.15)',success:'#2EA043','success-dim':'rgba(46,160,67,.15)',warning:'#D4A72C','warning-dim':'rgba(212,167,44,.15)',danger:'#DA3633','danger-dim':'rgba(218,54,51,.15)',purple:'#8B5CF6','purple-dim':'rgba(139,92,246,.15)'},
+  'linear-dark': {bg:'#101012',surface:'#1A1A1F',surface2:'#222228',border:'#2C2C35',border2:'#38384A',text:'#E2E2E9',text2:'#8E8E9E',text3:'#5C5C6E',accent:'#5E6AD2','accent-dim':'rgba(94,106,210,.15)',success:'#4DA771','success-dim':'rgba(77,167,113,.15)',warning:'#F2C94C','warning-dim':'rgba(242,201,76,.15)',danger:'#EB5757','danger-dim':'rgba(235,87,87,.15)',purple:'#BB87FC','purple-dim':'rgba(187,135,252,.15)'},
+  'linear-light': {bg:'#F9F9FB',surface:'#FFFFFF',surface2:'#F0F0F4',border:'#E0E0E6',border2:'#D0D0D8',text:'#1A1A2E',text2:'#6B6B80',text3:'#9090A0',accent:'#5E6AD2','accent-dim':'rgba(94,106,210,.1)',success:'#4DA771','success-dim':'rgba(77,167,113,.1)',warning:'#D4A017','warning-dim':'rgba(212,160,23,.1)',danger:'#EB5757','danger-dim':'rgba(235,87,87,.1)',purple:'#9B6DD7','purple-dim':'rgba(155,109,215,.1)'},
+  'jira-dark': {bg:'#0D1117',surface:'#161B22',surface2:'#1C2333',border:'#293040',border2:'#344050',text:'#DEE4EC',text2:'#8C96A5',text3:'#5A6577',accent:'#2684FF','accent-dim':'rgba(38,132,255,.15)',success:'#36B37E','success-dim':'rgba(54,179,126,.15)',warning:'#FFAB00','warning-dim':'rgba(255,171,0,.15)',danger:'#FF5630','danger-dim':'rgba(255,86,48,.15)',purple:'#6554C0','purple-dim':'rgba(101,84,192,.15)'},
+  'jira-light': {bg:'#F4F5F7',surface:'#FFFFFF',surface2:'#EBECF0',border:'#DFE1E6',border2:'#C1C7D0',text:'#172B4D',text2:'#6B778C',text3:'#97A0AF',accent:'#0052CC','accent-dim':'rgba(0,82,204,.1)',success:'#36B37E','success-dim':'rgba(54,179,126,.1)',warning:'#FF991F','warning-dim':'rgba(255,153,31,.1)',danger:'#FF5630','danger-dim':'rgba(255,86,48,.1)',purple:'#6554C0','purple-dim':'rgba(101,84,192,.1)'},
+  'catppuccin-mocha': {bg:'#1E1E2E',surface:'#262637',surface2:'#313244',border:'#3B3B52',border2:'#45475A',text:'#CDD6F4',text2:'#A6ADC8',text3:'#6C7086',accent:'#89B4FA','accent-dim':'rgba(137,180,250,.15)',success:'#A6E3A1','success-dim':'rgba(166,227,161,.15)',warning:'#F9E2AF','warning-dim':'rgba(249,226,175,.15)',danger:'#F38BA8','danger-dim':'rgba(243,139,168,.15)',purple:'#CBA6F7','purple-dim':'rgba(203,166,247,.15)'},
+  'catppuccin-latte': {bg:'#EFF1F5',surface:'#FFFFFF',surface2:'#E6E9EF',border:'#CCD0DA',border2:'#BCC0CC',text:'#4C4F69',text2:'#6C6F85',text3:'#9CA0B0',accent:'#1E66F5','accent-dim':'rgba(30,102,245,.1)',success:'#40A02B','success-dim':'rgba(64,160,43,.1)',warning:'#DF8E1D','warning-dim':'rgba(223,142,29,.1)',danger:'#D20F39','danger-dim':'rgba(210,15,57,.1)',purple:'#8839EF','purple-dim':'rgba(136,57,239,.1)'},
+  'ayu-dark': {bg:'#0B0E14',surface:'#0F1219',surface2:'#151920',border:'#1E222A',border2:'#272D38',text:'#BFBDB6',text2:'#6C7380',text3:'#4A5060',accent:'#E6B450','accent-dim':'rgba(230,180,80,.15)',success:'#7FD962','success-dim':'rgba(127,217,98,.15)',warning:'#FFB454','warning-dim':'rgba(255,180,84,.15)',danger:'#F07178','danger-dim':'rgba(240,113,120,.15)',purple:'#D2A6FF','purple-dim':'rgba(210,166,255,.15)'},
+  'ayu-light': {bg:'#F8F9FA',surface:'#FFFFFF',surface2:'#F0F1F2',border:'#E0E1E2',border2:'#D4D5D6',text:'#5C6166',text2:'#787B80',text3:'#ACB0B5',accent:'#FF9940','accent-dim':'rgba(255,153,64,.1)',success:'#6CBF43','success-dim':'rgba(108,191,67,.1)',warning:'#F2AE49','warning-dim':'rgba(242,174,73,.1)',danger:'#F07171','danger-dim':'rgba(240,113,113,.1)',purple:'#A37ACC','purple-dim':'rgba(163,122,204,.1)'},
+  'tokyo-night': {bg:'#1A1B26',surface:'#1F2335',surface2:'#24283B',border:'#2F3449',border2:'#3B4261',text:'#C0CAF5',text2:'#7982A9',text3:'#565F89',accent:'#7AA2F7','accent-dim':'rgba(122,162,247,.15)',success:'#9ECE6A','success-dim':'rgba(158,206,106,.15)',warning:'#E0AF68','warning-dim':'rgba(224,175,104,.15)',danger:'#F7768E','danger-dim':'rgba(247,118,142,.15)',purple:'#BB9AF7','purple-dim':'rgba(187,154,247,.15)'},
+  'tokyo-night-storm': {bg:'#24283B',surface:'#292E42',surface2:'#2F3549',border:'#3B4261',border2:'#464F78',text:'#C0CAF5',text2:'#7982A9',text3:'#565F89',accent:'#7AA2F7','accent-dim':'rgba(122,162,247,.15)',success:'#9ECE6A','success-dim':'rgba(158,206,106,.15)',warning:'#E0AF68','warning-dim':'rgba(224,175,104,.15)',danger:'#F7768E','danger-dim':'rgba(247,118,142,.15)',purple:'#BB9AF7','purple-dim':'rgba(187,154,247,.15)'},
+  'notion-light': {bg:'#F7F6F3',surface:'#FFFFFF',surface2:'#EEEEEC',border:'#E3E2DE',border2:'#D4D3CF',text:'#37352F',text2:'#6B6B6B',text3:'#9B9A97',accent:'#2383E2','accent-dim':'rgba(35,131,226,.1)',success:'#0F7B0F','success-dim':'rgba(15,123,15,.1)',warning:'#CB7B00','warning-dim':'rgba(203,123,0,.1)',danger:'#E03E3E','danger-dim':'rgba(224,62,62,.1)',purple:'#6940A5','purple-dim':'rgba(105,64,165,.1)'},
+  'notion-dark': {bg:'#191919',surface:'#202020',surface2:'#2B2B2B',border:'#363636',border2:'#444444',text:'#E3E2DE',text2:'#9B9B9B',text3:'#6B6B6B',accent:'#529CCA','accent-dim':'rgba(82,156,202,.15)',success:'#4DAB9A','success-dim':'rgba(77,171,154,.15)',warning:'#CB7B00','warning-dim':'rgba(203,123,0,.15)',danger:'#E03E3E','danger-dim':'rgba(224,62,62,.15)',purple:'#9A6DD7','purple-dim':'rgba(154,109,215,.15)'},
+  'github-dark': {bg:'#0D1117',surface:'#161B22',surface2:'#1C2128',border:'#30363D',border2:'#3D444D',text:'#E6EDF3',text2:'#8B949E',text3:'#6E7681',accent:'#58A6FF','accent-dim':'rgba(88,166,255,.15)',success:'#3FB950','success-dim':'rgba(63,185,80,.15)',warning:'#D29922','warning-dim':'rgba(210,153,34,.15)',danger:'#F85149','danger-dim':'rgba(248,81,73,.15)',purple:'#BC8CFF','purple-dim':'rgba(188,140,255,.15)'},
+  'github-light': {bg:'#F6F8FA',surface:'#FFFFFF',surface2:'#EAEEF2',border:'#D0D7DE',border2:'#BCC3CB',text:'#1F2328',text2:'#656D76',text3:'#8C959F',accent:'#0969DA','accent-dim':'rgba(9,105,218,.1)',success:'#1A7F37','success-dim':'rgba(26,127,55,.1)',warning:'#9A6700','warning-dim':'rgba(154,103,0,.1)',danger:'#CF222E','danger-dim':'rgba(207,34,46,.1)',purple:'#8250DF','purple-dim':'rgba(130,80,223,.1)'},
+  'dracula': {bg:'#1E1F29',surface:'#282A36',surface2:'#2E303E',border:'#3A3C4E',border2:'#44475A',text:'#F8F8F2',text2:'#ADB0C0',text3:'#6272A4',accent:'#BD93F9','accent-dim':'rgba(189,147,249,.15)',success:'#50FA7B','success-dim':'rgba(80,250,123,.15)',warning:'#F1FA8C','warning-dim':'rgba(241,250,140,.15)',danger:'#FF5555','danger-dim':'rgba(255,85,85,.15)',purple:'#FF79C6','purple-dim':'rgba(255,121,198,.15)'},
+  'nord': {bg:'#242933',surface:'#2E3440',surface2:'#353C4A',border:'#3B4252',border2:'#434C5E',text:'#ECEFF4',text2:'#A5B1C2',text3:'#697688',accent:'#88C0D0','accent-dim':'rgba(136,192,208,.15)',success:'#A3BE8C','success-dim':'rgba(163,190,140,.15)',warning:'#EBCB8B','warning-dim':'rgba(235,203,139,.15)',danger:'#BF616A','danger-dim':'rgba(191,97,106,.15)',purple:'#B48EAD','purple-dim':'rgba(180,142,173,.15)'},
+  'solarized-dark': {bg:'#002129',surface:'#002B36',surface2:'#073642',border:'#0A4050',border2:'#1A5060',text:'#93A1A1',text2:'#839496',text3:'#586E75',accent:'#268BD2','accent-dim':'rgba(38,139,210,.15)',success:'#859900','success-dim':'rgba(133,153,0,.15)',warning:'#B58900','warning-dim':'rgba(181,137,0,.15)',danger:'#DC322F','danger-dim':'rgba(220,50,47,.15)',purple:'#6C71C4','purple-dim':'rgba(108,113,196,.15)'},
+  'solarized-light': {bg:'#FDF6E3',surface:'#FFFFFF',surface2:'#EEE8D5',border:'#DDD6C1',border2:'#C9C2AD',text:'#586E75',text2:'#657B83',text3:'#93A1A1',accent:'#268BD2','accent-dim':'rgba(38,139,210,.1)',success:'#859900','success-dim':'rgba(133,153,0,.1)',warning:'#B58900','warning-dim':'rgba(181,137,0,.1)',danger:'#DC322F','danger-dim':'rgba(220,50,47,.1)',purple:'#6C71C4','purple-dim':'rgba(108,113,196,.1)'},
+  'one-dark': {bg:'#1E2127',surface:'#282C34',surface2:'#2C313C',border:'#3A3F4B',border2:'#4B5263',text:'#ABB2BF',text2:'#7F848E',text3:'#5C6370',accent:'#61AFEF','accent-dim':'rgba(97,175,239,.15)',success:'#98C379','success-dim':'rgba(152,195,121,.15)',warning:'#E5C07B','warning-dim':'rgba(229,192,123,.15)',danger:'#E06C75','danger-dim':'rgba(224,108,117,.15)',purple:'#C678DD','purple-dim':'rgba(198,120,221,.15)'},
+  'gruvbox-dark': {bg:'#1D2021',surface:'#282828',surface2:'#32302F',border:'#3C3836',border2:'#504945',text:'#EBDBB2',text2:'#A89984',text3:'#7C6F64',accent:'#FE8019','accent-dim':'rgba(254,128,25,.15)',success:'#B8BB26','success-dim':'rgba(184,187,38,.15)',warning:'#FABD2F','warning-dim':'rgba(250,189,47,.15)',danger:'#FB4934','danger-dim':'rgba(251,73,52,.15)',purple:'#D3869B','purple-dim':'rgba(211,134,155,.15)'},
+};
+
+function generateThemeCss(themeId) {
+  const vars = THEME_VARS[themeId];
+  if (!vars) return '';
+  const name = THEME_NAMES[themeId] || themeId;
+  let css = '/* mdboard theme: ' + name + ' */\n:root {\n';
+  for (const key in vars) {
+    if (vars.hasOwnProperty(key)) {
+      css += '  --' + key + ': ' + vars[key] + ';\n';
+    }
+  }
+  css += '}\n';
+  return css;
+}
+
+function handleTheme(args) {
+  const themeName = args.filter(a => !a.startsWith('--'))[0];
+  const isProject = args.includes('--project');
+
+  if (!themeName) {
+    listThemes();
+    return;
+  }
+
+  if (!THEME_IDS.includes(themeName)) {
+    console.error('\n  Error: Unknown theme "' + themeName + '"');
+    console.log('  Run "mdboard theme" to see available themes.\n');
+    process.exit(1);
+  }
+
+  const configPath = isProject
+    ? path.join(process.cwd(), 'project', 'mdboard.json')
+    : path.join(os.homedir(), '.config', 'mdboard', 'mdboard.json');
+
+  const dir = path.dirname(configPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+
+  let config = {};
+  try {
+    config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+  } catch {
+    // file doesn't exist or is invalid, start fresh
+  }
+
+  config.theme = themeName;
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+
+  // Also write CSS file
+  const css = generateThemeCss(themeName);
+  const cssPath = isProject
+    ? path.join(process.cwd(), 'project', 'mdboard.css')
+    : path.join(os.homedir(), '.config', 'mdboard', 'mdboard.css');
+  fs.writeFileSync(cssPath, css, 'utf-8');
+
+  const scope = isProject ? 'project' : 'global';
+  console.log('\n  Theme set to "' + THEME_NAMES[themeName] + '" (' + scope + ')');
+  console.log('  Config: ' + configPath);
+  console.log('  CSS:    ' + cssPath + '\n');
+}
+
+function listThemes() {
+  const dark = THEME_IDS.filter(id => id.includes('dark') || ['catppuccin-mocha', 'tokyo-night', 'tokyo-night-storm', 'dracula', 'nord', 'one-dark', 'gruvbox-dark'].includes(id));
+  const light = THEME_IDS.filter(id => !dark.includes(id));
+
+  console.log('\n  Available themes:\n');
+  console.log('  Dark:');
+  dark.forEach(function(id) {
+    console.log('    ' + id.padEnd(24) + THEME_NAMES[id]);
+  });
+  console.log('\n  Light:');
+  light.forEach(function(id) {
+    console.log('    ' + id.padEnd(24) + THEME_NAMES[id]);
+  });
+  console.log('\n  Usage:');
+  console.log('    mdboard theme <name>             Set theme globally');
+  console.log('    mdboard theme <name> --project    Set theme for current project\n');
+}
+
+module.exports = { handleTheme };

package/src/client/app.js

@@ -0,0 +1,266 @@
+/* ══════════════════════════════════════════════════════════════
+   RENDER
+   ══════════════════════════════════════════════════════════════ */
+function renderAll() {
+  renderHeader(); renderBoardFilters(); renderBoard(); renderTableControls(); renderTableBody(); renderMsFilters(); renderMilestones(); renderMetrics();
+  // Render overview if active
+  var overviewView = document.getElementById('view-overview');
+  if (overviewView && overviewView.classList.contains('active')) {
+    renderOverview();
+  }
+}
+
+function renderHeader() {
+  renderSidebarLogo();
+
+  var mw = document.getElementById('h-milestone-wrap');
+  var am = D.milestones.find(function(m) { return m.status === 'active'; });
+  if (am) {
+    mw.style.display = '';
+    document.getElementById('h-milestone-name').textContent = am.title || am.id || '';
+    document.getElementById('h-milestone-progress').style.width = (am.progress || 0) + '%';
+  } else { mw.style.display = 'none'; }
+
+  var sw = document.getElementById('h-sprint-wrap');
+  var as = D.sprints.find(function(s) { return s.status === 'active'; });
+  if (as) {
+    sw.style.display = '';
+    document.getElementById('h-sprint-name').textContent = as.goal || as.id || '';
+    var dr = daysRemaining(as.end_date);
+    document.getElementById('h-sprint-days').textContent = dr !== null ? (dr >= 0 ? dr + ' days left' : Math.abs(dr) + ' days over') : '';
+  } else { sw.style.display = 'none'; }
+
+  var taskPlural = ENTITY_NAMES.task ? ENTITY_NAMES.task.plural : 'Tasks';
+  var total = D.tasks.length;
+  var done = D.tasks.filter(function(f) { return f.status === COMPLETED_STATUS; }).length;
+  var inProgStatus = (D.config && D.config.statuses && D.config.statuses.task) ?
+    ((D.config.statuses.task.find(function(s) { return s.icon === 'half-circle'; }) || {}).key || 'in-progress') : 'in-progress';
+  var inProg = D.tasks.filter(function(f) { return f.status === inProgStatus; }).length;
+  var vel = D.health && D.health.velocity != null ? D.health.velocity : (total ? Math.round(done / total * 100) : 0);
+  document.getElementById('h-stats').innerHTML =
+    '<div class="stat"><span class="stat-val">' + total + '</span><span class="stat-label">' + escHtml(taskPlural) + '</span></div>' +
+    '<div class="stat"><span class="stat-val" style="color:var(--success)">' + done + '</span><span class="stat-label">Done</span></div>' +
+    '<div class="stat"><span class="stat-val" style="color:var(--warning)">' + inProg + '</span><span class="stat-label">In Progress</span></div>' +
+    '<div class="stat"><span class="stat-val" style="color:var(--accent)">' + vel + '%</span><span class="stat-label">Velocity</span></div>';
+}
+
+/* ══════════════════════════════════════════════════════════════
+   NAVIGATION
+   ══════════════════════════════════════════════════════════════ */
+function switchView(name) {
+  document.querySelectorAll('.view').forEach(function(v) { v.classList.remove('active'); });
+  document.querySelectorAll('#sidebar-nav a[data-view]').forEach(function(a) { a.classList.remove('active'); });
+  var t = document.getElementById('view-' + name);
+  if (t) t.classList.add('active');
+  var l = document.querySelector('#sidebar-nav a[data-view="' + name + '"]');
+  if (l) l.classList.add('active');
+  // Persist view selection
+  try { localStorage.setItem('mdboard-view', name); } catch(e) {}
+  // Trigger overview rendering when switching to it
+  if (name === 'overview' && D.loaded) {
+    renderOverview();
+  }
+  // Trigger notes rendering when switching to it
+  if (name === 'notes' && D.loaded) {
+    renderNotes();
+  }
+}
+
+document.getElementById('sidebar-nav').addEventListener('click', function(e) {
+  var a = e.target.closest('a[data-view]');
+  if (!a) return;
+  e.preventDefault();
+  switchView(a.dataset.view);
+  window.location.hash = a.dataset.view;
+});
+
+function handleHash() {
+  var hash = window.location.hash.replace('#', '');
+  if (!hash) {
+    try { hash = localStorage.getItem('mdboard-view') || ''; } catch(e) {}
+  }
+  hash = hash || 'board';
+  var valid = ['board','table','milestones','metrics','overview','notes'];
+  switchView(valid.indexOf(hash) !== -1 ? hash : 'board');
+}
+window.addEventListener('hashchange', handleHash);
+
+/* ══════════════════════════════════════════════════════════════
+   SETTINGS PANEL
+   ══════════════════════════════════════════════════════════════ */
+var _settingsState = { selectedTheme: null, originalTheme: null };
+
+function openSettings() {
+  var active = getActiveTheme();
+  _settingsState.originalTheme = active;
+  _settingsState.selectedTheme = null;
+  document.getElementById('settings-overlay').classList.add('open');
+  document.getElementById('settings-panel').classList.add('open');
+  var toggle = document.getElementById('theme-default-toggle');
+  if (toggle) toggle.checked = false;
+  renderThemeGrid();
+}
+
+function closeSettings() {
+  if (_settingsState.selectedTheme) {
+    revertThemePreview();
+    _settingsState.selectedTheme = null;
+  }
+  document.getElementById('settings-overlay').classList.remove('open');
+  document.getElementById('settings-panel').classList.remove('open');
+}
+
+function renderThemeGrid() {
+  var grid = document.getElementById('theme-grid');
+  var info = document.getElementById('settings-theme-info');
+  var active = getActiveTheme();
+  var selected = _settingsState.selectedTheme;
+
+  if (info) {
+    var displayId = selected || active;
+    var displayTheme = THEMES[displayId];
+    info.textContent = 'Active: ' + (THEMES[active] ? THEMES[active].name : active) +
+      (selected && selected !== active ? ' → Preview: ' + (displayTheme ? displayTheme.name : selected) : '');
+  }
+
+  var html = '';
+  THEME_LIST.forEach(function(t) {
+    var theme = THEMES[t.id];
+    var v = theme.vars;
+    var isSelected = selected ? t.id === selected : t.id === active;
+    var cls = isSelected ? ' active' : '';
+    html += '<div class="theme-card' + cls + '" data-theme="' + t.id + '">' +
+      '<div class="theme-card-preview">' +
+        '<span style="background:' + v.bg + '"></span>' +
+        '<span style="background:' + v.surface + '"></span>' +
+        '<span style="background:' + v.accent + '"></span>' +
+        '<span style="background:' + v.success + '"></span>' +
+        '<span style="background:' + v.warning + '"></span>' +
+      '</div>' +
+      '<div class="theme-card-name">' + escHtml(theme.name) + '</div>' +
+      '<div class="theme-card-type">' + theme.type + '</div>' +
+    '</div>';
+  });
+  grid.innerHTML = html;
+}
+
+function saveTheme() {
+  var themeId = _settingsState.selectedTheme;
+  if (!themeId) {
+    closeSettings();
+    return;
+  }
+  var toggle = document.getElementById('theme-default-toggle');
+  var setDefault = toggle ? toggle.checked : false;
+  var css = generateThemeCss(themeId);
+
+  fetch('/api/theme', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ themeId: themeId, css: css, setDefault: setDefault })
+  }).then(function(r) { return r.json(); }).then(function(data) {
+    if (data && data.ok) {
+      revertThemePreview();
+      reloadCustomCss();
+      D.config.theme = themeId;
+      _settingsState.selectedTheme = null;
+      showToast('Theme saved: ' + (THEMES[themeId] ? THEMES[themeId].name : themeId), 'success');
+      closeSettings();
+    } else {
+      showToast('Error: ' + (data.error || 'Unknown'), 'error');
+    }
+  }).catch(function(e) {
+    showToast('Error: ' + e.message, 'error');
+  });
+}
+
+document.getElementById('settings-toggle').addEventListener('click', function(e) {
+  e.preventDefault();
+  openSettings();
+});
+
+document.getElementById('settings-close').addEventListener('click', closeSettings);
+document.getElementById('settings-overlay').addEventListener('click', closeSettings);
+
+document.getElementById('theme-grid').addEventListener('click', function(e) {
+  var card = e.target.closest('.theme-card');
+  if (!card) return;
+  var themeId = card.dataset.theme;
+  _settingsState.selectedTheme = themeId;
+  applyTheme(themeId);
+  renderThemeGrid();
+});
+
+document.getElementById('settings-save').addEventListener('click', saveTheme);
+
+/* ══════════════════════════════════════════════════════════════
+   INIT
+   ══════════════════════════════════════════════════════════════ */
+(async function() {
+  handleHash();
+  await loadAll();
+  initFromConfig();
+
+  // Sidebar logo always shows project name
+  renderSidebarLogo();
+
+  // Workspace detection: build source rail + restore last source
+  if (hasWorkspace()) {
+    // Create overview tab (hidden by default)
+    var overviewTab = document.querySelector('#sidebar-nav a[data-view="overview"]');
+    if (!overviewTab) {
+      var nav = document.getElementById('sidebar-nav');
+      var metricsLink = document.querySelector('#sidebar-nav a[data-view="metrics"]');
+      var overviewLink = document.createElement('a');
+      overviewLink.href = '#overview';
+      overviewLink.dataset.view = 'overview';
+      overviewLink.style.display = 'none';
+      overviewLink.innerHTML = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5"><circle cx="12" cy="12" r="9"/><path d="M12 3v18M3 12h18"/></svg><span>Overview</span>';
+      if (metricsLink && metricsLink.nextSibling) {
+        nav.insertBefore(overviewLink, metricsLink.nextSibling);
+      } else {
+        nav.appendChild(overviewLink);
+      }
+    }
+
+    // Restore last source or default to overview
+    var savedSource = null;
+    try { savedSource = localStorage.getItem('mdboard-source'); } catch(e) {}
+    var validSource = savedSource && (savedSource === 'overview' || D.config.workspace.sources.some(function(s) { return s.name === savedSource; }));
+    var initialSource = validSource ? savedSource : 'overview';
+
+    buildSourceRail();
+    // switchSource skips if same as current, so set activeSource first then trigger
+    D.activeSource = null;
+    switchSource(initialSource);
+    // Wait for switchSource data reload before continuing
+    await loadAll();
+    initFromConfig();
+  }
+
+  renderAll();
+  connectSSE();
+
+  // Auto-open history modal if no project
+  checkAutoOpenHistory();
+
+  // Keyboard shortcut: Ctrl/Cmd+K to open history modal
+  document.addEventListener('keydown', function(e) {
+    if ((e.metaKey || e.ctrlKey) && e.key === 'k') {
+      e.preventDefault();
+      openHistoryModal();
+    }
+  });
+
+  // Load AI suggestions for autocomplete
+  fetchJson('/api/ai-suggestions').then(function(data) {
+    D.aiSuggestions = data || { skills: [], agents: [], mcps: [], commands: [], context: [] };
+  });
+
+  // Load overview links in background for reverse link display
+  if (hasWorkspace()) {
+    fetchJson('/api/overview/links').then(function(data) {
+      D.overviewLinks = data;
+    });
+  }
+})();