innov-mcp-tasks 1.3.0 → 1.4.0

package/README.md

@@ -52,11 +52,12 @@ Na raiz do repo existe [`.cursor/mcp.json`](../.cursor/mcp.json) com **dois** se
 
 ### Tarefas e projetos
 
-- `tasks_list` — opcional `project_id`
+- `tasks_list` — opcional `project_id`, `milestones_only` (filtra marcos no cliente)
 - `my_tasks` — tarefas do utilizador do token (endpoint “minhas” da API)
 - `projects_list` — lista projetos visíveis (`GET /api/v1/projects`)
 - `project_create` — cria projeto (`POST /api/v1/projects`)
-- `task_get`, `task_create`, `task_update_status`, `task_assign`, `task_assign_to_me`
+- `task_get`, `task_create`, `task_update`, `task_update_status`, `task_assign`, `task_assign_to_me`
+- `task_create` / `task_update` — marcos: `is_milestone`, `start_date` (YYYY-MM-DD), `duration` (dias); marco exige `project_id` na criação
 - `task_attachment_download` — baixa anexo por `attachment_id` (conteúdo em base64; ids em `task_get` → `attachments`)
 
 ### Anotações / documentação

package/index.mjs

@@ -87,13 +87,49 @@ async function apiFetchBinary(path) {
   };
 }
 
+/** Campos de marco / cronograma (is_milestone exige project_id na API). */
+const taskMilestoneInputSchema = {
+  is_milestone: z.boolean().optional(),
+  start_date: z
+    .string()
+    .optional()
+    .describe('Data de início (YYYY-MM-DD); usada em marcos e Gantt'),
+  duration: z
+    .number()
+    .int()
+    .min(1)
+    .optional()
+    .describe('Duração em dias (marco/cronograma)'),
+};
+
+function pickDefined(fields) {
+  return Object.fromEntries(
+    Object.entries(fields).filter(([, v]) => v !== undefined),
+  );
+}
+
+function filterTasksMilestonesOnly(data) {
+  if (!Array.isArray(data)) {
+    return data;
+  }
+  return data.filter((t) => t && t.is_milestone);
+}
+
 const server = new McpServer({ name: 'innov-tasks', version: '1.0.0' });
 
 server.registerTool(
   'tasks_list',
   {
-    description: 'Lista tarefas. Com project_id usa GET /tasks?project_id=…; sem project_id usa GET /tasks/kanban.',
-    inputSchema: { project_id: z.number().int().positive().optional() },
+    description:
+      'Lista tarefas. Com project_id usa GET /tasks?project_id=…; sem project_id usa GET /tasks/kanban. ' +
+      'Cada item inclui is_milestone, start_date e duration. Com milestones_only=true filtra só marcos (no cliente).',
+    inputSchema: {
+      project_id: z.number().int().positive().optional(),
+      milestones_only: z
+        .boolean()
+        .optional()
+        .describe('Se true, devolve apenas tarefas com is_milestone=true'),
+    },
   },
   async (args) => {
     try {
@@ -101,7 +137,10 @@ server.registerTool(
         args.project_id != null
           ? `/api/v1/tasks?project_id=${encodeURIComponent(String(args.project_id))}`
           : '/api/v1/tasks/kanban';
-      const data = await apiFetch(path);
+      let data = await apiFetch(path);
+      if (args.milestones_only) {
+        data = filterTasksMilestonesOnly(data);
+      }
       return jsonText(data);
     } catch (e) {
       return jsonError(e instanceof Error ? e.message : String(e));
@@ -129,7 +168,8 @@ server.registerTool(
 server.registerTool(
   'task_get',
   {
-    description: 'Obtém uma tarefa por id (GET /tasks/{id}).',
+    description:
+      'Obtém uma tarefa por id (GET /tasks/{id}). Inclui is_milestone, start_date e duration.',
     inputSchema: { task_id: z.number().int().positive() },
   },
   async (args) => {
@@ -233,7 +273,8 @@ server.registerTool(
 server.registerTool(
   'task_create',
   {
-    description: 'Cria tarefa (POST /tasks).',
+    description:
+      'Cria tarefa (POST /tasks). Marcos: is_milestone=true exige project_id; opcional start_date e duration (dias).',
     inputSchema: {
       title: z.string().min(1).max(255),
       project_id: z.number().int().positive().optional(),
@@ -241,18 +282,24 @@ server.registerTool(
       description: z.string().optional(),
       assigned_to: z.number().int().positive().optional(),
       priority: z.enum(['low', 'medium', 'high', 'urgent']).optional(),
+      due_date: z.string().optional().describe('Prazo (YYYY-MM-DD)'),
+      ...taskMilestoneInputSchema,
     },
   },
   async (args) => {
     try {
-      const body = {
+      const body = pickDefined({
         title: args.title,
-        project_id: args.project_id ?? null,
-        team_id: args.team_id ?? null,
-        description: args.description ?? null,
-        assigned_to: args.assigned_to ?? null,
+        project_id: args.project_id,
+        team_id: args.team_id,
+        description: args.description,
+        assigned_to: args.assigned_to,
         priority: args.priority ?? 'medium',
-      };
+        due_date: args.due_date,
+        is_milestone: args.is_milestone,
+        start_date: args.start_date,
+        duration: args.duration,
+      });
       const data = await apiFetch('/api/v1/tasks', {
         method: 'POST',
         body: JSON.stringify(body),
@@ -264,6 +311,41 @@ server.registerTool(
   },
 );
 
+server.registerTool(
+  'task_update',
+  {
+    description:
+      'Atualiza tarefa (PATCH /tasks/{id}). Campos opcionais; marcos: is_milestone, start_date, duration (dias). ' +
+      'Marco exige projeto e não pode ser subtarefa (regras da API).',
+    inputSchema: {
+      task_id: z.number().int().positive(),
+      title: z.string().min(1).max(255).optional(),
+      description: z.string().optional(),
+      status: z
+        .enum(['pending', 'in_progress', 'in_review', 'completed', 'cancelled'])
+        .optional(),
+      priority: z.enum(['low', 'medium', 'high', 'urgent']).optional(),
+      due_date: z.string().optional(),
+      assigned_to: z.number().int().positive().optional(),
+      progress: z.number().int().min(0).max(100).optional(),
+      ...taskMilestoneInputSchema,
+    },
+  },
+  async (args) => {
+    try {
+      const { task_id, ...fields } = args;
+      const body = pickDefined(fields);
+      const data = await apiFetch(`/api/v1/tasks/${task_id}`, {
+        method: 'PATCH',
+        body: JSON.stringify(body),
+      });
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
 server.registerTool(
   'task_update_status',
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "innov-mcp-tasks",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "MCP stdio — tarefas e anotações Innov (INNOV_API_BASE_URL + token Sanctum)",
   "type": "module",
   "main": "index.mjs",