drafted 1.7.18 → 1.7.19

package/install-mcp.sh

@@ -586,6 +586,7 @@ struct DraftedUpdaterApp: App {
   var body: some Scene {
     MenuBarExtra {
       Button("Update Drafted") { Actions.updateDrafted() }
+      Button("View Logs") { Actions.viewLogs() }
       Button("Open Drafted") { Actions.openDrafted() }
       Divider()
       Button("Quit") { NSApp.terminate(nil) }
@@ -735,6 +736,47 @@ struct Actions {
     }
   }
 
+  static func viewLogs() {
+    let fm = FileManager.default
+    let home = fm.homeDirectoryForCurrentUser
+    let fallback = home.appendingPathComponent(".drafted")
+    try? fm.createDirectory(at: fallback, withIntermediateDirectories: true)
+    let readme = fallback.appendingPathComponent("logs-readme.txt")
+    if !fm.fileExists(atPath: readme.path) {
+      let text = """
+Drafted MCP logs are written by the host app that launched drafted-mcp.
+
+Most useful locations:
+- Drafted MCP client errors: ~/.drafted/mcp-client.log
+- Claude Desktop: ~/Library/Logs/Claude/mcp-server-drafted.log
+- Claude Code: ~/.claude/projects (session transcripts) or ~/.claude/logs when present
+- Drafted installer/updater: ~/.drafted
+
+If a tool returns `fetch failed`, open the Claude log or transcript from the same run and look for `mcp-server-drafted` or `Drafted MCP`.
+"""
+      try? text.write(to: readme, atomically: true, encoding: .utf8)
+    }
+
+    let candidates = [
+      home.appendingPathComponent(".drafted/mcp-client.log"),
+      home.appendingPathComponent("Library/Logs/Claude/mcp-server-drafted.log"),
+      home.appendingPathComponent("Library/Logs/Claude"),
+      home.appendingPathComponent(".claude/logs"),
+      home.appendingPathComponent(".claude/projects"),
+      fallback,
+    ]
+    for url in candidates where fm.fileExists(atPath: url.path) {
+      var isDirectory: ObjCBool = false
+      fm.fileExists(atPath: url.path, isDirectory: &isDirectory)
+      if isDirectory.boolValue {
+        NSWorkspace.shared.open(url)
+      } else {
+        NSWorkspace.shared.activateFileViewerSelecting([url])
+      }
+      return
+    }
+  }
+
   static func openDrafted() {
     NSWorkspace.shared.open(URL(string: "https://drafted.live")!)
   }

package/mcp/server.mjs

@@ -10,9 +10,9 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { execFile } from 'child_process';
 import { createHash } from 'node:crypto';
-import { readFileSync, existsSync, realpathSync, writeFileSync, mkdirSync, unlinkSync } from 'fs';
+import { readFileSync, existsSync, realpathSync, writeFileSync, mkdirSync, unlinkSync, appendFileSync } from 'fs';
 import { join, dirname, basename, extname, resolve } from 'path';
-import { homedir } from 'os';
+import { homedir, platform, release as osRelease, arch as osArch } from 'os';
 import { fileURLToPath } from 'url';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { z } from 'zod';
@@ -202,9 +202,15 @@ function tool(name, descOrSchema, schemaOrHandler, handler) {
   }
   return server.registerTool(name, config, async (...args) => {
     const state = getState();
+    const previousTool = state.currentTool;
+    state.currentTool = name;
     trackUmamiEvent(UMAMI_EVENTS.MCP_TOOL_CALLED, { tool: name, projectId: state.projectId || undefined, source: 'mcp' });
-    reportInstallationEvent(UMAMI_EVENTS.DRAFTED_MCP_REQUEST);
-    return cb(...args);
+    reportInstallationEvent(UMAMI_EVENTS.DRAFTED_MCP_REQUEST, { tool: name });
+    try {
+      return await cb(...args);
+    } finally {
+      state.currentTool = previousTool;
+    }
   });
 }
 
@@ -301,7 +307,25 @@ function getInstallInfo() {
   }
 }
 
