@critical-path/core 0.18.0 → 0.19.0

package/src/types/index.ts

@@ -33,6 +33,32 @@ export type TaskLifecycleState = TaskDerivedStatus;
 
 export type Role = 'admin' | 'project_manager' | 'contributor' | 'viewer';
 
+export interface WorkingHoursRange {
+  start: string; // "09:00" (HH:MM 24-hour format)
+  end: string;   // "17:00"
+}
+
+export interface DaySchedule {
+  dayOfWeek: number; // 0 = Sunday, 1 = Monday, ..., 6 = Saturday
+  isWorkingDay: boolean;
+  hours?: WorkingHoursRange[];
+}
+
+export interface Holiday {
+  date: string; // "YYYY-MM-DD"
+  name?: string;
+  halfDay?: boolean; // if true, counts as 50% working hours
+}
+
+export interface WorkSchedule {
+  id?: string;
+  name?: string;
+  timezone?: string; // Informational (e.g. "UTC", "America/New_York")
+  defaultHoursPerDay?: number; // Default: 8
+  days: DaySchedule[];
+  holidays?: Holiday[];
+}
+
 export interface User {
   id: string;
   name: string;
@@ -40,6 +66,7 @@ export interface User {
   avatarUrl?: string;
   role: Role;
   weeklyCapacityHours?: number;
+  schedule?: WorkSchedule;
   createdAt: string;
 }
 
@@ -50,6 +77,7 @@ export interface Team {
   leaderId?: string;
   memberIds: string[];
   weeklyCapacityHours?: number;
+  schedule?: WorkSchedule;
   createdAt: string;
   updatedAt: string;
 }
@@ -107,6 +135,9 @@ export interface Project {
   statusDefinitions?: StatusDefinition[];
   priorityDefinitions?: Array<{ key: string; label: string; level?: number }>;
   customFieldDefinitions?: CustomFieldDefinition[];
+  schedule?: WorkSchedule;
+  startDate?: string;
+  targetEndDate?: string;
   createdAt: string;
   updatedAt: string;
 }
@@ -185,6 +216,8 @@ export interface Task {
   billableDurationMinutes?: number;
   // Progress (0 to 100 percentage)
   progress?: number;
+  isBlocked?: boolean;
+  blockedReason?: string | null;
   tags?: string[];
   todos?: TaskTodoItem[];
   customFields?: Record<string, unknown>;
@@ -371,6 +404,7 @@ export type WebhookEvent =
   | 'task.updated'
   | 'task.deleted'
   | 'task.status_changed'
+  | 'task.blocked'
   | 'task.unblocked'
   | 'comment.created'
   | 'comment.updated'
@@ -415,6 +449,7 @@ export interface CriticalPathConfig {
   fileStorage?: FileStorageAdapter;
   plugins?: CriticalPathPlugin[];
   webhooks?: Omit<Webhook, 'id' | 'createdAt'>[];
+  defaultSchedule?: WorkSchedule;
   initialData?: {
     projects?: Project[];
     tasks?: Task[];
@@ -483,12 +518,21 @@ export interface TaskCriticalPathSchedule {
   lateFinish: number;
   totalSlack: number;
   isCritical: boolean;
+  durationHours?: number;
+  earlyStartDate?: string;
+  earlyFinishDate?: string;
+  lateStartDate?: string;
+  lateFinishDate?: string;
+  slackWorkingHours?: number;
 }
 
 export interface CriticalPathAnalysis {
   projectId: string;
   calculatedAt: string;
   totalDurationHours: number;
+  totalWorkingHours?: number;
+  projectStartDate?: string;
+  projectEndDate?: string;
   criticalTaskIds: string[];
   tasks: TaskCriticalPathSchedule[];
 }
@@ -523,6 +567,7 @@ export interface RealityDelta {
   effortVarianceHours?: number; // loggedHours - estimatedHours (effort variance)
   durationVarianceHours?: number; // actual duration hours - planned duration hours
   scheduleVarianceDays?: number; // days difference between planned/due vs actual
+  scheduleVarianceWorkingDays?: number; // working days difference between planned/due vs actual
   accuracyRatio?: number; // loggedHours / estimatedHours (estimation accuracy ratio)
   isOverdue: boolean;
   isOverEstimate: boolean;
@@ -669,5 +714,8 @@ export interface WorkloadDistributionOptions {
   metric?: WorkloadMetric; // default: 'blended'
   defaultWeeklyCapacityHours?: number; // default: 40
   capacityOverrides?: Record<string, number>; // e.g. { [assigneeOrTeamId]: weeklyCapacityHours }
+  schedule?: WorkSchedule;
+  userSchedules?: Record<string, WorkSchedule>;
+  teamSchedules?: Record<string, WorkSchedule>;
 }
 

package/src/utils/status.ts

@@ -88,8 +88,13 @@ export function deriveTaskLifecycleState(
     return upstreamDef.category !== 'completed';
   });
   const blockingTaskIds = blockingTasks.map((t) => t.id);
-  const isBlocked = !isDone && blockingTaskIds.length > 0;
-  const isReady = semanticStatus === 'not_started' && blockingTaskIds.length === 0;
+  const isExplicitlyBlocked = Boolean(
+    task.isBlocked === true ||
+    task.customFields?.isBlocked === true ||
+    task.status === 'blocked'
+  );
+  const isBlocked = !isDone && (blockingTaskIds.length > 0 || isExplicitlyBlocked);
+  const isReady = semanticStatus === 'not_started' && !isBlocked;
 
   // Time & Schedule Indicators
   let isOverdue = false;

package/tsconfig.tsbuildinfo

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