@opentask/taskin-task-manager 1.0.6

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+
+> @opentask/taskin-task-manager@1.0.6 build /Users/sidarta/repositorios/taskin/packages/task-manager
+> tsc
+

package/.turbo/turbo-format.log

@@ -0,0 +1,31 @@
+
+
+> @opentask/taskin-task-manager@1.0.5 format /Users/sidarta/repositorios/taskin/packages/task-manager
+> prettier --write .
+
+.turbo/turbo-build.log.turbo/turbo-format.log.turbo/turbo-test.logdist/index.d.tsdist/index.d.ts 59ms (unchanged)
+dist/index.jsdist/index.js 12ms (unchanged)
+dist/index.js.mapdist/metrics.types.d.tsdist/metrics.types.d.ts 19ms (unchanged)
+dist/metrics.types.jsdist/metrics.types.js 3ms (unchanged)
+dist/metrics.types.js.mapdist/provider-stats.test.d.tsdist/provider-stats.test.d.ts 2ms (unchanged)
+dist/provider-stats.test.jsdist/provider-stats.test.js 13ms (unchanged)
+dist/provider-stats.test.js.mapdist/task-manager.d.tsdist/task-manager.d.ts 8ms (unchanged)
+dist/task-manager.jsdist/task-manager.js 19ms (unchanged)
+dist/task-manager.js.mapdist/task-manager.mock.d.tsdist/task-manager.mock.d.ts 8ms (unchanged)
+dist/task-manager.mock.jsdist/task-manager.mock.js 6ms (unchanged)
+dist/task-manager.mock.js.mapdist/task-manager.test.d.tsdist/task-manager.test.d.ts 5ms (unchanged)
+dist/task-manager.test.jsdist/task-manager.test.js 25ms (unchanged)
+dist/task-manager.test.js.mapdist/task-manager.types.d.tsdist/task-manager.types.d.ts 19ms (unchanged)
+dist/task-manager.types.jsdist/task-manager.types.js 2ms (unchanged)
+dist/task-manager.types.js.mapeslint.config.jseslint.config.js 9ms (unchanged)
+package.jsonpackage.json 7ms (unchanged)
+README.mdREADME.md 26ms (unchanged)
+src/index.tssrc/index.ts 4ms (unchanged)
+src/metrics.types.tssrc/metrics.types.ts 14ms (unchanged)
+src/provider-stats.test.tssrc/provider-stats.test.ts 8ms (unchanged)
+src/task-manager.mock.tssrc/task-manager.mock.ts 13ms (unchanged)
+src/task-manager.test.tssrc/task-manager.test.ts 48ms (unchanged)
+src/task-manager.tssrc/task-manager.ts 27ms (unchanged)
+src/task-manager.types.tssrc/task-manager.types.ts 9ms (unchanged)
+tsconfig.jsontsconfig.json 2ms (unchanged)
+tsconfig.tsbuildinfovitest.config.tsvitest.config.ts 4ms (unchanged)

package/.turbo/turbo-test.log

@@ -0,0 +1,15 @@
+
+> @opentask/taskin-task-manager@1.0.5 test /Users/sidarta/repositorios/taskin/packages/task-manager
+> vitest run
+
+
+ RUN  v4.0.16 /Users/sidarta/repositorios/taskin/packages/task-manager
+
+ ✓ src/provider-stats.test.ts (1 test) 1ms
+ ✓ src/task-manager.test.ts (9 tests) 60ms
+
+ Test Files  2 passed (2)
+      Tests  10 passed (10)
+   Start at  09:48:51
+   Duration  496ms (transform 59ms, setup 0ms, import 108ms, tests 62ms, environment 0ms)
+

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @opentask/taskin-task-manager
+
+## 1.0.6
+
+### Patch Changes
+
+- chore: publish packages required by taskin CLI

package/README.md

