Function createDataSource

scripts/dashboard-server.js:80–147

(projectRoot)

      options.projectRoot = path.resolve(argv[++i]);
    } else if (arg === '--open') {
      options.open = true;
    } else if (arg === '--help' || arg === '-h') {
      options.help = true;
    }
  }
  return options;
}

function usage() {
  return [
    'Usage: node scripts/dashboard-server.js [--port 4180] [--project-root <path>] [--open]',
    '',
    'Serves local Mission Control over canonical .planning/ state.',
    'Binds to 127.0.0.1 only. See docs/DASHBOARD_SPEC.md.',
  ].join('\n');
}

// ---------------------------------------------------------------------------
// Data collection (cached, invalidated by watcher or TTL)
// ---------------------------------------------------------------------------

function createDataSource(projectRoot) {
  const state = { cache: null, collectedAt: 0, dirty: true };

  function readHandoffs() {
    const dir = path.join(projectRoot, '.planning', 'handoffs');
    try {
      if (!fs.existsSync(dir)) return [];
      return fs.readdirSync(dir)
        .filter((name) => name.endsWith('.md'))
        .filter((name) => {
          try {
            const stat = fs.lstatSync(path.join(dir, name));
            return stat.isFile() && !stat.isSymbolicLink();
          } catch { return false; }
        })
        .sort((a, b) => b.localeCompare(a))
        .slice(0, 50)
        .map((name) => {
          const filePath = path.join(dir, name);
          let modifiedAt = null;
          try { modifiedAt = fs.statSync(filePath).mtime.toISOString(); } catch { /* render as unknown */ }
          return { name, path: `.planning/handoffs/${name}`, modifiedAt };
        })
        .sort((a, b) => String(b.modifiedAt).localeCompare(String(a.modifiedAt)) || b.name.localeCompare(a.name));
    } catch {
      return [];
    }
  }

  function readDaemon() {
    try {
      const raw = fs.readFileSync(path.join(projectRoot, '.planning', 'daemon.json'), 'utf8');
      return JSON.parse(raw);
    } catch {
      return null;
    }
  }