@critical-path/core 0.5.2 → 0.7.0

package/dist/engine/index.d.ts

@@ -1,10 +1,13 @@
-import type { CriticalPathConfig, Project, Task, TaskDependencyGraph, Team, TaskContainer, Iteration, Workflow } from '../types/index.js';
+import type { CriticalPathConfig, Project, Task, TaskDependency, TaskDependencyGraph, Team, TaskContainer, Iteration, Comment, Attachment, FileStorageAdapter, UploadFileInput, PresignedUrlOptions, PresignedUploadResult, TimeEntry, Workflow, CreateTaskInput } from '../types/index.js';
 import { StorageAdapter } from '../store/index.js';
 import { PluginRegistry } from '../plugins/index.js';
 import { type TaskLifecycleState } from '../utils/status.js';
+import { DomainEventBus } from '../domain/events.js';
 export declare class CriticalPathEngine {
     readonly store: StorageAdapter;
+    readonly fileStorage?: FileStorageAdapter;
     readonly plugins: PluginRegistry;
+    readonly events: DomainEventBus;
     constructor(config?: CriticalPathConfig);
     private seedInitialData;
     getWorkflows(): Promise<Workflow[]>;
@@ -17,13 +20,40 @@ export declare class CriticalPathEngine {
     getProjects(): Promise<Project[]>;
     getProject(id: string): Promise<Project | null>;
     createProject(project: Omit<Project, 'id' | 'createdAt' | 'updatedAt'>): Promise<Project>;
+    updateProject(id: string, updates: Partial<Project>): Promise<Project | null>;
     getTasks(projectId?: string): Promise<Task[]>;
     getTask(id: string): Promise<Task | null>;
-    createTask(taskInput: Omit<Task, 'id' | 'createdAt' | 'updatedAt'>): Promise<Task>;
+    createTask(taskInput: CreateTaskInput): Promise<Task>;
     updateTask(id: string, updates: Partial<Task>): Promise<Task | null>;
     deleteTask(id: string): Promise<boolean>;
+    addDependency(dep: Omit<TaskDependency, 'id'>): Promise<TaskDependency>;
     getTaskDependencyGraph(taskId: string): Promise<TaskDependencyGraph>;
     getTaskLifecycleState(taskId: string): Promise<TaskLifecycleState | null>;
+    logTime(entry: Omit<TimeEntry, 'id' | 'loggedAt' | 'userId'> & {
+        userId?: string;
+    }): Promise<TimeEntry>;
+    getComments(taskId: string): Promise<Comment[]>;
+    getComment(id: string): Promise<Comment | null>;
+    addComment(comment: Omit<Comment, 'id' | 'createdAt' | 'updatedAt'>): Promise<Comment>;
+    updateComment(id: string, updates: Partial<Comment>): Promise<Comment | null>;
+    deleteComment(id: string): Promise<boolean>;
+    getAttachments(filter?: {
+        taskId?: string;
+        projectId?: string;
+        commentId?: string;
+    }): Promise<Attachment[]>;
+    getAttachment(id: string): Promise<Attachment | null>;
+    createAttachment(attachment: Omit<Attachment, 'id' | 'createdAt' | 'updatedAt'>): Promise<Attachment>;
+    deleteAttachment(id: string): Promise<boolean>;
+    uploadAttachmentFile(input: UploadFileInput & {
+        taskId?: string;
+        projectId?: string;
+        commentId?: string;
+        uploaderId: string;
+        uploaderType?: 'user' | 'agent' | 'system';
+        metadata?: Record<string, unknown>;
+    }): Promise<Attachment>;
+    getPresignedAttachmentUploadUrl(options: PresignedUrlOptions): Promise<PresignedUploadResult>;
     getTeams(): Promise<Team[]>;
     getTeam(id: string): Promise<Team | null>;
     createTeam(team: Omit<Team, 'id' | 'createdAt' | 'updatedAt'>): Promise<Team>;

package/dist/engine/index.d.ts.map

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

package/dist/engine/index.js

@@ -1,15 +1,22 @@
 import { InMemoryStore } from '../store/index.js';
 import { PluginRegistry } from '../plugins/index.js';
-import { deriveTaskLifecycleState } from '../utils/status.js';
+import { deriveTaskLifecycleState, resolveStatusDefinition } from '../utils/status.js';
 import { validateTransition, getAllowedNextStatuses, WorkflowValidationError, DEFAULT_SOFTWARE_WORKFLOW } from '../utils/workflow.js';
+import { DomainEventBus } from '../domain/events.js';
+import { validateCustomFieldValues } from '../domain/custom-fields.js';
+import { detectDependencyCycle, CircularDependencyError } from '../domain/graph.js';
 export class CriticalPathEngine {
     store;
+    fileStorage;
     plugins;
+    events;
     constructor(config = {}) {
         this.store = typeof config.store === 'object' && config.store !== null
             ? config.store
             : new InMemoryStore();
+        this.fileStorage = config.fileStorage;
         this.plugins = new PluginRegistry();
+        this.events = new DomainEventBus();
         if (config.plugins) {
             for (const plugin of config.plugins) {
                 this.plugins.register(plugin);
@@ -60,6 +67,16 @@ export class CriticalPathEngine {
     }
     async createWorkflow(workflow) {
         const created = await this.store.createWorkflow(workflow);
+        const now = new Date().toISOString();
+        const event = {
+            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            name: 'workflow.created',
+            aggregateId: created.id,
+            aggregateType: 'Workflow',
+            occurredAt: now,
+            payload: { workflow: created }
+        };
+        await this.events.publish(event);
         await this.store.logActivity({
             actorId: 'system',
             action: 'workflow.created',
@@ -74,6 +91,16 @@ export class CriticalPathEngine {
             return null;
         const updated = await this.store.updateWorkflow(id, updates);
         if (updated) {
+            const now = new Date().toISOString();
+            const event = {
+                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                name: 'workflow.updated',
+                aggregateId: updated.id,
+                aggregateType: 'Workflow',
+                occurredAt: now,
+                payload: { workflow: updated, previous: existing }
+            };
+            await this.events.publish(event);
             await this.store.logActivity({
                 actorId: 'system',
                 action: 'workflow.updated',
@@ -89,6 +116,16 @@ export class CriticalPathEngine {
             return false;
         const deleted = await this.store.deleteWorkflow(id);
         if (deleted) {
+            const now = new Date().toISOString();
+            const event = {
+                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                name: 'workflow.deleted',
+                aggregateId: id,
+                aggregateType: 'Workflow',
+                occurredAt: now,
+                payload: { workflowId: id, name: existing.name }
+            };
+            await this.events.publish(event);
             await this.store.logActivity({
                 actorId: 'system',
                 action: 'workflow.deleted',
@@ -131,6 +168,16 @@ export class CriticalPathEngine {
     }
     async createProject(project) {
         const created = await this.store.createProject(project);
+        const now = new Date().toISOString();
+        const event = {
+            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            name: 'project.created',
+            aggregateId: created.id,
+            aggregateType: 'Project',
+            occurredAt: now,
+            payload: { project: created }
+        };
+        await this.events.publish(event);
         await this.store.logActivity({
             projectId: created.id,
             actorId: project.ownerId || 'system',
@@ -140,6 +187,32 @@ export class CriticalPathEngine {
         this.dispatchWebhook('project.created', { project: created });
         return created;
     }
+    async updateProject(id, updates) {
+        const existing = await this.store.getProject(id);
+        if (!existing)
+            return null;
+        const updated = await this.store.updateProject(id, updates);
+        if (updated) {
+            const now = new Date().toISOString();
+            const event = {
+                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                name: 'project.updated',
+                aggregateId: updated.id,
+                aggregateType: 'Project',
+                occurredAt: now,
+                payload: { project: updated, previous: existing }
+            };
+            await this.events.publish(event);
+            await this.store.logActivity({
+                projectId: updated.id,
+                actorId: 'system',
+                action: 'project.updated',
+                details: { name: updated.name }
+            });
+            this.dispatchWebhook('project.updated', { project: updated });
+        }
+        return updated;
+    }
     // --- Tasks ---
     async getTasks(projectId) {
         return this.store.getTasks(projectId);
@@ -150,13 +223,24 @@ export class CriticalPathEngine {
     async createTask(taskInput) {
         const processedInput = await this.plugins.runBeforeTaskCreate(taskInput);
         const projectId = processedInput.projectId || taskInput.projectId;
+        const project = await this.store.getProject(projectId);
         const workflow = await this.resolveProjectWorkflow(projectId);
+        // Validate custom field domain invariants
+        if (project?.customFieldDefinitions && (processedInput.customFields || taskInput.customFields)) {
+            validateCustomFieldValues(project.customFieldDefinitions, processedInput.customFields || taskInput.customFields);
+        }
         const defaultStatus = workflow?.defaultStatusKey || 'todo';
+        const initialStatus = processedInput.status || taskInput.status || defaultStatus;
+        const now = new Date().toISOString();
+        // Derive initial lifecycle timestamps
+        const statusDef = resolveStatusDefinition(initialStatus, project?.statusDefinitions || workflow?.statuses);
+        const actualStartDate = processedInput.actualStartDate ?? taskInput.actualStartDate ?? (statusDef.executionState === 'active' ? now : undefined);
+        const actualEndDate = processedInput.actualEndDate ?? taskInput.actualEndDate ?? (statusDef.completionState === 'done' ? now : undefined);
         const created = await this.store.createTask({
             projectId,
             title: processedInput.title || taskInput.title,
             description: processedInput.description ?? taskInput.description,
-            status: processedInput.status || taskInput.status || defaultStatus,
+            status: initialStatus,
             priority: processedInput.priority || taskInput.priority || 'medium',
             taskType: processedInput.taskType || taskInput.taskType || 'task',
             assigneeId: processedInput.assigneeId ?? taskInput.assigneeId,
@@ -166,8 +250,8 @@ export class CriticalPathEngine {
             teamId: processedInput.teamId ?? taskInput.teamId,
             containerId: processedInput.containerId ?? taskInput.containerId,
             plannedStartDate: processedInput.plannedStartDate ?? taskInput.plannedStartDate,
-            actualStartDate: processedInput.actualStartDate ?? taskInput.actualStartDate,
-            actualEndDate: processedInput.actualEndDate ?? taskInput.actualEndDate,
+            actualStartDate,
+            actualEndDate,
             dueDate: processedInput.dueDate ?? taskInput.dueDate,
             estimatedHours: processedInput.estimatedHours ?? taskInput.estimatedHours,
             loggedHours: processedInput.loggedHours ?? taskInput.loggedHours ?? 0,
@@ -176,12 +260,22 @@ export class CriticalPathEngine {
             estimatedDurationMinutes: processedInput.estimatedDurationMinutes ?? taskInput.estimatedDurationMinutes,
             actualDurationMinutes: processedInput.actualDurationMinutes ?? taskInput.actualDurationMinutes,
             billableDurationMinutes: processedInput.billableDurationMinutes ?? taskInput.billableDurationMinutes,
-            progress: processedInput.progress ?? taskInput.progress ?? 0,
+            progress: processedInput.progress ?? taskInput.progress ?? (statusDef.completionState === 'done' ? 100 : 0),
             tags: processedInput.tags ?? taskInput.tags ?? [],
             customFields: processedInput.customFields ?? taskInput.customFields ?? {},
             parentId: processedInput.parentId ?? taskInput.parentId
         });
         await this.plugins.runAfterTaskCreate(created);
+        // Publish typed Domain Event
+        const event = {
+            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            name: 'task.created',
+            aggregateId: created.id,
+            aggregateType: 'Task',
+            occurredAt: now,
+            payload: { task: created }
+        };
+        await this.events.publish(event);
         await this.store.logActivity({
             projectId: created.projectId,
             taskId: created.id,
@@ -196,19 +290,73 @@ export class CriticalPathEngine {
         const existing = await this.store.getTask(id);
         if (!existing)
             return null;
+        const project = await this.store.getProject(existing.projectId);
+        const workflow = await this.resolveProjectWorkflow(existing.projectId);
+        // Validate workflow transition invariant
         if (updates.status && updates.status !== existing.status) {
-            const workflow = await this.resolveProjectWorkflow(existing.projectId);
             const isValid = validateTransition(workflow || undefined, existing.status, updates.status);
             if (!isValid) {
                 throw new WorkflowValidationError(existing.status, updates.status, workflow?.id);
             }
         }
+        // Validate custom field invariants
+        if (project?.customFieldDefinitions && updates.customFields) {
+            validateCustomFieldValues(project.customFieldDefinitions, {
+                ...existing.customFields,
+                ...updates.customFields
+            });
+        }
         const processedUpdates = await this.plugins.runBeforeTaskUpdate(id, updates);
+        // Auto-update execution/completion timestamps if status changes
+        if (processedUpdates.status && processedUpdates.status !== existing.status) {
+            const statusDef = resolveStatusDefinition(processedUpdates.status, project?.statusDefinitions || workflow?.statuses);
+            const now = new Date().toISOString();
+            if (statusDef.executionState === 'active' && !existing.actualStartDate && !processedUpdates.actualStartDate) {
+                processedUpdates.actualStartDate = now;
+            }
+            if (statusDef.completionState === 'done' && !processedUpdates.actualEndDate) {
+                processedUpdates.actualEndDate = now;
+                if (processedUpdates.progress === undefined && (existing.progress || 0) < 100) {
+                    processedUpdates.progress = 100;
+                }
+            }
+        }
         const updated = await this.store.updateTask(id, processedUpdates);
         if (!updated)
             return null;
         await this.plugins.runAfterTaskUpdate(updated, existing);
+        const now = new Date().toISOString();
         const isStatusChange = existing.status !== updated.status;
+        // Publish typed Domain Events
+        if (isStatusChange) {
+            const statusEvent = {
+                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                name: 'task.status_changed',
+                aggregateId: updated.id,
+                aggregateType: 'Task',
+                occurredAt: now,
+                payload: {
+                    task: updated,
+                    previousStatus: existing.status,
+                    newStatus: updated.status
+                }
+            };
+            await this.events.publish(statusEvent);
+        }
+        else {
+            const updateEvent = {
+                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                name: 'task.updated',
+                aggregateId: updated.id,
+                aggregateType: 'Task',
+                occurredAt: now,
+                payload: {
+                    task: updated,
+                    previous: existing
+                }
+            };
+            await this.events.publish(updateEvent);
+        }
         await this.store.logActivity({
             projectId: updated.projectId,
             taskId: updated.id,
@@ -230,6 +378,20 @@ export class CriticalPathEngine {
         const deleted = await this.store.deleteTask(id);
         if (deleted) {
             await this.plugins.runAfterTaskDelete(id);
+            const now = new Date().toISOString();
+            const event = {
+                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                name: 'task.deleted',
+                aggregateId: id,
+                aggregateType: 'Task',
+                occurredAt: now,
+                payload: {
+                    taskId: id,
+                    projectId: existing.projectId,
+                    title: existing.title
+                }
+            };
+            await this.events.publish(event);
             await this.store.logActivity({
                 projectId: existing.projectId,
                 taskId: id,
@@ -242,6 +404,30 @@ export class CriticalPathEngine {
         return deleted;
     }
     // --- Task Dependencies & Graph ---
+    async addDependency(dep) {
+        const existingDependencies = await this.store.getDependencies(dep.taskId);
+        const allProjectDeps = [
+            ...existingDependencies,
+            ...(await this.store.getDependencies(dep.dependsOnTaskId))
+        ];
+        // Enforce Directed Acyclic Graph (DAG) Invariant
+        const cycleCheck = detectDependencyCycle(allProjectDeps, dep);
+        if (cycleCheck.hasCycle) {
+            throw new CircularDependencyError(dep.taskId, dep.dependsOnTaskId, cycleCheck.cyclePath);
+        }
+        const created = await this.store.addDependency(dep);
+        const now = new Date().toISOString();
+        const event = {
+            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            name: 'dependency.added',
+            aggregateId: created.id,
+            aggregateType: 'Dependency',
+            occurredAt: now,
+            payload: { dependency: created }
+        };
+        await this.events.publish(event);
+        return created;
+    }
     async getTaskDependencyGraph(taskId) {
         const dependencies = await this.store.getDependencies(taskId);
         const upstreamTaskIds = new Set();
@@ -272,6 +458,181 @@ export class CriticalPathEngine {
         const statusDefs = project?.statusDefinitions || workflow?.statuses;
         return deriveTaskLifecycleState(task, statusDefs);
     }
+    // --- Time Tracking ---
+    async logTime(entry) {
+        if (entry.hours <= 0) {
+            throw new Error('Logged hours must be a positive number.');
+        }
+        const task = await this.store.getTask(entry.taskId);
+        if (task) {
+            const newLoggedHours = (task.loggedHours || 0) + entry.hours;
+            const newActualHours = (task.actualHours || 0) + entry.hours;
+            const newBillableHours = entry.isBillable !== false ? (task.billableHours || 0) + entry.hours : task.billableHours;
+            await this.store.updateTask(task.id, {
+                loggedHours: newLoggedHours,
+                actualHours: newActualHours,
+                billableHours: newBillableHours
+            });
+        }
+        const fullEntry = {
+            ...entry,
+            userId: entry.userId || task?.assigneeId || 'system'
+        };
+        const created = await this.store.logTime(fullEntry);
+        const now = new Date().toISOString();
+        const event = {
+            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            name: 'time.logged',
+            aggregateId: entry.taskId,
+            aggregateType: 'Task',
+            occurredAt: now,
+            payload: { taskId: entry.taskId, timeEntry: created }
+        };
+        await this.events.publish(event);
+        return created;
+    }
+    // --- Comments ---
+    async getComments(taskId) {
+        return this.store.getComments(taskId);
+    }
+    async getComment(id) {
+        return this.store.getComment(id);
+    }
+    async addComment(comment) {
+        const created = await this.store.addComment(comment);
+        const now = new Date().toISOString();
+        const event = {
+            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            name: 'comment.created',
+            aggregateId: created.id,
+            aggregateType: 'Comment',
+            occurredAt: now,
+            payload: { taskId: comment.taskId, comment: created }
+        };
+        await this.events.publish(event);
+        this.dispatchWebhook('comment.created', { comment: created });
+        return created;
+    }
+    async updateComment(id, updates) {
+        const existing = await this.store.getComment(id);
+        if (!existing)
+            return null;
+        const updated = await this.store.updateComment(id, updates);
+        if (!updated)
+            return null;
+        const now = new Date().toISOString();
+        const event = {
+            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            name: 'comment.updated',
+            aggregateId: updated.id,
+            aggregateType: 'Comment',
+            occurredAt: now,
+            payload: { comment: updated, previous: existing }
+        };
+        await this.events.publish(event);
+        this.dispatchWebhook('comment.updated', { comment: updated });
+        return updated;
+    }
+    async deleteComment(id) {
+        const existing = await this.store.getComment(id);
+        if (!existing)
+            return false;
+        const deleted = await this.store.deleteComment(id);
+        if (deleted) {
+            const now = new Date().toISOString();
+            const event = {
+                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                name: 'comment.deleted',
+                aggregateId: id,
+                aggregateType: 'Comment',
+                occurredAt: now,
+                payload: { taskId: existing.taskId, commentId: id }
+            };
+            await this.events.publish(event);
+            this.dispatchWebhook('comment.deleted', { commentId: id, taskId: existing.taskId });
+        }
+        return deleted;
+    }
+    // --- Attachments ---
+    async getAttachments(filter) {
+        return this.store.getAttachments(filter);
+    }
+    async getAttachment(id) {
+        return this.store.getAttachment(id);
+    }
+    async createAttachment(attachment) {
+        const created = await this.store.createAttachment(attachment);
+        const now = new Date().toISOString();
+        const event = {
+            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            name: 'attachment.created',
+            aggregateId: created.id,
+            aggregateType: 'Attachment',
+            occurredAt: now,
+            payload: { attachment: created }
+        };
+        await this.events.publish(event);
+        this.dispatchWebhook('attachment.created', { attachment: created });
+        return created;
+    }
+    async deleteAttachment(id) {
+        const existing = await this.store.getAttachment(id);
+        if (!existing)
+            return false;
+        if (existing.storageKey && this.fileStorage) {
+            try {
+                await this.fileStorage.delete(existing.storageKey);
+            }
+            catch {
+                // Silently continue if underlying file is already gone
+            }
+        }
+        const deleted = await this.store.deleteAttachment(id);
+        if (deleted) {
+            const now = new Date().toISOString();
+            const event = {
+                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                name: 'attachment.deleted',
+                aggregateId: id,
+                aggregateType: 'Attachment',
+                occurredAt: now,
+                payload: { attachmentId: id, storageKey: existing.storageKey, url: existing.url }
+            };
+            await this.events.publish(event);
+            this.dispatchWebhook('attachment.deleted', { attachmentId: id, taskId: existing.taskId, projectId: existing.projectId });
+        }
+        return deleted;
+    }
+    async uploadAttachmentFile(input) {
+        if (!this.fileStorage) {
+            throw new Error('No FileStorageAdapter configured in CriticalPathEngine. Pass "fileStorage" in config to enable direct file uploads.');
+        }
+        const uploadResult = await this.fileStorage.upload({
+            filename: input.filename,
+            data: input.data,
+            mimeType: input.mimeType,
+            pathPrefix: input.pathPrefix || (input.projectId ? `projects/${input.projectId}` : input.taskId ? `tasks/${input.taskId}` : undefined)
+        });
+        return this.createAttachment({
+            taskId: input.taskId,
+            projectId: input.projectId,
+            commentId: input.commentId,
+            uploaderId: input.uploaderId,
+            uploaderType: input.uploaderType || 'user',
+            filename: input.filename,
+            mimeType: uploadResult.mimeType,
+            sizeBytes: uploadResult.sizeBytes,
+            url: uploadResult.url,
+            storageKey: uploadResult.storageKey,
+            metadata: input.metadata
+        });
+    }
+    async getPresignedAttachmentUploadUrl(options) {
+        if (!this.fileStorage || !this.fileStorage.getPresignedUploadUrl) {
+            throw new Error('Presigned uploads are not supported by the configured FileStorageAdapter.');
+        }
+        return this.fileStorage.getPresignedUploadUrl(options);
+    }
     // --- Teams ---
     async getTeams() {
         return this.store.getTeams();
@@ -281,6 +642,16 @@ export class CriticalPathEngine {
     }
     async createTeam(team) {
         const created = await this.store.createTeam(team);
+        const now = new Date().toISOString();
+        const event = {
+            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            name: 'team.created',
+            aggregateId: created.id,
+            aggregateType: 'Team',
+            occurredAt: now,
+            payload: { team: created }
+        };
+        await this.events.publish(event);
         this.dispatchWebhook('team.created', { team: created });
         return created;
     }
@@ -299,6 +670,16 @@ export class CriticalPathEngine {
     }
     async createContainer(container) {
         const created = await this.store.createContainer(container);
+        const now = new Date().toISOString();
+        const event = {
+            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            name: 'container.created',
+            aggregateId: created.id,
+            aggregateType: 'Container',
+            occurredAt: now,
+            payload: { container: created }
+        };
+        await this.events.publish(event);
         this.dispatchWebhook('container.created', { container: created });
         return created;
     }
@@ -318,6 +699,16 @@ export class CriticalPathEngine {
     async createIteration(iteration) {
         const created = await this.store.createIteration(iteration);
         if (created.status === 'active') {
+            const now = new Date().toISOString();
+            const event = {
+                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                name: 'iteration.started',
+                aggregateId: created.id,
+                aggregateType: 'Iteration',
+                occurredAt: now,
+                payload: { iteration: created }
+            };
+            await this.events.publish(event);
             this.dispatchWebhook('iteration.started', { iteration: created });
         }
         return created;
@@ -328,10 +719,29 @@ export class CriticalPathEngine {
             return null;
         const updated = await this.store.updateIteration(id, updates);
         if (updated) {
+            const now = new Date().toISOString();
             if (existing.status !== 'active' && updated.status === 'active') {
+                const event = {
+                    id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                    name: 'iteration.started',
+                    aggregateId: updated.id,
+                    aggregateType: 'Iteration',
+                    occurredAt: now,
+                    payload: { iteration: updated }
+                };
+                await this.events.publish(event);
                 this.dispatchWebhook('iteration.started', { iteration: updated });
             }
             else if (existing.status !== 'completed' && updated.status === 'completed') {
+                const event = {
+                    id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                    name: 'iteration.completed',
+                    aggregateId: updated.id,
+                    aggregateType: 'Iteration',
+                    occurredAt: now,
+                    payload: { iteration: updated }
+                };
+                await this.events.publish(event);
                 this.dispatchWebhook('iteration.completed', { iteration: updated });
             }
         }