@critical-path/core 0.3.0 → 0.4.0

package/dist/utils/workflow.js

@@ -0,0 +1,101 @@
+import { DEFAULT_STATUS_DEFINITIONS } from './status.js';
+export class WorkflowValidationError extends Error {
+    fromStatus;
+    toStatus;
+    workflowId;
+    constructor(fromStatus, toStatus, workflowId, message) {
+        const msg = message || `Illegal status transition from "${fromStatus}" to "${toStatus}"${workflowId ? ` in workflow "${workflowId}"` : ''}.`;
+        super(msg);
+        this.name = 'WorkflowValidationError';
+        this.fromStatus = fromStatus;
+        this.toStatus = toStatus;
+        this.workflowId = workflowId;
+    }
+}
+export const DEFAULT_TASK_TYPES = [
+    { key: 'task', label: 'Task', description: 'A standard work item', icon: 'check-square' },
+    { key: 'bug', label: 'Bug', description: 'A problem or defect that needs fixing', icon: 'bug' },
+    { key: 'feature', label: 'Feature', description: 'A new capability or enhancement', icon: 'sparkles' },
+    { key: 'epic', label: 'Epic', description: 'A large body of work that spans multiple tasks', icon: 'layers' },
+    { key: 'subtask', label: 'Subtask', description: 'A piece of work required to complete a parent task', icon: 'corner-down-right' }
+];
+export const DEFAULT_SOFTWARE_WORKFLOW = {
+    id: 'wf_software_default',
+    name: 'Software Development Workflow',
+    description: 'Standard software development lifecycle with backlog, review, and completion states.',
+    statuses: [
+        DEFAULT_STATUS_DEFINITIONS.backlog,
+        DEFAULT_STATUS_DEFINITIONS.todo,
+        DEFAULT_STATUS_DEFINITIONS.in_progress,
+        DEFAULT_STATUS_DEFINITIONS.in_review,
+        DEFAULT_STATUS_DEFINITIONS.done,
+        DEFAULT_STATUS_DEFINITIONS.canceled
+    ],
+    transitions: [
+        { name: 'Start Work', fromStatusKey: 'backlog', toStatusKey: 'todo' },
+        { name: 'Start Implementation', fromStatusKey: 'todo', toStatusKey: 'in_progress' },
+        { name: 'Complete Task', fromStatusKey: 'todo', toStatusKey: 'done' },
+        { name: 'Submit for Review', fromStatusKey: 'in_progress', toStatusKey: 'in_review' },
+        { name: 'Complete Implementation', fromStatusKey: 'in_progress', toStatusKey: 'done' },
+        { name: 'Approve & Complete', fromStatusKey: 'in_review', toStatusKey: 'done' },
+        { name: 'Request Changes', fromStatusKey: 'in_review', toStatusKey: 'in_progress' },
+        { name: 'Reopen', fromStatusKey: 'done', toStatusKey: 'todo' },
+        { name: 'Cancel', fromStatusKey: '*', toStatusKey: 'canceled' },
+        { name: 'Restore', fromStatusKey: 'canceled', toStatusKey: 'todo' }
+    ],
+    taskTypes: DEFAULT_TASK_TYPES,
+    defaultStatusKey: 'todo',
+    isDefault: true,
+    createdAt: '2026-01-01T00:00:00.000Z',
+    updatedAt: '2026-01-01T00:00:00.000Z'
+};
+export const DEFAULT_SIMPLE_WORKFLOW = {
+    id: 'wf_simple_default',
+    name: 'Simple Task Workflow',
+    description: 'Lightweight workflow with To Do, In Progress, and Done states.',
+    statuses: [
+        DEFAULT_STATUS_DEFINITIONS.todo,
+        DEFAULT_STATUS_DEFINITIONS.in_progress,
+        DEFAULT_STATUS_DEFINITIONS.done
+    ],
+    transitions: [
+        { name: 'Start', fromStatusKey: 'todo', toStatusKey: 'in_progress' },
+        { name: 'Complete', fromStatusKey: 'todo', toStatusKey: 'done' },
+        { name: 'Complete', fromStatusKey: 'in_progress', toStatusKey: 'done' },
+        { name: 'Reopen', fromStatusKey: 'done', toStatusKey: 'todo' }
+    ],
+    taskTypes: DEFAULT_TASK_TYPES.filter((t) => ['task', 'subtask'].includes(t.key)),
+    defaultStatusKey: 'todo',
+    isDefault: true,
+    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;
+    if (!workflow || !workflow.transitions || workflow.transitions.length === 0)
+        return true;
+    return workflow.transitions.some((t) => (t.fromStatusKey === '*' || t.fromStatusKey === fromStatus) &&
+        (t.toStatusKey === '*' || t.toStatusKey === toStatus));
+}
+export function getAllowedNextStatuses(workflow, currentStatus) {
+    if (!workflow || !workflow.statuses || workflow.statuses.length === 0) {
+        return Object.keys(DEFAULT_STATUS_DEFINITIONS);
+    }
+    const allStatusKeys = workflow.statuses.map((s) => s.key);
+    if (!workflow.transitions || workflow.transitions.length === 0) {
+        return allStatusKeys;
+    }
+    const matches = workflow.transitions.filter((t) => t.fromStatusKey === '*' || t.fromStatusKey === currentStatus);
+    if (matches.some((t) => t.toStatusKey === '*')) {
+        return allStatusKeys;
+    }
+    const allowed = new Set();
+    for (const t of matches) {
+        if (allStatusKeys.includes(t.toStatusKey)) {
+            allowed.add(t.toStatusKey);
+        }
+    }
+    return Array.from(allowed);
+}
+//# sourceMappingURL=workflow.js.map

