@opentask/taskin-task-manager 3.1.0 → 3.2.0

package/dist/ordenar-tarefas/ordenar-tarefas.test.js

@@ -0,0 +1,70 @@
+import { parseGroupId, parseTaskId } from '@opentask/taskin-types';
+import { describe, expect, it } from 'vitest';
+import { agruparTarefas, ordenarTarefas } from './ordenar-tarefas.js';
+const t = (id, extra = {}) => ({ id: parseTaskId(id), title: `Tarefa ${id}`, status: 'pending', type: 'feat', ...extra });
+const ids = (ts) => ts.map((x) => String(x.id));
+/**
+ * A ordenacao que o dashboard ja usava, agora onde as tres superficies alcancam.
+ *
+ * Ela vivia em `use-prioritization.ts`, dentro do pacote **Vue** — inalcancavel
+ * para a CLI e para o servidor MCP. O `taskin list` devolvia as tarefas na
+ * ordem em que o provider as achava, que na pratica e por id: a coluna de
+ * prioridade subia e descia sem padrao, e quem lia precisava reordenar de
+ * cabeca. Foi assim que um agente autonomo escolheu uma tarefa de prioridade 30
+ * tendo uma de 255 na mesma lista.
+ */
+describe('ordenarTarefas', () => {
+    it('manual ordena por prioridade, com quem nao tem por ultimo', () => {
+        const tarefas = [t('001', { order: 30 }), t('002'), t('003', { order: 10 })];
+        expect(ids(ordenarTarefas(tarefas, 'manual'))).toEqual(['003', '001', '002']);
+    });
+    it('manual e estavel entre empatados', () => {
+        const tarefas = [t('001', { order: 10 }), t('002', { order: 10 }), t('003', { order: 10 })];
+        expect(ids(ordenarTarefas(tarefas, 'manual'))).toEqual(['001', '002', '003']);
+    });
+    it('difficulty ordena do mais facil ao mais dificil, e o inverso', () => {
+        const tarefas = [t('001', { difficulty: 5 }), t('002', { difficulty: 1 }), t('003', { difficulty: 3 })];
+        expect(ids(ordenarTarefas(tarefas, 'diff-asc'))).toEqual(['002', '003', '001']);
+        expect(ids(ordenarTarefas(tarefas, 'diff-desc'))).toEqual(['001', '003', '002']);
+    });
+    it('nao altera a lista recebida', () => {
+        const tarefas = [t('001', { order: 30 }), t('002', { order: 10 })];
+        ordenarTarefas(tarefas, 'manual');
+        expect(ids(tarefas)).toEqual(['001', '002']);
+    });
+});
+/**
+ * Agrupar e separado de ordenar, e de proposito.
+ *
+ * No dashboard as duas coisas vinham juntas porque a arvore era so para
+ * desenhar caixas. Na saida de maquina quem consome decide — e separar deixa a
+ * CLI ordenar sem agrupar quando ninguem pediu grupo.
+ */
+describe('agruparTarefas', () => {
+    const g1 = parseGroupId('g-1');
+    it('junta membros do mesmo grupo, esteja onde estiver na ordem', () => {
+        const tarefas = [t('001', { groupId: g1 }), t('002'), t('003', { groupId: g1 })];
+        const nos = agruparTarefas(tarefas, { 'g-1': 'Sprint' });
+        expect(nos).toHaveLength(2);
+        expect(nos[0]).toMatchObject({ kind: 'group', groupId: 'g-1', groupName: 'Sprint', hidden: 0 });
+        expect(nos[0]?.kind === 'group' && ids(nos[0].tasks)).toEqual(['001', '003']);
+    });
+    /*
+     * O grupo parcial, decidido: mostra os membros que casam, e diz quantos o
+     * filtro escondeu. Nunca alarga o filtro para trazer o grupo inteiro.
+     */
+    it('diz quantos membros o filtro deixou de fora', () => {
+        const tarefas = [t('001', { groupId: g1 })];
+        const nos = agruparTarefas(tarefas, { 'g-1': 'Sprint' }, { 'g-1': 7 });
+        expect(nos[0]).toMatchObject({ kind: 'group', hidden: 6 });
+    });
+    it('tarefa sem grupo fica solta, na ordem em que veio', () => {
+        const nos = agruparTarefas([t('001'), t('002')], {});
+        expect(nos.map((n) => n.kind)).toEqual(['task', 'task']);
+    });
+    it('grupo sem nome no registro ainda aparece, pelo id', () => {
+        const nos = agruparTarefas([t('001', { groupId: g1 })], {});
+        expect(nos[0]).toMatchObject({ kind: 'group', groupId: 'g-1', groupName: undefined });
+    });
+});
+//# sourceMappingURL=ordenar-tarefas.test.js.map

