@critical-path/core 0.2.1 → 0.4.0

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './status.js';
+export * from './key.js';
+export * from './workflow.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export * from './status.js';
+export * from './key.js';
+export * from './workflow.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/utils/key.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generates a 2-6 character uppercase project short code/key from a project name.
+ * e.g., "Mobile App" -> "MA", "Frontend Core" -> "FC", "Operative" -> "OPE".
+ */
+export declare function generateProjectKey(name: string): string;
+/**
+ * Validates whether a given key meets project key format rules (2-6 uppercase alphanumeric characters).
+ */
+export declare function validateProjectKey(key: string): boolean;
+/**
+ * Formats a task key using a project key and task index (e.g. "MOB-12").
+ */
+export declare function formatTaskKey(projectKey: string, taskNumber: number): string;
+//# sourceMappingURL=key.d.ts.map

package/dist/utils/key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.d.ts","sourceRoot":"","sources":["../../src/utils/key.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8BvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAG5E"}

package/dist/utils/key.js

@@ -0,0 +1,49 @@
+/**
+ * Generates a 2-6 character uppercase project short code/key from a project name.
+ * e.g., "Mobile App" -> "MA", "Frontend Core" -> "FC", "Operative" -> "OPE".
+ */
+export function generateProjectKey(name) {
+    if (!name || !name.trim()) {
+        return 'PRJ';
+    }
+    const words = name.trim().split(/\s+/).filter(Boolean);
+    let rawKey = '';
+    if (words.length === 1) {
+        const word = words[0].replace(/[^a-zA-Z0-9]/g, '');
+        if (word.length <= 3) {
+            rawKey = word.toUpperCase();
+        }
+        else {
+            rawKey = word.substring(0, 3).toUpperCase();
+        }
+    }
+    else {
+        rawKey = words
+            .map((w) => w.replace(/[^a-zA-Z0-9]/g, '')[0] || '')
+            .join('')
+            .substring(0, 4)
+            .toUpperCase();
+    }
+    // Ensure key meets basic 2-6 char alphanumeric requirement
+    const cleanKey = rawKey.replace(/[^A-Z0-9]/g, '');
+    if (cleanKey.length >= 2 && cleanKey.length <= 6) {
+        return cleanKey;
+    }
+    return 'PRJ';
+}
+/**
+ * Validates whether a given key meets project key format rules (2-6 uppercase alphanumeric characters).
+ */
+export function validateProjectKey(key) {
+    if (!key)
+        return false;
+    return /^[A-Z0-9]{2,6}$/.test(key);
+}
+/**
+ * Formats a task key using a project key and task index (e.g. "MOB-12").
+ */
+export function formatTaskKey(projectKey, taskNumber) {
+    const prefix = projectKey ? projectKey.toUpperCase() : 'TASK';
+    return `${prefix}-${taskNumber}`;
+}
+//# sourceMappingURL=key.js.map

package/dist/utils/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../src/utils/key.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,KAAK;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACnD,IAAI,CAAC,EAAE,CAAC;aACR,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;aACf,WAAW,EAAE,CAAC;IACnB,CAAC;IAED,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAClD,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,OAAO,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,UAAkB;IAClE,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,OAAO,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;AACnC,CAAC"}

package/dist/utils/key.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=key.test.d.ts.map

package/dist/utils/key.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.test.d.ts","sourceRoot":"","sources":["../../src/utils/key.test.ts"],"names":[],"mappings":""}

package/dist/utils/key.test.js

