@parhelia/core 0.3.12816 → 0.3.12818

package/dist/task-board/TaskBoardWorkspace.js

@@ -37,6 +37,8 @@ import { WizardCommunicationCenter } from "./components/WizardCommunicationCente
 import { Loader2 } from "lucide-react";
 import { MainContentTree } from "../editor/sidebar/MainContentTree";
 import { useTaskBoardAgentPanelState } from "./useTaskBoardAgentPanelState";
+import { goalScopesMatch } from "./goalRefreshState";
+import { initialGoalTaskNavigationState, reduceGoalTaskNavigation, } from "./goalTaskNavigationState";
 const DependencyGraphView = lazy(() => import("./views/DependencyGraphView").then((module) => ({
     default: module.DependencyGraphView,
 })));
@@ -177,10 +179,15 @@ export function TaskBoardWorkspace() {
     const [tasks, setTasks] = useState([]);
     const [goals, setGoals] = useState([]);
     const [goalsLoading, setGoalsLoading] = useState(false);
+    const [goalsError, setGoalsError] = useState(null);
     const [goalCatalog, setGoalCatalog] = useState([]);
     const [goalPermissions, setGoalPermissions] = useState({});
+    const [goalDisplaySpecs, setGoalDisplaySpecs] = useState({});
+    const [goalStateScope, setGoalStateScope] = useState(null);
     const [includeGoalSubprojects, setIncludeGoalSubprojects] = useState(false);
     const latestGoalsProjectIdRef = useRef(null);
+    const goalsRequestGenerationRef = useRef(0);
+    const wsGoalRefreshTimeoutRef = useRef(null);
     const refreshGoalsRef = useRef(null);
     const includeGoalSubprojectsRef = useRef(false);
     const [isTasksLoading, setIsTasksLoading] = useState(false);
@@ -250,6 +257,14 @@ export function TaskBoardWorkspace() {
     const projectsRequestCountRef = useRef(0);
     const tasksRequestCountRef = useRef(0);
     const latestTasksProjectIdRef = useRef(null);
+    const taskRequestGenerationByProjectRef = useRef(new Map());
+    const taskRequestInFlightByProjectRef = useRef(new Map());
+    const goalTaskNavigationStateRef = useRef(initialGoalTaskNavigationState);
+    const transitionGoalTaskNavigation = useCallback((action) => {
+        const next = reduceGoalTaskNavigation(goalTaskNavigationStateRef.current, action);
+        goalTaskNavigationStateRef.current = next;
+        return next.outcome;
+    }, []);
     const latestDependenciesProjectIdRef = useRef(null);
     const latestGraphLayoutProjectIdRef = useRef(null);
     const latestSubprojectCountsProjectIdRef = useRef(null);
@@ -798,6 +813,9 @@ export function TaskBoardWorkspace() {
         return () => window.removeEventListener("popstate", handlePopState);
     }, [syncTaskBoardStateFromUrl]);
     const refreshTasks = useCallback(async (projectId) => {
+        const generation = (taskRequestGenerationByProjectRef.current.get(projectId) ?? 0) + 1;
+        taskRequestGenerationByProjectRef.current.set(projectId, generation);
+        taskRequestInFlightByProjectRef.current.set(projectId, generation);
         tasksRequestCountRef.current += 1;
         latestTasksProjectIdRef.current = projectId;
         const requestProjectId = projectId;
@@ -813,14 +831,29 @@ export function TaskBoardWorkspace() {
             }
             const nextTasks = result.data || [];
             setTasks(nextTasks);
+            const navigationOutcome = transitionGoalTaskNavigation({
+                type: "tasksLoaded",
+                projectId,
+                generation,
+                taskIds: nextTasks.map((task) => task.taskId),
+            });
+            if (navigationOutcome.kind === "select") {
+                setTaskSelection(navigationOutcome.taskId, { source: "user" });
+            }
+            else if (navigationOutcome.kind === "missing") {
+                toast.error("The referenced task is not available in this project");
+            }
         }
         finally {
+            if (taskRequestInFlightByProjectRef.current.get(projectId) === generation) {
+                taskRequestInFlightByProjectRef.current.delete(projectId);
+            }
             tasksRequestCountRef.current = Math.max(0, tasksRequestCountRef.current - 1);
             if (tasksRequestCountRef.current === 0) {
                 setIsTasksLoading(false);
             }
         }
-    }, []);
+    }, [setTaskSelection, transitionGoalTaskNavigation]);
     const refreshExecutionState = useCallback(async (projectId) => {
         const result = await getExecutionState({ projectId });
         if (result.type !== "success") {
@@ -832,22 +865,36 @@ export function TaskBoardWorkspace() {
         setExecutionRecordsByTaskId(indexed);
     }, []);
     const refreshGoals = useCallback(async (projectId, includeDescendants) => {
+        const generation = ++goalsRequestGenerationRef.current;
         latestGoalsProjectIdRef.current = projectId;
         setGoalsLoading(true);
+        setGoalsError(null);
         try {
             const result = await getProjectGoals(projectId, includeDescendants);
-            if (latestGoalsProjectIdRef.current !== projectId)
+            if (latestGoalsProjectIdRef.current !== projectId ||
+                generation !== goalsRequestGenerationRef.current)
                 return;
             if (result.type !== "success") {
-                toast.error(result.summary || "Failed to load goals");
+                const message = result.summary || "Failed to load goals";
+                setGoals([]);
+                setGoalCatalog([]);
+                setGoalPermissions({});
+                setGoalDisplaySpecs({});
+                setGoalStateScope({ projectId, includeDescendants });
+                setGoalsError(message);
+                toast.error(message);
                 return;
             }
             setGoals(result.data?.goals ?? []);
             setGoalCatalog(result.data?.catalog ?? []);
             setGoalPermissions(result.data?.permissions ?? {});
+            setGoalDisplaySpecs(result.data?.displaySpecs ?? {});
+            setGoalStateScope({ projectId, includeDescendants });
+            setGoalsError(null);
         }
         finally {
-            if (latestGoalsProjectIdRef.current === projectId) {
+            if (latestGoalsProjectIdRef.current === projectId &&
+                generation === goalsRequestGenerationRef.current) {
                 setGoalsLoading(false);
             }
         }
@@ -868,6 +915,14 @@ export function TaskBoardWorkspace() {
             return;
         void refreshGoals(selectedProjectId, includeGoalSubprojects);
     }, [isGoalsView, selectedProjectId, includeGoalSubprojects, refreshGoals]);
+    useEffect(() => {
+        return () => {
+            if (wsGoalRefreshTimeoutRef.current !== null) {
+                window.clearTimeout(wsGoalRefreshTimeoutRef.current);
+                wsGoalRefreshTimeoutRef.current = null;
+            }
+        };
+    }, [selectedProjectId, includeGoalSubprojects]);
     const refreshGraphLayout = useCallback(async (projectId) => {
         latestGraphLayoutProjectIdRef.current = projectId;
         const requestProjectId = projectId;
@@ -1701,7 +1756,11 @@ export function TaskBoardWorkspace() {
     useEffect(() => {
         previousTaskStatusesRef.current = {};
         previousWizardAttentionSignatureRef.current = "";
-    }, [selectedProjectId]);
+        transitionGoalTaskNavigation({
+            type: "projectSelected",
+            projectId: selectedProjectId,
+        });
+    }, [selectedProjectId, transitionGoalTaskNavigation]);
     useEffect(() => {
         if (!selectedProjectId)
             return;
@@ -1846,7 +1905,13 @@ export function TaskBoardWorkspace() {
                     !isProjectWithinSelectedTree(projectId, currentProjectId)) {
                     return;
                 }
-                refreshGoalsRef.current?.();
+                if (wsGoalRefreshTimeoutRef.current !== null) {
+                    window.clearTimeout(wsGoalRefreshTimeoutRef.current);
+                }
+                wsGoalRefreshTimeoutRef.current = window.setTimeout(() => {
+                    wsGoalRefreshTimeoutRef.current = null;
+                    refreshGoalsRef.current?.();
+                }, WS_REFRESH_DELAY_MS);
                 return;
             }
             if (messageType !== "task:updated" &&
@@ -2056,6 +2121,105 @@ export function TaskBoardWorkspace() {
         wizardNextReviewTaskId,
     ]);
     const isProjectViewLoading = !!selectedProjectId && projectViewLoadingId === selectedProjectId;
+    const goalScopeMatches = goalScopesMatch(goalStateScope, {
+        projectId: selectedProjectId ?? "",
+        includeDescendants: includeGoalSubprojects,
+    });
+    const goalProjectLabels = useMemo(() => {
+        const byId = new Map(projects.map((entry) => [entry.project.projectId, entry.project]));
+        const labels = {};
+        for (const entry of projects) {
+            const project = entry.project;
+            const titles = [];
+            const seen = new Set();
+            let cursorId = project.projectId;
+            while (cursorId && !seen.has(cursorId)) {
+                const cursor = byId.get(cursorId);
+                if (!cursor)
+                    break;
+                seen.add(cursorId);
+                titles.unshift(cursor.title);
+                cursorId = cursor.parentProjectId ?? null;
+            }
+            labels[project.projectId] = {
+                title: project.title,
+                path: titles.join(" / "),
+            };
+        }
+        return labels;
+    }, [projects]);
+    const handleGoalOpenItem = useCallback(async (ref) => {
+        if (!editContext)
+            return;
+        try {
+            const loaded = await editContext.loadItem({
+                id: ref.itemId,
+                language: ref.language ?? editContext.currentItemDescriptor?.language ?? "en",
+                version: 0,
+            });
+            if (!loaded) {
+                toast.error("The referenced item could not be opened");
+                return;
+            }
+            editContext.setShowAgentsWorkspaceEditor(true);
+        }
+        catch {
+            toast.error("The referenced item could not be opened");
+        }
+    }, [editContext]);
+    const handleGoalSelectTask = useCallback((ref) => {
+        const targetProjectId = ref.projectId ?? selectedProjectIdRef.current;
+        if (!targetProjectId)
+            return;
+        const project = projectsRef.current.find((entry) => entry.project.projectId.toLowerCase() ===
+            targetProjectId.toLowerCase());
+        if (!project) {
+            toast.error("The referenced task project is not available");
+            return;
+        }
+        const resolvedProjectId = project.project.projectId;
+        const currentProjectId = selectedProjectIdRef.current;
+        const inFlightGeneration = taskRequestInFlightByProjectRef.current.get(resolvedProjectId);
+        const latestIssued = taskRequestGenerationByProjectRef.current.get(resolvedProjectId) ?? 0;
+        const navigationOutcome = transitionGoalTaskNavigation({
+            type: "request",
+            projectId: resolvedProjectId,
+            taskId: ref.taskId,
+            currentProjectId,
+            currentTaskIds: tasksRef.current.map((task) => task.taskId),
+            inFlightGeneration,
+            latestIssuedGeneration: latestIssued,
+        });
+        if (navigationOutcome.kind === "select") {
+            setTaskSelection(navigationOutcome.taskId, { source: "user" });
+            return;
+        }
+        if (navigationOutcome.kind === "missing") {
+            toast.error("The referenced task is not available in this project");
+            return;
+        }
+        if (navigationOutcome.kind === "load") {
+            if (navigationOutcome.switchProject) {
+                handleSelectProject(navigationOutcome.projectId);
+            }
+            else if (navigationOutcome.refresh) {
+                void refreshTasks(navigationOutcome.projectId);
+            }
+        }
+    }, [
+        handleSelectProject,
+        refreshTasks,
+        setTaskSelection,
+        transitionGoalTaskNavigation,
+    ]);
+    const handleGoalTaskCreated = useCallback((projectId) => {
+        if (projectId === selectedProjectIdRef.current) {
+            void refreshVisibleTaskData();
+        }
+        else if (directSubprojectIdsRef.current.has(projectId)) {
+            void refreshSubprojectTaskCountsRef.current?.();
+        }
+    }, [refreshVisibleTaskData]);
     const taskBoardContent = useMemo(() => {
         if (isProjectViewLoading) {
             return (_jsx("div", { className: "border-border-default bg-neutral-grey-5/70 flex h-full min-h-[240px] items-center justify-center rounded-lg border border-dashed", "data-testid": "taskboard-project-loading-state", children: _jsxs("div", { className: "text-muted-foreground flex flex-col items-center gap-3 text-sm", children: [_jsx(Loader2, { strokeWidth: 1, className: "h-6 w-6 animate-spin" }), _jsx("div", { children: "Loading project..." })] }) }));
@@ -2076,7 +2240,14 @@ export function TaskBoardWorkspace() {
                             } }) })] }));
         }
         if (isGoalsView) {
-            return (_jsxs("div", { className: "flex h-full min-h-0 min-w-0 flex-col gap-3", children: [_jsx(ProjectDashboard, { projectId: selectedProjectId, selectedProjectTitle: selectedProject?.project.title ?? "No project selected", selectedProjectDescription: selectedProject?.project.description, selectedProjectCostUsed: selectedProjectCumulativeCostUsed, selectedProjectCostLimit: selectedProject?.project.costLimit ?? null, selectedProjectTaskCounts: selectedProjectTaskCounts, subprojects: directSubprojects, taskCountsByProjectId: subprojectTaskCounts, parentProjectId: parentProject?.project.projectId ?? null, parentProjectTitle: parentProject?.project.title ?? null, onSelectProject: handleSelectProject, canCreateTask: canEditTasks, onCreateTask: () => setCreateDialogOpen(true), showCreateTaskButton: false }), sharedViewSwitcher, _jsx("div", { className: "mt-3 max-w-[1000px]", children: _jsx(ProjectGoalsPanel, { goals: goals, catalog: goalCatalog, loading: goalsLoading, hasSubprojects: hasDirectSubprojects, includeDescendants: includeGoalSubprojects, onToggleIncludeDescendants: setIncludeGoalSubprojects, selectedProjectId: selectedProjectId, permissions: goalPermissions, onChanged: () => refreshGoalsRef.current?.() }) })] }));
+            return (_jsxs("div", { className: "flex h-full min-h-0 min-w-0 flex-col gap-3", children: [_jsx(ProjectDashboard, { projectId: selectedProjectId, selectedProjectTitle: selectedProject?.project.title ?? "No project selected", selectedProjectDescription: selectedProject?.project.description, selectedProjectCostUsed: selectedProjectCumulativeCostUsed, selectedProjectCostLimit: selectedProject?.project.costLimit ?? null, selectedProjectTaskCounts: selectedProjectTaskCounts, subprojects: directSubprojects, taskCountsByProjectId: subprojectTaskCounts, parentProjectId: parentProject?.project.projectId ?? null, parentProjectTitle: parentProject?.project.title ?? null, onSelectProject: handleSelectProject, canCreateTask: canEditTasks, onCreateTask: () => setCreateDialogOpen(true), showCreateTaskButton: false }), sharedViewSwitcher, _jsx("div", { className: "mt-3 min-w-0", children: _jsx(ProjectGoalsPanel, { goals: goalScopeMatches ? goals : [], catalog: goalScopeMatches ? goalCatalog : [], loading: goalsLoading || !goalScopeMatches, error: goalScopeMatches ? goalsError : null, onRetry: () => {
+                                if (selectedProjectId) {
+                                    void refreshGoals(selectedProjectId, includeGoalSubprojects);
+                                }
+                            }, hasSubprojects: hasDirectSubprojects, includeDescendants: includeGoalSubprojects, onToggleIncludeDescendants: setIncludeGoalSubprojects, selectedProjectId: selectedProjectId, permissions: goalScopeMatches ? goalPermissions : {}, goalDisplaySpecs: goalScopeMatches ? goalDisplaySpecs : {}, projectLabels: goalProjectLabels, onOpenItem: (ref) => void handleGoalOpenItem(ref), onSelectTask: handleGoalSelectTask, onTaskCreated: handleGoalTaskCreated, onChanged: () => {
+                                if (goalScopeMatches)
+                                    refreshGoalsRef.current?.();
+                            } }) })] }));
         }
         if (isKpisView) {
             return (_jsxs("div", { className: "flex h-full min-h-0 min-w-0 flex-col gap-3", children: [_jsx(ProjectDashboard, { projectId: selectedProjectId, selectedProjectTitle: selectedProject?.project.title ?? "No project selected", selectedProjectDescription: selectedProject?.project.description, selectedProjectCostUsed: selectedProjectCumulativeCostUsed, selectedProjectCostLimit: selectedProject?.project.costLimit ?? null, selectedProjectTaskCounts: selectedProjectTaskCounts, subprojects: directSubprojects, taskCountsByProjectId: subprojectTaskCounts, parentProjectId: parentProject?.project.projectId ?? null, parentProjectTitle: parentProject?.project.title ?? null, onSelectProject: handleSelectProject, canCreateTask: canEditTasks, onCreateTask: () => setCreateDialogOpen(true), showCreateTaskButton: false }), sharedViewSwitcher, _jsx("div", { className: "mt-3 max-w-[1000px]", children: _jsx(ProjectKpisPanel, { selectedProjectCostUsed: selectedProjectCumulativeCostUsed, selectedProjectCostLimit: selectedProject?.project.costLimit ?? null, selectedProjectTaskCounts: selectedProjectTaskCounts, selectedProjectAttention: selectedProject?.overview?.attention, subprojects: directSubprojects, taskCountsByProjectId: subprojectTaskCounts, attentionTaskGroups: kpiAttentionTaskGroups, attentionDetailsLoading: subprojectCountsLoading, onSelectAttentionTask: (taskId) => setTaskSelection(taskId, { source: "user" }) }) })] }));
@@ -2114,8 +2285,12 @@ export function TaskBoardWorkspace() {
         isGoalsView,
         goals,
         goalsLoading,
+        goalsError,
         goalCatalog,
         goalPermissions,
+        goalDisplaySpecs,
+        goalScopeMatches,
+        goalProjectLabels,
         includeGoalSubprojects,
         hasDirectSubprojects,
         graphLayout,
@@ -2145,7 +2320,11 @@ export function TaskBoardWorkspace() {
         wizardCommunicationPanel,
         setTaskSelection,
         refreshProjects,
+        refreshGoals,
         refreshVisibleTaskData,
+        handleGoalOpenItem,
+        handleGoalSelectTask,
+        handleGoalTaskCreated,
     ]);
     const taskDetailAgentLaunch = useMemo(() => {
         if (!selectedTask)