@critical-path/core 0.2.0 → 0.3.0

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/status.d.ts

@@ -0,0 +1,14 @@
+import type { Task, StatusDefinition, CompletionState, ExecutionState } from '../types/index.js';
+export declare const DEFAULT_STATUS_DEFINITIONS: Record<string, StatusDefinition>;
+export interface TaskLifecycleState {
+    completionState: CompletionState;
+    executionState: ExecutionState;
+    isDone: boolean;
+    isActive: boolean;
+    isCancelled: boolean;
+    isOverdue: boolean;
+    isUpcoming: boolean;
+}
+export declare function resolveStatusDefinition(statusKey: string, customDefinitions?: StatusDefinition[]): StatusDefinition;
+export declare function deriveTaskLifecycleState(task: Task, customDefinitions?: StatusDefinition[], referenceDate?: Date): TaskLifecycleState;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/utils/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAOvE,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,eAAe,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,GACrC,gBAAgB,CAkBlB;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,EACV,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,EACtC,aAAa,GAAE,IAAiB,GAC/B,kBAAkB,CA+BpB"}

package/dist/utils/status.js

@@ -0,0 +1,58 @@
+export const DEFAULT_STATUS_DEFINITIONS = {
+    backlog: { key: 'backlog', label: 'Backlog', completionState: 'not_done', executionState: 'inactive' },
+    todo: { key: 'todo', label: 'To Do', completionState: 'not_done', executionState: 'inactive' },
+    in_progress: { key: 'in_progress', label: 'In Progress', completionState: 'not_done', executionState: 'active' },
+    in_review: { key: 'in_review', label: 'In Review', completionState: 'not_done', executionState: 'active' },
+    done: { key: 'done', label: 'Done', completionState: 'done', executionState: 'inactive' },
+    canceled: { key: 'canceled', label: 'Canceled', completionState: 'done', executionState: 'inactive', isCancelled: true }
+};
+export function resolveStatusDefinition(statusKey, customDefinitions) {
+    if (customDefinitions) {
+        const found = customDefinitions.find((def) => def.key === statusKey);
+        if (found)
+            return found;
+    }
+    if (DEFAULT_STATUS_DEFINITIONS[statusKey]) {
+        return DEFAULT_STATUS_DEFINITIONS[statusKey];
+    }
+    // Fallback heuristic for unknown custom statuses:
+    const isDoneKey = ['done', 'completed', 'finished', 'closed', 'canceled', 'cancelled'].includes(statusKey.toLowerCase());
+    const isActiveKey = ['in_progress', 'active', 'working', 'in_review', 'review'].includes(statusKey.toLowerCase());
+    return {
+        key: statusKey,
+        label: statusKey,
+        completionState: isDoneKey ? 'done' : 'not_done',
+        executionState: isActiveKey ? 'active' : 'inactive',
+        isCancelled: statusKey.toLowerCase().includes('cancel')
+    };
+}
+export function deriveTaskLifecycleState(task, customDefinitions, referenceDate = new Date()) {
+    const def = resolveStatusDefinition(task.status, customDefinitions);
+    const isDone = def.completionState === 'done';
+    const isActive = def.executionState === 'active';
+    const isCancelled = Boolean(def.isCancelled);
+    let isOverdue = false;
+    if (!isDone && task.dueDate) {
+        const due = new Date(task.dueDate);
+        if (!isNaN(due.getTime()) && due < referenceDate) {
+            isOverdue = true;
+        }
+    }
+    let isUpcoming = false;
+    if (!isDone && !isActive && task.plannedStartDate) {
+        const plannedStart = new Date(task.plannedStartDate);
+        if (!isNaN(plannedStart.getTime()) && plannedStart > referenceDate) {
+            isUpcoming = true;
+        }
+    }
+    return {
+        completionState: def.completionState,
+        executionState: def.executionState,
+        isDone,
+        isActive,
+        isCancelled,
+        isOverdue,
+        isUpcoming
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/utils/status.js.map

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

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@critical-path/core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Core headless domain engine, plugin architecture, and data stores for Critical Path",
   "author": "Jack James",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pixerate/critical-path.git"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/engine/index.ts

@@ -1,6 +1,16 @@
-import type { CriticalPathConfig, Project, Task, WebhookEvent } from '../types/index.js';
+import type {
+  CriticalPathConfig,
+  Project,
+  Task,
+  TaskDependencyGraph,
+  Team,
+  TaskContainer,
+  Iteration,
+  WebhookEvent
+} 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';
 
 export class CriticalPathEngine {
   public readonly store: StorageAdapter;
@@ -30,6 +40,21 @@ export class CriticalPathEngine {
         await this.store.createProject(p);
       }
     }
+    if (data.teams) {
+      for (const tm of data.teams) {
+        await this.store.createTeam(tm);
+      }
+    }
+    if (data.containers) {
+      for (const c of data.containers) {
+        await this.store.createContainer(c);
+      }
+    }
+    if (data.iterations) {
+      for (const it of data.iterations) {
+        await this.store.createIteration(it);
+      }
+    }
     if (data.tasks) {
       for (const t of data.tasks) {
         await this.store.createTask(t);
@@ -37,8 +62,7 @@ export class CriticalPathEngine {
     }
   }
 
-  // --- Domain Methods with Plugin Hooks & Audit Logging ---
-
+  // --- Projects ---
   async getProjects(): Promise<Project[]> {
     return this.store.getProjects();
   }
@@ -59,6 +83,7 @@ export class CriticalPathEngine {
     return created;
   }
 
+  // --- Tasks ---
   async getTasks(projectId?: string): Promise<Task[]> {
     return this.store.getTasks(projectId);
   }
@@ -68,7 +93,6 @@ export class CriticalPathEngine {
   }
 
   async createTask(taskInput: Omit<Task, 'id' | 'createdAt' | 'updatedAt'>): Promise<Task> {
-    // Run plugin beforeTaskCreate hooks
     const processedInput = await this.plugins.runBeforeTaskCreate(taskInput);
 
     const created = await this.store.createTask({
@@ -79,16 +103,27 @@ export class CriticalPathEngine {
       priority: processedInput.priority || taskInput.priority || 'medium',
       assigneeId: processedInput.assigneeId ?? taskInput.assigneeId,
       reporterId: processedInput.reporterId ?? taskInput.reporterId,
-      sprintId: processedInput.sprintId ?? taskInput.sprintId,
+      reviewerId: processedInput.reviewerId ?? taskInput.reviewerId,
+      iterationId: processedInput.iterationId ?? taskInput.iterationId,
+      teamId: processedInput.teamId ?? taskInput.teamId,
+      containerId: processedInput.containerId ?? taskInput.containerId,
+      plannedStartDate: processedInput.plannedStartDate ?? taskInput.plannedStartDate,
+      actualStartDate: processedInput.actualStartDate ?? taskInput.actualStartDate,
+      actualEndDate: processedInput.actualEndDate ?? taskInput.actualEndDate,
       dueDate: processedInput.dueDate ?? taskInput.dueDate,
       estimatedHours: processedInput.estimatedHours ?? taskInput.estimatedHours,
       loggedHours: processedInput.loggedHours ?? taskInput.loggedHours ?? 0,
+      actualHours: processedInput.actualHours ?? taskInput.actualHours,
+      billableHours: processedInput.billableHours ?? taskInput.billableHours,
+      estimatedDurationMinutes: processedInput.estimatedDurationMinutes ?? taskInput.estimatedDurationMinutes,
+      actualDurationMinutes: processedInput.actualDurationMinutes ?? taskInput.actualDurationMinutes,
+      billableDurationMinutes: processedInput.billableDurationMinutes ?? taskInput.billableDurationMinutes,
+      progress: processedInput.progress ?? taskInput.progress ?? 0,
       tags: processedInput.tags ?? taskInput.tags ?? [],
       customFields: processedInput.customFields ?? taskInput.customFields ?? {},
       parentId: processedInput.parentId ?? taskInput.parentId
     });
 
-    // Run plugin afterTaskCreate hooks
     await this.plugins.runAfterTaskCreate(created);
 
     await this.store.logActivity({
@@ -151,18 +186,136 @@ export class CriticalPathEngine {
     return deleted;
   }
 
+  // --- Task Dependencies & Graph ---
+  async getTaskDependencyGraph(taskId: string): Promise<TaskDependencyGraph> {
+    const dependencies = await this.store.getDependencies(taskId);
+    const upstreamTaskIds = new Set<string>();
+    const downstreamTaskIds = new Set<string>();
+
+    for (const dep of dependencies) {
+      if (dep.taskId === taskId) {
+        upstreamTaskIds.add(dep.dependsOnTaskId);
+      } else if (dep.dependsOnTaskId === taskId) {
+        downstreamTaskIds.add(dep.taskId);
+      }
+    }
+
+    const upstreamTasks = (
+      await Promise.all(Array.from(upstreamTaskIds).map((id) => this.store.getTask(id)))
+    ).filter((t): t is Task => t !== null);
+
+    const downstreamTasks = (
+      await Promise.all(Array.from(downstreamTaskIds).map((id) => this.store.getTask(id)))
+    ).filter((t): t is Task => t !== null);
+
+    return {
+      taskId,
+      upstreamTasks,
+      downstreamTasks,
+      dependencies
+    };
+  }
+
+  async getTaskLifecycleState(taskId: string): Promise<TaskLifecycleState | null> {
+    const task = await this.getTask(taskId);
+    if (!task) return null;
+    const project = await this.getProject(task.projectId);
+    return deriveTaskLifecycleState(task, project?.statusDefinitions);
+  }
+
+  // --- Teams ---
+  async getTeams(): Promise<Team[]> {
+    return this.store.getTeams();
+  }
+
+  async getTeam(id: string): Promise<Team | null> {
+    return this.store.getTeam(id);
+  }
+
+  async createTeam(team: Omit<Team, 'id' | 'createdAt' | 'updatedAt'>): Promise<Team> {
+    const created = await this.store.createTeam(team);
+    this.dispatchWebhook('team.created', { team: created });
+    return created;
+  }
+
+  async updateTeam(id: string, updates: Partial<Team>): Promise<Team | null> {
+    return this.store.updateTeam(id, updates);
+  }
+
+  async deleteTeam(id: string): Promise<boolean> {
+    return this.store.deleteTeam(id);
+  }
+
+  // --- Containers ---
+  async getContainers(projectId: string): Promise<TaskContainer[]> {
+    return this.store.getContainers(projectId);
+  }
+
+  async getContainer(id: string): Promise<TaskContainer | null> {
+    return this.store.getContainer(id);
+  }
+
+  async createContainer(container: Omit<TaskContainer, 'id' | 'createdAt' | 'updatedAt'>): Promise<TaskContainer> {
+    const created = await this.store.createContainer(container);
+    this.dispatchWebhook('container.created', { container: created });
+    return created;
+  }
+
+  async updateContainer(id: string, updates: Partial<TaskContainer>): Promise<TaskContainer | null> {
+    return this.store.updateContainer(id, updates);
+  }
+
+  async deleteContainer(id: string): Promise<boolean> {
+    return this.store.deleteContainer(id);
+  }
+
+  // --- Iterations ---
+  async getIterations(projectId: string): Promise<Iteration[]> {
+    return this.store.getIterations(projectId);
+  }
+
+  async getIteration(id: string): Promise<Iteration | null> {
+    return this.store.getIteration(id);
+  }
+
+  async createIteration(iteration: Omit<Iteration, 'id' | 'createdAt'>): Promise<Iteration> {
+    const created = await this.store.createIteration(iteration);
+    if (created.status === 'active') {
+      this.dispatchWebhook('iteration.started', { iteration: created });
+    }
+    return created;
+  }
+
+  async updateIteration(id: string, updates: Partial<Iteration>): Promise<Iteration | null> {
+    const existing = await this.store.getIteration(id);
+    if (!existing) return null;
+
+    const updated = await this.store.updateIteration(id, updates);
+    if (updated) {
+      if (existing.status !== 'active' && updated.status === 'active') {
+        this.dispatchWebhook('iteration.started', { iteration: updated });
+      } else if (existing.status !== 'completed' && updated.status === 'completed') {
+        this.dispatchWebhook('iteration.completed', { iteration: updated });
+      }
+    }
+    return updated;
+  }
+
+  async deleteIteration(id: string): Promise<boolean> {
+    return this.store.deleteIteration(id);
+  }
+
   private async dispatchWebhook(event: WebhookEvent, payload: Record<string, unknown>): Promise<void> {
     const webhooks = await this.store.getWebhooks();
     const active = webhooks.filter((w) => w.active && w.events.includes(event));
 
     for (const wh of active) {
-      // Fire-and-forget webhook post
       fetch(wh.url, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ event, timestamp: new Date().toISOString(), data: payload })
       }).catch(() => {
-        // Silent catch for webhook delivery errors in dev
+        // Silent catch for webhook errors in dev
       });
     }
   }

package/src/index.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { CriticalPathEngine } from './engine/index.js';
+import { CriticalPathEngine, deriveTaskLifecycleState } from './index.js';
 import type { CriticalPathPlugin } from './types/index.js';
 
 describe('CriticalPathEngine Core Tests', () => {
@@ -60,4 +60,116 @@ describe('CriticalPathEngine Core Tests', () => {
     expect(hookExecuted).toBe(true);
     expect(task.tags).toContain('auto-tagged');
   });
+
+  it('handles teams, containers, and iterations', async () => {
+    const engine = new CriticalPathEngine();
+
+    const team = await engine.createTeam({
+      name: 'Engineering',
+      memberIds: ['user_1', 'user_2']
+    });
+
+    const proj = await engine.createProject({
+      key: 'ENG',
+      name: 'Engineering Project',
+      teamIds: [team.id]
+    });
+
+    const container = await engine.createContainer({
+      projectId: proj.id,
+      name: 'Core Platform Epic',
+      type: 'epic'
+    });
+
+    const iteration = await engine.createIteration({
+      projectId: proj.id,
+      name: 'Sprint 1',
+      type: 'sprint',
+      status: 'active'
+    });
+
+    const task = await engine.createTask({
+      projectId: proj.id,
+      title: 'Setup Database Schema',
+      status: 'in_progress',
+      priority: 'urgent',
+      reviewerId: 'user_2',
+      teamId: team.id,
+      containerId: container.id,
+      iterationId: iteration.id,
+      plannedStartDate: '2026-09-01T00:00:00.000Z',
+      dueDate: '2026-09-15T00:00:00.000Z',
+      estimatedHours: 10,
+      actualHours: 8,
+      billableHours: 8,
+      estimatedDurationMinutes: 600,
+      actualDurationMinutes: 480,
+      billableDurationMinutes: 480,
+      progress: 80
+    });
+
+    expect(task.reviewerId).toBe('user_2');
+    expect(task.teamId).toBe(team.id);
+    expect(task.containerId).toBe(container.id);
+    expect(task.iterationId).toBe(iteration.id);
+    expect(task.estimatedHours).toBe(10);
+    expect(task.actualHours).toBe(8);
+    expect(task.billableHours).toBe(8);
+    expect(task.estimatedDurationMinutes).toBe(600);
+    expect(task.actualDurationMinutes).toBe(480);
+    expect(task.billableDurationMinutes).toBe(480);
+    expect(task.progress).toBe(80);
+  });
+
+  it('evaluates status definitions and task lifecycle state', async () => {
+    const engine = new CriticalPathEngine();
+
+    const proj = await engine.createProject({
+      key: 'CUST',
+      name: 'Custom Workflow Project',
+      statusDefinitions: [
+        { key: 'draft', label: 'Draft', completionState: 'not_done', executionState: 'inactive' },
+        { key: 'active_work', label: 'Active Work', completionState: 'not_done', executionState: 'active' },
+        { key: 'finished', label: 'Finished', completionState: 'done', executionState: 'inactive' }
+      ]
+    });
+
+    const task = await engine.createTask({
+      projectId: proj.id,
+      title: 'Workflow Task',
+      status: 'active_work',
+      priority: 'medium',
+      plannedStartDate: '2026-08-01T00:00:00.000Z',
+      dueDate: '2026-08-10T00:00:00.000Z'
+    });
+
+    const state = await engine.getTaskLifecycleState(task.id);
+    expect(state).not.toBeNull();
+    expect(state?.completionState).toBe('not_done');
+    expect(state?.executionState).toBe('active');
+    expect(state?.isActive).toBe(true);
+    expect(state?.isDone).toBe(false);
+  });
+
+  it('builds task dependency graph with upstream and downstream tasks', async () => {
+    const engine = new CriticalPathEngine();
+
+    const proj = await engine.createProject({ key: 'DEP', name: 'Dependency Project' });
+
+    const taskA = await engine.createTask({ projectId: proj.id, title: 'Task A', status: 'todo', priority: 'medium' });
+    const taskB = await engine.createTask({ projectId: proj.id, title: 'Task B', status: 'todo', priority: 'medium' });
+
+    // Task B depends on Task A
+    await engine.store.addDependency({
+      taskId: taskB.id,
+      dependsOnTaskId: taskA.id,
+      type: 'blocking'
+    });
+
+    const graphA = await engine.getTaskDependencyGraph(taskA.id);
+    expect(graphA.downstreamTasks.map((t) => t.id)).toContain(taskB.id);
+
+    const graphB = await engine.getTaskDependencyGraph(taskB.id);
+    expect(graphB.upstreamTasks.map((t) => t.id)).toContain(taskA.id);
+  });
 });

package/src/index.ts

@@ -1,4 +1,6 @@
 export * from './types/index.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

@@ -1,11 +1,17 @@
 import { describe, it, expect, beforeEach } from 'vitest';
-import { FirebaseStore } from './firebase.js';
+import { FirebaseStore, InMemoryFirestoreMock } from './firebase.js';
 
 describe('FirebaseStore', () => {
   let store: FirebaseStore;
 
   beforeEach(() => {
-    store = new FirebaseStore();
+    store = new FirebaseStore({ db: new InMemoryFirestoreMock() });
+  });
+
+  it('should throw an error if db is missing in config', () => {
+    expect(() => new FirebaseStore({} as any)).toThrow(
+      'FirebaseStore requires a valid Firestore db instance'
+    );
   });
 
   it('should create and retrieve projects in FirebaseStore', async () => {