md-feedback 1.1.1 → 1.3.0

package/README.md

@@ -28,6 +28,21 @@ Add to your MCP client config (Claude Code, Cursor, etc.):
 
 That's it. No install, no setup — `npx` handles everything.
 
+**Workspace override** — if your MCP client doesn't set `cwd` to the project folder:
+
+```json
+{
+  "mcpServers": {
+    "md-feedback": {
+      "command": "npx",
+      "args": ["-y", "md-feedback", "--workspace=/path/to/project"]
+    }
+  }
+}
+```
+
+Resolution order: `--workspace=` CLI arg > `MD_FEEDBACK_WORKSPACE` env > `cwd`
+
 ## 19 MCP Tools
 
 | Tool | Description |
@@ -37,7 +52,7 @@ That's it. No install, no setup — `npx` handles everything.
 | `get_review_status` | Annotation counts and session status |
 | `create_annotation` | Create annotation programmatically with anchor search |
 | `respond_to_memo` | Add AI response to an annotation |
-| `update_memo_status` | Mark a memo as open/in_progress/answered/done/failed/wontfix |
+| `update_memo_status` | Mark a memo as open/in_progress/needs_review/answered/done/failed/wontfix |
 | `update_cursor` | Set plan cursor position (task ID, step, next action) |
 | `evaluate_gates` | Check if merge/release/implement conditions are met |
 | `export_review` | Export for a specific AI tool format |
@@ -52,6 +67,11 @@ That's it. No install, no setup — `npx` handles everything.
 | `batch_apply` | Apply multiple operations in a single transaction |
 | `get_memo_changes` | Get implementation history and progress for a memo |
 
+## Safety & Reliability
+
+- **File mutex** — concurrent MCP tool calls are serialized per-file, preventing data corruption
+- **Improved anchor matching** — annotations find their intended location more reliably, even with multiple matches
+
 ## How It Works
 
 1. You annotate a markdown plan in the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=yeominux.md-feedback-vscode)
@@ -63,9 +83,10 @@ That's it. No install, no setup — `npx` handles everything.
 ## CLI
 
 ```bash
-md-feedback --help      # Show help
-md-feedback --version   # Print version
-md-feedback             # Start MCP server (stdio)
+md-feedback                          # Start MCP server (stdio)
+md-feedback --workspace=/path/to/dir # Set workspace root explicitly
+md-feedback --version                # Print version
+md-feedback --help                   # Show help
 ```
 
 ## Who Is This For?

package/bin/md-feedback.cjs

@@ -3,11 +3,17 @@
 const arg = process.argv[2]
 if (arg === '--help' || arg === '-h') {
   console.log('md-feedback - MCP server for markdown annotation review\n')
-  console.log('Usage: md-feedback              Start MCP server (stdio transport)')
-  console.log('       md-feedback --version    Print version')
-  console.log('       md-feedback --help       Show this help\n')
+  console.log('Usage: md-feedback                          Start MCP server (stdio transport)')
+  console.log('       md-feedback --workspace=/path/to/dir Set workspace root explicitly')
+  console.log('       md-feedback --version                Print version')
+  console.log('       md-feedback --help                   Show this help\n')
+  console.log('Workspace resolution (first match wins):')
+  console.log('  1. --workspace=<path>              CLI argument')
+  console.log('  2. MD_FEEDBACK_WORKSPACE env var   Environment variable')
+  console.log('  3. Current working directory       Default fallback\n')
   console.log('Configure in your AI tool\'s MCP settings:')
   console.log('  { "command": "npx", "args": ["-y", "md-feedback"] }')
+  console.log('  { "command": "npx", "args": ["-y", "md-feedback", "--workspace=/my/project"] }')
   process.exit(0)
 }
 if (arg === '--version' || arg === '-v') {