agent-ecosystem/src/shared/utils/taskHistory.ts
iliya 9678d790cd feat: enhance task review process with new event tracking
- Introduced a new function to determine the current review state based on task history events, improving the accuracy of review status tracking.
- Updated the requestReview, approveReview, and requestChanges functions to append corresponding review events to the task history, ensuring comprehensive tracking of review actions.
- Refactored task management logic to utilize the new historyEvents structure, replacing the previous statusHistory implementation for better clarity and maintainability.
- Enhanced tests to validate the new review event handling and ensure correct behavior across various task states.
2026-03-09 14:52:38 +02:00

50 lines
1.8 KiB
TypeScript

import type { TaskHistoryEvent, TeamReviewState, TeamTask, TeamTaskStatus } from '@shared/types';
/** Extract historyEvents from a task, defaulting to empty array. */
export function getTaskHistoryEvents(task: Pick<TeamTask, 'historyEvents'>): TaskHistoryEvent[] {
return Array.isArray(task.historyEvents) ? task.historyEvents : [];
}
/** Derive the current task status from historyEvents. Falls back to task.status if no events. */
export function getDerivedTaskStatus(
task: Pick<TeamTask, 'historyEvents' | 'status'>
): TeamTaskStatus {
const events = getTaskHistoryEvents(task);
for (let i = events.length - 1; i >= 0; i--) {
const event = events[i];
if (event.type === 'task_created') return event.status;
if (event.type === 'status_changed') return event.to;
}
return task.status;
}
/** Derive the current review state from historyEvents. */
export function getDerivedReviewState(task: Pick<TeamTask, 'historyEvents'>): TeamReviewState {
const events = getTaskHistoryEvents(task);
for (let i = events.length - 1; i >= 0; i--) {
const event = events[i];
if (
event.type === 'review_requested' ||
event.type === 'review_changes_requested' ||
event.type === 'review_approved'
) {
return event.to;
}
// A status_changed to in_progress after a review event resets review state
if (event.type === 'status_changed' && event.to === 'in_progress') {
return 'none';
}
}
return 'none';
}
/** Get a full workflow snapshot from historyEvents. */
export function getTaskWorkflowSnapshot(task: Pick<TeamTask, 'historyEvents' | 'status'>): {
status: TeamTaskStatus;
reviewState: TeamReviewState;
} {
return {
status: getDerivedTaskStatus(task),
reviewState: getDerivedReviewState(task),
};
}