@@ -0,0 +1,48 @@
+import { describe, it, expect } from 'vitest';
+import { generateProjectKey, validateProjectKey, formatTaskKey } from './key.js';
+describe('Project Key Utilities', () => {
+    describe('generateProjectKey', () => {
+        it('generates a key for a single word name', () => {
+            expect(generateProjectKey('Operative')).toBe('OPE');
+            expect(generateProjectKey('App')).toBe('APP');
+            expect(generateProjectKey('Go')).toBe('GO');
+        });
+        it('generates a key for multi-word names', () => {
+            expect(generateProjectKey('Mobile App')).toBe('MA');
+            expect(generateProjectKey('Frontend Core Platform')).toBe('FCP');
+            expect(generateProjectKey('Very Long Project Name Here')).toBe('VLPN');
+        });
+        it('handles special characters and whitespace', () => {
+            expect(generateProjectKey('  v2.0  ')).toBe('V20');
+            expect(generateProjectKey('Project #1')).toBe('P1');
+        });
+        it('returns default PRJ fallback for empty input', () => {
+            expect(generateProjectKey('')).toBe('PRJ');
+            expect(generateProjectKey('   ')).toBe('PRJ');
+        });
+    });
+    describe('validateProjectKey', () => {
+        it('returns true for valid keys', () => {
+            expect(validateProjectKey('CP')).toBe(true);
+            expect(validateProjectKey('PROJ')).toBe(true);
+            expect(validateProjectKey('APP123')).toBe(true);
+        });
+        it('returns false for invalid keys', () => {
+            expect(validateProjectKey('A')).toBe(false); // too short
+            expect(validateProjectKey('TOOLONGKEY')).toBe(false); // too long
+            expect(validateProjectKey('proj')).toBe(false); // lowercase
+            expect(validateProjectKey('P-1')).toBe(false); // special char
+            expect(validateProjectKey('')).toBe(false);
+        });
+    });
+    describe('formatTaskKey', () => {
+        it('formats project key and task number', () => {
+            expect(formatTaskKey('MOB', 42)).toBe('MOB-42');
+            expect(formatTaskKey('op', 1)).toBe('OP-1');
+        });
+        it('uses fallback for missing project key', () => {
+            expect(formatTaskKey('', 10)).toBe('TASK-10');
+        });
+    });
+});
+//# sourceMappingURL=key.test.js.map

package/dist/utils/key.test.js.map

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

package/dist/utils/workflow.d.ts

@@ -0,0 +1,13 @@
+import type { Workflow, TaskTypeDefinition } from '../types/index.js';
+export declare class WorkflowValidationError extends Error {
+    readonly fromStatus: string;
+    readonly toStatus: string;
+    readonly workflowId?: string;
+    constructor(fromStatus: string, toStatus: string, workflowId?: string, message?: string);
+}
+export declare const DEFAULT_TASK_TYPES: TaskTypeDefinition[];
+export declare const DEFAULT_SOFTWARE_WORKFLOW: Workflow;
+export declare const DEFAULT_SIMPLE_WORKFLOW: Workflow;
+export declare function validateTransition(workflow: Workflow | undefined, fromStatus: string, toStatus: string): boolean;
+export declare function getAllowedNextStatuses(workflow: Workflow | undefined, currentStatus: string): string[];
+//# sourceMappingURL=workflow.d.ts.map

package/dist/utils/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/utils/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAER,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAG3B,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQxF;AAED,eAAO,MAAM,kBAAkB,EAAE,kBAAkB,EAMlD,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,QA6BvC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,QAoBrC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAST;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,aAAa,EAAE,MAAM,GACpB,MAAM,EAAE,CA0BV"}

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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@critical-path/core",
-  "version": "0.2.1",
+  "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/index.ts

@@ -1,5 +1,6 @@
 export * from './types/index.js';
-export * from './utils/status.js';
+export * from './utils/index.js';
 export * from './store/index.js';
 export * from './plugins/index.js';
 export * from './engine/index.js';
+

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,8 +9,10 @@ import type {
   TimeEntry,
   Activity,
   Webhook,
-  TaskDependency
+  TaskDependency,
+  Workflow
 } from '../types/index.js';
+import { generateProjectKey } from '../utils/key.js';
 
 export interface FirestoreDBInterface {
   collection(name: string): {
@@ -126,7 +128,8 @@ export class FirebaseStore implements StorageAdapter {
   async createProject(project: Omit<Project, 'id' | 'createdAt' | 'updatedAt'>): Promise<Project> {
     const docRef = this.db.collection('projects').doc();
     const now = new Date().toISOString();
-    const newProj: Project = { ...project, id: docRef.id, createdAt: now, updatedAt: now };
+    const key = project.key || generateProjectKey(project.name);
+    const newProj: Project = { ...project, key, id: docRef.id, createdAt: now, updatedAt: now };
     await docRef.set(newProj);
     return newProj;
   }
@@ -151,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();