import { useState, useEffect, useCallback, useRef } from "react"; import { Globe, Folder } from "lucide-react"; import { THINKING_LEVELS, GLOBAL_SETTINGS_KEYS, PROJECT_SETTINGS_KEYS } from "@fusion/core"; import type { Settings, GlobalSettings, ThemeMode, ColorTheme, ModelPreset, NtfyNotificationEvent } from "@fusion/core"; import { fetchSettings, updateSettings, updateGlobalSettings, fetchAuthStatus, loginProvider, logoutProvider, saveApiKey, clearApiKey, fetchModels, testNtfyNotification, fetchBackups, createBackup, exportSettings, importSettings, fetchMemory, saveMemory } from "../api"; import type { AuthProvider, ModelInfo, BackupListResponse, SettingsExportData } from "../api"; import type { ToastType } from "../hooks/useToast"; import { ThemeSelector } from "./ThemeSelector"; import { CustomModelDropdown } from "./CustomModelDropdown"; import { FileEditor } from "./FileEditor"; import { PluginManager } from "./PluginManager"; import { applyPresetToSelection, generateUniquePresetId } from "../utils/modelPresets"; /** * Settings sections configuration. * * Each section groups related settings fields under a sidebar nav item. * Sections have a `scope` to indicate where their settings are stored: * - "global": User-level settings stored in ~/.pi/fusion/settings.json (shared across projects) * - "project": Project-specific settings stored in .fusion/config.json * - "mixed": Section contains both global and project settings (rendered specially) * - undefined: Section operates independently of settings storage (e.g. authentication) * * To add a new section: * 1. Add an entry to SETTINGS_SECTIONS with a unique id, label, and scope * 2. Add a corresponding case in renderSectionFields() * * Sections: * - general: Task prefix configuration (project) * - models: Mixed scope — default/fallback models (global), planning & validator models, * model presets, and AI summarization (project). Rendered as sub-sections on one screen. * The sidebar shows both global and project icons for this section. * - appearance: Theme and color settings (global) * - scheduling: Concurrency, poll interval, file overlap serialization, and step execution * settings (runStepsInNewSessions, maxParallelSteps) (project) * - worktrees: Worktree limits, init commands, recycling (project) * - commands: Test and build command configuration (project) * - merge: Auto-merge settings (project) * - notifications: ntfy.sh notification settings (global) * - authentication: OAuth provider status, login/logout (independent) */ /** Section entry type with optional icon */ type SettingsSection = { id: string; label: string; scope: "global" | "project" | "mixed" | undefined; icon?: typeof Globe; }; const SETTINGS_SECTIONS: SettingsSection[] = [ { id: "authentication", label: "Authentication", scope: undefined, icon: Globe }, { id: "appearance", label: "Appearance", scope: "global" }, { id: "notifications", label: "Notifications", scope: "global" }, { id: "general", label: "General", scope: "project" }, { id: "models", label: "Models", scope: "mixed" }, { id: "scheduling", label: "Scheduling", scope: "project" }, { id: "worktrees", label: "Worktrees", scope: "project" }, { id: "commands", label: "Commands", scope: "project" }, { id: "merge", label: "Merge", scope: "project" }, { id: "memory", label: "Memory", scope: "project" }, { id: "backups", label: "Backups", scope: "project" }, { id: "plugins", label: "Plugins", scope: "project" }, ]; export type SectionId = SettingsSection["id"]; interface SettingsModalProps { onClose: () => void; addToast: (message: string, type?: ToastType) => void; projectId?: string; /** Optional section to show when the modal first opens. Defaults to "general". */ initialSection?: SectionId; /** Current theme mode */ themeMode?: ThemeMode; /** Current color theme */ colorTheme?: ColorTheme; /** Called when theme mode changes */ onThemeModeChange?: (mode: ThemeMode) => void; /** Called when color theme changes */ onColorThemeChange?: (theme: ColorTheme) => void; } export function SettingsModal({ onClose, addToast, projectId, initialSection, themeMode = "dark", colorTheme = "default", onThemeModeChange, onColorThemeChange, }: SettingsModalProps) { const [form, setForm] = useState({ maxConcurrent: 2, maxWorktrees: 4, pollIntervalMs: 15000, groupOverlappingFiles: true, autoMerge: true, mergeStrategy: "direct", recycleWorktrees: false, worktreeNaming: "random", includeTaskIdInCommit: true, worktreeInitCommand: "", ntfyEnabled: false, ntfyTopic: undefined }); const [loading, setLoading] = useState(true); const [activeSection, setActiveSection] = useState(initialSection ?? SETTINGS_SECTIONS[0].id); const [prefixError, setPrefixError] = useState(null); /** Get the scope of the currently active section */ const activeSectionScope = SETTINGS_SECTIONS.find((s) => s.id === activeSection)?.scope; // Auth state (independent of the settings save flow) const [authProviders, setAuthProviders] = useState([]); const [authLoading, setAuthLoading] = useState(false); const [authActionInProgress, setAuthActionInProgress] = useState(null); const [apiKeyInputs, setApiKeyInputs] = useState>({}); const [apiKeyErrors, setApiKeyErrors] = useState>({}); const pollIntervalRef = useRef | null>(null); // Model state const [availableModels, setAvailableModels] = useState([]); const [modelsLoading, setModelsLoading] = useState(false); const [favoriteProviders, setFavoriteProviders] = useState([]); const [favoriteModels, setFavoriteModels] = useState([]); // Test notification state const [testNotificationLoading, setTestNotificationLoading] = useState(false); const [editingPresetId, setEditingPresetId] = useState(null); const [presetDraft, setPresetDraft] = useState(null); // Backup state const [backupInfo, setBackupInfo] = useState(null); const [backupLoading, setBackupLoading] = useState(false); // Project memory state const [memoryContent, setMemoryContent] = useState(""); const [memoryLoading, setMemoryLoading] = useState(false); const [memoryDirty, setMemoryDirty] = useState(false); // Import/Export state const [importDialogOpen, setImportDialogOpen] = useState(false); const [importFile, setImportFile] = useState(null); const [importPreview, setImportPreview] = useState(null); const [importLoading, setImportLoading] = useState(false); const [importScope, setImportScope] = useState<'global' | 'project' | 'both'>('both'); const [importMerge, setImportMerge] = useState(true); const fileInputRef = useRef(null); useEffect(() => { fetchSettings(projectId) .then((s) => { setForm(s); setLoading(false); }) .catch((err) => { addToast(err.message, "error"); setLoading(false); }); }, [addToast, projectId]); // Load auth status when the authentication section is active const loadAuthStatus = useCallback(async () => { try { const { providers } = await fetchAuthStatus(); setAuthProviders(providers); } catch { // Silently fail — auth may not be configured } }, []); useEffect(() => { if (activeSection === "models") { setModelsLoading(true); fetchModels() .then((response) => { setAvailableModels(response.models); setFavoriteProviders(response.favoriteProviders); setFavoriteModels(response.favoriteModels); }) .catch(() => setAvailableModels([])) .finally(() => setModelsLoading(false)); } }, [activeSection]); useEffect(() => { if (activeSection === "backups") { setBackupLoading(true); fetchBackups(projectId) .then((info) => setBackupInfo(info)) .catch(() => setBackupInfo(null)) .finally(() => setBackupLoading(false)); } }, [activeSection, projectId]); useEffect(() => { if (activeSection !== "memory" || memoryDirty) { return; } let cancelled = false; setMemoryLoading(true); fetchMemory(projectId) .then(({ content }) => { if (cancelled) return; setMemoryContent(content); setMemoryDirty(false); }) .catch((err: any) => { if (cancelled) return; addToast(err?.message || "Failed to load project memory", "error"); setMemoryContent(""); }) .finally(() => { if (!cancelled) { setMemoryLoading(false); } }); return () => { cancelled = true; }; }, [activeSection, memoryDirty, projectId, addToast]); useEffect(() => { if (activeSection === "authentication") { setAuthLoading(true); loadAuthStatus().finally(() => setAuthLoading(false)); } // Clean up polling when leaving auth section return () => { if (pollIntervalRef.current) { clearInterval(pollIntervalRef.current); pollIntervalRef.current = null; } }; }, [activeSection, loadAuthStatus]); const handleLogin = useCallback(async (providerId: string) => { setAuthActionInProgress(providerId); try { const { url } = await loginProvider(providerId); window.open(url, "_blank"); // Poll for auth completion every 2 seconds pollIntervalRef.current = setInterval(async () => { try { const { providers } = await fetchAuthStatus(); setAuthProviders(providers); const provider = providers.find((p) => p.id === providerId); if (provider?.authenticated) { if (pollIntervalRef.current) { clearInterval(pollIntervalRef.current); pollIntervalRef.current = null; } setAuthActionInProgress(null); addToast("Login successful", "success"); } } catch { // Continue polling on transient errors } }, 2000); } catch (err: any) { addToast(err.message || "Login failed", "error"); setAuthActionInProgress(null); } }, [addToast]); const handleLogout = useCallback(async (providerId: string) => { setAuthActionInProgress(providerId); try { await logoutProvider(providerId); await loadAuthStatus(); addToast("Logged out", "success"); } catch (err: any) { addToast(err.message || "Logout failed", "error"); } finally { setAuthActionInProgress(null); } }, [addToast, loadAuthStatus]); const handleSaveApiKey = useCallback(async (providerId: string) => { const key = apiKeyInputs[providerId]?.trim(); if (!key) { setApiKeyErrors((prev) => ({ ...prev, [providerId]: "API key is required" })); return; } setAuthActionInProgress(providerId); setApiKeyErrors((prev) => { const next = { ...prev }; delete next[providerId]; return next; }); try { await saveApiKey(providerId, key); setApiKeyInputs((prev) => { const next = { ...prev }; delete next[providerId]; return next; }); await loadAuthStatus(); addToast("API key saved", "success"); } catch (err: any) { setApiKeyErrors((prev) => ({ ...prev, [providerId]: err.message || "Failed to save API key" })); } finally { setAuthActionInProgress(null); } }, [apiKeyInputs, addToast, loadAuthStatus]); const handleClearApiKey = useCallback(async (providerId: string) => { setAuthActionInProgress(providerId); try { await clearApiKey(providerId); setApiKeyInputs((prev) => { const next = { ...prev }; delete next[providerId]; return next; }); setApiKeyErrors((prev) => { const next = { ...prev }; delete next[providerId]; return next; }); await loadAuthStatus(); addToast("API key cleared", "success"); } catch (err: any) { addToast(err.message || "Failed to clear API key", "error"); } finally { setAuthActionInProgress(null); } }, [addToast, loadAuthStatus]); const handleTestNotification = useCallback(async () => { // Validate ntfy is enabled and topic is valid if (!form.ntfyEnabled || !form.ntfyTopic || !/^[a-zA-Z0-9_-]{1,64}$/.test(form.ntfyTopic)) { return; } setTestNotificationLoading(true); try { const result = await testNtfyNotification({ ntfyEnabled: form.ntfyEnabled, ntfyTopic: form.ntfyTopic, }, projectId); if (result.success) { addToast("Test notification sent — check your ntfy app!", "success"); } else { addToast("Failed to send test notification", "error"); } } catch (err: any) { addToast(err.message || "Failed to send test notification", "error"); } finally { setTestNotificationLoading(false); } }, [addToast, form.ntfyEnabled, form.ntfyTopic, projectId]); const handleBackupNow = useCallback(async () => { setBackupLoading(true); try { const result = await createBackup(projectId); if (result.success) { addToast("Backup created successfully", "success"); // Refresh backup list const info = await fetchBackups(projectId); setBackupInfo(info); } else { addToast(result.error || "Failed to create backup", "error"); } } catch (err: any) { addToast(err.message || "Failed to create backup", "error"); } finally { setBackupLoading(false); } }, [addToast, projectId]); // Export/Import handlers const handleExport = useCallback(async () => { try { // Default scope based on active section const scope = activeSectionScope === "global" ? "global" : activeSectionScope === "project" ? "project" : "both"; const data = await exportSettings(scope, projectId); // Create and download the JSON file const blob = new Blob([JSON.stringify(data, null, 2)], { type: "application/json" }); const url = URL.createObjectURL(blob); const link = document.createElement("a"); const filename = `fusion-settings-${new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19)}.json`; link.href = url; link.download = filename; document.body.appendChild(link); link.click(); document.body.removeChild(link); URL.revokeObjectURL(url); const scopeLabel = scope === "global" ? "global" : scope === "project" ? "project" : "all"; addToast(`Settings exported (${scopeLabel} scope)`, "success"); } catch (err: any) { addToast(err.message || "Failed to export settings", "error"); } }, [addToast, activeSectionScope, projectId]); const handleFileSelect = useCallback(async (e: React.ChangeEvent) => { const file = e.target.files?.[0]; if (!file) return; setImportFile(file); setImportLoading(true); try { const text = await file.text(); const data = JSON.parse(text) as SettingsExportData; setImportPreview(data); setImportDialogOpen(true); } catch (err: any) { addToast(`Invalid JSON file: ${err.message}`, "error"); setImportFile(null); } finally { setImportLoading(false); } }, [addToast]); const handleImport = useCallback(async () => { if (!importPreview) return; setImportLoading(true); try { const result = await importSettings(importPreview, { scope: importScope, merge: importMerge }, projectId); if (result.success) { const parts: string[] = []; if (result.globalCount > 0) parts.push(`${result.globalCount} global`); if (result.projectCount > 0) parts.push(`${result.projectCount} project`); addToast(`Imported ${parts.join(", ")} setting(s)`, "success"); setImportDialogOpen(false); setImportPreview(null); setImportFile(null); // Refresh settings to show imported values const refreshed = await fetchSettings(projectId); setForm(refreshed); } else { addToast(result.error || "Import failed", "error"); } } catch (err: any) { addToast(err.message || "Failed to import settings", "error"); } finally { setImportLoading(false); } }, [addToast, importPreview, importScope, importMerge, projectId]); const handleToggleFavorite = useCallback(async (provider: string) => { const currentFavorites = favoriteProviders; const isFavorite = currentFavorites.includes(provider); const newFavorites = isFavorite ? currentFavorites.filter((p) => p !== provider) : [provider, ...currentFavorites]; setFavoriteProviders(newFavorites); try { await updateGlobalSettings({ favoriteProviders: newFavorites, favoriteModels }); } catch { setFavoriteProviders(currentFavorites); } }, [favoriteProviders, favoriteModels]); const handleToggleModelFavorite = useCallback(async (modelId: string) => { const currentFavorites = favoriteModels; const isFavorite = currentFavorites.includes(modelId); const newFavorites = isFavorite ? currentFavorites.filter((m) => m !== modelId) : [modelId, ...currentFavorites]; setFavoriteModels(newFavorites); try { await updateGlobalSettings({ favoriteProviders, favoriteModels: newFavorites }); } catch { setFavoriteModels(currentFavorites); } }, [favoriteModels, favoriteProviders]); useEffect(() => { const handleKey = (e: KeyboardEvent) => { if (e.key === "Escape") onClose(); }; document.addEventListener("keydown", handleKey); return () => document.removeEventListener("keydown", handleKey); }, [onClose]); const handleOverlayClick = useCallback( (e: React.MouseEvent) => { if (e.target === e.currentTarget) onClose(); }, [onClose], ); const handleSave = useCallback(async () => { if (prefixError || presetDraft) return; try { const payload = { ...form, worktreeInitCommand: form.worktreeInitCommand?.trim() || undefined, taskPrefix: form.taskPrefix?.trim() || undefined, }; // Always save both global and project settings. // The backend filters each appropriately (updateSettings ignores global keys, // updateGlobalSettings ignores project keys). This ensures fields in sections // are persisted correctly based on their scope. const globalKeySet = new Set(GLOBAL_SETTINGS_KEYS); const globalPatch: Partial = {}; for (const [key, value] of Object.entries(payload)) { if (globalKeySet.has(key)) { (globalPatch as any)[key] = value; } } const projectKeySet = new Set(PROJECT_SETTINGS_KEYS as readonly string[]); const projectPatch: Partial = {}; for (const [key, value] of Object.entries(payload)) { if (key === "githubTokenConfigured") continue; // server-only field if (projectKeySet.has(key)) { (projectPatch as any)[key] = value; } } // Save both scopes in parallel if they have changes. // Note: themeMode/colorTheme may also be write-through via useTheme callbacks // in the Appearance section; duplicate global writes are intentional/idempotent, // while this save path persists the full settings form in one action. await Promise.all([ Object.keys(globalPatch).length > 0 ? updateGlobalSettings(globalPatch) : Promise.resolve(), Object.keys(projectPatch).length > 0 ? updateSettings(projectPatch, projectId) : Promise.resolve(), ]); addToast("Settings saved", "success"); onClose(); } catch (err: any) { addToast(err.message, "error"); } }, [form, prefixError, presetDraft, onClose, addToast, projectId]); const handleSaveMemory = useCallback(async () => { try { await saveMemory(memoryContent, projectId); setMemoryDirty(false); addToast("Memory saved", "success"); } catch (err: any) { addToast(err?.message || "Failed to save memory", "error"); } }, [memoryContent, projectId, addToast]); const savePresetDraft = () => { if (!presetDraft) return; const nextName = presetDraft.name.trim(); if (!nextName) { addToast("Preset name is required", "error"); return; } const presets = form.modelPresets || []; // For new presets, generate unique ID from name; for edits, keep existing ID let nextId: string; if (editingPresetId) { nextId = editingPresetId; } else { nextId = generateUniquePresetId(nextName, presets); } const normalizedDraft: ModelPreset = { id: nextId, name: nextName, executorProvider: presetDraft.executorProvider, executorModelId: presetDraft.executorModelId, validatorProvider: presetDraft.validatorProvider, validatorModelId: presetDraft.validatorModelId, }; setForm((current) => { const existing = current.modelPresets || []; const nextPresets = editingPresetId ? existing.map((preset) => (preset.id === editingPresetId ? normalizedDraft : preset)) : [...existing, normalizedDraft]; return { ...current, modelPresets: nextPresets }; }); setEditingPresetId(null); setPresetDraft(null); }; /** Render a scope indicator banner for the current section with theme-aware Lucide icons */ const renderScopeBanner = () => { if (activeSectionScope === "global") { return (
These settings are shared across all your Fusion projects.
); } if (activeSectionScope === "project") { return (
These settings only affect this project.
); } if (activeSectionScope === "mixed") { return (
This section contains both global settings (default & fallback models) and project settings (planning, validator, presets, and AI summarization).
); } return null; }; const renderSectionFields = () => { switch (activeSection) { case "general": return ( <> {renderScopeBanner()}

General

{ const val = e.target.value; setForm((f) => ({ ...f, taskPrefix: val || undefined })); if (val && !/^[A-Z]{1,10}$/.test(val)) { setPrefixError("Prefix must be 1–10 uppercase letters"); } else { setPrefixError(null); } }} /> {prefixError && {prefixError}} {!prefixError && Prefix for new task IDs (e.g. KB, PROJ)}
When enabled, AI-generated task specifications require manual approval before moving to Todo
); case "models": { const selectedValue = form.defaultProvider && form.defaultModelId ? `${form.defaultProvider}/${form.defaultModelId}` : ""; const planningValue = form.planningProvider && form.planningModelId ? `${form.planningProvider}/${form.planningModelId}` : ""; const validatorValue = form.validatorProvider && form.validatorModelId ? `${form.validatorProvider}/${form.validatorModelId}` : ""; const presets = form.modelPresets || []; const presetOptions = presets.map((preset) => ({ id: preset.id, name: preset.name })); const inUsePresetIds = new Set(Object.values(form.defaultPresetBySize || {}).filter(Boolean)); return ( <> {renderScopeBanner()} {/* --- Default Model --- */}

Default Model

🌐 Default model is shared across all projects. {modelsLoading ? (
Loading available models…
) : availableModels.length === 0 ? (
No models available. Configure authentication first.
) : ( <>
{ if (!val) { setForm((f) => ({ ...f, defaultProvider: undefined, defaultModelId: undefined })); } else { const slashIdx = val.indexOf("/"); setForm((f) => ({ ...f, defaultProvider: val.slice(0, slashIdx), defaultModelId: val.slice(slashIdx + 1), })); } }} placeholder="Use default" favoriteProviders={favoriteProviders} onToggleFavorite={handleToggleFavorite} favoriteModels={favoriteModels} onToggleModelFavorite={handleToggleModelFavorite} /> Default AI model used for task execution when no per-task override is set. "Use default" lets the engine choose automatically.
{ if (!val) { setForm((f) => ({ ...f, fallbackProvider: undefined, fallbackModelId: undefined })); } else { const slashIdx = val.indexOf("/"); setForm((f) => ({ ...f, fallbackProvider: val.slice(0, slashIdx), fallbackModelId: val.slice(slashIdx + 1), })); } }} placeholder="No fallback" favoriteProviders={favoriteProviders} onToggleFavorite={handleToggleFavorite} favoriteModels={favoriteModels} onToggleModelFavorite={handleToggleModelFavorite} /> Used automatically if the primary default model hits a retryable provider error like rate limiting or overload.
)} {(() => { const selectedModel = availableModels.find( (m) => m.provider === form.defaultProvider && m.id === form.defaultModelId, ); if (selectedModel && !selectedModel.reasoning) return null; return (
Controls how much reasoning effort the AI model uses. Higher levels produce better results but cost more.
); })()}
{ const val = e.target.value; setForm((f) => ({ ...f, tokenCap: val ? parseInt(val, 10) : null } as any)); }} /> {(form as any).tokenCap != null && ( )}
Automatically compact context when approaching this token count. Leave empty for no cap (compact only on overflow errors). Set a number to proactively compact when reaching this token count.
{/* --- Planning & Validation --- */}

