create_project
Create a new project with name, description, and status to organize work in the Helios-9 project management system.
Instructions
Create a new project with specified details
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The name of the project | |
| description | No | Optional description of the project | |
| status | No | Initial status of the project | active |
Implementation Reference
- src/tools/projects.ts:148-166 (handler)The main execution handler for the 'create_project' MCP tool. Validates input args using Zod schema, creates the project via supabaseService, logs actions, and returns the new project with success message.export const createProject = requireAuth(async (args: any) => { const projectData = CreateProjectSchema.parse(args) logger.info('Creating new project', { name: projectData.name }) const project = await supabaseService.createProject({ name: projectData.name, description: projectData.description || null, status: projectData.status // Removed metadata as it doesn't exist in the database schema }) logger.info('Project created successfully', { project_id: project.id, name: project.name }) return { project, message: `Project "${project.name}" created successfully` } })
- src/tools/projects.ts:120-146 (registration)MCPTool registration object defining the 'create_project' tool's metadata: name, description, and JSON inputSchema for validation.export const createProjectTool: MCPTool = { name: 'create_project', description: 'Create a new project with specified details', inputSchema: { type: 'object', properties: { name: { type: 'string', minLength: 1, maxLength: 255, description: 'The name of the project' }, description: { type: 'string', description: 'Optional description of the project' }, status: { type: 'string', enum: ['active', 'completed', 'archived'], default: 'active', description: 'Initial status of the project' }, // Removed priority, metadata as they don't exist in the database schema }, required: ['name'] } }
- src/tools/projects.ts:23-28 (schema)Zod schema (CreateProjectSchema) used within the handler for runtime input validation and parsing.const CreateProjectSchema = z.object({ name: z.string().min(1).max(255), description: z.string().optional(), status: z.enum(['active', 'completed', 'archived']).default('active') // Removed priority, metadata as they don't exist in the database schema })
- src/tools/projects.ts:778-788 (registration)Mapping of tool names to their handler functions in the projectHandlers object, which is used by other parts of the codebase (e.g., prompt-to-project.ts) to invoke the create_project tool.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 }