@opentask/taskin-task-manager 3.0.2 → 3.2.0

package/dist/numerar-prioridade/numerar-prioridade.test.js

@@ -0,0 +1,55 @@
+import { parseTaskId } from '@opentask/taskin-types';
+import { describe, expect, it } from 'vitest';
+import { numerarPrioridade } from './numerar-prioridade.js';
+const tarefa = (id, order) => ({ id: parseTaskId(id), title: `Tarefa ${id}`, status: 'pending', type: 'feat', order });
+const ids = (ts) => ts.map((t) => String(t.id));
+/**
+ * Numeracao inicial de prioridade.
+ *
+ * Existe para eliminar o estado que custa caro: um projeto **meio numerado**.
+ * Enquanto metade das tarefas nao tem `order`, dar numero a uma do meio obriga a
+ * numerar todos os antecessores — 124 arquivos num projeto de 500, medido. Com o
+ * projeto inteiro numerado de uma vez, num ato deliberado, todo movimento
+ * seguinte custa um arquivo.
+ *
+ * A funcao devolve **so** o que precisa mudar, e nao a lista inteira: quem chama
+ * grava exatamente isso.
+ */
+describe('numerarPrioridade', () => {
+    it('num projeto sem nenhuma prioridade, numera todas preservando a ordem', () => {
+        const tarefas = [tarefa('001'), tarefa('002'), tarefa('003')];
+        const mudancas = numerarPrioridade(tarefas);
+        expect(ids(mudancas)).toEqual(['001', '002', '003']);
+        expect(mudancas.map((t) => t.order)).toEqual([100, 200, 300]);
+    });
+    /*
+     * Quem ja priorizou tomou uma decisao, e o comando preenche as lacunas em
+     * volta dela em vez de reescreve-la.
+     */
+    it('mantem o numero de quem ja tem, e so preenche as lacunas', () => {
+        const tarefas = [tarefa('001', 50), tarefa('002'), tarefa('003', 900)];
+        const mudancas = numerarPrioridade(tarefas);
+        expect(ids(mudancas)).toEqual(['002']);
+        const nova = mudancas[0]?.order ?? 0;
+        expect(nova).toBeGreaterThan(50);
+        expect(nova).toBeLessThan(900);
+    });
+    /*
+     * Seguro de pôr num script ou num hook: a segunda passada nao escreve nada.
+     */
+    it('rodar de novo nao muda nada', () => {
+        const tarefas = [tarefa('001'), tarefa('002'), tarefa('003')];
+        const primeira = numerarPrioridade(tarefas);
+        const segunda = numerarPrioridade(primeira.length ? aplicar(tarefas, primeira) : tarefas);
+        expect(segunda).toEqual([]);
+    });
+    it('nao devolve nada quando todas ja estao numeradas e em ordem', () => {
+        expect(numerarPrioridade([tarefa('001', 100), tarefa('002', 200)])).toEqual([]);
+    });
+});
+/** Aplica as mudancas devolvidas, como quem grava faria. */
+function aplicar(tarefas, mudancas) {
+    const por = new Map(mudancas.map((t) => [String(t.id), t]));
+    return tarefas.map((t) => por.get(String(t.id)) ?? t);
+}
+//# sourceMappingURL=numerar-prioridade.test.js.map

package/dist/numerar-prioridade/numerar-prioridade.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numerar-prioridade.test.js","sourceRoot":"","sources":["../../src/numerar-prioridade/numerar-prioridade.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,KAAc,EAAQ,EAAE,CAClD,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAS,CAAC;AAEnG,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;;;;;;;;;;;GAWG;AACH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAE9D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE5C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH;;;OAGG;IACH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAEvE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE5C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH;;OAEG;IACH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAE9D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAE1F,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,4DAA4D;AAC5D,SAAS,OAAO,CAAC,OAAwB,EAAE,QAAyB;IAClE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/ordenar-tarefas/index.d.ts

