@critical-path/core 0.33.0 → 0.35.0

package/dist/engine/index.js

@@ -64,6 +64,14 @@ export class CriticalPathEngine {
         Object.defineProperty(scoped, 'actor', { value: Object.freeze({ ...actor }), enumerable: true });
         return scoped;
     }
+    /** Publishes a domain event, filling in its id and timestamp. */
+    async publishEvent(event) {
+        await this.events.publish({
+            ...event,
+            id: `evt_${crypto.randomUUID()}`,
+            occurredAt: new Date().toISOString()
+        });
+    }
     actorIdOr(fallback) {
         return this.actor?.userId ?? fallback;
     }
@@ -222,7 +230,7 @@ export class CriticalPathEngine {
         const created = await this.store.createWorkflow({ ...workflow, tenantId: this.actor ? this.actor.tenantId : workflow.tenantId });
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'workflow.created',
             aggregateId: created.id,
             aggregateType: 'Workflow',
@@ -247,7 +255,7 @@ export class CriticalPathEngine {
         if (updated) {
             const now = new Date().toISOString();
             const event = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'workflow.updated',
                 aggregateId: updated.id,
                 aggregateType: 'Workflow',
@@ -272,7 +280,7 @@ export class CriticalPathEngine {
         if (deleted) {
             const now = new Date().toISOString();
             const event = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'workflow.deleted',
                 aggregateId: id,
                 aggregateType: 'Workflow',
@@ -349,7 +357,7 @@ export class CriticalPathEngine {
         const created = await this.store.createProject(input);
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'project.created',
             aggregateId: created.id,
             aggregateType: 'Project',
@@ -378,7 +386,7 @@ export class CriticalPathEngine {
         if (updated) {
             const now = new Date().toISOString();
             const event = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'project.updated',
                 aggregateId: updated.id,
                 aggregateType: 'Project',
@@ -424,7 +432,7 @@ export class CriticalPathEngine {
         if (deleted) {
             const now = new Date().toISOString();
             const event = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'project.deleted',
                 aggregateId: id,
                 aggregateType: 'Project',
@@ -551,7 +559,7 @@ export class CriticalPathEngine {
         await this.plugins.runAfterTaskCreate(created);
         // Publish typed Domain Event
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'task.created',
             aggregateId: created.id,
             aggregateType: 'Task',
@@ -746,7 +754,7 @@ export class CriticalPathEngine {
         // Publish typed Domain Events
         if (isStatusChange) {
             const statusEvent = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'task.status_changed',
                 aggregateId: updated.id,
                 aggregateType: 'Task',
@@ -768,7 +776,7 @@ export class CriticalPathEngine {
         }
         else {
             const updateEvent = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'task.updated',
                 aggregateId: updated.id,
                 aggregateType: 'Task',
@@ -788,7 +796,7 @@ export class CriticalPathEngine {
         if (!wasBlocked && isNowBlocked) {
             const blockedReason = updated.blockedReason ?? null;
             const blockedEvent = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'task.blocked',
                 aggregateId: updated.id,
                 aggregateType: 'Task',
@@ -812,7 +820,7 @@ export class CriticalPathEngine {
         }
         else if (wasBlocked && !isNowBlocked) {
             const unblockedEvent = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'task.unblocked',
                 aggregateId: updated.id,
                 aggregateType: 'Task',
@@ -887,7 +895,7 @@ export class CriticalPathEngine {
                     }
                     const now = new Date().toISOString();
                     const unblockedEvent = {
-                        id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                        id: `evt_${crypto.randomUUID()}`,
                         name: 'task.unblocked',
                         aggregateId: downstream.id,
                         aggregateType: 'Task',
@@ -929,7 +937,7 @@ export class CriticalPathEngine {
             await this.plugins.runAfterTaskDelete(id, existing);
             const now = new Date().toISOString();
             const event = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'task.deleted',
                 aggregateId: id,
                 aggregateType: 'Task',
@@ -995,7 +1003,7 @@ export class CriticalPathEngine {
         const removed = await this.store.removeDependency(id);
         if (removed) {
             const event = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'dependency.removed',
                 aggregateId: id,
                 aggregateType: 'Dependency',
@@ -1025,7 +1033,7 @@ export class CriticalPathEngine {
         const created = await this.store.addDependency(dep);
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'dependency.added',
             aggregateId: created.id,
             aggregateType: 'Dependency',
@@ -1132,7 +1140,7 @@ export class CriticalPathEngine {
         const created = await this.store.logTime(fullEntry);
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'time.logged',
             aggregateId: entry.taskId,
             aggregateType: 'Task',
@@ -1177,7 +1185,7 @@ export class CriticalPathEngine {
         const created = await this.store.addComment({ ...comment, mentions });
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'comment.created',
             aggregateId: created.id,
             aggregateType: 'Comment',
@@ -1202,7 +1210,7 @@ export class CriticalPathEngine {
             return null;
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'comment.updated',
             aggregateId: updated.id,
             aggregateType: 'Comment',
@@ -1224,7 +1232,7 @@ export class CriticalPathEngine {
         if (deleted) {
             const now = new Date().toISOString();
             const event = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'comment.deleted',
                 aggregateId: id,
                 aggregateType: 'Comment',
@@ -1261,7 +1269,7 @@ export class CriticalPathEngine {
             return null;
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'comment.reaction.added',
             aggregateId: commentId,
             aggregateType: 'Comment',
@@ -1297,7 +1305,7 @@ export class CriticalPathEngine {
             return null;
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'comment.reaction.removed',
             aggregateId: commentId,
             aggregateType: 'Comment',
@@ -1340,7 +1348,7 @@ export class CriticalPathEngine {
         const created = await this.store.createAttachment(attachment);
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'attachment.created',
             aggregateId: created.id,
             aggregateType: 'Attachment',
@@ -1370,7 +1378,7 @@ export class CriticalPathEngine {
         if (deleted) {
             const now = new Date().toISOString();
             const event = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'attachment.deleted',
                 aggregateId: id,
                 aggregateType: 'Attachment',
@@ -1498,7 +1506,7 @@ export class CriticalPathEngine {
         const created = await this.store.createTeam({ ...team, tenantId: this.actor ? this.actor.tenantId : team.tenantId });
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'team.created',
             aggregateId: created.id,
             aggregateType: 'Team',
@@ -1509,16 +1517,36 @@ export class CriticalPathEngine {
         return created;
     }
     async updateTeam(id, updates) {
-        if (!(await this.getTeam(id)))
+        const existing = await this.getTeam(id);
+        if (!existing)
             return null;
         await this.requireWorkspaceAccess('workspace.manage');
-        return this.store.updateTeam(id, this.withoutTenant(updates));
+        const updated = await this.store.updateTeam(id, this.withoutTenant(updates));
+        if (updated) {
+            await this.publishEvent({
+                name: 'team.updated',
+                aggregateId: id,
+                aggregateType: 'Team',
+                payload: { team: updated, previous: existing }
+            });
+        }
+        return updated;
     }
     async deleteTeam(id) {
-        if (!(await this.getTeam(id)))
+        const existing = await this.getTeam(id);
+        if (!existing)
             return false;
         await this.requireWorkspaceAccess('workspace.manage');
-        return this.store.deleteTeam(id);
+        const deleted = await this.store.deleteTeam(id);
+        if (deleted) {
+            await this.publishEvent({
+                name: 'team.deleted',
+                aggregateId: id,
+                aggregateType: 'Team',
+                payload: { teamId: id, name: existing.name, tenantId: existing.tenantId }
+            });
+        }
+        return deleted;
     }
     // --- Containers ---
     async getContainers(projectId) {
@@ -1537,7 +1565,7 @@ export class CriticalPathEngine {
         const created = await this.store.createContainer(container);
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'container.created',
             aggregateId: created.id,
             aggregateType: 'Container',
@@ -1552,7 +1580,16 @@ export class CriticalPathEngine {
         if (!existing)
             return null;
         await this.requireProjectAccess('plan.manage', existing.projectId);
-        return this.store.updateContainer(id, updates);
+        const updated = await this.store.updateContainer(id, updates);
+        if (updated) {
+            await this.publishEvent({
+                name: 'container.updated',
+                aggregateId: id,
+                aggregateType: 'Container',
+                payload: { container: updated, previous: existing }
+            });
+        }
+        return updated;
     }
     /** Deletes a container. Its tasks and nested containers are kept but no longer reference it. */
     async deleteContainer(id) {
@@ -1564,7 +1601,16 @@ export class CriticalPathEngine {
         for (const child of (await this.store.getContainers(existing.projectId)).filter((c) => c.parentId === id)) {
             await this.store.updateContainer(child.id, { parentId: undefined });
         }
-        return this.store.deleteContainer(id);
+        const deleted = await this.store.deleteContainer(id);
+        if (deleted) {
+            await this.publishEvent({
+                name: 'container.deleted',
+                aggregateId: id,
+                aggregateType: 'Container',
+                payload: { containerId: id, projectId: existing.projectId, name: existing.name }
+            });
+        }
+        return deleted;
     }
     /** Unsets a reference (e.g. `iterationId`) on every task in the project that points at `id`. */
     async clearTaskReferences(projectId, field, id) {
@@ -1599,7 +1645,7 @@ export class CriticalPathEngine {
         });
         const now = new Date().toISOString();
         const event = {
-            id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+            id: `evt_${crypto.randomUUID()}`,
             name: 'deliverable.created',
             aggregateId: created.id,
             aggregateType: 'Deliverable',
@@ -1628,7 +1674,7 @@ export class CriticalPathEngine {
             const now = new Date().toISOString();
             if (updates.status && updates.status !== existing.status) {
                 const statusEvent = {
-                    id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                    id: `evt_${crypto.randomUUID()}`,
                     name: 'deliverable.status_changed',
                     aggregateId: updated.id,
                     aggregateType: 'Deliverable',
@@ -1642,7 +1688,7 @@ export class CriticalPathEngine {
                 await this.events.publish(statusEvent);
             }
             const updateEvent = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'deliverable.updated',
                 aggregateId: updated.id,
                 aggregateType: 'Deliverable',
@@ -1669,7 +1715,7 @@ export class CriticalPathEngine {
         if (deleted) {
             const now = new Date().toISOString();
             const event = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'deliverable.deleted',
                 aggregateId: id,
                 aggregateType: 'Deliverable',
@@ -1745,10 +1791,16 @@ export class CriticalPathEngine {
     async createIteration(iteration) {
         await this.requireProjectAccess('plan.manage', iteration.projectId);
         const created = await this.store.createIteration(iteration);
+        await this.publishEvent({
+            name: 'iteration.created',
+            aggregateId: created.id,
+            aggregateType: 'Iteration',
+            payload: { iteration: created }
+        });
         if (created.status === 'active') {
             const now = new Date().toISOString();
             const event = {
-                id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                id: `evt_${crypto.randomUUID()}`,
                 name: 'iteration.started',
                 aggregateId: created.id,
                 aggregateType: 'Iteration',
@@ -1766,10 +1818,16 @@ export class CriticalPathEngine {
         await this.requireProjectAccess('plan.manage', existing.projectId);
         const updated = await this.store.updateIteration(id, updates);
         if (updated) {
+            await this.publishEvent({
+                name: 'iteration.updated',
+                aggregateId: id,
+                aggregateType: 'Iteration',
+                payload: { iteration: updated, previous: existing }
+            });
             const now = new Date().toISOString();
             if (existing.status !== 'active' && updated.status === 'active') {
                 const event = {
-                    id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                    id: `evt_${crypto.randomUUID()}`,
                     name: 'iteration.started',
                     aggregateId: updated.id,
                     aggregateType: 'Iteration',
@@ -1780,7 +1838,7 @@ export class CriticalPathEngine {
             }
             else if (existing.status !== 'completed' && updated.status === 'completed') {
                 const event = {
-                    id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+                    id: `evt_${crypto.randomUUID()}`,
                     name: 'iteration.completed',
                     aggregateId: updated.id,
                     aggregateType: 'Iteration',
@@ -1799,7 +1857,16 @@ export class CriticalPathEngine {
             return false;
         await this.requireProjectAccess('plan.manage', existing.projectId);
         await this.clearTaskReferences(existing.projectId, 'iterationId', id);
-        return this.store.deleteIteration(id);
+        const deleted = await this.store.deleteIteration(id);
+        if (deleted) {
+            await this.publishEvent({
+                name: 'iteration.deleted',
+                aggregateId: id,
+                aggregateType: 'Iteration',
+                payload: { iterationId: id, projectId: existing.projectId, name: existing.name }
+            });
+        }
+        return deleted;
     }
     // --- Ladder of Abstraction & Critical Path Method ---
     async calculateCriticalPath(projectId, options = {}) {