@critical-path/core 0.15.2 → 0.16.0

package/src/types/index.ts

@@ -424,3 +424,141 @@ export interface CriticalPathConfig {
     deliverables?: Deliverable[];
   };
 }
+
+// ==========================================
+// Bret Victor's Ladder of Abstraction Types
+// ==========================================
+
+export type AbstractionLevel = 'macro' | 'standard' | 'concrete' | 'all';
+
+export type MacroPhaseHealth = 'on_track' | 'at_risk' | 'blocked' | 'overdue' | 'completed';
+
+export interface MacroPhaseRollup {
+  id: string; // containerId, iterationId, deliverableId, or 'unassigned'
+  type: 'container' | 'iteration' | 'deliverable' | 'phase';
+  name: string;
+  description?: string;
+  startDate?: string;
+  endDate?: string;
+  durationHours: number;
+  totalTasks: number;
+  completedTasks: number;
+  inProgressTasks: number;
+  blockedTasks: number;
+  progressPercentage: number;
+  totalEstimatedHours: number;
+  totalLoggedHours: number;
+  isCritical: boolean;
+  criticalTaskCount: number;
+  health: MacroPhaseHealth;
+  taskIds: string[];
+}
+
+export interface MacroTimelineSummary {
+  projectId: string;
+  projectName: string;
+  overallStartDate?: string;
+  overallEndDate?: string;
+  projectedFinishDate?: string;
+  totalDurationHours: number;
+  criticalPathDurationHours: number;
+  overallProgressPercentage: number;
+  health: MacroPhaseHealth;
+  totalTasks: number;
+  completedTasks: number;
+  inProgressTasks: number;
+  blockedTasks: number;
+  totalEstimatedHours: number;
+  totalLoggedHours: number;
+  phases: MacroPhaseRollup[];
+}
+
+export interface TaskCriticalPathSchedule {
+  taskId: string;
+  earlyStart: number;
+  earlyFinish: number;
+  lateStart: number;
+  lateFinish: number;
+  totalSlack: number;
+  isCritical: boolean;
+}
+
+export interface CriticalPathAnalysis {
+  projectId: string;
+  calculatedAt: string;
+  totalDurationHours: number;
+  criticalTaskIds: string[];
+  tasks: TaskCriticalPathSchedule[];
+}
+
+export interface ConcreteEvidenceSummary {
+  attachmentCount: number;
+  deliverableCount: number;
+  todoCount: number;
+  completedTodoCount: number;
+  timeEntryCount: number;
+  totalLoggedHours: number;
+  hasVisualAsset: boolean;
+  lastActivityAt?: string;
+}
+
+export interface StandardTaskTimelineItem extends Task {
+  cpm?: TaskCriticalPathSchedule;
+  blockingTaskIds: string[];
+  dependentTaskIds: string[];
+  childTaskIds: string[];
+  concreteEvidenceSummary: ConcreteEvidenceSummary;
+}
+
+export interface RealityDelta {
+  plannedStartDate?: string;
+  actualStartDate?: string;
+  dueDate?: string;
+  actualEndDate?: string;
+  estimatedHours: number;
+  loggedHours: number;
+  varianceHours: number; // loggedHours - estimatedHours
+  scheduleVarianceDays?: number; // days difference between planned/due vs actual
+  isOverdue: boolean;
+  isOverEstimate: boolean;
+}
+
+export interface ConcreteTaskEvidence {
+  taskId: string;
+  attachments: Attachment[];
+  deliverables: Deliverable[];
+  todos: TaskTodoItem[];
+  timeEntries: TimeEntry[];
+  dailyEffortDistribution: Array<{ date: string; hours: number }>;
+  activities: Activity[];
+  realityDelta: RealityDelta;
+  evidenceSummary: ConcreteEvidenceSummary;
+}
+
+export interface TimelineLadderOptions {
+  level?: AbstractionLevel;
+  containerId?: string;
+  iterationId?: string;
+}
+
+export interface TimelineLadder {
+  projectId: string;
+  generatedAt: string;
+  level: AbstractionLevel;
+  macro?: MacroTimelineSummary;
+  standard?: {
+    tasks: StandardTaskTimelineItem[];
+    criticalPathTaskIds: string[];
+    dependencies: TaskDependency[];
+    totalDurationHours: number;
+  };
+  concrete?: Record<string, ConcreteTaskEvidence>;
+}
+
+export interface TaskLadderView {
+  taskId: string;
+  macroPhase?: MacroPhaseRollup;
+  standard: StandardTaskTimelineItem;
+  concrete: ConcreteTaskEvidence;
+}
+

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/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"}
+{"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"}