@critical-path/core 0.11.0 → 0.13.0

package/dist/utils/workflow.js

@@ -105,6 +105,43 @@ export const DEFAULT_VFX_WORKFLOW = {
     createdAt: '2026-01-01T00:00:00.000Z',
     updatedAt: '2026-01-01T00:00:00.000Z'
 };
+export const DEFAULT_CREATIVE_WORKFLOW = {
+    id: 'wf_creative_default',
+    name: 'Creative Production Workflow',
+    description: 'Production pipeline for creative deliverables from briefing and concepts to internal review, client feedback, and final delivery.',
+    statuses: [
+        { key: 'briefing', label: 'Briefing & Scoping', completionState: 'not_done', executionState: 'inactive' },
+        { key: 'concept', label: 'Concept & Storyboarding', completionState: 'not_done', executionState: 'active' },
+        { key: 'in_production', label: 'In Production', completionState: 'not_done', executionState: 'active' },
+        { key: 'internal_review', label: 'Internal Review', completionState: 'not_done', executionState: 'active' },
+        { key: 'client_review', label: 'Client Review', completionState: 'not_done', executionState: 'active' },
+        { key: 'revision_requested', label: 'Revision Requested', completionState: 'not_done', executionState: 'active' },
+        { key: 'approved', label: 'Approved', completionState: 'done', executionState: 'inactive' },
+        { key: 'delivered', label: 'Delivered', completionState: 'done', executionState: 'inactive' },
+        DEFAULT_STATUS_DEFINITIONS.canceled
+    ],
+    transitions: [
+        { name: 'Start Concepts', fromStatusKey: 'briefing', toStatusKey: 'concept' },
+        { name: 'Approve Concept for Production', fromStatusKey: 'concept', toStatusKey: 'in_production' },
+        { name: 'Submit for Internal Review', fromStatusKey: 'in_production', toStatusKey: 'internal_review' },
+        { name: 'Submit for Client Review', fromStatusKey: 'internal_review', toStatusKey: 'client_review' },
+        { name: 'Request Revisions (Internal)', fromStatusKey: 'internal_review', toStatusKey: 'revision_requested' },
+        { name: 'Request Revisions (Client)', fromStatusKey: 'client_review', toStatusKey: 'revision_requested' },
+        { name: 'Address Revisions', fromStatusKey: 'revision_requested', toStatusKey: 'in_production' },
+        { name: 'Approve Work', fromStatusKey: 'client_review', toStatusKey: 'approved' },
+        { name: 'Deliver Final Assets', fromStatusKey: 'approved', toStatusKey: 'delivered' },
+        { name: 'Cancel', fromStatusKey: '*', toStatusKey: 'canceled' }
+    ],
+    taskTypes: [
+        { key: 'deliverable', label: 'Deliverable', description: 'Finished asset, cutdown, or packaged export', icon: 'package' },
+        { key: 'creative_task', label: 'Creative Task', description: 'Production task (e.g. Design, Copy, Editing, Color)', icon: 'pen-tool' },
+        { key: 'review', label: 'Review Gate', description: 'Internal or external client sign-off', icon: 'check-circle' }
+    ],
+    defaultStatusKey: 'briefing',
+    isDefault: false,
+    createdAt: '2026-01-01T00:00:00.000Z',
+    updatedAt: '2026-01-01T00:00:00.000Z'
+};
 export function validateTransition(workflow, fromStatus, toStatus) {
     if (fromStatus === toStatus)
         return true;
@@ -133,4 +170,31 @@ export function getAllowedNextStatuses(workflow, currentStatus) {
     }
     return Array.from(allowed);
 }