@@ -0,0 +1 @@
+export * from './ordenar-tarefas.js';

package/dist/ordenar-tarefas/index.js

@@ -0,0 +1,2 @@
+export * from './ordenar-tarefas.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ordenar-tarefas/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/ordenar-tarefas/ordenar-tarefas.d.ts

@@ -0,0 +1,70 @@
+import type { Task } from '@opentask/taskin-types';
+/**
+ * Como uma listagem pode ser ordenada.
+ *
+ * O mesmo vocabulario que o quadro de priorizacao do dashboard usa. Manter as
+ * grafias iguais entre as superficies vale mais que elegancia local: quem le a
+ * documentacao de uma reconhece a outra.
+ *
+ * @public
+ */
+export type ModoDeOrdenacao = 'manual' | 'diff-asc' | 'diff-desc';
+/**
+ * O que a ordenacao precisa saber, e nada alem disso.
+ *
+ * Exigir `Task` inteira deixaria a funcao inalcancavel para quem tem outra
+ * forma de tarefa — o quadro de priorizacao do dashboard, por exemplo, usa um
+ * modelo de tela proprio. Pedir so os dois campos que ela le e o que permite as
+ * duas superficies compartilharem a regra em vez de cada uma ter a sua copia.
+ *
+ * @public
+ */
+export interface OrdenavelPorPrioridade {
+    readonly order?: number;
+    readonly difficulty?: number;
+}
+/** Um no da listagem: uma tarefa solta, ou um grupo com os membros que casaram. */
+export type NoDaListagem<TTask extends Task = Task> = {
+    readonly kind: 'task';
+    readonly task: TTask;
+} | {
+    readonly kind: 'group';
+    readonly groupId: string;
+    /** `undefined` quando o registro nao conhece o grupo. */
+    readonly groupName: string | undefined;
+    readonly tasks: readonly TTask[];
+    /** Quantos membros o filtro deixou de fora. Zero quando o grupo veio inteiro. */
+    readonly hidden: number;
+};
+/**
+ * Ordena uma listagem, sem alterar a lista recebida.
+ *
+ * Vivia dentro do pacote Vue do dashboard, inalcancavel para a CLI e para o
+ * servidor MCP — e por isso `taskin list` devolvia as tarefas na ordem em que o
+ * provider as achava, que na pratica e por id.
+ *
+ * `manual` usa o `order`, com quem nao tem por ultimo e estabilidade no resto.
+ * Os dois modos de dificuldade usam o `difficulty`.
+ *
+ * @public
+ */
+export declare function ordenarTarefas<TTask extends OrdenavelPorPrioridade>(tarefas: readonly TTask[], modo?: ModoDeOrdenacao): TTask[];
+/**
+ * Junta os membros de um grupo num no so, **por identidade**.
+ *
+ * Separado de {@link ordenarTarefas} de proposito. No dashboard as duas coisas
+ * vinham juntas porque a arvore existia para desenhar caixas; aqui quem consome
+ * decide se quer agrupar.
+ *
+ * Agrupa pelo `groupId`, e nao por adjacencia: membros separados por um filtro
+ * ou por uma ordenacao continuam sendo **um** grupo. Agrupar por adjacencia era
+ * o defeito da task-072, que partia o mesmo grupo em dois nos com o mesmo nome.
+ *
+ * @param tarefas - Ja ordenadas; a ordem dos grupos segue a do primeiro membro
+ * @param nomes - O que o registro de grupos sabe, por id
+ * @param totais - Quantos membros cada grupo tem **antes** do filtro. O que
+ *   falta vira `hidden`, para o leitor saber que nao esta vendo o grupo inteiro
+ *   em vez de o filtro se alargar sozinho e trazer o resto.
+ * @public
+ */
+export declare function agruparTarefas<TTask extends Task>(tarefas: readonly TTask[], nomes?: Readonly<Record<string, string>>, totais?: Readonly<Record<string, number>>): NoDaListagem<TTask>[];

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

