KarposKarpos

Projetos

CRUD completo de projetos. Liste, crie, atualize e delete projetos no seu workspace.

A operação delete-project remove permanentemente o projeto e todas as suas tarefas. Não há soft-delete ou lixeira. Sempre confirme com o usuário antes de executar.

list-projects

list-projects

Retorna todos os projetos do workspace com status, cor, datas e contagem de tarefas. Suporta filtro por status.

Parâmetros

workspaceId* obrigatório

string

ID do workspace

statusopcional

string

Filtrar por status: "active" | "archived"

Exemplo

{
  "tool": "list-projects",
  "workspaceId": "wsp_abc123",
  "status": "active"
}

Resposta

{
  "projects": [
    {
      "id": "prj_001",
      "name": "Website Redesign",
      "status": "active",
      "color": "#3b82f6",
      "taskCount": 24,
      "startDate": "2024-01-01",
      "dueDate": "2024-06-30"
    }
  ]
}

create-project

create-project

Cria um novo projeto no workspace especificado. Retorna o projeto criado com ID gerado automaticamente.

Parâmetros

workspaceId* obrigatório

string

ID do workspace

name* obrigatório

string

Nome do projeto

descriptionopcional

string

Descrição do projeto

coloropcional

string

Cor hex (ex: #3b82f6)

startDateopcional

string

Data de início (ISO 8601)

dueDateopcional

string

Data de entrega (ISO 8601)

Exemplo

{
  "tool": "create-project",
  "workspaceId": "wsp_abc123",
  "name": "Q2 Marketing",
  "description": "Campanhas do segundo trimestre",
  "color": "#8b5cf6"
}

Resposta

{
  "project": {
    "id": "prj_003",
    "name": "Q2 Marketing",
    "status": "active",
    "color": "#8b5cf6",
    "taskCount": 0
  }
}

update-project

update-project

Atualiza campos de um projeto existente. Envie apenas os campos que deseja alterar — os demais são preservados.

Parâmetros

projectId* obrigatório

string

ID do projeto

nameopcional

string

Novo nome

descriptionopcional

string

Nova descrição

statusopcional

string

"active" | "archived"

coloropcional

string

Nova cor hex

dueDateopcional

string

Nova data de entrega (ISO 8601)

Exemplo

{
  "tool": "update-project",
  "projectId": "prj_003",
  "status": "archived"
}

Resposta

{
  "success": true
}

delete-project

delete-project

Remove permanentemente um projeto e todas as suas tarefas. Esta operação é irreversível. Confirme com o usuário antes de executar.

Parâmetros

projectId* obrigatório

string

ID do projeto a deletar

Exemplo

{
  "tool": "delete-project",
  "projectId": "prj_003"
}

Resposta

{
  "success": true,
  "deletedTasks": 12
}