-function reportInstallationEvent(event) {
+
+function osFamily() {
+  const p = platform();
+  if (p === 'darwin') return 'macos';
+  if (p === 'win32') return 'windows';
+  if (p === 'linux') return 'linux';
+  return 'unknown';
+}
+
+function normalizedArch() {
+  const a = osArch();
+  return ['x64', 'arm64', 'arm', 'ia32'].includes(a) ? a : 'unknown';
+}
+
+function mcpMode() {
+  return process.argv.includes('--http') ? 'http' : 'stdio';
+}
+
+function reportInstallationEvent(event, extra = {}) {
   const info = getInstallInfo();
   if (!info) return;
   fetch(`${getServerUrl()}/api/installations/report`, {
@@ -312,12 +336,78 @@ function reportInstallationEvent(event) {
       event,
       schemaVersion: 1,
       cliVersion: PACKAGE_VERSION,
-      mcpMode: process.argv.includes('--http') ? 'http' : 'stdio',
+      osFamily: osFamily(),
+      osVersion: osRelease().slice(0, 60),
+      arch: normalizedArch(),
+      nodeVersion: process.version,
+      mcpMode: mcpMode(),
       source: 'mcp',
+      ...extra,
     }),
   }).catch(() => {});
 }
 
+function classifyMcpError(error) {
+  const msg = String(error?.message || error || '').toLowerCase();
+  const causeCode = String(error?.cause?.code || error?.code || '').toLowerCase();
+  if (causeCode) return causeCode.slice(0, 80);
+  if (msg.includes('fetch failed')) return 'fetch_failed';
+  if (msg.includes('failed to fetch')) return 'fetch_failed';
+  if (msg.includes('network')) return 'network_error';
+  if (msg.includes('timeout') || msg.includes('timed out')) return 'timeout';
+  const httpMatch = msg.match(/http\s+(\d{3})/);
+  if (httpMatch) return `http_${httpMatch[1]}`;
+  if (msg.includes('unauthorized') || msg.includes('401')) return 'auth_401';
+  if (msg.includes('forbidden') || msg.includes('403')) return 'auth_403';
+  return 'tool_error';
+}
+
+function scrubLogValue(value) {
+  if (typeof value !== 'string') return value;
+  return value
+    .replace(/([?&](?:token|code|dci|session|auth|password|secret)=)[^&\s]+/gi, '$1[Filtered]')
+    .replace(/(Bearer\s+)[A-Za-z0-9._~+\/-]+=*/gi, '$1[Filtered]')
+    .replace(/(gc_session=)[^;\s]+/gi, '$1[Filtered]')
+    .slice(0, 500);
+}
+
+function serverOriginForLog() {
+  try { return new URL(getServerUrl()).origin; } catch { return 'invalid_server_url'; }
+}
+
+function writeMcpClientLog(tool, error) {
+  const entry = {
+    ts: new Date().toISOString(),
+    level: 'error',
+    component: 'drafted-mcp-client',
+    version: PACKAGE_VERSION,
+    tool: String(tool || 'unknown').slice(0, 80),
+    errorCode: classifyMcpError(error),
+    message: scrubLogValue(error?.message || String(error)),
+    causeCode: scrubLogValue(error?.cause?.code || error?.code || ''),
+    causeMessage: scrubLogValue(error?.cause?.message || ''),
+    server: serverOriginForLog(),
+    osFamily: osFamily(),
+    nodeVersion: process.version,
+    mcpMode: mcpMode(),
+  };
+  const line = `[Drafted MCP] ${JSON.stringify(entry)}\n`;
+  try { console.error(line.trimEnd()); } catch { /* ignore */ }
+  try {
+    const logPath = join(homedir(), '.drafted', 'mcp-client.log');
+    mkdirSync(dirname(logPath), { recursive: true });
+    appendFileSync(logPath, line, { mode: 0o600 });
+  } catch { /* best effort */ }
+}
+
+function reportMcpToolError(tool, error) {
+  writeMcpClientLog(tool, error);
+  reportInstallationEvent(UMAMI_EVENTS.DRAFTED_MCP_ERROR, {
+    tool: String(tool || 'unknown').slice(0, 80),
+    errorCode: classifyMcpError(error),
+  });
+}
+
 function wikiBrowserUrl(path = '') {
   const normalized = normalizeWikiPath(path || '');
   if (!normalized) return `${getServerUrl()}/wiki`;
@@ -702,6 +792,7 @@ if (!globalThis.__draftedAgentWsBootstrapped) {
 }
 
 function err(error) {
+  reportMcpToolError(getState().currentTool, error);
   return { content: [{ type: 'text', text: error.message || String(error) }], isError: true };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.7.18",
+  "version": "1.7.19",
   "description": "Drafted — visual thinking surface for humans and AI agents. Renders HTML, markdown, images, and code as frames on a zoomable canvas, with MCP tools for AI agents and real-time sync for humans.",
   "type": "module",
   "files": [