addTaskManager MCP Server

Instructions

Implementation Reference

• src/index.ts:575-586 (schema)

  Schema definition for the moveToRealm tool, including input parameters and description. Part of the tools list returned by listTools.

    name: 'moveToRealm',
    description: 'Move a task or project to a specific realm.',
    inputSchema: {
      type: 'object',
      properties: {
        itemRecordName: { type: 'string', description: 'Record name of the task or project to move' },
        itemType: { type: 'string', enum: ['Task', 'Project'], description: 'Type of item to move' },
        realmId: { type: 'string', enum: ['assess', 'decide', 'do'], description: 'Target realm (assess=1, decide=2, do=3)' }
      },
      required: ['itemRecordName', 'itemType', 'realmId']
    }
  },

• src/index.ts:750-758 (handler)

  Main handler for moveToRealm tool in the CallToolRequestSchema switch statement. Validates args and dispatches to task/project specific move functions.

    if (args.itemType === 'Task') {
      return await this.moveTaskToRealm(args.itemRecordName, args.realmId);
    } else if (args.itemType === 'Project') {
      return await this.moveProjectToRealm(args.itemRecordName, args.realmId);
    } else {
      throw new McpError(ErrorCode.InvalidParams, 'itemType must be Task or Project');
    }
  case 'get_collections':
    return await this.getCollections();

• src/index.ts:1042-1049 (helper)

  Task-specific handler that validates realm transition before calling generic moveItemToRealm.

  private async moveTaskToRealm(taskRecordName: string, targetRealm: string) {
    // Add validation before moving
    const validationResult = await this.validateRealmTransition(taskRecordName, 'Task', targetRealm as RealmString);
    if (!validationResult.valid) {
      throw new McpError(ErrorCode.InvalidParams, validationResult.reason);
    }
    return this.moveItemToRealm(taskRecordName, 'Task', targetRealm as RealmString);
  }

• src/index.ts:1051-1058 (helper)

  Project-specific handler that validates realm transition before calling generic moveItemToRealm.

  private async moveProjectToRealm(projectRecordName: string, targetRealm: string) {
    // Add validation before moving
    const validationResult = await this.validateRealmTransition(projectRecordName, 'Project', targetRealm as RealmString);
    if (!validationResult.valid) {
      throw new McpError(ErrorCode.InvalidParams, validationResult.reason);
    }
    return this.moveItemToRealm(projectRecordName, 'Project', targetRealm as RealmString);
  }

• src/index.ts:1200-1214 (handler)

  Core implementation logic for moving an item to a target realm, including realm-specific message and mock update.

  private async moveItemToRealm(itemRecordName: string, itemType: 'Task' | 'Project', targetRealmStr: RealmString) {
    const targetRealmId = realmStringToId(targetRealmStr);
    
    // Mock update realmId and clean up fields based on realm rules
    let updateMessage = `${itemType} ${itemRecordName} moved to ${targetRealmStr} realm (ID: ${targetRealmId})`;
    
    // Apply realm-specific cleanup rules
    if (targetRealmId === REALM_ASSESS_ID) {
      updateMessage += '. Context and due date cleared for fresh evaluation';
    } else if (targetRealmId === REALM_DECIDE_ID && targetRealmStr !== 'decide') {
      updateMessage += '. Ready for context assignment and due date setting';
    }
    
    return { content: [{ type: 'text', text: updateMessage }] };
  }