@critical-path/core 0.15.2 → 0.17.0

package/src/store/firebase.ts

@@ -536,9 +536,9 @@ export class FirebaseStore implements StorageAdapter {
     return snap.docs.map((doc) => ({ ...doc.data(), id: doc.id }));
   }
 
-  async logTime(entry: Omit<TimeEntry, 'id' | 'loggedAt'>): Promise<TimeEntry> {
+  async logTime(entry: Omit<TimeEntry, 'id' | 'loggedAt'> & { loggedAt?: string }): Promise<TimeEntry> {
     const docRef = this.db.collection('time_entries').doc();
-    const now = new Date().toISOString();
+    const now = entry.loggedAt || new Date().toISOString();
     const newEntry: TimeEntry = { ...entry, id: docRef.id, loggedAt: now };
     await docRef.set(sanitizeFirestoreData(newEntry));
     return newEntry;

package/src/store/index.ts

@@ -91,7 +91,7 @@ export interface ActivityRepository {
 
 export interface TimeEntryRepository {
   getTimeEntries(taskId: string): Promise<TimeEntry[]>;
-  logTime(entry: Omit<TimeEntry, 'id' | 'loggedAt'>): Promise<TimeEntry>;
+  logTime(entry: Omit<TimeEntry, 'id' | 'loggedAt'> & { loggedAt?: string }): Promise<TimeEntry>;
 }
 
 export interface DependencyRepository {
@@ -512,9 +512,9 @@ export class InMemoryStore implements StorageAdapter {
     return Array.from(this.timeEntries.values()).filter((e) => e.taskId === taskId);
   }
 
-  async logTime(entry: Omit<TimeEntry, 'id' | 'loggedAt'>): Promise<TimeEntry> {
+  async logTime(entry: Omit<TimeEntry, 'id' | 'loggedAt'> & { loggedAt?: string }): Promise<TimeEntry> {
     const id = `time_${Math.random().toString(36).substring(2, 9)}`;
-    const newEntry: TimeEntry = { ...entry, id, loggedAt: new Date().toISOString() };
+    const newEntry: TimeEntry = { ...entry, id, loggedAt: entry.loggedAt || new Date().toISOString() };
     this.timeEntries.set(id, newEntry);
     return newEntry;
   }

package/src/store/sqlite.ts

@@ -1084,9 +1084,9 @@ export class SQLiteStore implements StorageAdapter {
     return rows.map((r) => ({ ...r, isBillable: r.isBillable !== null ? Boolean(r.isBillable) : undefined }));
   }
 
-  async logTime(entry: Omit<TimeEntry, 'id' | 'loggedAt'>): Promise<TimeEntry> {
+  async logTime(entry: Omit<TimeEntry, 'id' | 'loggedAt'> & { loggedAt?: string }): Promise<TimeEntry> {
     const id = `time_${Math.random().toString(36).substring(2, 9)}`;
-    const now = new Date().toISOString();
+    const now = entry.loggedAt || new Date().toISOString();
     const newEntry: TimeEntry = { ...entry, id, loggedAt: now };
 
     const stmt = this.db.prepare(`

package/src/types/index.ts

@@ -424,3 +424,209 @@ export interface CriticalPathConfig {
     deliverables?: Deliverable[];
   };
 }
+
+// ==========================================
+// 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
+  effortVarianceHours?: number; // loggedHours - estimatedHours (effort variance)
+  durationVarianceHours?: number; // actual duration hours - planned duration hours
+  scheduleVarianceDays?: number; // days difference between planned/due vs actual
+  accuracyRatio?: number; // loggedHours / estimatedHours (estimation accuracy ratio)
+  isOverdue: boolean;
+  isOverEstimate: boolean;
+}
+
+export type ProgressInferenceSource = 'explicit' | 'todos' | 'time_effort' | 'schedule_elapsed' | 'blended';
+
+export interface TaskProgressInference {
+  progressPercentage: number;
+  source: ProgressInferenceSource;
+  isExplicit: boolean;
+  breakdown: {
+    explicitProgress?: number;
+    todoProgress?: number;
+    effortProgress?: number;
+    scheduleProgress?: number;
+  };
+}
+
+export type ProgressCurveProfile =
+  | 'linear'
+  | 's_curve'
+  | 'early_surge'
+  | 'late_rush'
+  | 'stalled'
+  | 'insufficient_data';
+
+export interface TaskProgressHistoryPoint {
+  timestamp: string;
+  progress: number;
+  inferredProgress?: number;
+  status: TaskStatus;
+  semanticStatus?: SemanticStatus;
+  action: string;
+}
+
+export interface TaskProgressHistory {
+  taskId: string;
+  points: TaskProgressHistoryPoint[];
+  curveProfile: ProgressCurveProfile;
+}
+
+export interface TaskEVM {
+  plannedValue: number; // PV (expected hours)
+  earnedValue: number; // EV (earned hours)
+  actualCost: number; // AC (logged hours)
+  costVariance: number; // CV = EV - AC
+  scheduleVariance: number; // SV = EV - PV
+  costPerformanceIndex: number; // CPI = EV / AC
+  schedulePerformanceIndex: number; // SPI = EV / PV
+}
+
+export interface TaskInferredActuals {
+  actualStartDate?: string;
+  actualEndDate?: string;
+  isStartDateInferred: boolean;
+  isEndDateInferred: boolean;
+  activeWorkingHours?: number;
+}
+
+export interface TaskMetrics {
+  taskId: string;
+  inferredActuals: TaskInferredActuals;
+  realityDelta: RealityDelta;
+  progress: TaskProgressInference;
+  evm: TaskEVM;
+  progressHistory: TaskProgressHistory;
+}
+
+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;
+  metrics?: TaskMetrics;
+}
+

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/domain/metrics.test.ts","./src/domain/metrics.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"}