@opentask/taskin-task-manager 3.0.2 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # @opentask/taskin-task-manager
 
+## 3.1.0
+
+### Minor Changes
+
+- 6bebe35: O taskin passa a entregar a lista de tarefas de forma que outra ferramenta
+  consuma — `taskin list --json` e `list_tasks` no servidor MCP.
+  
+  ## O que havia
+  
+  O `list` só imprimia tabela colorida. O servidor MCP não tinha ferramenta de
+  listagem, e o recurso `taskin://tasks` **anunciava** a capacidade e respondia
+  com um espaço reservado:
+  
+  ```json
+  {"message": "Task list would be here", "note": "Requires ITaskProvider integration"}
+  ```
+  
+  Pior que não oferecer: quem consome recebe algo com cara de dado.
+  
+  ## Uma seleção, não três
+  
+  Havia duas implementações da mesma pergunta, já discordando — o comando `list`
+  casava o responsável por substring em nome ou id, e a classe `Taskin` casava
+  `userId` exato, além de projetar a task derrubando o `assignee`. A saída em
+  JSON e o MCP seriam a terceira e a quarta.
+  
+  `filterTasks` e `summarizeTask` vivem no pacote agnóstico, e os três caminhos
+  perguntam ao mesmo lugar.
+  
+  ## Detalhes que importam para quem consome
+  
+  `list --json` sai **sem cabeçalho, moldura ou aviso** — a saída inteira é JSON
+  válido, e lista vazia é `[]`. Não carrega `content` nem `description`: o
+  provider de arquivos guarda o markdown inteiro neles, e a listagem deste
+  repositório passaria de vinte mil linhas. O corpo se busca pelo id.
+  
+  `getAllTasks` entrou no `ITaskManager`, delegando ao provider como `lint` já
+  fazia — era o que faltava para um consumidor que só tem o manager responder
+  "que trabalho existe?".
+  
+  `ListTasksOptions.status` e `.type` passam a usar os tipos do domínio em vez de
+  `string`. Um valor fora do conjunto nunca casaria, e falhava em silêncio.
+  
+  ## Um defeito de transporte, corrigido junto
+  
+  Exercitando o servidor por stdio, o SDK recusava a resposta com
+  `invalid_union: expected string, received array`. O invólucro fazia
+  `text: result.content`, embrulhando o arranjo de blocos dentro de um bloco cujo
+  `text` precisa ser string — então **`start_task` e `finish_task` nunca
+  funcionaram pelo transporte real**. Nenhum teste pegava porque todos chamavam
+  `callTool` direto, pulando o invólucro.
+
+### Patch Changes
+
+- Updated dependencies [6bebe35]
+  - @opentask/taskin-types@2.2.0
+
 ## 3.0.2
 
 ### Patch Changes

package/dist/filter-tasks/filter-tasks.d.ts

@@ -0,0 +1,26 @@
+import type { Task } from '@opentask/taskin-types';
+import type { TaskFilterCriteria, TaskSummary } from './filter-tasks.types.js';
+/**
+ * Seleciona tarefas por criterio, sem saber como elas serao exibidas.
+ *
+ * Vive aqui, no pacote agnostico, porque a mesma pergunta e feita de tres
+ * lugares: o comando `list`, a saida em JSON e o servidor MCP. Antes eram duas
+ * implementacoes que ja discordavam — o comando casava o responsavel por
+ * substring em nome ou id, e a classe `Taskin` casava `userId` exato.
+ *
+ * Nao ordena e nao muda o arranjo recebido: a ordem que entra e a que sai.
+ *
+ * @public
+ */
+export declare function filterTasks(tasks: readonly Task[], criteria: TaskFilterCriteria): Task[];
+/**
+ * O que identifica uma tarefa numa listagem, sem o que ela diz.
+ *
+ * O provider de arquivos carrega o markdown inteiro em `content` e
+ * `description`. Incluir isso faria a listagem deste repositorio passar de
+ * vinte mil linhas — e quem lista quer **escolher** uma tarefa, nao le-las
+ * todas. O corpo se busca depois, pelo id.
+ *
+ * @public
+ */
+export declare function summarizeTask(task: Task): TaskSummary;

