taskover-mcp 1.1.0 → 1.2.0

package/index.js

@@ -1,1433 +1,2294 @@
-#!/usr/bin/env node
-
-const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
-const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
-const {
-  ListToolsRequestSchema,
-  CallToolRequestSchema,
-} = require("@modelcontextprotocol/sdk/types.js");
-
-// SECURITY: Mode selection — API key (headless) or browser auth (default).
-const CLOUD_MODE = !!process.env.TASKOVER_API_KEY;
-const BROWSER_AUTH_MODE = !CLOUD_MODE;
-
-// SECURITY: Refuse API key passed as CLI argument
-if (process.argv.some(arg => arg.startsWith("tok_"))) {
-  console.error("[SECURITY] API keys must not be passed as command-line arguments.");
-  console.error("Use the TASKOVER_API_KEY environment variable instead.");
-  process.exit(1);
-}
-
-const cloudAdapter = require("./cloud-adapter.js");
-const { TOOL_MAP: toolMap, validateSchema } = require("./tool-map.js");
-let authFlow;
-
-if (CLOUD_MODE) {
-  cloudAdapter.init(process.env.TASKOVER_API_KEY);
-} else {
-  authFlow = require("./auth-flow.js");
-}
-
-const server = new Server(
-  { name: "taskover.gg", version: "1.0.0" },
-  { capabilities: { tools: {} } }
-);
-
-// ===== TOOL DEFINITIONS =====
-
-const TOOLS = [
-  // --- Dashboard & Context ---
-  {
-    name: "taskovergg_dashboard",
-    description: "Get full project dashboard: system counts, open bugs, task board, last session. Use at start of every new chat.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string", description: "Project ID (e.g. 'village', 'room-06')" },
-      },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_context_export",
-    description: "Generate full context dump — all systems, bugs, tasks, last session, decisions. Paste into new chats.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_search",
-    description: "Search across all project data — tasks, systems, sessions, bugs, blueprints, notes.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        query: { type: "string", description: "Search term" },
-      },
-      required: ["project_id", "query"],
-    },
-  },
-
-  // --- Projects ---
-  {
-    name: "taskovergg_list_projects",
-    description: "List all projects.",
-    inputSchema: { type: "object", properties: {} },
-  },
-  {
-    name: "taskovergg_add_project",
-    description: `DO NOT call this tool directly. Projects must be created by the user on the TaskOver website.
-
-Instead of calling this tool, instruct the user with these steps:
-1. Go to taskover.gg and log in
-2. Click the project dropdown in the top-left of the sidebar
-3. Click "+ New Project" at the bottom of the dropdown
-4. Follow the 5-step project creation wizard:
-   - Step 1: Enter the project name and description
-   - Step 2: Choose a project color/icon
-   - Step 3: Set up initial systems (or skip)
-   - Step 4: Configure project settings
-   - Step 5: Review and confirm
-5. Once the project appears in the project list, tell the AI the project name so it can begin adding tasks, systems, and other data to it via MCP.
-
-After the user confirms the project exists, use taskovergg_list_projects to find the project_id, then use other tools (taskovergg_add_task, taskovergg_add_system, etc.) to populate it.`,
-    inputSchema: {
-      type: "object",
-      properties: {
-        name: { type: "string" },
-        description: { type: "string" },
-        trello_board_id: { type: "string" },
-      },
-      required: ["name"],
-    },
-  },
-
-  // --- Tasks (replaces To Do / Doing / Done / Scrapped) ---
-  {
-    name: "taskovergg_get_tasks",
-    description: "Get tasks filtered by status and/or phase. Statuses: todo, doing, done, scrapped.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        status: { type: "string", enum: ["todo", "doing", "done", "scrapped"] },
-        phase: { type: "string" },
-      },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_task",
-    description: "Add a task (idea, feature, to-do item).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        title: { type: "string" },
-        description: { type: "string" },
-        status: { type: "string", enum: ["todo", "doing", "done", "scrapped"] },
-        phase: { type: "string" },
-        priority: { type: "string", enum: ["high", "medium", "low"] },
-        tags: { type: "array", items: { type: "string" } },
-        checklist: { type: "array", items: { type: "object", properties: { text: { type: "string" }, done: { type: "boolean" } } } },
-      },
-      required: ["project_id", "title"],
-    },
-  },
-  {
-    name: "taskovergg_update_task",
-    description: "Update a task's fields.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        task_id: { type: "string" },
-        title: { type: "string" },
-        description: { type: "string" },
-        status: { type: "string", enum: ["todo", "doing", "done", "scrapped"] },
-        phase: { type: "string" },
-        priority: { type: "string", enum: ["high", "medium", "low"] },
-        tags: { type: "array", items: { type: "string" } },
-        checklist: { type: "array", items: { type: "object", properties: { text: { type: "string" }, done: { type: "boolean" } } } },
-      },
-      required: ["task_id"],
-    },
-  },
-  {
-    name: "taskovergg_move_task",
-    description: "Move task between columns (todo/doing/done/scrapped).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        task_id: { type: "string" },
-        status: { type: "string", enum: ["todo", "doing", "done", "scrapped"] },
-      },
-      required: ["task_id", "status"],
-    },
-  },
-  {
-    name: "taskovergg_add_task_comment",
-    description: "Add a comment to a task (replaces Trello card comments).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        task_id: { type: "string" },
-        text: { type: "string" },
-      },
-      required: ["task_id", "text"],
-    },
-  },
-
-  // --- Systems (replaces Claude Memory documentation cards) ---
-  {
-    name: "taskovergg_get_systems",
-    description: "Get all systems/features for a project with status, files, rules, notes.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_system",
-    description: "Document a new system/feature. Include critical rules and notes.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        name: { type: "string" },
-        description: { type: "string" },
-        status: { type: "string", enum: ["working", "wip", "broken", "planned"] },
-        key_files: { type: "string" },
-        notes: { type: "string" },
-        critical_rules: { type: "string" },
-      },
-      required: ["project_id", "name"],
-    },
-  },
-  {
-    name: "taskovergg_update_system",
-    description: "Update a system's status, description, notes, or rules.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        system_id: { type: "string" },
-        name: { type: "string" },
-        description: { type: "string" },
-        status: { type: "string", enum: ["working", "wip", "broken", "planned"] },
-        key_files: { type: "string" },
-        notes: { type: "string" },
-        critical_rules: { type: "string" },
-      },
-      required: ["system_id"],
-    },
-  },
-
-  // --- Sessions (replaces Claude Chat Memory) ---
-  {
-    name: "taskovergg_get_sessions",
-    description: "Get recent work sessions with what was done and where we left off.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        limit: { type: "number" },
-      },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_log_session",
-    description: "Log a work session. Call at end of each chat (replaces !chatsave). Include what was done, where we left off, and next steps.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        title: { type: "string" },
-        summary: { type: "string" },
-        what_we_did: { type: "array", items: { type: "string" } },
-        where_we_left_off: { type: "string" },
-        next_steps: { type: "array", items: { type: "string" } },
-        systems_worked_on: { type: "array", items: { type: "string" } },
-      },
-      required: ["project_id", "title"],
-    },
-  },
-
-  // --- Changelog ---
-  {
-    name: "taskovergg_get_changelog",
-    description: "Get recent changelog entries.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        limit: { type: "number" },
-      },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_changelog",
-    description: "Log changes made. Include list of specific changes and affected systems.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        title: { type: "string" },
-        changes: { type: "array", items: { type: "string" } },
-        systems_affected: { type: "array", items: { type: "string" } },
-      },
-      required: ["project_id", "title", "changes"],
-    },
-  },
-
-  // --- Bugs ---
-  {
-    name: "taskovergg_get_bugs",
-    description: "Get bugs, optionally filtered by status (open/fixed/wontfix).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        status: { type: "string", enum: ["open", "fixed", "wontfix"] },
-      },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_bug",
-    description: "Report a bug with priority and steps to reproduce.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        system_id: { type: "string" },
-        title: { type: "string" },
-        description: { type: "string" },
-        priority: { type: "string", enum: ["high", "medium", "low"] },
-        steps_to_reproduce: { type: "string" },
-      },
-      required: ["project_id", "title"],
-    },
-  },
-  {
-    name: "taskovergg_fix_bug",
-    description: "Mark a bug as fixed with a description of the fix.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        bug_id: { type: "string" },
-        fix_description: { type: "string" },
-      },
-      required: ["bug_id"],
-    },
-  },
-
-  // --- Decisions ---
-  {
-    name: "taskovergg_get_decisions",
-    description: "Get design decisions for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_log_decision",
-    description: "Log a design decision with context and alternatives considered.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        decision: { type: "string" },
-        context: { type: "string" },
-        system_id: { type: "string" },
-        alternatives: { type: "string" },
-      },
-      required: ["project_id", "decision"],
-    },
-  },
-
-  // --- Blueprints ---
-  {
-    name: "taskovergg_get_blueprints",
-    description: "Get all registered Blueprints for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_blueprint",
-    description: "Register a Blueprint with path, parent class, variables, and key functions.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        name: { type: "string" },
-        path: { type: "string" },
-        parent_class: { type: "string" },
-        system_id: { type: "string" },
-        description: { type: "string" },
-        variables: { type: "array", items: { type: "string" } },
-        key_functions: { type: "array", items: { type: "string" } },
-      },
-      required: ["project_id", "name"],
-    },
-  },
-  {
-    name: "taskovergg_update_blueprint",
-    description: "Update a registered Blueprint.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        blueprint_id: { type: "string" },
-        name: { type: "string" },
-        path: { type: "string" },
-        parent_class: { type: "string" },
-        description: { type: "string" },
-        variables: { type: "array", items: { type: "string" } },
-        key_functions: { type: "array", items: { type: "string" } },
-      },
-      required: ["blueprint_id"],
-    },
-  },
-
-  // --- Blueprint Graphs ---
-  {
-    name: "taskovergg_get_blueprint_graphs",
-    description: "Get all visual diagram graphs for a blueprint, including nodes, connections, and layout.",
-    inputSchema: {
-      type: "object",
-      properties: { blueprint_id: { type: "string" } },
-      required: ["blueprint_id"],
-    },
-  },
-  {
-    name: "taskovergg_set_blueprint_graph",
-    description: "Set a complete visual diagram graph on a blueprint. Creates or replaces a named graph with nodes, pins, and connections.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        blueprint_id: { type: "string" },
-        graph_name: { type: "string", description: "Graph name, e.g. 'EventGraph'" },
-        graph_type: { type: "string", enum: ["event", "function", "macro"] },
-        nodes: {
-          type: "array",
-          items: {
-            type: "object",
-            properties: {
-              id: { type: "string" }, type: { type: "string" }, title: { type: "string" },
-              subtitle: { type: "string" }, x: { type: "number" }, y: { type: "number" },
-              comment: { type: "string" }, pure: { type: "boolean" },
-              pins: { type: "array", items: { type: "object",
-                properties: { id: { type: "string" }, name: { type: "string" }, direction: { type: "string" }, type: { type: "string" } },
-                required: ["id", "name", "direction", "type"] } },
-            },
-            required: ["id", "type", "title", "x", "y", "pins"],
-          },
-        },
-        connections: {
-          type: "array",
-          items: { type: "object",
-            properties: { id: { type: "string" }, sourceNodeId: { type: "string" }, sourcePinId: { type: "string" }, targetNodeId: { type: "string" }, targetPinId: { type: "string" } },
-            required: ["id", "sourceNodeId", "sourcePinId", "targetNodeId", "targetPinId"] },
-        },
-      },
-      required: ["blueprint_id", "graph_name", "nodes", "connections"],
-    },
-  },
-  {
-    name: "taskovergg_add_graph_nodes",
-    description: "Add nodes and connections to an existing blueprint graph without replacing existing data.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        blueprint_id: { type: "string" },
-        graph_name: { type: "string" },
-        nodes: { type: "array", items: { type: "object" } },
-        connections: { type: "array", items: { type: "object" } },
-      },
-      required: ["blueprint_id", "graph_name"],
-    },
-  },
-
-  // --- Notes ---
-  {
-    name: "taskovergg_get_notes",
-    description: "Get notes, optionally filtered by parent type (project/system/task/blueprint).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        parent_type: { type: "string", enum: ["project", "system", "task", "blueprint"] },
-        parent_id: { type: "string" },
-      },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_note",
-    description: "Add a note/document to the project or attached to a system/task/blueprint.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        parent_type: { type: "string", enum: ["project", "system", "task", "blueprint"] },
-        parent_id: { type: "string" },
-        title: { type: "string" },
-        content: { type: "string" },
-      },
-      required: ["project_id", "content"],
-    },
-  },
-
-  // --- Backups ---
-  {
-    name: "taskovergg_log_backup",
-    description: "Log that a project backup was created (replaces !backup).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        title: { type: "string" },
-        description: { type: "string" },
-      },
-      required: ["project_id"],
-    },
-  },
-
-  // --- Levels ---
-  {
-    name: "taskovergg_get_levels",
-    description: "Get all levels/scenes for a project with actors and status.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_level",
-    description: "Add a level/scene with name, map, and actor count.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        name: { type: "string" },
-        map: { type: "string", description: "Map/file path" },
-        actor_count: { type: "number" },
-        status: { type: "string", enum: ["planned", "wip", "testing", "done"] },
-      },
-      required: ["project_id", "name"],
-    },
-  },
-  {
-    name: "taskovergg_update_level",
-    description: "Update a level's status, name, map, or actor count.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        level_id: { type: "string" },
-        name: { type: "string" },
-        map: { type: "string" },
-        actor_count: { type: "number" },
-        status: { type: "string", enum: ["planned", "wip", "testing", "done"] },
-      },
-      required: ["level_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_actor",
-    description: "Add an actor to a level with XYZ coordinates.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        level_id: { type: "string" },
-        name: { type: "string" },
-        x: { type: "number" }, y: { type: "number" }, z: { type: "number" },
-        notes: { type: "string" },
-      },
-      required: ["level_id", "name"],
-    },
-  },
-  {
-    name: "taskovergg_remove_actor",
-    description: "Remove an actor from a level by index.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        level_id: { type: "string" },
-        actor_index: { type: "number" },
-      },
-      required: ["level_id", "actor_index"],
-    },
-  },
-
-  // --- Plugins ---
-  {
-    name: "taskovergg_get_plugins",
-    description: "Get all plugins/dependencies for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_plugin",
-    description: "Track a plugin/dependency with version and source.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        name: { type: "string" },
-        version: { type: "string" },
-        source: { type: "string", description: "Marketplace, GitHub, Custom, etc." },
-        dependents: { type: "array", items: { type: "string" } },
-      },
-      required: ["project_id", "name"],
-    },
-  },
-  {
-    name: "taskovergg_update_plugin",
-    description: "Update a plugin's version, source, or dependents.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        plugin_id: { type: "string" },
-        name: { type: "string" },
-        version: { type: "string" },
-        source: { type: "string" },
-        dependents: { type: "array", items: { type: "string" } },
-      },
-      required: ["plugin_id"],
-    },
-  },
-  {
-    name: "taskovergg_delete_plugin",
-    description: "Remove a plugin from the tracker.",
-    inputSchema: {
-      type: "object",
-      properties: { plugin_id: { type: "string" } },
-      required: ["plugin_id"],
-    },
-  },
-
-  // --- Build Errors ---
-  {
-    name: "taskovergg_get_build_errors",
-    description: "Get build/compile errors, optionally filtered by status (open/fixed).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        status: { type: "string", enum: ["open", "fixed"] },
-      },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_build_error",
-    description: "Log a build/compile error tagged to a blueprint.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        error: { type: "string", description: "Error message/description" },
-        bp: { type: "string", description: "Related blueprint name" },
-      },
-      required: ["project_id", "error"],
-    },
-  },
-  {
-    name: "taskovergg_fix_build_error",
-    description: "Mark a build error as fixed with a description of the fix.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        error_id: { type: "string" },
-        fix: { type: "string", description: "How the error was fixed" },
-      },
-      required: ["error_id"],
-    },
-  },
-
-  // --- Optimize Items ---
-  {
-    name: "taskovergg_get_optimize_items",
-    description: "Get optimization issues (unused assets, oversized files, performance problems).",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_optimize_item",
-    description: "Log an optimization issue with category and estimated savings.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        title: { type: "string" },
-        category: { type: "string", enum: ["unused", "textures", "meshes", "performance", "memory", "other"] },
-        status: { type: "string", enum: ["open", "fixed", "ok"] },
-        savings: { type: "string", description: "Estimated savings (e.g. '50MB', '15ms')" },
-      },
-      required: ["project_id", "title"],
-    },
-  },
-  {
-    name: "taskovergg_update_optimize_item",
-    description: "Update an optimization item's status or details.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        item_id: { type: "string" },
-        title: { type: "string" },
-        category: { type: "string" },
-        status: { type: "string", enum: ["open", "fixed", "ok"] },
-        savings: { type: "string" },
-      },
-      required: ["item_id"],
-    },
-  },
-
-  // --- Perf Budget ---
-  {
-    name: "taskovergg_get_perf_budget",
-    description: "Get performance budget readings (FPS, GPU, memory per scene).",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_perf_budget",
-    description: "Add a performance budget reading for a scene.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        scene: { type: "string" },
-        fps: { type: "number" },
-        gpu: { type: "number", description: "GPU usage percentage" },
-        memory: { type: "number", description: "Memory usage in MB" },
-        notes: { type: "string" },
-      },
-      required: ["project_id", "scene"],
-    },
-  },
-
-  // --- Playtests ---
-  {
-    name: "taskovergg_get_playtests",
-    description: "Get playtest sessions for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_playtest",
-    description: "Log a playtest session with rating, tester, issues, and build version.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        duration: { type: "string", description: "e.g. '45 min'" },
-        issues: { type: "array", items: { type: "string" } },
-        rating: { type: "number", description: "1-5 star rating" },
-        notes: { type: "string" },
-        tester: { type: "string" },
-        build_version: { type: "string" },
-      },
-      required: ["project_id"],
-    },
-  },
-
-  // --- Milestones ---
-  {
-    name: "taskovergg_get_milestones",
-    description: "Get project milestones/timeline.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_milestone",
-    description: "Add a project milestone with target date.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        title: { type: "string" },
-        date: { type: "string", description: "Target date (YYYY-MM-DD)" },
-        status: { type: "string", enum: ["upcoming", "active", "done", "missed"] },
-        notes: { type: "string" },
-      },
-      required: ["project_id", "title"],
-    },
-  },
-  {
-    name: "taskovergg_update_milestone",
-    description: "Update a milestone's status, date, or notes.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        milestone_id: { type: "string" },
-        title: { type: "string" },
-        date: { type: "string" },
-        status: { type: "string", enum: ["upcoming", "active", "done", "missed"] },
-        notes: { type: "string" },
-      },
-      required: ["milestone_id"],
-    },
-  },
-
-  // --- Iterations ---
-  {
-    name: "taskovergg_get_iterations",
-    description: "Get feature iteration history.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_iteration",
-    description: "Log a feature iteration (version change with reason).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        feature: { type: "string" },
-        version: { type: "string", description: "e.g. 'v2', 'v3'" },
-        change: { type: "string", description: "What changed" },
-        reason: { type: "string", description: "Why it changed" },
-      },
-      required: ["project_id", "feature"],
-    },
-  },
-
-  // --- Dialogues ---
-  {
-    name: "taskovergg_get_dialogues",
-    description: "Get NPC dialogue nodes for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_dialogue",
-    description: "Add an NPC dialogue node with choices and branching.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        npc: { type: "string" },
-        line: { type: "string", description: "Dialogue text" },
-        choices: { type: "array", items: { type: "string" } },
-        next_node: { type: "string", description: "Next dialogue node ID" },
-        notes: { type: "string" },
-      },
-      required: ["project_id", "npc"],
-    },
-  },
-  {
-    name: "taskovergg_update_dialogue",
-    description: "Update a dialogue node.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        dialogue_id: { type: "string" },
-        npc: { type: "string" },
-        line: { type: "string" },
-        choices: { type: "array", items: { type: "string" } },
-        next_node: { type: "string" },
-        notes: { type: "string" },
-      },
-      required: ["dialogue_id"],
-    },
-  },
-
-  // --- Sounds ---
-  {
-    name: "taskovergg_get_sounds",
-    description: "Get sound cues for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_sound",
-    description: "Track a sound cue with actor, trigger, and spatial settings.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        name: { type: "string" },
-        actor: { type: "string" },
-        trigger: { type: "string" },
-        spatial: { type: "boolean" },
-        attenuation: { type: "string" },
-        notes: { type: "string" },
-      },
-      required: ["project_id", "name"],
-    },
-  },
-  {
-    name: "taskovergg_update_sound",
-    description: "Update a sound cue's settings.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        sound_id: { type: "string" },
-        name: { type: "string" },
-        actor: { type: "string" },
-        trigger: { type: "string" },
-        spatial: { type: "boolean" },
-        attenuation: { type: "string" },
-        notes: { type: "string" },
-      },
-      required: ["sound_id"],
-    },
-  },
-
-  // --- Controls ---
-  {
-    name: "taskovergg_get_controls",
-    description: "Get input control bindings for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_control",
-    description: "Add an input control binding (key → action).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        key: { type: "string", description: "Input key/button" },
-        action: { type: "string", description: "Game action" },
-        context: { type: "string", description: "Input context (e.g. 'on foot', 'in vehicle')" },
-        condition: { type: "string" },
-      },
-      required: ["project_id", "key", "action"],
-    },
-  },
-  {
-    name: "taskovergg_update_control",
-    description: "Update a control binding.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        control_id: { type: "string" },
-        key: { type: "string" },
-        action: { type: "string" },
-        context: { type: "string" },
-        condition: { type: "string" },
-      },
-      required: ["control_id"],
-    },
-  },
-
-  // --- Assets ---
-  {
-    name: "taskovergg_get_assets",
-    description: "Get assets in the pipeline for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_asset",
-    description: "Track an asset in the pipeline with type, status, and usage.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        name: { type: "string" },
-        type: { type: "string", description: "Asset type (Mesh, Texture, Material, Sound, etc.)" },
-        path: { type: "string" },
-        size: { type: "string" },
-        status: { type: "string", enum: ["concept", "imported", "integrated", "tested", "final"] },
-        used_by: { type: "string" },
-      },
-      required: ["project_id", "name"],
-    },
-  },
-  {
-    name: "taskovergg_update_asset",
-    description: "Update an asset's status or details.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        asset_id: { type: "string" },
-        name: { type: "string" },
-        type: { type: "string" },
-        path: { type: "string" },
-        size: { type: "string" },
-        status: { type: "string", enum: ["concept", "imported", "integrated", "tested", "final"] },
-        used_by: { type: "string" },
-      },
-      required: ["asset_id"],
-    },
-  },
-
-  // --- References ---
-  {
-    name: "taskovergg_get_refs",
-    description: "Get reference/inspiration items for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_ref",
-    description: "Add a reference/inspiration item (game, art, video, article).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        title: { type: "string" },
-        type: { type: "string", enum: ["Game", "Art", "Video", "Article"] },
-        url: { type: "string" },
-        notes: { type: "string" },
-      },
-      required: ["project_id", "title"],
-    },
-  },
-
-  // --- Marketing ---
-  {
-    name: "taskovergg_get_marketing_items",
-    description: "Get marketing/launch prep items for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_marketing_item",
-    description: "Add a marketing/launch prep item (Steam page, trailer, social, press).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        item: { type: "string" },
-        category: { type: "string", enum: ["Steam", "Trailer", "Social", "Press"] },
-        status: { type: "string", enum: ["todo", "doing", "done"] },
-        notes: { type: "string" },
-      },
-      required: ["project_id", "item"],
-    },
-  },
-  {
-    name: "taskovergg_update_marketing_item",
-    description: "Update a marketing item's status or details.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        marketing_id: { type: "string" },
-        item: { type: "string" },
-        category: { type: "string" },
-        status: { type: "string", enum: ["todo", "doing", "done"] },
-        notes: { type: "string" },
-      },
-      required: ["marketing_id"],
-    },
-  },
-
-  // --- Wiki ---
-  {
-    name: "taskovergg_get_wiki_pages",
-    description: "Get internal wiki/knowledge base pages for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_wiki_page",
-    description: "Add a wiki/knowledge base page with category and content.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        title: { type: "string" },
-        category: { type: "string", enum: ["Systems", "Workflows", "Guides", "Reference"] },
-        content: { type: "string" },
-      },
-      required: ["project_id", "title"],
-    },
-  },
-  {
-    name: "taskovergg_update_wiki_page",
-    description: "Update a wiki page's title, category, or content.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        wiki_id: { type: "string" },
-        title: { type: "string" },
-        category: { type: "string" },
-        content: { type: "string" },
-      },
-      required: ["wiki_id"],
-    },
-  },
-
-  // --- Ship Readiness ---
-  {
-    name: "taskovergg_get_ship_checked",
-    description: "Get completed ship readiness checklist items for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_toggle_ship_check",
-    description: "Toggle a ship readiness checklist step as complete/incomplete.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        step_id: { type: "string", description: "Checklist step ID (e.g. 'p1s1', 'p2s3')" },
-      },
-      required: ["project_id", "step_id"],
-    },
-  },
-
-  // --- Open Questions ---
-  {
-    name: "taskovergg_get_open_questions",
-    description: "Get open design/development questions for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_open_question",
-    description: "Add an open question that needs answering.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        text: { type: "string" },
-      },
-      required: ["project_id", "text"],
-    },
-  },
-  {
-    name: "taskovergg_toggle_question",
-    description: "Toggle an open question as resolved/unresolved.",
-    inputSchema: {
-      type: "object",
-      properties: { question_id: { type: "string" } },
-      required: ["question_id"],
-    },
-  },
-
-  // --- Board Columns (Blocks) ---
-  {
-    name: "taskovergg_add_board_column",
-    description: "Add a new custom column (block) to the Kanban task board. Use this when the user asks to create a new block, column, or category on their task board. This does NOT create a task/card — it creates a new column that cards can be placed into.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        name: { type: "string", description: "The name/label for the new column (e.g. 'Review Later', 'Blocked', 'QA Testing')" },
-        color: { type: "string", description: "Hex color for the column dot (e.g. '#FDE68A'). Defaults to '#9B95A0' if not provided." },
-      },
-      required: ["name"],
-    },
-  },
-  // --- Stories (Narrative Bible) ---
-  {
-    name: "taskovergg_get_stories",
-    description: "Get all narrative bible / story sections for a project.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_story",
-    description: "Add a narrative bible section (synopsis, characters, lore, plot points, or endings).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        section_id: { type: "string", description: "Section key: s_synopsis, s_characters, s_lore, s_plot, s_endings" },
-        section: { type: "string", description: "Display label for the section" },
-        content: { type: "string", description: "Section content text" },
-      },
-      required: ["project_id", "section_id", "section"],
-    },
-  },
-  {
-    name: "taskovergg_update_story",
-    description: "Update a narrative bible story section's content.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        story_id: { type: "string" },
-        section: { type: "string" },
-        content: { type: "string" },
-      },
-      required: ["story_id"],
-    },
-  },
-  // --- Scenes ---
-  {
-    name: "taskovergg_get_scenes",
-    description: "Get all scenes for a project's narrative bible.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_scene",
-    description: "Add a new scene to a project's story.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        number: { type: "number", description: "Scene number" },
-        title: { type: "string" },
-        location: { type: "string" },
-        characters: { type: "array", items: { type: "string" }, description: "Character names in this scene" },
-        mood: { type: "string" },
-        round: { type: "string", description: "Story round/act (e.g. Intro, Act 1)" },
-        content: { type: "string" },
-      },
-      required: ["project_id", "title"],
-    },
-  },
-  {
-    name: "taskovergg_update_scene",
-    description: "Update a scene's fields.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        scene_id: { type: "string" },
-        number: { type: "number" },
-        title: { type: "string" },
-        location: { type: "string" },
-        characters: { type: "array", items: { type: "string" } },
-        mood: { type: "string" },
-        round: { type: "string" },
-        content: { type: "string" },
-      },
-      required: ["scene_id"],
-    },
-  },
-  {
-    name: "taskovergg_delete_scene",
-    description: "Delete a scene from the narrative bible.",
-    inputSchema: {
-      type: "object",
-      properties: { scene_id: { type: "string" } },
-      required: ["scene_id"],
-    },
-  },
-  // --- Story Bible (Story NEW tab — full project story data) ---
-  {
-    name: "taskovergg_get_story_bible",
-    description: "Get the full Story Bible for a project — includes title, logline, genre, tone, characters, chapters, scenes with word counts, and script. This is the primary tool for reading story data from the Story NEW writing environment.",
-    inputSchema: {
-      type: "object",
-      properties: { project_id: { type: "string" } },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_update_story_bible",
-    description: "Update the Story Bible metadata (title, logline, genre, tone, script).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        title: { type: "string" },
-        logline: { type: "string" },
-        genre: { type: "string" },
-        tone: { type: "string" },
-        script: { type: "string", description: "Full script/source material text" },
-      },
-      required: ["project_id"],
-    },
-  },
-  {
-    name: "taskovergg_add_story_character",
-    description: "Add a character to the Story Bible.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        name: { type: "string" },
-        role: { type: "string", description: "Character role: Player, Protagonist, Antagonist, NPC, Supporting, Mentioned" },
-        description: { type: "string" },
-      },
-      required: ["project_id", "name"],
-    },
-  },
-  {
-    name: "taskovergg_update_story_character",
-    description: "Update a character in the Story Bible.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        character_id: { type: "string" },
-        name: { type: "string" },
-        role: { type: "string" },
-        description: { type: "string" },
-      },
-      required: ["project_id", "character_id"],
-    },
-  },
-  {
-    name: "taskovergg_get_scene_content",
-    description: "Get the full content and details of a specific scene by ID.",
-    inputSchema: {
-      type: "object",
-      properties: { scene_id: { type: "string" } },
-      required: ["scene_id"],
-    },
-  },
-  {
-    name: "taskovergg_update_scene_content",
-    description: "Update a scene's fields in the Story NEW writing environment (title, location, mood, content, chapter, characters, objectives).",
-    inputSchema: {
-      type: "object",
-      properties: {
-        project_id: { type: "string" },
-        scene_id: { type: "string" },
-        title: { type: "string" },
-        location: { type: "string" },
-        mood: { type: "string" },
-        content: { type: "string", description: "Scene content (HTML supported)" },
-        round: { type: "string", description: "Chapter name this scene belongs to" },
-        characters: { type: "array", items: { type: "string" }, description: "Character IDs assigned to this scene" },
-        objectives: { type: "array", items: { type: "object", properties: { text: { type: "string" }, done: { type: "boolean" } } } },
-      },
-      required: ["project_id", "scene_id"],
-    },
-  },
-];
-
-// ===== REGISTER TOOLS =====
-
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return { tools: TOOLS };
-});
-
-// ===== PROJECT SCOPE GUARD =====
-// ===== HANDLE TOOL CALLS =====
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-
-  const mapping = toolMap[name];
-  if (!mapping) {
-    return { content: [{ type: "text", text: `Unknown tool: ${name}` }] };
-  }
-  if (!cloudAdapter.isAllowed(mapping.rpc)) {
-    return { content: [{ type: "text", text: `Method "${mapping.rpc}" is not available` }] };
-  }
-
-  // SECURITY: Schema validation -- strips unknown fields, checks required + types
-  const raw = args || {};
-  const { errors, cleaned } = validateSchema(raw, mapping.schema);
-  if (errors.length > 0) {
-    return { content: [{ type: "text", text: `Validation error: ${errors.join("; ")}` }] };
-  }
-
-  try {
-    const rpcArgs = mapping.args(cleaned, raw);
-    const result = await cloudAdapter.callRpc(mapping.rpc, rpcArgs);
-    return { content: [{ type: "text", text: typeof result === "string" ? result : JSON.stringify(result, null, 2) }] };
-  } catch (err) {
-    if (err.message === "AUTH_FAILED") {
-      console.error("[ERROR] Authentication failed. Shutting down.");
-      process.exit(1);
-    }
-    if (err.message.startsWith("RATE_LIMITED:")) {
-      const secs = err.message.split(":")[1];
-      return { content: [{ type: "text", text: `Rate limited. Try again in ${secs} seconds.` }] };
-    }
-    return { content: [{ type: "text", text: `Error: ${err.message}` }] };
-  }
-});
-
-
-// ===== START =====
-
-async function main() {
-  if (CLOUD_MODE) {
-    const check = await cloudAdapter.validateKey();
-    if (!check.valid) {
-      console.error(`[ERROR] ${check.error}`);
-      process.exit(1);
-    }
-    console.error("[CLOUD] Connected to api.taskover.gg (API key mode)");
-  } else {
-    try {
-      const hostType = process.env.TASKOVER_HOST_TYPE || "MCP";
-      const auth = await authFlow.authenticate(hostType);
-      cloudAdapter.initWithToken(auth.accessToken, auth.refreshToken);
-      if (auth.displayName) {
-        console.error(`[AUTH] Connected as ${auth.displayName}`);
-      } else {
-        console.error("[AUTH] Connected to api.taskover.gg");
-      }
-    } catch (err) {
-      console.error(`[ERROR] ${err.message}`);
-      console.error("[HINT] Set TASKOVER_API_KEY for headless/CI environments.");
-      process.exit(1);
-    }
-  }
-
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error("TaskOver MCP server running (stdio)");
-}
-
-main().catch((err) => {
-  // SECURITY: Never log secrets in crash output
-  const msg = err.message || String(err);
-  const redacted = msg
-    .replace(/tok_[a-zA-Z0-9]+/g, "tok_[REDACTED]")
-    .replace(/ht_[a-zA-Z0-9]+/g, "ht_[REDACTED]");
-  console.error(`[FATAL] ${redacted}`);
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const {
+  ListToolsRequestSchema,
+  CallToolRequestSchema,
+} = require("@modelcontextprotocol/sdk/types.js");
+
+// SECURITY: Mode selection -- cloud is the customer path, local is dev-only.
+// Priority: CLOUD > LOCAL > BROWSER_AUTH (default)
+const CLOUD_MODE = !!process.env.TASKOVER_API_KEY;
+const LOCAL_MODE = !CLOUD_MODE && process.env.TASKOVER_LOCAL === "1";
+const BROWSER_AUTH_MODE = !CLOUD_MODE && !LOCAL_MODE;
+
+if (LOCAL_MODE) {
+  console.error("[DEV] Using local SQLite database. Not for production use.");
+}
+
+// SECURITY: Refuse API key passed as CLI argument
+if (process.argv.some(arg => arg.startsWith("tok_"))) {
+  console.error("[SECURITY] API keys must not be passed as command-line arguments.");
+  console.error("Use the TASKOVER_API_KEY environment variable instead.");
+  process.exit(1);
+}
+
+let store, initDb, reloadFromDisk;
+let cloudAdapter, toolMap, validateSchema;
+let authFlow;
+
+if (CLOUD_MODE || BROWSER_AUTH_MODE) {
+  cloudAdapter = require("./cloud-adapter.js");
+  const tm = require("./tool-map.js");
+  toolMap = tm.TOOL_MAP;
+  validateSchema = tm.validateSchema;
+  if (CLOUD_MODE) {
+    cloudAdapter.init(process.env.TASKOVER_API_KEY);
+  }
+  if (BROWSER_AUTH_MODE) {
+    authFlow = require("./auth-flow.js");
+  }
+} else {
+  store = require("./data-store.js");
+  ({ initDb, reloadFromDisk } = require("./db"));
+}
+
+const server = new Server(
+  { name: "taskover.com", version: "1.0.0" },
+  { capabilities: { tools: {} } }
+);
+
+// ===== TOOL DEFINITIONS =====
+
+const TOOLS = [
+  // --- Dashboard & Context ---
+  {
+    name: "taskovergg_dashboard",
+    description: "Get full project dashboard: system counts, open bugs, task board, last session. Use at start of every new chat.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string", description: "Project ID (e.g. 'village', 'room-06')" },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_context_export",
+    description: "Generate full context dump — all systems, bugs, tasks, last session, decisions. Paste into new chats.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_search",
+    description: "Search across all project data — tasks, systems, sessions, bugs, blueprints, notes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        query: { type: "string", description: "Search term" },
+      },
+      required: ["project_id", "query"],
+    },
+  },
+
+  // --- Projects ---
+  {
+    name: "taskovergg_list_projects",
+    description: "List all projects.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "taskovergg_add_project",
+    description: `DO NOT call this tool directly. Projects must be created by the user on the TaskOver website.
+
+Instead of calling this tool, instruct the user with these steps:
+1. Go to taskover.com and log in
+2. Click the project dropdown in the top-left of the sidebar
+3. Click "+ New Project" at the bottom of the dropdown
+4. Follow the 5-step project creation wizard:
+   - Step 1: Enter the project name and description
+   - Step 2: Choose a project color/icon
+   - Step 3: Set up initial systems (or skip)
+   - Step 4: Configure project settings
+   - Step 5: Review and confirm
+5. Once the project appears in the project list, tell the AI the project name so it can begin adding tasks, systems, and other data to it via MCP.
+
+After the user confirms the project exists, use taskovergg_list_projects to find the project_id, then use other tools (taskovergg_add_task, taskovergg_add_system, etc.) to populate it.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string" },
+        description: { type: "string" },
+        trello_board_id: { type: "string" },
+      },
+      required: ["name"],
+    },
+  },
+
+  // --- Tasks (replaces To Do / Doing / Done / Scrapped) ---
+  {
+    name: "taskovergg_get_tasks",
+    description: "Get tasks filtered by status and/or phase. Statuses: todo, doing, done, scrapped.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        status: { type: "string", enum: ["todo", "doing", "done", "scrapped"] },
+        phase: { type: "string" },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_task",
+    description: "Add a task (idea, feature, to-do item).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        title: { type: "string" },
+        description: { type: "string" },
+        status: { type: "string", enum: ["todo", "doing", "done", "scrapped"] },
+        phase: { type: "string" },
+        priority: { type: "string", enum: ["high", "medium", "low"] },
+        tags: { type: "array", items: { type: "string" } },
+        checklist: { type: "array", items: { type: "object", properties: { text: { type: "string" }, done: { type: "boolean" } } } },
+      },
+      required: ["project_id", "title"],
+    },
+  },
+  {
+    name: "taskovergg_update_task",
+    description: "Update a task's fields.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        task_id: { type: "string" },
+        title: { type: "string" },
+        description: { type: "string" },
+        status: { type: "string", enum: ["todo", "doing", "done", "scrapped"] },
+        phase: { type: "string" },
+        priority: { type: "string", enum: ["high", "medium", "low"] },
+        tags: { type: "array", items: { type: "string" } },
+        checklist: { type: "array", items: { type: "object", properties: { text: { type: "string" }, done: { type: "boolean" } } } },
+      },
+      required: ["task_id"],
+    },
+  },
+  {
+    name: "taskovergg_move_task",
+    description: "Move task between columns (todo/doing/done/scrapped).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        task_id: { type: "string" },
+        status: { type: "string", enum: ["todo", "doing", "done", "scrapped"] },
+      },
+      required: ["task_id", "status"],
+    },
+  },
+  {
+    name: "taskovergg_add_task_comment",
+    description: "Add a comment to a task (replaces Trello card comments).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        task_id: { type: "string" },
+        text: { type: "string" },
+      },
+      required: ["task_id", "text"],
+    },
+  },
+
+  // --- Systems (replaces Claude Memory documentation cards) ---
+  {
+    name: "taskovergg_get_systems",
+    description: "Get all systems/features for a project with status, files, rules, notes.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_system",
+    description: "Document a new system/feature. Include critical rules and notes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        name: { type: "string" },
+        description: { type: "string" },
+        status: { type: "string", enum: ["working", "wip", "broken", "planned"] },
+        key_files: { type: "string" },
+        notes: { type: "string" },
+        critical_rules: { type: "string" },
+      },
+      required: ["project_id", "name"],
+    },
+  },
+  {
+    name: "taskovergg_update_system",
+    description: "Update a system's status, description, notes, or rules.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        system_id: { type: "string" },
+        name: { type: "string" },
+        description: { type: "string" },
+        status: { type: "string", enum: ["working", "wip", "broken", "planned"] },
+        key_files: { type: "string" },
+        notes: { type: "string" },
+        critical_rules: { type: "string" },
+      },
+      required: ["system_id"],
+    },
+  },
+
+  // --- Sessions (replaces Claude Chat Memory) ---
+  {
+    name: "taskovergg_get_sessions",
+    description: "Get recent work sessions with what was done and where we left off.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        limit: { type: "number" },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_log_session",
+    description: "Log a work session. Call at end of each chat (replaces !chatsave). Include what was done, where we left off, and next steps.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        title: { type: "string" },
+        summary: { type: "string" },
+        what_we_did: { type: "array", items: { type: "string" } },
+        where_we_left_off: { type: "string" },
+        next_steps: { type: "array", items: { type: "string" } },
+        systems_worked_on: { type: "array", items: { type: "string" } },
+      },
+      required: ["project_id", "title"],
+    },
+  },
+
+  // --- Changelog ---
+  {
+    name: "taskovergg_get_changelog",
+    description: "Get recent changelog entries.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        limit: { type: "number" },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_changelog",
+    description: "Log changes made. Include list of specific changes and affected systems.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        title: { type: "string" },
+        changes: { type: "array", items: { type: "string" } },
+        systems_affected: { type: "array", items: { type: "string" } },
+      },
+      required: ["project_id", "title", "changes"],
+    },
+  },
+
+  // --- Bugs ---
+  {
+    name: "taskovergg_get_bugs",
+    description: "Get bugs, optionally filtered by status (open/fixed/wontfix).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        status: { type: "string", enum: ["open", "fixed", "wontfix"] },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_bug",
+    description: "Report a bug with priority and steps to reproduce.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        system_id: { type: "string" },
+        title: { type: "string" },
+        description: { type: "string" },
+        priority: { type: "string", enum: ["high", "medium", "low"] },
+        steps_to_reproduce: { type: "string" },
+      },
+      required: ["project_id", "title"],
+    },
+  },
+  {
+    name: "taskovergg_fix_bug",
+    description: "Mark a bug as fixed with a description of the fix.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        bug_id: { type: "string" },
+        fix_description: { type: "string" },
+      },
+      required: ["bug_id"],
+    },
+  },
+
+  // --- Decisions ---
+  {
+    name: "taskovergg_get_decisions",
+    description: "Get design decisions for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_log_decision",
+    description: "Log a design decision with context and alternatives considered.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        decision: { type: "string" },
+        context: { type: "string" },
+        system_id: { type: "string" },
+        alternatives: { type: "string" },
+      },
+      required: ["project_id", "decision"],
+    },
+  },
+
+  // --- Blueprints ---
+  {
+    name: "taskovergg_get_blueprints",
+    description: "Get all registered Blueprints for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_blueprint",
+    description: "Register a Blueprint with path, parent class, variables, and key functions.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        name: { type: "string" },
+        path: { type: "string" },
+        parent_class: { type: "string" },
+        system_id: { type: "string" },
+        description: { type: "string" },
+        variables: { type: "array", items: { type: "string" } },
+        key_functions: { type: "array", items: { type: "string" } },
+      },
+      required: ["project_id", "name"],
+    },
+  },
+  {
+    name: "taskovergg_update_blueprint",
+    description: "Update a registered Blueprint.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        blueprint_id: { type: "string" },
+        name: { type: "string" },
+        path: { type: "string" },
+        parent_class: { type: "string" },
+        description: { type: "string" },
+        variables: { type: "array", items: { type: "string" } },
+        key_functions: { type: "array", items: { type: "string" } },
+      },
+      required: ["blueprint_id"],
+    },
+  },
+
+  // --- Blueprint Graphs ---
+  {
+    name: "taskovergg_get_blueprint_graphs",
+    description: "Get all visual diagram graphs for a blueprint, including nodes, connections, and layout.",
+    inputSchema: {
+      type: "object",
+      properties: { blueprint_id: { type: "string" } },
+      required: ["blueprint_id"],
+    },
+  },
+  {
+    name: "taskovergg_set_blueprint_graph",
+    description: "Set a complete visual diagram graph on a blueprint. Creates or replaces a named graph with nodes, pins, and connections.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        blueprint_id: { type: "string" },
+        graph_name: { type: "string", description: "Graph name, e.g. 'EventGraph'" },
+        graph_type: { type: "string", enum: ["event", "function", "macro"] },
+        nodes: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              id: { type: "string" }, type: { type: "string" }, title: { type: "string" },
+              subtitle: { type: "string" }, x: { type: "number" }, y: { type: "number" },
+              comment: { type: "string" }, pure: { type: "boolean" },
+              pins: { type: "array", items: { type: "object",
+                properties: { id: { type: "string" }, name: { type: "string" }, direction: { type: "string" }, type: { type: "string" } },
+                required: ["id", "name", "direction", "type"] } },
+            },
+            required: ["id", "type", "title", "x", "y", "pins"],
+          },
+        },
+        connections: {
+          type: "array",
+          items: { type: "object",
+            properties: { id: { type: "string" }, sourceNodeId: { type: "string" }, sourcePinId: { type: "string" }, targetNodeId: { type: "string" }, targetPinId: { type: "string" } },
+            required: ["id", "sourceNodeId", "sourcePinId", "targetNodeId", "targetPinId"] },
+        },
+      },
+      required: ["blueprint_id", "graph_name", "nodes", "connections"],
+    },
+  },
+  {
+    name: "taskovergg_add_graph_nodes",
+    description: "Add nodes and connections to an existing blueprint graph without replacing existing data.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        blueprint_id: { type: "string" },
+        graph_name: { type: "string" },
+        nodes: { type: "array", items: { type: "object" } },
+        connections: { type: "array", items: { type: "object" } },
+      },
+      required: ["blueprint_id", "graph_name"],
+    },
+  },
+
+  // --- Blueprint Intelligence ---
+  {
+    name: "taskovergg_sync_blueprint_data",
+    description: "Sync full Blueprint graph data from UE5 plugin. Pushes variables, functions, graphs with nodes/pins/connections. Max 50 BPs per call — chunk larger projects.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string", description: "Target project ID" },
+        schema_version: { type: "number", description: "Payload schema version (must be 1)" },
+        blueprints: {
+          type: "array",
+          description: "Array of blueprint data objects",
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string" }, path: { type: "string" },
+              parent_class: { type: "string" }, description: { type: "string" },
+              variables: { type: "array", items: { type: "object" } },
+              key_functions: { type: "array", items: { type: "object" } },
+              graphs: { type: "array", items: {
+                type: "object",
+                properties: {
+                  name: { type: "string" }, type: { type: "string" },
+                  nodes: { type: "array", items: { type: "object" } },
+                  connections: { type: "array", items: { type: "object" } },
+                },
+              }},
+            },
+            required: ["name", "path"],
+          },
+        },
+      },
+      required: ["project_id", "schema_version", "blueprints"],
+    },
+  },
+  {
+    name: "taskovergg_sync_debug",
+    description: "Get sync debug info for a project: last sync time, per-BP hash, node/connection counts, sync status.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_get_discovered_bp_detail",
+    description: "Get full detail for a discovered Blueprint including parsed graph data.",
+    inputSchema: {
+      type: "object",
+      properties: { blueprint_id: { type: "string" } },
+      required: ["blueprint_id"],
+    },
+  },
+  {
+    name: "taskovergg_blueprint_complexity",
+    description: "Get estimated complexity score (heuristic v1) for one blueprint or all blueprints in a project. Returns per-metric breakdown with data confidence level.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string", description: "Get health overview for entire project" },
+        blueprint_id: { type: "string", description: "Get complexity for specific blueprint" },
+      },
+    },
+  },
+  {
+    name: "taskovergg_blueprint_timeline",
+    description: "Get change history for a blueprint. Shows structural changes over time with diffs and summaries.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        blueprint_id: { type: "string" },
+        limit: { type: "number", description: "Max entries to return (default 20)" },
+        include_layout: { type: "boolean", description: "Include layout-only changes (default false)" },
+      },
+      required: ["blueprint_id"],
+    },
+  },
+  {
+    name: "taskovergg_blueprint_summary",
+    description: "Generate an auto-generated overview of a blueprint including execution paths, variables, and performance notes. This is a draft summary — verify against the actual Blueprint.",
+    inputSchema: {
+      type: "object",
+      properties: { blueprint_id: { type: "string" } },
+      required: ["blueprint_id"],
+    },
+  },
+  {
+    name: "taskovergg_blueprint_review",
+    description: "Run AI heuristic review on a blueprint. Returns findings (high-confidence warnings) and signals (informational hints). Checks for tick issues, cast chains, deep nesting, spaghetti, etc.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string", description: "Review all blueprints in project" },
+        blueprint_id: { type: "string", description: "Review single blueprint" },
+      },
+    },
+  },
+  {
+    name: "taskovergg_blueprint_standards",
+    description: "Manage blueprint coding standards for a project. Get standards list, toggle rules, or evaluate all blueprints against enabled standards.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        action: { type: "string", enum: ["get", "toggle", "evaluate"], description: "get=list standards, toggle=enable/disable a rule, evaluate=run all standards" },
+        rule_id: { type: "string", description: "For toggle action" },
+        enabled: { type: "boolean", description: "For toggle action" },
+      },
+      required: ["project_id", "action"],
+    },
+  },
+  {
+    name: "taskovergg_blueprint_impact",
+    description: "Analyze detected impact radius for a blueprint change. Shows which other blueprints reference this one via casts, variables, and function calls. Heuristic v1 — does not include C++, interfaces, or runtime connections.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        blueprint_id: { type: "string" },
+      },
+      required: ["project_id", "blueprint_id"],
+    },
+  },
+  {
+    name: "taskovergg_blueprint_dependencies",
+    description: "Build or retrieve the full blueprint dependency graph for a project. Shows cast, variable, and function references between blueprints.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+
+  // --- Notes ---
+  {
+    name: "taskovergg_get_notes",
+    description: "Get notes, optionally filtered by parent type (project/system/task/blueprint).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        parent_type: { type: "string", enum: ["project", "system", "task", "blueprint"] },
+        parent_id: { type: "string" },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_note",
+    description: "Add a note/document to the project or attached to a system/task/blueprint.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        parent_type: { type: "string", enum: ["project", "system", "task", "blueprint"] },
+        parent_id: { type: "string" },
+        title: { type: "string" },
+        content: { type: "string" },
+      },
+      required: ["project_id", "content"],
+    },
+  },
+
+  // --- Backups ---
+  {
+    name: "taskovergg_log_backup",
+    description: "Log that a project backup was created (replaces !backup).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        title: { type: "string" },
+        description: { type: "string" },
+      },
+      required: ["project_id"],
+    },
+  },
+
+  // --- Levels ---
+  {
+    name: "taskovergg_get_levels",
+    description: "Get all levels/scenes for a project with actors and status.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_level",
+    description: "Add a level/scene with name, map, and actor count.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        name: { type: "string" },
+        map: { type: "string", description: "Map/file path" },
+        actor_count: { type: "number" },
+        status: { type: "string", enum: ["planned", "wip", "testing", "done"] },
+      },
+      required: ["project_id", "name"],
+    },
+  },
+  {
+    name: "taskovergg_update_level",
+    description: "Update a level's status, name, map, or actor count.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        level_id: { type: "string" },
+        name: { type: "string" },
+        map: { type: "string" },
+        actor_count: { type: "number" },
+        status: { type: "string", enum: ["planned", "wip", "testing", "done"] },
+      },
+      required: ["level_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_actor",
+    description: "Add an actor to a level with XYZ coordinates.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        level_id: { type: "string" },
+        name: { type: "string" },
+        x: { type: "number" }, y: { type: "number" }, z: { type: "number" },
+        notes: { type: "string" },
+      },
+      required: ["level_id", "name"],
+    },
+  },
+  {
+    name: "taskovergg_remove_actor",
+    description: "Remove an actor from a level by index.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        level_id: { type: "string" },
+        actor_index: { type: "number" },
+      },
+      required: ["level_id", "actor_index"],
+    },
+  },
+
+  // --- Plugins ---
+  {
+    name: "taskovergg_get_plugins",
+    description: "Get all plugins/dependencies for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_plugin",
+    description: "Track a plugin/dependency with version and source.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        name: { type: "string" },
+        version: { type: "string" },
+        source: { type: "string", description: "Marketplace, GitHub, Custom, etc." },
+        dependents: { type: "array", items: { type: "string" } },
+      },
+      required: ["project_id", "name"],
+    },
+  },
+  {
+    name: "taskovergg_update_plugin",
+    description: "Update a plugin's version, source, or dependents.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        plugin_id: { type: "string" },
+        name: { type: "string" },
+        version: { type: "string" },
+        source: { type: "string" },
+        dependents: { type: "array", items: { type: "string" } },
+      },
+      required: ["plugin_id"],
+    },
+  },
+  {
+    name: "taskovergg_delete_plugin",
+    description: "Remove a plugin from the tracker.",
+    inputSchema: {
+      type: "object",
+      properties: { plugin_id: { type: "string" } },
+      required: ["plugin_id"],
+    },
+  },
+
+  // --- Build Errors ---
+  {
+    name: "taskovergg_get_build_errors",
+    description: "Get build/compile errors, optionally filtered by status (open/fixed).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        status: { type: "string", enum: ["open", "fixed"] },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_build_error",
+    description: "Log a build/compile error tagged to a blueprint.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        error: { type: "string", description: "Error message/description" },
+        bp: { type: "string", description: "Related blueprint name" },
+      },
+      required: ["project_id", "error"],
+    },
+  },
+  {
+    name: "taskovergg_fix_build_error",
+    description: "Mark a build error as fixed with a description of the fix.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        error_id: { type: "string" },
+        fix: { type: "string", description: "How the error was fixed" },
+      },
+      required: ["error_id"],
+    },
+  },
+
+  // --- Optimize Items ---
+  {
+    name: "taskovergg_get_optimize_items",
+    description: "Get optimization issues (unused assets, oversized files, performance problems).",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_optimize_item",
+    description: "Log an optimization issue with category and estimated savings.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        title: { type: "string" },
+        category: { type: "string", enum: ["unused", "textures", "meshes", "performance", "memory", "other"] },
+        status: { type: "string", enum: ["open", "fixed", "ok"] },
+        savings: { type: "string", description: "Estimated savings (e.g. '50MB', '15ms')" },
+      },
+      required: ["project_id", "title"],
+    },
+  },
+  {
+    name: "taskovergg_update_optimize_item",
+    description: "Update an optimization item's status or details.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        item_id: { type: "string" },
+        title: { type: "string" },
+        category: { type: "string" },
+        status: { type: "string", enum: ["open", "fixed", "ok"] },
+        savings: { type: "string" },
+      },
+      required: ["item_id"],
+    },
+  },
+
+  // --- Perf Budget ---
+  {
+    name: "taskovergg_get_perf_budget",
+    description: "Get performance budget readings (FPS, GPU, memory per scene).",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_perf_budget",
+    description: "Add a performance budget reading for a scene.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        scene: { type: "string" },
+        fps: { type: "number" },
+        gpu: { type: "number", description: "GPU usage percentage" },
+        memory: { type: "number", description: "Memory usage in MB" },
+        notes: { type: "string" },
+      },
+      required: ["project_id", "scene"],
+    },
+  },
+
+  // --- Playtests ---
+  {
+    name: "taskovergg_get_playtests",
+    description: "Get playtest sessions for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_playtest",
+    description: "Log a playtest session with rating, tester, issues, and build version.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        duration: { type: "string", description: "e.g. '45 min'" },
+        issues: { type: "array", items: { type: "string" } },
+        rating: { type: "number", description: "1-5 star rating" },
+        notes: { type: "string" },
+        tester: { type: "string" },
+        build_version: { type: "string" },
+      },
+      required: ["project_id"],
+    },
+  },
+
+  // --- Milestones ---
+  {
+    name: "taskovergg_get_milestones",
+    description: "Get project milestones/timeline.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_milestone",
+    description: "Add a project milestone with target date.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        title: { type: "string" },
+        date: { type: "string", description: "Target date (YYYY-MM-DD)" },
+        status: { type: "string", enum: ["upcoming", "active", "done", "missed"] },
+        notes: { type: "string" },
+      },
+      required: ["project_id", "title"],
+    },
+  },
+  {
+    name: "taskovergg_update_milestone",
+    description: "Update a milestone's status, date, or notes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        milestone_id: { type: "string" },
+        title: { type: "string" },
+        date: { type: "string" },
+        status: { type: "string", enum: ["upcoming", "active", "done", "missed"] },
+        notes: { type: "string" },
+      },
+      required: ["milestone_id"],
+    },
+  },
+
+  // --- Iterations ---
+  {
+    name: "taskovergg_get_iterations",
+    description: "Get feature iteration history.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_iteration",
+    description: "Log a feature iteration (version change with reason).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        feature: { type: "string" },
+        version: { type: "string", description: "e.g. 'v2', 'v3'" },
+        change: { type: "string", description: "What changed" },
+        reason: { type: "string", description: "Why it changed" },
+      },
+      required: ["project_id", "feature"],
+    },
+  },
+
+  // --- Dialogues ---
+  {
+    name: "taskovergg_get_dialogues",
+    description: "Get NPC dialogue nodes for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_dialogue",
+    description: "Add an NPC dialogue node with choices and branching.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        npc: { type: "string" },
+        line: { type: "string", description: "Dialogue text" },
+        choices: { type: "array", items: { type: "string" } },
+        next_node: { type: "string", description: "Next dialogue node ID" },
+        notes: { type: "string" },
+      },
+      required: ["project_id", "npc"],
+    },
+  },
+  {
+    name: "taskovergg_update_dialogue",
+    description: "Update a dialogue node.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        dialogue_id: { type: "string" },
+        npc: { type: "string" },
+        line: { type: "string" },
+        choices: { type: "array", items: { type: "string" } },
+        next_node: { type: "string" },
+        notes: { type: "string" },
+      },
+      required: ["dialogue_id"],
+    },
+  },
+
+  // --- Sounds ---
+  {
+    name: "taskovergg_get_sounds",
+    description: "Get sound cues for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_sound",
+    description: "Track a sound cue with actor, trigger, and spatial settings.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        name: { type: "string" },
+        actor: { type: "string" },
+        trigger: { type: "string" },
+        spatial: { type: "boolean" },
+        attenuation: { type: "string" },
+        notes: { type: "string" },
+      },
+      required: ["project_id", "name"],
+    },
+  },
+  {
+    name: "taskovergg_update_sound",
+    description: "Update a sound cue's settings.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sound_id: { type: "string" },
+        name: { type: "string" },
+        actor: { type: "string" },
+        trigger: { type: "string" },
+        spatial: { type: "boolean" },
+        attenuation: { type: "string" },
+        notes: { type: "string" },
+      },
+      required: ["sound_id"],
+    },
+  },
+
+  // --- Controls ---
+  {
+    name: "taskovergg_get_controls",
+    description: "Get input control bindings for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_control",
+    description: "Add an input control binding (key → action).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        key: { type: "string", description: "Input key/button" },
+        action: { type: "string", description: "Game action" },
+        context: { type: "string", description: "Input context (e.g. 'on foot', 'in vehicle')" },
+        condition: { type: "string" },
+      },
+      required: ["project_id", "key", "action"],
+    },
+  },
+  {
+    name: "taskovergg_update_control",
+    description: "Update a control binding.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        control_id: { type: "string" },
+        key: { type: "string" },
+        action: { type: "string" },
+        context: { type: "string" },
+        condition: { type: "string" },
+      },
+      required: ["control_id"],
+    },
+  },
+
+  // --- Assets ---
+  {
+    name: "taskovergg_get_assets",
+    description: "Get assets in the pipeline for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_asset",
+    description: "Track an asset in the pipeline with type, status, and usage.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        name: { type: "string" },
+        type: { type: "string", description: "Asset type (Mesh, Texture, Material, Sound, etc.)" },
+        path: { type: "string" },
+        size: { type: "string" },
+        status: { type: "string", enum: ["concept", "imported", "integrated", "tested", "final"] },
+        used_by: { type: "string" },
+      },
+      required: ["project_id", "name"],
+    },
+  },
+  {
+    name: "taskovergg_update_asset",
+    description: "Update an asset's status or details.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        asset_id: { type: "string" },
+        name: { type: "string" },
+        type: { type: "string" },
+        path: { type: "string" },
+        size: { type: "string" },
+        status: { type: "string", enum: ["concept", "imported", "integrated", "tested", "final"] },
+        used_by: { type: "string" },
+      },
+      required: ["asset_id"],
+    },
+  },
+
+  // --- References ---
+  {
+    name: "taskovergg_get_refs",
+    description: "Get reference/inspiration items for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_ref",
+    description: "Add a reference/inspiration item (game, art, video, article).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        title: { type: "string" },
+        type: { type: "string", enum: ["Game", "Art", "Video", "Article"] },
+        url: { type: "string" },
+        notes: { type: "string" },
+      },
+      required: ["project_id", "title"],
+    },
+  },
+
+  // --- Marketing ---
+  {
+    name: "taskovergg_get_marketing_items",
+    description: "Get marketing/launch prep items for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_marketing_item",
+    description: "Add a marketing/launch prep item (Steam page, trailer, social, press).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        item: { type: "string" },
+        category: { type: "string", enum: ["Steam", "Trailer", "Social", "Press"] },
+        status: { type: "string", enum: ["todo", "doing", "done"] },
+        notes: { type: "string" },
+      },
+      required: ["project_id", "item"],
+    },
+  },
+  {
+    name: "taskovergg_update_marketing_item",
+    description: "Update a marketing item's status or details.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        marketing_id: { type: "string" },
+        item: { type: "string" },
+        category: { type: "string" },
+        status: { type: "string", enum: ["todo", "doing", "done"] },
+        notes: { type: "string" },
+      },
+      required: ["marketing_id"],
+    },
+  },
+
+  // --- Wiki ---
+  {
+    name: "taskovergg_get_wiki_pages",
+    description: "Get internal wiki/knowledge base pages for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_wiki_page",
+    description: "Add a wiki/knowledge base page with category and content.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        title: { type: "string" },
+        category: { type: "string", enum: ["Systems", "Workflows", "Guides", "Reference"] },
+        content: { type: "string" },
+      },
+      required: ["project_id", "title"],
+    },
+  },
+  {
+    name: "taskovergg_update_wiki_page",
+    description: "Update a wiki page's title, category, or content.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        wiki_id: { type: "string" },
+        title: { type: "string" },
+        category: { type: "string" },
+        content: { type: "string" },
+      },
+      required: ["wiki_id"],
+    },
+  },
+
+  // --- Ship Readiness ---
+  {
+    name: "taskovergg_get_ship_checked",
+    description: "Get completed ship readiness checklist items for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_toggle_ship_check",
+    description: "Toggle a ship readiness checklist step as complete/incomplete.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        step_id: { type: "string", description: "Checklist step ID (e.g. 'p1s1', 'p2s3')" },
+      },
+      required: ["project_id", "step_id"],
+    },
+  },
+
+  // --- Open Questions ---
+  {
+    name: "taskovergg_get_open_questions",
+    description: "Get open design/development questions for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_open_question",
+    description: "Add an open question that needs answering.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        text: { type: "string" },
+      },
+      required: ["project_id", "text"],
+    },
+  },
+  {
+    name: "taskovergg_toggle_question",
+    description: "Toggle an open question as resolved/unresolved.",
+    inputSchema: {
+      type: "object",
+      properties: { question_id: { type: "string" } },
+      required: ["question_id"],
+    },
+  },
+
+  // --- Board Columns (Blocks) ---
+  {
+    name: "taskovergg_add_board_column",
+    description: "Add a new custom column (block) to the Kanban task board. Use this when the user asks to create a new block, column, or category on their task board. This does NOT create a task/card — it creates a new column that cards can be placed into.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "The name/label for the new column (e.g. 'Review Later', 'Blocked', 'QA Testing')" },
+        color: { type: "string", description: "Hex color for the column dot (e.g. '#FDE68A'). Defaults to '#9B95A0' if not provided." },
+      },
+      required: ["name"],
+    },
+  },
+  // --- Stories (Narrative Bible) ---
+  {
+    name: "taskovergg_get_stories",
+    description: "Get all narrative bible / story sections for a project.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_story",
+    description: "Add a narrative bible section (synopsis, characters, lore, plot points, or endings).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        section_id: { type: "string", description: "Section key: s_synopsis, s_characters, s_lore, s_plot, s_endings" },
+        section: { type: "string", description: "Display label for the section" },
+        content: { type: "string", description: "Section content text" },
+      },
+      required: ["project_id", "section_id", "section"],
+    },
+  },
+  {
+    name: "taskovergg_update_story",
+    description: "Update a narrative bible story section's content.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        story_id: { type: "string" },
+        section: { type: "string" },
+        content: { type: "string" },
+      },
+      required: ["story_id"],
+    },
+  },
+  // --- Scenes ---
+  {
+    name: "taskovergg_get_scenes",
+    description: "Get all scenes for a project's narrative bible.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_scene",
+    description: "Add a new scene to a project's story.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        number: { type: "number", description: "Scene number" },
+        title: { type: "string" },
+        location: { type: "string" },
+        characters: { type: "array", items: { type: "string" }, description: "Character names in this scene" },
+        mood: { type: "string" },
+        round: { type: "string", description: "Story round/act (e.g. Intro, Act 1)" },
+        content: { type: "string" },
+      },
+      required: ["project_id", "title"],
+    },
+  },
+  {
+    name: "taskovergg_update_scene",
+    description: "Update a scene's fields.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        scene_id: { type: "string" },
+        number: { type: "number" },
+        title: { type: "string" },
+        location: { type: "string" },
+        characters: { type: "array", items: { type: "string" } },
+        mood: { type: "string" },
+        round: { type: "string" },
+        content: { type: "string" },
+      },
+      required: ["scene_id"],
+    },
+  },
+  {
+    name: "taskovergg_delete_scene",
+    description: "Delete a scene from the narrative bible.",
+    inputSchema: {
+      type: "object",
+      properties: { scene_id: { type: "string" } },
+      required: ["scene_id"],
+    },
+  },
+  // --- Story Bible (Story NEW tab — full project story data) ---
+  {
+    name: "taskovergg_get_story_bible",
+    description: "Get the full Story Bible for a project — includes title, logline, genre, tone, characters, chapters, scenes with word counts, and script. This is the primary tool for reading story data from the Story NEW writing environment.",
+    inputSchema: {
+      type: "object",
+      properties: { project_id: { type: "string" } },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_update_story_bible",
+    description: "Update the Story Bible metadata (title, logline, genre, tone, script).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        title: { type: "string" },
+        logline: { type: "string" },
+        genre: { type: "string" },
+        tone: { type: "string" },
+        script: { type: "string", description: "Full script/source material text" },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "taskovergg_add_story_character",
+    description: "Add a character to the Story Bible.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        name: { type: "string" },
+        role: { type: "string", description: "Character role: Player, Protagonist, Antagonist, NPC, Supporting, Mentioned" },
+        description: { type: "string" },
+      },
+      required: ["project_id", "name"],
+    },
+  },
+  {
+    name: "taskovergg_update_story_character",
+    description: "Update a character in the Story Bible.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        character_id: { type: "string" },
+        name: { type: "string" },
+        role: { type: "string" },
+        description: { type: "string" },
+      },
+      required: ["project_id", "character_id"],
+    },
+  },
+  {
+    name: "taskovergg_get_scene_content",
+    description: "Get the full content and details of a specific scene by ID.",
+    inputSchema: {
+      type: "object",
+      properties: { scene_id: { type: "string" } },
+      required: ["scene_id"],
+    },
+  },
+  {
+    name: "taskovergg_update_scene_content",
+    description: "Update a scene's fields in the Story NEW writing environment (title, location, mood, content, chapter, characters, objectives).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string" },
+        scene_id: { type: "string" },
+        title: { type: "string" },
+        location: { type: "string" },
+        mood: { type: "string" },
+        content: { type: "string", description: "Scene content (HTML supported)" },
+        round: { type: "string", description: "Chapter name this scene belongs to" },
+        characters: { type: "array", items: { type: "string" }, description: "Character IDs assigned to this scene" },
+        objectives: { type: "array", items: { type: "object", properties: { text: { type: "string" }, done: { type: "boolean" } } } },
+      },
+      required: ["project_id", "scene_id"],
+    },
+  },
+];
+
+// ===== REGISTER TOOLS =====
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return { tools: TOOLS };
+});
+
+// ===== PROJECT SCOPE GUARD =====
+const EXEMPT_TOOLS = new Set(["taskovergg_list_projects", "taskovergg_add_project"]);
+
+function getActiveProject() {
+  return store.getSetting("active_project");
+}
+
+// ===== HANDLE TOOL CALLS =====
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  // ── Cloud/Browser-auth mode: validate schema, then route through cloud adapter ──
+  if (CLOUD_MODE || BROWSER_AUTH_MODE) {
+    const mapping = toolMap[name];
+    if (!mapping) {
+      return { content: [{ type: "text", text: `Unknown tool: ${name}` }] };
+    }
+    if (!cloudAdapter.isAllowed(mapping.rpc)) {
+      return { content: [{ type: "text", text: `Method "${mapping.rpc}" is not available in cloud mode` }] };
+    }
+
+    // SECURITY: Schema validation -- strips unknown fields, checks required + types
+    const raw = args || {};
+    const { errors, cleaned } = validateSchema(raw, mapping.schema);
+    if (errors.length > 0) {
+      return { content: [{ type: "text", text: `Validation error: ${errors.join("; ")}` }] };
+    }
+
+    try {
+      const rpcArgs = mapping.args(cleaned, raw);
+      const result = await cloudAdapter.callRpc(mapping.rpc, rpcArgs);
+      return { content: [{ type: "text", text: typeof result === "string" ? result : JSON.stringify(result, null, 2) }] };
+    } catch (err) {
+      // Boot grace: MCP host auto-called a tool before the user did anything.
+      // Return a passive, non-alarming message — no browser popup was opened.
+      if (err.message && err.message.startsWith("AUTH_NOT_READY:")) {
+        const detail = err.message.slice("AUTH_NOT_READY:".length);
+        return {
+          content: [{
+            type: "text",
+            text: detail
+          }],
+        };
+      }
+      // JIT auth: auth was declined, timed out, or failed after browser flow.
+      // The held-request already waited — this is a final failure, user must retry.
+      if (err.message && err.message.startsWith("AUTH_FAILED_RETRY:")) {
+        const detail = err.message.slice("AUTH_FAILED_RETRY:".length);
+        return {
+          content: [{
+            type: "text",
+            text: `Authorization required. ${detail} Please try your request again.`
+          }],
+          isError: true,
+        };
+      }
+      // Hard auth failure (invalid API key in CLOUD_MODE)
+      if (err.message === "AUTH_FAILED") {
+        return {
+          content: [{
+            type: "text",
+            text: "Authorization failed. Your API key or session is invalid. Check your TASKOVER_API_KEY or restart the MCP server."
+          }],
+          isError: true,
+        };
+      }
+      if (err.message.startsWith("RATE_LIMITED:")) {
+        const secs = err.message.split(":")[1];
+        return { content: [{ type: "text", text: `Rate limited. Try again in ${secs} seconds.` }] };
+      }
+      return { content: [{ type: "text", text: `Error: ${err.message}` }] };
+    }
+  }
+
+  // ── Local mode: existing switch/case block (unchanged) ──
+
+  // Reload database from disk so we pick up changes made by the Electron app
+  reloadFromDisk();
+
+  // Auto-resolve project_id: if a tool needs a project_id, use the active project from TaskOver
+  if (!EXEMPT_TOOLS.has(name)) {
+    const activeProject = getActiveProject();
+    if (activeProject) {
+      // Always use the active project — no guessing needed from the AI
+      args.project_id = activeProject;
+    }
+  }
+
+  try {
+    let result;
+
+    switch (name) {
+      // Dashboard & Context
+      case "taskovergg_dashboard":
+        result = store.dashboard(args.project_id);
+        break;
+      case "taskovergg_context_export":
+        result = store.contextExport(args.project_id);
+        break;
+      case "taskovergg_search":
+        result = store.search(args.project_id, args.query);
+        break;
+
+      // Projects
+      case "taskovergg_list_projects":
+        result = store.listProjects();
+        break;
+      case "taskovergg_add_project":
+        result = {
+          error: "Projects must be created on the TaskOver website — not via MCP.",
+          instructions: [
+            "1. Go to taskover.com and log in",
+            "2. Click the project dropdown in the top-left of the sidebar",
+            "3. Click '+ New Project' at the bottom of the dropdown",
+            "4. Follow the 5-step project creation wizard (name, color/icon, systems, settings, review)",
+            "5. Once the project appears in the list, come back and tell me the project name",
+            "6. I'll then use taskovergg_list_projects to get the project_id and start adding tasks, systems, etc."
+          ],
+          hint: "After the user creates the project, use taskovergg_list_projects to find the project_id."
+        };
+        break;
+
+      // Tasks
+      case "taskovergg_get_tasks":
+        result = store.getTasks(args.project_id, args.status, args.phase);
+        break;
+      case "taskovergg_add_task": {
+        const DEFAULT_STATUSES = new Set(["todo", "doing", "done", "scrapped"]);
+        const taskStatus = (args.status || "todo").toLowerCase();
+
+        // If the status matches a custom column, add as a card to that column instead
+        if (!DEFAULT_STATUSES.has(taskStatus) && args.project_id) {
+          const proj = store.getProject(args.project_id);
+          const customCols = proj?.customBoardCols || [];
+          const matchCol = customCols.find(cc =>
+            cc.name.toLowerCase() === taskStatus ||
+            cc.tag === taskStatus ||
+            String(cc.id) === taskStatus
+          );
+          if (matchCol) {
+            const newCard = {
+              id: Date.now(),
+              title: args.title,
+              description: args.description || "",
+              priority: args.priority || "medium",
+              tags: args.tags || [],
+              createdBy: "Assistant",
+              createdAt: new Date().toISOString(),
+            };
+            const updCols = customCols.map(cc =>
+              String(cc.id) === String(matchCol.id) ? { ...cc, cards: [...(cc.cards || []), newCard] } : cc
+            );
+            store.updateProjectField(args.project_id, "customBoardCols", updCols);
+            result = { ...newCard, column: matchCol.name };
+            break;
+          }
+        }
+
+        result = store.addTask({
+          projectId: args.project_id, title: args.title, description: args.description,
+          status: args.status, phase: args.phase, priority: args.priority,
+          tags: args.tags, checklist: args.checklist, createdBy: "Assistant",
+        });
+        break;
+      }
+      case "taskovergg_update_task":
+        if (!args.task_id) { result = { error: "task_id is required" }; break; }
+        result = store.updateTask(args.task_id, {
+          title: args.title, description: args.description, status: args.status,
+          phase: args.phase, priority: args.priority, tags: args.tags, checklist: args.checklist,
+        });
+        if (!result) { result = { error: `Task not found: ${args.task_id}` }; }
+        break;
+      case "taskovergg_move_task":
+        result = store.moveTask(args.task_id, args.status);
+        break;
+      case "taskovergg_add_task_comment":
+        result = store.addTaskComment(args.task_id, args.text);
+        break;
+
+      // Systems
+      case "taskovergg_get_systems":
+        result = store.getSystems(args.project_id);
+        break;
+      case "taskovergg_add_system":
+        result = store.addSystem({
+          projectId: args.project_id, name: args.name, description: args.description,
+          status: args.status, keyFiles: args.key_files, notes: args.notes,
+          criticalRules: args.critical_rules,
+        });
+        break;
+      case "taskovergg_update_system":
+        result = store.updateSystem(args.system_id, {
+          name: args.name, description: args.description, status: args.status,
+          keyFiles: args.key_files, notes: args.notes, criticalRules: args.critical_rules,
+        });
+        break;
+
+      // Sessions
+      case "taskovergg_get_sessions":
+        result = store.getSessions(args.project_id, args.limit);
+        break;
+      case "taskovergg_log_session":
+        result = store.logSession({
+          projectId: args.project_id, title: args.title, summary: args.summary,
+          whatWeDid: args.what_we_did, whereWeLeftOff: args.where_we_left_off,
+          nextSteps: args.next_steps, systemsWorkedOn: args.systems_worked_on,
+        });
+        break;
+
+      // Changelog
+      case "taskovergg_get_changelog":
+        result = store.getChangelog(args.project_id, args.limit);
+        break;
+      case "taskovergg_add_changelog":
+        result = store.addChangelog({
+          projectId: args.project_id, title: args.title,
+          changes: args.changes, systemsAffected: args.systems_affected,
+        });
+        break;
+
+      // Bugs
+      case "taskovergg_get_bugs":
+        result = store.getBugs(args.project_id, args.status);
+        break;
+      case "taskovergg_add_bug":
+        result = store.addBug({
+          projectId: args.project_id, systemId: args.system_id, title: args.title,
+          description: args.description, priority: args.priority,
+          stepsToReproduce: args.steps_to_reproduce,
+        });
+        break;
+      case "taskovergg_fix_bug":
+        result = store.fixBug(args.bug_id, args.fix_description);
+        break;
+
+      // Decisions
+      case "taskovergg_get_decisions":
+        result = store.getDecisions(args.project_id);
+        break;
+      case "taskovergg_log_decision":
+        result = store.logDecision({
+          projectId: args.project_id, decision: args.decision, context: args.context,
+          systemId: args.system_id, alternatives: args.alternatives,
+        });
+        break;
+
+      // Blueprints
+      case "taskovergg_get_blueprints":
+        result = store.getBlueprints(args.project_id);
+        break;
+      case "taskovergg_add_blueprint":
+        result = store.addBlueprint({
+          projectId: args.project_id, name: args.name, path: args.path,
+          parentClass: args.parent_class, systemId: args.system_id,
+          description: args.description, variables: args.variables,
+          keyFunctions: args.key_functions,
+        });
+        break;
+      case "taskovergg_update_blueprint":
+        result = store.updateBlueprint(args.blueprint_id, {
+          name: args.name, path: args.path, parentClass: args.parent_class,
+          description: args.description, variables: args.variables,
+          keyFunctions: args.key_functions,
+        });
+        break;
+
+      // Blueprint Graphs
+      case "taskovergg_get_blueprint_graphs":
+        result = store.getBlueprintGraphs(args.blueprint_id);
+        break;
+      case "taskovergg_set_blueprint_graph":
+        result = store.setBlueprintGraph(args.blueprint_id, {
+          name: args.graph_name, type: args.graph_type || "event",
+          nodes: args.nodes, connections: args.connections,
+        });
+        break;
+      case "taskovergg_add_graph_nodes":
+        result = store.addGraphNodes(args.blueprint_id, args.graph_name, {
+          nodes: args.nodes || [], connections: args.connections || [],
+        });
+        break;
+
+      // Blueprint Intelligence
+      case "taskovergg_sync_blueprint_data":
+        result = store.syncDiscoveredBps(args.project_id, args.blueprints, args.schema_version);
+        break;
+      case "taskovergg_sync_debug":
+        result = store.getSyncDebugInfo(args.project_id);
+        break;
+      case "taskovergg_get_discovered_bp_detail":
+        result = store.getDiscoveredBpDetail(args.blueprint_id);
+        break;
+      case "taskovergg_blueprint_complexity":
+        if (args.blueprint_id) {
+          result = store.computeBlueprintComplexity(args.blueprint_id);
+        } else if (args.project_id) {
+          result = store.computeBlueprintHealth(args.project_id);
+        } else {
+          result = { error: "Provide either project_id or blueprint_id" };
+        }
+        break;
+      case "taskovergg_blueprint_timeline":
+        result = store.getBlueprintTimeline(args.blueprint_id, args.limit, args.include_layout);
+        break;
+      case "taskovergg_blueprint_summary":
+        result = store.generateBlueprintSummary(args.blueprint_id);
+        break;
+      case "taskovergg_blueprint_review":
+        if (args.blueprint_id) {
+          result = store.computeBlueprintReview(args.blueprint_id);
+        } else if (args.project_id) {
+          result = store.computeProjectBlueprintReview(args.project_id);
+        } else {
+          result = { error: "Provide either project_id or blueprint_id" };
+        }
+        break;
+      case "taskovergg_blueprint_standards":
+        if (args.action === "get") {
+          result = store.getBlueprintStandards(args.project_id);
+        } else if (args.action === "toggle") {
+          result = store.toggleBlueprintStandard(args.project_id, args.rule_id, args.enabled);
+        } else if (args.action === "evaluate") {
+          result = store.evaluateBlueprintStandards(args.project_id);
+        } else {
+          result = { error: "Unknown action. Use: get, toggle, evaluate" };
+        }
+        break;
+      case "taskovergg_blueprint_impact":
+        result = store.computeImpactAnalysis(args.project_id, args.blueprint_id);
+        break;
+      case "taskovergg_blueprint_dependencies":
+        result = store.buildBlueprintDependencyGraph(args.project_id);
+        break;
+
+      // Notes
+      case "taskovergg_get_notes":
+        result = store.getNotes(args.project_id, args.parent_type, args.parent_id);
+        break;
+      case "taskovergg_add_note":
+        result = store.addNote({
+          projectId: args.project_id, parentType: args.parent_type,
+          parentId: args.parent_id, title: args.title, content: args.content,
+        });
+        break;
+
+      // Backups
+      case "taskovergg_log_backup":
+        result = store.logBackup({
+          projectId: args.project_id, title: args.title, description: args.description,
+        });
+        break;
+
+      // Levels
+      case "taskovergg_get_levels":
+        result = store.getLevels(args.project_id);
+        break;
+      case "taskovergg_add_level":
+        result = store.addLevel({
+          projectId: args.project_id, name: args.name, map: args.map,
+          actorCount: args.actor_count, status: args.status,
+        });
+        break;
+      case "taskovergg_update_level":
+        result = store.updateLevel(args.level_id, {
+          name: args.name, map: args.map, actorCount: args.actor_count, status: args.status,
+        });
+        break;
+      case "taskovergg_add_actor":
+        result = store.addActor(args.level_id, {
+          name: args.name, x: args.x, y: args.y, z: args.z, notes: args.notes,
+        });
+        break;
+      case "taskovergg_remove_actor":
+        result = store.removeActor(args.level_id, args.actor_index);
+        break;
+
+      // Plugins
+      case "taskovergg_get_plugins":
+        result = store.getPlugins(args.project_id);
+        break;
+      case "taskovergg_add_plugin":
+        result = store.addPlugin({
+          projectId: args.project_id, name: args.name, version: args.version,
+          source: args.source, dependents: args.dependents,
+        });
+        break;
+      case "taskovergg_update_plugin":
+        result = store.updatePlugin(args.plugin_id, {
+          name: args.name, version: args.version, source: args.source, dependents: args.dependents,
+        });
+        break;
+      case "taskovergg_delete_plugin":
+        result = store.deletePlugin(args.plugin_id);
+        break;
+
+      // Build Errors
+      case "taskovergg_get_build_errors":
+        result = store.getBuildErrors(args.project_id, args.status);
+        break;
+      case "taskovergg_add_build_error":
+        result = store.addBuildError({
+          projectId: args.project_id, error: args.error, bp: args.bp,
+        });
+        break;
+      case "taskovergg_fix_build_error":
+        result = store.fixBuildError(args.error_id, args.fix);
+        break;
+
+      // Optimize Items
+      case "taskovergg_get_optimize_items":
+        result = store.getOptimizeItems(args.project_id);
+        break;
+      case "taskovergg_add_optimize_item":
+        result = store.addOptimizeItem({
+          projectId: args.project_id, title: args.title, category: args.category,
+          status: args.status, savings: args.savings,
+        });
+        break;
+      case "taskovergg_update_optimize_item":
+        result = store.updateOptimizeItem(args.item_id, {
+          title: args.title, category: args.category, status: args.status, savings: args.savings,
+        });
+        break;
+
+      // Perf Budget
+      case "taskovergg_get_perf_budget":
+        result = store.getPerfBudget(args.project_id);
+        break;
+      case "taskovergg_add_perf_budget":
+        result = store.addPerfBudget({
+          projectId: args.project_id, scene: args.scene, fps: args.fps,
+          gpu: args.gpu, memory: args.memory, notes: args.notes,
+        });
+        break;
+
+      // Playtests
+      case "taskovergg_get_playtests":
+        result = store.getPlaytests(args.project_id);
+        break;
+      case "taskovergg_add_playtest":
+        result = store.addPlaytest({
+          projectId: args.project_id, duration: args.duration, issues: args.issues,
+          rating: args.rating, notes: args.notes, tester: args.tester,
+          buildVersion: args.build_version,
+        });
+        break;
+
+      // Milestones
+      case "taskovergg_get_milestones":
+        result = store.getMilestones(args.project_id);
+        break;
+      case "taskovergg_add_milestone":
+        result = store.addMilestone({
+          projectId: args.project_id, title: args.title, date: args.date,
+          status: args.status, notes: args.notes,
+        });
+        break;
+      case "taskovergg_update_milestone":
+        result = store.updateMilestone(args.milestone_id, {
+          title: args.title, date: args.date, status: args.status, notes: args.notes,
+        });
+        break;
+
+      // Iterations
+      case "taskovergg_get_iterations":
+        result = store.getIterations(args.project_id);
+        break;
+      case "taskovergg_add_iteration":
+        result = store.addIteration({
+          projectId: args.project_id, feature: args.feature, version: args.version,
+          change: args.change, reason: args.reason,
+        });
+        break;
+
+      // Dialogues
+      case "taskovergg_get_dialogues":
+        result = store.getDialogues(args.project_id);
+        break;
+      case "taskovergg_add_dialogue":
+        result = store.addDialogue({
+          projectId: args.project_id, npc: args.npc, line: args.line,
+          choices: args.choices, nextNode: args.next_node, notes: args.notes,
+        });
+        break;
+      case "taskovergg_update_dialogue":
+        result = store.updateDialogue(args.dialogue_id, {
+          npc: args.npc, line: args.line, choices: args.choices,
+          nextNode: args.next_node, notes: args.notes,
+        });
+        break;
+
+      // Sounds
+      case "taskovergg_get_sounds":
+        result = store.getSounds(args.project_id);
+        break;
+      case "taskovergg_add_sound":
+        result = store.addSound({
+          projectId: args.project_id, name: args.name, actor: args.actor,
+          trigger: args.trigger, spatial: args.spatial, attenuation: args.attenuation,
+          notes: args.notes,
+        });
+        break;
+      case "taskovergg_update_sound":
+        result = store.updateSound(args.sound_id, {
+          name: args.name, actor: args.actor, trigger: args.trigger,
+          spatial: args.spatial, attenuation: args.attenuation, notes: args.notes,
+        });
+        break;
+
+      // Controls
+      case "taskovergg_get_controls":
+        result = store.getControls(args.project_id);
+        break;
+      case "taskovergg_add_control":
+        result = store.addControl({
+          projectId: args.project_id, key: args.key, action: args.action,
+          context: args.context, condition: args.condition,
+        });
+        break;
+      case "taskovergg_update_control":
+        result = store.updateControl(args.control_id, {
+          key: args.key, action: args.action, context: args.context, condition: args.condition,
+        });
+        break;
+
+      // Assets
+      case "taskovergg_get_assets":
+        result = store.getAssets(args.project_id);
+        break;
+      case "taskovergg_add_asset":
+        result = store.addAsset({
+          projectId: args.project_id, name: args.name, type: args.type,
+          path: args.path, size: args.size, status: args.status, usedBy: args.used_by,
+        });
+        break;
+      case "taskovergg_update_asset":
+        result = store.updateAsset(args.asset_id, {
+          name: args.name, type: args.type, path: args.path,
+          size: args.size, status: args.status, usedBy: args.used_by,
+        });
+        break;
+
+      // References
+      case "taskovergg_get_refs":
+        result = store.getRefs(args.project_id);
+        break;
+      case "taskovergg_add_ref":
+        result = store.addRef({
+          projectId: args.project_id, title: args.title, type: args.type,
+          url: args.url, notes: args.notes,
+        });
+        break;
+
+      // Marketing
+      case "taskovergg_get_marketing_items":
+        result = store.getMarketingItems(args.project_id);
+        break;
+      case "taskovergg_add_marketing_item":
+        result = store.addMarketingItem({
+          projectId: args.project_id, item: args.item, category: args.category,
+          status: args.status, notes: args.notes,
+        });
+        break;
+      case "taskovergg_update_marketing_item":
+        result = store.updateMarketingItem(args.marketing_id, {
+          item: args.item, category: args.category, status: args.status, notes: args.notes,
+        });
+        break;
+
+      // Wiki
+      case "taskovergg_get_wiki_pages":
+        result = store.getWikiPages(args.project_id);
+        break;
+      case "taskovergg_add_wiki_page":
+        result = store.addWikiPage({
+          projectId: args.project_id, title: args.title, category: args.category,
+          content: args.content,
+        });
+        break;
+      case "taskovergg_update_wiki_page":
+        result = store.updateWikiPage(args.wiki_id, {
+          title: args.title, category: args.category, content: args.content,
+        });
+        break;
+
+      // Ship Readiness
+      case "taskovergg_get_ship_checked":
+        result = store.getShipChecked(args.project_id);
+        break;
+      case "taskovergg_toggle_ship_check":
+        result = store.toggleShipCheck(args.project_id, args.step_id);
+        break;
+
+      // Open Questions
+      case "taskovergg_get_open_questions":
+        result = store.getOpenQuestions(args.project_id);
+        break;
+      case "taskovergg_add_open_question":
+        result = store.addOpenQuestion({
+          projectId: args.project_id, text: args.text,
+        });
+        break;
+      case "taskovergg_toggle_question":
+        result = store.toggleQuestion(args.question_id);
+        break;
+
+      // Board Columns (Blocks)
+      case "taskovergg_add_board_column": {
+        const pid = args.project_id;
+        if (!pid) { result = { error: "No active project" }; break; }
+        const proj = store.getProject(pid);
+        if (!proj) { result = { error: `Project not found: ${pid}` }; break; }
+        const newCol = {
+          id: Date.now(),
+          name: args.name,
+          color: args.color || "#9B95A0",
+          tag: args.name.toLowerCase().replace(/[^a-z0-9]+/g, "-"),
+          cards: [],
+        };
+        const existingCols = proj.customBoardCols || [];
+        store.updateProjectField(pid, "customBoardCols", [...existingCols, newCol]);
+        result = newCol;
+        break;
+      }
+
+      // Stories (Narrative Bible)
+      case "taskovergg_get_stories":
+        result = store.getStories(args.project_id);
+        break;
+      case "taskovergg_add_story":
+        result = store.addStory({
+          projectId: args.project_id, sectionId: args.section_id,
+          section: args.section, content: args.content,
+        });
+        break;
+      case "taskovergg_update_story":
+        result = store.updateStory(args.story_id, {
+          section: args.section, content: args.content,
+        });
+        break;
+
+      // Scenes
+      case "taskovergg_get_scenes":
+        result = store.getScenes(args.project_id);
+        break;
+      case "taskovergg_add_scene":
+        result = store.addScene({
+          projectId: args.project_id, number: args.number, title: args.title,
+          location: args.location, characters: args.characters,
+          mood: args.mood, round: args.round, content: args.content,
+        });
+        break;
+      case "taskovergg_update_scene":
+        result = store.updateScene(args.scene_id, {
+          number: args.number, title: args.title, location: args.location,
+          characters: args.characters, mood: args.mood, round: args.round, content: args.content,
+        });
+        break;
+      case "taskovergg_delete_scene":
+        result = store.deleteScene(args.scene_id);
+        break;
+
+      // Story Bible (Story NEW tab)
+      case "taskovergg_get_story_bible":
+        result = store.getStoryBible(args.project_id);
+        break;
+      case "taskovergg_update_story_bible":
+        result = store.updateStoryBible(args.project_id, {
+          title: args.title, logline: args.logline, genre: args.genre,
+          tone: args.tone, script: args.script,
+        });
+        break;
+      case "taskovergg_add_story_character":
+        result = store.addStoryCharacter(args.project_id, {
+          name: args.name, role: args.role, description: args.description,
+        });
+        break;
+      case "taskovergg_update_story_character":
+        result = store.updateStoryCharacter(args.project_id, args.character_id, {
+          name: args.name, role: args.role, description: args.description,
+        });
+        break;
+      case "taskovergg_get_scene_content":
+        result = store.getSceneContent(args.scene_id);
+        break;
+      case "taskovergg_update_scene_content":
+        result = store.updateSceneContent(args.project_id, args.scene_id, {
+          title: args.title, location: args.location, mood: args.mood,
+          content: args.content, round: args.round,
+          characters: args.characters, objectives: args.objectives,
+        });
+        break;
+
+      default:
+        return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
+    }
+
+    return {
+      content: [{
+        type: "text",
+        text: typeof result === "string" ? result : JSON.stringify(result, null, 2),
+      }],
+    };
+
+  } catch (err) {
+    return {
+      content: [{ type: "text", text: `Error: ${err && err.message ? err.message : String(err)}` }],
+      isError: true,
+    };
+  }
+});
+
+// ===== START =====
+
+const MCP_TRANSPORT = (process.env.MCP_TRANSPORT || "stdio").toLowerCase();
+const MCP_PORT = parseInt(process.env.MCP_PORT || "8484", 10);
+
+async function startStdio() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("TaskOver MCP server running (stdio)");
+}
+
+async function startHttp() {
+  const http = require("http");
+  const { randomUUID } = require("crypto");
+  const { StreamableHTTPServerTransport } = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+
+  const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: () => randomUUID(),
+  });
+  await server.connect(transport);
+
+  const httpServer = http.createServer(async (req, res) => {
+    // Only bind to /mcp endpoint
+    const url = req.url.split("?")[0];
+    if (url === "/mcp") {
+      await transport.handleRequest(req, res);
+    } else if (url === "/health") {
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ status: "ok", transport: "http", tools: TOOLS.length }));
+    } else {
+      res.writeHead(404);
+      res.end("Not found");
+    }
+  });
+
+  httpServer.listen(MCP_PORT, "127.0.0.1", () => {
+    console.error(`TaskOver MCP server running (http) on http://127.0.0.1:${MCP_PORT}/mcp`);
+  });
+}
+
+async function main() {
+  if (CLOUD_MODE) {
+    const check = await cloudAdapter.validateKey();
+    if (!check.valid) {
+      console.error(`[ERROR] ${check.error}`);
+      process.exit(1);
+    }
+    console.error("[CLOUD] Connected to api.taskover.gg (API key mode)");
+  } else if (BROWSER_AUTH_MODE) {
+    // JIT auth: try loading cached tokens silently, but never force browser auth at startup.
+    // If no cached tokens, the server boots unauthenticated. Auth happens on first tool use.
+    const authGate = require("./auth-gate.js");
+    const hasCached = await authGate.tryLoadCachedTokens();
+    if (hasCached) {
+      console.error("[AUTH] Ready (cached credentials loaded)");
+    } else {
+      console.error("[AUTH] Ready (will authenticate on first tool use)");
+    }
+  } else {
+    await initDb();
+  }
+
+  if (MCP_TRANSPORT === "http" || MCP_TRANSPORT === "sse") {
+    await startHttp();
+  } else {
+    await startStdio();
+  }
+}
+
+main().catch((err) => {
+  // SECURITY: Never log secrets in crash output
+  const msg = err.message || String(err);
+  const redacted = msg
+    .replace(/tok_[a-zA-Z0-9]+/g, "tok_[REDACTED]")
+    .replace(/ht_[a-zA-Z0-9]+/g, "ht_[REDACTED]");
+  console.error(`[FATAL] ${redacted}`);
+  process.exit(1);
+});