@critical-path/core 0.5.2 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @critical-path/core
 
+## 0.6.0
+
+### Minor Changes
+
+- 6e9dece: Introduce Domain-Driven Design (DDD) constructs:
+  - Rich Domain Aggregates (`TaskEntity`, `ProjectEntity`, `BaseEntity`) encapsulating invariants, transitions, and uncommitted events.
+  - Typed `DomainEventBus` and domain event interfaces (`task.created`, `task.status_changed`, `time.logged`, `dependency.added`, etc.).
+  - DAG task dependency graph cycle detection (`detectDependencyCycle`, `CircularDependencyError`).
+  - Custom field value object validation (`validateCustomFieldValues`, `CustomFieldValidationError`).
+  - Interface segregation for discrete repositories (`ProjectRepository`, `TaskRepository`, `WorkflowRepository`, etc.).
+
 ## 0.5.2
 
 ### Patch Changes

package/README.md

@@ -1,55 +1,85 @@
 # `@critical-path/core`
 
-> The foundational domain engine, plugin lifecycle hooks, and storage adapters for **Critical Path**.
+> The foundational domain engine, Domain-Driven Design (DDD) aggregate roots, domain event bus, graph cycle detection, and storage adapters for **Critical Path**.
 
 ---
 
 ## 📦 Features
 
-- **Domain Engine**: Complete business logic for projects, workflows & status transition rules, tasks, sprints, comments, activities, time tracking, task dependencies, and webhooks.
+- **Domain-Driven Design (DDD) Engine**: Rich aggregates (`TaskEntity`, `ProjectEntity`) encapsulating lifecycle invariants, state transitions, time tracking, and uncommitted domain events.
+- **Typed Domain Event Bus**: In-memory pub/sub `DomainEventBus` enabling reactive subscriptions to granular domain events (`task.created`, `task.status_changed`, `time.logged`, `dependency.added`, etc.).
+- **DAG Graph Cycle Invariant**: Built-in topological validation (`detectDependencyCycle`, `CircularDependencyError`) to ensure strict acyclic task dependency graphs.
+- **Custom Field Value Object Validation**: Strict type-checking (`validateCustomFieldValues`, `CustomFieldValidationError`) against configured project field schemas.
+- **Interface Segregated Repositories**: Focused repository contracts (`ProjectRepository`, `TaskRepository`, `WorkflowRepository`, etc.) composed into `StorageAdapter`.
 - **Plugin Lifecycle Architecture**: Extensible hooks (`beforeTaskCreate`, `afterTaskUpdate`, `beforeTaskDelete`, etc.).
 - **Multiple Built-in Storage Adapters**:
   - `InMemoryStore`: Fast, zero-config in-memory storage for local dev and testing.
   - `SQLiteStore`: Embedded relational database storage powered by native Node.js SQLite (`node:sqlite`).
   - `FirebaseStore`: Firestore collection mapping for cloud-native web and mobile backends.
-  - Custom `StorageAdapter` interface for connecting PostgreSQL, Prisma, or Drizzle.
 
 ---
 
-## 🚀 Usage Example
+## 🚀 Usage Examples
 
-### Using SQLiteStore
+### 1. Initializing the Engine & Subscribing to Domain Events
 
 ```ts
-import { CriticalPathEngine, SQLiteStore } from '@critical-path/core';
+import { CriticalPathEngine, SQLiteStore, type TaskStatusChangedEvent } from '@critical-path/core';
 
-// Initialize SQLite database store (file-backed or :memory:)
 const store = new SQLiteStore({ filename: 'critical-path.db' });
 const engine = new CriticalPathEngine({ store });
 
-// Create a project
-const project = await engine.createProject({
-  key: 'MAIN',
-  name: 'Core Roadmap'
+// Subscribe to specific typed domain events
+engine.events.subscribe<TaskStatusChangedEvent>('task.status_changed', (event) => {
+  console.log(`Task ${event.aggregateId} moved from ${event.payload.previousStatus} to ${event.payload.newStatus}`);
 });
 
-// Create a task
-const task = await engine.createTask({
-  projectId: project.id,
-  title: 'Setup Database Migration',
+// Or subscribe to all domain events with wildcard
+engine.events.subscribe('*', (event) => {
+  console.log(`[Domain Event] ${event.name}`, event);
+});
+```
+
+### 2. Rich Entities & Invariant Enforcement
+
+```ts
+import { TaskEntity, DEFAULT_SOFTWARE_WORKFLOW } from '@critical-path/core';
+
+// Create a rich Task Aggregate Root
+const task = TaskEntity.create({
+  projectId: 'proj_123',
+  title: 'Implement Payment Gateway',
   status: 'todo',
   priority: 'high'
 });
+
+// Perform valid state transitions with workflow enforcement
+task.transitionTo('in_progress', DEFAULT_SOFTWARE_WORKFLOW);
+
+// Log time on aggregate
+task.logTime({ hours: 3.5, isBillable: true });
+
+// Read and dispatch uncommitted events
+const events = task.getUncommittedEvents();
+task.clearEvents();
 ```
 