package/dist/ordenar-tarefas/ordenar-tarefas.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordenar-tarefas.test.js","sourceRoot":"","sources":["../../src/ordenar-tarefas/ordenar-tarefas.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtE,MAAM,CAAC,GAAG,CAAC,EAAU,EAAE,QAAuB,EAAE,EAAQ,EAAE,CACxD,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAS,CAAC;AAEtG,MAAM,GAAG,GAAG,CAAC,EAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEjE;;;;;;;;;GASG;AACH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAE7E,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAE5F,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAExG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACnE,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAElC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAE/B,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAEjF,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEzD,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAChG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH;;;OAGG;IACH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAE5C,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAEvE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAErD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAE5D,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/task-manager.d.ts

@@ -1,5 +1,6 @@
 import type { Task, TaskId } from '@opentask/taskin-types';
-import type { CreateTaskOptions, CreateTaskResult, ITaskManager, ITaskProvider, LintResult } from './task-manager.types.js';
+import type { IGroupRegistry } from './group-registry.types.js';
+import type { CreateTaskOptions, CreateTaskResult, CriterioEmAberto, ITaskManager, ITaskProvider, LintResult } from './task-manager.types.js';
 /**
  * Orchestrates task state transitions on top of any {@link ITaskProvider}.
  *
@@ -27,6 +28,30 @@ export declare class TaskManager<TTask extends Task = Task> implements ITaskMana
      * the MCP server — answer "what work exists?".
      */
     getAllTasks(): Promise<TTask[]>;
+    /** Repassa o registro do provider, quando ele tem um. */
+    get groupRegistry(): IGroupRegistry | undefined;
+    prioritizeAll(options?: {
+        dryRun?: boolean;
+    }): Promise<{
+        total: number;
+        withoutPriority: number;
+        changed: number;
+    }>;
+    /**
+     * Conclui a tarefa e **relata** o que ficou em aberto.
+     *
+     * Avisa, e nao recusa. Fechar uma tarefa e um gesto que acontece uma vez,
+     * muitas vezes com pressa; recusar ali torna o comando fragil e ensina a
+     * contornar. O portao duro vive no `lint`, que roda em CI e quebra o build —
+     * aqui o papel e dizer, no momento em que a pessoa ainda esta olhando, o que
+     * ficou para tras.
+     *
+     * Um provider sem a capacidade conclui sem portao nenhum.
+     */
+    finishTaskComRelato(taskId: TaskId): Promise<{
+        task: TTask;
+        blockers: CriterioEmAberto[];
+    }>;
     finishTask(taskId: TaskId): Promise<TTask>;
     reviewTask(taskId: TaskId): Promise<TTask>;
     createTask(options: CreateTaskOptions): Promise<CreateTaskResult<TTask>>;

package/dist/task-manager.js

