feat(inbox): offer AI clarify in the guided processing clarify step (#1022)

Author: dongdongbh

apps/desktop/src/components/InboxProcessingWizard.tsx

@@ -1,6 +1,6 @@
 import { memo, useEffect, useRef, useState } from 'react';
-import { ArrowRight, BookOpen, Check, CheckCircle, ChevronLeft, ClipboardList, Clock, Trash2, User, X } from 'lucide-react';
-import { DEFAULT_PROJECT_COLOR, filterProjectsBySelectedArea, formatTimeEstimateLabel, safeFormatDate, safeParseDate, tFallback, type Area, type Project, type Task, type TaskDraft, type TaskDraftSetter, type TaskPriority, type TimeEstimate } from '@mindwtr/core';
+import { ArrowRight, BookOpen, Check, CheckCircle, ChevronLeft, ClipboardList, Clock, Loader2, Sparkles, Trash2, User, X } from 'lucide-react';
+import { DEFAULT_PROJECT_COLOR, filterProjectsBySelectedArea, formatTimeEstimateLabel, safeFormatDate, safeParseDate, tFallback, type AppData, type Area, type Project, type Task, type TaskDraft, type TaskDraftSetter, type TaskPriority, type TimeEstimate } from '@mindwtr/core';
 
 import { cn } from '../lib/utils';
 import { useNativeDateInputLocale } from '../hooks/use-native-date-input-locale';
@@ -15,6 +15,8 @@ import {
     type InboxProcessingOptionLists,
     type InboxProcessingVisibility,
 } from './views/inbox/inbox-processing-utils';
+import { TaskEditorAiPanels } from './Task/TaskEditorAiPanels';
+import { useTaskItemAi } from './Task/useTaskItemAi';
 import { TokenAutocompleteInput } from './Task/TokenAutocompleteInput';
 import { AutocompleteTextInput } from './ui/AutocompleteTextInput';
 import { AreaSelector } from './ui/AreaSelector';
@@ -89,6 +91,8 @@ export type InboxProcessingWizardProps = {
     showProjectInRefine: boolean;
     scheduleFields: InboxProcessingScheduleFieldsControls;
     visibleScheduleFieldKeys: InboxProcessingScheduleFieldKey[];
+    /** Only for the AI-enabled switch behind the clarify step's assistant. */
+    settings?: AppData['settings'];
 };
 
 const PRIORITY_OPTIONS: TaskPriority[] = ['low', 'medium', 'high', 'urgent'];
@@ -158,6 +162,7 @@ export const InboxProcessingWizard = memo(function InboxProcessingWizard({
     showProjectInRefine,
     scheduleFields,
     visibleScheduleFieldKeys,
+    settings,
 }: InboxProcessingWizardProps) {
     const { nativeDateInputLocale, dateFormatSetting } = useNativeDateInputLocale();
     const {
@@ -203,6 +208,28 @@ export const InboxProcessingWizard = memo(function InboxProcessingWizard({
     const setSelectedProjectId = (value: string | null) => setField('projectId', value ?? '');
     const setSelectedAreaId = (value: string | null) => setField('areaId', value ?? '');
 
+    // The same clarify action the task editor offers, on the task being
+    // processed (#1022). Copilot stays off: the wizard makes no background AI
+    // calls, only the one the user asks for.
+    const ai = useTaskItemAi({
+        taskId: processingTask?.id ?? '',
+        settings,
+        t,
+        editTitle: draft.title,
+        editDescription: draft.description,
+        editContexts: draft.contexts,
+        editTags: draft.tags,
+        editStartTime: draft.startTime,
+        editDueDate: draft.dueDate,
+        editReviewAt: draft.reviewAt,
+        contextOptions: allContexts,
+        tagOptions: allTags,
+        projectContext: null,
+        timeEstimatesEnabled: showTimeEstimateField,
+        setField,
+        copilotEnabled: false,
+    });
+
     // After a long step is submitted the view is left scrolled to the bottom;
     // bring the panel top (title of the next task) back into view on advance.
     const panelRef = useRef<HTMLDivElement | null>(null);
@@ -396,6 +423,30 @@ export const InboxProcessingWizard = memo(function InboxProcessingWizard({
                                 />
                             </div>
                         )}
+                        {ai.aiEnabled && (
+                            <div className="flex flex-col gap-2 text-xs">
+                                <div className="flex items-center gap-2">
+                                    <button
+                                        type="button"
+                                        onClick={ai.handleAIClarify}
+                                        disabled={ai.isAIWorking}
+                                        aria-busy={ai.isAIWorking}
+                                        className="inline-flex items-center gap-1.5 rounded-md px-2 py-1 font-medium text-muted-foreground transition-colors hover:bg-muted hover:text-foreground disabled:cursor-not-allowed disabled:opacity-60"
+                                    >
+                                        {ai.isAIWorking
+                                            ? <Loader2 className="h-3.5 w-3.5 animate-spin" />
+                                            : <Sparkles className="h-3.5 w-3.5" />}
+                                        {t('taskEdit.aiClarify')}
+                                    </button>
+                                    {ai.isAIWorking && (
+                                        <span role="status" aria-live="polite" className="text-muted-foreground">
+                                            {tFallback(t, 'ai.working', 'Working...')}
+                                        </span>
+                                    )}
+                                </div>
+                                <TaskEditorAiPanels ai={ai} timeEstimatesEnabled={showTimeEstimateField} t={t} />
+                            </div>
+                        )}
                     </div>
                 </div>
             ) : null}

apps/desktop/src/components/views/InboxProcessor.test.tsx

@@ -1068,4 +1068,22 @@ describe('InboxProcessor', () => {
         const [, updates] = updateTask.mock.calls[updateTask.mock.calls.length - 1] as [string, Task];
         expect(updates.description).toBeUndefined();
     });
+
+    it('offers AI clarify in the guided refine step when AI is on (#1022)', () => {
+        const { getByRole } = renderInboxProcessor({
+            settings: { ai: { enabled: true, provider: 'openai' } },
+        });
+
+        fireEvent.click(getByRole('button', { name: /process\.btn/i }));
+
+        expect(getByRole('button', { name: 'taskEdit.aiClarify' })).toBeInTheDocument();
+    });
+
+    it('leaves the refine step free of AI actions when AI is off', () => {
+        const { getByRole, queryByRole } = renderInboxProcessor();
+
+        fireEvent.click(getByRole('button', { name: /process\.btn/i }));
+
+        expect(queryByRole('button', { name: 'taskEdit.aiClarify' })).not.toBeInTheDocument();
+    });
 });

apps/desktop/src/components/views/inbox/useInboxProcessingController.ts

@@ -873,6 +873,7 @@ export function useInboxProcessingController({
         showProjectInRefine: projectFirst && showProjectStep,
         scheduleFields,
         visibleScheduleFieldKeys,
+        settings,
     };
 
     return {

docs/release-notes/unreleased.md

@@ -14,6 +14,7 @@ Changes collected after `v1.1.6` and before the next version tag.
 - Recurrence: completing a repeating task late no longer creates a next copy whose start date sits after its own due date — start, due, and review dates now move forward together, keeping the gaps you set between them, and the new copy is never already overdue the moment it appears. Desktop and mobile.
 - Task editor: the Person field now appears automatically while a task is edited as Waiting For, so an existing task can be assigned to someone without first customizing the editor layout. Desktop and mobile. (#1021)
 - AI Copilot: suggestions now apply one piece at a time — tap the suggested context, time estimate, or any tag on its own, or apply all of them at once. Works in the task editor, the desktop list's add-task row, and mobile quick capture. (#1022)
+- Process Inbox: the guided clarify step now offers the AI clarify action when the AI assistant is switched on. Desktop. (#1022)
 
 - Calendar: a task with a start date but no time now shows "All day" in the desktop month grid and the mobile schedule list, instead of a phantom midnight time (shown as "12:00" on 12-hour clocks).
 - Desktop: attachment links pointing at a folder (for example `D:\Media\Movies\`) now open in the file manager instead of failing with "Path is outside Mindwtr-managed locations". Links to files anywhere already worked; folders now match.