@critical-path/core 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @critical-path/core
 
+## 0.19.0
+
+### Minor Changes
+
+- 31a6dde: Promote task blocking state (`isBlocked: boolean` and `blockedReason: string | null`) to first-class fields on `Task`, `CreateTaskInput`, and `UpdateTaskInput`.
+  
+  - **Domain Events**: Introduced `TaskBlockedEvent` (`task.blocked`) and updated `TaskUnblockedEvent` (`task.unblocked`) to support explicit unblocking.
+  - **Lifecycle Derivation**: Updated `deriveTaskStatus` and `deriveTaskLifecycleState` to reflect `task.isBlocked` directly alongside upstream dependency checks.
+  - **Engines & Storage**: Added `isBlocked` and `blockedReason` persistence to `SQLiteStore`, `FirebaseStore`, and `InMemoryStore`.
+  - **MCP Server**: Added `isBlocked` and `blockedReason` parameter options to `create_task` and `update_task` tool schemas.
+- 31a6dde: Add comprehensive Work Schedule, Working Hours, Working Days & Holidays subsystem:
+  - Added `WorkSchedule`, `DaySchedule`, `WorkingHoursRange`, and `Holiday` types supporting custom shifts, weekend configurations, and organization/regional holidays.
+  - Integrated hierarchical calendar resolution: Task Assignee/Team -> Project -> Engine/Default (`DEFAULT_WORK_SCHEDULE`).
+  - Enhanced Critical Path Method (CPM) with calendar working-hours math (`earlyStartDate`, `earlyFinishDate`, `lateStartDate`, `lateFinishDate`, `totalWorkingHours`, `projectEndDate`) skipping weekends and holidays.
+  - Enhanced Workload & Capacity Engine with working-day effort distribution and holiday capacity deductions.
+  - Added working-days schedule variance (`scheduleVarianceWorkingDays`) to Reality Deltas in the Ladder of Abstraction.
+
 ## 0.18.0
 
 ### Minor Changes

package/README.md

@@ -36,6 +36,12 @@
   - Multi-scale timeline synthesis: Macro bird's-eye phase rollups (`getTimelineLadder({ level: 'macro' })`), Standard Gantt view with topological CPM forward/backward passes and total float/slack, and Concrete grounding (attachments, deliverables, checklist items, daily effort histograms, and reality deltas).
   - Single-task contextual drilldown via `getTaskLadder(taskId)`.
   - Comprehensive CPM analysis via `calculateCriticalPath(projectId)` identifying project bottleneck tasks and critical path duration.
+- **Work Schedules, Working Hours, Working Days & Holidays Subsystem**:
+  - Configurable `WorkSchedule` data model defining day-by-day active working hours (e.g. 09:00–17:00), non-working days/weekends, and organization or regional `Holiday` exemptions.
+  - Multi-level schedule inheritance hierarchy: Task Assignee / Team -> Project -> Global Engine Default (`DEFAULT_WORK_SCHEDULE`).
+  - Calendar math domain operations (`addWorkingHours`, `subtractWorkingHours`, `getWorkingHoursBetween`, `getWorkingDaysBetween`, `getNetAvailableCapacity`).
+  - Automatic exclusion of weekends and holidays during Critical Path Method (CPM) forward and backward schedule passes (`earlyStartDate`, `earlyFinishDate`, `lateStartDate`, `lateFinishDate`, `totalWorkingHours`, `projectEndDate`).
+  - Calendar-aware capacity reductions in Workload Distribution and working-day schedule variance metrics (`scheduleVarianceWorkingDays`).
 - **Headless Workload & Capacity Distribution (Streamgraphs & Capacity Planning)**:
   - Time-series aggregations across customizable intervals (`day`, `week`, `month`) and dimensions (`assignee`, `team`, `taskType`, `priority`, `status`).
   - Pluggable effort distribution metrics (`scheduled`, `logged`, `remaining`, `blended`) with contiguous, gap-free calendar buckets and zero-filled tabular series matrices ready for D3 (`d3.stack().offset(d3.stackOffsetWiggle)`).