@@ -1,3 +1,4 @@
+import { numerarPrioridade } from './numerar-prioridade/index.js';
 /**
  * Orchestrates task state transitions on top of any {@link ITaskProvider}.
  *
@@ -56,6 +57,53 @@ export class TaskManager {
     async getAllTasks() {
         return await this.taskProvider.getAllTasks();
     }
+    /** Repassa o registro do provider, quando ele tem um. */
+    get groupRegistry() {
+        return this.taskProvider.groupRegistry;
+    }
+    async prioritizeAll(options = {}) {
+        const tarefas = await this.taskProvider.getAllTasks();
+        /*
+         * Quem ja tem numero define a ordem; quem nao tem entra depois, na sequencia
+         * em que o provider devolveu.
+         */
+        const ordenadas = [...tarefas].sort((a, b) => {
+            if (a.order === undefined && b.order === undefined)
+                return 0;
+            if (a.order === undefined)
+                return 1;
+            if (b.order === undefined)
+                return -1;
+            return a.order - b.order;
+        });
+        const mudancas = numerarPrioridade(ordenadas);
+        const semNumero = tarefas.filter((t) => t.order === undefined).length;
+        if (!options.dryRun) {
+            for (const tarefa of mudancas) {
+                await this.taskProvider.updateTask(tarefa);
+            }
+        }
+        return { total: tarefas.length, withoutPriority: semNumero, changed: mudancas.length };
+    }
+    /**
+     * Conclui a tarefa e **relata** o que ficou em aberto.
+     *
+     * Avisa, e nao recusa. Fechar uma tarefa e um gesto que acontece uma vez,
+     * muitas vezes com pressa; recusar ali torna o comando fragil e ensina a
+     * contornar. O portao duro vive no `lint`, que roda em CI e quebra o build —
+     * aqui o papel e dizer, no momento em que a pessoa ainda esta olhando, o que
+     * ficou para tras.
+     *
+     * Um provider sem a capacidade conclui sem portao nenhum.
+     */
+    async finishTaskComRelato(taskId) {
+        const task = await this.taskProvider.findTask(taskId);
+        if (!task)
+            throw new Error(`Task with ID '${taskId}' not found.`);
+        const blockers = (await this.taskProvider.getCompletionBlockers?.(task)) ?? [];
+        const atualizada = await this.finishTask(taskId);
+        return { task: atualizada, blockers };
+    }
     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

@@ -1,4 +1,5 @@
 import type { Task, TaskId, TaskType } from '@opentask/taskin-types';
+import type { IGroupRegistry } from './group-registry.types.js';
 /**
  * Options for creating a new task
  * @public
@@ -36,6 +37,13 @@ export type ValidationSeverity = 'error' | 'warning' | 'info';
  * A validation error or warning found during linting
  * @public
  */
