@critical-path/core 0.16.0 → 0.18.0

package/dist/domain/metrics.test.js

@@ -0,0 +1,251 @@
+import { describe, it, expect } from 'vitest';
+import { inferTaskProgress, calculateTaskEVM, reconstructTaskProgressHistory, calculateTaskMetrics } from './metrics.js';
+import { TaskEntity } from './entities.js';
+import { CriticalPathEngine } from '../engine/index.js';
+import { InMemoryStore } from '../store/index.js';
+describe('Task Metrics Domain', () => {
+    const baseTask = {
+        id: 'task-1',
+        projectId: 'proj-1',
+        title: 'Design API Architecture',
+        status: 'in_progress',
+        semanticStatus: 'in_progress',
+        priority: 'high',
+        estimatedHours: 20,
+        loggedHours: 10,
+        actualStartDate: '2026-09-01T09:00:00Z',
+        dueDate: '2026-09-10T17:00:00Z',
+        createdAt: '2026-09-01T08:00:00Z',
+        updatedAt: '2026-09-05T12:00:00Z'
+    };
+    describe('inferTaskProgress', () => {
+        it('returns 100% progress for completed tasks', () => {
+            const completedTask = { ...baseTask, status: 'done', semanticStatus: 'completed' };
+            const res = inferTaskProgress(completedTask);
+            expect(res.progressPercentage).toBe(100);
+            expect(res.breakdown.effortProgress).toBe(100);
+            expect(res.breakdown.scheduleProgress).toBe(100);
+        });
+        it('uses explicit progress when provided', () => {
+            const taskWithExplicit = {
+                ...baseTask,
+                progress: 45,
+                todos: [
+                    { id: 't1', title: 'Step 1', completed: true },
+                    { id: 't2', title: 'Step 2', completed: false }
+                ]
+            };
+            const res = inferTaskProgress(taskWithExplicit);
+            expect(res.isExplicit).toBe(true);
+            expect(res.source).toBe('explicit');
+            expect(res.progressPercentage).toBe(45);
+            expect(res.breakdown.explicitProgress).toBe(45);
+            expect(res.breakdown.todoProgress).toBe(50);
+        });
+        it('infers progress from todos when explicit progress is absent', () => {
+            const taskWithTodos = {
+                ...baseTask,
+                progress: undefined,
+                todos: [
+                    { id: 't1', title: 'Step 1', completed: true },
+                    { id: 't2', title: 'Step 2', completed: true },
+                    { id: 't3', title: 'Step 3', completed: false },
+                    { id: 't4', title: 'Step 4', completed: false }
+                ]
+            };
+            const res = inferTaskProgress(taskWithTodos);
+            expect(res.isExplicit).toBe(false);
+            expect(res.source).toBe('todos');
+            expect(res.progressPercentage).toBe(50);
+            expect(res.breakdown.todoProgress).toBe(50);
+        });
+        it('infers progress from effort (logged vs estimated) when todos and explicit are absent', () => {
+            const taskWithEffort = {
+                ...baseTask,
+                progress: undefined,
+                todos: undefined,
+                estimatedHours: 40,
+                loggedHours: 10
+            };
+            const res = inferTaskProgress(taskWithEffort);
+            expect(res.isExplicit).toBe(false);
+            expect(res.source).toBe('time_effort');
+            expect(res.progressPercentage).toBe(25);
+            expect(res.breakdown.effortProgress).toBe(25);
+        });
+        it('infers progress from schedule elapsed time when no other metrics are present', () => {
+            const taskWithSchedule = {
+                ...baseTask,
+                progress: undefined,
+                todos: undefined,
+                estimatedHours: 0,
+                loggedHours: 0,
+                actualStartDate: '2026-09-01T00:00:00Z',
+                dueDate: '2026-09-11T00:00:00Z'
+            };
+            const midDate = new Date('2026-09-06T00:00:00Z'); // 50% elapsed
+            const res = inferTaskProgress(taskWithSchedule, { referenceDate: midDate });
+            expect(res.source).toBe('schedule_elapsed');
+            expect(res.progressPercentage).toBe(50);
+            expect(res.breakdown.scheduleProgress).toBe(50);
+        });
+    });
+    describe('calculateTaskEVM', () => {
+        it('computes standard EVM values for on-track tasks', () => {
+            const task = {
+                ...baseTask,
+                estimatedHours: 20,
+                loggedHours: 10,
+                actualStartDate: '2026-09-01T00:00:00Z',
+                dueDate: '2026-09-11T00:00:00Z',
+                progress: 50
+            };
+            const midDate = new Date('2026-09-06T00:00:00Z'); // 50% expected
+            const evm = calculateTaskEVM(task, { referenceDate: midDate });
+            expect(evm.plannedValue).toBe(10); // 50% of 20h
+            expect(evm.earnedValue).toBe(10); // 50% of 20h
+            expect(evm.actualCost).toBe(10);
+            expect(evm.costVariance).toBe(0);
+            expect(evm.scheduleVariance).toBe(0);
+            expect(evm.costPerformanceIndex).toBe(1.0);
+            expect(evm.schedulePerformanceIndex).toBe(1.0);
+        });
+        it('detects cost overrun and schedule lag (CPI < 1, SPI < 1)', () => {
+            const task = {
+                ...baseTask,
+                estimatedHours: 20,
+                loggedHours: 15, // Spent 15h
+                progress: 25, // Only 25% complete (5h EV)
+                actualStartDate: '2026-09-01T00:00:00Z',
+                dueDate: '2026-09-11T00:00:00Z'
+            };
+            const midDate = new Date('2026-09-06T00:00:00Z'); // 50% expected (10h PV)
+            const evm = calculateTaskEVM(task, { referenceDate: midDate });
+            expect(evm.plannedValue).toBe(10);
+            expect(evm.earnedValue).toBe(5);
+            expect(evm.actualCost).toBe(15);
+            expect(evm.costVariance).toBe(-10); // 5 - 15 = -10
+            expect(evm.scheduleVariance).toBe(-5); // 5 - 10 = -5
+            expect(evm.costPerformanceIndex).toBe(0.33); // 5 / 15
+            expect(evm.schedulePerformanceIndex).toBe(0.5); // 5 / 10
+        });
+    });
+    describe('reconstructTaskProgressHistory & Curve Profile', () => {
+        it('detects linear progress', () => {
+            const activities = [
+                { id: 'a1', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 25 }, createdAt: '2026-09-02T10:00:00Z' },
+                { id: 'a2', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 50 }, createdAt: '2026-09-04T10:00:00Z' },
+                { id: 'a3', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 75 }, createdAt: '2026-09-06T10:00:00Z' },
+                { id: 'a4', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 100 }, createdAt: '2026-09-08T10:00:00Z' }
+            ];
+            const task = { ...baseTask, progress: 100, updatedAt: '2026-09-08T10:00:00Z' };
+            const history = reconstructTaskProgressHistory(task, activities);
+            expect(history.points.length).toBeGreaterThanOrEqual(4);
+            expect(history.curveProfile).toBe('linear');
+        });
+        it('detects S-Curve progress', () => {
+            const activities = [
+                { id: 'a1', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 15 }, createdAt: '2026-09-02T10:00:00Z' },
+                { id: 'a2', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 45 }, createdAt: '2026-09-05T10:00:00Z' },
+                { id: 'a3', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 85 }, createdAt: '2026-09-07T10:00:00Z' },
+                { id: 'a4', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 95 }, createdAt: '2026-09-09T10:00:00Z' }
+            ];
+            const task = { ...baseTask, progress: 95, updatedAt: '2026-09-09T10:00:00Z' };
+            const history = reconstructTaskProgressHistory(task, activities);
+            expect(history.curveProfile).toBe('s_curve');
+        });
+        it('detects early surge progress', () => {
+            const activities = [
+                { id: 'a1', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 75 }, createdAt: '2026-09-02T10:00:00Z' },
+                { id: 'a2', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 75 }, createdAt: '2026-09-05T10:00:00Z' },
+                { id: 'a3', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 78 }, createdAt: '2026-09-08T10:00:00Z' }
+            ];
+            const task = { ...baseTask, progress: 78, updatedAt: '2026-09-08T10:00:00Z' };
+            const history = reconstructTaskProgressHistory(task, activities);
+            expect(history.curveProfile).toBe('early_surge');
+        });
+        it('detects late rush progress', () => {
+            const activities = [
+                { id: 'a1', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 10 }, createdAt: '2026-09-03T10:00:00Z' },
+                { id: 'a2', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 15 }, createdAt: '2026-09-06T10:00:00Z' },
+                { id: 'a3', taskId: 'task-1', actorId: 'u1', action: 'task.updated', details: { progress: 90 }, createdAt: '2026-09-08T10:00:00Z' }
+            ];
+            const task = { ...baseTask, progress: 90, updatedAt: '2026-09-08T10:00:00Z' };
+            const history = reconstructTaskProgressHistory(task, activities);
+            expect(history.curveProfile).toBe('late_rush');
+        });
+    });
+    describe('calculateTaskMetrics & Multi-dimensional Variance', () => {
+        it('computes complete metrics with effort and schedule variances', () => {
+            const task = {
+                ...baseTask,
+                plannedStartDate: '2026-09-01T09:00:00Z',
+                actualStartDate: '2026-09-01T09:00:00Z',
+                dueDate: '2026-09-05T17:00:00Z',
+                actualEndDate: '2026-09-07T17:00:00Z',
+                status: 'done',
+                semanticStatus: 'completed',
+                estimatedHours: 20,
+                loggedHours: 25
+            };
+            const metrics = calculateTaskMetrics(task);
+            expect(metrics.taskId).toBe('task-1');
+            expect(metrics.realityDelta.varianceHours).toBe(5);
+            expect(metrics.realityDelta.effortVarianceHours).toBe(5);
+            expect(metrics.realityDelta.accuracyRatio).toBe(1.25); // 25 / 20
+            expect(metrics.realityDelta.scheduleVarianceDays).toBe(2); // Completed 2 days late
+            expect(metrics.realityDelta.durationVarianceHours).toBe(48); // 2 days extra duration
+            expect(metrics.inferredActuals.activeWorkingHours).toBeGreaterThan(0);
+            expect(metrics.inferredActuals.isEndDateInferred).toBe(true);
+        });
+    });
+    describe('Task Re-opening Timestamp Behavior', () => {
+        it('resets actualEndDate when TaskEntity transitions from completed back to in_progress', () => {
+            const entity = TaskEntity.create({
+                projectId: 'proj-1',
+                title: 'Bugfix',
+                status: 'todo'
+            });
+            // Move to in_progress -> stamps actualStartDate
+            entity.transitionTo('in_progress');
+            expect(entity.actualStartDate).toBeDefined();
+            expect(entity.actualEndDate).toBeUndefined();
+            // Move to done -> stamps actualEndDate
+            entity.transitionTo('done');
+            expect(entity.actualEndDate).toBeDefined();
+            // Re-open back to in_progress -> actualEndDate must be cleared
+            entity.transitionTo('in_progress');
+            expect(entity.actualEndDate).toBeUndefined();
+            expect(entity.actualStartDate).toBeDefined();
+        });
+        it('integrates with CriticalPathEngine getTaskMetrics and getTaskProgressHistory', async () => {
+            const store = new InMemoryStore();
+            const engine = new CriticalPathEngine({ store });
+            const project = await engine.createProject({ name: 'Engine Test' });
+            const task = await engine.createTask({
+                projectId: project.id,
+                title: 'Implement Auth',
+                estimatedHours: 16
+            });
+            // Move to in_progress
+            await engine.updateTask(task.id, { status: 'in_progress' });
+            await engine.logTime({ taskId: task.id, hours: 8, isBillable: true });
+            const metrics = await engine.getTaskMetrics(task.id);
+            expect(metrics).not.toBeNull();
+            expect(metrics?.taskId).toBe(task.id);
+            expect(metrics?.realityDelta.loggedHours).toBe(8);
+            expect(metrics?.realityDelta.estimatedHours).toBe(16);
+            expect(metrics?.progress.source).toBe('time_effort');
+            expect(metrics?.progress.progressPercentage).toBe(50);
+            expect(metrics?.evm.earnedValue).toBe(8);
+            const history = await engine.getTaskProgressHistory(task.id);
+            expect(history).not.toBeNull();
+            expect(history?.points.length).toBeGreaterThanOrEqual(1);
+            // Verify ladder view includes metrics
+            const ladder = await engine.getTaskLadder(task.id);
+            expect(ladder?.metrics).toBeDefined();
+            expect(ladder?.metrics?.taskId).toBe(task.id);
+        });
+    });
+});
+//# sourceMappingURL=metrics.test.js.map