+export function getAllowedPreviousStatuses(workflow, currentStatus) {
+    if (!workflow || !workflow.statuses || workflow.statuses.length === 0) {
+        return [];
+    }
+    const allStatusKeys = workflow.statuses.map((s) => s.key);
+    const currentIndex = allStatusKeys.indexOf(currentStatus);
+    if (currentIndex <= 0) {
+        return [];
+    }
+    const previousStatusKeys = allStatusKeys.slice(0, currentIndex);
+    if (workflow.transitions && workflow.transitions.length > 0) {
+        const matches = workflow.transitions.filter((t) => t.fromStatusKey === '*' || t.fromStatusKey === currentStatus);
+        const allowed = new Set();
+        for (const t of matches) {
+            if (t.toStatusKey === '*') {
+                return previousStatusKeys;
+            }
+            if (previousStatusKeys.includes(t.toStatusKey)) {
+                allowed.add(t.toStatusKey);
+            }
+        }
+        if (allowed.size > 0) {
+            return Array.from(allowed);
+        }
+    }
+    return [allStatusKeys[currentIndex - 1]];
+}
 //# sourceMappingURL=workflow.js.map

package/dist/utils/workflow.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@critical-path/core",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Core headless domain engine, plugin architecture, and data stores for Critical Path",
   "author": "Jack James",
   "license": "MIT",

package/src/deliverables.test.ts

