@critical-path/core 0.11.0 → 0.13.0

package/src/store/sqlite.ts

@@ -12,7 +12,9 @@ import type {
   Activity,
   Webhook,
   TaskDependency,
-  Workflow
+  Workflow,
+  Deliverable,
+  CreateDeliverableInput
 } from '../types/index.js';
 import { generateProjectKey } from '../utils/key.js';
 
@@ -111,11 +113,13 @@ export class SQLiteStore implements StorageAdapter {
         priority TEXT NOT NULL,
         taskType TEXT,
         assigneeId TEXT,
+        assignees TEXT,
         reporterId TEXT,
         reviewerId TEXT,
         iterationId TEXT,
         teamId TEXT,
         containerId TEXT,
+        deliverableId TEXT,
         plannedStartDate TEXT,
         actualStartDate TEXT,
         actualEndDate TEXT,
@@ -135,6 +139,24 @@ export class SQLiteStore implements StorageAdapter {
         updatedAt TEXT NOT NULL
       );
 
+      CREATE TABLE IF NOT EXISTS deliverables (
+        id TEXT PRIMARY KEY,
+        projectId TEXT NOT NULL,
+        title TEXT NOT NULL,
+        description TEXT,
+        status TEXT NOT NULL,
+        format TEXT,
+        specs TEXT,
+        leadId TEXT,
+        reviewerId TEXT,
+        dueDate TEXT,
+        deliveredAt TEXT,
+        outputUrls TEXT,
+        customFields TEXT,
+        createdAt TEXT NOT NULL,
+        updatedAt TEXT NOT NULL
+      );
+
       CREATE TABLE IF NOT EXISTS iterations (
         id TEXT PRIMARY KEY,
         projectId TEXT NOT NULL,
@@ -226,6 +248,18 @@ export class SQLiteStore implements StorageAdapter {
     } catch {
       // Column may already exist
     }
+
+    try {
+      this.db.exec('ALTER TABLE tasks ADD COLUMN assignees TEXT');
+    } catch {
+      // Column may already exist
+    }
+
+    try {
+      this.db.exec('ALTER TABLE tasks ADD COLUMN deliverableId TEXT');
+    } catch {
+      // Column may already exist
+    }
   }
 
   // --- Projects ---
@@ -503,6 +537,98 @@ export class SQLiteStore implements StorageAdapter {
     return (result.changes ?? 0) > 0;
   }
 
+  // --- Deliverables ---
+  async getDeliverables(projectId: string): Promise<Deliverable[]> {
+    const stmt = this.db.prepare('SELECT * FROM deliverables WHERE projectId = ?');
+    const rows = stmt.all(projectId) as any[];
+    return rows.map((r) => this.mapDeliverable(r));
+  }
+
+  async getDeliverable(id: string): Promise<Deliverable | null> {
+    const stmt = this.db.prepare('SELECT * FROM deliverables WHERE id = ?');
+    const row = stmt.get(id) as any;
+    return row ? this.mapDeliverable(row) : null;
+  }
+
+  async createDeliverable(deliverable: CreateDeliverableInput): Promise<Deliverable> {
+    const id = `deliv_${Math.random().toString(36).substring(2, 9)}`;
+    const now = new Date().toISOString();
+    const newDeliverable: Deliverable = {
+      ...deliverable,
+      id,
+      status: deliverable.status || 'planned',
+      outputUrls: deliverable.outputUrls ? [...deliverable.outputUrls] : [],
+      customFields: deliverable.customFields ? { ...deliverable.customFields } : {},
+      createdAt: now,
+      updatedAt: now
+    };
+
+    const stmt = this.db.prepare(`
+      INSERT INTO deliverables (
+        id, projectId, title, description, status, format, specs, leadId, reviewerId,
+        dueDate, deliveredAt, outputUrls, customFields, createdAt, updatedAt
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+    stmt.run(
+      newDeliverable.id,
+      newDeliverable.projectId,
+      newDeliverable.title,
+      newDeliverable.description || null,
+      newDeliverable.status,
+      newDeliverable.format || null,
+      newDeliverable.specs ? JSON.stringify(newDeliverable.specs) : null,
+      newDeliverable.leadId || null,
+      newDeliverable.reviewerId || null,
+      newDeliverable.dueDate || null,
+      newDeliverable.deliveredAt || null,
+      JSON.stringify(newDeliverable.outputUrls || []),
+      JSON.stringify(newDeliverable.customFields || {}),
+      newDeliverable.createdAt,
+      newDeliverable.updatedAt
+    );
+    return newDeliverable;
+  }
+
+  async updateDeliverable(id: string, updates: Partial<Deliverable>): Promise<Deliverable | null> {
+    const existing = await this.getDeliverable(id);
+    if (!existing) return null;
+
+    const updated: Deliverable = {
+      ...existing,
+      ...updates,
+      updatedAt: new Date().toISOString()
+    };
+
+    const stmt = this.db.prepare(`
+      UPDATE deliverables SET
+        title = ?, description = ?, status = ?, format = ?, specs = ?, leadId = ?, reviewerId = ?,
+        dueDate = ?, deliveredAt = ?, outputUrls = ?, customFields = ?, updatedAt = ?
+      WHERE id = ?
+    `);
+    stmt.run(
+      updated.title,
+      updated.description || null,
+      updated.status,
+      updated.format || null,
+      updated.specs ? JSON.stringify(updated.specs) : null,
+      updated.leadId || null,
+      updated.reviewerId || null,
+      updated.dueDate || null,
+      updated.deliveredAt || null,
+      JSON.stringify(updated.outputUrls || []),
+      JSON.stringify(updated.customFields || {}),
+      updated.updatedAt,
+      id
+    );
+    return updated;
+  }
+
+  async deleteDeliverable(id: string): Promise<boolean> {
+    const stmt = this.db.prepare('DELETE FROM deliverables WHERE id = ?');
+    const result = stmt.run(id);
+    return (result.changes ?? 0) > 0;
+  }
+
   // --- Tasks ---
   async getTasks(projectId?: string): Promise<Task[]> {
     let rows: any[];
@@ -529,12 +655,12 @@ export class SQLiteStore implements StorageAdapter {
 
     const stmt = this.db.prepare(`
       INSERT INTO tasks (
-        id, projectId, title, description, status, priority, taskType, assigneeId, reporterId,
-        reviewerId, iterationId, teamId, containerId, plannedStartDate, actualStartDate, actualEndDate,
+        id, projectId, title, description, status, priority, taskType, assigneeId, assignees, reporterId,
+        reviewerId, iterationId, teamId, containerId, deliverableId, plannedStartDate, actualStartDate, actualEndDate,
         dueDate, estimatedHours, loggedHours, actualHours, billableHours,
         estimatedDurationMinutes, actualDurationMinutes, billableDurationMinutes, progress,
         tags, customFields, parentId, createdAt, updatedAt
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `);
     stmt.run(
       newTask.id,
@@ -545,11 +671,13 @@ export class SQLiteStore implements StorageAdapter {
       newTask.priority,
       newTask.taskType || null,
       newTask.assigneeId || null,
+      newTask.assignees ? JSON.stringify(newTask.assignees) : null,
       newTask.reporterId || null,
       newTask.reviewerId || null,
       newTask.iterationId || null,
       newTask.teamId || null,
       newTask.containerId || null,
+      newTask.deliverableId || null,
       newTask.plannedStartDate || null,
       newTask.actualStartDate || null,
       newTask.actualEndDate || null,
@@ -584,7 +712,7 @@ export class SQLiteStore implements StorageAdapter {
     const stmt = this.db.prepare(`
       UPDATE tasks SET
         projectId = ?, title = ?, description = ?, status = ?, priority = ?, taskType = ?,
-        assigneeId = ?, reporterId = ?, reviewerId = ?, iterationId = ?, teamId = ?, containerId = ?,
+        assigneeId = ?, assignees = ?, reporterId = ?, reviewerId = ?, iterationId = ?, teamId = ?, containerId = ?, deliverableId = ?,
         plannedStartDate = ?, actualStartDate = ?, actualEndDate = ?, dueDate = ?,
         estimatedHours = ?, loggedHours = ?, actualHours = ?, billableHours = ?,
         estimatedDurationMinutes = ?, actualDurationMinutes = ?, billableDurationMinutes = ?, progress = ?,
@@ -599,11 +727,13 @@ export class SQLiteStore implements StorageAdapter {
       updated.priority,
       updated.taskType || null,
       updated.assigneeId || null,
+      updated.assignees ? JSON.stringify(updated.assignees) : null,
       updated.reporterId || null,
       updated.reviewerId || null,
       updated.iterationId || null,
       updated.teamId || null,
       updated.containerId || null,
+      updated.deliverableId || null,
       updated.plannedStartDate || null,
       updated.actualStartDate || null,
       updated.actualEndDate || null,
@@ -1059,7 +1189,18 @@ export class SQLiteStore implements StorageAdapter {
     return {
       ...row,
       taskType: row.taskType || undefined,
+      deliverableId: row.deliverableId || undefined,
       tags: row.tags ? JSON.parse(row.tags) : [],
+      assignees: row.assignees ? JSON.parse(row.assignees) : undefined,
+      customFields: row.customFields ? JSON.parse(row.customFields) : {}
+    };
+  }
+
+  private mapDeliverable(row: any): Deliverable {
+    return {
+      ...row,
+      specs: row.specs ? JSON.parse(row.specs) : undefined,
+      outputUrls: row.outputUrls ? JSON.parse(row.outputUrls) : [],
       customFields: row.customFields ? JSON.parse(row.customFields) : {}
     };
   }

package/src/types/index.ts

@@ -127,6 +127,14 @@ export interface TaskTodoItem {
   completedAt?: string;
 }
 
+export interface TaskAssignee {
+  id: string;
+  name?: string;
+  role?: string;
+  type?: 'user' | 'agent' | 'team';
+  avatarUrl?: string;
+}
+
 export interface Task {
   id: string;
   projectId: string;
@@ -137,11 +145,13 @@ export interface Task {
   priority: Priority;
   taskType?: string; // e.g. "bug", "feature", "task", "epic"
   assigneeId?: string;
+  assignees?: TaskAssignee[];
   reporterId?: string;
   reviewerId?: string;
   iterationId?: string;
   teamId?: string;
   containerId?: string;
+  deliverableId?: string; // Direct link to parent deliverable
   plannedStartDate?: string;
   actualStartDate?: string;
   actualEndDate?: string;
@@ -169,6 +179,50 @@ export type CreateTaskInput = Omit<Task, 'id' | 'createdAt' | 'updatedAt' | 'sta
   priority?: Priority;
 };
 
+export type DeliverableStatus =
+  | 'draft'
+  | 'planned'
+  | 'in_production'
+  | 'internal_review'
+  | 'client_review'
+  | 'revision_requested'
+  | 'approved'
+  | 'delivered'
+  | 'canceled'
+  | (string & {});
+
+export interface Deliverable {
+  id: string;
+  projectId: string;
+  title: string;
+  description?: string;
+  status: DeliverableStatus;
+  format?: string; // e.g., '16:9 4K ProRes', 'Figma', 'PDF'
+  specs?: Record<string, unknown>; // Technical specifications (resolution, frame rate, etc.)
+  leadId?: string; // Creative director or lead creator
+  reviewerId?: string; // Approver or client reviewer
+  dueDate?: string;
+  deliveredAt?: string;
+  outputUrls?: string[]; // Links to final rendered assets, exports, or storage keys
+  customFields?: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface DeliverableSummary {
+  deliverable: Deliverable;
+  totalTasks: number;
+  completedTasks: number;
+  activeTasks: number;
+  progressPercentage: number;
+  estimatedHours: number;
+  loggedHours: number;
+}
+
+export type CreateDeliverableInput = Omit<Deliverable, 'id' | 'createdAt' | 'updatedAt' | 'status'> & {
+  status?: DeliverableStatus;
+};
+
 export type CreateProjectInput = Omit<Project, 'id' | 'createdAt' | 'updatedAt'>;
 
 export interface Iteration {
@@ -309,7 +363,11 @@ export type WebhookEvent =
   | 'container.created'
   | 'workflow.created'
   | 'workflow.updated'
-  | 'workflow.deleted';
+  | 'workflow.deleted'
+  | 'deliverable.created'
+  | 'deliverable.updated'
+  | 'deliverable.deleted'
+  | 'deliverable.status_changed';
 
 export interface PluginHooks {
   beforeTaskCreate?: (task: Partial<Task>) => Promise<Partial<Task>> | Partial<Task>;
@@ -343,5 +401,6 @@ export interface CriticalPathConfig {
     teams?: Team[];
     containers?: TaskContainer[];
     workflows?: Workflow[];
+    deliverables?: Deliverable[];
   };
 }

package/src/utils/workflow.ts

@@ -117,6 +117,44 @@ export const DEFAULT_VFX_WORKFLOW: Workflow = {
   updatedAt: '2026-01-01T00:00:00.000Z'
 };
 
+export const DEFAULT_CREATIVE_WORKFLOW: 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: Workflow | undefined,
   fromStatus: string,
@@ -162,3 +200,42 @@ export function getAllowedNextStatuses(
 
   return Array.from(allowed);
 }
+
+export function getAllowedPreviousStatuses(
+  workflow: Workflow | undefined,
+  currentStatus: string
+): string[] {
+  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<string>();
+    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]];
+}

package/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/index.test.ts","./src/index.ts","./src/use-case-validation.test.ts","./src/domain/custom-fields.ts","./src/domain/ddd.test.ts","./src/domain/entities.ts","./src/domain/events.ts","./src/domain/graph.ts","./src/domain/index.ts","./src/engine/index.ts","./src/plugins/index.ts","./src/storage/file-storage.ts","./src/storage/firebase-storage.ts","./src/storage/index.ts","./src/storage/s3.ts","./src/storage/storage.test.ts","./src/store/firebase.test.ts","./src/store/firebase.ts","./src/store/index.ts","./src/store/sqlite.test.ts","./src/store/sqlite.ts","./src/types/index.ts","./src/utils/index.ts","./src/utils/key.test.ts","./src/utils/key.ts","./src/utils/mentions.test.ts","./src/utils/mentions.ts","./src/utils/status.ts","./src/utils/workflow.ts"],"version":"5.9.3"}
+{"root":["./src/deliverables.test.ts","./src/index.test.ts","./src/index.ts","./src/use-case-validation.test.ts","./src/domain/custom-fields.ts","./src/domain/ddd.test.ts","./src/domain/entities.ts","./src/domain/events.ts","./src/domain/graph.ts","./src/domain/index.ts","./src/engine/index.ts","./src/plugins/index.ts","./src/storage/file-storage.ts","./src/storage/firebase-storage.ts","./src/storage/index.ts","./src/storage/s3.ts","./src/storage/storage.test.ts","./src/store/firebase.test.ts","./src/store/firebase.ts","./src/store/index.ts","./src/store/sqlite.test.ts","./src/store/sqlite.ts","./src/types/index.ts","./src/utils/index.ts","./src/utils/key.test.ts","./src/utils/key.ts","./src/utils/mentions.test.ts","./src/utils/mentions.ts","./src/utils/status.ts","./src/utils/workflow.ts"],"version":"5.9.3"}