Something went wrong. Try again.
Reference implementation for the Phoenix Architecture. Work in progress. aicoding.leaflet.pub
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139export interface TaskRecord { id: string; createdAt: Date; completedAt?: Date; dueDate?: Date; status: 'pending' | 'completed' | 'overdue';}
export interface MetricsSnapshot { totalCreated: number; totalCompleted: number; totalOverdue: number; averageCompletionTimeHours: number; throughputTasksPerDay: number; calculatedAt: Date;}
export class Metrics { private tasks: TaskRecord[] = [];
constructor(initialTasks: TaskRecord[] = []) { this.tasks = [...initialTasks]; }
addTask(task: TaskRecord): void { this.tasks.push({ ...task }); }
addTasks(tasks: TaskRecord[]): void { this.tasks.push(...tasks.map(task => ({ ...task }))); }
updateTask(taskId: string, updates: Partial<TaskRecord>): boolean { const taskIndex = this.tasks.findIndex(task => task.id === taskId); if (taskIndex === -1) { return false; } this.tasks[taskIndex] = { ...this.tasks[taskIndex], ...updates }; return true; }
getTotalCreated(): number { return this.tasks.length; }
getTotalCompleted(): number { return this.tasks.filter(task => task.status === 'completed').length; }
getTotalOverdue(): number { const now = new Date(); return this.tasks.filter(task => { if (task.status === 'completed' || !task.dueDate) { return false; } return task.dueDate < now; }).length; }
getAverageCompletionTimeHours(): number { const completedTasks = this.tasks.filter(task => task.status === 'completed' && task.completedAt );
if (completedTasks.length === 0) { return 0; }
const totalHours = completedTasks.reduce((sum, task) => { const completionTime = task.completedAt!.getTime() - task.createdAt.getTime(); return sum + (completionTime / (1000 * 60 * 60)); // Convert ms to hours }, 0);
return totalHours / completedTasks.length; }
getThroughputTasksPerDay(): number { const now = new Date(); const sevenDaysAgo = new Date(now.getTime() - (7 * 24 * 60 * 60 * 1000));
const completedInWindow = this.tasks.filter(task => task.status === 'completed' && task.completedAt && task.completedAt >= sevenDaysAgo && task.completedAt <= now );
return completedInWindow.length / 7; }
getSnapshot(): MetricsSnapshot { return { totalCreated: this.getTotalCreated(), totalCompleted: this.getTotalCompleted(), totalOverdue: this.getTotalOverdue(), averageCompletionTimeHours: this.getAverageCompletionTimeHours(), throughputTasksPerDay: this.getThroughputTasksPerDay(), calculatedAt: new Date() }; }
reset(): void { this.tasks = []; }
getAllTasks(): TaskRecord[] { return this.tasks.map(task => ({ ...task })); }}
export function calculateMetricsFromTasks(tasks: TaskRecord[]): MetricsSnapshot { const metrics = new Metrics(tasks); return metrics.getSnapshot();}
export function isTaskOverdue(task: TaskRecord, referenceDate: Date = new Date()): boolean { if (task.status === 'completed' || !task.dueDate) { return false; } return task.dueDate < referenceDate;}
export function getCompletionTimeHours(task: TaskRecord): number | null { if (task.status !== 'completed' || !task.completedAt) { return null; } const completionTime = task.completedAt.getTime() - task.createdAt.getTime(); return completionTime / (1000 * 60 * 60);}
/** @internal Phoenix VCS traceability — do not remove. */export const _phoenix = { iu_id: '91cdb7e04a917c132c5de2e90731694b755d911d82ab03eb8b67e2232d3aa0b4', name: 'Metrics', risk_tier: 'medium', canon_ids: [4 as const],} as const;