Helios-9 MCP Server

Instructions

Implementation Reference

• src/tools/tasks.ts:514-552 (handler)

  The main execution handler for the 'add_task_dependency' tool. It validates input, checks task existence and circular dependencies, creates the dependency in the database, and returns the created dependency with related task information.

  export const addTaskDependency = requireAuth(async (args: any) => {
    const { task_id, depends_on_task_id, dependency_type } = AddTaskDependencySchema.parse(args)
    
    logger.info('Adding task dependency', { task_id, depends_on_task_id, dependency_type })
  
    // Validate tasks exist
    const [task, dependsOnTask] = await Promise.all([
      supabaseService.getTask(task_id),
      supabaseService.getTask(depends_on_task_id)
    ])
  
    if (!task || !dependsOnTask) {
      throw new Error('One or both tasks not found')
    }
  
    // Check for circular dependencies
    const hasCircularDependency = await checkCircularDependency(task_id, depends_on_task_id)
    if (hasCircularDependency) {
      throw new Error('Cannot create dependency: would create circular dependency')
    }
  
    // Create dependency record
    const dependency = await supabaseService.createTaskDependency({
      task_id,
      depends_on_task_id,
      dependency_type,
      created_at: new Date().toISOString()
    })
  
    // Note: blocked status doesn't exist in database schema
    // In a real implementation, you might use metadata or a separate blocking system
  
    return {
      dependency,
      task: await supabaseService.getTask(task_id),
      depends_on_task: dependsOnTask,
      message: `Dependency created: "${task.title}" ${dependency_type} "${dependsOnTask.title}"`
    }
  })

• src/tools/tasks.ts:508-512 (schema)

  Zod schema for validating input parameters to the add_task_dependency tool: task_id, depends_on_task_id, and optional dependency_type.

  const AddTaskDependencySchema = z.object({
    task_id: z.string().min(1),
    depends_on_task_id: z.string().min(1),
    dependency_type: z.enum(['blocks', 'subtask', 'related']).default('blocks')
  })

• src/tools/tasks.ts:483-506 (registration)

  MCPTool registration object for 'add_task_dependency', including name, description, and input schema definition.

  export const addTaskDependencyTool: MCPTool = {
    name: 'add_task_dependency',
    description: 'Add a dependency relationship between tasks',
    inputSchema: {
      type: 'object',
      properties: {
        task_id: {
          type: 'string',
          description: 'ID of the dependent task'
        },
        depends_on_task_id: {
          type: 'string',
          description: 'ID of the task this task depends on'
        },
        dependency_type: {
          type: 'string',
          enum: ['blocks', 'subtask', 'related'],
          default: 'blocks',
          description: 'Type of dependency relationship'
        }
      },
      required: ['task_id', 'depends_on_task_id']
    }
  }

• src/tools/tasks.ts:1157-1167 (registration)

  Registration of the addTaskDependency handler function under the 'add_task_dependency' key in the taskHandlers export object, used for tool dispatching.

  export const taskHandlers = {
    list_tasks: listTasks,
    create_task: createTask,
    get_task: getTask,
    update_task: updateTask,
    add_task_dependency: addTaskDependency,
    get_task_dependencies: getTaskDependencies,
    create_task_workflow: createTaskWorkflow,
    bulk_update_tasks: bulkUpdateTasks,
    get_task_workflow_status: getTaskWorkflowStatus
  }

• src/tools/tasks.ts:1145-1155 (registration)

  Inclusion of addTaskDependencyTool in the taskTools export object for module-level tool registry.

  export const taskTools = {
    listTasksTool,
    createTaskTool,
    getTaskTool,
    updateTaskTool,
    addTaskDependencyTool,
    getTaskDependenciesTool,
    createTaskWorkflowTool,
    bulkUpdateTasksTool,
    getTaskWorkflowStatusTool
  }