Helios-9 MCP Server

Instructions

Implementation Reference

• src/tools/projects.ts:406-474 (handler)

  The main handler function that implements the duplicate_project tool. It copies the source project, optionally copies tasks and documents, handles date resets, and returns the results.

  export const duplicateProject = requireAuth(async (args: any) => {
    const { source_project_id, new_name, include_tasks, include_documents, reset_dates, new_owner_id } = DuplicateProjectSchema.parse(args)
    
    logger.info('Duplicating project', { source_project_id, new_name, include_tasks, include_documents })
  
    // Get source project
    const sourceProject = await supabaseService.getProject(source_project_id)
    if (!sourceProject) {
      throw new Error('Source project not found')
    }
  
    const now = new Date().toISOString()
    
    // Create new project
    const newProject = await supabaseService.createProject({
      name: new_name,
      description: `Copy of ${sourceProject.name}${sourceProject.description ? `: ${sourceProject.description}` : ''}`,
      status: 'active'
      // Removed owner_id, priority, visibility, metadata as they don't exist in the database schema
    })
  
    const duplicateResults = {
      new_project: newProject,
      tasks_copied: 0,
      documents_copied: 0
    }
  
    // Copy tasks if requested
    if (include_tasks) {
      const sourceTasks = await supabaseService.getTasks({ project_id: source_project_id })
      
      for (const task of sourceTasks) {
        const newTask = {
          title: task.title,
          description: task.description,
          project_id: newProject.id,
          initiative_id: null,
          status: 'todo' as const, // Reset all tasks to todo
          priority: task.priority,
          due_date: reset_dates ? null : task.due_date,
          assignee_id: task.assignee_id
          // Removed started_at, completed_at as they don't exist in the database schema
        }
        
        await supabaseService.createTask(newTask)
        duplicateResults.tasks_copied++
      }
    }
  
    // Copy documents if requested
    if (include_documents) {
      const sourceDocuments = await supabaseService.getDocuments({ project_id: source_project_id })
      
      for (const doc of sourceDocuments) {
        const newDoc = {
          project_id: newProject.id,
          title: `${doc.title} (Copy)`,
          content: doc.content,
          document_type: doc.document_type
          // Removed metadata as it doesn't exist in the database schema
        }
        
        await supabaseService.createDocument(newDoc)
        duplicateResults.documents_copied++
      }
    }
  
    return duplicateResults
  })

• src/tools/projects.ts:397-404 (schema)

  Zod input schema for validating parameters of the duplicate_project tool.

  const DuplicateProjectSchema = z.object({
    source_project_id: z.string().min(1),
    new_name: z.string().min(1).max(200),
    include_tasks: z.boolean().default(true),
    include_documents: z.boolean().default(true),
    reset_dates: z.boolean().default(true),
    new_owner_id: z.string().optional()
  })

• src/tools/projects.ts:359-395 (registration)

  MCPTool registration defining the duplicate_project tool, including its name, description, and input schema for the protocol.

  export const duplicateProjectTool: MCPTool = {
    name: 'duplicate_project',
    description: 'Create a copy of an existing project with customizable options',
    inputSchema: {
      type: 'object',
      properties: {
        source_project_id: {
          type: 'string',
          description: 'ID of the project to duplicate'
        },
        new_name: {
          type: 'string',
          description: 'Name for the new project'
        },
        include_tasks: {
          type: 'boolean',
          default: true,
          description: 'Whether to copy tasks'
        },
        include_documents: {
          type: 'boolean',
          default: true,
          description: 'Whether to copy documents'
        },
        reset_dates: {
          type: 'boolean',
          default: true,
          description: 'Whether to reset all dates to current'
        },
        new_owner_id: {
          type: 'string',
          description: 'New owner for the duplicated project (optional)'
        }
      },
      required: ['source_project_id', 'new_name']
    }
  }

• src/tools/projects.ts:778-787 (registration)

  Handler registration object that maps 'duplicate_project' to the duplicateProject function.

  export const projectHandlers = {
    list_projects: listProjects,
    get_project: getProject,
    create_project: createProject,
    update_project: updateProject,
    get_project_context: getProjectContext,
    archive_project: archiveProject,
    duplicate_project: duplicateProject,
    get_project_timeline: getProjectTimeline,
    bulk_update_projects: bulkUpdateProjects

• src/tools/projects.ts:766-775 (registration)

  Collection of all project tools including duplicateProjectTool for bulk registration.

  export const projectTools = {
    listProjectsTool,
    getProjectTool,
    createProjectTool,
    updateProjectTool,
    getProjectContextTool,
    archiveProjectTool,
    duplicateProjectTool,
    getProjectTimelineTool,
    bulkUpdateProjectsTool