memd-cli 3.2.0 → 3.3.0

package/CLAUDE.md

@@ -41,7 +41,8 @@ node main.js test/test1.md
 node main.js test/test2.md
 node main.js test/complex.md
 node main.js --html test/test1.md          # HTML output to stdout
-node main.js serve --dir test --port 3000  # HTTP serve mode
+node main.js serve test --port 3000        # HTTP serve mode (directory)
+node main.js serve test/test1.md           # HTTP serve mode (single file)
 ```
 
 ## Key CLI flags
@@ -70,4 +71,5 @@ nord-light, zinc-dark, zinc-light
 - `render-shared.js` converts Mermaid fenced blocks to SVG via `@ktrysmt/beautiful-mermaid`, then renders full HTML with `marked`
 - `render-worker.js` runs `renderToHTML` in a worker thread for non-blocking serve mode
 - `render-utils.js` provides theme color resolution and HTML escaping (shared by main.js and render-shared.js)
-- Serve mode supports: directory listing, ETag/304 caching, gzip, static file serving (images/css), sidebar navigation, `--watch` with SSE live reload, CSP nonce
+- Serve mode supports: directory or single-file serving, directory listing, ETag/304 caching, gzip, static file serving (images/css), sidebar navigation, `--watch` with SSE live reload, CSP nonce
+- Single-file mode (`serve foo.md`): sets baseDir to the file's parent directory, root `/` redirects to `/<filename>`

package/main.js

@@ -707,13 +707,13 @@ async function main() {
   program
     .command('serve')
     .description('Start HTTP server to serve .md files as HTML')
-    .option('-d, --dir <path>', 'directory to serve', '.')
+    .argument('[path]', 'directory or .md file to serve', '.')
     .option('-p, --port <number>', 'port number (0-65535)', Number, 8888)
     .option('--host <string>', 'host to bind', '127.0.0.1')
     .option('--workers <number>', 'number of render workers (default: min(cpus-1, 4))', Number)
     .option('--watch', 'watch for file changes and live-reload')
     .option('--theme <name>', `color theme (env: MEMD_THEME)\n${THEME_NAMES.join(', ')}`, process.env.MEMD_THEME || 'nord')
-    .action(async (options) => {
+    .action(async (servePath, options) => {
       if (!(options.theme in THEME_MAP)) {
         const names = Object.keys(THEME_MAP).join(', ');
         console.error(`Unknown theme: ${options.theme}\nAvailable themes: ${names}`);
@@ -732,14 +732,26 @@ async function main() {
       }
 
       let baseDir;
+      let singleFile = null; // basename of .md file in single-file mode
+      let resolvedServePath;
       try {
-        baseDir = fs.realpathSync(path.resolve(options.dir));
+        resolvedServePath = fs.realpathSync(path.resolve(servePath));
       } catch {
-        console.error(`Directory not found: ${options.dir}`);
+        console.error(`Path not found: ${servePath}`);
         process.exit(1);
       }
-      if (!fs.statSync(baseDir).isDirectory()) {
-        console.error(`Not a directory: ${options.dir}`);
+      const serveStat = fs.statSync(resolvedServePath);
+      if (serveStat.isFile()) {
+        if (!resolvedServePath.endsWith('.md')) {
+          console.error(`Not a .md file: ${servePath}`);
+          process.exit(1);
+        }
+        singleFile = path.basename(resolvedServePath);
+        baseDir = path.dirname(resolvedServePath);
+      } else if (serveStat.isDirectory()) {
+        baseDir = resolvedServePath;
+      } else {
+        console.error(`Not a file or directory: ${servePath}`);
         process.exit(1);
       }
       if (baseDir === '/') {
@@ -1069,6 +1081,14 @@ body:has(.memd-layout) { max-width: none; margin: 0; padding: 0; }
             return;
           }
 
+          // Single-file mode: redirect root to the served file
+          if (singleFile && urlPath === '/') {
+            const target = '/' + encodeURIComponent(singleFile) + parsedUrl.search;
+            res.writeHead(302, { Location: target });
+            res.end();
+            return;
+          }
+
           if (isDotPath(urlPath)) {
             res.writeHead(403, { 'Content-Type': 'text/plain' });
             res.end('Forbidden');
@@ -1277,7 +1297,11 @@ body:has(.memd-layout) { max-width: none; margin: 0; padding: 0; }
         let displayHost = options.host === '0.0.0.0' || options.host === '::' ? 'localhost' : options.host;
         if (displayHost.includes(':')) displayHost = `[${displayHost}]`;
         console.log(`memd serve`);
-        console.log(`  Directory: ${baseDir}`);
+        if (singleFile) {
+          console.log(`  File:      ${path.join(baseDir, singleFile)}`);
+        } else {
+          console.log(`  Directory: ${baseDir}`);
+        }
         console.log(`  Theme:     ${options.theme}`);
         if (options.watch) console.log('  Watch:     enabled');
         console.log(`  URL:       http://${displayHost}:${addr.port}/`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memd-cli",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "type": "module",
   "main": "main.js",
   "bin": {
@@ -10,7 +10,7 @@
     "test": "vitest run --maxConcurrency=20"
   },
   "dependencies": {
-    "@ktrysmt/beautiful-mermaid": "1.4.0",
+    "@ktrysmt/beautiful-mermaid": "1.4.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "marked": "^17.0.4",

package/test/memd.test.js

@@ -26,7 +26,7 @@ function runSync(args) {
 describe('memd CLI', () => {
   it.concurrent('--version', async () => {
     const output = await run(['-v'])
-    expect(output).toContain('3.2.0')
+    expect(output).toContain('3.2.1')
   })
 
   it.concurrent('--help', async () => {
@@ -416,7 +416,7 @@ describe('memd serve', () => {
   let serverProcess
 
   beforeAll(async () => {
-    serverProcess = spawn('node', [MAIN, 'serve', '--port', String(PORT), '--dir', __dirname, '--host', '127.0.0.1'], {
+    serverProcess = spawn('node', [MAIN, 'serve', __dirname, '--port', String(PORT), '--host', '127.0.0.1'], {
       stdio: ['pipe', 'pipe', 'pipe'],
     })
     await new Promise((resolve, reject) => {
@@ -444,7 +444,7 @@ describe('memd serve', () => {
 
   it('serve --help shows options', () => {
     const output = runSync(['serve', '--help'])
-    expect(output).toContain('-d, --dir')
+    expect(output).toContain('[path]')
     expect(output).toContain('--port')
     expect(output).toContain('--host')
     expect(output).toContain('--watch')
@@ -655,7 +655,7 @@ describe('memd serve --watch', () => {
   let watchProcess
 
   beforeAll(async () => {
-    watchProcess = spawn('node', [MAIN, 'serve', '--port', String(WATCH_PORT), '--dir', __dirname, '--host', '127.0.0.1', '--watch'], {
+    watchProcess = spawn('node', [MAIN, 'serve', __dirname, '--port', String(WATCH_PORT), '--host', '127.0.0.1', '--watch'], {
       stdio: ['pipe', 'pipe', 'pipe'],
     })
     await new Promise((resolve, reject) => {

package/test/test-subgraph.md

@@ -0,0 +1,26 @@
+```mermaid
+graph TD
+    subgraph WS1["WS1: Blog Publication"]
+        B1["Blog #1-6<br>FISC 13th Analysis"]
+        B7["Blog #7<br>Cross-Mapping<br>Methods and Challenges"]
+    end
+
+    subgraph WS3["WS3: CODE BLUE CFP"]
+        IR["NIST IR 8477<br>Methodology Notes<br>(internal research)"]
+        CE["3.3 CIS-NIST-ISO<br>Prior Art Review"]
+        AB["3.4 CFP Abstract<br>Draft"]
+        SUB["3.12 CFP Submission<br>Jul 10"]
+    end
+
+    subgraph WS4["WS4: C3a SaaS"]
+        OSCAL["OSCAL Mapping Model<br>Data Format"]
+    end
+
+    B1 -->|"Establishes<br>domain expertise"| B7
+    B7 -->|"Demonstrates<br>practical experience"| AB
+    IR -->|"Provides<br>theoretical framework"| AB
+    CE -->|"Positions<br>novelty"| AB
+    AB --> SUB
+    IR -->|"OSCAL compatibility<br>requirement"| OSCAL
+    B7 -.->|"Blog #7 references<br>IR 8477 methodology"| IR
+```

package/.claude/settings.local.json

@@ -1,23 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(echo:*)",
-      "Bash(FORCE_COLOR=1 echo:*)",
-      "Bash(script:*)",
-      "Bash(FORCE_COLOR=1 node:*)",
-      "Bash(node -e \"import\\('beautiful-mermaid/src/ascii/ansi.ts'\\).then\\(m=>console.log\\(Object.keys\\(m\\)\\)\\).catch\\(e=>console.error\\('ERROR:',e.message\\)\\)\" 2>&1 | head -5)",
-      "Bash(node main.js test/test-highlight.md --no-pager --theme catppuccin-mocha 2>&1 | head -3 | xxd | head -10)",
-      "Bash(FORCE_COLOR=1 node main.js test/test-highlight.md --no-pager --theme catppuccin-mocha 2>&1 | head -3 | xxd | head -5)",
-      "Bash(FORCE_COLOR=1 node main.js test/test-highlight.md --no-pager --theme zinc-dark 2>&1 | head -3 | xxd | head -5)",
-      "mcp__grep-github__searchGitHub",
-      "Bash(npx npm-check-updates:*)",
-      "Bash(MEMD_THEME= pnpm test 2>&1 | tail -20)",
-      "Bash(MEMD_THEME= npx vitest run 2>&1)",
-      "Bash(node:*)",
-      "Bash(printf:*)",
-      "WebFetch(domain:registry.npmjs.org)",
-      "WebFetch(domain:api.github.com)",
-      "Bash(mkdir:*)"
-    ]
-  }
-}