@@ -202,6 +208,43 @@ console.log('Contiguous Weekly Buckets:', workload.buckets);
 // }
 ```
 
+### 8. Configuring Work Schedules, Working Hours & Holidays
+
+```ts
+import { CriticalPathEngine, type WorkSchedule, addWorkingHours } from '@critical-path/core';
+
+// Define a project schedule with 4-day workweeks and holidays
+const engineeringSchedule: WorkSchedule = {
+  timezone: 'UTC',
+  days: {
+    monday: { isWorking: true, hours: [{ start: '09:00', end: '17:00' }] },
+    tuesday: { isWorking: true, hours: [{ start: '09:00', end: '17:00' }] },
+    wednesday: { isWorking: true, hours: [{ start: '09:00', end: '17:00' }] },
+    thursday: { isWorking: true, hours: [{ start: '09:00', end: '17:00' }] },
+    friday: { isWorking: false },
+    saturday: { isWorking: false },
+    sunday: { isWorking: false }
+  },
+  holidays: [
+    { date: '2026-12-25', name: 'Christmas Day' },
+    { date: '2026-12-26', name: 'Boxing Day' }
+  ]
+};
+
+const engine = new CriticalPathEngine({
+  defaultSchedule: engineeringSchedule
+});
+
+// CPM automatically rolls over non-working days and holidays
+const cpm = await engine.calculateCriticalPath('proj_123', {
+  projectStartDate: '2026-09-01T09:00:00Z',
+  schedule: engineeringSchedule
+});
+
+console.log('Project End Date (skipping weekends & holidays):', cpm.projectEndDate);
+console.log('Total Working Hours on Critical Path:', cpm.totalWorkingHours);
+```
+
 ---
 
 ## 🔌 Creating a Custom Plugin

package/dist/domain/calendar.d.ts

@@ -0,0 +1,53 @@
+import type { Project, Team, User, WorkSchedule } from '../types/index.js';
+export declare const DEFAULT_WORK_SCHEDULE: WorkSchedule;
+export interface ScheduleResolutionContext {
+    user?: User | null;
+    team?: Team | null;
+    project?: Project | null;
+    defaultSchedule?: WorkSchedule | null;
+}
+/**
+ * Resolves the effective work schedule following the hierarchy:
+ * 1. User schedule (if present)
+ * 2. Team schedule (if present)
+ * 3. Project schedule (if present)
+ * 4. Engine / default schedule (fallback to DEFAULT_WORK_SCHEDULE)
+ */
+export declare function resolveEffectiveSchedule(context?: ScheduleResolutionContext): WorkSchedule;
+export declare function toDateString(d: Date): string;
+export declare function parseDate(input: Date | string): Date;
+/**
+ * Checks whether a given calendar date is an active working day under the provided schedule.
+ */
+export declare function isWorkingDay(input: Date | string, schedule?: WorkSchedule): boolean;
+/**
+ * Returns the effective working hours available on a specific calendar day.
+ */
+export declare function getWorkingHoursInDay(input: Date | string, schedule?: WorkSchedule): number;
+/**
+ * Advances a start date forward by a given number of working hours,
+ * skipping non-working days, holidays, and non-working hours.
+ */
+export declare function addWorkingHours(startInput: Date | string, hoursToAdd: number, schedule?: WorkSchedule): Date;
+/**
+ * Moves backward from an end date by a given number of working hours,
+ * skipping non-working days, holidays, and non-working hours.
+ */
+export declare function subtractWorkingHours(endInput: Date | string, hoursToSubtract: number, schedule?: WorkSchedule): Date;
+/**
+ * Calculates the exact number of active working hours between two dates under the schedule.
+ */
+export declare function getWorkingHoursBetween(startInput: Date | string, endInput: Date | string, schedule?: WorkSchedule): number;
+/**
+ * Returns the count of working days between two dates (inclusive of start and end).
+ */
+export declare function getWorkingDaysBetween(startInput: Date | string, endInput: Date | string, schedule?: WorkSchedule): number;
+/**
+ * Returns an array of YYYY-MM-DD date strings for all active working days between start and end.
+ */
+export declare function getWorkingDaysList(startInput: Date | string, endInput: Date | string, schedule?: WorkSchedule): string[];
+/**
+ * Computes net available capacity (in working hours) over a contiguous date interval.
+ */
+export declare function getNetAvailableCapacity(startInput: Date | string, endInput: Date | string, schedule?: WorkSchedule): number;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/domain/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/domain/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,OAAO,EACP,IAAI,EACJ,IAAI,EAEJ,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,qBAAqB,EAAE,YAanC,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,YAAY,CAM1F;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAE5C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAUpD;AAkBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,QAAQ,GAAE,YAAoC,GAAG,OAAO,CAa1G;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,QAAQ,GAAE,YAAoC,GAAG,MAAM,CA4BjH;AA4CD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,IAAI,GAAG,MAAM,EACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,YAAoC,GAC7C,IAAI,CAqEN;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,IAAI,GAAG,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,QAAQ,GAAE,YAAoC,GAC7C,IAAI,CAkEN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,IAAI,GAAG,MAAM,EACzB,QAAQ,EAAE,IAAI,GAAG,MAAM,EACvB,QAAQ,GAAE,YAAoC,GAC7C,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,IAAI,GAAG,MAAM,EACzB,QAAQ,EAAE,IAAI,GAAG,MAAM,EACvB,QAAQ,GAAE,YAAoC,GAC7C,MAAM,CAuBR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,IAAI,GAAG,MAAM,EACzB,QAAQ,EAAE,IAAI,GAAG,MAAM,EACvB,QAAQ,GAAE,YAAoC,GAC7C,MAAM,EAAE,CAsBV;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,IAAI,GAAG,MAAM,EACzB,QAAQ,EAAE,IAAI,GAAG,MAAM,EACvB,QAAQ,GAAE,YAAoC,GAC7C,MAAM,CAgBR"}

package/dist/domain/calendar.js

@@ -0,0 +1,333 @@
+export const DEFAULT_WORK_SCHEDULE = {
+    name: 'Standard 40-Hour Work Week',
+    defaultHoursPerDay: 8,
+    days: [
+        { dayOfWeek: 0, isWorkingDay: false }, // Sunday
+        { dayOfWeek: 1, isWorkingDay: true, hours: [{ start: '09:00', end: '17:00' }] }, // Monday
+        { dayOfWeek: 2, isWorkingDay: true, hours: [{ start: '09:00', end: '17:00' }] }, // Tuesday
+        { dayOfWeek: 3, isWorkingDay: true, hours: [{ start: '09:00', end: '17:00' }] }, // Wednesday
+        { dayOfWeek: 4, isWorkingDay: true, hours: [{ start: '09:00', end: '17:00' }] }, // Thursday
+        { dayOfWeek: 5, isWorkingDay: true, hours: [{ start: '09:00', end: '17:00' }] }, // Friday
+        { dayOfWeek: 6, isWorkingDay: false } // Saturday
+    ],
+    holidays: []
+};
+/**
+ * Resolves the effective work schedule following the hierarchy:
+ * 1. User schedule (if present)
+ * 2. Team schedule (if present)
+ * 3. Project schedule (if present)
+ * 4. Engine / default schedule (fallback to DEFAULT_WORK_SCHEDULE)
+ */
+export function resolveEffectiveSchedule(context) {
+    if (context?.user?.schedule)
+        return context.user.schedule;
+    if (context?.team?.schedule)
+        return context.team.schedule;
+    if (context?.project?.schedule)
+        return context.project.schedule;
+    if (context?.defaultSchedule)
+        return context.defaultSchedule;
+    return DEFAULT_WORK_SCHEDULE;
+}
+export function toDateString(d) {
+    return d.toISOString().split('T')[0];
+}
+export function parseDate(input) {
+    if (input instanceof Date) {
+        return new Date(input.getTime());
+    }
+    if (!input.includes('T')) {
+        // Treat date-only string as UTC midnight
+        const parts = input.split('-');
+        return new Date(Date.UTC(parseInt(parts[0], 10), parseInt(parts[1], 10) - 1, parseInt(parts[2], 10)));
+    }
+    return new Date(input);
+}
+function parseTimeToMinutes(timeStr) {
+    const parts = timeStr.split(':');
+    const h = parseInt(parts[0], 10) || 0;
+    const m = parseInt(parts[1], 10) || 0;
+    return h * 60 + m;
+}
+function getDayConfig(dayOfWeek, schedule) {
+    return schedule.days.find((d) => d.dayOfWeek === dayOfWeek);
+}
+function getHoliday(dateStr, schedule) {
+    if (!schedule.holidays)
+        return undefined;
+    return schedule.holidays.find((h) => h.date === dateStr);
+}
+/**
+ * Checks whether a given calendar date is an active working day under the provided schedule.
+ */
+export function isWorkingDay(input, schedule = DEFAULT_WORK_SCHEDULE) {
+    const d = parseDate(input);
+    const dateStr = toDateString(d);
+    const holiday = getHoliday(dateStr, schedule);
+    if (holiday && !holiday.halfDay) {
+        return false;
+    }
+    const dayOfWeek = d.getUTCDay();
+    const dayConfig = getDayConfig(dayOfWeek, schedule);
+    if (!dayConfig || !dayConfig.isWorkingDay) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Returns the effective working hours available on a specific calendar day.
+ */
+export function getWorkingHoursInDay(input, schedule = DEFAULT_WORK_SCHEDULE) {
+    const d = parseDate(input);
+    const dateStr = toDateString(d);
+    const holiday = getHoliday(dateStr, schedule);
+    if (holiday && !holiday.halfDay) {
+        return 0;
+    }
+    const dayOfWeek = d.getUTCDay();
+    const dayConfig = getDayConfig(dayOfWeek, schedule);
+    if (!dayConfig || !dayConfig.isWorkingDay) {
+        return 0;
+    }
+    let baseHours = schedule.defaultHoursPerDay ?? 8;
+    if (dayConfig.hours && dayConfig.hours.length > 0) {
+        baseHours = dayConfig.hours.reduce((sum, range) => {
+            const startMin = parseTimeToMinutes(range.start);
+            const endMin = parseTimeToMinutes(range.end);
+            return sum + Math.max(0, (endMin - startMin) / 60);
+        }, 0);
+    }
+    if (holiday && holiday.halfDay) {
+        return Math.round((baseHours / 2) * 100) / 100;
+    }
+    return baseHours;
+}
+/**
+ * Returns the normalized working time windows (in minutes from UTC midnight) for a given date.
+ */
+function getDayWorkingWindows(d, schedule) {
+    const dateStr = toDateString(d);
+    const holiday = getHoliday(dateStr, schedule);
+    if (holiday && !holiday.halfDay) {
+        return [];
+    }
+    const dayOfWeek = d.getUTCDay();
+    const dayConfig = getDayConfig(dayOfWeek, schedule);
+    if (!dayConfig || !dayConfig.isWorkingDay) {
+        return [];
+    }
+    let ranges = dayConfig.hours && dayConfig.hours.length > 0
+        ? dayConfig.hours.map((r) => ({ start: parseTimeToMinutes(r.start), end: parseTimeToMinutes(r.end) }))
+        : [{ start: 9 * 60, end: (9 + (schedule.defaultHoursPerDay ?? 8)) * 60 }];
+    if (holiday && holiday.halfDay && ranges.length > 0) {
+        // Take the first half of the working hours
+        const totalMinutes = ranges.reduce((acc, r) => acc + (r.end - r.start), 0);
+        let targetMinutes = totalMinutes / 2;
+        const adjustedRanges = [];
+        for (const r of ranges) {
+            const dur = r.end - r.start;
+            if (targetMinutes <= 0)
+                break;
+            if (dur <= targetMinutes) {
+                adjustedRanges.push(r);
+                targetMinutes -= dur;
+            }
+            else {
+                adjustedRanges.push({ start: r.start, end: r.start + targetMinutes });
+                targetMinutes = 0;
+            }
+        }
+        return adjustedRanges;
+    }
+    return ranges;
+}
+/**
+ * Advances a start date forward by a given number of working hours,
+ * skipping non-working days, holidays, and non-working hours.
+ */
+export function addWorkingHours(startInput, hoursToAdd, schedule = DEFAULT_WORK_SCHEDULE) {
+    if (hoursToAdd <= 0) {
+        return parseDate(startInput);
+    }
+    let current = parseDate(startInput);
+    let remainingMinutes = Math.round(hoursToAdd * 60);
+    // Safety guard against infinite loops
+    let daysScanned = 0;
+    const maxDays = 3650; // 10 years
+    while (remainingMinutes > 0 && daysScanned < maxDays) {
+        const windows = getDayWorkingWindows(current, schedule);
+        if (windows.length === 0) {
+            // Non-working day or holiday: move to start of next UTC day
+            current = new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate() + 1, 0, 0, 0, 0));
+            daysScanned++;
+            continue;
+        }
+        const currentMinuteOfDay = current.getUTCHours() * 60 + current.getUTCMinutes() + current.getUTCSeconds() / 60;
+        for (let i = 0; i < windows.length && remainingMinutes > 0; i++) {
+            const w = windows[i];
+            if (currentMinuteOfDay >= w.end) {
+                // Already past this window
+                continue;
+            }
+            // If current time is before the window starts, jump to window start
+            const windowStartMin = Math.max(w.start, currentMinuteOfDay);
+            const availableMinutes = w.end - windowStartMin;
+            if (remainingMinutes <= availableMinutes) {
+                const finalMinuteOfDay = windowStartMin + remainingMinutes;
+                const finalHour = Math.floor(finalMinuteOfDay / 60);
+                const finalMin = Math.round(finalMinuteOfDay % 60);
+                return new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate(), finalHour, finalMin, 0, 0));
+            }
+            else {
+                remainingMinutes -= availableMinutes;
+                // Advance current time to end of this window
+                current = new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate(), Math.floor(w.end / 60), Math.round(w.end % 60), 0, 0));
+            }
+        }
+        // Finished processing windows for today; advance to tomorrow at 00:00
+        current = new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate() + 1, 0, 0, 0, 0));
+        daysScanned++;
+    }
+    return current;
+}
+/**
+ * Moves backward from an end date by a given number of working hours,
+ * skipping non-working days, holidays, and non-working hours.
+ */
+export function subtractWorkingHours(endInput, hoursToSubtract, schedule = DEFAULT_WORK_SCHEDULE) {
+    if (hoursToSubtract <= 0) {
+        return parseDate(endInput);
+    }
+    let current = parseDate(endInput);
+    let remainingMinutes = Math.round(hoursToSubtract * 60);
+    let daysScanned = 0;
+    const maxDays = 3650;
+    while (remainingMinutes > 0 && daysScanned < maxDays) {
+        const windows = getDayWorkingWindows(current, schedule);
+        if (windows.length === 0) {
+            // Non-working day: move to end of previous UTC day (23:59:59)
+            current = new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate() - 1, 23, 59, 59, 999));
+            daysScanned++;
+            continue;
+        }
+        const currentMinuteOfDay = current.getUTCHours() * 60 + current.getUTCMinutes() + current.getUTCSeconds() / 60;
+        // Traverse windows backwards
+        for (let i = windows.length - 1; i >= 0 && remainingMinutes > 0; i--) {
+            const w = windows[i];
+            if (currentMinuteOfDay <= w.start) {
+                continue;
+            }
+            const windowEndMin = Math.min(w.end, currentMinuteOfDay);
+            const availableMinutes = windowEndMin - w.start;
+            if (remainingMinutes <= availableMinutes) {
+                const finalMinuteOfDay = windowEndMin - remainingMinutes;
+                const finalHour = Math.floor(finalMinuteOfDay / 60);
+                const finalMin = Math.round(finalMinuteOfDay % 60);
+                return new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate(), finalHour, finalMin, 0, 0));
+            }
+            else {
+                remainingMinutes -= availableMinutes;
+                current = new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate(), Math.floor(w.start / 60), Math.round(w.start % 60), 0, 0));
+            }
+        }
+        // Move to end of previous day
+        current = new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate() - 1, 23, 59, 59, 999));
+        daysScanned++;
+    }
+    return current;
+}
+/**
+ * Calculates the exact number of active working hours between two dates under the schedule.
+ */
+export function getWorkingHoursBetween(startInput, endInput, schedule = DEFAULT_WORK_SCHEDULE) {
+    const start = parseDate(startInput);
+    const end = parseDate(endInput);
+    if (end <= start) {
+        return 0;
+    }
+    let totalMinutes = 0;
+    let current = new Date(Date.UTC(start.getUTCFullYear(), start.getUTCMonth(), start.getUTCDate(), 0, 0, 0, 0));
+    const endDay = new Date(Date.UTC(end.getUTCFullYear(), end.getUTCMonth(), end.getUTCDate(), 0, 0, 0, 0));
+    let days = 0;
+    while (current <= endDay && days < 3650) {
+        const windows = getDayWorkingWindows(current, schedule);
+        const isFirstDay = current.getTime() === Date.UTC(start.getUTCFullYear(), start.getUTCMonth(), start.getUTCDate(), 0, 0, 0, 0);
+        const isLastDay = current.getTime() === endDay.getTime();
+        const startMin = isFirstDay ? start.getUTCHours() * 60 + start.getUTCMinutes() : 0;
+        const endMin = isLastDay ? end.getUTCHours() * 60 + end.getUTCMinutes() : 24 * 60;
+        for (const w of windows) {
+            const activeStart = Math.max(w.start, startMin);
+            const activeEnd = Math.min(w.end, endMin);
+            if (activeEnd > activeStart) {
+                totalMinutes += (activeEnd - activeStart);
+            }
+        }
+        current = new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate() + 1, 0, 0, 0, 0));
+        days++;
+    }
+    return Math.round((totalMinutes / 60) * 100) / 100;
+}
+/**
+ * Returns the count of working days between two dates (inclusive of start and end).
+ */
+export function getWorkingDaysBetween(startInput, endInput, schedule = DEFAULT_WORK_SCHEDULE) {
+    const start = parseDate(startInput);
+    const end = parseDate(endInput);
+    if (end < start) {
+        return 0;
+    }
+    let current = new Date(Date.UTC(start.getUTCFullYear(), start.getUTCMonth(), start.getUTCDate(), 0, 0, 0, 0));
+    const endDay = new Date(Date.UTC(end.getUTCFullYear(), end.getUTCMonth(), end.getUTCDate(), 0, 0, 0, 0));
+    let count = 0;
+    let days = 0;
+    while (current <= endDay && days < 3650) {
+        if (isWorkingDay(current, schedule)) {
+            const holiday = getHoliday(toDateString(current), schedule);
+            count += (holiday && holiday.halfDay) ? 0.5 : 1;
+        }
+        current = new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate() + 1, 0, 0, 0, 0));
+        days++;
+    }
+    return count;
+}
+/**
+ * Returns an array of YYYY-MM-DD date strings for all active working days between start and end.
+ */
+export function getWorkingDaysList(startInput, endInput, schedule = DEFAULT_WORK_SCHEDULE) {
+    const start = parseDate(startInput);
+    const end = parseDate(endInput);
+    if (end < start) {
+        return [];
+    }
+    let current = new Date(Date.UTC(start.getUTCFullYear(), start.getUTCMonth(), start.getUTCDate(), 0, 0, 0, 0));
+    const endDay = new Date(Date.UTC(end.getUTCFullYear(), end.getUTCMonth(), end.getUTCDate(), 0, 0, 0, 0));
+    const list = [];
+    let days = 0;
+    while (current <= endDay && days < 3650) {
+        if (isWorkingDay(current, schedule)) {
+            list.push(toDateString(current));
+        }
+        current = new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate() + 1, 0, 0, 0, 0));
+        days++;
+    }
+    return list;
+}
+/**
+ * Computes net available capacity (in working hours) over a contiguous date interval.
+ */
+export function getNetAvailableCapacity(startInput, endInput, schedule = DEFAULT_WORK_SCHEDULE) {
+    const start = parseDate(startInput);
+    const end = parseDate(endInput);
+    let current = new Date(Date.UTC(start.getUTCFullYear(), start.getUTCMonth(), start.getUTCDate(), 0, 0, 0, 0));
+    const endDay = new Date(Date.UTC(end.getUTCFullYear(), end.getUTCMonth(), end.getUTCDate(), 0, 0, 0, 0));
+    let totalCapacity = 0;
+    let days = 0;
+    while (current <= endDay && days < 3650) {
+        totalCapacity += getWorkingHoursInDay(current, schedule);
+        current = new Date(Date.UTC(current.getUTCFullYear(), current.getUTCMonth(), current.getUTCDate() + 1, 0, 0, 0, 0));
+        days++;
+    }
+    return Math.round(totalCapacity * 100) / 100;
+}
+//# sourceMappingURL=calendar.js.map

package/dist/domain/calendar.js.map

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

package/dist/domain/calendar.test.d.ts

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

package/dist/domain/calendar.test.d.ts.map

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

package/dist/domain/calendar.test.js

@@ -0,0 +1,136 @@
+import { describe, it, expect } from 'vitest';
+import { DEFAULT_WORK_SCHEDULE, resolveEffectiveSchedule, isWorkingDay, getWorkingHoursInDay, addWorkingHours, subtractWorkingHours, getWorkingHoursBetween, getWorkingDaysBetween, getWorkingDaysList, getNetAvailableCapacity } from './calendar.js';
+describe('Calendar and Work Schedule Domain', () => {
+    describe('resolveEffectiveSchedule', () => {
+        const customUserSchedule = {
+            name: 'User 30h',
+            defaultHoursPerDay: 6,
+            days: [{ dayOfWeek: 1, isWorkingDay: true }]
+        };
+        const customTeamSchedule = {
+            name: 'Team 35h',
+            defaultHoursPerDay: 7,
+            days: [{ dayOfWeek: 1, isWorkingDay: true }]
+        };
+        const customProjectSchedule = {
+            name: 'Project 4-Day',
+            defaultHoursPerDay: 10,
+            days: [{ dayOfWeek: 1, isWorkingDay: true }]
+        };
+        it('prioritizes user schedule when present', () => {
+            const resolved = resolveEffectiveSchedule({
+                user: { id: 'u1', name: 'Alice', email: 'alice@test.com', role: 'contributor', schedule: customUserSchedule, createdAt: '' },
+                team: { id: 't1', name: 'Dev', memberIds: [], schedule: customTeamSchedule, createdAt: '', updatedAt: '' },
+                project: { id: 'p1', name: 'Proj', schedule: customProjectSchedule, createdAt: '', updatedAt: '' }
+            });
+            expect(resolved.name).toBe('User 30h');
+        });
+        it('falls back to team schedule when user has no custom schedule', () => {
+            const resolved = resolveEffectiveSchedule({
+                user: { id: 'u1', name: 'Alice', email: 'alice@test.com', role: 'contributor', createdAt: '' },
+                team: { id: 't1', name: 'Dev', memberIds: [], schedule: customTeamSchedule, createdAt: '', updatedAt: '' },
+                project: { id: 'p1', name: 'Proj', schedule: customProjectSchedule, createdAt: '', updatedAt: '' }
+            });
+            expect(resolved.name).toBe('Team 35h');
+        });
+        it('falls back to project schedule when user and team have no schedule', () => {
+            const resolved = resolveEffectiveSchedule({
+                project: { id: 'p1', name: 'Proj', schedule: customProjectSchedule, createdAt: '', updatedAt: '' }
+            });
+            expect(resolved.name).toBe('Project 4-Day');
+        });
+        it('falls back to engine default or DEFAULT_WORK_SCHEDULE', () => {
+            const resolved = resolveEffectiveSchedule();
+            expect(resolved.name).toBe(DEFAULT_WORK_SCHEDULE.name);
+            expect(resolved.defaultHoursPerDay).toBe(8);
+        });
+    });
+    describe('isWorkingDay and getWorkingHoursInDay', () => {
+        // 2026-09-18 is Friday, 2026-09-19 is Saturday, 2026-09-20 is Sunday, 2026-09-21 is Monday
+        it('identifies weekdays as working days and weekends as non-working days by default', () => {
+            expect(isWorkingDay('2026-09-18')).toBe(true); // Friday
+            expect(isWorkingDay('2026-09-19')).toBe(false); // Saturday
+            expect(isWorkingDay('2026-09-20')).toBe(false); // Sunday
+            expect(isWorkingDay('2026-09-21')).toBe(true); // Monday
+            expect(getWorkingHoursInDay('2026-09-18')).toBe(8);
+            expect(getWorkingHoursInDay('2026-09-19')).toBe(0);
+            expect(getWorkingHoursInDay('2026-09-20')).toBe(0);
+        });
+        it('accounts for full and half-day holidays', () => {
+            const holidaySchedule = {
+                ...DEFAULT_WORK_SCHEDULE,
+                holidays: [
+                    { date: '2026-09-21', name: 'Labor Day' },
+                    { date: '2026-09-22', name: 'Eve', halfDay: true }
+                ]
+            };
+            expect(isWorkingDay('2026-09-21', holidaySchedule)).toBe(false);
+            expect(getWorkingHoursInDay('2026-09-21', holidaySchedule)).toBe(0);
+            expect(isWorkingDay('2026-09-22', holidaySchedule)).toBe(true);
+            expect(getWorkingHoursInDay('2026-09-22', holidaySchedule)).toBe(4);
+        });
+    });
+    describe('addWorkingHours', () => {
+        it('advances hours within the same working day', () => {
+            // Monday 2026-09-21 at 09:00 + 4 hours -> 13:00
+            const start = '2026-09-21T09:00:00Z';
+            const finish = addWorkingHours(start, 4);
+            expect(finish.toISOString()).toBe('2026-09-21T13:00:00.000Z');
+        });
+        it('rolls over weekends seamlessly', () => {
+            // Friday 2026-09-18 at 15:00 + 4 hours
+            // 15:00-17:00 is 2h on Friday. Sat & Sun skipped.
+            // Remaining 2h starts Monday 2026-09-21 at 09:00 -> finishes 11:00!
+            const start = '2026-09-18T15:00:00Z';
+            const finish = addWorkingHours(start, 4);
+            expect(finish.toISOString()).toBe('2026-09-21T11:00:00.000Z');
+        });
+        it('skips holidays when rolling over', () => {
+            const scheduleWithMondayHoliday = {
+                ...DEFAULT_WORK_SCHEDULE,
+                holidays: [{ date: '2026-09-21', name: 'Bank Holiday' }]
+            };
+            // Friday 2026-09-18 at 15:00 + 4 hours -> 2h Friday, Sat/Sun skipped, Mon skipped -> finishes Tuesday 11:00!
+            const start = '2026-09-18T15:00:00Z';
+            const finish = addWorkingHours(start, 4, scheduleWithMondayHoliday);
+            expect(finish.toISOString()).toBe('2026-09-22T11:00:00.000Z');
+        });
+    });
+    describe('subtractWorkingHours', () => {
+        it('moves backward within the same working day', () => {
+            // Monday 2026-09-21 at 15:00 - 4 hours -> 11:00
+            const end = '2026-09-21T15:00:00Z';
+            const start = subtractWorkingHours(end, 4);
+            expect(start.toISOString()).toBe('2026-09-21T11:00:00.000Z');
+        });
+        it('moves backward across weekends', () => {
+            // Monday 2026-09-21 at 11:00 - 4 hours
+            // 2h backwards to 09:00 on Monday. Sunday & Saturday skipped.
+            // Remaining 2h backwards from Friday 17:00 -> 15:00!
+            const end = '2026-09-21T11:00:00Z';
+            const start = subtractWorkingHours(end, 4);
+            expect(start.toISOString()).toBe('2026-09-18T15:00:00.000Z');
+        });
+    });
+    describe('getWorkingHoursBetween and getWorkingDaysBetween', () => {
+        it('calculates working hours between two dates excluding weekends', () => {
+            // Friday 09:00 to Monday 17:00 = 8h (Friday) + 0h (weekend) + 8h (Monday) = 16h
+            const start = '2026-09-18T09:00:00Z';
+            const end = '2026-09-21T17:00:00Z';
+            expect(getWorkingHoursBetween(start, end)).toBe(16);
+            expect(getWorkingDaysBetween('2026-09-18', '2026-09-21')).toBe(2);
+            expect(getWorkingDaysList('2026-09-18', '2026-09-21')).toEqual(['2026-09-18', '2026-09-21']);
+        });
+        it('calculates net capacity deducting holidays', () => {
+            const scheduleWithHoliday = {
+                ...DEFAULT_WORK_SCHEDULE,
+                holidays: [{ date: '2026-09-21', name: 'Holiday' }]
+            };
+            // Friday 2026-09-18 to Tuesday 2026-09-22:
+            // Friday (8) + Sat (0) + Sun (0) + Mon (0, holiday) + Tue (8) = 16h
+            const cap = getNetAvailableCapacity('2026-09-18', '2026-09-22', scheduleWithHoliday);
+            expect(cap).toBe(16);
+        });
+    });
+});
+//# sourceMappingURL=calendar.test.js.map