@critical-path/core 0.1.2 → 0.2.1

package/src/types/index.ts

@@ -1,6 +1,19 @@
-export type Priority = 'urgent' | 'high' | 'medium' | 'low' | 'none';
+export type DefaultPriority = 'urgent' | 'high' | 'medium' | 'low' | 'none';
+export type Priority = DefaultPriority | (string & {});
 
-export type TaskStatus = 'backlog' | 'todo' | 'in_progress' | 'in_review' | 'done' | 'canceled';
+export type DefaultTaskStatus = 'backlog' | 'todo' | 'in_progress' | 'in_review' | 'done' | 'canceled';
+export type TaskStatus = DefaultTaskStatus | (string & {});
+
+export type CompletionState = 'done' | 'not_done';
+export type ExecutionState = 'active' | 'inactive';
+
+export interface StatusDefinition {
+  key: string;
+  label: string;
+  completionState: CompletionState;
+  executionState: ExecutionState;
+  isCancelled?: boolean;
+}
 
 export type Role = 'admin' | 'project_manager' | 'contributor' | 'viewer';
 
@@ -13,6 +26,16 @@ export interface User {
   createdAt: string;
 }
 
+export interface Team {
+  id: string;
+  name: string;
+  description?: string;
+  leaderId?: string;
+  memberIds: string[];
+  createdAt: string;
+  updatedAt: string;
+}
+
 export interface CustomFieldDefinition {
   id: string;
   key: string;
@@ -30,11 +53,26 @@ export interface Project {
   description?: string;
   ownerId?: string;
   members?: string[]; // user IDs
+  teamIds?: string[]; // team IDs
+  statusDefinitions?: StatusDefinition[];
+  priorityDefinitions?: Array<{ key: string; label: string; level?: number }>;
   customFieldDefinitions?: CustomFieldDefinition[];
   createdAt: string;
   updatedAt: string;
 }
 
+export interface TaskContainer {
+  id: string;
+  projectId: string;
+  name: string;
+  description?: string;
+  parentId?: string; // nested container hierarchy (e.g., folder -> epic -> group)
+  type?: 'epic' | 'group' | 'section' | 'folder' | string;
+  color?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
 export interface TaskDependency {
   id: string;
   taskId: string;
@@ -42,6 +80,13 @@ export interface TaskDependency {
   type: 'blocking' | 'blocked_by' | 'relates_to';
 }
 
+export interface TaskDependencyGraph {
+  taskId: string;
+  upstreamTasks: Task[];   // tasks that this task depends on
+  downstreamTasks: Task[]; // tasks that depend on this task
+  dependencies: TaskDependency[];
+}
+
 export interface Task {
   id: string;
   projectId: string;
@@ -51,10 +96,24 @@ export interface Task {
   priority: Priority;
   assigneeId?: string;
   reporterId?: string;
-  sprintId?: string;
+  reviewerId?: string;
+  iterationId?: string;
+  teamId?: string;
+  containerId?: string;
+  plannedStartDate?: string;
+  actualStartDate?: string;
+  actualEndDate?: string;
   dueDate?: string;
+  // Duration & Effort (in hours and/or minutes)
   estimatedHours?: number;
   loggedHours?: number;
+  actualHours?: number;
+  billableHours?: number;
+  estimatedDurationMinutes?: number;
+  actualDurationMinutes?: number;
+  billableDurationMinutes?: number;
+  // Progress (0 to 100 percentage)
+  progress?: number;
   tags?: string[];
   customFields?: Record<string, unknown>;
   parentId?: string; // Subtask support
@@ -62,13 +121,14 @@ export interface Task {
   updatedAt: string;
 }
 
-export interface Sprint {
+export interface Iteration {
   id: string;
   projectId: string;
   name: string;
   goal?: string;
-  startDate: string;
-  endDate: string;
+  type?: 'sprint' | 'cycle' | 'milestone' | string;
+  startDate?: string;
+  endDate?: string;
   status: 'planning' | 'active' | 'completed';
   createdAt: string;
 }
@@ -87,6 +147,7 @@ export interface TimeEntry {
   taskId: string;
   userId: string;
   hours: number;
+  isBillable?: boolean;
   description?: string;
   loggedAt: string;
 }
@@ -119,8 +180,10 @@ export type WebhookEvent =
   | 'task.deleted'
   | 'task.status_changed'
   | 'comment.created'
-  | 'sprint.started'
-  | 'sprint.completed';
+  | 'iteration.started'
+  | 'iteration.completed'
+  | 'team.created'
+  | 'container.created';
 
 export interface PluginHooks {
   beforeTaskCreate?: (task: Partial<Task>) => Promise<Partial<Task>> | Partial<Task>;
@@ -149,6 +212,8 @@ export interface CriticalPathConfig {
     projects?: Project[];
     tasks?: Task[];
     users?: User[];
-    sprints?: Sprint[];
+    iterations?: Iteration[];
+    teams?: Team[];
+    containers?: TaskContainer[];
   };
 }

package/src/utils/status.ts

@@ -0,0 +1,85 @@
+import type {
+  Task,
+  StatusDefinition,
+  CompletionState,
+  ExecutionState
+} from '../types/index.js';
+
+export const DEFAULT_STATUS_DEFINITIONS: Record<string, StatusDefinition> = {
+  backlog: { key: 'backlog', label: 'Backlog', completionState: 'not_done', executionState: 'inactive' },
+  todo: { key: 'todo', label: 'To Do', completionState: 'not_done', executionState: 'inactive' },
+  in_progress: { key: 'in_progress', label: 'In Progress', completionState: 'not_done', executionState: 'active' },
+  in_review: { key: 'in_review', label: 'In Review', completionState: 'not_done', executionState: 'active' },
+  done: { key: 'done', label: 'Done', completionState: 'done', executionState: 'inactive' },
+  canceled: { key: 'canceled', label: 'Canceled', completionState: 'done', executionState: 'inactive', isCancelled: true }
+};
+
+export interface TaskLifecycleState {
+  completionState: CompletionState;
+  executionState: ExecutionState;
+  isDone: boolean;
+  isActive: boolean;
+  isCancelled: boolean;
+  isOverdue: boolean;
+  isUpcoming: boolean;
+}
+
+export function resolveStatusDefinition(
+  statusKey: string,
+  customDefinitions?: StatusDefinition[]
+): StatusDefinition {
+  if (customDefinitions) {
+    const found = customDefinitions.find((def) => def.key === statusKey);
+    if (found) return found;
+  }
+  if (DEFAULT_STATUS_DEFINITIONS[statusKey]) {
+    return DEFAULT_STATUS_DEFINITIONS[statusKey];
+  }
+  // Fallback heuristic for unknown custom statuses:
+  const isDoneKey = ['done', 'completed', 'finished', 'closed', 'canceled', 'cancelled'].includes(statusKey.toLowerCase());
+  const isActiveKey = ['in_progress', 'active', 'working', 'in_review', 'review'].includes(statusKey.toLowerCase());
+  return {
+    key: statusKey,
+    label: statusKey,
+    completionState: isDoneKey ? 'done' : 'not_done',
+    executionState: isActiveKey ? 'active' : 'inactive',
+    isCancelled: statusKey.toLowerCase().includes('cancel')
+  };
+}
+
+export function deriveTaskLifecycleState(
+  task: Task,
+  customDefinitions?: StatusDefinition[],
+  referenceDate: Date = new Date()
+): TaskLifecycleState {
+  const def = resolveStatusDefinition(task.status, customDefinitions);
+  const isDone = def.completionState === 'done';
+  const isActive = def.executionState === 'active';
+  const isCancelled = Boolean(def.isCancelled);
+
+  let isOverdue = false;
+  if (!isDone && task.dueDate) {
+    const due = new Date(task.dueDate);
+    if (!isNaN(due.getTime()) && due < referenceDate) {
+      isOverdue = true;
+    }
+  }
+
+  let isUpcoming = false;
+  if (!isDone && !isActive && task.plannedStartDate) {
+    const plannedStart = new Date(task.plannedStartDate);
+    if (!isNaN(plannedStart.getTime()) && plannedStart > referenceDate) {
+      isUpcoming = true;
+    }
+  }
+
+  return {
+    completionState: def.completionState,
+    executionState: def.executionState,
+    isDone,
+    isActive,
+    isCancelled,
+    isOverdue,
+    isUpcoming
+  };
+}

package/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/index.test.ts","./src/index.ts","./src/engine/index.ts","./src/plugins/index.ts","./src/store/index.ts","./src/types/index.ts"],"version":"5.9.3"}
+{"root":["./src/index.test.ts","./src/index.ts","./src/engine/index.ts","./src/plugins/index.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/status.ts"],"version":"5.9.3"}