+/** Um criterio que ainda impede a conclusao. */
+export interface CriterioEmAberto {
+    /** O texto do item, como escrito. */
+    readonly texto: string;
+    /** Onde ele esta, quando a fonte sabe dizer. */
+    readonly linha?: number;
+}
 export interface ValidationIssue {
     /** The file or task that has the issue */
     file: string;
@@ -113,6 +121,19 @@ export interface ITaskProvider<TTask extends Task = Task> {
      * @returns The lint result with any validation issues found
      */
     lint: (fix?: boolean) => Promise<LintResult>;
+    /**
+     * Os criterios de conclusao que ainda bloqueiam esta tarefa, se a fonte tiver
+     * o conceito.
+     *
+     * **Opcional de proposito.** Checklist e uma forma do provider de arquivos: o
+     * Jira tem subtarefas, o GitHub tem itens de lista na descricao. Um provider
+     * sem nada equivalente simplesmente nao implementa, e o `finishTask` conclui
+     * sem portao — em vez de chamar algo que falha.
+     *
+     * O conceito e de dominio ("o que falta para isto estar pronto?"); a
+     * representacao e de provider.
+     */
+    getCompletionBlockers?: (task: TTask) => Promise<CriterioEmAberto[]>;
 }
 /**
  * Interface for task management operations.
@@ -146,6 +167,54 @@ export interface ITaskManager<TTask extends Task = Task> {
      * @returns The tasks, in whatever order the provider returns them
      */
     getAllTasks: () => Promise<TTask[]>;
+    /**
+     * Da a cada tarefa um numero de prioridade, de uma vez.
+     *
+     * E operacao de dominio, e nao um `updateTask` generico, por dois motivos.
+     *
+     * O primeiro e de desenho: a regra da numeracao — preservar a ordem, manter o
+     * numero de quem ja tem, abrir espaco quando faltar — passa a viver num lugar
+     * so, em vez de ser reescrita pela CLI e pelo servidor MCP.
+     *
+     * O segundo e de tipo: um metodo que **consome** `TTask` torna a interface
+     * contravariante nele, e um `ITaskManager<TarefaEspecifica>` deixa de poder
+     * ser usado onde se espera `ITaskManager<Task>`. Uma operacao que so devolve
+     * numeros nao tem esse problema.
+     *
+     * Existe porque um projeto **meio numerado** cobra caro: mover uma tarefa do
+     * meio da regiao sem numero reescreve todos os antecessores — 124 arquivos num
+     * projeto de 500, medido. Depois desta operacao, todo movimento custa um.
+     *
+     * @param options - `dryRun` apenas conta, sem gravar
+     * @returns Quantas existem, quantas estavam sem numero, e quantas mudaram
+     */
+    /**
+     * Os grupos, quando a fonte tem o conceito — `undefined` quando nao tem.
+     *
+     * Opcional de proposito: o GitHub mapeia para milestone, o Redmine para
+     * categoria, e uma fonte sem nada equivalente simplesmente nao oferece. Quem
+     * consome descobre pela ausencia, em vez de chamar algo que falha.
+     */
+    readonly groupRegistry?: IGroupRegistry;
+    /**
+     * Conclui a tarefa e relata os criterios que ficaram em aberto.
+     *
+     * Avisa, e nao recusa: fechar e um gesto unico, muitas vezes com pressa, e
+     * recusar ali torna o comando fragil. O portao duro vive no `lint`.
+     *
+     * O relato vem vazio quando o provider nao tem o conceito de checklist.
+     */
+    finishTaskComRelato: (taskId: TaskId) => Promise<{
+        task: TTask;
+        blockers: CriterioEmAberto[];
+    }>;
+    prioritizeAll: (options?: {
+        dryRun?: boolean;
+    }) => Promise<{
+        total: number;
+        withoutPriority: number;
+        changed: number;
+    }>;
     /**
      * Mark a task as ready for review.
      * Transitions the task from 'in-progress' to 'in-review' status.
@@ -185,4 +254,17 @@ export interface ITaskManager<TTask extends Task = Task> {
      * @returns The lint result with any validation issues found
      */
     lint: (fix?: boolean) => Promise<LintResult>;
+    /**
+     * Os criterios de conclusao que ainda bloqueiam esta tarefa, se a fonte tiver
+     * o conceito.
+     *
+     * **Opcional de proposito.** Checklist e uma forma do provider de arquivos: o
+     * Jira tem subtarefas, o GitHub tem itens de lista na descricao. Um provider
+     * sem nada equivalente simplesmente nao implementa, e o `finishTask` conclui
+     * sem portao — em vez de chamar algo que falha.
+     *
+     * O conceito e de dominio ("o que falta para isto estar pronto?"); a
+     * representacao e de provider.
+     */
+    getCompletionBlockers?: (task: TTask) => Promise<CriterioEmAberto[]>;
 }

package/dist/testing.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Contratos que as implementacoes provam contra si mesmas.
+ *
+ * Exportado por `@opentask/taskin-task-manager/testing` para o `vitest` nunca
+ * entrar no grafo de execucao do pacote.
+ */
+export * from './group-registry.contract.js';
+export * from './user-registry.contract.js';

package/dist/testing.js

@@ -0,0 +1,9 @@
+/**
+ * Contratos que as implementacoes provam contra si mesmas.
+ *
+ * Exportado por `@opentask/taskin-task-manager/testing` para o `vitest` nunca
+ * entrar no grafo de execucao do pacote.
+ */
+export * from './group-registry.contract.js';
+export * from './user-registry.contract.js';
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC"}

package/dist/user-registry.contract.js

