@critical-path/core 0.15.1 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +4 -0
  3. package/dist/domain/cpm.d.ts +10 -0
  4. package/dist/domain/cpm.d.ts.map +1 -0
  5. package/dist/domain/cpm.js +176 -0
  6. package/dist/domain/cpm.js.map +1 -0
  7. package/dist/domain/cpm.test.d.ts +2 -0
  8. package/dist/domain/cpm.test.d.ts.map +1 -0
  9. package/dist/domain/cpm.test.js +113 -0
  10. package/dist/domain/cpm.test.js.map +1 -0
  11. package/dist/domain/index.d.ts +2 -0
  12. package/dist/domain/index.d.ts.map +1 -1
  13. package/dist/domain/index.js +2 -0
  14. package/dist/domain/index.js.map +1 -1
  15. package/dist/domain/ladder.d.ts +16 -0
  16. package/dist/domain/ladder.d.ts.map +1 -0
  17. package/dist/domain/ladder.js +338 -0
  18. package/dist/domain/ladder.js.map +1 -0
  19. package/dist/domain/ladder.test.d.ts +2 -0
  20. package/dist/domain/ladder.test.d.ts.map +1 -0
  21. package/dist/domain/ladder.test.js +213 -0
  22. package/dist/domain/ladder.test.js.map +1 -0
  23. package/dist/engine/index.d.ts +5 -1
  24. package/dist/engine/index.d.ts.map +1 -1
  25. package/dist/engine/index.js +84 -1
  26. package/dist/engine/index.js.map +1 -1
  27. package/dist/store/firebase.d.ts +3 -1
  28. package/dist/store/firebase.d.ts.map +1 -1
  29. package/dist/store/firebase.js +1 -1
  30. package/dist/store/firebase.js.map +1 -1
  31. package/dist/store/index.d.ts +6 -2
  32. package/dist/store/index.d.ts.map +1 -1
  33. package/dist/store/index.js +1 -1
  34. package/dist/store/index.js.map +1 -1
  35. package/dist/store/sqlite.d.ts +3 -1
  36. package/dist/store/sqlite.d.ts.map +1 -1
  37. package/dist/store/sqlite.js +1 -1
  38. package/dist/store/sqlite.js.map +1 -1
  39. package/dist/task-state.test.d.ts +2 -0
  40. package/dist/task-state.test.d.ts.map +1 -0
  41. package/dist/task-state.test.js +374 -0
  42. package/dist/task-state.test.js.map +1 -0
  43. package/dist/types/index.d.ts +123 -0
  44. package/dist/types/index.d.ts.map +1 -1
  45. package/package.json +1 -1
  46. package/src/domain/cpm.test.ts +128 -0
  47. package/src/domain/cpm.ts +215 -0
  48. package/src/domain/index.ts +3 -0
  49. package/src/domain/ladder.test.ts +251 -0
  50. package/src/domain/ladder.ts +437 -0
  51. package/src/engine/index.ts +110 -4
  52. package/src/store/firebase.ts +2 -2
  53. package/src/store/index.ts +3 -3
  54. package/src/store/sqlite.ts +2 -2
  55. package/src/task-state.test.ts +447 -0
  56. package/src/types/index.ts +138 -0
  57. package/tsconfig.tsbuildinfo +1 -1
