taskover-mcp 1.0.1 → 1.2.0

package/publish/index.js

@@ -0,0 +1,1433 @@
+#!/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);
+});