-### Using FirebaseStore
+### 3. DAG Dependency Cycle Prevention
 
 ```ts
-import { CriticalPathEngine, FirebaseStore } from '@critical-path/core';
-
-// Initialize Firebase / Firestore store
-const store = new FirebaseStore({ db: myFirestoreInstance });
-const engine = new CriticalPathEngine({ store });
+import { CircularDependencyError } from '@critical-path/core';
+
+try {
+  await engine.addDependency({
+    taskId: 'task_C',
+    dependsOnTaskId: 'task_A',
+    type: 'blocking'
+  });
+} catch (error) {
+  if (error instanceof CircularDependencyError) {
+    console.error(`Blocked cyclic dependency! Cycle path: ${error.cyclePath.join(' -> ')}`);
+  }
+}
 ```
 
 ---

package/dist/domain/custom-fields.d.ts

@@ -0,0 +1,9 @@
+import type { CustomFieldDefinition } from '../types/index.js';
+export declare class CustomFieldValidationError extends Error {
+    readonly fieldKey: string;
+    readonly expectedType?: string;
+    readonly receivedValue?: unknown;
+    constructor(message: string, fieldKey: string, expectedType?: string, receivedValue?: unknown);
+}
+export declare function validateCustomFieldValues(definitions: CustomFieldDefinition[] | undefined, values: Record<string, unknown> | undefined): void;
+//# sourceMappingURL=custom-fields.d.ts.map

package/dist/domain/custom-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-fields.d.ts","sourceRoot":"","sources":["../../src/domain/custom-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtC,SAAgB,aAAa,CAAC,EAAE,OAAO,CAAC;gBAE5B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO;CAO9F;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,qBAAqB,EAAE,GAAG,SAAS,EAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,IAAI,CA+GN"}

package/dist/domain/custom-fields.js

@@ -0,0 +1,72 @@
+export class CustomFieldValidationError extends Error {
+    fieldKey;
+    expectedType;
+    receivedValue;
+    constructor(message, fieldKey, expectedType, receivedValue) {
+        super(message);
+        this.name = 'CustomFieldValidationError';
+        this.fieldKey = fieldKey;
+        this.expectedType = expectedType;
+        this.receivedValue = receivedValue;
+    }
+}
+export function validateCustomFieldValues(definitions, values) {
+    if (!definitions || definitions.length === 0)
+        return;
+    const customValues = values || {};
+    for (const def of definitions) {
+        const value = customValues[def.key];
+        // Check required invariant
+        if (def.required && (value === undefined || value === null || value === '')) {
+            throw new CustomFieldValidationError(`Custom field "${def.label || def.key}" (${def.key}) is required.`, def.key, def.type, value);
+        }
+        if (value === undefined || value === null) {
+            continue;
+        }
+        // Type and schema validation
+        switch (def.type) {
+            case 'number':
+                if (typeof value !== 'number' || isNaN(value)) {
+                    throw new CustomFieldValidationError(`Custom field "${def.label || def.key}" must be a valid number. Received: ${typeof value}`, def.key, 'number', value);
+                }
+                break;
+            case 'text':
+            case 'user':
+                if (typeof value !== 'string') {
+                    throw new CustomFieldValidationError(`Custom field "${def.label || def.key}" must be a string. Received: ${typeof value}`, def.key, def.type, value);
+                }
+                break;
+            case 'boolean':
+                if (typeof value !== 'boolean') {
+                    throw new CustomFieldValidationError(`Custom field "${def.label || def.key}" must be a boolean. Received: ${typeof value}`, def.key, 'boolean', value);
+                }
+                break;
+            case 'date':
+                if (typeof value !== 'string' || isNaN(new Date(value).getTime())) {
+                    throw new CustomFieldValidationError(`Custom field "${def.label || def.key}" must be a valid ISO date string. Received: ${JSON.stringify(value)}`, def.key, 'date', value);
+                }
+                break;
+            case 'single_select':
+                if (typeof value !== 'string') {
+                    throw new CustomFieldValidationError(`Custom field "${def.label || def.key}" must be a string option. Received: ${typeof value}`, def.key, 'single_select', value);
+                }
+                if (def.options && def.options.length > 0 && !def.options.includes(value)) {
+                    throw new CustomFieldValidationError(`Custom field "${def.label || def.key}" value "${value}" is not an allowed option [${def.options.join(', ')}].`, def.key, 'single_select', value);
+                }
+                break;
+            case 'multi_select':
+                if (!Array.isArray(value)) {
+                    throw new CustomFieldValidationError(`Custom field "${def.label || def.key}" must be an array of string options. Received: ${typeof value}`, def.key, 'multi_select', value);
+                }
+                if (def.options && def.options.length > 0) {
+                    for (const item of value) {
+                        if (typeof item !== 'string' || !def.options.includes(item)) {
+                            throw new CustomFieldValidationError(`Custom field "${def.label || def.key}" option "${item}" is not allowed in [${def.options.join(', ')}].`, def.key, 'multi_select', item);
+                        }
+                    }
+                }
+                break;
+        }
+    }
+}
+//# sourceMappingURL=custom-fields.js.map