@@ -0,0 +1,447 @@
1
+ import { describe, it, expect, vi } from 'vitest';
2
+ import { CriticalPathEngine } from './engine/index.js';
3
+ import { deriveTaskLifecycleState } from './utils/status.js';
4
+ import type { Task, StatusDefinition, TaskUnblockedEvent } from './index.js';
5
+
6
+ describe('Task State Behaviour & Dependency Validation', () => {
7
+ const baseTask: Task = {
8
+ id: 'task_target',
9
+ projectId: 'proj_1',
10
+ title: 'Implement Authentication UI',
11
+ status: 'todo',
12
+ priority: 'high',
13
+ createdAt: '2026-09-01T00:00:00.000Z',
14
+ updatedAt: '2026-09-01T00:00:00.000Z'
15
+ };
16
+
17
+ describe('deriveTaskLifecycleState (Pure Function)', () => {
18
+ it('marks a task as blocked when an upstream dependency is not complete', () => {
19
+ const upstreamIncomplete: Task = {
20
+ id: 'task_upstream',
21
+ projectId: 'proj_1',
22
+ title: 'Backend Auth API',
23
+ status: 'in_progress',
24
+ priority: 'high',
25
+ createdAt: '2026-09-01T00:00:00.000Z',
26
+ updatedAt: '2026-09-01T00:00:00.000Z'
27
+ };
28
+
29
+ const state = deriveTaskLifecycleState(baseTask, {
30
+ upstreamTasks: [upstreamIncomplete]
31
+ });
32
+
33
+ expect(state.isBlocked).toBe(true);
34
+ expect(state.isReady).toBe(false);
35
+ expect(state.blockingTaskIds).toEqual(['task_upstream']);
36
+ });
37
+
38
+ it('marks a task as unblocked and ready when an upstream dependency is complete (vice versa)', () => {
39
+ const upstreamComplete: Task = {
40
+ id: 'task_upstream',
41
+ projectId: 'proj_1',
42
+ title: 'Backend Auth API',
43
+ status: 'done',
44
+ priority: 'high',
45
+ createdAt: '2026-09-01T00:00:00.000Z',
46
+ updatedAt: '2026-09-02T00:00:00.000Z'
47
+ };
48
+
49
+ const state = deriveTaskLifecycleState(baseTask, {
50
+ upstreamTasks: [upstreamComplete]
51
+ });
52
+
53
+ expect(state.isBlocked).toBe(false);
54
+ expect(state.isReady).toBe(true);
55
+ expect(state.blockingTaskIds).toHaveLength(0);
56
+ });
57
+
58
+ it('marks a task as blocked again if upstream dependency transitions from complete back to incomplete', () => {
59
+ const upstreamTask: Task = {
60
+ id: 'task_upstream',
61
+ projectId: 'proj_1',
62
+ title: 'Backend Auth API',
63
+ status: 'done',
64
+ priority: 'high',
65
+ createdAt: '2026-09-01T00:00:00.000Z',
66
+ updatedAt: '2026-09-02T00:00:00.000Z'
67
+ };
68
+
69
+ // Initially complete: target is ready
70
+ const initial = deriveTaskLifecycleState(baseTask, {
71
+ upstreamTasks: [upstreamTask]
72
+ });
73
+ expect(initial.isBlocked).toBe(false);
74
+ expect(initial.isReady).toBe(true);
75
+
76
+ // Upstream reopened to in_progress
77
+ const reopenedUpstream: Task = {
78
+ ...upstreamTask,
79
+ status: 'in_progress',
80
+ updatedAt: '2026-09-03T00:00:00.000Z'
81
+ };
82
+
83
+ const afterReopen = deriveTaskLifecycleState(baseTask, {
84
+ upstreamTasks: [reopenedUpstream]
85
+ });
86
+ expect(afterReopen.isBlocked).toBe(true);
87
+ expect(afterReopen.isReady).toBe(false);
88
+ expect(afterReopen.blockingTaskIds).toEqual(['task_upstream']);
89
+ });
90
+
91
+ it('handles multiple upstream dependencies (fan-in): blocked until ALL are complete', () => {
92
+ const upstreamA: Task = {
93
+ id: 'up_a',
94
+ projectId: 'proj_1',
95
+ title: 'API Endpoints',
96
+ status: 'done',
97
+ priority: 'high',
98
+ createdAt: '2026-09-01T00:00:00.000Z',
99
+ updatedAt: '2026-09-01T00:00:00.000Z'
100
+ };
101
+ const upstreamB: Task = {
102
+ id: 'up_b',
103
+ projectId: 'proj_1',
104
+ title: 'Database Schema Migration',
105
+ status: 'todo',
106
+ priority: 'urgent',
107
+ createdAt: '2026-09-01T00:00:00.000Z',
108
+ updatedAt: '2026-09-01T00:00:00.000Z'
109
+ };
110
+
111
+ // 1. One done, one todo -> still blocked
112
+ const partialState = deriveTaskLifecycleState(baseTask, {
113
+ upstreamTasks: [upstreamA, upstreamB]
114
+ });
115
+ expect(partialState.isBlocked).toBe(true);
116
+ expect(partialState.isReady).toBe(false);
117
+ expect(partialState.blockingTaskIds).toEqual(['up_b']);
118
+
119
+ // 2. Both done -> now unblocked and ready
120
+ const allCompleteState = deriveTaskLifecycleState(baseTask, {
121
+ upstreamTasks: [upstreamA, { ...upstreamB, status: 'done' }]
122
+ });
123
+ expect(allCompleteState.isBlocked).toBe(false);
124
+ expect(allCompleteState.isReady).toBe(true);
125
+ expect(allCompleteState.blockingTaskIds).toHaveLength(0);
126
+ });
127
+
128
+ it('does not mark a completed or canceled task as blocked even if upstream is incomplete', () => {
129
+ const upstreamIncomplete: Task = {
130
+ id: 'task_upstream',
131
+ projectId: 'proj_1',
132
+ title: 'Database Setup',
133
+ status: 'todo',
134
+ priority: 'high',
135
+ createdAt: '2026-09-01T00:00:00.000Z',
136
+ updatedAt: '2026-09-01T00:00:00.000Z'
137
+ };
138
+
139
+ // Target task is already done
140
+ const completedTask: Task = {
141
+ ...baseTask,
142
+ status: 'done'
143
+ };
144
+ const doneState = deriveTaskLifecycleState(completedTask, {
145
+ upstreamTasks: [upstreamIncomplete]
146
+ });
147
+ expect(doneState.isDone).toBe(true);
148
+ expect(doneState.isBlocked).toBe(false);
149
+
150
+ // Target task was canceled
151
+ const canceledTask: Task = {
152
+ ...baseTask,
153
+ status: 'canceled'
154
+ };
155
+ const canceledState = deriveTaskLifecycleState(canceledTask, {
156
+ upstreamTasks: [upstreamIncomplete]
157
+ });
158
+ expect(canceledState.isCancelled).toBe(true);
159
+ expect(canceledState.isBlocked).toBe(false);
160
+ });
161
+
162
+ it('correctly uses custom status definitions to determine blocking completion', () => {
163
+ const customDefinitions: StatusDefinition[] = [
164
+ { key: 'backlog', label: 'Backlog', category: 'not_started' },
165
+ { key: 'qa_review', label: 'QA Review', category: 'in_progress' },
166
+ { key: 'shipped_prod', label: 'Shipped to Production', category: 'completed' },
167
+ { key: 'abandoned', label: 'Abandoned', category: 'canceled' }
168
+ ];
169
+
170
+ const upstreamInQa: Task = {
171
+ id: 'up_qa',
172
+ projectId: 'proj_1',
173
+ title: 'Core Engine Feature',
174
+ status: 'qa_review',
175
+ priority: 'high',
176
+ createdAt: '2026-09-01T00:00:00.000Z',
177
+ updatedAt: '2026-09-01T00:00:00.000Z'
178
+ };
179
+
180
+ // qa_review is categorized as in_progress -> blocks target
181
+ const blockedState = deriveTaskLifecycleState(baseTask, {
182
+ customDefinitions,
183
+ upstreamTasks: [upstreamInQa]
184
+ });
185
+ expect(blockedState.isBlocked).toBe(true);
186
+ expect(blockedState.blockingTaskIds).toEqual(['up_qa']);
187
+
188
+ // shipped_prod is categorized as completed -> unblocks target
189
+ const unblockedState = deriveTaskLifecycleState(baseTask, {
190
+ customDefinitions,
191
+ upstreamTasks: [{ ...upstreamInQa, status: 'shipped_prod' }]
192
+ });
193
+ expect(unblockedState.isBlocked).toBe(false);
194
+ expect(unblockedState.isReady).toBe(true);
195
+ });
196
+ });
197
+
198
+ describe('CriticalPathEngine Lifecycle & Dependency Integration', () => {
199
+ it('validates upstream blocking behavior and directional asymmetry', async () => {
200
+ const engine = new CriticalPathEngine();
201
+ const project = await engine.createProject({ key: 'ST', name: 'State Test Project' });
202
+
203
+ // Task A: Upstream
204
+ const taskA = await engine.createTask({
205
+ projectId: project.id,
206
+ title: 'Task A (Upstream)',
207
+ status: 'todo',
208
+ priority: 'high'
209
+ });
210
+
211
+ // Task B: Downstream dependent
212
+ const taskB = await engine.createTask({
213
+ projectId: project.id,
214
+ title: 'Task B (Downstream)',
215
+ status: 'todo',
216
+ priority: 'medium'
217
+ });
218
+
219
+ // Before dependency: both are ready, neither is blocked
220
+ let stateA = await engine.getTaskLifecycleState(taskA.id);
221
+ let stateB = await engine.getTaskLifecycleState(taskB.id);
222
+ expect(stateA?.isBlocked).toBe(false);
223
+ expect(stateA?.isReady).toBe(true);
224
+ expect(stateB?.isBlocked).toBe(false);
225
+ expect(stateB?.isReady).toBe(true);
226
+
227
+ // Add blocking dependency: B depends on A
228
+ await engine.addDependency({
229
+ taskId: taskB.id,
230
+ dependsOnTaskId: taskA.id,
231
+ type: 'blocking'
232
+ });
233
+
234
+ // Verify B is blocked by A, but A is NOT blocked by B (directional check)
235
+ stateA = await engine.getTaskLifecycleState(taskA.id);
236
+ stateB = await engine.getTaskLifecycleState(taskB.id);
237
+
238
+ expect(stateA?.isBlocked).toBe(false);
239
+ expect(stateA?.isReady).toBe(true);
240
+ expect(stateA?.blockingTaskIds).toHaveLength(0);
241
+
242
+ expect(stateB?.isBlocked).toBe(true);
243
+ expect(stateB?.isReady).toBe(false);
244
+ expect(stateB?.blockingTaskIds).toEqual([taskA.id]);
245
+
246
+ // Complete Upstream Task A -> Task B is unblocked
247
+ await engine.updateTask(taskA.id, { status: 'done' });
248
+
249
+ stateA = await engine.getTaskLifecycleState(taskA.id);
250
+ stateB = await engine.getTaskLifecycleState(taskB.id);
251
+
252
+ expect(stateA?.isDone).toBe(true);
253
+ expect(stateB?.isBlocked).toBe(false);
254
+ expect(stateB?.isReady).toBe(true);
255
+ expect(stateB?.blockingTaskIds).toHaveLength(0);
256
+
257
+ // Reopen Task A from done back to todo -> Task B becomes blocked again
258
+ await engine.updateTask(taskA.id, { status: 'todo' });
259
+
260
+ stateB = await engine.getTaskLifecycleState(taskB.id);
261
+ expect(stateB?.isBlocked).toBe(true);
262
+ expect(stateB?.isReady).toBe(false);
263
+ expect(stateB?.blockingTaskIds).toEqual([taskA.id]);
264
+ });
265
+
266
+ it('unblocks task when blocking upstream task is deleted', async () => {
267
+ const engine = new CriticalPathEngine();
268
+ const project = await engine.createProject({ key: 'DEL', name: 'Delete Dep Project' });
269
+
270
+ const taskA = await engine.createTask({ projectId: project.id, title: 'Task A', status: 'todo' });
271
+ const taskB = await engine.createTask({ projectId: project.id, title: 'Task B', status: 'todo' });
272
+
273
+ await engine.addDependency({
274
+ taskId: taskB.id,
275
+ dependsOnTaskId: taskA.id,
276
+ type: 'blocking'
277
+ });
278
+
279
+ let stateB = await engine.getTaskLifecycleState(taskB.id);
280
+ expect(stateB?.isBlocked).toBe(true);
281
+
282
+ // Delete upstream task
283
+ await engine.deleteTask(taskA.id);
284
+
285
+ stateB = await engine.getTaskLifecycleState(taskB.id);
286
+ expect(stateB?.isBlocked).toBe(false);
287
+ expect(stateB?.isReady).toBe(true);
288
+ expect(stateB?.blockingTaskIds).toHaveLength(0);
289
+ });
290
+
291
+ it('validates multi-level transitive dependency chain (A -> B -> C)', async () => {
292
+ const engine = new CriticalPathEngine();
293
+ const project = await engine.createProject({ key: 'CHAIN', name: 'Chain Project' });
294
+
295
+ const taskA = await engine.createTask({ projectId: project.id, title: 'Step 1: DB Schema', status: 'todo' });
296
+ const taskB = await engine.createTask({ projectId: project.id, title: 'Step 2: API Endpoints', status: 'todo' });
297
+ const taskC = await engine.createTask({ projectId: project.id, title: 'Step 3: Frontend View', status: 'todo' });
298
+
299
+ // B depends on A
300
+ await engine.addDependency({
301
+ taskId: taskB.id,
302
+ dependsOnTaskId: taskA.id,
303
+ type: 'blocking'
304
+ });
305
+
306
+ // C depends on B
307
+ await engine.addDependency({
308
+ taskId: taskC.id,
309
+ dependsOnTaskId: taskB.id,
310
+ type: 'blocking'
311
+ });
312
+
313
+ // Initial state: A is ready; B is blocked by A; C is blocked by B
314
+ let stateA = await engine.getTaskLifecycleState(taskA.id);
315
+ let stateB = await engine.getTaskLifecycleState(taskB.id);
316
+ let stateC = await engine.getTaskLifecycleState(taskC.id);
317
+
318
+ expect(stateA?.isReady).toBe(true);
319
+ expect(stateB?.isBlocked).toBe(true);
320
+ expect(stateB?.blockingTaskIds).toEqual([taskA.id]);
321
+ expect(stateC?.isBlocked).toBe(true);
322
+ expect(stateC?.blockingTaskIds).toEqual([taskB.id]);
323
+
324
+ // Complete A: B becomes ready; C is STILL blocked by B
325
+ await engine.updateTask(taskA.id, { status: 'done' });
326
+
327
+ stateB = await engine.getTaskLifecycleState(taskB.id);
328
+ stateC = await engine.getTaskLifecycleState(taskC.id);
329
+
330
+ expect(stateB?.isBlocked).toBe(false);
331
+ expect(stateB?.isReady).toBe(true);
332
+
333
+ expect(stateC?.isBlocked).toBe(true);
334
+ expect(stateC?.isReady).toBe(false);
335
+ expect(stateC?.blockingTaskIds).toEqual([taskB.id]);
336
+
337
+ // Complete B: C is finally unblocked and ready
338
+ await engine.updateTask(taskB.id, { status: 'done' });
339
+
340
+ stateC = await engine.getTaskLifecycleState(taskC.id);
341
+ expect(stateC?.isBlocked).toBe(false);
342
+ expect(stateC?.isReady).toBe(true);
343
+ expect(stateC?.blockingTaskIds).toHaveLength(0);
344
+ });
345
+
346
+ it('emits task.unblocked domain event and auto-transitions status from blocked to todo when dependencies complete', async () => {
347
+ const engine = new CriticalPathEngine();
348
+ const project = await engine.createProject({ key: 'UNBLK', name: 'Auto Unblock Project' });
349
+
350
+ const taskUpstream = await engine.createTask({
351
+ projectId: project.id,
352
+ title: 'Compile Library',
353
+ status: 'todo'
354
+ });
355
+
356
+ // Create downstream task with status: 'blocked' and customFields.isBlocked = true
357
+ const taskDownstream = await engine.createTask({
358
+ projectId: project.id,
359
+ title: 'Run Integration Tests',
360
+ status: 'blocked',
361
+ customFields: { isBlocked: true, blockedReason: 'Waiting on compilation' }
362
+ });
363
+
364
+ await engine.addDependency({
365
+ taskId: taskDownstream.id,
366
+ dependsOnTaskId: taskUpstream.id,
367
+ type: 'blocking'
368
+ });
369
+
370
+ // Subscribe to domain event
371
+ const unblockedEvents: TaskUnblockedEvent[] = [];
372
+ engine.events.subscribe<TaskUnblockedEvent>('task.unblocked', (event) => {
373
+ unblockedEvents.push(event);
374
+ });
375
+
376
+ // Complete upstream task
377
+ await engine.updateTask(taskUpstream.id, { status: 'done' });
378
+
379
+ // Verify domain event was published
380
+ expect(unblockedEvents).toHaveLength(1);
381
+ expect(unblockedEvents[0].name).toBe('task.unblocked');
382
+ expect(unblockedEvents[0].aggregateId).toBe(taskDownstream.id);
383
+ expect(unblockedEvents[0].payload.upstreamTaskId).toBe(taskUpstream.id);
384
+
385
+ // Verify downstream task was automatically transitioned from 'blocked' to 'todo'
386
+ const updatedDownstream = await engine.getTask(taskDownstream.id);
387
+ expect(updatedDownstream?.status).toBe('todo');
388
+ expect(updatedDownstream?.customFields?.isBlocked).toBe(false);
389
+ expect(updatedDownstream?.customFields?.blockedReason).toBeNull();
390
+
391
+ // Verify lifecycle state is ready and unblocked
392
+ const lifecycle = await engine.getTaskLifecycleState(taskDownstream.id);
393
+ expect(lifecycle?.isBlocked).toBe(false);
394
+ expect(lifecycle?.isReady).toBe(true);
395
+ });
396
+
397
+ it('does not auto-unblock downstream task if other upstream dependencies remain incomplete', async () => {
398
+ const engine = new CriticalPathEngine();
399
+ const project = await engine.createProject({ key: 'FANIN', name: 'Fan In Project' });
400
+
401
+ const up1 = await engine.createTask({ projectId: project.id, title: 'Dependency 1', status: 'todo' });
402
+ const up2 = await engine.createTask({ projectId: project.id, title: 'Dependency 2', status: 'todo' });
403
+
404
+ const downstream = await engine.createTask({
405
+ projectId: project.id,
406
+ title: 'Final Assembly',
407
+ status: 'blocked',
408
+ customFields: { isBlocked: true }
409
+ });
410
+
411
+ await engine.addDependency({ taskId: downstream.id, dependsOnTaskId: up1.id, type: 'blocking' });
412
+ await engine.addDependency({ taskId: downstream.id, dependsOnTaskId: up2.id, type: 'blocking' });
413
+
414
+ const unblockedEvents: TaskUnblockedEvent[] = [];
415
+ engine.events.subscribe<TaskUnblockedEvent>('task.unblocked', (evt) => {
416
+ unblockedEvents.push(evt);
417
+ });
418
+
419
+ // Complete up1 only
420
+ await engine.updateTask(up1.id, { status: 'done' });
421
+
422
+ // Downstream should NOT be unblocked because up2 is still incomplete
423
+ expect(unblockedEvents).toHaveLength(0);
424
+
425
+ let taskState = await engine.getTask(downstream.id);
426
+ expect(taskState?.status).toBe('blocked');
427
+ expect(taskState?.customFields?.isBlocked).toBe(true);
428
+
429
+ let lifecycle = await engine.getTaskLifecycleState(downstream.id);
430
+ expect(lifecycle?.isBlocked).toBe(true);
431
+ expect(lifecycle?.blockingTaskIds).toEqual([up2.id]);
432
+
433
+ // Complete up2
434
+ await engine.updateTask(up2.id, { status: 'done' });
435
+
436
+ // Now it should be unblocked
437
+ expect(unblockedEvents).toHaveLength(1);
438
+ taskState = await engine.getTask(downstream.id);
439
+ expect(taskState?.status).toBe('todo');
440
+ expect(taskState?.customFields?.isBlocked).toBe(false);
441
+
442
+ lifecycle = await engine.getTaskLifecycleState(downstream.id);
443
+ expect(lifecycle?.isBlocked).toBe(false);
444
+ expect(lifecycle?.isReady).toBe(true);
445
+ });
446
+ });
447
+ });
@@ -424,3 +424,141 @@ export interface CriticalPathConfig {
424
424
  deliverables?: Deliverable[];
425
425
  };