package/dist/filter-tasks/filter-tasks.js

@@ -0,0 +1,84 @@
+/**
+ * O que conta como "ainda em aberto".
+ *
+ * `paused` e `in-review` entram: a tarefa nao foi entregue nem descartada, so
+ * nao esta sendo tocada agora. Deixa-las de fora escondia trabalho em curso de
+ * quem filtrava por `--open`.
+ */
+const EM_ABERTO = ['pending', 'in-progress', 'paused', 'in-review', 'blocked'];
+const ENCERRADOS = ['done', 'canceled'];
+const contem = (valor, procurado) => valor !== undefined && valor.toLowerCase().includes(procurado);
+/**
+ * Casa o responsavel por id ou nome, inteiro ou em parte.
+ *
+ * Tarefa sem responsavel nunca casa: filtrar por uma pessoa e perguntar "o que
+ * e dela", e "de ninguem" nao e resposta.
+ */
+function casaResponsavel(task, procurado) {
+    const alvo = procurado.toLowerCase();
+    return contem(task.assignee?.id, alvo) || contem(task.assignee?.name, alvo);
+}
+/**
+ * Seleciona tarefas por criterio, sem saber como elas serao exibidas.
+ *
+ * Vive aqui, no pacote agnostico, porque a mesma pergunta e feita de tres
+ * lugares: o comando `list`, a saida em JSON e o servidor MCP. Antes eram duas
+ * implementacoes que ja discordavam — o comando casava o responsavel por
+ * substring em nome ou id, e a classe `Taskin` casava `userId` exato.
+ *
+ * Nao ordena e nao muda o arranjo recebido: a ordem que entra e a que sai.
+ *
+ * @public
+ */
+export function filterTasks(tasks, criteria) {
+    return tasks.filter((task) => {
+        if (criteria.status !== undefined) {
+            if (task.status !== criteria.status)
+                return false;
+        }
+        else if (criteria.open && !EM_ABERTO.includes(task.status)) {
+            return false;
+        }
+        else if (criteria.closed && !ENCERRADOS.includes(task.status)) {
+            return false;
+        }
+        if (criteria.type !== undefined && task.type !== criteria.type)
+            return false;
+        if (criteria.assignee !== undefined && !casaResponsavel(task, criteria.assignee))
+            return false;
+        if (criteria.text !== undefined) {
+            const procurado = criteria.text.toLowerCase();
+            const casa = task.id.toLowerCase().includes(procurado) ||
+                contem(task.title, procurado) ||
+                contem(task.status, procurado) ||
+                casaResponsavel(task, procurado);
+            if (!casa)
+                return false;
+        }
+        return true;
+    });
+}
+/**
+ * O que identifica uma tarefa numa listagem, sem o que ela diz.
+ *
+ * O provider de arquivos carrega o markdown inteiro em `content` e
+ * `description`. Incluir isso faria a listagem deste repositorio passar de
+ * vinte mil linhas — e quem lista quer **escolher** uma tarefa, nao le-las
+ * todas. O corpo se busca depois, pelo id.
+ *
+ * @public
+ */
+export function summarizeTask(task) {
+    return {
+        id: task.id,
+        title: task.title,
+        status: task.status,
+        type: task.type,
+        ...(task.assignee && { assignee: { id: task.assignee.id, name: task.assignee.name } }),
+        ...(task.order !== undefined && { priority: task.order }),
+        ...(task.groupId && { groupId: task.groupId }),
+        ...(task.groupName && { groupName: task.groupName }),
+        ...(task.difficulty !== undefined && { difficulty: task.difficulty }),
+    };
+}
+//# sourceMappingURL=filter-tasks.js.map

