mdboard 1.3.0 → 2.0.0

package/bin.js

@@ -1,9 +1,18 @@
 #!/usr/bin/env node
 
+/**
+ * mdboard — CLI entry point
+ *
+ * All commands, entity types, and flags are resolved dynamically from config.
+ * The only hardcoded commands are structural: init, help, version, cache, theme, server.
+ */
+
+'use strict';
+
 const path = require('path');
 const args = process.argv.slice(2);
 
-// Pre-process --config and --workspace flags before dispatching commands
+// Pre-process global 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]);
@@ -11,44 +20,54 @@ for (let i = 0; i < args.length; i++) {
   if (args[i] === '--workspace' && args[i + 1]) {
     process.env.MDBOARD_WORKSPACE = path.resolve(args[i + 1]);
   }
+  if (args[i] === '--preset' && args[i + 1]) {
+    process.env.MDBOARD_PRESET = args[i + 1];
+  }
 }
 
 const command = args[0];
 
+// --- Version ---
 if (command === '--version' || command === '-v') {
   const pkg = require('./package.json');
   console.log('mdboard v' + pkg.version);
   process.exit(0);
 }
 
-if (command === '--help' || command === '-h') {
+// --- Help ---
+if (command === '--help' || command === '-h' || command === 'help') {
   printHelp();
   process.exit(0);
 }
 
+// --- Init ---
 if (command === 'init') {
-  const initArgs = args.slice(1).filter(a => !a.startsWith('--'));
-  process.env.MDBOARD_INIT_NAME = initArgs[0] || '';
-  require('./src/cli/init.js');
-} else if (command === 'help') {
-  printHelp();
+  require('./src/cli/init');
   process.exit(0);
-} else if (command === 'cache') {
+}
+
+// --- Cache ---
+if (command === 'cache') {
   handleCache();
-} else if (command === 'status') {
+  process.exit(0);
+}
+
+// --- History ---
+if (command === 'history') {
+  handleHistory();
+  process.exit(0);
+}
+
+// --- Status ---
+if (command === 'status') {
   const { resolveProjectDir } = require('./src/cli/cli');
   const { generateStatus } = require('./src/cli/status');
   generateStatus(resolveProjectDir(args));
-} else if (command === 'sync') {
-  const { resolveProjectDir, parseFlags } = require('./src/cli/cli');
-  const { runSync } = require('./src/cli/sync');
-  const { flags } = parseFlags(args.slice(1));
-  runSync(resolveProjectDir(args), { fix: !!flags.fix });
-} else if (command === 'theme') {
-  const { handleTheme } = require('./src/cli/theme');
-  handleTheme(args.slice(1));
   process.exit(0);
-} else if (command === 'create') {
+}
+
+// --- CRUD: create, update, delete ---
+if (command === 'create') {
   const { resolveProjectDir, handleCreate } = require('./src/cli/cli');
   handleCreate(resolveProjectDir(args), args.slice(1));
 } else if (command === 'update') {
@@ -57,11 +76,28 @@ if (command === 'init') {
 } else if (command === 'delete') {
   const { resolveProjectDir, handleDelete } = require('./src/cli/cli');
   handleDelete(resolveProjectDir(args), args.slice(1));
-} else {
-  // Default: start server. Pass all args through.
+} else if (command === 'list') {
+  const { resolveProjectDir, handleList } = require('./src/cli/cli');
+  handleList(resolveProjectDir(args), args.slice(1));
+} else if (command === 'preset') {
+  require('./src/cli/preset').run(args.slice(1));
+} else if (command === 'config') {
+  require('./src/cli/config').run(args.slice(1));
+  // readline keeps process alive; config.js calls process.exit(0) when done
+} else if (command === 'skill') {
+  require('./src/cli/skill').run(args.slice(1));
+  // readline keeps process alive; skill.js calls process.exit(0) when done
+} else if (!command || command.startsWith('--')) {
+  // Default: start server (flags like --port are handled by server.js)
   require('./src/server/server.js');
+} else {
+  console.error('  Unknown command: ' + command);
+  console.error('  Run `mdboard --help` for usage.');
+  process.exit(1);
 }
 
+// --- Cache handler ---
+
 function handleCache() {
   const subCmd = args[1];
   const { listCache, cleanCache, CACHE_DIR } = require('./src/core/workspace');
@@ -83,48 +119,70 @@ function handleCache() {
       console.log('\n  No cache to clean or error occurred.\n');
     }
   } else {
-    console.log(`
-  mdboard cache — Manage remote source cache
+    console.log('\n  mdboard cache — Manage remote source cache\n\n  Subcommands:\n    mdboard cache list       List cached remote repos\n    mdboard cache clean      Remove all cached repos\n');
+  }
+}
 
-  Subcommands:
-    mdboard cache list       List cached remote repos
-    mdboard cache clean      Remove all cached repos
-`);
+// --- History handler ---
+
+function handleHistory() {
+  const subCmd = args[1];
+  const { readHistory, pruneHistory } = require('./src/core/history');
+
+  if (subCmd === 'list') {
+    const entries = readHistory();
+    if (entries.length === 0) {
+      console.log('\n  No projects in history.\n');
+    } else {
+      console.log('\n  Project history (' + entries.length + '):\n');
+      const fs = require('fs');
+      entries.forEach(function(e) {
+        const exists = fs.existsSync(e.path);
+        const marker = exists ? '  ' : '✗ ';
+        console.log('    ' + marker + e.name + '  ' + e.path);
+      });
+      console.log('');
+    }
+  } else if (subCmd === 'clean') {
+    const { removed, kept } = pruneHistory();
+    if (removed.length === 0) {
+      console.log('\n  History is clean — all entries point to existing directories.\n');
+    } else {
+      console.log('\n  Removed ' + removed.length + ' stale entr' + (removed.length === 1 ? 'y' : 'ies') + ':\n');
+      removed.forEach(function(p) { console.log('    ✗ ' + p); });
+      console.log('\n  ' + kept + ' entr' + (kept === 1 ? 'y' : 'ies') + ' remaining.\n');
+    }
+  } else {
+    console.log('\n  mdboard history — Manage project switch history\n\n  Subcommands:\n    mdboard history list      List all projects in history\n    mdboard history clean     Remove entries with missing directories\n');
   }
-  process.exit(0);
 }
 
+// --- Help ---
+
 function printHelp() {
-  console.log(`
-  mdboard — Git-based project management dashboard
-
-  Usage:
-    mdboard                    Start the dashboard server
-    mdboard init [name]        Scaffold a new workspace (prompts if no name)
-    mdboard status             Generate project/status.md from current state
-    mdboard sync [--fix]       Check consistency; --fix to auto-correct
-    mdboard create <entity>    Create milestone, epic, task, or sprint
-    mdboard update <entity>    Update an entity's frontmatter fields
-    mdboard delete <entity>    Delete an entity and clean references
-    mdboard theme              List available themes
-    mdboard theme <name>       Set theme globally
-    mdboard theme <n> --project  Set theme for current project
-    mdboard cache list|clean   Manage remote source cache
-    mdboard --version          Print version
-    mdboard --help             Show this help
-
-  CRUD examples:
-    mdboard create milestone "MVP"
-    mdboard create epic "Auth" --milestone mvp
-    mdboard create task "Login" --milestone mvp --epic auth
-    mdboard create sprint --milestone mvp --goal "Sprint 1"
-    mdboard update task TASK-001 --status in-progress
-    mdboard delete task TASK-001
-
-  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
-`);
+  // Load config to generate dynamic examples
+  let entityExamples = '';
+  try {
+    const configEngine = require('./src/core/config');
+    const cfg = configEngine.loadConfig(process.cwd(), process.env.MDBOARD_CONFIG);
+    const types = configEngine.getEntityTypes(cfg);
+
+    if (types.length > 0) {
+      const examples = [];
+      for (const type of types) {
+        const entity = configEngine.getEntity(cfg, type);
+        const ancestors = configEngine.getAncestors(cfg, type);
+        let example = '    mdboard create ' + type + ' "My ' + entity.singular + '"';
+        for (const anc of ancestors) {
+          example += ' --' + anc.replace(/_/g, '-') + ' <slug>';
+        }
+        examples.push(example);
+      }
+      entityExamples = '\n  CRUD examples (from ' + cfg._preset + ' preset):\n' + examples.join('\n') + '\n    mdboard update task TASK-001 --status done\n    mdboard delete task TASK-001\n    mdboard list task\n';
+    }
+  } catch (e) {
+    entityExamples = '\n  CRUD examples:\n    mdboard create <entity> "title" [--flags]\n    mdboard update <entity> <id> --field value\n    mdboard delete <entity> <id>\n    mdboard list <entity>\n';
+  }
+
+  console.log('\n  mdboard — Git-based project management dashboard\n\n  Usage:\n    mdboard                    Start the dashboard server\n    mdboard init [name]        Scaffold a new workspace\n    mdboard create <entity>    Create an entity\n    mdboard update <entity>    Update an entity\n    mdboard delete <entity>    Delete an entity\n    mdboard list <entity>      List entities\n    mdboard status             Generate status report\n    mdboard preset             Create & manage presets (scrum, kanban)\n    mdboard config             Setup preferences & AI skill\n    mdboard skill              Install AI skill to IDE/agent\n    mdboard history list|clean  Manage project switch history\n    mdboard cache list|clean   Manage remote source cache\n    mdboard --version          Print version\n    mdboard --help             Show this help\n' + entityExamples + '\n  Options:\n    --project <path>           Workspace root (default: cwd)\n    --preset <name>            Methodology preset (shape-up, scrum, kanban)\n    --config <path>            Path to config directory\n    --port <number>            Server port (default: 3333)\n    --workspace <path>         Path to workspace.json\n');
 }