openwriter 0.2.2 → 0.3.1

package/README.md

@@ -45,7 +45,7 @@ npx skills add https://github.com/travsteward/openwriter --skill openwriter
 
 Then add the MCP server for the 24 editing tools:
 ```bash
-claude mcp add -s user open-writer -- npx openwriter --no-open
+claude mcp add -s user openwriter -- npx openwriter --no-open
 ```
 
 The skill teaches your agent how to use OpenWriter's tools effectively — writing strategy, review etiquette, and troubleshooting. The MCP server provides the actual document editing capabilities.
@@ -55,7 +55,7 @@ The skill teaches your agent how to use OpenWriter's tools effectively — writi
 ```json
 {
   "mcpServers": {
-    "open-writer": {
+    "openwriter": {
       "command": "npx",
       "args": ["openwriter", "--no-open"]
     }
@@ -78,7 +78,7 @@ Now your agent has 24 tools to read, write, and organize documents — and every
 | **Document** | `read_pad`, `write_to_pad`, `edit_text`, `get_pad_status`, + 5 more | Read/write document content, fine-grained text edits, metadata |
 | **Multi-doc** | `list_documents`, `switch_document`, `create_document` | Navigate and manage multiple documents |
 | **Workspace** | `create_workspace`, `get_workspace_structure`, `add_doc`, + 6 more | Organize docs into projects with containers and tags |
-| **Import** | `import_gdoc` | Import Google Docs, auto-split into chapters |
+| **Import** | `import_gdoc` | Import structured Google Docs, auto-split into chapters |
 
 Agents write in markdown or TipTap JSON. The server converts, assigns node IDs, and broadcasts changes to your browser in real-time via WebSocket.
 

package/dist/bin/pad.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * CLI entry point for OpenWriter.
- * Usage: npx openwriter [--api-key av_live_xxx] [--port 5050] [--no-open] [--av-url URL] [--plugins name1,name2]
+ * Usage: openwriter [--api-key av_live_xxx] [--port 5050] [--no-open] [--av-url URL] [--plugins name1,name2]
  *
  * API key resolution (first wins):
  *   1. --api-key CLI flag
@@ -9,11 +9,18 @@
  *   3. Saved in ~/.openwriter/config.json (from a previous --api-key)
  *
  * If no key found, server starts anyway — plugins that need it will report errors.
+ *
+ * Boot order optimized for fast MCP startup:
+ *   1. Parse args + config (light imports only)
+ *   2. Port check (fast TCP probe)
+ *   3. Start MCP stdio transport (what Claude Code waits for)
+ *   4. Lazy-load Express server + plugins (heavy deps deferred)
  */
 // Redirect all console output to stderr so MCP stdio protocol stays clean on stdout
 const originalLog = console.log;
 console.log = (...args) => console.error(...args);
-import { startServer } from '../server/index.js';
+// Only light imports here — helpers.js uses fs/path/os/crypto (all Node stdlib)
+import { createConnection } from 'net';
 import { readConfig, saveConfig } from '../server/helpers.js';
 const args = process.argv.slice(2);
 // Subcommands (run and exit, don't start server)
@@ -66,5 +73,30 @@ else {
         process.env.AV_API_KEY = avApiKey;
     if (avBackendUrl)
         process.env.AV_BACKEND_URL = avBackendUrl;
-    startServer({ port, noOpen, plugins });
+    // Fast port check — determines primary vs client mode
+    const portTaken = await new Promise((resolve) => {
+        const socket = createConnection({ port, host: '127.0.0.1' });
+        socket.once('connect', () => { socket.destroy(); resolve(true); });
+        socket.once('error', () => { resolve(false); });
+    });
+    if (portTaken) {
+        // Client mode: proxy MCP calls to existing primary server via HTTP
+        console.error(`[OpenWriter] Port ${port} in use — entering client mode (proxying to existing server)`);
+        const { startMcpClientServer } = await import('../server/mcp-client.js');
+        startMcpClientServer(port).catch((err) => {
+            console.error('[MCP-Client] Failed to start:', err);
+        });
+    }
+    else {
+        // Primary mode: start MCP stdio FIRST, then lazy-load Express
+        const { load } = await import('../server/state.js');
+        load();
+        const { startMcpServer } = await import('../server/mcp.js');
+        startMcpServer().catch((err) => {
+            console.error('[MCP] Failed to start:', err);
+        });
+        // Deferred: load Express + plugins (heavy deps) after MCP is connecting
+        const { startHttpServer } = await import('../server/index.js');
+        startHttpServer({ port, noOpen, plugins });
+    }
 }