innov-mcp-tasks 1.2.0 → 1.4.0

package/README.md

@@ -52,11 +52,13 @@ 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

@@ -50,13 +50,86 @@ async function apiFetch(path, init = {}) {
   return data;
 }
 
+async function apiFetchBinary(path) {
+  if (!base || !token) {
+    throw new Error(
+      'Defina INNOV_API_BASE_URL e INNOV_API_TOKEN no ambiente ou num .env.',
+    );
+  }
+  const url = `${base}${path.startsWith('/') ? path : `/${path}`}`;
+  const res = await fetch(url, {
+    headers: {
+      Authorization: `Bearer ${token}`,
+    },
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    let msg = text.slice(0, 800);
+    try {
+      const data = text ? JSON.parse(text) : null;
+      if (data && (data.message || data.error)) {
+        msg = String(data.message || data.error);
+      }
+    } catch {
+      /* texto bruto */
+    }
+    throw new Error(`HTTP ${res.status}: ${msg}`);
+  }
+  const buffer = Buffer.from(await res.arrayBuffer());
+  const disposition = res.headers.get('content-disposition') || '';
+  const filenameMatch = disposition.match(/filename="?([^";\n]+)"?/i);
+  const filename = filenameMatch?.[1]?.trim() || 'attachment';
+  return {
+    buffer,
+    contentType: res.headers.get('content-type') || 'application/octet-stream',
+    filename,
+    size: buffer.length,
+  };
+}
+
+/** 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 {
@@ -64,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));
@@ -92,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) => {
@@ -105,6 +182,34 @@ server.registerTool(
   },
 );
 
+server.registerTool(
+  'task_attachment_download',
+  {
+    description:
+      'Baixa anexo de tarefa (GET /task-attachments/{id}/download). Requer Bearer Sanctum. ' +
+      'Retorna metadados e conteúdo em base64 (útil para zip, pdf, docx, txt, srt, etc.). ' +
+      'Use task_get para listar attachments[].id da tarefa.',
+    inputSchema: { attachment_id: z.number().int().positive() },
+  },
+  async (args) => {
+    try {
+      const file = await apiFetchBinary(
+        `/api/v1/task-attachments/${args.attachment_id}/download`,
+      );
+      return jsonText({
+        attachment_id: args.attachment_id,
+        filename: file.filename,
+        content_type: file.contentType,
+        size_bytes: file.size,
+        content_base64: file.buffer.toString('base64'),
+        hint: 'Decodifique content_base64 para gravar o ficheiro localmente.',
+      });
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
 server.registerTool(
   'projects_list',
   {
@@ -168,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(),
@@ -176,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),
@@ -199,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.2.0",
+  "version": "1.4.0",
   "description": "MCP stdio — tarefas e anotações Innov (INNOV_API_BASE_URL + token Sanctum)",
   "type": "module",
   "main": "index.mjs",