package/dist/filter-tasks/filter-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-tasks.js","sourceRoot":"","sources":["../../src/filter-tasks/filter-tasks.ts"],"names":[],"mappings":"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"}

package/dist/filter-tasks/filter-tasks.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/filter-tasks/filter-tasks.test.js

@@ -0,0 +1,72 @@
+import { parseTaskId } from '@opentask/taskin-types';
+import { describe, expect, it } from 'vitest';
+import { filterTasks } from './filter-tasks.js';
+function tarefa({ id, ...resto }) {
+    return {
+        createdAt: '2026-09-12T00:00:00.000Z',
+        status: 'pending',
+        title: `Tarefa ${id}`,
+        type: 'feat',
+        ...resto,
+        id: parseTaskId(id),
+    };
+}
+const ANA = { id: 'ana-souza', name: 'Ana Souza', email: 'ana@example.com' };
+const JOAO = { id: 'joao', name: 'João Silva', email: 'joao@example.com' };
+/**
+ * A selecao de tarefas, isolada de como ela e exibida.
+ *
+ * Existiam duas implementacoes divergentes: o comando `list` casava assignee
+ * por substring em nome **ou** id, e o `Taskin.list` casava `userId` exato — e
+ * ainda projetava a task derrubando o proprio `assignee`. Duas respostas
+ * diferentes para a mesma pergunta, e o servidor MCP sem nenhuma.
+ */
+describe('filterTasks', () => {
+    const TAREFAS = [
+        tarefa({ id: '001', status: 'pending', type: 'feat', assignee: ANA, title: 'Criar login' }),
+        tarefa({ id: '002', status: 'done', type: 'fix', assignee: JOAO, title: 'Corrigir crash' }),
+        tarefa({ id: '003', status: 'in-progress', type: 'feat', assignee: ANA, title: 'Painel de metricas' }),
+        tarefa({ id: '004', status: 'blocked', type: 'chore', title: 'Sem responsavel' }),
+        tarefa({ id: '005', status: 'canceled', type: 'docs', assignee: JOAO, title: 'Guia antigo' }),
+    ];
+    it('sem criterio, devolve tudo na ordem recebida', () => {
+        expect(filterTasks(TAREFAS, {}).map((t) => t.id)).toEqual(['001', '002', '003', '004', '005']);
+    });
+    it('filtra por status', () => {
+        expect(filterTasks(TAREFAS, { status: 'done' }).map((t) => t.id)).toEqual(['002']);
+    });
+    it('filtra por tipo', () => {
+        expect(filterTasks(TAREFAS, { type: 'feat' }).map((t) => t.id)).toEqual(['001', '003']);
+    });
+    it('`open` traz o que ainda esta em aberto, e nao o que foi encerrado', () => {
+        expect(filterTasks(TAREFAS, { open: true }).map((t) => t.id)).toEqual(['001', '003', '004']);
+    });
+    it('`closed` traz done e canceled', () => {
+        expect(filterTasks(TAREFAS, { closed: true }).map((t) => t.id)).toEqual(['002', '005']);
+    });
+    it('casa o assignee pelo id, pelo nome e por parte dele', () => {
+        expect(filterTasks(TAREFAS, { assignee: 'ana-souza' }).map((t) => t.id)).toEqual(['001', '003']);
+        expect(filterTasks(TAREFAS, { assignee: 'Ana Souza' }).map((t) => t.id)).toEqual(['001', '003']);
+        expect(filterTasks(TAREFAS, { assignee: 'ana' }).map((t) => t.id)).toEqual(['001', '003']);
+    });
+    it('nao devolve tarefa sem responsavel quando se filtra por um', () => {
+        expect(filterTasks(TAREFAS, { assignee: 'ana' }).map((t) => t.id)).not.toContain('004');
+    });
+    it('o texto livre procura em id, titulo, status e responsavel', () => {
+        expect(filterTasks(TAREFAS, { text: 'crash' }).map((t) => t.id)).toEqual(['002']);
+        expect(filterTasks(TAREFAS, { text: '003' }).map((t) => t.id)).toEqual(['003']);
+        expect(filterTasks(TAREFAS, { text: 'blocked' }).map((t) => t.id)).toEqual(['004']);
+        expect(filterTasks(TAREFAS, { text: 'joão' }).map((t) => t.id)).toEqual(['002', '005']);
+    });
+    it('combina criterios, exigindo todos', () => {
+        expect(filterTasks(TAREFAS, { type: 'feat', assignee: 'ana', status: 'pending' }).map((t) => t.id)).toEqual([
+            '001',
+        ]);
+    });
+    it('nao altera o arranjo recebido', () => {
+        const original = [...TAREFAS];
+        filterTasks(TAREFAS, { status: 'done' });
+        expect(TAREFAS).toEqual(original);
+    });
+});
+//# sourceMappingURL=filter-tasks.test.js.map

