taskover-mcp 1.0.1 → 1.2.0

package/publish/tool-map.js

@@ -0,0 +1,1146 @@
+// mcp-server/tool-map.js
+// Maps MCP tool names to cloud RPC method names, argument builders, and schemas.
+//
+// SECURITY: Only tools whose rpc method is in cloud-adapter's MCP_ALLOWED_METHODS will work.
+// This file defines the mapping shape + schema -- the allowlist is enforced in cloud-adapter.js.
+//
+// IMPORTANT: Every mapping was verified against the actual RPC_REGISTRY in server.js.
+// Do NOT add speculative mappings. If a method doesn't exist in the RPC registry,
+// it must be added to server.js first (see Task 1).
+//
+// Schema validation runs BEFORE the RPC call. Unknown fields are stripped.
+// Required fields cause an error if missing. Types are checked loosely (string, number, boolean, array, object).
+
+// ── Schema helpers ──
+
+function validateSchema(args, schema) {
+  const errors = [];
+  const cleaned = {};
+
+  // Check required fields
+  for (const field of (schema.required || [])) {
+    if (args[field] === undefined || args[field] === null) {
+      errors.push(`Missing required field: ${field}`);
+    }
+  }
+
+  // Copy allowed fields only (required + optional), with type checks
+  const allFields = { ...(schema.fields || {}) };
+  for (const [field, type] of Object.entries(allFields)) {
+    if (args[field] !== undefined && args[field] !== null) {
+      if (type && !checkType(args[field], type)) {
+        errors.push(`Field "${field}" must be ${type}, got ${typeof args[field]}`);
+      } else {
+        cleaned[field] = args[field];
+      }
+    }
+  }
+
+  // SECURITY: Unknown fields are silently dropped -- never forwarded to RPC
+  return { errors, cleaned };
+}
+
+function checkType(value, type) {
+  if (type === "string") return typeof value === "string";
+  if (type === "number") return typeof value === "number";
+  if (type === "boolean") return typeof value === "boolean";
+  if (type === "array") return Array.isArray(value);
+  if (type === "object") return typeof value === "object" && !Array.isArray(value) && value !== null;
+  if (type === "any") return true;
+  return true; // unknown type = allow
+}
+
+// ── Tool mappings ──
+// Each entry:
+//   rpc: string          -- RPC method name (must be in cloud-adapter allowlist)
+//   schema: object       -- { required: string[], fields: { name: type } }
+//   args: (cleaned, raw) -- builds the RPC args array from validated+cleaned fields
+//                           `raw` is passed for fields like project_id that are always
+//                           present but not part of the "update" object
+//
+// For update methods, the `schema` defines the UPDATABLE fields only.
+// The record ID and project ID come from `raw` (the original MCP args).
+
+const TOOL_MAP = {
+
+  // ── Dashboard & context ──
+
+  taskovergg_dashboard: {
+    rpc: "dashboard",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_context_export: {
+    rpc: "contextExport",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_search: {
+    rpc: "search",
+    schema: { required: ["project_id", "query"], fields: { project_id: "string", query: "string" } },
+    args: (c, r) => [r.project_id, r.query],
+  },
+  taskovergg_list_projects: {
+    rpc: "listProjects",
+    schema: { required: [], fields: {} },
+    args: () => [],
+  },
+
+  // ── Tasks ──
+
+  taskovergg_get_tasks: {
+    rpc: "getTasks",
+    schema: {
+      required: ["project_id"],
+      fields: { project_id: "string", status: "string", phase: "string" },
+    },
+    args: (c, r) => [r.project_id, r.status, r.phase],
+  },
+  taskovergg_add_task: {
+    rpc: "addTask",
+    schema: {
+      required: ["project_id", "title"],
+      fields: {
+        project_id: "string", title: "string", description: "string",
+        status: "string", phase: "string", priority: "string",
+        tags: "string", checklist: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    // NOTE: createdBy is intentionally HARDCODED and excluded from schema.fields.
+    // The RPC accepts it (matrix write allowlist), but the MCP tool does not expose it
+    // to callers. This prevents callers from impersonating other authors.
+    args: (c, r) => [{
+      projectId: r.project_id, title: c.title, description: c.description,
+      status: c.status || "todo", phase: c.phase, priority: c.priority || "medium",
+      tags: c.tags, checklist: c.checklist, createdBy: "Assistant",
+    }],
+  },
+  taskovergg_update_task: {
+    rpc: "updateTask",
+    schema: {
+      required: ["task_id"],
+      fields: {
+        task_id: "string", project_id: "string",
+        title: "string", description: "string", status: "string",
+        phase: "string", priority: "string", tags: "string", checklist: "string",
+      },
+    },
+    // SECURITY: explicit field allowlist -- only these fields are forwarded as updates
+    // REVISED per M0: record:tasks ownership — no projectId in args
+    args: (c, r) => [r.task_id, {
+      ...(c.title !== undefined && { title: c.title }),
+      ...(c.description !== undefined && { description: c.description }),
+      ...(c.status !== undefined && { status: c.status }),
+      ...(c.phase !== undefined && { phase: c.phase }),
+      ...(c.priority !== undefined && { priority: c.priority }),
+      ...(c.tags !== undefined && { tags: c.tags }),
+      ...(c.checklist !== undefined && { checklist: c.checklist }),
+    }],
+  },
+  taskovergg_move_task: {
+    rpc: "moveTask",
+    schema: {
+      required: ["task_id", "status"],
+      fields: { task_id: "string", project_id: "string", status: "string" },
+    },
+    // REVISED per M0: record:tasks ownership — [taskId, status]
+    args: (c, r) => [r.task_id, r.status],
+  },
+  taskovergg_add_task_comment: {
+    rpc: "addTaskComment",
+    schema: {
+      required: ["task_id", "text"],
+      fields: { task_id: "string", project_id: "string", text: "string" },
+    },
+    // REVISED per M0: record:tasks ownership — [taskId, text] (not wrapped in object)
+    args: (c, r) => [r.task_id, c.text],
+  },
+
+  // ── Systems ──
+
+  taskovergg_get_systems: {
+    rpc: "getSystems",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_system: {
+    rpc: "addSystem",
+    schema: {
+      required: ["project_id", "name"],
+      fields: {
+        project_id: "string", name: "string", description: "string",
+        status: "string", key_files: "string", notes: "string", critical_rules: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, name: c.name, description: c.description,
+      status: c.status || "planned", keyFiles: c.key_files, notes: c.notes,
+      criticalRules: c.critical_rules,
+    }],
+  },
+  taskovergg_update_system: {
+    rpc: "updateSystem",
+    schema: {
+      required: ["system_id"],
+      fields: {
+        system_id: "string", project_id: "string",
+        name: "string", description: "string", status: "string",
+        key_files: "string", notes: "string", critical_rules: "string",
+      },
+    },
+    // REVISED per M0: record:systems ownership — no projectId in args
+    args: (c, r) => [r.system_id, {
+      ...(c.name !== undefined && { name: c.name }),
+      ...(c.description !== undefined && { description: c.description }),
+      ...(c.status !== undefined && { status: c.status }),
+      ...(c.key_files !== undefined && { keyFiles: c.key_files }),
+      ...(c.notes !== undefined && { notes: c.notes }),
+      ...(c.critical_rules !== undefined && { criticalRules: c.critical_rules }),
+    }],
+  },
+
+  // ── Sessions ──
+
+  taskovergg_get_sessions: {
+    rpc: "getSessions",
+    schema: {
+      required: ["project_id"],
+      fields: { project_id: "string", limit: "number" },
+    },
+    args: (c, r) => [r.project_id, r.limit],
+  },
+  taskovergg_log_session: {
+    rpc: "logSession",
+    schema: {
+      required: ["project_id", "title"],
+      fields: {
+        project_id: "string", title: "string", summary: "string",
+        what_we_did: "string", where_we_left_off: "string",
+        next_steps: "string", systems_worked_on: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, title: c.title, summary: c.summary,
+      whatWeDid: c.what_we_did, whereWeLeftOff: c.where_we_left_off,
+      nextSteps: c.next_steps, systemsWorkedOn: c.systems_worked_on,
+    }],
+  },
+
+  // ── Changelog ──
+
+  taskovergg_get_changelog: {
+    rpc: "getChangelog",
+    schema: {
+      required: ["project_id"],
+      fields: { project_id: "string", limit: "number" },
+    },
+    args: (c, r) => [r.project_id, r.limit],
+  },
+  taskovergg_add_changelog: {
+    rpc: "addChangelog",
+    schema: {
+      required: ["project_id", "title", "changes"],
+      fields: {
+        project_id: "string", title: "string",
+        changes: "string", systems_affected: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, title: c.title, changes: c.changes,
+      systemsAffected: c.systems_affected,
+    }],
+  },
+
+  // ── Bugs ──
+
+  taskovergg_get_bugs: {
+    rpc: "getBugs",
+    schema: {
+      required: ["project_id"],
+      fields: { project_id: "string", status: "string" },
+    },
+    args: (c, r) => [r.project_id, r.status],
+  },
+  taskovergg_add_bug: {
+    rpc: "addBug",
+    schema: {
+      required: ["project_id", "title"],
+      fields: {
+        project_id: "string", title: "string", system_id: "string",
+        description: "string", priority: "string", steps_to_reproduce: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, systemId: c.system_id, title: c.title,
+      description: c.description, priority: c.priority,
+      stepsToReproduce: c.steps_to_reproduce,
+    }],
+  },
+  taskovergg_fix_bug: {
+    rpc: "fixBug",
+    schema: {
+      required: ["bug_id"],
+      fields: { bug_id: "string", project_id: "string", fix_description: "string" },
+    },
+    // REVISED per M0: record:bugs ownership — [bugId, fixDescription]
+    args: (c, r) => [r.bug_id, c.fix_description],
+  },
+
+  // ── Decisions ──
+
+  taskovergg_get_decisions: {
+    rpc: "getDecisions",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_log_decision: {
+    rpc: "logDecision",
+    schema: {
+      required: ["project_id", "decision"],
+      fields: {
+        project_id: "string", decision: "string", context: "string",
+        system_id: "string", alternatives: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, decision: c.decision, context: c.context,
+      systemId: c.system_id, alternatives: c.alternatives,
+    }],
+  },
+
+  // ── Blueprints ──
+
+  taskovergg_get_blueprints: {
+    rpc: "getBlueprints",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_blueprint: {
+    rpc: "addBlueprint",
+    schema: {
+      required: ["project_id", "name"],
+      fields: {
+        project_id: "string", name: "string", path: "string",
+        parent_class: "string", system_id: "string", description: "string",
+        variables: "string", key_functions: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, name: c.name, path: c.path,
+      parentClass: c.parent_class, systemId: c.system_id,
+      description: c.description, variables: c.variables,
+      keyFunctions: c.key_functions,
+    }],
+  },
+  taskovergg_update_blueprint: {
+    rpc: "updateBlueprint",
+    schema: {
+      required: ["blueprint_id"],
+      fields: {
+        blueprint_id: "string", project_id: "string",
+        name: "string", path: "string", parent_class: "string",
+        description: "string", variables: "string", key_functions: "string",
+      },
+    },
+    // REVISED per M0: record:blueprints ownership — no projectId in args
+    args: (c, r) => [r.blueprint_id, {
+      ...(c.name !== undefined && { name: c.name }),
+      ...(c.path !== undefined && { path: c.path }),
+      ...(c.parent_class !== undefined && { parentClass: c.parent_class }),
+      ...(c.description !== undefined && { description: c.description }),
+      ...(c.variables !== undefined && { variables: c.variables }),
+      ...(c.key_functions !== undefined && { keyFunctions: c.key_functions }),
+    }],
+  },
+  // REMOVED per M0: taskovergg_get_blueprint_graphs — DEFERRED (ANOMALY-1: ownership mismatch)
+  // REMOVED per M0: taskovergg_set_blueprint_graph — DEFERRED (ANOMALY-1: ownership mismatch)
+  // REMOVED per M0: taskovergg_add_graph_nodes — DEFERRED (ANOMALY-1: ownership mismatch)
+  // Unblock path: fix RPC registry project:true → record:"blueprints" for all 3 methods
+
+  // ── Notes ──
+
+  taskovergg_get_notes: {
+    rpc: "getNotes",
+    schema: {
+      required: ["project_id"],
+      fields: { project_id: "string", parent_type: "string", parent_id: "string" },
+    },
+    args: (c, r) => [r.project_id, r.parent_type, r.parent_id],
+  },
+  taskovergg_add_note: {
+    rpc: "addNote",
+    schema: {
+      required: ["project_id", "content"],
+      fields: {
+        project_id: "string", content: "string",
+        parent_type: "string", parent_id: "string", title: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, parentType: c.parent_type,
+      parentId: c.parent_id, title: c.title, content: c.content,
+    }],
+  },
+
+  // ── Backups ──
+
+  taskovergg_log_backup: {
+    rpc: "logBackup",
+    schema: {
+      required: ["project_id"],
+      fields: { project_id: "string", title: "string", description: "string" },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{ projectId: r.project_id, title: c.title, description: c.description }],
+  },
+
+  // ── Levels ──
+
+  taskovergg_get_levels: {
+    rpc: "getLevels",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_level: {
+    rpc: "addLevel",
+    schema: {
+      required: ["project_id", "name"],
+      fields: {
+        project_id: "string", name: "string",
+        map: "string", actor_count: "number", status: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, name: c.name, map: c.map,
+      actorCount: c.actor_count, status: c.status,
+    }],
+  },
+  taskovergg_update_level: {
+    rpc: "updateLevel",
+    schema: {
+      required: ["level_id"],
+      fields: {
+        level_id: "string", project_id: "string",
+        name: "string", map: "string", actor_count: "number", status: "string",
+      },
+    },
+    // REVISED per M0: record:levels ownership — no projectId in args
+    args: (c, r) => [r.level_id, {
+      ...(c.name !== undefined && { name: c.name }),
+      ...(c.map !== undefined && { map: c.map }),
+      ...(c.actor_count !== undefined && { actorCount: c.actor_count }),
+      ...(c.status !== undefined && { status: c.status }),
+    }],
+  },
+  taskovergg_add_actor: {
+    rpc: "addActor",
+    schema: {
+      required: ["level_id", "name"],
+      fields: {
+        level_id: "string", project_id: "string", name: "string",
+        x: "number", y: "number", z: "number", notes: "string",
+      },
+    },
+    // REVISED per M0: record:levels ownership — [levelId, actorData]
+    args: (c, r) => [r.level_id, {
+      name: c.name, x: c.x, y: c.y, z: c.z, notes: c.notes,
+    }],
+  },
+  taskovergg_remove_actor: {
+    rpc: "removeActor",
+    schema: {
+      required: ["level_id", "actor_index"],
+      fields: { level_id: "string", project_id: "string", actor_index: "number" },
+    },
+    // REVISED per M0: record:levels ownership — [levelId, actorIndex]
+    args: (c, r) => [r.level_id, r.actor_index],
+  },
+
+  // ── Plugins ──
+
+  taskovergg_get_plugins: {
+    rpc: "getPlugins",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_plugin: {
+    rpc: "addPlugin",
+    schema: {
+      required: ["project_id", "name"],
+      fields: {
+        project_id: "string", name: "string",
+        version: "string", source: "string", dependents: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, name: c.name, version: c.version,
+      source: c.source, dependents: c.dependents,
+    }],
+  },
+  taskovergg_update_plugin: {
+    rpc: "updatePlugin",
+    schema: {
+      required: ["plugin_id"],
+      fields: {
+        plugin_id: "string", project_id: "string",
+        name: "string", version: "string", source: "string", dependents: "string",
+      },
+    },
+    // REVISED per M0: record:plugins ownership — no projectId in args
+    args: (c, r) => [r.plugin_id, {
+      ...(c.name !== undefined && { name: c.name }),
+      ...(c.version !== undefined && { version: c.version }),
+      ...(c.source !== undefined && { source: c.source }),
+      ...(c.dependents !== undefined && { dependents: c.dependents }),
+    }],
+  },
+  // taskovergg_delete_plugin -- DEFERRED: delete ops blocked in beta
+
+  // ── Build Errors ──
+
+  taskovergg_get_build_errors: {
+    rpc: "getBuildErrors",
+    schema: {
+      required: ["project_id"],
+      fields: { project_id: "string", status: "string" },
+    },
+    args: (c, r) => [r.project_id, r.status],
+  },
+  taskovergg_add_build_error: {
+    rpc: "addBuildError",
+    schema: {
+      required: ["project_id", "error"],
+      fields: { project_id: "string", error: "string", bp: "string" },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{ projectId: r.project_id, error: c.error, bp: c.bp }],
+  },
+  taskovergg_fix_build_error: {
+    rpc: "fixBuildError",
+    schema: {
+      required: ["error_id"],
+      fields: { error_id: "string", project_id: "string", fix: "string" },
+    },
+    // REVISED per M0: record:build_errors ownership — [errorId, fix]
+    args: (c, r) => [r.error_id, c.fix],
+  },
+
+  // ── Optimize ──
+
+  taskovergg_get_optimize_items: {
+    rpc: "getOptimizeItems",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_optimize_item: {
+    rpc: "addOptimizeItem",
+    schema: {
+      required: ["project_id", "title"],
+      fields: {
+        project_id: "string", title: "string",
+        category: "string", status: "string", savings: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, title: c.title, category: c.category,
+      status: c.status, savings: c.savings,
+    }],
+  },
+  taskovergg_update_optimize_item: {
+    rpc: "updateOptimizeItem",
+    schema: {
+      required: ["item_id"],
+      fields: {
+        item_id: "string", project_id: "string",
+        title: "string", category: "string", status: "string", savings: "string",
+      },
+    },
+    // REVISED per M0: record:optimize_items — no projectId in args
+    args: (c, r) => [r.item_id, {
+      ...(c.title !== undefined && { title: c.title }),
+      ...(c.category !== undefined && { category: c.category }),
+      ...(c.status !== undefined && { status: c.status }),
+      ...(c.savings !== undefined && { savings: c.savings }),
+    }],
+  },
+
+  // ── Perf Budget ──
+
+  taskovergg_get_perf_budget: {
+    rpc: "getPerfBudget",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_perf_budget: {
+    rpc: "addPerfBudget",
+    schema: {
+      required: ["project_id", "scene"],
+      fields: {
+        project_id: "string", scene: "string",
+        fps: "string", gpu: "string", memory: "string", notes: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, scene: c.scene, fps: c.fps,
+      gpu: c.gpu, memory: c.memory, notes: c.notes,
+    }],
+  },
+
+  // ── Playtests ──
+
+  taskovergg_get_playtests: {
+    rpc: "getPlaytests",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_playtest: {
+    rpc: "addPlaytest",
+    schema: {
+      required: ["project_id"],
+      fields: {
+        project_id: "string", duration: "string", issues: "string",
+        rating: "number", notes: "string", tester: "string", build_version: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, duration: c.duration, issues: c.issues,
+      rating: c.rating, notes: c.notes, tester: c.tester,
+      buildVersion: c.build_version,
+    }],
+  },
+
+  // ── Milestones ──
+
+  taskovergg_get_milestones: {
+    rpc: "getMilestones",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_milestone: {
+    rpc: "addMilestone",
+    schema: {
+      required: ["project_id", "title"],
+      fields: {
+        project_id: "string", title: "string",
+        date: "string", status: "string", notes: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, title: c.title, date: c.date,
+      status: c.status, notes: c.notes,
+    }],
+  },
+  taskovergg_update_milestone: {
+    rpc: "updateMilestone",
+    schema: {
+      required: ["milestone_id"],
+      fields: {
+        milestone_id: "string", project_id: "string",
+        title: "string", date: "string", status: "string", notes: "string",
+      },
+    },
+    // REVISED per M0: record:milestones — no projectId in args
+    args: (c, r) => [r.milestone_id, {
+      ...(c.title !== undefined && { title: c.title }),
+      ...(c.date !== undefined && { date: c.date }),
+      ...(c.status !== undefined && { status: c.status }),
+      ...(c.notes !== undefined && { notes: c.notes }),
+    }],
+  },
+
+  // ── Iterations ──
+
+  taskovergg_get_iterations: {
+    rpc: "getIterations",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_iteration: {
+    rpc: "addIteration",
+    schema: {
+      required: ["project_id", "feature"],
+      fields: {
+        project_id: "string", feature: "string",
+        version: "string", change: "string", reason: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, feature: c.feature, version: c.version,
+      change: c.change, reason: c.reason,
+    }],
+  },
+
+  // ── Dialogues ──
+
+  taskovergg_get_dialogues: {
+    rpc: "getDialogues",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_dialogue: {
+    rpc: "addDialogue",
+    schema: {
+      required: ["project_id", "npc"],
+      fields: {
+        project_id: "string", npc: "string", line: "string",
+        choices: "string", next_node: "string", notes: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, npc: c.npc, line: c.line,
+      choices: c.choices, nextNode: c.next_node, notes: c.notes,
+    }],
+  },
+  taskovergg_update_dialogue: {
+    rpc: "updateDialogue",
+    schema: {
+      required: ["dialogue_id"],
+      fields: {
+        dialogue_id: "string", project_id: "string",
+        npc: "string", line: "string", choices: "string",
+        next_node: "string", notes: "string",
+      },
+    },
+    // REVISED per M0: record:dialogues — no projectId in args
+    args: (c, r) => [r.dialogue_id, {
+      ...(c.npc !== undefined && { npc: c.npc }),
+      ...(c.line !== undefined && { line: c.line }),
+      ...(c.choices !== undefined && { choices: c.choices }),
+      ...(c.next_node !== undefined && { nextNode: c.next_node }),
+      ...(c.notes !== undefined && { notes: c.notes }),
+    }],
+  },
+
+  // ── Sounds ──
+
+  taskovergg_get_sounds: {
+    rpc: "getSounds",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_sound: {
+    rpc: "addSound",
+    schema: {
+      required: ["project_id", "name"],
+      fields: {
+        project_id: "string", name: "string", actor: "string",
+        trigger: "string", spatial: "string", attenuation: "string", notes: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, name: c.name, actor: c.actor,
+      trigger: c.trigger, spatial: c.spatial,
+      attenuation: c.attenuation, notes: c.notes,
+    }],
+  },
+  taskovergg_update_sound: {
+    rpc: "updateSound",
+    schema: {
+      required: ["sound_id"],
+      fields: {
+        sound_id: "string", project_id: "string",
+        name: "string", actor: "string", trigger: "string",
+        spatial: "string", attenuation: "string", notes: "string",
+      },
+    },
+    // REVISED per M0: record:sounds — no projectId in args
+    args: (c, r) => [r.sound_id, {
+      ...(c.name !== undefined && { name: c.name }),
+      ...(c.actor !== undefined && { actor: c.actor }),
+      ...(c.trigger !== undefined && { trigger: c.trigger }),
+      ...(c.spatial !== undefined && { spatial: c.spatial }),
+      ...(c.attenuation !== undefined && { attenuation: c.attenuation }),
+      ...(c.notes !== undefined && { notes: c.notes }),
+    }],
+  },
+
+  // ── Controls ──
+
+  taskovergg_get_controls: {
+    rpc: "getControls",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_control: {
+    rpc: "addControl",
+    schema: {
+      required: ["project_id", "key", "action"],
+      fields: {
+        project_id: "string", key: "string", action: "string",
+        context: "string", condition: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, key: c.key, action: c.action,
+      context: c.context, condition: c.condition,
+    }],
+  },
+  taskovergg_update_control: {
+    rpc: "updateControl",
+    schema: {
+      required: ["control_id"],
+      fields: {
+        control_id: "string", project_id: "string",
+        key: "string", action: "string", context: "string", condition: "string",
+      },
+    },
+    // REVISED per M0: record:controls — no projectId in args
+    args: (c, r) => [r.control_id, {
+      ...(c.key !== undefined && { key: c.key }),
+      ...(c.action !== undefined && { action: c.action }),
+      ...(c.context !== undefined && { context: c.context }),
+      ...(c.condition !== undefined && { condition: c.condition }),
+    }],
+  },
+
+  // ── Assets ──
+
+  taskovergg_get_assets: {
+    rpc: "getAssets",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_asset: {
+    rpc: "addAsset",
+    schema: {
+      required: ["project_id", "name"],
+      fields: {
+        project_id: "string", name: "string", type: "string",
+        path: "string", size: "string", status: "string", used_by: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, name: c.name, type: c.type,
+      path: c.path, size: c.size, status: c.status, usedBy: c.used_by,
+    }],
+  },
+  taskovergg_update_asset: {
+    rpc: "updateAsset",
+    schema: {
+      required: ["asset_id"],
+      fields: {
+        asset_id: "string", project_id: "string",
+        name: "string", type: "string", path: "string",
+        size: "string", status: "string", used_by: "string",
+      },
+    },
+    // REVISED per M0: record:assets — no projectId in args
+    args: (c, r) => [r.asset_id, {
+      ...(c.name !== undefined && { name: c.name }),
+      ...(c.type !== undefined && { type: c.type }),
+      ...(c.path !== undefined && { path: c.path }),
+      ...(c.size !== undefined && { size: c.size }),
+      ...(c.status !== undefined && { status: c.status }),
+      ...(c.used_by !== undefined && { usedBy: c.used_by }),
+    }],
+  },
+
+  // ── References ──
+
+  taskovergg_get_refs: {
+    rpc: "getRefs",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_ref: {
+    rpc: "addRef",
+    schema: {
+      required: ["project_id", "title"],
+      fields: {
+        project_id: "string", title: "string",
+        type: "string", url: "string", notes: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, title: c.title, type: c.type,
+      url: c.url, notes: c.notes,
+    }],
+  },
+
+  // ── Marketing ──
+
+  taskovergg_get_marketing_items: {
+    rpc: "getMarketingItems",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_marketing_item: {
+    rpc: "addMarketingItem",
+    schema: {
+      required: ["project_id", "item"],
+      fields: {
+        project_id: "string", item: "string",
+        category: "string", status: "string", notes: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, item: c.item, category: c.category,
+      status: c.status, notes: c.notes,
+    }],
+  },
+  taskovergg_update_marketing_item: {
+    rpc: "updateMarketingItem",
+    schema: {
+      required: ["marketing_id"],
+      fields: {
+        marketing_id: "string", project_id: "string",
+        item: "string", category: "string", status: "string", notes: "string",
+      },
+    },
+    // REVISED per M0: record:marketing_items — no projectId in args
+    args: (c, r) => [r.marketing_id, {
+      ...(c.item !== undefined && { item: c.item }),
+      ...(c.category !== undefined && { category: c.category }),
+      ...(c.status !== undefined && { status: c.status }),
+      ...(c.notes !== undefined && { notes: c.notes }),
+    }],
+  },
+
+  // ── Wiki ──
+
+  taskovergg_get_wiki_pages: {
+    rpc: "getWikiPages",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_wiki_page: {
+    rpc: "addWikiPage",
+    schema: {
+      required: ["project_id", "title"],
+      fields: { project_id: "string", title: "string", category: "string", content: "string" },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, title: c.title, category: c.category,
+      content: c.content,
+    }],
+  },
+  taskovergg_update_wiki_page: {
+    rpc: "updateWikiPage",
+    schema: {
+      required: ["wiki_id"],
+      fields: {
+        wiki_id: "string", project_id: "string",
+        title: "string", category: "string", content: "string",
+      },
+    },
+    // REVISED per M0: record:wiki_pages — no projectId in args
+    args: (c, r) => [r.wiki_id, {
+      ...(c.title !== undefined && { title: c.title }),
+      ...(c.category !== undefined && { category: c.category }),
+      ...(c.content !== undefined && { content: c.content }),
+    }],
+  },
+
+  // ── Ship Readiness ──
+
+  taskovergg_get_ship_checked: {
+    rpc: "getShipChecked",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_toggle_ship_check: {
+    rpc: "toggleShipCheck",
+    schema: {
+      required: ["project_id", "step_id"],
+      fields: { project_id: "string", step_id: "string" },
+    },
+    args: (c, r) => [r.project_id, r.step_id],
+  },
+
+  // ── Open Questions ──
+
+  taskovergg_get_open_questions: {
+    rpc: "getOpenQuestions",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_open_question: {
+    rpc: "addOpenQuestion",
+    schema: {
+      required: ["project_id", "text"],
+      fields: { project_id: "string", text: "string" },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{ projectId: r.project_id, text: c.text }],
+  },
+  taskovergg_toggle_question: {
+    rpc: "toggleQuestion",
+    schema: {
+      required: ["question_id"],
+      fields: { question_id: "string", project_id: "string" },
+    },
+    // REVISED per M0: record:open_questions — [questionId] only
+    args: (c, r) => [r.question_id],
+  },
+
+  // ── Board ──
+
+  // REMOVED per M0: taskovergg_add_board_column — DEFERRED (ANOMALY-2: no RPC method)
+  // Unblock path: add dedicated addBoardColumn RPC method or allowlist customBoardCols in updateProjectField
+
+  // ── Stories ──
+
+  taskovergg_get_stories: {
+    rpc: "getStories",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_story: {
+    rpc: "addStory",
+    schema: {
+      required: ["project_id", "section_id", "section"],
+      fields: {
+        project_id: "string", section_id: "string",
+        section: "string", content: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, sectionId: c.section_id,
+      section: c.section, content: c.content,
+    }],
+  },
+  taskovergg_update_story: {
+    rpc: "updateStory",
+    schema: {
+      required: ["story_id"],
+      fields: {
+        story_id: "string", project_id: "string",
+        section: "string", content: "string",
+      },
+    },
+    // REVISED per M0: record:stories — no projectId in args
+    args: (c, r) => [r.story_id, {
+      ...(c.section !== undefined && { section: c.section }),
+      ...(c.content !== undefined && { content: c.content }),
+    }],
+  },
+
+  // ── Scenes ──
+
+  taskovergg_get_scenes: {
+    rpc: "getScenes",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_add_scene: {
+    rpc: "addScene",
+    schema: {
+      required: ["project_id", "title"],
+      fields: {
+        project_id: "string", title: "string", number: "number",
+        location: "string", characters: "string", mood: "string",
+        round: "string", content: "string",
+      },
+    },
+    // REVISED per M0: project:true add — single object with projectId inside
+    args: (c, r) => [{
+      projectId: r.project_id, number: c.number, title: c.title,
+      location: c.location, characters: c.characters,
+      mood: c.mood, round: c.round, content: c.content,
+    }],
+  },
+  taskovergg_update_scene: {
+    rpc: "updateScene",
+    schema: {
+      required: ["scene_id"],
+      fields: {
+        scene_id: "string", project_id: "string",
+        title: "string", number: "number", location: "string",
+        characters: "string", mood: "string", round: "string", content: "string",
+      },
+    },
+    // REVISED per M0: record:scenes — no projectId in args
+    args: (c, r) => [r.scene_id, {
+      ...(c.title !== undefined && { title: c.title }),
+      ...(c.number !== undefined && { number: c.number }),
+      ...(c.location !== undefined && { location: c.location }),
+      ...(c.characters !== undefined && { characters: c.characters }),
+      ...(c.mood !== undefined && { mood: c.mood }),
+      ...(c.round !== undefined && { round: c.round }),
+      ...(c.content !== undefined && { content: c.content }),
+    }],
+  },
+  // taskovergg_delete_scene -- DEFERRED: delete ops blocked in beta
+
+  // ── Story Bible ──
+
+  taskovergg_get_story_bible: {
+    rpc: "getStoryBible",
+    schema: { required: ["project_id"], fields: { project_id: "string" } },
+    args: (c, r) => [r.project_id],
+  },
+  taskovergg_update_story_bible: {
+    rpc: "updateStoryBible",
+    schema: {
+      required: ["project_id"],
+      fields: {
+        project_id: "string", title: "string", logline: "string",
+        genre: "string", tone: "string", script: "string",
+      },
+    },
+    args: (c, r) => [r.project_id, {
+      ...(c.title !== undefined && { title: c.title }),
+      ...(c.logline !== undefined && { logline: c.logline }),
+      ...(c.genre !== undefined && { genre: c.genre }),
+      ...(c.tone !== undefined && { tone: c.tone }),
+      ...(c.script !== undefined && { script: c.script }),
+    }],
+  },
+  taskovergg_add_story_character: {
+    rpc: "addStoryCharacter",
+    schema: {
+      required: ["project_id", "name"],
+      fields: {
+        project_id: "string", name: "string",
+        role: "string", description: "string",
+      },
+    },
+    args: (c, r) => [r.project_id, {
+      name: c.name, role: c.role, description: c.description,
+    }],
+  },
+  // REMOVED per M0: taskovergg_update_story_character — DEFERRED (ANOMALY-3: ownership mismatch)
+  // Unblock path: fix RPC registry record:"story_characters" → project:true
+
+  // ── Scene Content ──
+
+  taskovergg_get_scene_content: {
+    rpc: "getSceneContent",
+    schema: {
+      required: ["scene_id"],
+      fields: { scene_id: "string", project_id: "string" },
+    },
+    // REVISED per M0: record:scenes ownership — cloud adapter sends [sceneId] only.
+    // RPC handler resolves projectId internally via SELECT project_id FROM scenes WHERE id = ?
+    args: (c, r) => [r.scene_id],
+  },
+  // REMOVED per M0: taskovergg_update_scene_content — DEFERRED (ANOMALY-3: ownership mismatch)
+  // Unblock path: fix RPC registry record:"scenes" → project:true
+
+  // REMOVED: taskovergg_get_activity_feed — not in M0 matrix (no MCP tool in TOOLS array)
+};
+
+module.exports = { TOOL_MAP, validateSchema };