mdboard 1.0.0 → 1.2.0

package/bin.js

@@ -1,6 +1,18 @@
 #!/usr/bin/env node
 
+const path = require('path');
 const args = process.argv.slice(2);
+
+// Pre-process --config and --workspace flags before dispatching commands
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--config' && args[i + 1]) {
+    process.env.MDBOARD_CONFIG = path.resolve(args[i + 1]);
+  }
+  if (args[i] === '--workspace' && args[i + 1]) {
+    process.env.MDBOARD_WORKSPACE = path.resolve(args[i + 1]);
+  }
+}
+
 const command = args[0];
 
 if (command === '--version' || command === '-v') {
@@ -19,11 +31,45 @@ if (command === 'init') {
 } else if (command === 'help') {
   printHelp();
   process.exit(0);
+} else if (command === 'cache') {
+  handleCache();
 } else {
   // Default: start server. Pass all args through.
   require('./server.js');
 }
 
+function handleCache() {
+  const subCmd = args[1];
+  const { listCache, cleanCache, CACHE_DIR } = require('./workspace');
+
+  if (subCmd === 'list') {
+    const entries = listCache();
+    if (entries.length === 0) {
+      console.log('\n  No cached remote repos.\n  Cache dir: ' + CACHE_DIR + '\n');
+    } else {
+      console.log('\n  Cached remote repos (' + CACHE_DIR + '):\n');
+      entries.forEach(function(e) { console.log('    ' + e); });
+      console.log('');
+    }
+  } else if (subCmd === 'clean') {
+    const ok = cleanCache();
+    if (ok) {
+      console.log('\n  Cache cleaned successfully.\n');
+    } else {
+      console.log('\n  No cache to clean or error occurred.\n');
+    }
+  } else {
+    console.log(`
+  mdboard cache — Manage remote source cache
+
+  Subcommands:
+    mdboard cache list       List cached remote repos
+    mdboard cache clean      Remove all cached repos
+`);
+  }
+  process.exit(0);
+}
+
 function printHelp() {
   console.log(`
   mdboard — Git-based project management dashboard
@@ -31,16 +77,26 @@ function printHelp() {
   Usage:
     mdboard                    Start the dashboard server
     mdboard init               Scaffold a new project/ directory
+    mdboard cache list|clean   Manage remote source cache
     mdboard --version          Print version
     mdboard --help             Show this help
 
   Server options:
     --project <path>           Workspace root directory (default: cwd)
     --port <number>            Server port (default: 3333)
+    --config <path>            Path to mdboard.json config file
+    --workspace <path>         Path to workspace.json
+
+  Multi-repo workspace:
+    Create a workspace.json in your project root to manage
+    multiple repositories from a single dashboard.
 
   Examples:
     npx mdboard                Start dashboard in current directory
     npx mdboard init           Create project/ with templates
     npx mdboard --port 4000    Start on port 4000
+    npx mdboard --workspace ./workspace.json
+    npx mdboard cache list     Show cached remote repos
+    npx mdboard cache clean    Clear remote cache
 `);
 }

package/config.js

@@ -0,0 +1,73 @@
+/**
+ * mdboard — Configuration loader
+ *
+ * Resolution order (highest priority first):
+ *   1. Explicit path via --config / MDBOARD_CONFIG
+ *   2. <projectDir>/project/mdboard.json  (per-project)
+ *   3. <projectDir>/mdboard.json          (workspace)
+ *   4. ~/.config/mdboard/mdboard.json     (global)
+ *   5. defaults.json                      (built-in)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const defaults = require('./defaults.json');
+
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key of Object.keys(source)) {
+    const sv = source[key];
+    const tv = target[key];
+    if (sv && typeof sv === 'object' && !Array.isArray(sv) && tv && typeof tv === 'object' && !Array.isArray(tv)) {
+      result[key] = deepMerge(tv, sv);
+    } else {
+      result[key] = sv;
+    }
+  }
+  return result;
+}
+
+function tryReadJson(filePath) {
+  try {
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+function loadConfig(projectDir, explicitPath) {
+  const candidates = [];
+
+  if (explicitPath) {
+    candidates.push(path.resolve(explicitPath));
+  }
+
+  if (projectDir) {
+    candidates.push(path.join(projectDir, 'project', 'mdboard.json'));
+    candidates.push(path.join(projectDir, 'mdboard.json'));
+  }
+
+  const globalPath = path.join(os.homedir(), '.config', 'mdboard', 'mdboard.json');
+  candidates.push(globalPath);
+
+  let userConfig = null;
+  let configPath = null;
+
+  for (const p of candidates) {
+    const data = tryReadJson(p);
+    if (data) {
+      userConfig = data;
+      configPath = p;
+      break;
+    }
+  }
+
+  const config = userConfig ? deepMerge(defaults, userConfig) : { ...defaults };
+  config._path = configPath;
+  return config;
+}
+
+module.exports = { loadConfig, deepMerge };

package/defaults.json

@@ -0,0 +1,43 @@
+{
+  "entities": {
+    "milestone": { "singular": "Milestone", "plural": "Milestones", "dir": "milestones" },
+    "epic":      { "singular": "Epic", "plural": "Epics", "dir": "epics" },
+    "task":      { "singular": "Task", "plural": "Tasks", "dir": "backlog", "prefix": "TASK", "legacyPrefixes": ["FEAT"] },
+    "sprint":    { "singular": "Sprint", "plural": "Sprints", "dir": "sprints" }
+  },
+  "statuses": {
+    "task": [
+      { "key": "backlog",     "label": "Backlog",     "color": "#5A5A63", "icon": "dashed-circle" },
+      { "key": "todo",        "label": "Todo",        "color": "#8B8B93", "icon": "circle" },
+      { "key": "in-progress", "label": "In Progress", "color": "#D4A72C", "icon": "half-circle" },
+      { "key": "in-review",   "label": "In Review",   "color": "#8B5CF6", "icon": "three-quarter-circle" },
+      { "key": "done",        "label": "Done",        "color": "#2EA043", "icon": "check-circle" },
+      { "key": "blocked",     "label": "Blocked",     "color": "#DA3633", "icon": "x-circle" },
+      { "key": "cancelled",   "label": "Cancelled",   "color": "#5A5A63", "icon": "slash-circle" }
+    ],
+    "milestone": [
+      { "key": "planned",   "label": "Planned",   "color": "#8B8B93" },
+      { "key": "active",    "label": "Active",    "color": "#5B6EF5" },
+      { "key": "completed", "label": "Completed", "color": "#2EA043" }
+    ],
+    "epic": [
+      { "key": "active",    "label": "Active",    "color": "#5B6EF5" },
+      { "key": "completed", "label": "Completed", "color": "#2EA043" },
+      { "key": "blocked",   "label": "Blocked",   "color": "#DA3633" }
+    ],
+    "sprint": [
+      { "key": "planned",   "label": "Planned",   "color": "#8B8B93" },
+      { "key": "active",    "label": "Active",    "color": "#5B6EF5" },
+      { "key": "completed", "label": "Completed", "color": "#2EA043" },
+      { "key": "cancelled", "label": "Cancelled", "color": "#DA3633" }
+    ]
+  },
+  "boardColumns": ["backlog", "todo", "in-progress", "in-review", "done"],
+  "priorities": [
+    { "key": "urgent", "label": "Urgent", "color": "#F97316", "bars": 4 },
+    { "key": "high",   "label": "High",   "color": "#F97316", "bars": 3 },
+    { "key": "medium", "label": "Medium", "color": "#D4A72C", "bars": 2 },
+    { "key": "low",    "label": "Low",    "color": "#5B6EF5", "bars": 1 }
+  ],
+  "completedStatus": "done"
+}