package/dist/filter-tasks/filter-tasks.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-tasks.test.js","sourceRoot":"","sources":["../../src/filter-tasks/filter-tasks.test.ts"],"names":[],"mappings":"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"}

package/dist/filter-tasks/filter-tasks.types.d.ts

@@ -0,0 +1,45 @@
+import type { GroupId, TaskId, TaskStatus, TaskType } from '@opentask/taskin-types';
+/**
+ * O que restringe uma listagem de tarefas.
+ *
+ * Todos os campos sao opcionais e **se somam**: informar dois exige os dois.
+ * Um criterio ausente nao restringe nada.
+ *
+ * @public
+ */
+export interface TaskFilterCriteria {
+    /** Status exato. */
+    readonly status?: TaskStatus;
+    /** Tipo exato. */
+    readonly type?: TaskType;
+    /**
+     * Responsavel, casado por id ou nome — inteiro ou em parte, sem distinguir
+     * maiuscula. Tarefa sem responsavel nunca casa.
+     */
+    readonly assignee?: string;
+    /** Apenas o que ainda esta em aberto. Ignorado quando `status` e informado. */
+    readonly open?: boolean;
+    /** Apenas o que foi encerrado. Ignorado quando `status` e informado. */
+    readonly closed?: boolean;
+    /** Busca livre em id, titulo, status e responsavel. */
+    readonly text?: string;
+}
+/**
+ * A forma de uma tarefa numa listagem — o que identifica, nao o que ela diz.
+ *
+ * @public
+ */
+export interface TaskSummary {
+    readonly id: TaskId;
+    readonly title: string;
+    readonly status: TaskStatus;
+    readonly type: TaskType;
+    readonly assignee?: {
+        readonly id: string;
+        readonly name: string;
+    };
+    readonly priority?: number;
+    readonly groupId?: GroupId;
+    readonly groupName?: string;
+    readonly difficulty?: number;
+}

package/dist/filter-tasks/filter-tasks.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filter-tasks.types.js.map

package/dist/filter-tasks/filter-tasks.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-tasks.types.js","sourceRoot":"","sources":["../../src/filter-tasks/filter-tasks.types.ts"],"names":[],"mappings":""}

package/dist/filter-tasks/index.d.ts

@@ -0,0 +1,2 @@
+export { filterTasks, summarizeTask } from './filter-tasks.js';
+export type { TaskFilterCriteria, TaskSummary } from './filter-tasks.types.js';

package/dist/filter-tasks/index.js

@@ -0,0 +1,2 @@
+export { filterTasks, summarizeTask } from './filter-tasks.js';
+//# sourceMappingURL=index.js.map

package/dist/filter-tasks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/filter-tasks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export type { Task, TaskStatus, TaskType, User } from '@opentask/taskin-types';
+export * from './filter-tasks/index.js';
 export * from './metrics.types.js';
 export * from './task-manager.js';
 export * from './task-manager.types.js';

package/dist/index.js