@@ -0,0 +1,84 @@
+# Task Manager — Metrics Interface
+
+This document describes the new `IMetricsManager` interface introduced to
+separate metrics/analytics responsibilities from the core `ITaskProvider`.
+
+## Motivation
+
+Previously the `ITaskProvider` exposed optional methods for statistics
+(`getUserStats`, `getTeamStats`, `getTaskStats`). To keep provider
+implementations focused on storage concerns and to provide a clearer
+contract for analytics, we introduced `IMetricsManager` as a dedicated
+interface for metrics/analytics.
+
+## Interface
+
+The interface lives at `packages/task-manager/src/metrics.types.ts`:
+
+- `getUserMetrics(userId: string, query?: StatsQuery): Promise<UserStats>`
+- `getTeamMetrics(teamId: string, query?: StatsQuery): Promise<TeamStats>`
+- `getTaskMetrics(taskId: string, query?: StatsQuery): Promise<TaskStats>`
+
+Types are re-used from `@opentask/taskin-types` (`UserStats`, `TeamStats`,
+`TaskStats`, `StatsQuery`).
+
+## Migration guide
+
+1. Remove any optional stats methods from provider implementations. The
+   methods were removed from `ITaskProvider` to avoid mixing concerns.
+2. Implement an adapter/service that implements `IMetricsManager` and
+   register it alongside your provider (for example, provide it to the
+   application bootstrap or dependency injection container).
+3. If you need to preserve backward compatibility, expose a thin adapter
+   that translates the old provider-level methods to the new
+   `IMetricsManager` API until consumers migrate.
+
+## Example
+
+Minimal example of an in-process metrics adapter (pseudo-code):
+
+```ts
+import type { IMetricsManager } from '@opentask/taskin-task-manager';
+import type { UserStats, StatsQuery } from '@opentask/taskin-types';
+
+export class FsMetricsAdapter implements IMetricsManager {
+  constructor(private fsProvider: any) {}
+
+  async getUserMetrics(userId: string, query?: StatsQuery): Promise<UserStats> {
+    // Aggregate tasks from fsProvider and compute simple metrics
+    const tasks = await this.fsProvider.getAllTasks();
+    const userTasks = tasks.filter((t) => t.assignee?.id === userId);
+    return { userId, taskCount: userTasks.length } as any;
+  }
+
+  // getTeamMetrics / getTaskMetrics implementations...
+}
+```
+
+## Compatibility and Versioning
+
+- This change is a breaking API change for providers: `ITaskProvider`
+  no longer contains stats methods. New providers should implement
+  `IMetricsManager` instead.
+- For consumers, prefer depending on `IMetricsManager` for analytics
+  features. If a provider exposes metrics through a different channel,
+  adapt it to `IMetricsManager`.
+
+## Tests
+
+There is a small unit test validating the contract at
+`packages/task-manager/src/provider-stats.test.ts` (now checks the
+`IMetricsManager` shape).
+
+---
+
+If you want, I can:
+
+- Add an example adapter implementation in `file-system-task-provider`.
+- Add documentation to the repo-level `docs/` folder and cross-links.
+
+Tell me which and I’ll implement it.
+
+# @taskin/task-manager
+
+This package is responsible for the core logic of managing tasks.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { Task, TaskStatus, TaskType, User } from '@opentask/taskin-types';
+export * from './task-manager';
+export * from './task-manager.types';

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './task-manager';
+export * from './task-manager.types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/metrics.types.d.ts