@@ -0,0 +1,79 @@
+/**
+ * Ordena uma listagem, sem alterar a lista recebida.
+ *
+ * Vivia dentro do pacote Vue do dashboard, inalcancavel para a CLI e para o
+ * servidor MCP — e por isso `taskin list` devolvia as tarefas na ordem em que o
+ * provider as achava, que na pratica e por id.
+ *
+ * `manual` usa o `order`, com quem nao tem por ultimo e estabilidade no resto.
+ * Os dois modos de dificuldade usam o `difficulty`.
+ *
+ * @public
+ */
+export function ordenarTarefas(tarefas, modo = 'manual') {
+    const comIndice = tarefas.map((task, index) => ({ task, index }));
+    const campo = (t) => (modo === 'manual' ? t.order : t.difficulty);
+    const sinal = modo === 'diff-desc' ? -1 : 1;
+    comIndice.sort((a, b) => {
+        const va = campo(a.task);
+        const vb = campo(b.task);
+        // Quem nao tem valor vai para o fim, qualquer que seja a direcao.
+        if (va === undefined && vb === undefined)
+            return a.index - b.index;
+        if (va === undefined)
+            return 1;
+        if (vb === undefined)
+            return -1;
+        if (va !== vb)
+            return (va - vb) * sinal;
+        return a.index - b.index;
+    });
+    return comIndice.map(({ task }) => task);
+}
+/**
+ * Junta os membros de um grupo num no so, **por identidade**.
+ *
+ * Separado de {@link ordenarTarefas} de proposito. No dashboard as duas coisas
+ * vinham juntas porque a arvore existia para desenhar caixas; aqui quem consome
+ * decide se quer agrupar.
+ *
+ * Agrupa pelo `groupId`, e nao por adjacencia: membros separados por um filtro
+ * ou por uma ordenacao continuam sendo **um** grupo. Agrupar por adjacencia era
+ * o defeito da task-072, que partia o mesmo grupo em dois nos com o mesmo nome.
+ *
+ * @param tarefas - Ja ordenadas; a ordem dos grupos segue a do primeiro membro
+ * @param nomes - O que o registro de grupos sabe, por id
+ * @param totais - Quantos membros cada grupo tem **antes** do filtro. O que
+ *   falta vira `hidden`, para o leitor saber que nao esta vendo o grupo inteiro
+ *   em vez de o filtro se alargar sozinho e trazer o resto.
+ * @public
+ */
+export function agruparTarefas(tarefas, nomes = {}, totais = {}) {
+    const nos = [];
+    const porGrupo = new Map();
+    for (const task of tarefas) {
+        const id = task.groupId === undefined ? undefined : String(task.groupId);
+        if (id === undefined) {
+            nos.push({ kind: 'task', task });
+            continue;
+        }
+        const existente = porGrupo.get(id);
+        if (existente) {
+            existente.push(task);
+            continue;
+        }
+        const membros = [task];
+        porGrupo.set(id, membros);
+        nos.push({
+            kind: 'group',
+            groupId: id,
+            groupName: nomes[id],
+            tasks: membros,
+            hidden: 0,
+        });
+    }
+    return nos.map((no) => no.kind === 'group'
+        ? { ...no, hidden: Math.max(0, (totais[no.groupId] ?? no.tasks.length) - no.tasks.length) }
+        : no);
+}
+//# sourceMappingURL=ordenar-tarefas.js.map

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

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

package/dist/ordenar-tarefas/ordenar-tarefas.test.d.ts

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

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}.
  *
@@ -19,6 +20,38 @@ 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[]>;
+    /** 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}.
  *
@@ -46,6 +47,63 @@ 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();
+    }
+    /** 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.
@@ -135,6 +156,65 @@ 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[]>;
+    /**
+     * 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.
@@ -174,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', () => {