mdboard 1.2.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,36 +20,87 @@ 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') {
-  require('./init.js');
-} else if (command === 'help') {
-  printHelp();
+  require('./src/cli/init');
   process.exit(0);
-} else if (command === 'cache') {
+}
+
+// --- Cache ---
+if (command === 'cache') {
   handleCache();
+  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));
+  process.exit(0);
+}
+
+// --- CRUD: create, update, delete ---
+if (command === 'create') {
+  const { resolveProjectDir, handleCreate } = require('./src/cli/cli');
+  handleCreate(resolveProjectDir(args), args.slice(1));
+} else if (command === 'update') {
+  const { resolveProjectDir, handleUpdate } = require('./src/cli/cli');
+  handleUpdate(resolveProjectDir(args), args.slice(1));
+} else if (command === 'delete') {
+  const { resolveProjectDir, handleDelete } = require('./src/cli/cli');
+  handleDelete(resolveProjectDir(args), args.slice(1));
+} 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 {
-  // Default: start server. Pass all args through.
-  require('./server.js');
+  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('./workspace');
+  const { listCache, cleanCache, CACHE_DIR } = require('./src/core/workspace');
 
   if (subCmd === 'list') {
     const entries = listCache();
@@ -59,44 +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               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
-`);
+  // 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');
 }