@@ -0,0 +1,284 @@
+import { describe, it, expect } from 'vitest';
+import {
+  CriticalPathEngine,
+  InMemoryStore,
+  SQLiteStore,
+  FirebaseStore,
+  InMemoryFirestoreMock,
+  DeliverableEntity,
+  DEFAULT_CREATIVE_WORKFLOW,
+  validateTransition
+} from './index.js';
+
+describe('Deliverable Entity & Creative Workflows', () => {
+  it('creates a DeliverableEntity with defaults and emits domain event', () => {
+    const entity = DeliverableEntity.create({
+      projectId: 'proj_1',
+      title: 'Hero 30s Spot - Cutdown 16:9',
+      format: 'ProRes 422HQ',
+      specs: { resolution: '3840x2160', fps: 24 }
+    });
+
+    expect(entity.id).toMatch(/^deliv_/);
+    expect(entity.status).toBe('planned');
+    expect(entity.format).toBe('ProRes 422HQ');
+    expect(entity.specs).toEqual({ resolution: '3840x2160', fps: 24 });
+    expect(entity.outputUrls).toEqual([]);
+
+    const events = entity.getUncommittedEvents();
+    expect(events).toHaveLength(1);
+    expect(events[0].name).toBe('deliverable.created');
+  });
+
+  it('transitions deliverable status and auto-records deliveredAt timestamp', () => {
+    const entity = DeliverableEntity.create({
+      projectId: 'proj_1',
+      title: 'Packaging Key Visual'
+    });
+    entity.clearEvents();
+
+    entity.transitionTo('in_progress');
+    expect(entity.status).toBe('in_progress');
+    expect(entity.deliveredAt).toBeUndefined();
+
+    entity.transitionTo('delivered');
+    expect(entity.status).toBe('delivered');
+    expect(entity.deliveredAt).toBeDefined();
+
+    const events = entity.getUncommittedEvents();
+    expect(events.map((e) => e.name)).toContain('deliverable.status_changed');
+  });
+
+  it('adds output URLs without duplicates and emits deliverable.updated', () => {
+    const entity = DeliverableEntity.create({
+      projectId: 'proj_1',
+      title: 'Brand Mascot 3D Render'
+    });
+    entity.clearEvents();
+
+    entity.addOutputUrl('https://cdn.example.com/renders/v1.mov');
+    expect(entity.outputUrls).toContain('https://cdn.example.com/renders/v1.mov');
+
+    entity.addOutputUrl('https://cdn.example.com/renders/v1.mov');
+    expect(entity.outputUrls).toHaveLength(1);
+
+    entity.addOutputUrl('https://cdn.example.com/renders/v2.mov');
+    expect(entity.outputUrls).toHaveLength(2);
+
+    const events = entity.getUncommittedEvents();
+    expect(events.filter((e) => e.name === 'deliverable.updated')).toHaveLength(2);
+  });
+
+  it('validates DEFAULT_CREATIVE_WORKFLOW stages and transitions', () => {
+    expect(DEFAULT_CREATIVE_WORKFLOW.id).toBe('wf_creative_default');
+    const statusKeys = DEFAULT_CREATIVE_WORKFLOW.statuses.map((s) => s.key);
+    expect(statusKeys).toContain('briefing');
+    expect(statusKeys).toContain('concept');
+    expect(statusKeys).toContain('in_production');
+    expect(statusKeys).toContain('internal_review');
+    expect(statusKeys).toContain('client_review');
+    expect(statusKeys).toContain('revision_requested');
+    expect(statusKeys).toContain('approved');
+    expect(statusKeys).toContain('delivered');
+
+    expect(validateTransition(DEFAULT_CREATIVE_WORKFLOW, 'briefing', 'concept')).toBe(true);
+    expect(validateTransition(DEFAULT_CREATIVE_WORKFLOW, 'concept', 'in_production')).toBe(true);
+    expect(validateTransition(DEFAULT_CREATIVE_WORKFLOW, 'internal_review', 'revision_requested')).toBe(true);
+    expect(validateTransition(DEFAULT_CREATIVE_WORKFLOW, 'client_review', 'approved')).toBe(true);
+    expect(validateTransition(DEFAULT_CREATIVE_WORKFLOW, 'approved', 'delivered')).toBe(true);
+  });
+});
+
+describe('Store Adapters Deliverable CRUD', () => {
+  it('supports Deliverable CRUD in InMemoryStore', async () => {
+    const store = new InMemoryStore();
+    const created = await store.createDeliverable({
+      projectId: 'proj_1',
+      title: 'Billboard Print 600dpi',
+      format: 'TIFF'
+    });
+
+    expect(created.id).toBeDefined();
+    expect(created.status).toBe('planned');
+
+    const fetched = await store.getDeliverable(created.id);
+    expect(fetched?.title).toBe('Billboard Print 600dpi');
+
+    const list = await store.getDeliverables('proj_1');
+    expect(list).toHaveLength(1);
+
+    const updated = await store.updateDeliverable(created.id, { status: 'in_review' });
+    expect(updated?.status).toBe('in_review');
+
+    const deleted = await store.deleteDeliverable(created.id);
+    expect(deleted).toBe(true);
+    expect(await store.getDeliverable(created.id)).toBeNull();
+  });
+
+  it('supports Deliverable CRUD in SQLiteStore', async () => {
+    const store = new SQLiteStore({ filename: ':memory:' });
+    const created = await store.createDeliverable({
+      projectId: 'proj_sql',
+      title: 'Social Video 9:16',
+      format: 'MP4',
+      specs: { codec: 'h264', bitrate: '12mbps' },
+      outputUrls: ['https://storage.google.com/bucket/output.mp4']
+    });
+
+    expect(created.id).toBeDefined();
+    expect(created.status).toBe('planned');
+    expect(created.specs).toEqual({ codec: 'h264', bitrate: '12mbps' });
+    expect(created.outputUrls).toEqual(['https://storage.google.com/bucket/output.mp4']);
+
+    const fetched = await store.getDeliverable(created.id);
+    expect(fetched?.title).toBe('Social Video 9:16');
+    expect(fetched?.specs).toEqual({ codec: 'h264', bitrate: '12mbps' });
+
+    const list = await store.getDeliverables('proj_sql');
+    expect(list).toHaveLength(1);
+
+    const updated = await store.updateDeliverable(created.id, {
+      status: 'delivered',
+      deliveredAt: '2026-09-04T12:00:00Z'
+    });
+    expect(updated?.status).toBe('delivered');
+    expect(updated?.deliveredAt).toBe('2026-09-04T12:00:00Z');
+
+    const deleted = await store.deleteDeliverable(created.id);
+    expect(deleted).toBe(true);
+    expect(await store.getDeliverable(created.id)).toBeNull();
+  });
+
+  it('supports Deliverable CRUD in FirebaseStore mock', async () => {
+    const mockDb = new InMemoryFirestoreMock();
+    const store = new FirebaseStore({ db: mockDb as any });
+
+    const created = await store.createDeliverable({
+      projectId: 'proj_fb',
+      title: 'Animated Web Banner 300x250',
+      format: 'HTML5/Zip'
+    });
+
+    expect(created.id).toBeDefined();
+    const fetched = await store.getDeliverable(created.id);
+    expect(fetched?.title).toBe('Animated Web Banner 300x250');
+
+    const list = await store.getDeliverables('proj_fb');
+    expect(list).toHaveLength(1);
+
+    const updated = await store.updateDeliverable(created.id, { status: 'in_progress' });
+    expect(updated?.status).toBe('in_progress');
+
+    const deleted = await store.deleteDeliverable(created.id);
+    expect(deleted).toBe(true);
+    expect(await store.getDeliverable(created.id)).toBeNull();
+  });
+});
+
+describe('CriticalPathEngine Deliverables & Rollup Metrics', () => {
+  it('manages deliverable lifecycle, fires events and computes summary metrics', async () => {
+    const engine = new CriticalPathEngine();
+
+    // Setup project with creative workflow
+    const project = await engine.createProject({
+      name: 'Autumn Ad Campaign'
+    });
+    await engine.createWorkflow(DEFAULT_CREATIVE_WORKFLOW);
+    await engine.updateProject(project.id, { workflowId: DEFAULT_CREATIVE_WORKFLOW.id });
+
+    // Track domain events
+    const eventLog: string[] = [];
+    engine.events.subscribe('*', (evt) => {
+      eventLog.push(evt.name);
+    });
+
+    // 1. Create Deliverable
+    const deliverable = await engine.createDeliverable({
+      projectId: project.id,
+      title: 'Hero Commercial Cutdown (15s)',
+      format: 'ProRes QuickTime',
+      dueDate: '2026-10-01'
+    });
+    expect(deliverable.id).toBeDefined();
+    expect(eventLog).toContain('deliverable.created');
+
+    // 2. Create tasks assigned to this deliverable
+    const task1 = await engine.createTask({
+      projectId: project.id,
+      title: 'Storyboard 15s Cut',
+      status: 'approved',
+      estimatedHours: 8,
+      loggedHours: 8,
+      progress: 100,
+      deliverableId: deliverable.id
+    });
+    expect(task1.deliverableId).toBe(deliverable.id);
+
+    const task2 = await engine.createTask({
+      projectId: project.id,
+      title: 'Color Grading 15s Cut',
+      status: 'in_production',
+      estimatedHours: 12,
+      loggedHours: 6,
+      progress: 50,
+      deliverableId: deliverable.id
+    });
+
+    const task3 = await engine.createTask({
+      projectId: project.id,
+      title: 'Sound Design & Final Mix',
+      status: 'briefing',
+      estimatedHours: 6,
+      loggedHours: 0,
+      progress: 0,
+      deliverableId: deliverable.id
+    });
+
+    // 3. Compute Deliverable Summary / Rollup
+    const summary = await engine.getDeliverableSummary(deliverable.id);
+    expect(summary).not.toBeNull();
+    expect(summary!.totalTasks).toBe(3);
+    expect(summary!.completedTasks).toBe(1); // 'approved' has completionState 'done'
+    expect(summary!.activeTasks).toBe(1); // 'in_production' has executionState 'active'
+    expect(summary!.estimatedHours).toBe(26); // 8 + 12 + 6
+    expect(summary!.loggedHours).toBe(14); // 8 + 6 + 0
+    expect(summary!.progressPercentage).toBe(50); // (100 + 50 + 0) / 3 = 50%
+
+    // 4. Update Deliverable to delivered
+    const updated = await engine.updateDeliverable(deliverable.id, {
+      status: 'delivered'
+    });
+    expect(updated?.status).toBe('delivered');
+    expect(updated?.deliveredAt).toBeDefined();
+    expect(eventLog).toContain('deliverable.status_changed');
+    expect(eventLog).toContain('deliverable.updated');
+
+    // 5. Delete Deliverable
+    const deleted = await engine.deleteDeliverable(deliverable.id);
+    expect(deleted).toBe(true);
+    expect(eventLog).toContain('deliverable.deleted');
+  });
+
+  it('seeds deliverables from initialData', async () => {
+    const engine = new CriticalPathEngine({
+      initialData: {
+        projects: [{ id: 'p_init', name: 'Init Proj', key: 'INIT', createdAt: '', updatedAt: '' }],
+        deliverables: [
+          {
+            id: 'deliv_seeded',
+            projectId: 'p_init',
+            title: 'Seeded Deliverable',
+            status: 'planned',
+            createdAt: '2026-01-01',
+            updatedAt: '2026-01-01'
+          }
+        ]
+      }
+    });
+
+    await engine.ready;
+    const deliverables = await engine.getDeliverables('p_init');
+    expect(deliverables).toHaveLength(1);
+    expect(deliverables[0].id).toBe('deliv_seeded');
+  });
+});

