feat(desktop): file-tree context-menu ops, git timeline, system tray

- file-tree right-click menu: copy/cut/paste/delete/rename/archive/extract
- git file timeline dialog backed by a local git binary
- system tray with close-to-tray (graceful Linux GNOME fallback when no
  StatusNotifierItem host, so a window is never stranded)
- powerSaveBlocker to prevent idle sleep while the app is active
- multi-platform hardening: EXDEV cross-device move fallback, Windows
  illegal filename chars, git-missing degradation, loopback-only filesystem
  bridge so a remote Server Edition sidecar never touches local paths
- CI: add macOS to the unit matrix; wire desktop test/test:ci into turbo
- tests: 62 unit cases covering pure decision logic and real fs/git/zip paths

Author: thomas-yanga

.github/workflows/test.yml

@@ -31,6 +31,8 @@ jobs:
             host: blacksmith-4vcpu-ubuntu-2404
           - name: windows
             host: blacksmith-4vcpu-windows-2025
+          - name: macos
+            host: macos-14
     runs-on: ${{ matrix.settings.host }}
     defaults:
       run:

packages/app/src/app.tsx

@@ -31,6 +31,7 @@ import { CommandProvider } from "@/context/command"
 import { CommentsProvider } from "@/context/comments"
 import { DebugProvider } from "@/context/debug"
 import { FileProvider } from "@/context/file"
+import type { DesktopApi } from "@/utils/desktop-api"
 import { GatewayProvider } from "@/context/gateway"
 import { ServerSDKProvider } from "@/context/server-sdk"
 import { ServerSyncProvider } from "@/context/server-sync"
@@ -76,10 +77,7 @@ declare global {
     __DEEPAGENT_CODE__?: {
       deepLinks?: string[]
     }
-    api?: {
-      setTitlebar?: (theme: { mode: "light" | "dark" }) => Promise<void>
-      exportDebugLogs?: (options?: { windowMs?: number; pick?: boolean }) => Promise<string | null>
-    }
+    api?: DesktopApi
   }
 }
 

packages/app/src/components/file-tree-context-menu.tsx

