feat: scoped permission rules, local settings source, scroll sync, and git status fix

- Add scoped "always allow" dropdown to permission prompt with per-destination
  rule persistence (session, local, project, user settings)
- Forward updatedPermissions through SDK permission bridge for rule saving
- Include "local" in settingSources for all SDK query paths
- Extract top scroll progress to a pure helper and sync it on programmatic scrolls
- Fix useGitStatus loading flag race with separate tracking ref
- Refine glass morphism gradient tuning (lighter titlebar, softer top fade)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: OpenSource03

electron/src/ipc/claude-sessions.ts

@@ -22,7 +22,7 @@ function fileCheckpointOptions(): Record<string, unknown> {
 }
 
 type PermissionResult =
-  | { behavior: "allow"; updatedInput?: Record<string, unknown> }
+  | { behavior: "allow"; updatedInput?: Record<string, unknown>; updatedPermissions?: unknown[] }
   | { behavior: "deny"; message: string };
 
 interface PendingPermission {
@@ -338,7 +338,7 @@ async function revalidateClaudeModelsCache(cwd?: string): Promise<{ models: Arra
           cwd: cwd?.trim() || os.homedir(),
           includePartialMessages: true,
           thinking: buildThinkingConfig(),
-          settingSources: ["user", "project"],
+          settingSources: ["user", "project", "local"],
           pathToClaudeCodeExecutable: attempt.cliPath,
           ...fileCheckpointOptions(),
           stderr: (data: string) => {
@@ -490,7 +490,7 @@ async function restartSession(
     includePartialMessages: true,
     thinking: buildThinkingConfig(),
     canUseTool,
-    settingSources: ["user", "project"],
+    settingSources: ["user", "project", "local"],
     pathToClaudeCodeExecutable: cliPath,
     ...fileCheckpointOptions(),
     resume: sessionId,
@@ -571,6 +571,7 @@ export function register(getMainWindow: () => BrowserWindow | null): void {
             requestId,
             toolUseId: context.toolUseID,
             reason: context.decisionReason,
+            hasSuggestions: Array.isArray(context.suggestions) && context.suggestions.length > 0,
           });
           safeSend(getMainWindow,"claude:permission_request", {
             _sessionId: sessionId,
@@ -591,7 +592,7 @@ export function register(getMainWindow: () => BrowserWindow | null): void {
         includePartialMessages: true,
         thinking: buildThinkingConfig(),
         canUseTool,
-        settingSources: ["user", "project"],
+        settingSources: ["user", "project", "local"],
         pathToClaudeCodeExecutable: cliPath,
         ...fileCheckpointOptions(),
         stderr: (data: string) => {
@@ -673,14 +674,15 @@ export function register(getMainWindow: () => BrowserWindow | null): void {
   });
 
   ipcMain.handle("claude:permission_response", async (_event, {
-    sessionId, requestId, behavior, toolInput, newPermissionMode,
+    sessionId, requestId, behavior, toolInput, newPermissionMode, updatedPermissions,
   }: {
     sessionId: string;
     requestId: string;
     behavior: string;
     toolUseId: string;
     toolInput: Record<string, unknown> | undefined;
     newPermissionMode?: string;
+    updatedPermissions?: unknown[];
   }) => {
     const session = sessions.get(sessionId);
     if (!session) {
@@ -693,7 +695,7 @@ export function register(getMainWindow: () => BrowserWindow | null): void {
       return { error: "No pending permission request" };
     }
     session.pendingPermissions.delete(requestId);
-    log("PERMISSION_RESPONSE", `session=${sessionId.slice(0, 8)} behavior=${behavior} requestId=${requestId} newMode=${newPermissionMode ?? "none"}`);
+    log("PERMISSION_RESPONSE", `session=${sessionId.slice(0, 8)} behavior=${behavior} requestId=${requestId} newMode=${newPermissionMode ?? "none"} hasUpdatedPermissions=${!!updatedPermissions?.length}`);
 
     if (newPermissionMode && session.queryHandle) {
       try {
@@ -705,7 +707,7 @@ export function register(getMainWindow: () => BrowserWindow | null): void {
     }
 
     if (behavior === "allow") {
-      pending.resolve({ behavior: "allow", updatedInput: toolInput });
+      pending.resolve({ behavior: "allow", updatedInput: toolInput, updatedPermissions });
     } else {
       // Pass user-provided rejection reason (from plan feedback) to the SDK so the model can adjust
       const denyMsg = toolInput?.denyMessage;

electron/src/ipc/title-gen.ts

@@ -304,7 +304,7 @@ export function register(): void {
         model: "haiku",
         extraOptions: {
           systemPrompt: { type: "preset", preset: "claude_code" },
-          settingSources: ["project", "user"],
+          settingSources: ["project", "user", "local"],
         },
       });
       return { message: result, error };

electron/src/lib/__tests__/chat-scroll.test.ts

@@ -1,7 +1,9 @@
 import { describe, expect, it } from "vitest";
 import {
   BOTTOM_LOCK_THRESHOLD_PX,
+  TOP_SCROLL_FADE_RANGE_PX,
   getDistanceFromBottom,
+  getTopScrollProgress,
   isWithinBottomLockThreshold,
   shouldUnlockBottomLock,
 } from "../../../../src/lib/chat-scroll";
@@ -48,4 +50,13 @@ describe("chat scroll helpers", () => {
       clientHeight: 300,
     })).toBe(true);
   });
+
+  it("keeps the top shadow hidden at the top and fully visible at the fade range", () => {
+    expect(getTopScrollProgress(0)).toBe(0);
+    expect(getTopScrollProgress(TOP_SCROLL_FADE_RANGE_PX)).toBe(1);
+  });
+
+  it("eases the top shadow progress through the fade ramp", () => {
+    expect(getTopScrollProgress(TOP_SCROLL_FADE_RANGE_PX / 2)).toBe(0.5);
+  });
 });

electron/src/preload.ts

@@ -69,8 +69,8 @@ contextBridge.exposeInMainWorld("claude", {
     ipcRenderer.on("claude:permission_request", listener);
     return () => ipcRenderer.removeListener("claude:permission_request", listener);
   },
-  respondPermission: (sessionId: string, requestId: string, behavior: string, toolUseId: string, toolInput: unknown, newPermissionMode?: string) =>
-    ipcRenderer.invoke("claude:permission_response", { sessionId, requestId, behavior, toolUseId, toolInput, newPermissionMode }),
+  respondPermission: (sessionId: string, requestId: string, behavior: string, toolUseId: string, toolInput: unknown, newPermissionMode?: string, updatedPermissions?: unknown[]) =>
+    ipcRenderer.invoke("claude:permission_response", { sessionId, requestId, behavior, toolUseId, toolInput, newPermissionMode, updatedPermissions }),
   setPermissionMode: (sessionId: string, permissionMode: string) =>
     ipcRenderer.invoke("claude:set-permission-mode", { sessionId, permissionMode }),
   setModel: (sessionId: string, model: string) =>

shared/types/engine.ts

@@ -43,11 +43,15 @@ export type AppPermissionBehavior = "allow" | "deny" | "allowForSession";
 /**
  * Canonical signature for responding to a tool permission prompt.
  * All engines must implement this — unused params can be ignored.
+ *
+ * `updatedPermissions` is forwarded to the SDK to persist allow rules
+ * to the chosen settings file (session / local / project / user).
  */
 export type RespondPermissionFn = (
   behavior: AppPermissionBehavior,
   updatedInput?: Record<string, unknown>,
   newPermissionMode?: string,
+  updatedPermissions?: unknown[],
 ) => Promise<void>;
 
 /**

src/components/AppLayout.tsx

@@ -1,4 +1,4 @@
-import { useCallback, useRef, useEffect, useState } from "react";
+import { useCallback, useRef, useEffect, useLayoutEffect, useState } from "react";
 import { PanelLeft } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { normalizeRatios } from "@/hooks/useSettings";
@@ -299,14 +299,16 @@ Link: ${issue.url}`;
   const chatIslandRef = useRef<HTMLDivElement>(null);
   const lastTopScrollProgressRef = useRef(0);
 
-  // Reset on session change — new/blank chats start at scroll 0.
   useEffect(() => {
-    lastTopScrollProgressRef.current = 0;
-    chatIslandRef.current?.style.setProperty("--chat-top-progress", "0");
     // Grabbed elements are session-specific context — discard on switch
     setGrabbedElements([]);
   }, [manager.activeSessionId]);
 
+  useLayoutEffect(() => {
+    lastTopScrollProgressRef.current = 0;
+    chatIslandRef.current?.style.setProperty("--chat-top-progress", "0");
+  }, [manager.activeSessionId]);
+
   const handleTopScrollProgress = useCallback((progress: number) => {
     const clamped = Math.max(0, Math.min(1, progress));
     if (Math.abs(lastTopScrollProgressRef.current - clamped) < 0.005) return;
@@ -339,16 +341,16 @@ Link: ${issue.url}`;
     : "var(--background)";
   // Keep titlebar veil/shadow behavior consistent across island and non-island layouts.
   const titlebarOpacity = isLightGlass
-    ? Math.round(74 + 18 * spaceOpacity)
-    : Math.round(30 + 50 * spaceOpacity); // 30–80% or brighter in light glass
+    ? Math.round(69 + 14 * spaceOpacity)
+    : Math.round(23 + 35 * spaceOpacity);
   const topFadeShadowOpacity = isLightGlass
-    ? Math.round(18 + 16 * spaceOpacity)
-    : Math.round(28 + 28 * spaceOpacity);
+    ? Math.round(13 + 15 * spaceOpacity)
+    : Math.round(21 + 26 * spaceOpacity);
   const titlebarSurfaceColor =
-    `linear-gradient(to bottom, color-mix(in oklab, ${chatSurfaceColor} ${titlebarOpacity}%, transparent) 0%, color-mix(in oklab, ${chatSurfaceColor} ${Math.max(titlebarOpacity - 8, 24)}%, transparent) 52%, color-mix(in oklab, ${chatSurfaceColor} ${Math.max(titlebarOpacity - 22, 12)}%, transparent) 76%, transparent 100%)`;
+    `linear-gradient(to bottom, color-mix(in oklab, ${chatSurfaceColor} ${titlebarOpacity}%, transparent) 0%, color-mix(in oklab, ${chatSurfaceColor} ${Math.max(titlebarOpacity - 3, 23)}%, transparent) 34%, color-mix(in oklab, ${chatSurfaceColor} ${Math.max(titlebarOpacity - 14, 11)}%, transparent) 68%, transparent 100%)`;
   const topFadeBackground = isIsland
-    ? `linear-gradient(to bottom, color-mix(in oklab, ${chatSurfaceColor} 100%, black 9%) 0%, color-mix(in oklab, ${chatSurfaceColor} 97%, black 4%) 20%, color-mix(in oklab, ${chatSurfaceColor} 92%, transparent) 54%, transparent 100%), radial-gradient(140% 92% at 50% 0%, color-mix(in srgb, black ${topFadeShadowOpacity}%, transparent) 0%, transparent 74%)`
-    : `linear-gradient(to bottom, ${chatSurfaceColor} 0%, ${chatSurfaceColor} 42%, color-mix(in oklab, ${chatSurfaceColor} 90%, transparent) 68%, transparent 100%), radial-gradient(145% 96% at 50% 0%, color-mix(in srgb, black ${topFadeShadowOpacity}%, transparent) 0%, transparent 76%)`;
+    ? `linear-gradient(to bottom, color-mix(in oklab, ${chatSurfaceColor} 100%, black 4.5%) 0%, color-mix(in oklab, ${chatSurfaceColor} 97.5%, black 1.75%) 18%, color-mix(in oklab, ${chatSurfaceColor} 93.5%, transparent) 48%, transparent 100%), radial-gradient(138% 88% at 50% 0%, color-mix(in srgb, black ${topFadeShadowOpacity}%, transparent) 0%, transparent 70%)`
+    : `linear-gradient(to bottom, ${chatSurfaceColor} 0%, ${chatSurfaceColor} 34%, color-mix(in oklab, ${chatSurfaceColor} 90.5%, transparent) 60%, transparent 100%), radial-gradient(142% 92% at 50% 0%, color-mix(in srgb, black ${topFadeShadowOpacity}%, transparent) 0%, transparent 72%)`;
   const bottomFadeBackground = `linear-gradient(to top, ${chatSurfaceColor}, transparent)`;
 
   const { activeTools } = settings;
@@ -462,7 +464,7 @@ Link: ${issue.url}`;
               {/* Island: gradient starts at top-0 (behind header, subtle bleed). Flat: starts at top-10 (right below header) so full gradient is visible and strong. */}
               <div
                 className={`pointer-events-none absolute inset-x-0 top-0 z-[5] ${
-                  isIsland ? "h-24" : "h-28"
+                  isIsland ? "h-20" : "h-24"
                 }`}
                 style={{
                   opacity: "calc(var(--chat-fade-strength, 1) * var(--chat-top-progress, 0))",

src/components/ChatView.tsx

@@ -17,6 +17,7 @@ import { TextShimmer } from "@/components/ui/text-shimmer";
 import {
   BOTTOM_LOCK_THRESHOLD_PX,
   USER_SCROLL_INTENT_WINDOW_MS,
+  getTopScrollProgress,
   isWithinBottomLockThreshold,
   shouldUnlockBottomLock,
 } from "@/lib/chat-scroll";
@@ -82,8 +83,6 @@ export const ChatView = memo(function ChatView({ messages, isProcessing, showThi
   onScrolledFromTopRef.current = onScrolledFromTop;
   const onTopScrollProgressRef = useRef(onTopScrollProgress);
   onTopScrollProgressRef.current = onTopScrollProgress;
-  const topProgressRafRef = useRef<number | null>(null);
-  const pendingTopProgressRef = useRef(0);
   const lastTopProgressRef = useRef(-1);
   const prependAnchorRef = useRef<{ scrollHeight: number; scrollTop: number } | null>(null);
   const lastSessionIdRef = useRef<string | undefined | null>(sessionId);
@@ -94,6 +93,9 @@ export const ChatView = memo(function ChatView({ messages, isProcessing, showThi
   );
 
   const getViewport = useCallback(() => {
+    if (viewportRef.current && !viewportRef.current.isConnected) {
+      viewportRef.current = null;
+    }
     if (!viewportRef.current) {
       viewportRef.current = scrollAreaRef.current?.querySelector<HTMLElement>(
         "[data-radix-scroll-area-viewport]",
@@ -167,6 +169,22 @@ export const ChatView = memo(function ChatView({ messages, isProcessing, showThi
     };
   }, [expandRenderedHistory, messages.length, visibleStartIndex]);
 
+  const publishTopProgress = useCallback((progress: number) => {
+    const clamped = Math.max(0, Math.min(1, progress));
+    const last = lastTopProgressRef.current;
+    if (last < 0 || Math.abs(clamped - last) >= 0.01 || clamped === 0 || clamped === 1) {
+      lastTopProgressRef.current = clamped;
+      onTopScrollProgressRef.current?.(clamped);
+    }
+  }, []);
+
+  const syncViewportState = useCallback((viewport: HTMLElement) => {
+    const { scrollTop, scrollHeight, clientHeight } = viewport;
+    onScrolledFromTopRef.current?.(scrollTop > 4);
+    publishTopProgress(getTopScrollProgress(scrollTop));
+    return { scrollTop, scrollHeight, clientHeight };
+  }, [publishTopProgress]);
+
   useLayoutEffect(() => {
     const anchor = prependAnchorRef.current;
     if (!anchor) return;
@@ -176,8 +194,9 @@ export const ChatView = memo(function ChatView({ messages, isProcessing, showThi
 
     const delta = viewport.scrollHeight - anchor.scrollHeight;
     viewport.scrollTop = anchor.scrollTop + delta;
+    syncViewportState(viewport);
     prependAnchorRef.current = null;
-  }, [getViewport, visibleStartIndex]);
+  }, [getViewport, syncViewportState, visibleStartIndex]);
 
   const visibleMessages = useMemo(
     () => visibleStartIndex === 0 ? messages : messages.slice(visibleStartIndex),
@@ -196,6 +215,7 @@ export const ChatView = memo(function ChatView({ messages, isProcessing, showThi
       if (shouldForce || Math.abs(targetViewport.scrollTop - targetScrollTop) > 1) {
         targetViewport.scrollTop = targetScrollTop;
       }
+      syncViewportState(targetViewport);
     };
 
     suppressScrollTrackingRef.current += 1;
@@ -205,7 +225,7 @@ export const ChatView = memo(function ChatView({ messages, isProcessing, showThi
       if (nextViewport) applyBottom(nextViewport);
       suppressScrollTrackingRef.current = Math.max(0, suppressScrollTrackingRef.current - 1);
     });
-  }, [getViewport]);
+  }, [getViewport, syncViewportState]);
 
   const clearSettleTimers = useCallback(() => {
     if (settleRafRef.current !== null) {
@@ -229,32 +249,21 @@ export const ChatView = memo(function ChatView({ messages, isProcessing, showThi
     scheduleSettleToBottom();
   }, [messages.length, isProcessing, scheduleSettleToBottom]);
 
+  useLayoutEffect(() => {
+    if (!sessionId) return;
+    bottomLockedRef.current = true;
+    userScrollIntentUntilRef.current = 0;
+    lastTopProgressRef.current = -1;
+    jumpToBottom({ force: true });
+  }, [jumpToBottom, sessionId]);
+
   // Track whether user is near the bottom; this drives sticky auto-follow behavior.
   useEffect(() => {
     const viewport = getViewport();
     if (!viewport) return;
 
-    const flushTopProgress = () => {
-      topProgressRafRef.current = null;
-      const progress = pendingTopProgressRef.current;
-      const last = lastTopProgressRef.current;
-      if (last < 0 || Math.abs(progress - last) >= 0.01 || progress === 0 || progress === 1) {
-        lastTopProgressRef.current = progress;
-        onTopScrollProgressRef.current?.(progress);
-      }
-    };
-
     const updateAutoFollow = () => {
-      const { scrollTop, scrollHeight, clientHeight } = viewport;
-      // Always report scroll-from-top state (controls header shadow visibility)
-      onScrolledFromTopRef.current?.(scrollTop > 4);
-      // Smooth top ramp: slower range + smoothstep easing to avoid abrupt header/fade jumps.
-      const normalized = Math.max(0, Math.min(1, scrollTop / 96));
-      const easedProgress = normalized * normalized * (3 - 2 * normalized);
-      pendingTopProgressRef.current = easedProgress;
-      if (topProgressRafRef.current === null) {
-        topProgressRafRef.current = window.requestAnimationFrame(flushTopProgress);
-      }
+      const { scrollTop, scrollHeight, clientHeight } = syncViewportState(viewport);
       // Auto-follow tracking is suppressed during programmatic scrolls to
       // prevent them from unlocking sticky follow mode
       if (suppressScrollTrackingRef.current > 0) {
@@ -322,14 +331,11 @@ export const ChatView = memo(function ChatView({ messages, isProcessing, showThi
       viewport.removeEventListener("pointerdown", markUserScrollIntent);
       viewport.removeEventListener("keydown", handleKeydown);
       viewport.removeEventListener("scroll", throttledUpdateAutoFollow);
-      if (topProgressRafRef.current !== null) {
-        window.cancelAnimationFrame(topProgressRafRef.current);
-        topProgressRafRef.current = null;
-      }
     };
-  }, [messages.length, clearSettleTimers, expandRenderedHistory, getViewport, visibleStartIndex]);
+  }, [messages.length, clearSettleTimers, expandRenderedHistory, getViewport, syncViewportState, visibleStartIndex]);
 
-  // Force-scroll to bottom on session switch, bypassing the proximity guard
+  // Force-scroll to bottom again after session changes so late layout shifts
+  // still settle at the bottom even after the immediate layout pass above.
   useEffect(() => {
     if (!sessionId) return;
     bottomLockedRef.current = true;