426
426
  }
427
+
428
+ // ==========================================
429
+ // Bret Victor's Ladder of Abstraction Types
430
+ // ==========================================
431
+
432
+ export type AbstractionLevel = 'macro' | 'standard' | 'concrete' | 'all';
433
+
434
+ export type MacroPhaseHealth = 'on_track' | 'at_risk' | 'blocked' | 'overdue' | 'completed';
435
+
436
+ export interface MacroPhaseRollup {
437
+ id: string; // containerId, iterationId, deliverableId, or 'unassigned'
438
+ type: 'container' | 'iteration' | 'deliverable' | 'phase';
439
+ name: string;
440
+ description?: string;
441
+ startDate?: string;
442
+ endDate?: string;
443
+ durationHours: number;
444
+ totalTasks: number;
445
+ completedTasks: number;
446
+ inProgressTasks: number;
447
+ blockedTasks: number;
448
+ progressPercentage: number;
449
+ totalEstimatedHours: number;
450
+ totalLoggedHours: number;
451
+ isCritical: boolean;
452
+ criticalTaskCount: number;
453
+ health: MacroPhaseHealth;
454
+ taskIds: string[];
455
+ }
456
+
457
+ export interface MacroTimelineSummary {
458
+ projectId: string;
459
+ projectName: string;
460
+ overallStartDate?: string;
461
+ overallEndDate?: string;
462
+ projectedFinishDate?: string;
463
+ totalDurationHours: number;
464
+ criticalPathDurationHours: number;
465
+ overallProgressPercentage: number;
466
+ health: MacroPhaseHealth;
467
+ totalTasks: number;
468
+ completedTasks: number;
469
+ inProgressTasks: number;
470
+ blockedTasks: number;
471
+ totalEstimatedHours: number;
472
+ totalLoggedHours: number;
473
+ phases: MacroPhaseRollup[];
474
+ }
475
+
476
+ export interface TaskCriticalPathSchedule {
477
+ taskId: string;
478
+ earlyStart: number;
479
+ earlyFinish: number;
480
+ lateStart: number;
481
+ lateFinish: number;
482
+ totalSlack: number;
483
+ isCritical: boolean;
484
+ }
485
+
486
+ export interface CriticalPathAnalysis {
487
+ projectId: string;
488
+ calculatedAt: string;
489
+ totalDurationHours: number;
490
+ criticalTaskIds: string[];
491
+ tasks: TaskCriticalPathSchedule[];
492
+ }
493
+
494
+ export interface ConcreteEvidenceSummary {
495
+ attachmentCount: number;
496
+ deliverableCount: number;
497
+ todoCount: number;
498
+ completedTodoCount: number;
499
+ timeEntryCount: number;
500
+ totalLoggedHours: number;
501
+ hasVisualAsset: boolean;
502
+ lastActivityAt?: string;
503
+ }
504
+
505
+ export interface StandardTaskTimelineItem extends Task {
506
+ cpm?: TaskCriticalPathSchedule;
507
+ blockingTaskIds: string[];
508
+ dependentTaskIds: string[];
509
+ childTaskIds: string[];
510
+ concreteEvidenceSummary: ConcreteEvidenceSummary;
511
+ }
512
+
513
+ export interface RealityDelta {
514
+ plannedStartDate?: string;
515
+ actualStartDate?: string;
516
+ dueDate?: string;
517
+ actualEndDate?: string;
518
+ estimatedHours: number;
519
+ loggedHours: number;
520
+ varianceHours: number; // loggedHours - estimatedHours
521
+ scheduleVarianceDays?: number; // days difference between planned/due vs actual
522
+ isOverdue: boolean;
523
+ isOverEstimate: boolean;
524
+ }
525
+
526
+ export interface ConcreteTaskEvidence {
527
+ taskId: string;
528
+ attachments: Attachment[];
529
+ deliverables: Deliverable[];
530
+ todos: TaskTodoItem[];
531
+ timeEntries: TimeEntry[];
532
+ dailyEffortDistribution: Array<{ date: string; hours: number }>;
533
+ activities: Activity[];
534
+ realityDelta: RealityDelta;
535
+ evidenceSummary: ConcreteEvidenceSummary;
536
+ }
537
+
538
+ export interface TimelineLadderOptions {
539
+ level?: AbstractionLevel;
540
+ containerId?: string;
541
+ iterationId?: string;
542
+ }
543
+
544
+ export interface TimelineLadder {
545
+ projectId: string;
546
+ generatedAt: string;
547
+ level: AbstractionLevel;
548
+ macro?: MacroTimelineSummary;
549
+ standard?: {
550
+ tasks: StandardTaskTimelineItem[];
551
+ criticalPathTaskIds: string[];
552
+ dependencies: TaskDependency[];
553
+ totalDurationHours: number;
554
+ };
555
+ concrete?: Record<string, ConcreteTaskEvidence>;
556
+ }
557
+
558
+ export interface TaskLadderView {
559
+ taskId: string;
560
+ macroPhase?: MacroPhaseRollup;
561
+ standard: StandardTaskTimelineItem;
562
+ concrete: ConcreteTaskEvidence;
563
+ }
564
+
@@ -1 +1 @@
1
- {"root":["./src/deliverables.test.ts","./src/index.test.ts","./src/index.ts","./src/status.test.ts","./src/use-case-validation.test.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/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"}
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/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"}