@@ -0,0 +1,92 @@
+import type {
+  StatsQuery,
+  TaskStats,
+  TeamStats,
+  UserStats,
+} from '@opentask/taskin-types';
+/**
+ * Manages metrics and statistics for users, teams, and tasks.
+ * Aggregates data from Git history and task files to provide productivity insights.
+ *
+ * @remarks
+ * This interface separates analytics/reporting responsibilities from ITaskProvider,
+ * following the Single Responsibility Principle.
+ *
+ * @example
+ * ```ts
+ * const metrics = new FileSystemMetricsAdapter(tasksDir, userRegistry, gitAnalyzer);
+ * const stats = await metrics.getUserMetrics('john-doe', { period: 'week' });
+ * console.log(`Commits: ${stats.codeMetrics.commits}`);
+ * ```
+ *
+ * @public
+ */
+export interface IMetricsManager {
+  /**
+   * Get productivity metrics for a specific user.
+   *
+   * Includes code metrics (commits, lines of code), temporal patterns
+   * (day of week, time of day), and engagement statistics (completion rate, streaks).
+   *
+   * @param userId - User identifier (username or registry ID)
+   * @param query - Optional query parameters to filter results
+   * @param query.period - Time period to analyze ('day' | 'week' | 'month' | 'year')
+   * @returns Promise resolving to user statistics
+   *
+   * @example
+   * ```ts
+   * const stats = await metrics.getUserMetrics('alice', { period: 'month' });
+   * console.log(`Tasks completed: ${stats.contributionMetrics.tasksCompleted}`);
+   * console.log(`Completion rate: ${(stats.engagementMetrics.completionRate * 100).toFixed(1)}%`);
+   * ```
+   */
+  getUserMetrics(userId: string, query?: StatsQuery): Promise<UserStats>;
+  /**
+   * Get aggregated metrics for an entire team.
+   *
+   * Provides overview of team productivity with breakdown by individual contributors.
+   * Useful for team retrospectives, capacity planning, and identifying top contributors.
+   *
+   * @param teamId - Team identifier
+   * @param query - Optional query parameters to filter results
+   * @returns Promise resolving to team statistics with per-contributor breakdown
+   *
+   * @example
+   * ```ts
+   * const stats = await metrics.getTeamMetrics('frontend', { period: 'week' });
+   * console.log(`Total commits: ${stats.totalCommits}`);
+   * console.log(`Contributors: ${stats.totalContributors}`);
+   * stats.contributors.forEach(c => {
+   *   console.log(`${c.username}: ${c.commits} commits, ${c.tasksCompleted} tasks`);
+   * });
+   * ```
+   */
+  getTeamMetrics(teamId: string, query?: StatsQuery): Promise<TeamStats>;
+  /**
+   * Get detailed metrics for a specific task.
+   *
+   * Includes timeline analysis, contributor activity, code impact metrics,
+   * and work patterns. Useful for task retrospectives and understanding
+   * effort distribution.
+   *
+   * @param taskId - Task identifier (task number like '015' or full ID like 'task-015')
+   * @param query - Optional query parameters
+   * @returns Promise resolving to task-specific statistics
+   *
+   * @example
+   * ```ts
+   * const stats = await metrics.getTaskMetrics('task-015', {});
+   * console.log(`Duration: ${stats.duration} days`);
+   * console.log(`Contributors: ${stats.contributors.map(c => c.name).join(', ')}`);
+   * if (stats.refactoringMetrics) {
+   *   console.log(`Simplification ratio: ${stats.refactoringMetrics.simplificationRatio.toFixed(2)}x`);
+   * }
+   * ```
+   */
+  getTaskMetrics(taskId: string, query?: StatsQuery): Promise<TaskStats>;
+}
+export type {
+  TaskStats as TaskMetrics,
+  TeamStats as TeamMetrics,
+  UserStats as UserMetrics,
+};

package/dist/metrics.types.js

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

package/dist/metrics.types.js.map

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

package/dist/provider-stats.test.d.ts

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

package/dist/provider-stats.test.js

@@ -0,0 +1,17 @@
+import { describe, expect, it } from 'vitest';
+describe('IMetricsManager contract', () => {
+  it('accepts an object implementing IMetricsManager', async () => {
+    const metrics = {
+      getUserMetrics: async (userId) => ({ userId }),
+      getTeamMetrics: async (teamId) => ({ teamId }),
+      getTaskMetrics: async (taskId) => ({ taskId }),
+    };
+    expect(typeof metrics.getUserMetrics).toBe('function');
+    expect(typeof metrics.getTeamMetrics).toBe('function');
+    expect(typeof metrics.getTaskMetrics).toBe('function');
+    await expect(metrics.getUserMetrics('u1')).resolves.toBeDefined();
+    await expect(metrics.getTeamMetrics('t1')).resolves.toBeDefined();
+    await expect(metrics.getTaskMetrics('task1')).resolves.toBeDefined();
+  });
+});
+//# sourceMappingURL=provider-stats.test.js.map

package/dist/provider-stats.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-stats.test.js","sourceRoot":"","sources":["../src/provider-stats.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG9C,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAoB;YAC/B,cAAc,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAQ;YAC7D,cAAc,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAQ;YAC7D,cAAc,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAQ;SAC9D,CAAC;QAEF,MAAM,CAAC,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,CAAC,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,CAAC,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEvD,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAClE,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAClE,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/task-manager.d.ts

@@ -0,0 +1,16 @@
+import type {
+  CreateTaskOptions,
+  CreateTaskResult,
+  ITaskManager,
+  ITaskProvider,
+  LintResult,
+  TaskFile,
+} from './task-manager.types';
+export declare class TaskManager implements ITaskManager {
+  private taskProvider;
+  constructor(taskProvider: ITaskProvider);
+  startTask(taskId: string): Promise<TaskFile>;
+  finishTask(taskId: string): Promise<TaskFile>;
+  createTask(options: CreateTaskOptions): Promise<CreateTaskResult>;
+  lint(fix?: boolean): Promise<LintResult>;
+}

package/dist/task-manager.js

