plugin-tasks

Beta

@fayz-ai/plugin-tasks

Work happens between the records. A salon owner needs to "call the supplier," a clinic admin needs to "follow up on lab results" — small things that never fit neatly into a booking or an invoice. plugin-tasks gives every Fayz app a lightweight, always-available task list: a topbar button that opens a drawer for quick-add, statuses, priorities, due dates, labels, and assignees.

Prévia do plugin-tasks como o cliente vê

Visão geral

Gestão de tarefas transversal a qualquer app. Diferente da maioria dos plugins, o plugin-tasks não adiciona um item no menu: ele monta um botão na barra superior do shell (zona shell.topbar.end) que abre uma gaveta de tarefas de qualquer lugar do app, além de uma aba em Configurações.

É a capability completa deste grupo — entrega dados, UI e ferramenta de IA prontos. Empacota duas migrations (000_plg_rename + 001_tasks_base) com duas tabelas próprias, tsk_tasks (subtarefas via parent_id, status todo/in_progress/done/cancelled, prioridade low/medium/high/urgent, prazo e etiquetas) e tsk_labels. O provider Supabase cai automaticamente para um provider mock em memória quando o Supabase não está configurado.

Para IA, expõe a ferramenta getTasksSummary (total, atrasadas, vencendo hoje, por status e prioridade).

Quando usar

Precisa de um "to-do" leve disponível em todo o app, sem ocupar um item de menu.
Quer subtarefas, prioridades e etiquetas coloridas sem construir do zero.
Quer que o assistente de IA responda "o que está atrasado?" a partir dos dados reais.

Ficha técnica

Pacote	`@fayz-ai/plugin-tasks`
Versão	0.1.7
Status	beta
Capability	Capability parcial
Canal stable	`^0.1.7`
Migrations	2 migration(s)
Factory	`createTasksPlugin()`

Modelo de dados

Tabela	Colunas-chave
`plg_tasks_labels`	name, color, is_active
`plg_tasks_tasks`	title, description, status, priority, due_date, assigned_to_id

Convenção plg_ + tenant_id + RLS. Modelo de dados.

Tools de IA

id	modo	descrição
`tasks.summary`	read	Returns a summary of pending tasks: total, overdue, due today, by status and priority.

Ferramentas que um agente pode chamar contra o seu app. Seu app como camada de dados.

Integrações

Sem conector hospedado — provedores externos entram via connector spine. Veja o catálogo de integrações.

Use esta página como skill. A versão .md desta ficha (em plugins/plugin-tasks.md) é o contrato agent-consumable — modelo de dados, tools e integrações num só arquivo que uma IA lê direto. Preview O comando fayz skill add plugin-tasks chega em breve para instalar isso como skill. Veja Skills.

Integrar

Adicione o plugin em surfaces.admin.plugins do app.manifest.json do seu app e rode o doctor para validar:

{
  "surfaces": {
    "admin": {
      "plugins": [
        { "id": "tasks", "enabled": true }
      ]
    }
  }
}

npx fayz doctor

O fayz doctor confere o manifesto contra o catálogo do SDK. Veja Configuração para o passo a passo completo.