@critical-path/core 0.10.0 → 0.12.0

package/src/store/index.ts

@@ -13,7 +13,9 @@ import type {
   Activity,
   Webhook,
   TaskDependency,
-  Workflow
+  Workflow,
+  Deliverable,
+  CreateDeliverableInput
 } from '../types/index.js';
 import { generateProjectKey } from '../utils/key.js';
 
@@ -102,12 +104,21 @@ export interface WebhookRepository {
   addWebhook(webhook: Omit<Webhook, 'id' | 'createdAt'>): Promise<Webhook>;
 }
 
+export interface DeliverableRepository {
+  getDeliverables(projectId: string): Promise<Deliverable[]>;
+  getDeliverable(id: string): Promise<Deliverable | null>;
+  createDeliverable(deliverable: CreateDeliverableInput): Promise<Deliverable>;
+  updateDeliverable(id: string, updates: Partial<Deliverable>): Promise<Deliverable | null>;
+  deleteDeliverable(id: string): Promise<boolean>;
+}
+
 export interface StorageAdapter
   extends ProjectRepository,
     WorkflowRepository,
     TaskRepository,
     TeamRepository,
     ContainerRepository,
+    DeliverableRepository,
     IterationRepository,
     CommentRepository,
     AttachmentRepository,
@@ -122,6 +133,7 @@ export class InMemoryStore implements StorageAdapter {
   private tasks = new Map<string, Task>();
   private teams = new Map<string, Team>();
   private containers = new Map<string, TaskContainer>();
+  private deliverables = new Map<string, Deliverable>();
   private iterations = new Map<string, Iteration>();
   private comments = new Map<string, Comment>();
   private attachments = new Map<string, Attachment>();
@@ -306,6 +318,47 @@ export class InMemoryStore implements StorageAdapter {
     return this.containers.delete(id);
   }
 
+  // Deliverables
+  async getDeliverables(projectId: string): Promise<Deliverable[]> {
+    return Array.from(this.deliverables.values()).filter((d) => d.projectId === projectId);
+  }
+
+  async getDeliverable(id: string): Promise<Deliverable | null> {
+    return this.deliverables.get(id) || null;
+  }
+
+  async createDeliverable(deliverable: CreateDeliverableInput): Promise<Deliverable> {
+    const id = (deliverable as any).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
+    };
+    this.deliverables.set(id, newDeliverable);
+    return newDeliverable;
+  }
+
+  async updateDeliverable(id: string, updates: Partial<Deliverable>): Promise<Deliverable | null> {
+    const existing = this.deliverables.get(id);
+    if (!existing) return null;
+    const updated: Deliverable = {
+      ...existing,
+      ...updates,
+      updatedAt: new Date().toISOString()
+    };
+    this.deliverables.set(id, updated);
+    return updated;
+  }
+
+  async deleteDeliverable(id: string): Promise<boolean> {
+    return this.deliverables.delete(id);
+  }
+
   // Iterations
   async getIterations(projectId: string): Promise<Iteration[]> {
     return Array.from(this.iterations.values()).filter((s) => s.projectId === projectId);

package/src/store/sqlite.test.ts

@@ -77,11 +77,16 @@ describe('SQLiteStore', () => {
     const comments = await store.getComments('task_1');
     expect(comments).toHaveLength(2);
 
-    const updatedComment = await store.updateComment(comment.id, { content: 'Updated content' });
+    const updatedComment = await store.updateComment(comment.id, {
+      content: 'Updated content',
+      mentions: ['planner', 'coordinator']
+    });
     expect(updatedComment?.content).toBe('Updated content');
+    expect(updatedComment?.mentions).toEqual(['planner', 'coordinator']);
 
     const fetchedComment = await store.getComment(comment.id);
     expect(fetchedComment?.content).toBe('Updated content');
+    expect(fetchedComment?.mentions).toEqual(['planner', 'coordinator']);
 
     const timeEntry = await store.logTime({
       taskId: 'task_1',

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';
 
@@ -116,6 +118,7 @@ export class SQLiteStore implements StorageAdapter {
         iterationId TEXT,
         teamId TEXT,
         containerId TEXT,
+        deliverableId TEXT,
         plannedStartDate TEXT,
         actualStartDate TEXT,
         actualEndDate TEXT,
@@ -135,6 +138,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,
@@ -154,6 +175,7 @@ export class SQLiteStore implements StorageAdapter {
         authorType TEXT,
         parentId TEXT,
         content TEXT NOT NULL,
+        mentions TEXT,
         reactions TEXT,
         metadata TEXT,
         createdAt TEXT NOT NULL,
@@ -219,6 +241,18 @@ export class SQLiteStore implements StorageAdapter {
     } catch {
       // Column may already exist
     }
+
+    try {
+      this.db.exec('ALTER TABLE comments ADD COLUMN mentions TEXT');
+    } catch {
+      // Column may already exist
+    }
+
+    try {
+      this.db.exec('ALTER TABLE tasks ADD COLUMN deliverableId TEXT');
+    } catch {
+      // Column may already exist
+    }
   }
 
   // --- Projects ---
@@ -496,6 +530,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[];
@@ -523,11 +649,11 @@ 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,
+        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,
@@ -543,6 +669,7 @@ export class SQLiteStore implements StorageAdapter {
       newTask.iterationId || null,
       newTask.teamId || null,
       newTask.containerId || null,
+      newTask.deliverableId || null,
       newTask.plannedStartDate || null,
       newTask.actualStartDate || null,
       newTask.actualEndDate || null,
@@ -577,7 +704,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 = ?, reporterId = ?, reviewerId = ?, iterationId = ?, teamId = ?, containerId = ?, deliverableId = ?,
         plannedStartDate = ?, actualStartDate = ?, actualEndDate = ?, dueDate = ?,
         estimatedHours = ?, loggedHours = ?, actualHours = ?, billableHours = ?,
         estimatedDurationMinutes = ?, actualDurationMinutes = ?, billableDurationMinutes = ?, progress = ?,
@@ -597,6 +724,7 @@ export class SQLiteStore implements StorageAdapter {
       updated.iterationId || null,
       updated.teamId || null,
       updated.containerId || null,
+      updated.deliverableId || null,
       updated.plannedStartDate || null,
       updated.actualStartDate || null,
       updated.actualEndDate || null,
@@ -697,6 +825,7 @@ export class SQLiteStore implements StorageAdapter {
       authorType: row.authorType,
       parentId: row.parentId || undefined,
       content: row.content,
+      mentions: row.mentions ? JSON.parse(row.mentions) : undefined,
       reactions: row.reactions ? JSON.parse(row.reactions) : undefined,
       metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
       createdAt: row.createdAt,
@@ -723,8 +852,8 @@ export class SQLiteStore implements StorageAdapter {
     const newComment: Comment = { ...comment, id, createdAt: now, updatedAt: now };
 
     const stmt = this.db.prepare(`
-      INSERT INTO comments (id, taskId, authorId, authorType, parentId, content, reactions, metadata, createdAt, updatedAt)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      INSERT INTO comments (id, taskId, authorId, authorType, parentId, content, mentions, reactions, metadata, createdAt, updatedAt)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `);
     stmt.run(
       newComment.id,
@@ -733,6 +862,7 @@ export class SQLiteStore implements StorageAdapter {
       newComment.authorType || 'user',
       newComment.parentId || null,
       newComment.content,
+      newComment.mentions ? JSON.stringify(newComment.mentions) : null,
       newComment.reactions ? JSON.stringify(newComment.reactions) : null,
       newComment.metadata ? JSON.stringify(newComment.metadata) : null,
       newComment.createdAt,
@@ -757,6 +887,7 @@ export class SQLiteStore implements StorageAdapter {
         authorType = ?,
         parentId = ?,
         content = ?,
+        mentions = ?,
         reactions = ?,
         metadata = ?,
         updatedAt = ?
@@ -767,6 +898,7 @@ export class SQLiteStore implements StorageAdapter {
       updated.authorType || 'user',
       updated.parentId || null,
       updated.content,
+      updated.mentions ? JSON.stringify(updated.mentions) : null,
       updated.reactions ? JSON.stringify(updated.reactions) : null,
       updated.metadata ? JSON.stringify(updated.metadata) : null,
       updated.updatedAt,
@@ -1048,8 +1180,18 @@ export class SQLiteStore implements StorageAdapter {
     return {
       ...row,
       taskType: row.taskType || undefined,
+      deliverableId: row.deliverableId || undefined,
       tags: row.tags ? JSON.parse(row.tags) : [],
       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

@@ -142,6 +142,7 @@ export interface Task {
   iterationId?: string;
   teamId?: string;
   containerId?: string;
+  deliverableId?: string; // Direct link to parent deliverable
   plannedStartDate?: string;
   actualStartDate?: string;
   actualEndDate?: string;
@@ -169,6 +170,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 {
@@ -198,6 +243,7 @@ export interface Comment {
   authorType?: AuthorType;
   parentId?: string; // Threaded reply support
   content: string;
+  mentions?: string[];
   reactions?: CommentReaction[];
   metadata?: Record<string, unknown>;
   createdAt: string;
@@ -308,7 +354,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>;
@@ -342,5 +392,6 @@ export interface CriticalPathConfig {
     teams?: Team[];
     containers?: TaskContainer[];
     workflows?: Workflow[];
+    deliverables?: Deliverable[];
   };
 }

package/src/utils/index.ts

@@ -1,4 +1,5 @@
 export * from './status.js';
 export * from './key.js';
 export * from './workflow.js';
+export * from './mentions.js';
 

package/src/utils/mentions.test.ts

@@ -0,0 +1,82 @@
+import { describe, it, expect } from 'vitest';
+import { extractMentions, parseMentionSegments } from './mentions.js';
+
+describe('mentions utility', () => {
+  describe('extractMentions', () => {
+    it('returns empty array for empty or non-string input', () => {
+      expect(extractMentions('')).toEqual([]);
+      expect(extractMentions(null as any)).toEqual([]);
+      expect(extractMentions(undefined as any)).toEqual([]);
+    });
+
+    it('extracts single mention', () => {
+      expect(extractMentions('Hello @planner, please review.')).toEqual(['planner']);
+    });
+
+    it('extracts multiple mentions and deduplicates them', () => {
+      const text = 'Hey @jane and @planner, can @jane check with @coordinator?';
+      expect(extractMentions(text)).toEqual(['jane', 'planner', 'coordinator']);
+    });
+
+    it('supports quoted handles with spaces', () => {
+      const text = 'Assigning to @"Agent Planner" and @"Jane Doe"';
+      expect(extractMentions(text)).toEqual(['Agent Planner', 'Jane Doe']);
+    });
+
+    it('ignores email addresses without leading space or boundary', () => {
+      const text = 'Send mail to user@example.com or ping @alex';
+      expect(extractMentions(text)).toEqual(['alex']);
+    });
+
+    it('handles mentions with dashes, underscores, and periods', () => {
+      const text = 'Call @agent-1, @super_user, and @john.doe';
+      expect(extractMentions(text)).toEqual(['agent-1', 'super_user', 'john.doe']);
+    });
+  });
+
+  describe('parseMentionSegments', () => {
+    it('returns empty array for empty string', () => {
+      expect(parseMentionSegments('')).toEqual([]);
+    });
+
+    it('returns single text segment if no mentions', () => {
+      expect(parseMentionSegments('Just a normal comment without tags.')).toEqual([
+        { type: 'text', value: 'Just a normal comment without tags.' }
+      ]);
+    });
+
+    it('correctly segments text with single mention in the middle', () => {
+      const result = parseMentionSegments('Hello @planner, please check.');
+      expect(result).toEqual([
+        { type: 'text', value: 'Hello ' },
+        { type: 'mention', value: '@planner', handle: 'planner' },
+        { type: 'text', value: ', please check.' }
+      ]);
+    });
+
+    it('correctly segments text starting with a mention', () => {
+      const result = parseMentionSegments('@planner can you take a look?');
+      expect(result).toEqual([
+        { type: 'mention', value: '@planner', handle: 'planner' },
+        { type: 'text', value: ' can you take a look?' }
+      ]);
+    });
+
+    it('correctly segments text ending with a mention', () => {
+      const result = parseMentionSegments('Assigned to @coordinator');
+      expect(result).toEqual([
+        { type: 'text', value: 'Assigned to ' },
+        { type: 'mention', value: '@coordinator', handle: 'coordinator' }
+      ]);
+    });
+
+    it('correctly segments quoted mentions', () => {
+      const result = parseMentionSegments('Ping @"Agent Supervisor" ASAP');
+      expect(result).toEqual([
+        { type: 'text', value: 'Ping ' },
+        { type: 'mention', value: '@"Agent Supervisor"', handle: 'Agent Supervisor' },
+        { type: 'text', value: ' ASAP' }
+      ]);
+    });
+  });
+});

package/src/utils/mentions.ts

@@ -0,0 +1,89 @@
+export interface MentionSegment {
+  type: 'text' | 'mention';
+  value: string;
+  handle?: string;
+}
+
+/**
+ * Regex matching mentions:
+ * - Quoted mentions: @"Jane Doe"
+ * - Standard mentions: @jane_doe, @planner, @user-1, @john.smith
+ * Note: Does not match emails like foo@bar.com (requires word boundary or start of string before @).
+ */
+export const MENTION_REGEX = /(?:^|\s)@(?:"([^"]+)"|([a-zA-Z0-9_.-]+))/g;
+
+/**
+ * Extracts unique mention handles from a text string.
+ * Strips quotes and the leading '@' symbol.
+ * Preserves the order of their first appearance.
+ */
+export function extractMentions(content: string): string[] {
+  if (!content || typeof content !== 'string') return [];
+
+  const mentions: string[] = [];
+  const seen = new Set<string>();
+
+  // Reset regex lastIndex
+  const regex = new RegExp(MENTION_REGEX.source, 'g');
+  let match: RegExpExecArray | null;
+
+  while ((match = regex.exec(content)) !== null) {
+    const handle = match[1] ?? match[2];
+    if (handle && !seen.has(handle)) {
+      seen.add(handle);
+      mentions.push(handle);
+    }
+  }
+
+  return mentions;
+}
+
+/**
+ * Segments a text string into plain text parts and mention tokens.
+ * Useful for rendering highlighted mention badges or links in UI components.
+ */
+export function parseMentionSegments(content: string): MentionSegment[] {
+  if (!content) return [];
+
+  const segments: MentionSegment[] = [];
+  const regex = new RegExp(MENTION_REGEX.source, 'g');
+  let lastIndex = 0;
+  let match: RegExpExecArray | null;
+
+  while ((match = regex.exec(content)) !== null) {
+    const fullMatch = match[0];
+    const leadingWhitespace = fullMatch.startsWith(' ') || fullMatch.startsWith('\t') || fullMatch.startsWith('\n')
+      ? fullMatch[0]
+      : '';
+    const mentionToken = fullMatch.slice(leadingWhitespace.length);
+    const handle = match[1] ?? match[2];
+    const matchStart = match.index + leadingWhitespace.length;
+
+    // Push text before this mention if any
+    if (matchStart > lastIndex) {
+      segments.push({
+        type: 'text',
+        value: content.slice(lastIndex, matchStart)
+      });
+    }
+
+    // Push the mention token
+    segments.push({
+      type: 'mention',
+      value: mentionToken,
+      handle
+    });
+
+    lastIndex = match.index + fullMatch.length;
+  }
+
+  // Push any remaining text after the last match
+  if (lastIndex < content.length) {
+    segments.push({
+      type: 'text',
+      value: content.slice(lastIndex)
+    });
+  }
+
+  return segments;
+}

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,