memd-cli 3.2.1 → 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.1",
+  "version": "3.3.0",
   "type": "module",
   "main": "main.js",
   "bin": {

package/test/memd.test.js

@@ -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/.claude/settings.local.json

@@ -1,28 +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:*)",
-      "Bash(# Restore original dist\ncp node_modules/@ktrysmt/beautiful-mermaid/dist/index.js.bak node_modules/@ktrysmt/beautiful-mermaid/dist/index.js && rm node_modules/@ktrysmt/beautiful-mermaid/dist/index.js.bak && rm -f debug-mermaid*.mjs bm-debug.mjs)",
-      "Bash(cp dist/index.js.bak dist/index.js)",
-      "Bash(rm -f dist/index.js.debug)",
-      "Bash(rm -f pnpm-lock.yaml)",
-      "Bash(rm -rf node_modules)"
-    ]
-  }
-}