package/src/domain/entities.ts

@@ -8,7 +8,10 @@ import type {
   TaskTodoItem,
   CustomFieldDefinition,
   CreateTaskInput,
-  CreateProjectInput
+  CreateProjectInput,
+  Deliverable,
+  DeliverableStatus,
+  CreateDeliverableInput
 } from '../types/index.js';
 import type {
   DomainEvent,
@@ -16,7 +19,10 @@ import type {
   TaskStatusChangedEvent,
   TaskUpdatedEvent,
   TimeLoggedEvent,
-  ProjectCreatedEvent
+  ProjectCreatedEvent,
+  DeliverableCreatedEvent,
+  DeliverableUpdatedEvent,
+  DeliverableStatusChangedEvent
 } from './events.js';
 import { validateTransition, WorkflowValidationError } from '../utils/workflow.js';
 import { resolveStatusDefinition } from '../utils/status.js';
@@ -67,6 +73,7 @@ export class TaskEntity extends BaseEntity {
   public iterationId?: string;
   public teamId?: string;
   public containerId?: string;
+  public deliverableId?: string;
   public plannedStartDate?: string;
   public actualStartDate?: string;
   public actualEndDate?: string;
@@ -99,6 +106,7 @@ export class TaskEntity extends BaseEntity {
     this.iterationId = data.iterationId;
     this.teamId = data.teamId;
     this.containerId = data.containerId;
+    this.deliverableId = data.deliverableId;
     this.plannedStartDate = data.plannedStartDate;
     this.actualStartDate = data.actualStartDate;
     this.actualEndDate = data.actualEndDate;
@@ -365,6 +373,7 @@ export class TaskEntity extends BaseEntity {
       iterationId: this.iterationId,
       teamId: this.teamId,
       containerId: this.containerId,
+      deliverableId: this.deliverableId,
       plannedStartDate: this.plannedStartDate,
       actualStartDate: this.actualStartDate,
       actualEndDate: this.actualEndDate,
@@ -471,6 +480,180 @@ export class ProjectEntity extends BaseEntity {
   }
 }
 
+export class DeliverableEntity extends BaseEntity {
+  public projectId: string;
+  public title: string;
+  public description?: string;
+  public status: DeliverableStatus;
+  public format?: string;
+  public specs?: Record<string, unknown>;
+  public leadId?: string;
+  public reviewerId?: string;
+  public dueDate?: string;
+  public deliveredAt?: string;
+  public outputUrls?: string[];
+  public customFields?: Record<string, unknown>;
+
+  constructor(data: Deliverable) {
+    super(data.id, data.createdAt, data.updatedAt);
+    this.projectId = data.projectId;
+    this.title = data.title;
+    this.description = data.description;
+    this.status = data.status;
+    this.format = data.format;
+    this.specs = data.specs ? { ...data.specs } : undefined;
+    this.leadId = data.leadId;
+    this.reviewerId = data.reviewerId;
+    this.dueDate = data.dueDate;
+    this.deliveredAt = data.deliveredAt;
+    this.outputUrls = data.outputUrls ? [...data.outputUrls] : [];
+    this.customFields = data.customFields ? { ...data.customFields } : {};
+  }
+
+  public static create(
+    input: CreateDeliverableInput,
+    options?: { id?: string; customFieldDefs?: CustomFieldDefinition[] }
+  ): DeliverableEntity {
+    const id = options?.id || `deliv_${Math.random().toString(36).substring(2, 9)}`;
+    const now = new Date().toISOString();
+
+    if (options?.customFieldDefs) {
+      validateCustomFieldValues(options.customFieldDefs, input.customFields);
+    }
+
+    const deliverable = new DeliverableEntity({
+      ...input,
+      id,
+      createdAt: now,
+      updatedAt: now,
+      status: input.status || 'planned',
+      outputUrls: input.outputUrls ?? [],
+      customFields: input.customFields ?? {}
+    });
+
+    const createdEvent: DeliverableCreatedEvent = {
+      id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+      name: 'deliverable.created',
+      aggregateId: deliverable.id,
+      aggregateType: 'Deliverable',
+      occurredAt: now,
+      payload: { deliverable: deliverable.toPlain() }
+    };
+    deliverable.raiseEvent(createdEvent);
+
+    return deliverable;
+  }
+
+  public transitionTo(newStatus: DeliverableStatus): this {
+    if (this.status === newStatus) return this;
+
+    const previousStatus = this.status;
+    this.status = newStatus;
+    const now = new Date().toISOString();
+
+    if (newStatus === 'delivered' && !this.deliveredAt) {
+      this.deliveredAt = now;
+    }
+
+    this.markUpdated();
+
+    const event: DeliverableStatusChangedEvent = {
+      id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+      name: 'deliverable.status_changed',
+      aggregateId: this.id,
+      aggregateType: 'Deliverable',
+      occurredAt: now,
+      payload: {
+        deliverable: this.toPlain(),
+        previousStatus,
+        newStatus
+      }
+    };
+    this.raiseEvent(event);
+
+    return this;
+  }
+
+  public addOutputUrl(url: string): this {
+    if (!this.outputUrls) {
+      this.outputUrls = [];
+    }
+    if (!this.outputUrls.includes(url)) {
+      const previous = this.toPlain();
+      this.outputUrls.push(url);
+      this.markUpdated();
+
+      const event: DeliverableUpdatedEvent = {
+        id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+        name: 'deliverable.updated',
+        aggregateId: this.id,
+        aggregateType: 'Deliverable',
+        occurredAt: new Date().toISOString(),
+        payload: {
+          deliverable: this.toPlain(),
+          previous
+        }
+      };
+      this.raiseEvent(event);
+    }
+    return this;
+  }
+
+  public update(updates: Partial<Deliverable>, customFieldDefs?: CustomFieldDefinition[]): this {
+    const previous = this.toPlain();
+
+    if (updates.customFields && customFieldDefs) {
+      validateCustomFieldValues(customFieldDefs, {
+        ...this.customFields,
+        ...updates.customFields
+      });
+    }
+
+    if (updates.status && updates.status !== this.status) {
+      this.transitionTo(updates.status);
+      delete updates.status;
+    }
+
+    Object.assign(this, updates);
+    this.markUpdated();
+
+    const event: DeliverableUpdatedEvent = {
+      id: `evt_${Math.random().toString(36).substring(2, 9)}`,
+      name: 'deliverable.updated',
+      aggregateId: this.id,
+      aggregateType: 'Deliverable',
+      occurredAt: new Date().toISOString(),
+      payload: {
+        deliverable: this.toPlain(),
+        previous
+      }
+    };
+    this.raiseEvent(event);
+
+    return this;
+  }
+
+  public toPlain(): Deliverable {
+    return {
+      id: this.id,
+      projectId: this.projectId,
+      title: this.title,
+      description: this.description,
+      status: this.status,
+      format: this.format,
+      specs: this.specs ? { ...this.specs } : undefined,
+      leadId: this.leadId,
+      reviewerId: this.reviewerId,
+      dueDate: this.dueDate,
+      deliveredAt: this.deliveredAt,
+      outputUrls: this.outputUrls ? [...this.outputUrls] : [],
+      customFields: this.customFields ? { ...this.customFields } : {},
+      createdAt: this.createdAt,
+      updatedAt: this.updatedAt
+    };
+  }
+}
+
 export class AttachmentValidationError extends Error {
   constructor(message: string) {
     super(message);