@@ -0,0 +1,37 @@
+export class TaskManager {
+  taskProvider;
+  constructor(taskProvider) {
+    this.taskProvider = taskProvider;
+  }
+  async startTask(taskId) {
+    const task = await this.taskProvider.findTask(taskId);
+    if (!task) {
+      throw new Error(`Task with ID '${taskId}' not found.`);
+    }
+    if (task.status === 'in-progress') {
+      throw new Error(`Task '${taskId}' is already in progress.`);
+    }
+    if (task.status === 'done') {
+      throw new Error(`Task '${taskId}' is already done.`);
+    }
+    const updatedTask = { ...task, status: 'in-progress' };
+    await this.taskProvider.updateTask(updatedTask);
+    return updatedTask;
+  }
+  async finishTask(taskId) {
+    const task = await this.taskProvider.findTask(taskId);
+    if (!task) {
+      throw new Error(`Task with ID '${taskId}' not found.`);
+    }
+    const updatedTask = { ...task, status: 'done' };
+    await this.taskProvider.updateTask(updatedTask);
+    return updatedTask;
+  }
+  async createTask(options) {
+    return this.taskProvider.createTask(options);
+  }
+  async lint(fix) {
+    return this.taskProvider.lint(fix);
+  }
+}
+//# sourceMappingURL=task-manager.js.map

package/dist/task-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.js","sourceRoot":"","sources":["../src/task-manager.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,YAA2B;QAA3B,iBAAY,GAAZ,YAAY,CAAe;IAAG,CAAC;IAEnD,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEtD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,cAAc,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,2BAA2B,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,oBAAoB,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,WAAW,GAAa,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACjE,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAEhD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEtD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,cAAc,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,WAAW,GAAa,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC1D,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAEhD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAA0B;QACzC,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAa;QACtB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;CACF"}

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

@@ -0,0 +1,5 @@
+import type { ITaskProvider, TaskFile } from './task-manager.types';
+export declare const createMockTask: (
+  overrides?: Partial<TaskFile>,
+) => TaskFile;
+export declare const createMockTaskProvider: () => ITaskProvider;

package/dist/task-manager.mock.js

@@ -0,0 +1,21 @@
+import { vi } from 'vitest';
+export const createMockTask = (overrides) => ({
+  content: '# Task 001 - Implement feature',
+  createdAt: new Date().toISOString(),
+  description: 'A test feature',
+  filePath: '/tasks/task-001.md',
+  id: 'task-001',
+  status: 'pending',
+  title: 'Implement feature',
+  type: 'feat',
+  userId: 'user-123',
+  ...overrides,
+});
+export const createMockTaskProvider = () => ({
+  findTask: vi.fn(),
+  getAllTasks: vi.fn(),
+  updateTask: vi.fn(),
+  createTask: vi.fn(),
+  lint: vi.fn(),
+});
+//# sourceMappingURL=task-manager.mock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.mock.js","sourceRoot":"","sources":["../src/task-manager.mock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG5B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAA6B,EAAY,EAAE,CAAC,CAAC;IAC1E,OAAO,EAAE,gCAAgC;IACzC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACnC,WAAW,EAAE,gBAAgB;IAC7B,QAAQ,EAAE,oBAAoB;IAC9B,EAAE,EAAE,UAAqC;IACzC,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,mBAAmB;IAC1B,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,UAAU;IAClB,GAAG,SAAS;CACb,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAkB,EAAE,CAAC,CAAC;IAC1D,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;IACjB,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE;IACpB,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;IACnB,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;IACnB,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;CACd,CAAC,CAAC"}

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

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

package/dist/task-manager.test.js