Planning & Validation

{modelsLoading ? (
Loading available models…
) : availableModels.length === 0 ? (
No models available. Configure authentication first.
) : ( <>
{ if (!val) { setForm((f) => ({ ...f, planningProvider: undefined, planningModelId: undefined })); } else { const slashIdx = val.indexOf("/"); setForm((f) => ({ ...f, planningProvider: val.slice(0, slashIdx), planningModelId: val.slice(slashIdx + 1), })); } }} placeholder="Use default" favoriteProviders={favoriteProviders} onToggleFavorite={handleToggleFavorite} favoriteModels={favoriteModels} onToggleModelFavorite={handleToggleModelFavorite} /> AI model used for task planning and specification (triage). Falls back to Default Model when not set.
{ if (!val) { setForm((f) => ({ ...f, planningFallbackProvider: undefined, planningFallbackModelId: undefined })); } else { const slashIdx = val.indexOf("/"); setForm((f) => ({ ...f, planningFallbackProvider: val.slice(0, slashIdx), planningFallbackModelId: val.slice(slashIdx + 1), })); } }} placeholder="Use global fallback" favoriteProviders={favoriteProviders} onToggleFavorite={handleToggleFavorite} favoriteModels={favoriteModels} onToggleModelFavorite={handleToggleModelFavorite} /> Used if the planning model fails due to rate limits or provider overload. Defaults to the global fallback model.
{ if (!val) { setForm((f) => ({ ...f, validatorProvider: undefined, validatorModelId: undefined })); } else { const slashIdx = val.indexOf("/"); setForm((f) => ({ ...f, validatorProvider: val.slice(0, slashIdx), validatorModelId: val.slice(slashIdx + 1), })); } }} placeholder="Use default" favoriteProviders={favoriteProviders} onToggleFavorite={handleToggleFavorite} favoriteModels={favoriteModels} onToggleModelFavorite={handleToggleModelFavorite} /> AI model used for code and specification review. Falls back to Default Model when not set.
{ if (!val) { setForm((f) => ({ ...f, validatorFallbackProvider: undefined, validatorFallbackModelId: undefined })); } else { const slashIdx = val.indexOf("/"); setForm((f) => ({ ...f, validatorFallbackProvider: val.slice(0, slashIdx), validatorFallbackModelId: val.slice(slashIdx + 1), })); } }} placeholder="Use global fallback" favoriteProviders={favoriteProviders} onToggleFavorite={handleToggleFavorite} favoriteModels={favoriteModels} onToggleModelFavorite={handleToggleModelFavorite} /> Used if the validator model fails due to rate limits or provider overload. Defaults to the global fallback model.
)} {/* --- Model Presets --- */}