package/dist/utils/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/utils/workflow.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChC,UAAU,CAAS;IACnB,QAAQ,CAAS;IACjB,UAAU,CAAU;IAEpC,YAAY,UAAkB,EAAE,QAAgB,EAAE,UAAmB,EAAE,OAAgB;QACrF,MAAM,GAAG,GAAG,OAAO,IAAI,mCAAmC,UAAU,SAAS,QAAQ,IAAI,UAAU,CAAC,CAAC,CAAC,iBAAiB,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QAC7I,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAyB;IACtD,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,sBAAsB,EAAE,IAAI,EAAE,cAAc,EAAE;IACzF,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,uCAAuC,EAAE,IAAI,EAAE,KAAK,EAAE;IAC/F,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,iCAAiC,EAAE,IAAI,EAAE,UAAU,EAAE;IACtG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,gDAAgD,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC7G,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,oDAAoD,EAAE,IAAI,EAAE,mBAAmB,EAAE;CACnI,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAa;IACjD,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE,sFAAsF;IACnG,QAAQ,EAAE;QACR,0BAA0B,CAAC,OAAO;QAClC,0BAA0B,CAAC,IAAI;QAC/B,0BAA0B,CAAC,WAAW;QACtC,0BAA0B,CAAC,SAAS;QACpC,0BAA0B,CAAC,IAAI;QAC/B,0BAA0B,CAAC,QAAQ;KACpC;IACD,WAAW,EAAE;QACX,EAAE,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE;QACrE,EAAE,IAAI,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE;QACnF,EAAE,IAAI,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;QACrE,EAAE,IAAI,EAAE,mBAAmB,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE;QACrF,EAAE,IAAI,EAAE,yBAAyB,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE;QACtF,EAAE,IAAI,EAAE,oBAAoB,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE;QAC/E,EAAE,IAAI,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE;QACnF,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;QAC9D,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE;QAC/D,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE;KACpE;IACD,SAAS,EAAE,kBAAkB;IAC7B,gBAAgB,EAAE,MAAM;IACxB,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,0BAA0B;IACrC,SAAS,EAAE,0BAA0B;CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,gEAAgE;IAC7E,QAAQ,EAAE;QACR,0BAA0B,CAAC,IAAI;QAC/B,0BAA0B,CAAC,WAAW;QACtC,0BAA0B,CAAC,IAAI;KAChC;IACD,WAAW,EAAE;QACX,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE;QACpE,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;QAChE,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE;QACvE,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;KAC/D;IACD,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChF,gBAAgB,EAAE,MAAM;IACxB,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,0BAA0B;IACrC,SAAS,EAAE,0BAA0B;CACtC,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAChC,QAA8B,EAC9B,UAAkB,EAClB,QAAgB;IAEhB,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzF,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,aAAa,KAAK,GAAG,IAAI,CAAC,CAAC,aAAa,KAAK,UAAU,CAAC;QAC3D,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,CACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAA8B,EAC9B,aAAqB;IAErB,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,OAAO,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,GAAG,IAAI,CAAC,CAAC,aAAa,KAAK,aAAa,CACpE,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,CAAC,EAAE,CAAC;QAC/C,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