@@ -35,7 +35,7 @@ export function runUserRegistryContractTests(createSubject) {
                 const user = registry.resolveUser('joao.silva');
                 expect(user).toBeDefined();
                 expect(user.id).toBe('joao.silva');
-                expect(user.avatar).toMatch(/^https:\/\/www\.gravatar\.com\/avatar\/[a-f0-9]{32}\?d=mp$/);
+                expect(user.avatarHash).toMatch(/^[a-f0-9]{32}$/);
             });
             it('should return user by name (case-insensitive)', async () => {
                 const registry = await createSubject();
@@ -47,7 +47,7 @@ export function runUserRegistryContractTests(createSubject) {
                 const user = registry.resolveUser('Maria Souza');
                 expect(user).toBeDefined();
                 expect(user.id).toBe('maria');
-                expect(user.avatar).toMatch(/^https:\/\/www\.gravatar\.com\/avatar\/[a-f0-9]{32}\?d=mp$/);
+                expect(user.avatarHash).toMatch(/^[a-f0-9]{32}$/);
             });
             it('should return undefined for unknown user', async () => {
                 const registry = await createSubject();
@@ -56,19 +56,19 @@ export function runUserRegistryContractTests(createSubject) {
             });
         });
         describe('createTemporaryUser', () => {
-            it('should create user with Gravatar URL', async () => {
+            it('should create user with an avatar identity hash', async () => {
                 const registry = await createSubject();
                 const user = registry.createTemporaryUser('Carlos');
                 expect(user.id).toBe('carlos');
                 expect(user.name).toBe('Carlos');
                 expect(user.email).toBe('carlos@example.com');
-                expect(user.avatar).toMatch(/^https:\/\/www\.gravatar\.com\/avatar\/[a-f0-9]{32}\?d=mp$/);
+                expect(user.avatarHash).toMatch(/^[a-f0-9]{32}$/);
             });
-            it('should create different Gravatar URLs for different inputs', async () => {
+            it('should create different avatar hashes for different inputs', async () => {
                 const registry = await createSubject();
                 const user1 = registry.createTemporaryUser('Alice');
                 const user2 = registry.createTemporaryUser('Bob');
-                expect(user1.avatar).not.toBe(user2.avatar);
+                expect(user1.avatarHash).not.toBe(user2.avatarHash);
             });
         });
         describe('ensureCurrentUser', () => {

package/dist/user-registry.contract.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentask/taskin-task-manager",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Task lifecycle management for Taskin",
   "type": "module",
   "motivation": "To manage the lifecycle of tasks, including creation, status updates, and retrieval.",
@@ -33,14 +33,15 @@
       "default": "./dist/index.js"
     },
     "./testing": {
-      "types": "./dist/user-registry.contract.d.ts",
-      "import": "./dist/user-registry.contract.js",
-      "require": "./dist/user-registry.contract.js",
-      "default": "./dist/user-registry.contract.js"
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "require": "./dist/testing.js",
+      "default": "./dist/testing.js"
     }
   },
   "dependencies": {
-    "@opentask/taskin-types": "2.2.0"
+    "zod": "^4.5.4",
+    "@opentask/taskin-types": "2.3.0"
   },
   "devDependencies": {
     "typescript": "^6.0.0"

package/src/completion-blockers.test.ts

@@ -0,0 +1,77 @@
+import { parseTaskId, type Task } from '@opentask/taskin-types';
+import { describe, expect, it, vi } from 'vitest';
+import { TaskManager } from './task-manager.js';
+import type { ITaskProvider } from './task-manager.types.js';
+
+const tarefa = (extra: Partial<Task> = {}): Task =>
+  ({ id: parseTaskId('001'), title: 'Uma tarefa', status: 'in-progress', type: 'feat', ...extra }) as Task;
+
+function provider(overrides: Partial<ITaskProvider> = {}): ITaskProvider {
+  return {
+    initialize: vi.fn(async () => {}),
+    findTask: vi.fn(async () => tarefa()),
+    getAllTasks: vi.fn(async () => [tarefa()]),
+    updateTask: vi.fn(async () => {}),
+    createTask: vi.fn(),
+    lint: vi.fn(),
+    ...overrides,
+  } as unknown as ITaskProvider;
+}
+
+/**
+ * O aviso no `finish`, e por que ele **avisa** em vez de recusar.
+ *
+ * Fechar uma tarefa e um gesto que acontece uma vez, muitas vezes com pressa.
+ * Recusar ali torna o comando fragil e ensina a contornar. O portao duro vive no
+ * `lint` (task-075), que roda em CI e quebra o build; aqui o papel e outro —
+ * dizer, no momento em que a pessoa ainda esta olhando, o que ficou para tras.
+ *
+ * E uma **capacidade opcional** do provider: nem toda fonte tem checklist. Um
+ * provider sem ela conclui sem portao nenhum, em vez de receber uma chamada que
+ * falha.
+ */
+describe('finishTask e os criterios em aberto', () => {
+  it('conclui em silencio quando o provider nao tem a capacidade', async () => {
+    const manager = new TaskManager(provider());
+
+    const { blockers } = await manager.finishTaskComRelato(parseTaskId('001'));
+
+    expect(blockers).toEqual([]);
+  });
+
+  it('relata os itens em aberto que o provider aponta', async () => {
+    const manager = new TaskManager(
+      provider({
+        getCompletionBlockers: vi.fn(async () => [{ texto: 'Documentar', linha: 12 }]),
+      } as Partial<ITaskProvider>),
+    );
+
+    const { blockers } = await manager.finishTaskComRelato(parseTaskId('001'));
+
+    expect(blockers).toHaveLength(1);
+    expect(blockers[0]?.texto).toBe('Documentar');
+  });
+
+  it('conclui mesmo assim: avisa, e nao recusa', async () => {
+    const updateTask = vi.fn(async () => {});
+    const manager = new TaskManager(
+      provider({
+        updateTask,
+        getCompletionBlockers: vi.fn(async () => [{ texto: 'Documentar', linha: 12 }]),
+      } as Partial<ITaskProvider>),
+    );
+
+    const { task } = await manager.finishTaskComRelato(parseTaskId('001'));
+
+    expect(task.status).toBe('done');
+    expect(updateTask).toHaveBeenCalled();
+  });
+
+  it('nao relata nada quando tudo esta feito ou adiado', async () => {
+    const manager = new TaskManager(
+      provider({ getCompletionBlockers: vi.fn(async () => []) } as Partial<ITaskProvider>),
+    );
+
+    expect((await manager.finishTaskComRelato(parseTaskId('001'))).blockers).toEqual([]);
+  });
+});

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

@@ -0,0 +1,113 @@
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import {
+  type CriterionSurface,
+  FILTER_CRITERIA_SURFACES,
+  FilterCriteriaSchema,
+  filterCriteriaCliOptions,
+  filterCriteriaJsonSchema,
+  parseFilterCriteria,
+  type TaskFilterCriteria,
+} from './filter-criteria.js';
+
+/**
+ * Um criterio sem superficie e **erro de compilacao**, e nao aviso em tempo de
+ * execucao. Esta linha e a prova: um mapa que cobre `TaskFilterCriteria` menos a
+ * chave `text` nao satisfaz o gate por tipo. O `@ts-expect-error` falha o
+ * `typecheck` se um dia a omissao passar a compilar — que e o defeito que a task
+ * fecha.
+ */
+const semText = { status: FILTER_CRITERIA_SURFACES.status };
+// @ts-expect-error — falta a chave 'text': um criterio sem superficie nao compila.
+const _gateIncompleto: Record<keyof TaskFilterCriteria, CriterionSurface> = semText;
+void _gateIncompleto;
+
+/**
+ * Uma definicao so para os criterios de filtro.
+ *
+ * A propriedade que vale nao afirma a forma do schema — afirma que um criterio
+ * definido num lugar so **aparece nas duas superficies** sem edicao manual. Por
+ * isso os geradores recebem um schema e superficies: o teste acrescenta um
+ * criterio ficticio e prova que ele emerge na CLI e no MCP, o que so e possivel
+ * se as superficies derivarem, em vez de repetir a lista a mao.
+ */
+describe('criterios de filtro derivam de uma definicao so', () => {
+  const schemaEstendido = FilterCriteriaSchema.extend({ fictional: z.string().optional() });
+  const superficiesEstendidas = {
+    ...FILTER_CRITERIA_SURFACES,
+    fictional: { description: 'criterio ficticio para o teste', cli: { kind: 'flag' as const } },
+  };
+
+  it('um criterio novo aparece no schema JSON do MCP sem editar o MCP', () => {
+    const json = filterCriteriaJsonSchema(schemaEstendido, superficiesEstendidas);
+
+    expect(json.properties).toHaveProperty('fictional');
+    expect((json.properties.fictional as { description?: string }).description).toBe('criterio ficticio para o teste');
+  });
+
+  it('um criterio novo aparece nas opcoes da CLI sem editar a CLI', () => {
+    const opcoes = filterCriteriaCliOptions(schemaEstendido, superficiesEstendidas);
+
+    const ficticia = opcoes.find((o) => o.flags.includes('--fictional'));
+    expect(ficticia).toBeDefined();
+    expect(ficticia?.description).toBe('criterio ficticio para o teste');
+  });
+
+  it('cada criterio do schema tem uma superficie — nenhum fica para tras', () => {
+    const doSchema = Object.keys(FilterCriteriaSchema.shape).sort();
+    const comSuperficie = Object.keys(FILTER_CRITERIA_SURFACES).sort();
+
+    expect(comSuperficie).toEqual(doSchema);
+  });
+});
+
+describe('o schema JSON derivado do MCP', () => {
+  it('descreve todo criterio, e usa enum onde o valor e fechado', () => {
+    const json = filterCriteriaJsonSchema();
+
+    expect(json.type).toBe('object');
+    expect(json.required).toEqual([]);
+    // status e um conjunto fechado: o schema JSON traz o enum, e nao string solta.
+    expect((json.properties.status as { enum?: string[] }).enum).toContain('pending');
+    expect((json.properties.open as { type?: string }).type).toBe('boolean');
+  });
+});
+
+describe('as opcoes derivadas da CLI', () => {
+  it('booleano nao leva valor; os demais levam <chave>', () => {
+    const opcoes = filterCriteriaCliOptions();
+    const porFlag = (frag: string) => opcoes.find((o) => o.flags.includes(frag));
+
+    expect(porFlag('--open')?.flags).toBe('--open');
+    expect(porFlag('--status')?.flags).toBe('-s, --status <status>');
+  });
+
+  it('unifica a grafia: a flag do responsavel e --assignee, e nao --user', () => {
+    const opcoes = filterCriteriaCliOptions();
+
+    expect(opcoes.some((o) => o.flags.includes('--assignee'))).toBe(true);
+    expect(opcoes.some((o) => o.flags.includes('--user'))).toBe(false);
+  });
+
+  it('o texto livre e argumento posicional, e nao vira flag', () => {
+    const opcoes = filterCriteriaCliOptions();
+
+    expect(opcoes.some((o) => o.flags.includes('--text'))).toBe(false);
+  });
+});
+
+describe('parseFilterCriteria', () => {
+  it('descarta chaves que nao sao criterio, como o --json', () => {
+    const criteria = parseFilterCriteria({ status: 'done', json: true, foo: 1 });
+
+    expect(criteria).toEqual({ status: 'done' });
+  });
+
+  it('falha barulhento num valor fora do conjunto, em vez de silenciar', () => {
+    expect(() => parseFilterCriteria({ status: 'inexistente' })).toThrow();
+  });
+
+  it('objeto vazio e um criterio valido que nao restringe nada', () => {
+    expect(parseFilterCriteria({})).toEqual({});
+  });
+});