Model Presets

{presets.length === 0 ? (
No presets configured yet.
) : (
{presets.map((preset) => { const selection = applyPresetToSelection(preset); const summary = `${selection.executorValue || "default"} / ${selection.validatorValue || "default"}`; return (
{preset.name} {summary}
); })}
)} {!presetDraft ? ( ) : null}
{presetDraft ? (
{ const name = e.target.value; setPresetDraft((current) => current ? { ...current, name } : current); }} />
{availableModels.length === 0 ? ( No models available. Configure authentication first. ) : ( <>
{ if (!val) { setPresetDraft((current) => current ? { ...current, executorProvider: undefined, executorModelId: undefined } : current); return; } const slashIdx = val.indexOf("/"); setPresetDraft((current) => current ? { ...current, executorProvider: val.slice(0, slashIdx), executorModelId: val.slice(slashIdx + 1), } : current); }} placeholder="Use default" favoriteProviders={favoriteProviders} onToggleFavorite={handleToggleFavorite} favoriteModels={favoriteModels} onToggleModelFavorite={handleToggleModelFavorite} />
{ if (!val) { setPresetDraft((current) => current ? { ...current, validatorProvider: undefined, validatorModelId: undefined } : current); return; } const slashIdx = val.indexOf("/"); setPresetDraft((current) => current ? { ...current, validatorProvider: val.slice(0, slashIdx), validatorModelId: val.slice(slashIdx + 1), } : current); }} placeholder="Use default" favoriteProviders={favoriteProviders} onToggleFavorite={handleToggleFavorite} favoriteModels={favoriteModels} onToggleModelFavorite={handleToggleModelFavorite} />
)}
) : null}
{form.autoSelectModelPreset ? ( <> {(["S", "M", "L"] as const).map((sizeKey) => (
))} ) : null} {/* --- OpenRouter Model Sync --- */}