package/dist/domain/metrics.test.js.map

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

package/dist/domain/workload.d.ts

@@ -0,0 +1,10 @@
+import type { Task, TimeEntry, User, Team, WorkloadDistribution, WorkloadDistributionOptions } from '../types/index.js';
+export interface WorkloadContext {
+    tasks: Task[];
+    timeEntries?: TimeEntry[];
+    users?: User[];
+    teams?: Team[];
+    projectId?: string;
+}
+export declare function calculateWorkloadDistribution(context: WorkloadContext, options?: WorkloadDistributionOptions): WorkloadDistribution;
+//# sourceMappingURL=workload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workload.d.ts","sourceRoot":"","sources":["../../src/domain/workload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,IAAI,EAKJ,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA+DD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CA6TtB"}

package/dist/domain/workload.js

@@ -0,0 +1,349 @@
+function toDateString(d) {
+    return d.toISOString().split('T')[0];
+}
+function parseDateOnly(isoString) {
+    const parts = isoString.split('T')[0].split('-');
+    return new Date(Date.UTC(parseInt(parts[0], 10), parseInt(parts[1], 10) - 1, parseInt(parts[2], 10)));
+}
+function addDays(d, days) {
+    const res = new Date(d.getTime());
+    res.setUTCDate(res.getUTCDate() + days);
+    return res;
+}
+function startOfWeek(d) {
+    const date = new Date(d.getTime());
+    const day = date.getUTCDay();
+    // Monday is day 1, Sunday is day 0 -> shift Sunday to 7
+    const diff = date.getUTCDate() - day + (day === 0 ? -6 : 1);
+    return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), diff));
+}
+function startOfMonth(d) {
+    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1));
+}
+function nextBucketDate(d, interval) {
+    if (interval === 'day') {
+        return addDays(d, 1);
+    }
+    if (interval === 'week') {
+        return addDays(d, 7);
+    }
+    // month: next month 1st
+    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + 1, 1));
+}
+function getBucketKey(d, interval) {
+    if (interval === 'day') {
+        return toDateString(d);
+    }
+    if (interval === 'week') {
+        return toDateString(startOfWeek(d));
+    }
+    return toDateString(startOfMonth(d));
+}
+function getTaskDurationHours(task) {
+    if (typeof task.estimatedHours === 'number' && task.estimatedHours >= 0) {
+        return task.estimatedHours;
+    }
+    if (typeof task.estimatedDurationMinutes === 'number' && task.estimatedDurationMinutes >= 0) {
+        return task.estimatedDurationMinutes / 60;
+    }
+    if (typeof task.actualHours === 'number' && task.actualHours > 0) {
+        return task.actualHours;
+    }
+    return 1;
+}
+export function calculateWorkloadDistribution(context, options = {}) {
+    const { tasks, timeEntries = [], users = [], teams = [], projectId } = context;
+    const interval = options.interval || 'week';
+    const groupBy = options.groupBy || 'assignee';
+    const metric = options.metric || 'blended';
+    const defaultWeeklyCapacity = options.defaultWeeklyCapacityHours ?? 40;
+    // Build lookups for human-readable labels
+    const userMap = new Map(users.map((u) => [u.id, u]));
+    const teamMap = new Map(teams.map((t) => [t.id, t]));
+    // 1. Determine date range
+    let minDate = options.startDate ? parseDateOnly(options.startDate) : null;
+    let maxDate = options.endDate ? parseDateOnly(options.endDate) : null;
+    if (!minDate || !maxDate) {
+        const dates = [];
+        for (const t of tasks) {
+            if (t.plannedStartDate)
+                dates.push(parseDateOnly(t.plannedStartDate).getTime());
+            if (t.actualStartDate)
+                dates.push(parseDateOnly(t.actualStartDate).getTime());
+            if (t.dueDate)
+                dates.push(parseDateOnly(t.dueDate).getTime());
+            if (t.actualEndDate)
+                dates.push(parseDateOnly(t.actualEndDate).getTime());
+            if (t.createdAt)
+                dates.push(parseDateOnly(t.createdAt).getTime());
+        }
+        for (const te of timeEntries) {
+            if (te.loggedAt)
+                dates.push(parseDateOnly(te.loggedAt).getTime());
+        }
+        if (dates.length > 0) {
+            if (!minDate)
+                minDate = new Date(Math.min(...dates));
+            if (!maxDate)
+                maxDate = new Date(Math.max(...dates));
+        }
+        else {
+            const now = new Date();
+            if (!minDate)
+                minDate = addDays(now, -7);
+            if (!maxDate)
+                maxDate = addDays(now, 28);
+        }
+    }
+    // Ensure minDate <= maxDate
+    if (minDate > maxDate) {
+        maxDate = new Date(minDate.getTime());
+    }
+    // Align start to bucket boundary
+    let cursor = interval === 'week' ? startOfWeek(minDate) : interval === 'month' ? startOfMonth(minDate) : minDate;
+    const endLimit = interval === 'week' ? startOfWeek(maxDate) : interval === 'month' ? startOfMonth(maxDate) : maxDate;
+    const bucketList = [];
+    const bucketMap = new Map();
+    while (cursor <= endLimit || bucketList.length === 0) {
+        const dateStr = toDateString(cursor);
+        const nextDate = nextBucketDate(cursor, interval);
+        const b = {
+            date: dateStr,
+            startDate: new Date(cursor.getTime()),
+            endDate: nextDate,
+            timestamp: cursor.getTime(),
+            values: {}
+        };
+        bucketList.push(b);
+        bucketMap.set(dateStr, b);
+        cursor = nextDate;
+    }
+    const seriesKeySet = new Set();
+    const getDimensionKey = (task, timeEntry) => {
+        switch (groupBy) {
+            case 'assignee':
+                if (timeEntry?.userId)
+                    return timeEntry.userId;
+                return task.assigneeId || 'unassigned';
+            case 'team':
+                return task.teamId || task.customFields?.teamId || 'unassigned';
+            case 'taskType':
+                return task.taskType || task.customFields?.type || 'standard';
+            case 'priority':
+                return task.priority || 'none';
+            case 'status':
+                return task.status || 'todo';
+            default:
+                return 'unassigned';
+        }
+    };
+    const addValue = (bucket, key, hours) => {
+        if (hours <= 0)
+            return;
+        seriesKeySet.add(key);
+        bucket.values[key] = (bucket.values[key] || 0) + hours;
+    };
+    const todayStr = toDateString(new Date());
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    // 2. Process Logged Hours from TimeEntries
+    if (metric === 'logged' || metric === 'blended') {
+        for (const entry of timeEntries) {
+            if (!entry.hours || entry.hours <= 0)
+                continue;
+            const entryDate = parseDateOnly(entry.loggedAt);
+            const bKey = getBucketKey(entryDate, interval);
+            const bucket = bucketMap.get(bKey);
+            if (bucket) {
+                const associatedTask = taskMap.get(entry.taskId) || {
+                    id: entry.taskId,
+                    projectId: projectId || '',
+                    title: '',
+                    status: 'in_progress',
+                    priority: 'medium',
+                    createdAt: entry.loggedAt,
+                    updatedAt: entry.loggedAt
+                };
+                const dimKey = getDimensionKey(associatedTask, entry);
+                addValue(bucket, dimKey, entry.hours);
+            }
+        }
+    }
+    // 3. Process Scheduled / Remaining / Blended Hours from Tasks
+    if (metric === 'scheduled' || metric === 'remaining' || metric === 'blended') {
+        for (const task of tasks) {
+            const estimated = getTaskDurationHours(task);
+            const logged = task.loggedHours || 0;
+            let hoursToDistribute = 0;
+            if (metric === 'scheduled') {
+                hoursToDistribute = estimated;
+            }
+            else if (metric === 'remaining' || metric === 'blended') {
+                if (task.semanticStatus === 'completed' || task.semanticStatus === 'canceled') {
+                    hoursToDistribute = 0;
+                }
+                else {
+                    hoursToDistribute = Math.max(0, estimated - logged);
+                }
+            }
+            if (hoursToDistribute <= 0)
+                continue;
+            const dimKey = getDimensionKey(task);
+            // Determine task date range
+            let taskStart = task.plannedStartDate
+                ? parseDateOnly(task.plannedStartDate)
+                : task.actualStartDate
+                    ? parseDateOnly(task.actualStartDate)
+                    : task.createdAt
+                        ? parseDateOnly(task.createdAt)
+                        : minDate;
+            let taskEnd = task.dueDate
+                ? parseDateOnly(task.dueDate)
+                : taskStart
+                    ? addDays(taskStart, Math.max(1, Math.ceil(hoursToDistribute / 8)))
+                    : maxDate;
+            // In blended mode, uncompleted tasks' remaining hours start from today or planned start (whichever is later)
+            if (metric === 'blended') {
+                const today = parseDateOnly(todayStr);
+                if (taskStart < today) {
+                    taskStart = today;
+                }
+                if (taskEnd < taskStart) {
+                    taskEnd = addDays(taskStart, 1);
+                }
+            }
+            if (taskEnd < taskStart) {
+                taskEnd = taskStart;
+            }
+            // Calculate days in task window
+            const msPerDay = 1000 * 60 * 60 * 24;
+            const totalDays = Math.max(1, Math.round((taskEnd.getTime() - taskStart.getTime()) / msPerDay) + 1);
+            const hoursPerDay = hoursToDistribute / totalDays;
+            // Distribute across overlapping buckets
+            for (const bucket of bucketList) {
+                const bucketLastDay = addDays(bucket.endDate, -1);
+                const overlapStart = new Date(Math.max(taskStart.getTime(), bucket.startDate.getTime()));
+                const overlapEnd = new Date(Math.min(taskEnd.getTime(), bucketLastDay.getTime()));
+                if (overlapStart <= overlapEnd) {
+                    const overlapDays = Math.round((overlapEnd.getTime() - overlapStart.getTime()) / msPerDay) + 1;
+                    const bucketEffort = overlapDays * hoursPerDay;
+                    addValue(bucket, dimKey, bucketEffort);
+                }
+            }
+        }
+    }
+    // Ensure all registered users are in series keys if grouping by assignee
+    if (groupBy === 'assignee' && users.length > 0) {
+        for (const u of users) {
+            seriesKeySet.add(u.id);
+        }
+    }
+    if (groupBy === 'team' && teams.length > 0) {
+        for (const t of teams) {
+            seriesKeySet.add(t.id);
+        }
+    }
+    const seriesKeys = Array.from(seriesKeySet).sort();
+    // Create human-readable series labels
+    const seriesLabels = {};
+    for (const key of seriesKeys) {
+        if (groupBy === 'assignee') {
+            const u = userMap.get(key);
+            seriesLabels[key] = u ? u.name : key === 'unassigned' ? 'Unassigned' : key;
+        }
+        else if (groupBy === 'team') {
+            const t = teamMap.get(key);
+            seriesLabels[key] = t ? t.name : key === 'unassigned' ? 'Unassigned' : key;
+        }
+        else {
+            seriesLabels[key] = key.charAt(0).toUpperCase() + key.slice(1).replace(/_/g, ' ');
+        }
+    }
+    // 4. Calculate Capacity & Normalize Buckets
+    let totalDistributedHours = 0;
+    let sumCapacityAcrossBuckets = 0;
+    const buckets = bucketList.map((ib) => {
+        const values = {};
+        const capacity = {};
+        let bucketTotalHours = 0;
+        let bucketTotalCapacity = 0;
+        for (const key of seriesKeys) {
+            const rawHours = ib.values[key] || 0;
+            const roundedHours = Math.round(rawHours * 100) / 100;
+            values[key] = roundedHours;
+            bucketTotalHours += roundedHours;
+            // Capacity calculation
+            let weeklyCap = defaultWeeklyCapacity;
+            if (options.capacityOverrides && typeof options.capacityOverrides[key] === 'number') {
+                weeklyCap = options.capacityOverrides[key];
+            }
+            else if (groupBy === 'assignee') {
+                const u = userMap.get(key);
+                if (u?.weeklyCapacityHours)
+                    weeklyCap = u.weeklyCapacityHours;
+                else if (key === 'unassigned')
+                    weeklyCap = 0;
+            }
+            else if (groupBy === 'team') {
+                const t = teamMap.get(key);
+                if (t?.weeklyCapacityHours) {
+                    weeklyCap = t.weeklyCapacityHours;
+                }
+                else if (t?.memberIds?.length) {
+                    weeklyCap = t.memberIds.length * defaultWeeklyCapacity;
+                }
+                else if (key === 'unassigned') {
+                    weeklyCap = 0;
+                }
+            }
+            let bucketCap = 0;
+            if (interval === 'week') {
+                bucketCap = weeklyCap;
+            }
+            else if (interval === 'day') {
+                bucketCap = Math.round((weeklyCap / 5) * 100) / 100;
+            }
+            else if (interval === 'month') {
+                const daysInMonth = new Date(Date.UTC(ib.startDate.getUTCFullYear(), ib.startDate.getUTCMonth() + 1, 0)).getUTCDate();
+                bucketCap = Math.round((weeklyCap * (daysInMonth / 7)) * 100) / 100;
+            }
+            capacity[key] = bucketCap;
+            bucketTotalCapacity += bucketCap;
+        }
+        bucketTotalHours = Math.round(bucketTotalHours * 100) / 100;
+        bucketTotalCapacity = Math.round(bucketTotalCapacity * 100) / 100;
+        totalDistributedHours += bucketTotalHours;
+        sumCapacityAcrossBuckets += bucketTotalCapacity;
+        const utilizationRatio = bucketTotalCapacity > 0
+            ? Math.round((bucketTotalHours / bucketTotalCapacity) * 1000) / 1000
+            : undefined;
+        return {
+            date: ib.date,
+            timestamp: ib.timestamp,
+            totalHours: bucketTotalHours,
+            values,
+            capacity,
+            totalCapacity: bucketTotalCapacity,
+            utilizationRatio
+        };
+    });
+    totalDistributedHours = Math.round(totalDistributedHours * 100) / 100;
+    sumCapacityAcrossBuckets = Math.round(sumCapacityAcrossBuckets * 100) / 100;
+    const averageUtilization = sumCapacityAcrossBuckets > 0
+        ? Math.round((totalDistributedHours / sumCapacityAcrossBuckets) * 1000) / 1000
+        : undefined;
+    return {
+        projectId,
+        startDate: toDateString(minDate),
+        endDate: toDateString(maxDate),
+        interval,
+        groupBy,
+        metric,
+        seriesKeys,
+        seriesLabels,
+        buckets,
+        totalHours: totalDistributedHours,
+        totalCapacity: sumCapacityAcrossBuckets,
+        averageUtilization
+    };
+}
+//# sourceMappingURL=workload.js.map