@@ -0,0 +1,135 @@
+import { createSignal, Show } from "solid-js"
+import { ContextMenu } from "@deepagent-code/ui/context-menu"
+import type { FileNode } from "@deepagent-code/sdk/v2"
+import { useFile } from "@/context/file"
+import { useLanguage } from "@/context/language"
+import { showToast } from "@/utils/toast"
+import { desktopApi, isLocalFilesystemOp } from "@/utils/desktop-api"
+import { canExtract, canOpenTimeline, canPaste, parentPath } from "./file-tree-menu"
+
+// Process-local clipboard for copy/cut → paste between file-tree nodes. Lives for the renderer
+// lifetime; cut entries are cleared after a successful paste.
+type Clip = { mode: "copy" | "cut"; absolute: string }
+const [clip, setClip] = createSignal<Clip | null>(null)
+
+export function FileTreeMenuContent(props: {
+  node: FileNode
+  onRename: () => void
+  onOpenTimeline: (node: FileNode) => void
+}) {
+  const file = useFile()
+  const language = useLanguage()
+
+  // File-ops and the git timeline run in the desktop main process against the local filesystem.
+  // They are only available on the desktop build AND when the connected sidecar is local
+  // (loopback). On the web build or against a remote Server Edition, these menu items degrade to
+  // disabled so the user never triggers an operation that would fail or touch the wrong host.
+  const localFs = () => isLocalFilesystemOp({ desktop: Boolean(desktopApi()), localSidecar: file.isLocalSidecar() })
+  const root = () => file.directory()
+
+  const refresh = () => {
+    void file.tree.refresh(parentPath(props.node.path))
+    if (props.node.type === "directory") void file.tree.refresh(props.node.path)
+  }
+
+  const report = (
+    res: { ok: boolean; error?: string } | undefined,
+    okKey: string,
+    errKey: string,
+  ) => {
+    if (!res) return
+    if (res.ok) {
+      showToast({ variant: "success", title: language.t(okKey) })
+      refresh()
+      return
+    }
+    showToast({ variant: "error", title: language.t(errKey), description: res.error })
+  }
+
+  const copyText = (text: string) => {
+    void navigator.clipboard?.writeText(text).then(() =>
+      showToast({ variant: "success", title: language.t("fileTree.copied") }),
+    )
+  }
+
+  const markClip = (mode: "copy" | "cut") => {
+    setClip({ mode, absolute: props.node.absolute })
+    showToast({ variant: "success", title: language.t(mode === "copy" ? "fileTree.copied" : "fileTree.cut") })
+  }
+
+  const paste = async () => {
+    const current = clip()
+    if (!current) return
+    const destDir = props.node.absolute
+    const res =
+      current.mode === "copy"
+        ? await desktopApi()?.fileOps?.copy(root(), current.absolute, destDir)
+        : await desktopApi()?.fileOps?.move(root(), current.absolute, destDir)
+    if (!res) return
+    if (res.ok) {
+      if (current.mode === "cut") setClip(null)
+      showToast({ variant: "success", title: language.t("fileTree.pasted") })
+      refresh()
+      return
+    }
+    showToast({ variant: "error", title: language.t("fileTree.pasteFailed"), description: res.error })
+  }
+
+  const remove = async () => {
+    if (!window.confirm(language.t("fileTree.deleteConfirm", { name: props.node.name }))) return
+    report(await desktopApi()?.fileOps?.remove(root(), props.node.absolute), "fileTree.deleted", "fileTree.deleteFailed")
+  }
+
+  const archive = async () => {
+    report(await desktopApi()?.fileOps?.archive(root(), props.node.absolute), "fileTree.archived", "fileTree.archiveFailed")
+  }
+
+  const extract = async () => {
+    report(await desktopApi()?.fileOps?.extract(root(), props.node.absolute), "fileTree.extracted", "fileTree.extractFailed")
+  }
+
+  return (
+    <>
+      <ContextMenu.Item onSelect={() => copyText(props.node.path)}>
+        <ContextMenu.ItemLabel>{language.t("fileTree.copyRelativePath")}</ContextMenu.ItemLabel>
+      </ContextMenu.Item>
+      <ContextMenu.Item onSelect={() => copyText(props.node.absolute)}>
+        <ContextMenu.ItemLabel>{language.t("fileTree.copyAbsolutePath")}</ContextMenu.ItemLabel>
+      </ContextMenu.Item>
+      <ContextMenu.Separator />
+      <ContextMenu.Item onSelect={() => markClip("copy")} disabled={!localFs()}>
+        <ContextMenu.ItemLabel>{language.t("fileTree.copy")}</ContextMenu.ItemLabel>
+      </ContextMenu.Item>
+      <ContextMenu.Item onSelect={() => markClip("cut")} disabled={!localFs()}>
+        <ContextMenu.ItemLabel>{language.t("fileTree.cut")}</ContextMenu.ItemLabel>
+      </ContextMenu.Item>
+      <Show when={canPaste({ nodeType: props.node.type, hasClip: Boolean(clip()), localFs: localFs() })}>
+        <ContextMenu.Item onSelect={paste}>
+          <ContextMenu.ItemLabel>{language.t("fileTree.paste")}</ContextMenu.ItemLabel>
+        </ContextMenu.Item>
+      </Show>
+      <ContextMenu.Separator />
+      <ContextMenu.Item onSelect={remove} disabled={!localFs()}>
+        <ContextMenu.ItemLabel>{language.t("common.delete")}</ContextMenu.ItemLabel>
+      </ContextMenu.Item>
+      <ContextMenu.Item onSelect={() => props.onRename()} disabled={!localFs()}>
+        <ContextMenu.ItemLabel>{language.t("common.rename")}</ContextMenu.ItemLabel>
+      </ContextMenu.Item>
+      <ContextMenu.Separator />
+      <ContextMenu.Item onSelect={archive} disabled={!localFs()}>
+        <ContextMenu.ItemLabel>{language.t("fileTree.archive")}</ContextMenu.ItemLabel>
+      </ContextMenu.Item>
+      <Show when={canExtract({ nodeType: props.node.type, name: props.node.name })}>
+        <ContextMenu.Item onSelect={extract} disabled={!localFs()}>
+          <ContextMenu.ItemLabel>{language.t("fileTree.extract")}</ContextMenu.ItemLabel>
+        </ContextMenu.Item>
+      </Show>
+      <Show when={canOpenTimeline({ nodeType: props.node.type, localFs: localFs() })}>
+        <ContextMenu.Separator />
+        <ContextMenu.Item onSelect={() => props.onOpenTimeline(props.node)}>
+          <ContextMenu.ItemLabel>{language.t("fileTree.openTimeline")}</ContextMenu.ItemLabel>
+        </ContextMenu.Item>
+      </Show>
+    </>
+  )
+}

packages/app/src/components/file-tree-menu.test.ts