@@ -0,0 +1,104 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { TaskManager } from './task-manager';
+import { createMockTask, createMockTaskProvider } from './task-manager.mock';
+describe('TaskManager', () => {
+  let taskManager;
+  let mockTaskProvider;
+  let mockTask;
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockTaskProvider = createMockTaskProvider();
+    mockTask = createMockTask();
+    taskManager = new TaskManager(mockTaskProvider);
+  });
+  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');
+      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.",
+      );
+    });
+    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.",
+      );
+    });
+  });
+  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');
+      expect(mockTaskProvider.updateTask).toHaveBeenCalledWith(
+        expect.objectContaining({ status: 'done' }),
+      );
+      expect(updatedTask.status).toBe('done');
+    });
+  });
+  describe('createTask', () => {
+    it('should delegate task creation to provider', async () => {
+      const createOptions = { title: 'New Task', type: 'feat' };
+      const createResult = {
+        task: mockTask,
+        taskId: '001',
+        filePath: '/tasks/task-001.md',
+      };
+      mockTaskProvider.createTask.mockResolvedValue(createResult);
+      const result = await taskManager.createTask(createOptions);
+      expect(mockTaskProvider.createTask).toHaveBeenCalledWith(createOptions);
+      expect(result).toEqual(createResult);
+    });
+    it('should pass through description and assignee to provider', async () => {
+      const createOptions = {
+        title: 'New Task',
+        type: 'fix',
+        description: 'Fix something',
+        assignee: 'john-doe',
+      };
+      const createResult = {
+        task: mockTask,
+        taskId: '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');
+    });
+  });
+  describe('lint', () => {
+    it('should delegate lint without fix to provider', async () => {
+      const lintResult = { errors: 0, warnings: 2, details: [] };
+      mockTaskProvider.lint.mockResolvedValue(lintResult);
+      const result = await taskManager.lint();
+      expect(mockTaskProvider.lint).toHaveBeenCalledWith(undefined);
+      expect(result).toEqual(lintResult);
+    });
+    it('should delegate lint with fix=true to provider', async () => {
+      const lintResult = { errors: 0, warnings: 0, details: [] };
+      mockTaskProvider.lint.mockResolvedValue(lintResult);
+      const result = await taskManager.lint(true);
+      expect(mockTaskProvider.lint).toHaveBeenCalledWith(true);
+      expect(result).toEqual(lintResult);
+    });
+    it('should delegate lint with fix=false to provider', async () => {
+      const lintResult = { errors: 1, warnings: 2, details: [] };
+      mockTaskProvider.lint.mockResolvedValue(lintResult);
+      const result = await taskManager.lint(false);
+      expect(mockTaskProvider.lint).toHaveBeenCalledWith(false);
+      expect(result).toEqual(lintResult);
+    });
+  });
+});
+//# sourceMappingURL=task-manager.test.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,152 @@
+import type { Task, TaskType, User } from '@opentask/taskin-types';
+/**
+ * Options for creating a new task
+ * @public
+ */
+export interface CreateTaskOptions {
+  /** Task title */
+  title: string;
+  /** Task type (feat, fix, chore, etc.) */
+  type: TaskType;
+  /** Optional task description */
+  description?: string;
+  /** Optional assignee user ID or name */
+  assignee?: string;
+}
+/**
+ * Result of creating a new task
+ * @public
+ */
+export interface CreateTaskResult {
+  /** The created task */
+  task: TaskFile;
+  /** The generated task ID */
+  taskId: string;
+  /** The file path where the task was created */
+  filePath: string;
+}
+/**
+ * Severity level for validation issues
+ * @public
+ */
+export type ValidationSeverity = 'error' | 'warning' | 'info';
+/**
+ * A validation error or warning found during linting
+ * @public
+ */
+export interface ValidationIssue {
+  /** The file or task that has the issue */
+  file: string;
+  /** Optional line number where the issue occurs */
+  line?: number;
+  /** Human-readable description of the issue */
+  message: string;
+  /** Severity level of the issue */
+  severity: ValidationSeverity;
+  /** Optional suggestion for fixing the issue */
+  suggestion?: string;
+}
+/**
+ * Result of a lint operation
+ * @public
+ */
+export interface LintResult {
+  /** Whether the lint passed without errors */
+  valid: boolean;
+  /** List of validation issues found */
+  issues: ValidationIssue[];
+  /** Number of errors found */
+  errorCount: number;
+  /** Number of warnings found */
+  warningCount: number;
+  /** 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).
+ * @public
+ */
+export interface ITaskProvider {
+  /**
+   * 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>;
+  /**
+   * Retrieve all tasks from the provider.
+   * @returns Array of all tasks
+   */
+  getAllTasks(): Promise<TaskFile[]>;
+  /**
+   * Update an existing task.
+   * @param task - The task with updated information
+   */
+  updateTask(task: TaskFile): Promise<void>;
+  /**
+   * Create a new task.
+   * @param options - Options for creating the task
+   * @returns The created task information
+   */
+  createTask(options: CreateTaskOptions): Promise<CreateTaskResult>;
+  /**
+   * 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>;
+}
+/**
+ * Interface for task management operations.
+ * Provides high-level methods for managing task workflow and state transitions.
+ * @public
+ */
+export interface ITaskManager {
+  /**
+   * Mark a task as finished.
+   * Transitions the task to 'done' status.
+   * @param taskId - The unique identifier of the task
+   * @returns The updated task
+   * @throws Error if task is not found
+   */
+  finishTask(taskId: string): Promise<TaskFile>;
+  /**
+   * Start working on a task.
+   * Transitions the task to 'in-progress' status.
+   * @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>;
+  /**
+   * Create a new task.
+   * @param options - Options for creating the task
+   * @returns The created task information
+   */
+  createTask(options: CreateTaskOptions): Promise<CreateTaskResult>;
+  /**
+   * 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>;
+}

package/dist/task-manager.types.js

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

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

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