package/dist/domain/custom-fields.js.map

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

package/dist/domain/ddd.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ddd.test.d.ts.map

package/dist/domain/ddd.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddd.test.d.ts","sourceRoot":"","sources":["../../src/domain/ddd.test.ts"],"names":[],"mappings":""}

package/dist/domain/ddd.test.js

@@ -0,0 +1,246 @@
+import { describe, it, expect, vi } from 'vitest';
+import { CriticalPathEngine, TaskEntity, ProjectEntity, DomainEventBus, CircularDependencyError, CustomFieldValidationError, DEFAULT_SOFTWARE_WORKFLOW, detectDependencyCycle, validateCustomFieldValues } from '../index.js';
+describe('Domain-Driven Design (DDD) Enhancements Suite', () => {
+    describe('Domain Event Bus & Typed Events', () => {
+        it('publishes and subscribes to typed domain events', async () => {
+            const bus = new DomainEventBus();
+            const statusChangedHandler = vi.fn();
+            const wildcardHandler = vi.fn();
+            const unsubscribe = bus.subscribe('task.status_changed', statusChangedHandler);
+            bus.subscribe('*', wildcardHandler);
+            const sampleEvent = {
+                id: 'evt_123',
+                name: 'task.status_changed',
+                aggregateId: 'task_1',
+                aggregateType: 'Task',
+                occurredAt: new Date().toISOString(),
+                payload: {
+                    task: {
+                        id: 'task_1',
+                        projectId: 'proj_1',
+                        title: 'Sample Task',
+                        status: 'in_progress',
+                        priority: 'high',
+                        createdAt: '2026-01-01T00:00:00Z',
+                        updatedAt: '2026-01-01T00:00:00Z'
+                    },
+                    previousStatus: 'todo',
+                    newStatus: 'in_progress'
+                }
+            };
+            await bus.publish(sampleEvent);
+            expect(statusChangedHandler).toHaveBeenCalledWith(sampleEvent);
+            expect(wildcardHandler).toHaveBeenCalledWith(sampleEvent);
+            unsubscribe();
+            await bus.publish(sampleEvent);
+            expect(statusChangedHandler).toHaveBeenCalledTimes(1);
+            expect(wildcardHandler).toHaveBeenCalledTimes(2);
+        });
+        it('publishes domain events from CriticalPathEngine during aggregate mutations', async () => {
+            const engine = new CriticalPathEngine();
+            const taskCreatedEvents = [];
+            const statusChangedEvents = [];
+            const timeLoggedEvents = [];
+            engine.events.subscribe('task.created', (evt) => {
+                taskCreatedEvents.push(evt);
+            });
+            engine.events.subscribe('task.status_changed', (evt) => {
+                statusChangedEvents.push(evt);
+            });
+            engine.events.subscribe('time.logged', (evt) => {
+                timeLoggedEvents.push(evt);
+            });
+            const project = await engine.createProject({
+                name: 'DDD Mobile App'
+            });
+            const task = await engine.createTask({
+                projectId: project.id,
+                title: 'Design Domain Aggregates',
+                status: 'todo'
+            });
+            expect(taskCreatedEvents.length).toBe(1);
+            expect(taskCreatedEvents[0].aggregateId).toBe(task.id);
+            expect(taskCreatedEvents[0].payload.task.title).toBe('Design Domain Aggregates');
+            await engine.updateTask(task.id, { status: 'in_progress' });
+            expect(statusChangedEvents.length).toBe(1);
+            expect(statusChangedEvents[0].payload.fromStatus || statusChangedEvents[0].payload.previousStatus).toBe('todo');
+            expect(statusChangedEvents[0].payload.toStatus || statusChangedEvents[0].payload.newStatus).toBe('in_progress');
+            await engine.logTime({
+                taskId: task.id,
+                hours: 3.5,
+                description: 'Implemented aggregate root logic'
+            });
+            expect(timeLoggedEvents.length).toBe(1);
+            expect(timeLoggedEvents[0].payload.timeEntry.hours).toBe(3.5);
+            const updatedTask = await engine.getTask(task.id);
+            expect(updatedTask?.loggedHours).toBe(3.5);
+        });
+    });
+    describe('Value Object Validation for Custom Fields', () => {
+        const definitions = [
+            { id: 'cf_sp', key: 'storyPoints', label: 'Story Points', type: 'number', required: true },
+            { id: 'cf_severity', key: 'severity', label: 'Severity', type: 'single_select', options: ['low', 'medium', 'high'] },
+            { id: 'cf_tags', key: 'domains', label: 'Domains', type: 'multi_select', options: ['frontend', 'backend', 'devops'] },
+            { id: 'cf_date', key: 'targetRelease', label: 'Target Release', type: 'date' }
+        ];
+        it('passes validation when valid custom field values are provided', () => {
+            expect(() => {
+                validateCustomFieldValues(definitions, {
+                    storyPoints: 5,
+                    severity: 'high',
+                    domains: ['frontend', 'backend'],
+                    targetRelease: '2026-10-01T00:00:00.000Z'
+                });
+            }).not.toThrow();
+        });
+        it('throws CustomFieldValidationError when required field is missing', () => {
+            expect(() => {
+                validateCustomFieldValues(definitions, {
+                    severity: 'high'
+                });
+            }).toThrow(CustomFieldValidationError);
+        });
+        it('throws CustomFieldValidationError on type mismatch or invalid option', () => {
+            expect(() => {
+                validateCustomFieldValues(definitions, {
+                    storyPoints: 'five'
+                });
+            }).toThrow(CustomFieldValidationError);
+            expect(() => {
+                validateCustomFieldValues(definitions, {
+                    storyPoints: 5,
+                    severity: 'critical' // Not in ['low', 'medium', 'high']
+                });
+            }).toThrow(CustomFieldValidationError);
+            expect(() => {
+                validateCustomFieldValues(definitions, {
+                    storyPoints: 5,
+                    domains: ['frontend', 'ai'] // 'ai' not allowed
+                });
+            }).toThrow(CustomFieldValidationError);
+        });
+        it('integrates custom field validation in CriticalPathEngine task creation and update', async () => {
+            const engine = new CriticalPathEngine();
+            const project = await engine.createProject({
+                name: 'Strict Project',
+                customFieldDefinitions: definitions
+            });
+            // Fails creation due to missing required storyPoints
+            await expect(engine.createTask({
+                projectId: project.id,
+                title: 'Invalid Task',
+                customFields: { severity: 'low' }
+            })).rejects.toThrow(CustomFieldValidationError);
+            // Successfully creates with valid fields
+            const validTask = await engine.createTask({
+                projectId: project.id,
+                title: 'Valid Task',
+                customFields: { storyPoints: 8, severity: 'medium' }
+            });
+            expect(validTask.id).toBeDefined();
+            // Fails update with invalid option
+            await expect(engine.updateTask(validTask.id, {
+                customFields: { severity: 'extreme' }
+            })).rejects.toThrow(CustomFieldValidationError);
+        });
+    });
+    describe('DAG Cycle Detection & Graph Invariant Protection', () => {
+        it('detects self-dependency cycles', () => {
+            const result = detectDependencyCycle([], { taskId: 'task_1', dependsOnTaskId: 'task_1' });
+            expect(result.hasCycle).toBe(true);
+        });
+        it('detects multi-node transitive cycles', () => {
+            // Existing: A -> B, B -> C
+            const existing = [
+                { id: '1', taskId: 'task_A', dependsOnTaskId: 'task_B', type: 'blocking' },
+                { id: '2', taskId: 'task_B', dependsOnTaskId: 'task_C', type: 'blocking' }
+            ];
+            // Try to add C -> A (creates C -> A -> B -> C cycle)
+            const result = detectDependencyCycle(existing, { taskId: 'task_C', dependsOnTaskId: 'task_A' });
+            expect(result.hasCycle).toBe(true);
+            expect(result.cyclePath).toEqual(['task_C', 'task_A', 'task_B', 'task_C']);
+        });
+        it('allows valid acyclic dependencies', () => {
+            const existing = [
+                { id: '1', taskId: 'task_A', dependsOnTaskId: 'task_B', type: 'blocking' },
+                { id: '2', taskId: 'task_B', dependsOnTaskId: 'task_C', type: 'blocking' }
+            ];
+            // Add A -> D (valid DAG)
+            const result = detectDependencyCycle(existing, { taskId: 'task_A', dependsOnTaskId: 'task_D' });
+            expect(result.hasCycle).toBe(false);
+        });
+        it('throws CircularDependencyError when engine.addDependency attempts to create a cycle', async () => {
+            const engine = new CriticalPathEngine();
+            const project = await engine.createProject({ name: 'Graph Test' });
+            const taskA = await engine.createTask({ projectId: project.id, title: 'Task A' });
+            const taskB = await engine.createTask({ projectId: project.id, title: 'Task B' });
+            const taskC = await engine.createTask({ projectId: project.id, title: 'Task C' });
+            await engine.addDependency({
+                taskId: taskA.id,
+                dependsOnTaskId: taskB.id,
+                type: 'blocking'
+            });
+            await engine.addDependency({
+                taskId: taskB.id,
+                dependsOnTaskId: taskC.id,
+                type: 'blocking'
+            });
+            // Attempt circular dependency: C depends on A
+            await expect(engine.addDependency({
+                taskId: taskC.id,
+                dependsOnTaskId: taskA.id,
+                type: 'blocking'
+            })).rejects.toThrow(CircularDependencyError);
+        });
+    });
+    describe('Rich Domain Aggregates (TaskEntity & ProjectEntity)', () => {
+        it('encapsulates state transitions, timestamps, and raises uncommitted domain events', () => {
+            const task = TaskEntity.create({
+                projectId: 'proj_1',
+                title: 'Rich Entity Task',
+                status: 'todo',
+                priority: 'high'
+            });
+            expect(task.getUncommittedEvents().length).toBe(1);
+            expect(task.getUncommittedEvents()[0].name).toBe('task.created');
+            task.clearEvents();
+            // Transition to in_progress
+            task.transitionTo('in_progress', DEFAULT_SOFTWARE_WORKFLOW);
+            expect(task.status).toBe('in_progress');
+            expect(task.actualStartDate).toBeDefined();
+            expect(task.getUncommittedEvents().length).toBe(1);
+            expect(task.getUncommittedEvents()[0].name).toBe('task.status_changed');
+            task.clearEvents();
+            // Log time
+            task.logTime({ hours: 4.5, isBillable: true });
+            expect(task.loggedHours).toBe(4.5);
+            expect(task.billableHours).toBe(4.5);
+            expect(task.getUncommittedEvents().length).toBe(1);
+            expect(task.getUncommittedEvents()[0].name).toBe('time.logged');
+            task.clearEvents();
+            // Complete task
+            task.transitionTo('done', DEFAULT_SOFTWARE_WORKFLOW);
+            expect(task.status).toBe('done');
+            expect(task.actualEndDate).toBeDefined();
+            expect(task.progress).toBe(100);
+        });
+        it('creates ProjectEntity and handles key generation and custom field validation', () => {
+            const project = ProjectEntity.create({
+                name: 'Critical Path Core',
+                customFieldDefinitions: [
+                    { id: 'cf_client', key: 'clientName', label: 'Client Name', type: 'text', required: true }
+                ]
+            });
+            expect(project.key).toBe('CPC');
+            expect(project.getUncommittedEvents().length).toBe(1);
+            expect(project.getUncommittedEvents()[0].name).toBe('project.created');
+            expect(() => {
+                project.validateCustomFields({});
+            }).toThrow(CustomFieldValidationError);
+            expect(() => {
+                project.validateCustomFields({ clientName: 'Acme Corp' });
+            }).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=ddd.test.js.map

package/dist/domain/ddd.test.js.map

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

package/dist/domain/entities.d.ts

@@ -0,0 +1,82 @@
+import type { Task, Project, Workflow, TimeEntry, Priority, TaskStatus, CustomFieldDefinition, CreateTaskInput, CreateProjectInput } from '../types/index.js';
+import type { DomainEvent } from './events.js';
+export declare abstract class BaseEntity {
+    readonly id: string;
+    createdAt: string;
+    updatedAt: string;
+    private uncommittedEvents;
+    constructor(id: string, createdAt?: string, updatedAt?: string);
+    protected raiseEvent(event: DomainEvent): void;
+    getUncommittedEvents(): DomainEvent[];
+    clearEvents(): void;
+    protected markUpdated(): void;
+}
+export declare class TaskEntity extends BaseEntity {
+    projectId: string;
+    key?: string;
+    title: string;
+    description?: string;
+    status: TaskStatus;
+    priority: Priority;
+    taskType?: string;
+    assigneeId?: string;
+    reporterId?: string;
+    reviewerId?: string;
+    iterationId?: string;
+    teamId?: string;
+    containerId?: string;
+    plannedStartDate?: string;
+    actualStartDate?: string;
+    actualEndDate?: string;
+    dueDate?: string;
+    estimatedHours?: number;
+    loggedHours?: number;
+    actualHours?: number;
+    billableHours?: number;
+    estimatedDurationMinutes?: number;
+    actualDurationMinutes?: number;
+    billableDurationMinutes?: number;
+    progress?: number;
+    tags?: string[];
+    customFields?: Record<string, unknown>;
+    parentId?: string;
+    constructor(data: Task);
+    static create(input: CreateTaskInput, options?: {
+        id?: string;
+        workflow?: Workflow;
+        customFieldDefs?: CustomFieldDefinition[];
+    }): TaskEntity;
+    transitionTo(newStatus: string, workflow?: Workflow, options?: {
+        statusDefs?: Workflow['statuses'];
+        actorId?: string;
+    }): this;
+    logTime(entry: {
+        hours: number;
+        isBillable?: boolean;
+        userId?: string;
+        description?: string;
+    }): TimeEntry;
+    update(updates: Partial<Task>, customFieldDefs?: CustomFieldDefinition[]): this;
+    toPlain(): Task;
+}
+export declare class ProjectEntity extends BaseEntity {
+    key: string;
+    name: string;
+    description?: string;
+    ownerId?: string;
+    members?: string[];
+    teamIds?: string[];
+    workflowId?: string;
+    workflow?: Workflow;
+    taskTypes?: Project['taskTypes'];
+    statusDefinitions?: Project['statusDefinitions'];
+    priorityDefinitions?: Project['priorityDefinitions'];
+    customFieldDefinitions?: CustomFieldDefinition[];
+    constructor(data: Project);
+    static create(input: CreateProjectInput, options?: {
+        id?: string;
+    }): ProjectEntity;
+    validateCustomFields(values?: Record<string, unknown>): void;
+    toPlain(): Project;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/domain/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/domain/entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,WAAW,EAMZ,MAAM,aAAa,CAAC;AAMrB,8BAAsB,UAAU;IAC9B,SAAgB,EAAE,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,iBAAiB,CAAqB;gBAElC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAO9D,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIvC,oBAAoB,IAAI,WAAW,EAAE;IAIrC,WAAW,IAAI,IAAI;IAI1B,SAAS,CAAC,WAAW,IAAI,IAAI;CAG9B;AAED,qBAAa,UAAW,SAAQ,UAAU;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE,IAAI;WAgCR,MAAM,CAClB,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,eAAe,CAAC,EAAE,qBAAqB,EAAE,CAAA;KAAE,GACxF,UAAU;IAkCN,YAAY,CACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,QAAQ,EACnB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE,IAAI;IA0CA,OAAO,CACZ,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACpF,SAAS;IAwCL,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,EAAE,qBAAqB,EAAE,GAAG,IAAI;IA6B/E,OAAO,IAAI,IAAI;CAmCvB;AAED,qBAAa,aAAc,SAAQ,UAAU;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjD,mBAAmB,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrD,sBAAsB,CAAC,EAAE,qBAAqB,EAAE,CAAC;gBAE5C,IAAI,EAAE,OAAO;WAgBX,MAAM,CAClB,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GACxB,aAAa;IA0BT,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,OAAO,IAAI,OAAO;CAmB1B"}