@@ -0,0 +1,80 @@
+import { describe, expect, test } from "bun:test"
+import { canExtract, canOpenTimeline, canPaste, parentPath } from "./file-tree-menu"
+
+// These rules encode the file-tree context menu's multi-platform / Server-Edition degradation
+// contract: local-only and destructive operations are gated on `localFs` (desktop bridge present
+// AND loopback sidecar), plus node-type / filename conditions. A change to the gating surfaces as
+// a focused failure here instead of only as a regression in the rendered menu.
+
+describe("parentPath", () => {
+  test("returns the directory portion of a nested path", () => {
+    expect(parentPath("src/components/file-tree.tsx")).toBe("src/components")
+  })
+
+  test("returns the top-level directory for a shallow file", () => {
+    expect(parentPath("README.md")).toBe("")
+  })
+
+  test("returns '' for a root-level path with no slash", () => {
+    expect(parentPath("file")).toBe("")
+  })
+
+  test("handles a trailing slash by slicing at the last separator", () => {
+    // the menu calls parentPath(node.path) to refresh the containing directory after an op;
+    // a directory node path like "src/sub/" still yields "src/sub"
+    expect(parentPath("src/sub/")).toBe("src/sub")
+  })
+})
+
+describe("canPaste", () => {
+  test("is offered on a directory with a clip and local fs available", () => {
+    expect(canPaste({ nodeType: "directory", hasClip: true, localFs: true })).toBe(true)
+  })
+
+  test("is hidden on a file even with a clip and local fs", () => {
+    expect(canPaste({ nodeType: "file", hasClip: true, localFs: true })).toBe(false)
+  })
+
+  test("is hidden when there is no clip to paste", () => {
+    expect(canPaste({ nodeType: "directory", hasClip: false, localFs: true })).toBe(false)
+  })
+
+  test("is hidden on the web build / remote Server Edition sidecar (no local fs)", () => {
+    // paste is destructive (move on cut) — must not surface when the local bridge is unavailable
+    expect(canPaste({ nodeType: "directory", hasClip: true, localFs: false })).toBe(false)
+  })
+})
+
+describe("canExtract", () => {
+  test("is offered on a .zip file", () => {
+    expect(canExtract({ nodeType: "file", name: "archive.zip" })).toBe(true)
+  })
+
+  test("is case-insensitive on the .zip extension", () => {
+    expect(canExtract({ nodeType: "file", name: "ARCHIVE.ZIP" })).toBe(true)
+    expect(canExtract({ nodeType: "file", name: "Archive.Zip" })).toBe(true)
+  })
+
+  test("is hidden on a non-zip file", () => {
+    expect(canExtract({ nodeType: "file", name: "notes.txt" })).toBe(false)
+    expect(canExtract({ nodeType: "file", name: "tar.gz" })).toBe(false)
+  })
+
+  test("is hidden on a directory even if named *.zip", () => {
+    expect(canExtract({ nodeType: "directory", name: "bundle.zip" })).toBe(false)
+  })
+})
+
+describe("canOpenTimeline", () => {
+  test("is offered on a file when local fs is available (local git binary)", () => {
+    expect(canOpenTimeline({ nodeType: "file", localFs: true })).toBe(true)
+  })
+
+  test("is hidden on a directory (git log is per-file)", () => {
+    expect(canOpenTimeline({ nodeType: "directory", localFs: true })).toBe(false)
+  })
+
+  test("is hidden on the web build / remote Server Edition sidecar (no local git)", () => {
+    expect(canOpenTimeline({ nodeType: "file", localFs: false })).toBe(false)
+  })
+})

packages/app/src/components/file-tree-menu.ts

@@ -0,0 +1,31 @@
+// Pure decision logic for the file-tree context menu, kept in a .ts module so it can be unit-tested
+// without importing the Solid component (which pulls in context providers and UI primitives).
+//
+// These rules encode the multi-platform / Server-Edition degradation contract: destructive and
+// local-only operations (copy/cut/paste/delete/rename/archive/extract/timeline) are gated on
+// `localFs` (desktop bridge present AND sidecar on loopback), and a few items additionally depend
+// on node type or filename. Keeping them here means a change to the gating rules surfaces as a
+// focused test failure instead of only as a regression in the rendered menu.
+
+export type FileNodeType = "file" | "directory"
+
+/** The parent directory path of a POSIX-style tree path ("" for top-level). */
+export function parentPath(p: string): string {
+  const idx = p.lastIndexOf("/")
+  return idx === -1 ? "" : p.slice(0, idx)
+}
+
+/** Paste is offered only on a directory, when a clip exists, and local fs ops are available. */
+export function canPaste(input: { nodeType: FileNodeType; hasClip: boolean; localFs: boolean }): boolean {
+  return input.nodeType === "directory" && input.hasClip && input.localFs
+}
+
+/** Extract is offered only on a file whose name ends with .zip (case-insensitive). */
+export function canExtract(input: { nodeType: FileNodeType; name: string }): boolean {
+  return input.nodeType === "file" && /\.zip$/i.test(input.name)
+}
+
+/** The git timeline is offered only on a file with local fs ops available (local git binary). */
+export function canOpenTimeline(input: { nodeType: FileNodeType; localFs: boolean }): boolean {
+  return input.nodeType === "file" && input.localFs
+}