@@ -1,3 +1,4 @@
+export * from './filter-tasks/index.js';
 export * from './metrics.types.js';
 export * from './task-manager.js';
 export * from './task-manager.types.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/task-manager.d.ts

@@ -19,6 +19,14 @@ export declare class TaskManager<TTask extends Task = Task> implements ITaskMana
     private withStatus;
     startTask(taskId: TaskId): Promise<TTask>;
     pauseTask(taskId: TaskId): Promise<TTask>;
+    /**
+     * Every task the configured provider knows about.
+     *
+     * Pass-through on purpose: the manager owns the state transitions, not the
+     * storage. Having it here is what lets a consumer holding only the manager —
+     * the MCP server — answer "what work exists?".
+     */
+    getAllTasks(): Promise<TTask[]>;
     finishTask(taskId: TaskId): Promise<TTask>;
     reviewTask(taskId: TaskId): Promise<TTask>;
     createTask(options: CreateTaskOptions): Promise<CreateTaskResult<TTask>>;

package/dist/task-manager.js

@@ -46,6 +46,16 @@ export class TaskManager {
         await this.taskProvider.updateTask(updatedTask);
         return updatedTask;
     }
+    /**
+     * Every task the configured provider knows about.
+     *
+     * Pass-through on purpose: the manager owns the state transitions, not the
+     * storage. Having it here is what lets a consumer holding only the manager —
+     * the MCP server — answer "what work exists?".
+     */
+    async getAllTasks() {
+        return await this.taskProvider.getAllTasks();
+    }
     async finishTask(taskId) {
         const task = await this.taskProvider.findTask(taskId);
         if (!task) {

package/dist/task-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-manager.js","sourceRoot":"","sources":["../src/task-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-manager.js","sourceRoot":"","sources":["../src/task-manager.ts"],"names":[],"mappings":"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"}

package/dist/task-manager.types.d.ts

@@ -135,6 +135,17 @@ export interface ITaskManager<TTask extends Task = Task> {
      * @throws Error if task is not found
      */
     finishTask: (taskId: TaskId) => Promise<TTask>;
+    /**
+     * Every task the configured provider knows about.
+     *
+     * Delegates to the provider, like {@link ITaskManager.lint} does. Listing is
+     * a domain question — "what work exists?" — and a consumer that only holds a
+     * manager should not need the provider to answer it. The MCP server did, and
+     * shipped a `taskin://tasks` resource that answered with a placeholder.
+     *
+     * @returns The tasks, in whatever order the provider returns them
+     */
+    getAllTasks: () => Promise<TTask[]>;
     /**
      * Mark a task as ready for review.
      * Transitions the task from 'in-progress' to 'in-review' status.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentask/taskin-task-manager",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "description": "Task lifecycle management for Taskin",
   "type": "module",
   "motivation": "To manage the lifecycle of tasks, including creation, status updates, and retrieval.",
@@ -40,7 +40,7 @@
     }
   },
   "dependencies": {
-    "@opentask/taskin-types": "2.1.1"
+    "@opentask/taskin-types": "2.2.0"
   },
   "devDependencies": {
     "typescript": "^6.0.0"

package/src/filter-tasks/filter-tasks.test.ts

@@ -0,0 +1,84 @@
+import { parseTaskId, type Task } from '@opentask/taskin-types';
+import { describe, expect, it } from 'vitest';
+import { filterTasks } from './filter-tasks.js';
+
+function tarefa({ id, ...resto }: Omit<Partial<Task>, 'id'> & { id: string }): Task {
+  return {
+    createdAt: '2026-09-12T00:00:00.000Z',
+    status: 'pending',
+    title: `Tarefa ${id}`,
+    type: 'feat',
+    ...resto,
+    id: parseTaskId(id),
+  };
+}
+
+const ANA = { id: 'ana-souza', name: 'Ana Souza', email: 'ana@example.com' };
+const JOAO = { id: 'joao', name: 'João Silva', email: 'joao@example.com' };
+
+/**
+ * A selecao de tarefas, isolada de como ela e exibida.
+ *
+ * Existiam duas implementacoes divergentes: o comando `list` casava assignee
+ * por substring em nome **ou** id, e o `Taskin.list` casava `userId` exato — e
+ * ainda projetava a task derrubando o proprio `assignee`. Duas respostas
+ * diferentes para a mesma pergunta, e o servidor MCP sem nenhuma.
+ */
+describe('filterTasks', () => {
+  const TAREFAS: readonly Task[] = [
+    tarefa({ id: '001', status: 'pending', type: 'feat', assignee: ANA, title: 'Criar login' }),
+    tarefa({ id: '002', status: 'done', type: 'fix', assignee: JOAO, title: 'Corrigir crash' }),
+    tarefa({ id: '003', status: 'in-progress', type: 'feat', assignee: ANA, title: 'Painel de metricas' }),
+    tarefa({ id: '004', status: 'blocked', type: 'chore', title: 'Sem responsavel' }),
+    tarefa({ id: '005', status: 'canceled', type: 'docs', assignee: JOAO, title: 'Guia antigo' }),
+  ];
+
+  it('sem criterio, devolve tudo na ordem recebida', () => {
+    expect(filterTasks(TAREFAS, {}).map((t) => t.id)).toEqual(['001', '002', '003', '004', '005']);
+  });
+
+  it('filtra por status', () => {
+    expect(filterTasks(TAREFAS, { status: 'done' }).map((t) => t.id)).toEqual(['002']);
+  });
+
+  it('filtra por tipo', () => {
+    expect(filterTasks(TAREFAS, { type: 'feat' }).map((t) => t.id)).toEqual(['001', '003']);
+  });
+
+  it('`open` traz o que ainda esta em aberto, e nao o que foi encerrado', () => {
+    expect(filterTasks(TAREFAS, { open: true }).map((t) => t.id)).toEqual(['001', '003', '004']);
+  });
+
+  it('`closed` traz done e canceled', () => {
+    expect(filterTasks(TAREFAS, { closed: true }).map((t) => t.id)).toEqual(['002', '005']);
+  });
+
+  it('casa o assignee pelo id, pelo nome e por parte dele', () => {
+    expect(filterTasks(TAREFAS, { assignee: 'ana-souza' }).map((t) => t.id)).toEqual(['001', '003']);
+    expect(filterTasks(TAREFAS, { assignee: 'Ana Souza' }).map((t) => t.id)).toEqual(['001', '003']);
+    expect(filterTasks(TAREFAS, { assignee: 'ana' }).map((t) => t.id)).toEqual(['001', '003']);
+  });
+
+  it('nao devolve tarefa sem responsavel quando se filtra por um', () => {
+    expect(filterTasks(TAREFAS, { assignee: 'ana' }).map((t) => t.id)).not.toContain('004');
+  });
+
+  it('o texto livre procura em id, titulo, status e responsavel', () => {
+    expect(filterTasks(TAREFAS, { text: 'crash' }).map((t) => t.id)).toEqual(['002']);
+    expect(filterTasks(TAREFAS, { text: '003' }).map((t) => t.id)).toEqual(['003']);
+    expect(filterTasks(TAREFAS, { text: 'blocked' }).map((t) => t.id)).toEqual(['004']);
+    expect(filterTasks(TAREFAS, { text: 'joão' }).map((t) => t.id)).toEqual(['002', '005']);
+  });
+
+  it('combina criterios, exigindo todos', () => {
+    expect(filterTasks(TAREFAS, { type: 'feat', assignee: 'ana', status: 'pending' }).map((t) => t.id)).toEqual([
+      '001',
+    ]);
+  });
+
+  it('nao altera o arranjo recebido', () => {
+    const original = [...TAREFAS];
+    filterTasks(TAREFAS, { status: 'done' });
+    expect(TAREFAS).toEqual(original);
+  });
+});

package/src/filter-tasks/filter-tasks.ts

@@ -0,0 +1,91 @@
+import type { Task, TaskStatus } from '@opentask/taskin-types';
+import type { TaskFilterCriteria, TaskSummary } from './filter-tasks.types.js';
+
+/**
+ * O que conta como "ainda em aberto".
+ *
+ * `paused` e `in-review` entram: a tarefa nao foi entregue nem descartada, so
+ * nao esta sendo tocada agora. Deixa-las de fora escondia trabalho em curso de
+ * quem filtrava por `--open`.
+ */
+const EM_ABERTO: readonly TaskStatus[] = ['pending', 'in-progress', 'paused', 'in-review', 'blocked'];
+
+const ENCERRADOS: readonly TaskStatus[] = ['done', 'canceled'];
+
+const contem = (valor: string | undefined, procurado: string): boolean =>
+  valor !== undefined && valor.toLowerCase().includes(procurado);
+
+/**
+ * Casa o responsavel por id ou nome, inteiro ou em parte.
+ *
+ * Tarefa sem responsavel nunca casa: filtrar por uma pessoa e perguntar "o que
+ * e dela", e "de ninguem" nao e resposta.
+ */
+function casaResponsavel(task: Task, procurado: string): boolean {
+  const alvo = procurado.toLowerCase();
+  return contem(task.assignee?.id, alvo) || contem(task.assignee?.name, alvo);
+}
+
+/**
+ * Seleciona tarefas por criterio, sem saber como elas serao exibidas.
+ *
+ * Vive aqui, no pacote agnostico, porque a mesma pergunta e feita de tres
+ * lugares: o comando `list`, a saida em JSON e o servidor MCP. Antes eram duas
+ * implementacoes que ja discordavam — o comando casava o responsavel por
+ * substring em nome ou id, e a classe `Taskin` casava `userId` exato.
+ *
+ * Nao ordena e nao muda o arranjo recebido: a ordem que entra e a que sai.
+ *
+ * @public
+ */
+export function filterTasks(tasks: readonly Task[], criteria: TaskFilterCriteria): Task[] {
+  return tasks.filter((task) => {
+    if (criteria.status !== undefined) {
+      if (task.status !== criteria.status) return false;
+    } else if (criteria.open && !EM_ABERTO.includes(task.status)) {
+      return false;
+    } else if (criteria.closed && !ENCERRADOS.includes(task.status)) {
+      return false;
+    }
+
+    if (criteria.type !== undefined && task.type !== criteria.type) return false;
+
+    if (criteria.assignee !== undefined && !casaResponsavel(task, criteria.assignee)) return false;
+
+    if (criteria.text !== undefined) {
+      const procurado = criteria.text.toLowerCase();
+      const casa =
+        task.id.toLowerCase().includes(procurado) ||
+        contem(task.title, procurado) ||
+        contem(task.status, procurado) ||
+        casaResponsavel(task, procurado);
+      if (!casa) return false;
+    }
+
+    return true;
+  });
+}
+
+/**
+ * O que identifica uma tarefa numa listagem, sem o que ela diz.
+ *
+ * O provider de arquivos carrega o markdown inteiro em `content` e
+ * `description`. Incluir isso faria a listagem deste repositorio passar de
+ * vinte mil linhas — e quem lista quer **escolher** uma tarefa, nao le-las
+ * todas. O corpo se busca depois, pelo id.
+ *
+ * @public
+ */
+export function summarizeTask(task: Task): TaskSummary {
+  return {
+    id: task.id,
+    title: task.title,
+    status: task.status,
+    type: task.type,
+    ...(task.assignee && { assignee: { id: task.assignee.id, name: task.assignee.name } }),
+    ...(task.order !== undefined && { priority: task.order }),
+    ...(task.groupId && { groupId: task.groupId }),
+    ...(task.groupName && { groupName: task.groupName }),
+    ...(task.difficulty !== undefined && { difficulty: task.difficulty }),
+  };
+}

package/src/filter-tasks/filter-tasks.types.ts

@@ -0,0 +1,44 @@
+import type { GroupId, TaskId, TaskStatus, TaskType } from '@opentask/taskin-types';
+
+/**
+ * O que restringe uma listagem de tarefas.
+ *
+ * Todos os campos sao opcionais e **se somam**: informar dois exige os dois.
+ * Um criterio ausente nao restringe nada.
+ *
+ * @public
+ */
+export interface TaskFilterCriteria {
+  /** Status exato. */
+  readonly status?: TaskStatus;
+  /** Tipo exato. */
+  readonly type?: TaskType;
+  /**
+   * Responsavel, casado por id ou nome — inteiro ou em parte, sem distinguir
+   * maiuscula. Tarefa sem responsavel nunca casa.
+   */
+  readonly assignee?: string;
+  /** Apenas o que ainda esta em aberto. Ignorado quando `status` e informado. */
+  readonly open?: boolean;
+  /** Apenas o que foi encerrado. Ignorado quando `status` e informado. */
+  readonly closed?: boolean;
+  /** Busca livre em id, titulo, status e responsavel. */
+  readonly text?: string;
+}
+
+/**
+ * A forma de uma tarefa numa listagem — o que identifica, nao o que ela diz.
+ *
+ * @public
+ */
+export interface TaskSummary {
+  readonly id: TaskId;
+  readonly title: string;
+  readonly status: TaskStatus;
+  readonly type: TaskType;
+  readonly assignee?: { readonly id: string; readonly name: string };
+  readonly priority?: number;
+  readonly groupId?: GroupId;
+  readonly groupName?: string;
+  readonly difficulty?: number;
+}

package/src/filter-tasks/index.ts

@@ -0,0 +1,2 @@
+export { filterTasks, summarizeTask } from './filter-tasks.js';
+export type { TaskFilterCriteria, TaskSummary } from './filter-tasks.types.js';

package/src/index.ts

@@ -1,5 +1,6 @@
 // Re-export commonly used types from @opentask/taskin-types for convenience
 export type { Task, TaskStatus, TaskType, User } from '@opentask/taskin-types';
+export * from './filter-tasks/index';
 export * from './metrics.types';
 export * from './task-manager';
 export * from './task-manager.types';

package/src/task-manager.ts

@@ -65,6 +65,17 @@ export class TaskManager<TTask extends Task = Task> implements ITaskManager<TTas
     return updatedTask;
   }
 
+  /**
+   * Every task the configured provider knows about.
+   *
+   * Pass-through on purpose: the manager owns the state transitions, not the
+   * storage. Having it here is what lets a consumer holding only the manager —
+   * the MCP server — answer "what work exists?".
+   */
+  async getAllTasks(): Promise<TTask[]> {
+    return await this.taskProvider.getAllTasks();
+  }
+
   async finishTask(taskId: TaskId): Promise<TTask> {
     const task = await this.taskProvider.findTask(taskId);
 

package/src/task-manager.types.ts

@@ -154,6 +154,18 @@ export interface ITaskManager<TTask extends Task = Task> {
    */
   finishTask: (taskId: TaskId) => Promise<TTask>;
 
+  /**
+   * Every task the configured provider knows about.
+   *
+   * Delegates to the provider, like {@link ITaskManager.lint} does. Listing is
+   * a domain question — "what work exists?" — and a consumer that only holds a
+   * manager should not need the provider to answer it. The MCP server did, and
+   * shipped a `taskin://tasks` resource that answered with a placeholder.
+   *
+   * @returns The tasks, in whatever order the provider returns them
+   */
+  getAllTasks: () => Promise<TTask[]>;
+
   /**
    * Mark a task as ready for review.
    * Transitions the task from 'in-progress' to 'in-review' status.