OpenRouter Models

When enabled, the dashboard fetches the latest available models from the OpenRouter API on startup, so the model picker always shows the most up-to-date catalog. Disable to skip the initial API call and use only the built-in model list.
{/* --- AI Summarization --- */}

AI Summarization

When enabled, tasks created without a title but with descriptions over 200 characters will automatically get an AI-generated title (max 60 characters).
{(form.autoSummarizeTitles || false) && ( <>
{modelsLoading ? ( Loading available models... ) : availableModels.length === 0 ? ( No models available. Configure authentication first. ) : ( { if (!val) { setForm((f) => ({ ...f, titleSummarizerProvider: undefined, titleSummarizerModelId: undefined, })); return; } const slashIdx = val.indexOf("/"); setForm((f) => ({ ...f, titleSummarizerProvider: val.slice(0, slashIdx), titleSummarizerModelId: val.slice(slashIdx + 1), })); }} placeholder="Use fallback model" favoriteProviders={favoriteProviders} onToggleFavorite={handleToggleFavorite} favoriteModels={favoriteModels} onToggleModelFavorite={handleToggleModelFavorite} /> )} {form.titleSummarizerProvider && form.titleSummarizerModelId ? "Using explicitly configured model" : form.planningProvider && form.planningModelId ? "(using planning model)" : form.defaultProvider && form.defaultModelId ? "(using default model)" : "(using automatic model selection)"}
)} ); } case "appearance": return ( <> {renderScopeBanner()}

Appearance

{ setForm((f) => ({ ...f, themeMode: mode })); onThemeModeChange?.(mode); }} onColorThemeChange={(theme) => { setForm((f) => ({ ...f, colorTheme: theme })); onColorThemeChange?.(theme); }} /> ); case "scheduling": return ( <> {renderScopeBanner()}

Scheduling

setForm((f) => ({ ...f, maxConcurrent: Number(e.target.value) })) } />
setForm((f) => ({ ...f, pollIntervalMs: Number(e.target.value) })) } />
{ const val = e.target.value; const num = Number(val); setForm((f) => ({ ...f, taskStuckTimeoutMs: val && num > 0 ? num * 60000 : undefined })); }} /> Timeout in minutes for detecting stuck tasks. When a task's agent session shows no activity for longer than this duration, the task is terminated and retried. Leave empty to disable. Suggested: 10.
{ const val = e.target.value; const num = Number(val); setForm((f) => ({ ...f, maxStuckKills: val && num > 0 ? num : undefined })); }} /> Maximum stuck-detector retries before a task is marked failed. Default: 6.
When enabled, tasks that modify the same files are queued serially to avoid merge conflicts
Step Execution
Run each task step in its own fresh agent session for better isolation and error recovery. Failed steps can be retried individually.
setForm((f) => ({ ...f, maxParallelSteps: Number(e.target.value) })) } disabled={!form.runStepsInNewSessions} /> Maximum number of steps to run in parallel when file scopes don't overlap (1-4)
); case "worktrees": return ( <> {renderScopeBanner()}

Worktrees

setForm((f) => ({ ...f, maxWorktrees: Number(e.target.value) })) } /> Limits total git worktrees including in-review tasks
setForm((f) => ({ ...f, worktreeInitCommand: e.target.value })) } /> Shell command to run in each new worktree after creation
When enabled, completed task worktrees are returned to an idle pool instead of being deleted, preserving build caches for faster startup
{form.recycleWorktrees ? "Naming style is not applicable when recycling worktrees — pooled worktrees retain their existing names" : "How to name fresh worktree directories. Only applies when recycling is off."}
); case "commands": return ( <> {renderScopeBanner()}

Commands

setForm((f) => ({ ...f, testCommand: e.target.value || undefined })) } /> Command used to run tests — injected into generated task specs
setForm((f) => ({ ...f, buildCommand: e.target.value || undefined })) } /> Command used to build the project — injected into generated task specs
); case "merge": return ( <> {renderScopeBanner()}

Merge

When enabled, tasks that pass review are automatically merged into the main branch
Controls what happens after a task reaches In Review. Direct mode preserves Fusion's current local squash-merge behavior. Pull request mode keeps the task in In Review while Fusion waits for GitHub reviews and required checks before merging the PR.
When disabled, merge commit messages omit the task ID from the scope (e.g. feat: ... instead of feat(KB-001): ...)
When enabled, lock files (package-lock.json, pnpm-lock.yaml, etc.), generated files (dist/*, *.gen.ts), and trivial whitespace conflicts are resolved automatically without AI intervention. Complex code conflicts still require AI review.
When enabled, lock files (package-lock.json, pnpm-lock.yaml, etc.) are resolved using 'ours' strategy, generated files (dist/*, *.gen.ts) using 'theirs' strategy, and trivial whitespace conflicts are auto-resolved without spawning an AI agent. Complex code conflicts still require AI review.
); case "memory": return ( <> {renderScopeBanner()}

Memory

When enabled, agents will consult and update .fusion/memory.md with durable project learnings
This file stores durable project learnings that agents consult during triage and execution.
{form.memoryEnabled === false && (
Memory is currently disabled. You can view the file, but editing is read-only until memory is re-enabled.
)} {memoryLoading ? (
Loading memory…
) : (
{ setMemoryContent(content); setMemoryDirty(true); }} readOnly={form.memoryEnabled === false} filePath=".fusion/memory.md" />
)} {memoryDirty && (
)} ); case "backups": return ( <> {renderScopeBanner()}

Database Backups

When enabled, the database is backed up automatically on a schedule
setForm((f) => ({ ...f, autoBackupSchedule: e.target.value })) } disabled={!form.autoBackupEnabled} /> Cron expression for backup timing. Default: 0 2 * * * (daily at 2 AM). Examples: 0 * * * * (hourly), 0 0 * * 0 (weekly), */15 * * * * (every 15 min) {form.autoBackupSchedule && !/^[\s\d*,/-]+$/.test(form.autoBackupSchedule) && ( Invalid cron expression format )}
setForm((f) => ({ ...f, autoBackupRetention: Number(e.target.value) })) } disabled={!form.autoBackupEnabled} /> Number of backup files to keep (oldest are deleted first). Range: 1-100. {form.autoBackupRetention !== undefined && (form.autoBackupRetention < 1 || form.autoBackupRetention > 100) && ( Must be between 1 and 100 )}
setForm((f) => ({ ...f, autoBackupDir: e.target.value })) } disabled={!form.autoBackupEnabled} /> Directory for backup files, relative to project root {form.autoBackupDir && form.autoBackupDir.includes("..") && ( Path cannot contain parent directory traversal (..) )}
{backupLoading ? (
Loading backup info…
) : backupInfo ? (
{backupInfo.count} backups
{backupInfo.totalSize > 1024 * 1024 ? `${(backupInfo.totalSize / (1024 * 1024)).toFixed(1)} MB` : `${(backupInfo.totalSize / 1024).toFixed(1)} KB`} total size
{backupInfo.backups.length > 0 && (
View {backupInfo.backups.length} backup(s)
    {backupInfo.backups.slice(0, 10).map((backup) => (
  • {backup.filename} {backup.size > 1024 * 1024 ? `${(backup.size / (1024 * 1024)).toFixed(1)} MB` : `${(backup.size / 1024).toFixed(1)} KB`}
  • ))} {backupInfo.backups.length > 10 && (
  • ...and {backupInfo.backups.length - 10} more
  • )}
)}
) : null}
); case "notifications": return ( <> {renderScopeBanner()}

Notifications

Receive push notifications when tasks complete or fail via ntfy.sh
{form.ntfyEnabled && ( <>
{ const val = e.target.value; setForm((f) => ({ ...f, ntfyTopic: val || undefined })); }} /> Your ntfy.sh topic name (1–64 alphanumeric/hyphen/underscore characters).{" "} Learn more about ntfy.sh {form.ntfyTopic && !/^[a-zA-Z0-9_-]{1,64}$/.test(form.ntfyTopic) && ( Topic must be 1–64 alphanumeric, hyphen, or underscore characters )}
When a task moves to In Review (ready for review) When a task is successfully merged to main When a task fails during execution (high priority) When a task specification needs manual approval before execution When an agent hands off a task for human review (high priority)
{ const val = e.target.value; setForm((f) => ({ ...f, ntfyDashboardHost: val || undefined })); }} /> Base URL for deep links in notifications. When set, clicking a notification opens the dashboard directly to the task. {form.ntfyDashboardHost && !/^https?:\/\/.+/.test(form.ntfyDashboardHost) && ( Must be a valid URL starting with http:// or https:// )}
)} ); case "plugins": return ( <>

Plugins

); case "authentication": return ( <>

Authentication

{authLoading ? (
Loading authentication status…
) : authProviders.length === 0 ? (
No providers available
) : ( <> {!authProviders.some(p => p.authenticated) && (
Sign in to at least one provider to get started.
)} {authProviders.map((provider) => (
{provider.name} {provider.authenticated ? "✓ Authenticated" : "✗ Not authenticated"}
{provider.type === "api_key" ? (
setApiKeyInputs((prev) => ({ ...prev, [provider.id]: e.target.value }))} disabled={authActionInProgress === provider.id} /> {provider.authenticated ? ( ) : ( )}
{authActionInProgress === provider.id && ( Saving… )} {apiKeyErrors[provider.id] && ( {apiKeyErrors[provider.id]} )}
) : (
{authActionInProgress === provider.id ? ( ) : provider.authenticated ? ( ) : ( )}
)}
))} )} Authentication changes take effect immediately — no need to save. ); } }; return (

Settings

{loading ? (
Loading…
) : (
{renderSectionFields()}
)}
{/* Import Confirmation Dialog */} {importDialogOpen && importPreview && (
e.target === e.currentTarget && setImportDialogOpen(false)}>

Import Settings

Review the settings to be imported:

{importPreview.global && Object.keys(importPreview.global).length > 0 && (
Global Settings:
    {Object.entries(importPreview.global) .filter(([, v]) => v !== undefined) .map(([key]) => (
  • {key}
  • ))}
)} {importPreview.project && Object.keys(importPreview.project).length > 0 && (
Project Settings:
    {Object.entries(importPreview.project) .filter(([, v]) => v !== undefined) .map(([key]) => (
  • {key}
  • ))}
)}
If unchecked, existing settings will be replaced with imported values.
)}
); }