@opentask/taskin-task-manager 2.0.1 → 3.0.0

package/dist/task-manager.test.js

@@ -1,6 +1,7 @@
+import { parseTaskId } from '@opentask/taskin-types';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { TaskManager } from './task-manager';
-import { createMockTask, createMockTaskProvider } from './task-manager.mock';
+import { TaskManager } from './task-manager.js';
+import { createMockTask, createMockTaskProvider } from './task-manager.mock.js';
 describe('TaskManager', () => {
     let taskManager;
     let mockTaskProvider;
@@ -14,26 +15,48 @@ describe('TaskManager', () => {
     describe('startTask', () => {
         it('should start a pending task', async () => {
             mockTaskProvider.findTask.mockResolvedValue(mockTask);
-            const updatedTask = await taskManager.startTask('task-001');
-            expect(mockTaskProvider.findTask).toHaveBeenCalledWith('task-001');
+            const updatedTask = await taskManager.startTask(parseTaskId('001'));
+            expect(mockTaskProvider.findTask).toHaveBeenCalledWith('001');
             expect(mockTaskProvider.updateTask).toHaveBeenCalledWith(expect.objectContaining({ status: 'in-progress' }));
             expect(updatedTask.status).toBe('in-progress');
         });
         it('should throw an error if task is not found', async () => {
             mockTaskProvider.findTask.mockResolvedValue(undefined);
-            await expect(taskManager.startTask('not-found')).rejects.toThrow("Task with ID 'not-found' not found.");
+            await expect(taskManager.startTask(parseTaskId('999'))).rejects.toThrow("Task with ID '999' not found.");
         });
         it('should throw an error if task is already in progress', async () => {
             const inProgressTask = { ...mockTask, status: 'in-progress' };
             mockTaskProvider.findTask.mockResolvedValue(inProgressTask);
-            await expect(taskManager.startTask('task-001')).rejects.toThrow("Task 'task-001' is already in progress.");
+            await expect(taskManager.startTask(parseTaskId('001'))).rejects.toThrow("Task '001' is already in progress.");
+        });
+    });
+    describe('pauseTask', () => {
+        it('should pause an in-progress task', async () => {
+            const inProgressTask = { ...mockTask, status: 'in-progress' };
+            mockTaskProvider.findTask.mockResolvedValue(inProgressTask);
+            const updatedTask = await taskManager.pauseTask(parseTaskId('001'));
+            expect(mockTaskProvider.updateTask).toHaveBeenCalledWith(expect.objectContaining({ status: 'paused' }));
+            expect(updatedTask.status).toBe('paused');
+        });
+        it('should throw an error if task is not found', async () => {
+            mockTaskProvider.findTask.mockResolvedValue(undefined);
+            await expect(taskManager.pauseTask(parseTaskId('999'))).rejects.toThrow("Task with ID '999' not found.");
+        });
+        it('should throw an error if task is not in-progress', async () => {
+            mockTaskProvider.findTask.mockResolvedValue({ ...mockTask, status: 'pending' });
+            await expect(taskManager.pauseTask(parseTaskId('001'))).rejects.toThrow("Task '001' must be in 'in-progress' status to be paused");
+        });
+        it('should let startTask resume a paused task', async () => {
+            mockTaskProvider.findTask.mockResolvedValue({ ...mockTask, status: 'paused' });
+            const updatedTask = await taskManager.startTask(parseTaskId('001'));
+            expect(updatedTask.status).toBe('in-progress');
         });
     });
     describe('finishTask', () => {
         it('should finish an in-progress task', async () => {
             const inProgressTask = { ...mockTask, status: 'in-progress' };
             mockTaskProvider.findTask.mockResolvedValue(inProgressTask);
-            const updatedTask = await taskManager.finishTask('task-001');
+            const updatedTask = await taskManager.finishTask(parseTaskId('001'));
             expect(mockTaskProvider.updateTask).toHaveBeenCalledWith(expect.objectContaining({ status: 'done' }));
             expect(updatedTask.status).toBe('done');
         });
@@ -42,29 +65,46 @@ describe('TaskManager', () => {
         it('should change status to in-review for an in-progress task', async () => {
             const inProgressTask = { ...mockTask, status: 'in-progress' };
             mockTaskProvider.findTask.mockResolvedValue(inProgressTask);
-            const updatedTask = await taskManager.reviewTask('task-001');
-            expect(mockTaskProvider.findTask).toHaveBeenCalledWith('task-001');
+            const updatedTask = await taskManager.reviewTask(parseTaskId('001'));
+            expect(mockTaskProvider.findTask).toHaveBeenCalledWith('001');
             expect(mockTaskProvider.updateTask).toHaveBeenCalledWith(expect.objectContaining({ status: 'in-review' }));
             expect(updatedTask.status).toBe('in-review');
         });
         it('should throw an error if task is not found', async () => {
             mockTaskProvider.findTask.mockResolvedValue(undefined);
-            await expect(taskManager.reviewTask('not-found')).rejects.toThrow("Task with ID 'not-found' not found.");
+            await expect(taskManager.reviewTask(parseTaskId('999'))).rejects.toThrow("Task with ID '999' not found.");
         });
         it('should throw an error if task is not in-progress', async () => {
             const pendingTask = { ...mockTask, status: 'pending' };
             mockTaskProvider.findTask.mockResolvedValue(pendingTask);
-            await expect(taskManager.reviewTask('task-001')).rejects.toThrow("Task 'task-001' must be in 'in-progress' status to be reviewed");
+            await expect(taskManager.reviewTask(parseTaskId('001'))).rejects.toThrow("Task '001' must be in 'in-progress' status to be reviewed");
         });
         it('should throw an error if task is already done', async () => {
             const doneTask = { ...mockTask, status: 'done' };
             mockTaskProvider.findTask.mockResolvedValue(doneTask);
-            await expect(taskManager.reviewTask('task-001')).rejects.toThrow("Task 'task-001' must be in 'in-progress' status to be reviewed");
+            await expect(taskManager.reviewTask(parseTaskId('001'))).rejects.toThrow("Task '001' must be in 'in-progress' status to be reviewed");
         });
         it('should throw an error if task is already in-review', async () => {
             const reviewTask = { ...mockTask, status: 'in-review' };
             mockTaskProvider.findTask.mockResolvedValue(reviewTask);
-            await expect(taskManager.reviewTask('task-001')).rejects.toThrow("Task 'task-001' must be in 'in-progress' status to be reviewed");
+            await expect(taskManager.reviewTask(parseTaskId('001'))).rejects.toThrow("Task '001' must be in 'in-progress' status to be reviewed");
+        });
+    });
+    describe('provider-specific fields', () => {
+        it('should preserve provider fields through a transition', async () => {
+            const providerTask = {
+                ...createMockTask(),
+                filePath: '/tasks/task-001.md',
+                content: '# Task 001',
+            };
+            const provider = createMockTaskProvider();
+            provider.findTask.mockResolvedValue(providerTask);
+            const manager = new TaskManager(provider);
+            const updated = await manager.startTask(parseTaskId('001'));
+            expect(updated.filePath).toBe('/tasks/task-001.md');
+            expect(updated.content).toBe('# Task 001');
+            expect(updated.status).toBe('in-progress');
+            expect(provider.updateTask).toHaveBeenCalledWith(expect.objectContaining({ filePath: '/tasks/task-001.md' }));
         });
     });
     describe('createTask', () => {
@@ -72,7 +112,6 @@ describe('TaskManager', () => {
             const createOptions = { title: 'New Task', type: 'feat' };
             const createResult = {
                 task: mockTask,
-                taskId: '001',
                 filePath: '/tasks/task-001.md',
             };
             mockTaskProvider.createTask.mockResolvedValue(createResult);
@@ -87,15 +126,17 @@ describe('TaskManager', () => {
                 description: 'Fix something',
                 assignee: 'john-doe',
             };
+            // Antes o assert batia no campo `taskId` do result, que dizia '002'
+            // enquanto o `task` dizia outro id. Com um campo so, o teste tem que
+            // devolver a task que ele afirma ter criado.
             const createResult = {
-                task: mockTask,
-                taskId: '002',
+                task: createMockTask({ id: parseTaskId('002') }),
                 filePath: '/tasks/task-002.md',
             };
             mockTaskProvider.createTask.mockResolvedValue(createResult);
             const result = await taskManager.createTask(createOptions);
             expect(mockTaskProvider.createTask).toHaveBeenCalledWith(createOptions);
-            expect(result.taskId).toBe('002');
+            expect(result.task.id).toBe('002');
         });
     });
     describe('lint', () => {

package/dist/task-manager.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-manager.test.js","sourceRoot":"","sources":["../src/task-manager.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,WAAwB,CAAC;IAC7B,IAAI,gBAA+B,CAAC;IACpC,IAAI,QAAkB,CAAC;IAEvB,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,gBAAgB,GAAG,sBAAsB,EAAE,CAAC;QAC5C,QAAQ,GAAG,cAAc,EAAE,CAAC;QAC5B,WAAW,GAAG,IAAI,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;YAC1C,gBAAgB,CAAC,QAAiB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAEhE,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAE5D,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;YACnE,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,oBAAoB,CACtD,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CACnD,CAAC;YACF,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YACzD,gBAAgB,CAAC,QAAiB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;YACjE,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC9D,qCAAqC,CACtC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,MAAM,cAAc,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC;YACtE,gBAAgB,CAAC,QAAiB,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;YAEtE,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC7D,yCAAyC,CAC1C,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,cAAc,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC;YACtE,gBAAgB,CAAC,QAAiB,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;YAEtE,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAE7D,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,oBAAoB,CACtD,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAC5C,CAAC;YACF,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;YACzE,MAAM,cAAc,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC;YACtE,gBAAgB,CAAC,QAAiB,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;YAEtE,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAE7D,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;YACnE,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,oBAAoB,CACtD,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CACjD,CAAC;YACF,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YACzD,gBAAgB,CAAC,QAAiB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;YAEjE,MAAM,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC/D,qCAAqC,CACtC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;YAChE,MAAM,WAAW,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,SAAkB,EAAE,CAAC;YAC/D,gBAAgB,CAAC,QAAiB,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;YAEnE,MAAM,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC9D,gEAAgE,CACjE,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,MAAe,EAAE,CAAC;YACzD,gBAAgB,CAAC,QAAiB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAEhE,MAAM,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC9D,gEAAgE,CACjE,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,UAAU,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,WAAoB,EAAE,CAAC;YAChE,gBAAgB,CAAC,QAAiB,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAElE,MAAM,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC9D,gEAAgE,CACjE,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,aAAa,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;YACnE,MAAM,YAAY,GAAG;gBACnB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,oBAAoB;aAC/B,CAAC;YAED,gBAAgB,CAAC,UAAmB,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAEtE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAE3D,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;YACxE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;YACxE,MAAM,aAAa,GAAG;gBACpB,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,KAAc;gBACpB,WAAW,EAAE,eAAe;gBAC5B,QAAQ,EAAE,UAAU;aACrB,CAAC;YACF,MAAM,YAAY,GAAG;gBACnB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,oBAAoB;aAC/B,CAAC;YAED,gBAAgB,CAAC,UAAmB,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAEtE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAE3D,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;YACxE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC1D,gBAAgB,CAAC,IAAa,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAE9D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;YAExC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC1D,gBAAgB,CAAC,IAAa,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAE9D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE5C,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACzD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;YAC/D,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC1D,gBAAgB,CAAC,IAAa,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAE9D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAE7C,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC1D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"task-manager.test.js","sourceRoot":"","sources":["../src/task-manager.test.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import type { Task, TaskType, User } from '@opentask/taskin-types';
+import type { Task, TaskId, TaskType } from '@opentask/taskin-types';
 /**
  * Options for creating a new task
  * @public
@@ -14,16 +14,18 @@ export interface CreateTaskOptions {
     assignee?: string;
 }
 /**
- * Result of creating a new task
+ * Result of creating a new task.
+ *
+ * Providers are free to return a wider object (e.g. the file system provider
+ * adds `filePath`); returning extra fields is allowed because the result is
+ * only ever consumed through this contract.
+ *
+ * @typeParam TTask - The task shape produced by the provider
  * @public
  */
-export interface CreateTaskResult {
+export interface CreateTaskResult<TTask extends Task = Task> {
     /** The created task */
-    task: TaskFile;
-    /** The generated task ID */
-    taskId: string;
-    /** The file path where the task was created */
-    filePath: string;
+    task: TTask;
 }
 /**
  * Severity level for validation issues
@@ -62,69 +64,69 @@ export interface LintResult {
     /** Number of info messages */
     infoCount: number;
 }
-/**
- * A task with additional file system metadata.
- * Extends the base Task type with content and path information.
- * @public
- */
-export type TaskFile = Task & {
-    /** The raw markdown content of the task file */
-    content: string;
-    /** Absolute or relative path to the task file */
-    filePath: string;
-    /** The type of work this task represents */
-    type: TaskType;
-    /** Optional user assigned to this task */
-    assignee?: User;
-};
 /**
  * Interface for task storage providers.
  * Implementations handle reading and writing tasks from different sources
- * (e.g., file system, database, API).
+ * (e.g., file system, GitHub issues, Redmine).
+ *
+ * The task shape is a type parameter so that a provider can enrich `Task` with
+ * whatever its backing store requires — the file system provider carries
+ * `content`/`filePath`, a Redmine provider would carry its own fields — without
+ * that shape leaking into this package. Consumers that do not care about the
+ * extra fields can simply use the default and work with plain `Task`.
+ *
+ * @typeParam TTask - The task shape this provider reads and writes
  * @public
  */
-export interface ITaskProvider {
+export interface ITaskProvider<TTask extends Task = Task> {
     /**
      * Initialize the provider, performing any necessary setup or loading.
      * This may involve reading existing tasks, setting up connections, etc.
      */
-    initialize(): Promise<void>;
+    initialize: () => Promise<void>;
     /**
      * Find a specific task by its ID.
      * @param taskId - The unique identifier of the task
      * @returns The task if found, undefined otherwise
      */
-    findTask(taskId: string): Promise<TaskFile | undefined>;
+    findTask: (taskId: TaskId) => Promise<TTask | undefined>;
     /**
      * Retrieve all tasks from the provider.
      * @returns Array of all tasks
      */
-    getAllTasks(): Promise<TaskFile[]>;
+    getAllTasks: () => Promise<TTask[]>;
     /**
      * Update an existing task.
      * @param task - The task with updated information
      */
-    updateTask(task: TaskFile): Promise<void>;
+    updateTask: (task: TTask) => Promise<void>;
     /**
      * Create a new task.
      * @param options - Options for creating the task
      * @returns The created task information
      */
-    createTask(options: CreateTaskOptions): Promise<CreateTaskResult>;
+    createTask: (options: CreateTaskOptions) => Promise<CreateTaskResult<TTask>>;
     /**
      * Validate all tasks managed by this provider.
      * Each provider knows its own format and validation rules.
      * @param fix - If true, attempt to automatically fix validation issues
      * @returns The lint result with any validation issues found
      */
-    lint(fix?: boolean): Promise<LintResult>;
+    lint: (fix?: boolean) => Promise<LintResult>;
 }
 /**
  * Interface for task management operations.
  * Provides high-level methods for managing task workflow and state transitions.
+ *
+ * Mirrors the provider's task shape: a manager built on top of the file system
+ * provider hands back the provider's richer task, while a manager built on any
+ * other provider hands back that provider's shape. This package never needs to
+ * know which one it is.
+ *
+ * @typeParam TTask - The task shape produced by the underlying provider
  * @public
  */
-export interface ITaskManager {
+export interface ITaskManager<TTask extends Task = Task> {
     /**
      * Mark a task as finished.
      * Transitions the task to 'done' status.
@@ -132,7 +134,7 @@ export interface ITaskManager {
      * @returns The updated task
      * @throws Error if task is not found
      */
-    finishTask(taskId: string): Promise<TaskFile>;
+    finishTask: (taskId: TaskId) => Promise<TTask>;
     /**
      * Mark a task as ready for review.
      * Transitions the task from 'in-progress' to 'in-review' status.
@@ -140,26 +142,36 @@ export interface ITaskManager {
      * @returns The updated task
      * @throws Error if task is not found or not in 'in-progress' status
      */
-    reviewTask(taskId: string): Promise<TaskFile>;
+    reviewTask: (taskId: TaskId) => Promise<TTask>;
     /**
      * Start working on a task.
      * Transitions the task to 'in-progress' status.
+     * Also used to resume a paused task.
      * @param taskId - The unique identifier of the task
      * @returns The updated task
      * @throws Error if task is not found, already in progress, or already done
      */
-    startTask(taskId: string): Promise<TaskFile>;
+    startTask: (taskId: TaskId) => Promise<TTask>;
+    /**
+     * Pause work on a task.
+     * Transitions the task from 'in-progress' to 'paused' status.
+     * Resume with {@link ITaskManager.startTask}.
+     * @param taskId - The unique identifier of the task
+     * @returns The updated task
+     * @throws Error if task is not found or not in 'in-progress' status
+     */
+    pauseTask: (taskId: TaskId) => Promise<TTask>;
     /**
      * Create a new task.
      * @param options - Options for creating the task
      * @returns The created task information
      */
-    createTask(options: CreateTaskOptions): Promise<CreateTaskResult>;
+    createTask: (options: CreateTaskOptions) => Promise<CreateTaskResult<TTask>>;
     /**
      * Validate all tasks in the system.
      * Delegates to the underlying provider's lint implementation.
      * @param fix - If true, attempt to automatically fix validation issues
      * @returns The lint result with any validation issues found
      */
-    lint(fix?: boolean): Promise<LintResult>;
+    lint: (fix?: boolean) => Promise<LintResult>;
 }

package/dist/user-registry.contract.d.ts

@@ -0,0 +1,13 @@
+import type { IUserRegistry } from './user-registry.types.js';
+/**
+ * Contract suite every {@link IUserRegistry} implementation must pass.
+ *
+ * Lives in the agnostic package on purpose: a provider-specific registry (file
+ * backed, GitHub, Redmine) proves itself against the same behaviour, and none of
+ * them has to depend on another provider's package to do it. Exported through
+ * the `./testing` subpath so `vitest` never enters the runtime import graph.
+ *
+ * @param createSubject - Builds a fresh, empty registry for each test
+ * @public
+ */
+export declare function runUserRegistryContractTests(createSubject: () => Promise<IUserRegistry>): void;

package/dist/user-registry.contract.js

@@ -0,0 +1,130 @@
+import { describe, expect, it } from 'vitest';
+/**
+ * Contract suite every {@link IUserRegistry} implementation must pass.
+ *
+ * Lives in the agnostic package on purpose: a provider-specific registry (file
+ * backed, GitHub, Redmine) proves itself against the same behaviour, and none of
+ * them has to depend on another provider's package to do it. Exported through
+ * the `./testing` subpath so `vitest` never enters the runtime import graph.
+ *
+ * @param createSubject - Builds a fresh, empty registry for each test
+ * @public
+ */
+export function runUserRegistryContractTests(createSubject) {
+    describe('IUserRegistry contract', () => {
+        describe('saveUser / getUser', () => {
+            it('should store and retrieve a user by ID', async () => {
+                const registry = await createSubject();
+                const user = { id: 'ana', name: 'Ana', email: 'ana@example.com' };
+                await registry.saveUser(user);
+                expect(registry.getUser('ana')).toEqual(user);
+            });
+            it('should return undefined for unknown user', async () => {
+                const registry = await createSubject();
+                expect(registry.getUser('unknown')).toBeUndefined();
+            });
+        });
+        describe('resolveUser', () => {
+            it('should return user by ID with avatar', async () => {
+                const registry = await createSubject();
+                await registry.saveUser({
+                    id: 'joao.silva',
+                    name: 'João Silva',
+                    email: 'joao@example.com',
+                });
+                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$/);
+            });
+            it('should return user by name (case-insensitive)', async () => {
+                const registry = await createSubject();
+                await registry.saveUser({
+                    id: 'maria',
+                    name: 'Maria Souza',
+                    email: 'maria@example.com',
+                });
+                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$/);
+            });
+            it('should return undefined for unknown user', async () => {
+                const registry = await createSubject();
+                const user = registry.resolveUser('unknown');
+                expect(user).toBeUndefined();
+            });
+        });
+        describe('createTemporaryUser', () => {
+            it('should create user with Gravatar URL', 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$/);
+            });
+            it('should create different Gravatar URLs 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);
+            });
+        });
+        describe('ensureCurrentUser', () => {
+            it('should create and return a user when registry is empty', async () => {
+                const registry = await createSubject();
+                const user = await registry.ensureCurrentUser({
+                    name: 'Test User',
+                    email: 'test@test.com',
+                });
+                expect(user.id).toBe('test-user');
+                expect(user.name).toBe('Test User');
+                expect(user.email).toBe('test@test.com');
+            });
+            it('should return existing user when email matches', async () => {
+                const registry = await createSubject();
+                await registry.saveUser({
+                    id: 'maria',
+                    name: 'Maria Souza',
+                    email: 'maria@example.com',
+                });
+                const user = await registry.ensureCurrentUser({
+                    name: 'Maria Souza',
+                    email: 'maria@example.com',
+                });
+                expect(user.id).toBe('maria');
+                expect(registry.getAllUsers()).toHaveLength(1);
+            });
+            it('should create new user when email does not match any existing', async () => {
+                const registry = await createSubject();
+                await registry.saveUser({
+                    id: 'joao',
+                    name: 'João',
+                    email: 'joao@example.com',
+                });
+                const user = await registry.ensureCurrentUser({
+                    name: 'Maria',
+                    email: 'maria@example.com',
+                });
+                expect(user.id).toBe('maria');
+                expect(registry.getAllUsers()).toHaveLength(2);
+            });
+        });
+        describe('getAllUsers', () => {
+            it('should return all saved users', async () => {
+                const registry = await createSubject();
+                await registry.saveUser({ id: 'a', name: 'A', email: 'a@a.com' });
+                await registry.saveUser({ id: 'b', name: 'B', email: 'b@b.com' });
+                const all = registry.getAllUsers();
+                expect(all).toHaveLength(2);
+                expect(all.map((u) => u.id)).toEqual(expect.arrayContaining(['a', 'b']));
+            });
+            it('should return empty array when no users', async () => {
+                const registry = await createSubject();
+                expect(registry.getAllUsers()).toEqual([]);
+            });
+        });
+    });
+}
+//# sourceMappingURL=user-registry.contract.js.map

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

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

package/dist/user-registry.types.d.ts

@@ -0,0 +1,51 @@
+import type { User } from '@opentask/taskin-types';
+/**
+ * Interface for user directories.
+ *
+ * Resolving an assignee to a {@link User} is something every provider needs, and
+ * each one answers it from a different place: the file system provider keeps a
+ * JSON registry in `.taskin/`, a GitHub provider reads the issue's `assignees`
+ * from the API, a Redmine provider queries its own user directory. So this port
+ * lives here, next to {@link ITaskProvider}, and not inside any one provider —
+ * declaring it in the file system package meant a remote provider had to import
+ * from the file system provider just to implement it, the same boundary leak
+ * that `TaskFile` had before task-031.
+ *
+ * A provider receives its registry injected; it never builds one. Implementations
+ * are expected to pass the contract suite exported from
+ * `@opentask/taskin-task-manager/testing`.
+ *
+ * @public
+ */
+export interface IUserRegistry {
+    /** Load the directory into memory, if the implementation needs a warm-up. */
+    load(): Promise<void>;
+    /**
+     * Look up a user by their exact id.
+     * @returns The user, or `undefined` when the id is unknown
+     */
+    getUser(userId: string): User | undefined;
+    /**
+     * Look up a user by id or display name.
+     * @returns The user, or `undefined` when nothing matches
+     */
+    resolveUser(nameOrId: string): User | undefined;
+    /**
+     * Ensure the person running the command exists in the directory, creating the
+     * entry when it does not.
+     * @param gitConfig - Identity to fall back on when the directory has no better source
+     */
+    ensureCurrentUser(gitConfig?: {
+        name: string;
+        email: string;
+    }): Promise<User>;
+    /**
+     * Build an in-memory user for a name that is not in the directory, so an
+     * unknown assignee degrades instead of failing the whole read.
+     */
+    createTemporaryUser(nameOrId: string): User;
+    /** Every user the directory knows about. */
+    getAllUsers(): User[];
+    /** Persist a user in the directory. */
+    saveUser(user: User): Promise<void>;
+}

package/dist/user-registry.types.js

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentask/taskin-task-manager",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "description": "Task lifecycle management for Taskin",
   "type": "module",
   "motivation": "To manage the lifecycle of tasks, including creation, status updates, and retrieval.",
@@ -28,23 +28,31 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "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"
     }
   },
   "dependencies": {
-    "@opentask/taskin-types": "1.1.1"
+    "@opentask/taskin-types": "2.0.0"
   },
   "devDependencies": {
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.0"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node ../../scripts/fix-esm-extensions.mjs dist",
     "clean": "rm -rf dist coverage .turbo",
     "dev": "tsc --watch",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
+    "format": "biome check --write .",
+    "format:check": "biome check .",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit"

package/src/index.ts

@@ -1,6 +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 './metrics.types';
 export * from './task-manager';
 export * from './task-manager.types';
-
-// Re-export commonly used types from @opentask/taskin-types for convenience
-export type { Task, TaskStatus, TaskType, User } from '@opentask/taskin-types';
+export * from './user-registry.types';