package/package.json

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

package/src/engine/index.ts

@@ -6,11 +6,18 @@ import type {
   Team,
   TaskContainer,
   Iteration,
-  WebhookEvent
+  WebhookEvent,
+  Workflow
 } from '../types/index.js';
 import { StorageAdapter, InMemoryStore } from '../store/index.js';
 import { PluginRegistry } from '../plugins/index.js';
 import { deriveTaskLifecycleState, type TaskLifecycleState } from '../utils/status.js';
+import {
+  validateTransition,
+  getAllowedNextStatuses,
+  WorkflowValidationError,
+  DEFAULT_SOFTWARE_WORKFLOW
+} from '../utils/workflow.js';
 
 export class CriticalPathEngine {
   public readonly store: StorageAdapter;
@@ -35,6 +42,11 @@ export class CriticalPathEngine {
   }
 
   private async seedInitialData(data: NonNullable<CriticalPathConfig['initialData']>): Promise<void> {
+    if (data.workflows) {
+      for (const wf of data.workflows) {
+        await this.store.createWorkflow(wf);
+      }
+    }
     if (data.projects) {
       for (const p of data.projects) {
         await this.store.createProject(p);
@@ -62,6 +74,81 @@ export class CriticalPathEngine {
     }
   }
 
+  // --- Workflows ---
+  async getWorkflows(): Promise<Workflow[]> {
+    return this.store.getWorkflows();
+  }
+
+  async getWorkflow(id: string): Promise<Workflow | null> {
+    return this.store.getWorkflow(id);
+  }
+
+  async createWorkflow(workflow: Omit<Workflow, 'id' | 'createdAt' | 'updatedAt'>): Promise<Workflow> {
+    const created = await this.store.createWorkflow(workflow);
+    await this.store.logActivity({
+      actorId: 'system',
+      action: 'workflow.created',
+      details: { name: created.name }
+    });
+    this.dispatchWebhook('workflow.created', { workflow: created });
+    return created;
+  }
+
+  async updateWorkflow(id: string, updates: Partial<Workflow>): Promise<Workflow | null> {
+    const existing = await this.store.getWorkflow(id);
+    if (!existing) return null;
+
+    const updated = await this.store.updateWorkflow(id, updates);
+    if (updated) {
+      await this.store.logActivity({
+        actorId: 'system',
+        action: 'workflow.updated',
+        details: { name: updated.name }
+      });
+      this.dispatchWebhook('workflow.updated', { workflow: updated, previous: existing });
+    }
+    return updated;
+  }
+
+  async deleteWorkflow(id: string): Promise<boolean> {
+    const existing = await this.store.getWorkflow(id);
+    if (!existing) return false;
+
+    const deleted = await this.store.deleteWorkflow(id);
+    if (deleted) {
+      await this.store.logActivity({
+        actorId: 'system',
+        action: 'workflow.deleted',
+        details: { name: existing.name }
+      });
+      this.dispatchWebhook('workflow.deleted', { workflowId: id, name: existing.name });
+    }
+    return deleted;
+  }
+
+  async resolveProjectWorkflow(projectId: string): Promise<Workflow | null> {
+    const project = await this.store.getProject(projectId);
+    if (project?.workflow) return project.workflow;
+    if (project?.workflowId) {
+      const wf = await this.store.getWorkflow(project.workflowId);
+      if (wf) return wf;
+    }
+
+    const workflows = await this.store.getWorkflows();
+    const defaultWf = workflows.find((w) => w.isDefault);
+    if (defaultWf) return defaultWf;
+    if (workflows.length > 0) return workflows[0];
+
+    return DEFAULT_SOFTWARE_WORKFLOW;
+  }
+
+  async getAllowedTaskTransitions(taskId: string): Promise<string[]> {
+    const task = await this.store.getTask(taskId);
+    if (!task) return [];
+    const workflow = await this.resolveProjectWorkflow(task.projectId);
+    return getAllowedNextStatuses(workflow || undefined, task.status);
+  }
+
   // --- Projects ---
   async getProjects(): Promise<Project[]> {
     return this.store.getProjects();
@@ -94,13 +181,18 @@ export class CriticalPathEngine {
 
   async createTask(taskInput: Omit<Task, 'id' | 'createdAt' | 'updatedAt'>): Promise<Task> {
     const processedInput = await this.plugins.runBeforeTaskCreate(taskInput);
+    const projectId = processedInput.projectId || taskInput.projectId;
+    const workflow = await this.resolveProjectWorkflow(projectId);
+
+    const defaultStatus = workflow?.defaultStatusKey || 'todo';
 
     const created = await this.store.createTask({
-      projectId: processedInput.projectId || taskInput.projectId,
+      projectId,
       title: processedInput.title || taskInput.title,
       description: processedInput.description ?? taskInput.description,
-      status: processedInput.status || taskInput.status || 'todo',
+      status: processedInput.status || taskInput.status || defaultStatus,
       priority: processedInput.priority || taskInput.priority || 'medium',
+      taskType: processedInput.taskType || taskInput.taskType || 'task',
       assigneeId: processedInput.assigneeId ?? taskInput.assigneeId,
       reporterId: processedInput.reporterId ?? taskInput.reporterId,
       reviewerId: processedInput.reviewerId ?? taskInput.reviewerId,
@@ -142,6 +234,14 @@ export class CriticalPathEngine {
     const existing = await this.store.getTask(id);
     if (!existing) return null;
 
+    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);
+      }
+    }
+
     const processedUpdates = await this.plugins.runBeforeTaskUpdate(id, updates);
     const updated = await this.store.updateTask(id, processedUpdates);
     if (!updated) return null;

package/src/index.test.ts

@@ -172,4 +172,58 @@ describe('CriticalPathEngine Core Tests', () => {
     const graphB = await engine.getTaskDependencyGraph(taskB.id);
     expect(graphB.upstreamTasks.map((t) => t.id)).toContain(taskA.id);
   });
+
+  it('manages workflows and enforces status transitions', async () => {
+    const engine = new CriticalPathEngine();
+
+    // Create a strict workflow
+    const workflow = await engine.createWorkflow({
+      name: 'Strict Software Workflow',
+      defaultStatusKey: 'backlog',
+      statuses: [
+        { key: 'backlog', label: 'Backlog', completionState: 'not_done', executionState: 'inactive' },
+        { key: 'in_progress', label: 'In Progress', completionState: 'not_done', executionState: 'active' },
+        { key: 'done', label: 'Done', completionState: 'done', executionState: 'inactive' }
+      ],
+      transitions: [
+        { id: 't1', fromStatusKey: 'backlog', toStatusKey: 'in_progress', name: 'Start Work' },
+        { id: 't2', fromStatusKey: 'in_progress', toStatusKey: 'done', name: 'Complete Work' }
+      ]
+    });
+
+    expect(workflow.id).toBeDefined();
+
+    // Create project tied to workflow
+    const proj = await engine.createProject({
+      key: 'WF',
+      name: 'Workflow Project',
+      workflowId: workflow.id
+    });
+
+    // Create task
+    const task = await engine.createTask({
+      projectId: proj.id,
+      title: 'Workflow Task',
+      status: 'backlog',
+      priority: 'high'
+    });
+
+    expect(task.status).toBe('backlog');
+    expect(task.taskType).toBe('task');
+
+    // Check allowed transitions
+    const allowed = await engine.getAllowedTaskTransitions(task.id);
+    expect(allowed).toEqual(['in_progress']);
+
+    // Valid transition: backlog -> in_progress
+    const updated = await engine.updateTask(task.id, { status: 'in_progress' });
+    expect(updated?.status).toBe('in_progress');
+
+    // Invalid transition: in_progress -> backlog (not allowed in strict workflow)
+    await expect(engine.updateTask(task.id, { status: 'backlog' })).rejects.toThrow();
+
+    // Valid transition: in_progress -> done
+    const doneTask = await engine.updateTask(task.id, { status: 'done' });
+    expect(doneTask?.status).toBe('done');
+  });
 });

package/src/store/firebase.test.ts

@@ -56,4 +56,25 @@ describe('FirebaseStore', () => {
     const remaining = await store.getTasks(project.id);
     expect(remaining).toHaveLength(0);
   });
+
+  it('should create, update, and delete workflows in FirebaseStore', async () => {
+    const workflow = await store.createWorkflow({
+      name: 'Firebase Workflow',
+      isDefault: false,
+      defaultStatusKey: 'backlog',
+      statuses: [{ key: 'backlog', label: 'Backlog', completionState: 'not_done', executionState: 'inactive' }],
+      transitions: []
+    });
+
+    expect(workflow.id).toBeDefined();
+
+    const fetched = await store.getWorkflow(workflow.id);
+    expect(fetched?.name).toBe('Firebase Workflow');
+
+    const updated = await store.updateWorkflow(workflow.id, { isDefault: true });
+    expect(updated?.isDefault).toBe(true);
+
+    const deleted = await store.deleteWorkflow(workflow.id);
+    expect(deleted).toBe(true);
+  });
 });

package/src/store/firebase.ts

@@ -9,7 +9,8 @@ import type {
   TimeEntry,
   Activity,
   Webhook,
-  TaskDependency
+  TaskDependency,
+  Workflow
 } from '../types/index.js';
 import { generateProjectKey } from '../utils/key.js';
 
@@ -153,6 +154,46 @@ export class FirebaseStore implements StorageAdapter {
     return true;
   }
 
+  // --- Workflows ---
+  async getWorkflows(): Promise<Workflow[]> {
+    const snap = await this.db.collection('workflows').get();
+    return snap.docs.map((doc) => ({ ...doc.data(), id: doc.id }));
+  }
+
+  async getWorkflow(id: string): Promise<Workflow | null> {
+    const snap = await this.db.collection('workflows').doc(id).get();
+    if (!snap.exists) return null;
+    return { ...snap.data(), id: snap.id };
+  }
+
+  async createWorkflow(workflow: Omit<Workflow, 'id' | 'createdAt' | 'updatedAt'>): Promise<Workflow> {
+    const docRef = this.db.collection('workflows').doc();
+    const now = new Date().toISOString();
+    const newWf: Workflow = { ...workflow, id: docRef.id, createdAt: now, updatedAt: now };
+    await docRef.set(newWf);
+    return newWf;
+  }
+
+  async updateWorkflow(id: string, updates: Partial<Workflow>): Promise<Workflow | null> {
+    const existing = await this.getWorkflow(id);
+    if (!existing) return null;
+
+    const updated: Workflow = {
+      ...existing,
+      ...updates,
+      updatedAt: new Date().toISOString()
+    };
+    await this.db.collection('workflows').doc(id).set(updated, { merge: true });
+    return updated;
+  }
+
+  async deleteWorkflow(id: string): Promise<boolean> {
+    const existing = await this.getWorkflow(id);
+    if (!existing) return false;
+    await this.db.collection('workflows').doc(id).delete();
+    return true;
+  }
+
   // --- Teams ---
   async getTeams(): Promise<Team[]> {
     const snap = await this.db.collection('teams').get();

package/src/store/index.ts

@@ -11,7 +11,8 @@ import type {
   TimeEntry,
   Activity,
   Webhook,
-  TaskDependency
+  TaskDependency,
+  Workflow
 } from '../types/index.js';
 import { generateProjectKey } from '../utils/key.js';
 
@@ -23,6 +24,13 @@ export interface StorageAdapter {
   updateProject(id: string, updates: Partial<Project>): Promise<Project | null>;
   deleteProject(id: string): Promise<boolean>;
 
+  // Workflows
+  getWorkflows(): Promise<Workflow[]>;
+  getWorkflow(id: string): Promise<Workflow | null>;
+  createWorkflow(workflow: Omit<Workflow, 'id' | 'createdAt' | 'updatedAt'>): Promise<Workflow>;
+  updateWorkflow(id: string, updates: Partial<Workflow>): Promise<Workflow | null>;
+  deleteWorkflow(id: string): Promise<boolean>;
+
   // Tasks
   getTasks(projectId?: string): Promise<Task[]>;
   getTask(id: string): Promise<Task | null>;
@@ -72,6 +80,7 @@ export interface StorageAdapter {
 
 export class InMemoryStore implements StorageAdapter {
   private projects = new Map<string, Project>();
+  private workflows = new Map<string, Workflow>();
   private tasks = new Map<string, Task>();
   private teams = new Map<string, Team>();
   private containers = new Map<string, TaskContainer>();
@@ -121,6 +130,44 @@ export class InMemoryStore implements StorageAdapter {
     return this.projects.delete(id);
   }
 
+  // Workflows
+  async getWorkflows(): Promise<Workflow[]> {
+    return Array.from(this.workflows.values());
+  }
+
+  async getWorkflow(id: string): Promise<Workflow | null> {
+    return this.workflows.get(id) || null;
+  }
+
+  async createWorkflow(workflow: Omit<Workflow, 'id' | 'createdAt' | 'updatedAt'>): Promise<Workflow> {
+    const id = `wf_${Math.random().toString(36).substring(2, 9)}`;
+    const now = new Date().toISOString();
+    const newWorkflow: Workflow = {
+      ...workflow,
+      id,
+      createdAt: now,
+      updatedAt: now
+    };
+    this.workflows.set(id, newWorkflow);
+    return newWorkflow;
+  }
+
+  async updateWorkflow(id: string, updates: Partial<Workflow>): Promise<Workflow | null> {
+    const existing = this.workflows.get(id);
+    if (!existing) return null;
+    const updated: Workflow = {
+      ...existing,
+      ...updates,
+      updatedAt: new Date().toISOString()
+    };
+    this.workflows.set(id, updated);
+    return updated;
+  }
+
+  async deleteWorkflow(id: string): Promise<boolean> {
+    return this.workflows.delete(id);
+  }
+
   async getTasks(projectId?: string): Promise<Task[]> {
     const all = Array.from(this.tasks.values());
     if (projectId) {

package/src/store/sqlite.test.ts

@@ -75,4 +75,32 @@ describe('SQLiteStore', () => {
     const entries = await store.getTimeEntries('task_1');
     expect(entries).toHaveLength(1);
   });
+
+  it('should create, retrieve, update, and delete workflows', async () => {
+    const workflow = await store.createWorkflow({
+      name: 'SQLite Workflow',
+      isDefault: true,
+      defaultStatusKey: 'todo',
+      statuses: [{ key: 'todo', label: 'To Do', completionState: 'not_done', executionState: 'inactive' }],
+      transitions: []
+    });
+
+    expect(workflow.id).toMatch(/^wf_/);
+    expect(workflow.name).toBe('SQLite Workflow');
+
+    const fetched = await store.getWorkflow(workflow.id);
+    expect(fetched?.isDefault).toBe(true);
+
+    const updated = await store.updateWorkflow(workflow.id, { name: 'Updated SQLite Workflow' });
+    expect(updated?.name).toBe('Updated SQLite Workflow');
+
+    const all = await store.getWorkflows();
+    expect(all).toHaveLength(1);
+
+    const deleted = await store.deleteWorkflow(workflow.id);
+    expect(deleted).toBe(true);
+
+    const remaining = await store.getWorkflows();
+    expect(remaining).toHaveLength(0);
+  });
 });