diff --git a/README.md b/README.md
index 6efe4f0d..9194a544 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,37 @@
 
 <br />
 
+## What is this
+
+A new approach to task management with AI agents.
+
+- **Assemble your team** — create agent teams with different roles that work autonomously in parallel
+- **Agents talk to each other** — they communicate, create and manage their own tasks, and leave comments
+- **Sit back and watch** — tasks change status on the kanban board while agents handle everything on their own
+- **Review changes like in Cursor** — see what code each task changed, then approve, reject, or comment
+- **Full tool visibility** — inspect exactly which tools an agent used to complete each task
+- **Live process dashboard** — see which agents are running processes in dedicated sections (frontend, backend, etc.) and open URLs directly in the browser
+- **Stay in control** — send a direct message to any agent or drop a comment on a task whenever you want to clarify something or add new work
+
+<details>
+<summary><strong>More features</strong></summary>
+
+<br />
+
+- **Recent tasks across projects** — browse the latest completed tasks from all your projects in one place
+- **Deep session analysis** — detailed breakdown of what happened in each Claude session: bash commands, reasoning, subprocesses
+- **Smart task-to-log matching** — automatically links Claude session logs to specific tasks based on status change timestamps, even when a task moves back and forth between states
+- **Zero-setup onboarding** — built-in Claude Code installation and authentication, ready to go out of the box
+- **Built-in code editor** — edit project files with Git support and other essential features without leaving the app
+- **Branch strategy control** — choose via prompt whether all agents work on a single branch or each gets its own git worktree
+- **Team member stats** — global performance statistics for every member of the team
+- **Attach code context** — reference files or code snippets in your messages, just like in Cursor
+- **Notification system** — configurable alerts when tasks complete, agents need attention, or errors occur
+
+</details>
+
+---
+
 <!--
 <p align="center">
   <video src="https://github.com/user-attachments/assets/2b420b2c-c4af-4d10-a679-c83269f8ee99">
diff --git a/package.json b/package.json
index 80353f9a..125253e7 100644
--- a/package.json
+++ b/package.json
@@ -110,6 +110,7 @@
     "cmdk": "1.0.4",
     "date-fns": "^3.6.0",
     "diff": "^8.0.3",
+    "dompurify": "^3.3.1",
     "electron-updater": "^6.7.3",
     "fastify": "^5.7.4",
     "highlight.js": "^11.11.1",
@@ -117,12 +118,14 @@
     "isbinaryfile": "^6.0.0",
     "lucide-react": "^0.562.0",
     "mdast-util-to-hast": "^13.2.1",
+    "mermaid": "^11.12.3",
     "node-diff3": "^3.2.0",
     "node-pty": "^1.1.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-markdown": "^10.1.0",
     "rehype-highlight": "^7.0.2",
+    "rehype-raw": "^7.0.0",
     "remark-gfm": "^4.0.1",
     "remark-parse": "^11.0.0",
     "simple-git": "^3.32.3",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index c5385a1c..346399b9 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -158,6 +158,9 @@ importers:
       diff:
         specifier: ^8.0.3
         version: 8.0.3
+      dompurify:
+        specifier: ^3.3.1
+        version: 3.3.1
       electron-updater:
         specifier: ^6.7.3
         version: 6.7.3
@@ -179,6 +182,9 @@ importers:
       mdast-util-to-hast:
         specifier: ^13.2.1
         version: 13.2.1
+      mermaid:
+        specifier: ^11.12.3
+        version: 11.12.3
       node-diff3:
         specifier: ^3.2.0
         version: 3.2.0
@@ -197,6 +203,9 @@ importers:
       rehype-highlight:
         specifier: ^7.0.2
         version: 7.0.2
+      rehype-raw:
+        specifier: ^7.0.0
+        version: 7.0.0
       remark-gfm:
         specifier: ^4.0.1
         version: 4.0.1
@@ -368,6 +377,9 @@ packages:
     resolution: {integrity: sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==}
     engines: {node: '>=6.0.0'}
 
+  '@antfu/install-pkg@1.1.0':
+    resolution: {integrity: sha512-MGQsmw10ZyI+EJo45CdSER4zEb+p31LpDAFp2Z3gkSd1yqVZGi0Ebx++YTEMonJy4oChEMLsxZ64j8FH6sSqtQ==}
+
   '@babel/code-frame@7.28.6':
     resolution: {integrity: sha512-JYgintcMjRiCvS8mMECzaEn+m3PfoQiyqukOMCCVQtoJGYJw8j/8LBJEiqkHLkfwCcs74E3pbAUFNg7d9VNJ+Q==}
     engines: {node: '>=6.9.0'}
@@ -465,6 +477,24 @@ packages:
     resolution: {integrity: sha512-DnGHL+v36YVMoWhWZqyJYVZ9dapNm7h4N3/P0lDPirJj0CHVPkjChMCCotj74cg6LW7iPJZFGrdEfh0X0g2bmQ==}
     engines: {node: '>=18.18'}
 
+  '@braintree/sanitize-url@7.1.2':
+    resolution: {integrity: sha512-jigsZK+sMF/cuiB7sERuo9V7N9jx+dhmHHnQyDSVdpZwVutaBu7WvNYqMDLSgFgfB30n452TP3vjDAvFC973mA==}
+
+  '@chevrotain/cst-dts-gen@11.1.2':
+    resolution: {integrity: sha512-XTsjvDVB5nDZBQB8o0o/0ozNelQtn2KrUVteIHSlPd2VAV2utEb6JzyCJaJ8tGxACR4RiBNWy5uYUHX2eji88Q==}
+
+  '@chevrotain/gast@11.1.2':
+    resolution: {integrity: sha512-Z9zfXR5jNZb1Hlsd/p+4XWeUFugrHirq36bKzPWDSIacV+GPSVXdk+ahVWZTwjhNwofAWg/sZg58fyucKSQx5g==}
+
+  '@chevrotain/regexp-to-ast@11.1.2':
+    resolution: {integrity: sha512-nMU3Uj8naWer7xpZTYJdxbAs6RIv/dxYzkYU8GSwgUtcAAlzjcPfX1w+RKRcYG8POlzMeayOQ/znfwxEGo5ulw==}
+
+  '@chevrotain/types@11.1.2':
+    resolution: {integrity: sha512-U+HFai5+zmJCkK86QsaJtoITlboZHBqrVketcO2ROv865xfCMSFpELQoz1GkX5GzME8pTa+3kbKrZHQtI0gdbw==}
+
+  '@chevrotain/utils@11.1.2':
+    resolution: {integrity: sha512-4mudFAQ6H+MqBTfqLmU7G1ZwRzCLfJEooL/fsF6rCX5eePMbGhoy5n4g+G4vlh2muDcsCTJtL+uKbOzWxs5LHA==}
+
   '@codemirror/autocomplete@6.20.0':
     resolution: {integrity: sha512-bOwvTOIJcG5FVo5gUUupiwYh8MioPLQ4UcqbcRf7UQ98X90tCa9E1kZ3Z7tqwpZxYyOvh1YTYbmZE9RTfTp5hg==}
 
@@ -1043,6 +1073,12 @@ packages:
     resolution: {integrity: sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==}
     engines: {node: '>=18.18'}
 
+  '@iconify/types@2.0.0':
+    resolution: {integrity: sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg==}
+
+  '@iconify/utils@3.1.0':
+    resolution: {integrity: sha512-Zlzem1ZXhI1iHeeERabLNzBHdOa4VhQbqAcOQaMKuTuyZCpwKbC2R4Dd0Zo3g9EAc+Y4fiarO8HIHRAth7+skw==}
+
   '@isaacs/balanced-match@4.0.1':
     resolution: {integrity: sha512-yzMTt9lEb8Gv7zRioUilSglI0c0smZ9k5D65677DLWLtWJaXIS3CqcGyUFByYKlnUj6TkjLVs54fBl6+TiGQDQ==}
     engines: {node: 20 || >=22}
@@ -1158,6 +1194,9 @@ packages:
   '@marijn/find-cluster-break@1.0.2':
     resolution: {integrity: sha512-l0h88YhZFyKdXIFNfSWpyjStDjGHwZ/U7iobcK1cQQD8sejsONdQtTVU+1wVN1PBw40PiiHB1vA5S7VTfQiP9g==}
 
+  '@mermaid-js/parser@1.0.0':
+    resolution: {integrity: sha512-vvK0Hi/VWndxoh03Mmz6wa1KDriSPjS2XMZL/1l19HFwygiObEEoEwSDxOqyLzzAI6J2PU3261JjTMTO7x+BPw==}
+
   '@napi-rs/wasm-runtime@0.2.12':
     resolution: {integrity: sha512-ZVWUcfwY4E/yPitQJl481FjFo3K22D6qF0DuFH6Y/nbnE11GY5uguDxZMGXPQ8WQ0128MXQD7TnfHyK4oWoIJQ==}
 
@@ -1895,6 +1934,99 @@ packages:
   '@types/chai@5.2.3':
     resolution: {integrity: sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==}
 
+  '@types/d3-array@3.2.2':
+    resolution: {integrity: sha512-hOLWVbm7uRza0BYXpIIW5pxfrKe0W+D5lrFiAEYR+pb6w3N2SwSMaJbXdUfSEv+dT4MfHBLtn5js0LAWaO6otw==}
+
+  '@types/d3-axis@3.0.6':
+    resolution: {integrity: sha512-pYeijfZuBd87T0hGn0FO1vQ/cgLk6E1ALJjfkC0oJ8cbwkZl3TpgS8bVBLZN+2jjGgg38epgxb2zmoGtSfvgMw==}
+
+  '@types/d3-brush@3.0.6':
+    resolution: {integrity: sha512-nH60IZNNxEcrh6L1ZSMNA28rj27ut/2ZmI3r96Zd+1jrZD++zD3LsMIjWlvg4AYrHn/Pqz4CF3veCxGjtbqt7A==}
+
+  '@types/d3-chord@3.0.6':
+    resolution: {integrity: sha512-LFYWWd8nwfwEmTZG9PfQxd17HbNPksHBiJHaKuY1XeqscXacsS2tyoo6OdRsjf+NQYeB6XrNL3a25E3gH69lcg==}
+
+  '@types/d3-color@3.1.3':
+    resolution: {integrity: sha512-iO90scth9WAbmgv7ogoq57O9YpKmFBbmoEoCHDB2xMBY0+/KVrqAaCDyCE16dUspeOvIxFFRI+0sEtqDqy2b4A==}
+
+  '@types/d3-contour@3.0.6':
+    resolution: {integrity: sha512-BjzLgXGnCWjUSYGfH1cpdo41/hgdWETu4YxpezoztawmqsvCeep+8QGfiY6YbDvfgHz/DkjeIkkZVJavB4a3rg==}
+
+  '@types/d3-delaunay@6.0.4':
+    resolution: {integrity: sha512-ZMaSKu4THYCU6sV64Lhg6qjf1orxBthaC161plr5KuPHo3CNm8DTHiLw/5Eq2b6TsNP0W0iJrUOFscY6Q450Hw==}
+
+  '@types/d3-dispatch@3.0.7':
+    resolution: {integrity: sha512-5o9OIAdKkhN1QItV2oqaE5KMIiXAvDWBDPrD85e58Qlz1c1kI/J0NcqbEG88CoTwJrYe7ntUCVfeUl2UJKbWgA==}
+
+  '@types/d3-drag@3.0.7':
+    resolution: {integrity: sha512-HE3jVKlzU9AaMazNufooRJ5ZpWmLIoc90A37WU2JMmeq28w1FQqCZswHZ3xR+SuxYftzHq6WU6KJHvqxKzTxxQ==}
+
+  '@types/d3-dsv@3.0.7':
+    resolution: {integrity: sha512-n6QBF9/+XASqcKK6waudgL0pf/S5XHPPI8APyMLLUHd8NqouBGLsU8MgtO7NINGtPBtk9Kko/W4ea0oAspwh9g==}
+
+  '@types/d3-ease@3.0.2':
+    resolution: {integrity: sha512-NcV1JjO5oDzoK26oMzbILE6HW7uVXOHLQvHshBUW4UMdZGfiY6v5BeQwh9a9tCzv+CeefZQHJt5SRgK154RtiA==}
+
+  '@types/d3-fetch@3.0.7':
+    resolution: {integrity: sha512-fTAfNmxSb9SOWNB9IoG5c8Hg6R+AzUHDRlsXsDZsNp6sxAEOP0tkP3gKkNSO/qmHPoBFTxNrjDprVHDQDvo5aA==}
+
+  '@types/d3-force@3.0.10':
+    resolution: {integrity: sha512-ZYeSaCF3p73RdOKcjj+swRlZfnYpK1EbaDiYICEEp5Q6sUiqFaFQ9qgoshp5CzIyyb/yD09kD9o2zEltCexlgw==}
+
+  '@types/d3-format@3.0.4':
+    resolution: {integrity: sha512-fALi2aI6shfg7vM5KiR1wNJnZ7r6UuggVqtDA+xiEdPZQwy/trcQaHnwShLuLdta2rTymCNpxYTiMZX/e09F4g==}
+
+  '@types/d3-geo@3.1.0':
+    resolution: {integrity: sha512-856sckF0oP/diXtS4jNsiQw/UuK5fQG8l/a9VVLeSouf1/PPbBE1i1W852zVwKwYCBkFJJB7nCFTbk6UMEXBOQ==}
+
+  '@types/d3-hierarchy@3.1.7':
+    resolution: {integrity: sha512-tJFtNoYBtRtkNysX1Xq4sxtjK8YgoWUNpIiUee0/jHGRwqvzYxkq0hGVbbOGSz+JgFxxRu4K8nb3YpG3CMARtg==}
+
+  '@types/d3-interpolate@3.0.4':
+    resolution: {integrity: sha512-mgLPETlrpVV1YRJIglr4Ez47g7Yxjl1lj7YKsiMCb27VJH9W8NVM6Bb9d8kkpG/uAQS5AmbA48q2IAolKKo1MA==}
+
+  '@types/d3-path@3.1.1':
+    resolution: {integrity: sha512-VMZBYyQvbGmWyWVea0EHs/BwLgxc+MKi1zLDCONksozI4YJMcTt8ZEuIR4Sb1MMTE8MMW49v0IwI5+b7RmfWlg==}
+
+  '@types/d3-polygon@3.0.2':
+    resolution: {integrity: sha512-ZuWOtMaHCkN9xoeEMr1ubW2nGWsp4nIql+OPQRstu4ypeZ+zk3YKqQT0CXVe/PYqrKpZAi+J9mTs05TKwjXSRA==}
+
+  '@types/d3-quadtree@3.0.6':
+    resolution: {integrity: sha512-oUzyO1/Zm6rsxKRHA1vH0NEDG58HrT5icx/azi9MF1TWdtttWl0UIUsjEQBBh+SIkrpd21ZjEv7ptxWys1ncsg==}
+
+  '@types/d3-random@3.0.3':
+    resolution: {integrity: sha512-Imagg1vJ3y76Y2ea0871wpabqp613+8/r0mCLEBfdtqC7xMSfj9idOnmBYyMoULfHePJyxMAw3nWhJxzc+LFwQ==}
+
+  '@types/d3-scale-chromatic@3.1.0':
+    resolution: {integrity: sha512-iWMJgwkK7yTRmWqRB5plb1kadXyQ5Sj8V/zYlFGMUBbIPKQScw+Dku9cAAMgJG+z5GYDoMjWGLVOvjghDEFnKQ==}
+
+  '@types/d3-scale@4.0.9':
+    resolution: {integrity: sha512-dLmtwB8zkAeO/juAMfnV+sItKjlsw2lKdZVVy6LRr0cBmegxSABiLEpGVmSJJ8O08i4+sGR6qQtb6WtuwJdvVw==}
+
+  '@types/d3-selection@3.0.11':
+    resolution: {integrity: sha512-bhAXu23DJWsrI45xafYpkQ4NtcKMwWnAC/vKrd2l+nxMFuvOT3XMYTIj2opv8vq8AO5Yh7Qac/nSeP/3zjTK0w==}
+
+  '@types/d3-shape@3.1.8':
+    resolution: {integrity: sha512-lae0iWfcDeR7qt7rA88BNiqdvPS5pFVPpo5OfjElwNaT2yyekbM0C9vK+yqBqEmHr6lDkRnYNoTBYlAgJa7a4w==}
+
+  '@types/d3-time-format@4.0.3':
+    resolution: {integrity: sha512-5xg9rC+wWL8kdDj153qZcsJ0FWiFt0J5RB6LYUNZjwSnesfblqrI/bJ1wBdJ8OQfncgbJG5+2F+qfqnqyzYxyg==}
+
+  '@types/d3-time@3.0.4':
+    resolution: {integrity: sha512-yuzZug1nkAAaBlBBikKZTgzCeA+k1uy4ZFwWANOfKw5z5LRhV0gNA7gNkKm7HoK+HRN0wX3EkxGk0fpbWhmB7g==}
+
+  '@types/d3-timer@3.0.2':
+    resolution: {integrity: sha512-Ps3T8E8dZDam6fUyNiMkekK3XUsaUEik+idO9/YjPtfj2qruF8tFBXS7XhtE4iIXBLxhmLjP3SXpLhVf21I9Lw==}
+
+  '@types/d3-transition@3.0.9':
+    resolution: {integrity: sha512-uZS5shfxzO3rGlu0cC3bjmMFKsXv+SmZZcgp0KD22ts4uGXp5EVYGzu/0YdwZeKmddhcAccYtREJKkPfXkZuCg==}
+
+  '@types/d3-zoom@3.0.8':
+    resolution: {integrity: sha512-iqMC4/YlFCSlO8+2Ii1GGGliCAY4XdeG748w5vQUbevlbDu0zSjH/+jojorQVBK/se0j6DUFNPBGSqD3YWYnDw==}
+
+  '@types/d3@7.4.3':
+    resolution: {integrity: sha512-lZXZ9ckh5R8uiFVt8ogUNf+pIrK4EsWrx2Np75WvF/eTpJ0FMHNhjXk8CKEx/+gpHbNQyJWehbFaTvqmHWB3ww==}
+
   '@types/debug@4.1.12':
     resolution: {integrity: sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ==}
 
@@ -1910,6 +2042,9 @@ packages:
   '@types/fs-extra@9.0.13':
     resolution: {integrity: sha512-nEnwB++1u5lVDM2UI4c1+5R+FYaKfaAzS4OococimjVm3nQw3TuzH5UNsocrcTBbhnerblyHj4A49qXbIiZdpA==}
 
+  '@types/geojson@7946.0.16':
+    resolution: {integrity: sha512-6C8nqWur3j98U6+lXDfTUWIfgvZU+EumvpHKcYjujKH7woYyLj2sUmff0tRhrqM7BohUw7Pz3ZB1jj2gW9Fvmg==}
+
   '@types/hast@3.0.4':
     resolution: {integrity: sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==}
 
@@ -1963,6 +2098,9 @@ packages:
   '@types/ssh2@1.15.5':
     resolution: {integrity: sha512-N1ASjp/nXH3ovBHddRJpli4ozpk6UdDYIX4RJWFa9L1YKnzdhTlVmiGHm4DZnj/jLbqZpes4aeR30EFGQtvhQQ==}
 
+  '@types/trusted-types@2.0.7':
+    resolution: {integrity: sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==}
+
   '@types/unist@2.0.11':
     resolution: {integrity: sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==}
 
@@ -2599,6 +2737,14 @@ packages:
     resolution: {integrity: sha512-PAJdDJusoxnwm1VwW07VWwUN1sl7smmC3OKggvndJFadxxDRyFJBX/ggnu/KE4kQAB7a3Dp8f/YXC1FlUprWmA==}
     engines: {node: '>= 16'}
 
+  chevrotain-allstar@0.3.1:
+    resolution: {integrity: sha512-b7g+y9A0v4mxCW1qUhf3BSVPg+/NvGErk/dOkrDaHA0nQIQGAtrOjlX//9OQtRlSCy+x9rfB5N8yC71lH1nvMw==}
+    peerDependencies:
+      chevrotain: ^11.0.0
+
+  chevrotain@11.1.2:
+    resolution: {integrity: sha512-opLQzEVriiH1uUQ4Kctsd49bRoFDXGGSC4GUqj7pGyxM3RehRhvTlZJc1FL/Flew2p5uwxa1tUDWKzI4wNM8pg==}
+
   chokidar@3.6.0:
     resolution: {integrity: sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==}
     engines: {node: '>= 8.10.0'}
@@ -2706,6 +2852,14 @@ packages:
     resolution: {integrity: sha512-P0CysNDQ7rtVw4QIQtm+MRxV66vKFSvlsQvGYXZWR3qFU0jlMKHZZZgw8e+8DSah4UDKMqnknRDQz+xuQXQ/Zg==}
     engines: {node: '>= 6'}
 
+  commander@7.2.0:
+    resolution: {integrity: sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw==}
+    engines: {node: '>= 10'}
+
+  commander@8.3.0:
+    resolution: {integrity: sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==}
+    engines: {node: '>= 12'}
+
   compare-version@0.1.2:
     resolution: {integrity: sha512-pJDh5/4wrEnXX/VWRZvruAGHkzKdr46z11OlTPN+VrATlWWhSKewNCJ1futCO5C7eJB3nPMFZA1LeYtcFboZ2A==}
     engines: {node: '>=0.10.0'}
@@ -2717,6 +2871,9 @@ packages:
   concat-map@0.0.1:
     resolution: {integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==}
 
+  confbox@0.1.8:
+    resolution: {integrity: sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==}
+
   config-file-ts@0.2.6:
     resolution: {integrity: sha512-6boGVaglwblBgJqGyxm4+xCmEGcWgnWHSWHY5jad58awQhB6gftq0G8HbzU39YqCIYHMLAiL1yjwiZ36m/CL8w==}
 
@@ -2743,6 +2900,12 @@ packages:
   core-util-is@1.0.3:
     resolution: {integrity: sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==}
 
+  cose-base@1.0.3:
+    resolution: {integrity: sha512-s9whTXInMSgAp/NVXVNuVxVKzGH2qck3aQlVHxDCdAEPgtMKwc4Wq6/QKhgdEdgbLSi9rBTAcPoRa6JpiG4ksg==}
+
+  cose-base@2.2.0:
+    resolution: {integrity: sha512-AzlgcsCbUMymkADOJtQm3wO9S3ltPfYOFD5033keQn9NJzIbtnZj+UdBJe7DYml/8TdbtHJW3j58SOnKhWY/5g==}
+
   cpu-features@0.0.10:
     resolution: {integrity: sha512-9IkYqtX3YHPCzoVg1Py+o9057a3i0fp7S530UWokCSaFVTc7CwXPRiOjRjBQQ18ZCNafx78YfnG+HALxtVmOGA==}
     engines: {node: '>=10.0.0'}
@@ -2774,6 +2937,162 @@ packages:
   csstype@3.2.3:
     resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}
 
+  cytoscape-cose-bilkent@4.1.0:
+    resolution: {integrity: sha512-wgQlVIUJF13Quxiv5e1gstZ08rnZj2XaLHGoFMYXz7SkNfCDOOteKBE6SYRfA9WxxI/iBc3ajfDoc6hb/MRAHQ==}
+    peerDependencies:
+      cytoscape: ^3.2.0
+
+  cytoscape-fcose@2.2.0:
+    resolution: {integrity: sha512-ki1/VuRIHFCzxWNrsshHYPs6L7TvLu3DL+TyIGEsRcvVERmxokbf5Gdk7mFxZnTdiGtnA4cfSmjZJMviqSuZrQ==}
+    peerDependencies:
+      cytoscape: ^3.2.0
+
+  cytoscape@3.33.1:
+    resolution: {integrity: sha512-iJc4TwyANnOGR1OmWhsS9ayRS3s+XQ185FmuHObThD+5AeJCakAAbWv8KimMTt08xCCLNgneQwFp+JRJOr9qGQ==}
+    engines: {node: '>=0.10'}
+
+  d3-array@2.12.1:
+    resolution: {integrity: sha512-B0ErZK/66mHtEsR1TkPEEkwdy+WDesimkM5gpZr5Dsg54BiTA5RXtYW5qTLIAcekaS9xfZrzBLF/OAkB3Qn1YQ==}
+
+  d3-array@3.2.4:
+    resolution: {integrity: sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg==}
+    engines: {node: '>=12'}
+
+  d3-axis@3.0.0:
+    resolution: {integrity: sha512-IH5tgjV4jE/GhHkRV0HiVYPDtvfjHQlQfJHs0usq7M30XcSBvOotpmH1IgkcXsO/5gEQZD43B//fc7SRT5S+xw==}
+    engines: {node: '>=12'}
+
+  d3-brush@3.0.0:
+    resolution: {integrity: sha512-ALnjWlVYkXsVIGlOsuWH1+3udkYFI48Ljihfnh8FZPF2QS9o+PzGLBslO0PjzVoHLZ2KCVgAM8NVkXPJB2aNnQ==}
+    engines: {node: '>=12'}
+
+  d3-chord@3.0.1:
+    resolution: {integrity: sha512-VE5S6TNa+j8msksl7HwjxMHDM2yNK3XCkusIlpX5kwauBfXuyLAtNg9jCp/iHH61tgI4sb6R/EIMWCqEIdjT/g==}
+    engines: {node: '>=12'}
+
+  d3-color@3.1.0:
+    resolution: {integrity: sha512-zg/chbXyeBtMQ1LbD/WSoW2DpC3I0mpmPdW+ynRTj/x2DAWYrIY7qeZIHidozwV24m4iavr15lNwIwLxRmOxhA==}
+    engines: {node: '>=12'}
+
+  d3-contour@4.0.2:
+    resolution: {integrity: sha512-4EzFTRIikzs47RGmdxbeUvLWtGedDUNkTcmzoeyg4sP/dvCexO47AaQL7VKy/gul85TOxw+IBgA8US2xwbToNA==}
+    engines: {node: '>=12'}
+
+  d3-delaunay@6.0.4:
+    resolution: {integrity: sha512-mdjtIZ1XLAM8bm/hx3WwjfHt6Sggek7qH043O8KEjDXN40xi3vx/6pYSVTwLjEgiXQTbvaouWKynLBiUZ6SK6A==}
+    engines: {node: '>=12'}
+
+  d3-dispatch@3.0.1:
+    resolution: {integrity: sha512-rzUyPU/S7rwUflMyLc1ETDeBj0NRuHKKAcvukozwhshr6g6c5d8zh4c2gQjY2bZ0dXeGLWc1PF174P2tVvKhfg==}
+    engines: {node: '>=12'}
+
+  d3-drag@3.0.0:
+    resolution: {integrity: sha512-pWbUJLdETVA8lQNJecMxoXfH6x+mO2UQo8rSmZ+QqxcbyA3hfeprFgIT//HW2nlHChWeIIMwS2Fq+gEARkhTkg==}
+    engines: {node: '>=12'}
+
+  d3-dsv@3.0.1:
+    resolution: {integrity: sha512-UG6OvdI5afDIFP9w4G0mNq50dSOsXHJaRE8arAS5o9ApWnIElp8GZw1Dun8vP8OyHOZ/QJUKUJwxiiCCnUwm+Q==}
+    engines: {node: '>=12'}
+    hasBin: true
+
+  d3-ease@3.0.1:
+    resolution: {integrity: sha512-wR/XK3D3XcLIZwpbvQwQ5fK+8Ykds1ip7A2Txe0yxncXSdq1L9skcG7blcedkOX+ZcgxGAmLX1FrRGbADwzi0w==}
+    engines: {node: '>=12'}
+
+  d3-fetch@3.0.1:
+    resolution: {integrity: sha512-kpkQIM20n3oLVBKGg6oHrUchHM3xODkTzjMoj7aWQFq5QEM+R6E4WkzT5+tojDY7yjez8KgCBRoj4aEr99Fdqw==}
+    engines: {node: '>=12'}
+
+  d3-force@3.0.0:
+    resolution: {integrity: sha512-zxV/SsA+U4yte8051P4ECydjD/S+qeYtnaIyAs9tgHCqfguma/aAQDjo85A9Z6EKhBirHRJHXIgJUlffT4wdLg==}
+    engines: {node: '>=12'}
+
+  d3-format@3.1.2:
+    resolution: {integrity: sha512-AJDdYOdnyRDV5b6ArilzCPPwc1ejkHcoyFarqlPqT7zRYjhavcT3uSrqcMvsgh2CgoPbK3RCwyHaVyxYcP2Arg==}
+    engines: {node: '>=12'}
+
+  d3-geo@3.1.1:
+    resolution: {integrity: sha512-637ln3gXKXOwhalDzinUgY83KzNWZRKbYubaG+fGVuc/dxO64RRljtCTnf5ecMyE1RIdtqpkVcq0IbtU2S8j2Q==}
+    engines: {node: '>=12'}
+
+  d3-hierarchy@3.1.2:
+    resolution: {integrity: sha512-FX/9frcub54beBdugHjDCdikxThEqjnR93Qt7PvQTOHxyiNCAlvMrHhclk3cD5VeAaq9fxmfRp+CnWw9rEMBuA==}
+    engines: {node: '>=12'}
+
+  d3-interpolate@3.0.1:
+    resolution: {integrity: sha512-3bYs1rOD33uo8aqJfKP3JWPAibgw8Zm2+L9vBKEHJ2Rg+viTR7o5Mmv5mZcieN+FRYaAOWX5SJATX6k1PWz72g==}
+    engines: {node: '>=12'}
+
+  d3-path@1.0.9:
+    resolution: {integrity: sha512-VLaYcn81dtHVTjEHd8B+pbe9yHWpXKZUC87PzoFmsFrJqgFwDe/qxfp5MlfsfM1V5E/iVt0MmEbWQ7FVIXh/bg==}
+
+  d3-path@3.1.0:
+    resolution: {integrity: sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ==}
+    engines: {node: '>=12'}
+
+  d3-polygon@3.0.1:
+    resolution: {integrity: sha512-3vbA7vXYwfe1SYhED++fPUQlWSYTTGmFmQiany/gdbiWgU/iEyQzyymwL9SkJjFFuCS4902BSzewVGsHHmHtXg==}
+    engines: {node: '>=12'}
+
+  d3-quadtree@3.0.1:
+    resolution: {integrity: sha512-04xDrxQTDTCFwP5H6hRhsRcb9xxv2RzkcsygFzmkSIOJy3PeRJP7sNk3VRIbKXcog561P9oU0/rVH6vDROAgUw==}
+    engines: {node: '>=12'}
+
+  d3-random@3.0.1:
+    resolution: {integrity: sha512-FXMe9GfxTxqd5D6jFsQ+DJ8BJS4E/fT5mqqdjovykEB2oFbTMDVdg1MGFxfQW+FBOGoB++k8swBrgwSHT1cUXQ==}
+    engines: {node: '>=12'}
+
+  d3-sankey@0.12.3:
+    resolution: {integrity: sha512-nQhsBRmM19Ax5xEIPLMY9ZmJ/cDvd1BG3UVvt5h3WRxKg5zGRbvnteTyWAbzeSvlh3tW7ZEmq4VwR5mB3tutmQ==}
+
+  d3-scale-chromatic@3.1.0:
+    resolution: {integrity: sha512-A3s5PWiZ9YCXFye1o246KoscMWqf8BsD9eRiJ3He7C9OBaxKhAd5TFCdEx/7VbKtxxTsu//1mMJFrEt572cEyQ==}
+    engines: {node: '>=12'}
+
+  d3-scale@4.0.2:
+    resolution: {integrity: sha512-GZW464g1SH7ag3Y7hXjf8RoUuAFIqklOAq3MRl4OaWabTFJY9PN/E1YklhXLh+OQ3fM9yS2nOkCoS+WLZ6kvxQ==}
+    engines: {node: '>=12'}
+
+  d3-selection@3.0.0:
+    resolution: {integrity: sha512-fmTRWbNMmsmWq6xJV8D19U/gw/bwrHfNXxrIN+HfZgnzqTHp9jOmKMhsTUjXOJnZOdZY9Q28y4yebKzqDKlxlQ==}
+    engines: {node: '>=12'}
+
+  d3-shape@1.3.7:
+    resolution: {integrity: sha512-EUkvKjqPFUAZyOlhY5gzCxCeI0Aep04LwIRpsZ/mLFelJiUfnK56jo5JMDSE7yyP2kLSb6LtF+S5chMk7uqPqw==}
+
+  d3-shape@3.2.0:
+    resolution: {integrity: sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA==}
+    engines: {node: '>=12'}
+
+  d3-time-format@4.1.0:
+    resolution: {integrity: sha512-dJxPBlzC7NugB2PDLwo9Q8JiTR3M3e4/XANkreKSUxF8vvXKqm1Yfq4Q5dl8budlunRVlUUaDUgFt7eA8D6NLg==}
+    engines: {node: '>=12'}
+
+  d3-time@3.1.0:
+    resolution: {integrity: sha512-VqKjzBLejbSMT4IgbmVgDjpkYrNWUYJnbCGo874u7MMKIWsILRX+OpX/gTk8MqjpT1A/c6HY2dCA77ZN0lkQ2Q==}
+    engines: {node: '>=12'}
+
+  d3-timer@3.0.1:
+    resolution: {integrity: sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA==}
+    engines: {node: '>=12'}
+
+  d3-transition@3.0.1:
+    resolution: {integrity: sha512-ApKvfjsSR6tg06xrL434C0WydLr7JewBB3V+/39RMHsaXTOG0zmt/OAXeng5M5LBm0ojmxJrpomQVZ1aPvBL4w==}
+    engines: {node: '>=12'}
+    peerDependencies:
+      d3-selection: 2 - 3
+
+  d3-zoom@3.0.0:
+    resolution: {integrity: sha512-b8AmV3kfQaqWAuacbPuNbL6vahnOJflOhexLzMMNLga62+/nh0JzvJ0aO/5a5MVgUFGS7Hu1P9P03o3fJkDCyw==}
+    engines: {node: '>=12'}
+
+  d3@7.9.0:
+    resolution: {integrity: sha512-e1U46jVP+w7Iut8Jt8ri1YsPOvFpg46k+K8TpCb0P+zjCkjkPnV7WzfDJzMHy1LnA+wj5pLT1wjO901gLXeEhA==}
+    engines: {node: '>=12'}
+
+  dagre-d3-es@7.0.13:
+    resolution: {integrity: sha512-efEhnxpSuwpYOKRm/L5KbqoZmNNukHa/Flty4Wp62JRvgH2ojwVgPgdYyr4twpieZnyRDdIH7PY2mopX26+j2Q==}
+
   damerau-levenshtein@1.0.8:
     resolution: {integrity: sha512-sdQSFB7+llfUcQHUQO3+B8ERRj0Oa4w9POWMI/puGtuf7gFywGmkaLCElnudfTiKZV+NvHqL0ifzdrI8Ro7ESA==}
 
@@ -2792,6 +3111,9 @@ packages:
   date-fns@3.6.0:
     resolution: {integrity: sha512-fRHTG8g/Gif+kSh50gaGEdToemgfj74aRX3swtiouboip5JDLAyDE9F11nHMIcvOaXeOC6D7SpNhi7uFyB7Uww==}
 
+  dayjs@1.11.19:
+    resolution: {integrity: sha512-t5EcLVS6QPBNqM2z8fakk/NKel+Xzshgt8FFKAn+qwlD1pzZWxh0nVCrvFK7ZDb6XucZeF9z8C7CBWTRIVApAw==}
+
   debug@3.2.7:
     resolution: {integrity: sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==}
     peerDependencies:
@@ -2838,6 +3160,9 @@ packages:
     resolution: {integrity: sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==}
     engines: {node: '>= 0.4'}
 
+  delaunator@5.0.1:
+    resolution: {integrity: sha512-8nvh+XBe96aCESrGOqMp/84b13H9cdKbG5P2ejQCh4d4sK9RL4371qou9drQjMhvnPmhWl5hnmqbEE0fXr9Xnw==}
+
   delayed-stream@1.0.0:
     resolution: {integrity: sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==}
     engines: {node: '>=0.4.0'}
@@ -2895,6 +3220,9 @@ packages:
     resolution: {integrity: sha512-35mSku4ZXK0vfCuHEDAwt55dg2jNajHZ1odvF+8SSr82EsZY4QmXfuWso8oEd8zRhVObSN18aM0CjSdoBX7zIw==}
     engines: {node: '>=0.10.0'}
 
+  dompurify@3.3.1:
+    resolution: {integrity: sha512-qkdCKzLNtrgPFP1Vo+98FRzJnBRGe4ffyCea9IwHB1fyxPOeNTHpLKYGd4Uk9xvNoH0ZoOjwZxNptyMwqrId1Q==}
+
   dotenv-expand@11.0.7:
     resolution: {integrity: sha512-zIHwmZPRshsCdpMDyVsqGmgyP0yT8GAgXUnkdAoJisxvf33k7yO6OuoKmcTGuXPWSsm8Oh88nZicRLA9Y0rUeA==}
     engines: {node: '>=12'}
@@ -2973,6 +3301,10 @@ packages:
   end-of-stream@1.4.5:
     resolution: {integrity: sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==}
 
+  entities@6.0.1:
+    resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}
+    engines: {node: '>=0.12'}
+
   env-paths@2.2.1:
     resolution: {integrity: sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==}
     engines: {node: '>=6'}
@@ -3468,6 +3800,9 @@ packages:
   graceful-fs@4.2.11:
     resolution: {integrity: sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==}
 
+  hachure-fill@0.5.2:
+    resolution: {integrity: sha512-3GKBOn+m2LX9iq+JC1064cSFprJY4jL1jCXTcpnfER5HYE2l/4EfWSGzkPa/ZDBmYI0ZOEj5VHV/eKnPGkHuOg==}
+
   handlebars@4.7.8:
     resolution: {integrity: sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==}
     engines: {node: '>=0.4.7'}
@@ -3507,18 +3842,33 @@ packages:
     resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==}
     engines: {node: '>= 0.4'}
 
+  hast-util-from-parse5@8.0.3:
+    resolution: {integrity: sha512-3kxEVkEKt0zvcZ3hCRYI8rqrgwtlIOFMWkbclACvjlDw8Li9S2hk/d51OI0nr/gIpdMHNepwgOKqZ/sy0Clpyg==}
+
   hast-util-is-element@3.0.0:
     resolution: {integrity: sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g==}
 
+  hast-util-parse-selector@4.0.0:
+    resolution: {integrity: sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==}
+
+  hast-util-raw@9.1.0:
+    resolution: {integrity: sha512-Y8/SBAHkZGoNkpzqqfCldijcuUKh7/su31kEBp67cFY09Wy0mTRgtsLYsiIxMJxlu0f6AA5SUTbDR8K0rxnbUw==}
+
   hast-util-to-jsx-runtime@2.3.6:
     resolution: {integrity: sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==}
 
+  hast-util-to-parse5@8.0.1:
+    resolution: {integrity: sha512-MlWT6Pjt4CG9lFCjiz4BH7l9wmrMkfkJYCxFwKQic8+RTZgWPuWxwAfjJElsXkex7DJjfSJsQIt931ilUgmwdA==}
+
   hast-util-to-text@4.0.2:
     resolution: {integrity: sha512-KK6y/BN8lbaq654j7JgBydev7wuNMcID54lkRav1P0CaE1e47P72AWWPiGKXTJU271ooYzcvTAn/Zt0REnvc7A==}
 
   hast-util-whitespace@3.0.0:
     resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==}
 
+  hastscript@9.0.1:
+    resolution: {integrity: sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==}
+
   hermes-estree@0.25.1:
     resolution: {integrity: sha512-0wUoCcLp+5Ev5pDW2OriHC2MJCbwLwuRx+gAqMTOkGKJJiBCLjtrvy4PWUGn6MIVefecRpzoOZ/UV6iGdOr+Cw==}
 
@@ -3539,6 +3889,9 @@ packages:
   html-url-attributes@3.0.1:
     resolution: {integrity: sha512-ol6UPyBWqsrO6EJySPz2O7ZSr856WDrEzM5zMqp+FJJLGMW35cLYmmZnl0vztAZxRUoNZJFTCohfjuIJ8I4QBQ==}
 
+  html-void-elements@3.0.0:
+    resolution: {integrity: sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==}
+
   http-cache-semantics@4.2.0:
     resolution: {integrity: sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==}
 
@@ -3626,6 +3979,13 @@ packages:
     resolution: {integrity: sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==}
     engines: {node: '>= 0.4'}
 
+  internmap@1.0.1:
+    resolution: {integrity: sha512-lDB5YccMydFBtasVtxnZ3MRBHuaoE8GKsppq+EchKL2U4nK/DmEpPHNH8MZe5HkMtpSiTSOZwfN0tzYjO/lJEw==}
+
+  internmap@2.0.3:
+    resolution: {integrity: sha512-5Hh7Y1wQbvY5ooGgPbDaL5iYLAPzMTUrjMulskHLH6wnv/A+1q5rgEaiuqEjB+oxGXIVZs1FF+R/KPN3ZSQYYg==}
+    engines: {node: '>=12'}
+
   ip-address@10.1.0:
     resolution: {integrity: sha512-XXADHxXmvT9+CRxhXg56LJovE+bmWnEWB78LB83VZTprKTmaC5QfruXocxzTZ2Kl0DNwKuBdlIhjL8LeY8Sf8Q==}
     engines: {node: '>= 12'}
@@ -3897,9 +4257,16 @@ packages:
     resolution: {integrity: sha512-ZZow9HBI5O6EPgSJLUb8n2NKgmVWTwCvHGwFuJlMjvLFqlGG6pjirPhtdsseaLZjSibD8eegzmYpUZwoIlj2cQ==}
     engines: {node: '>=4.0'}
 
+  katex@0.16.33:
+    resolution: {integrity: sha512-q3N5u+1sY9Bu7T4nlXoiRBXWfwSefNGoKeOwekV+gw0cAXQlz2Ww6BLcmBxVDeXBMUDQv6fK5bcNaJLxob3ZQA==}
+    hasBin: true
+
   keyv@4.5.4:
     resolution: {integrity: sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==}
 
+  khroma@2.1.0:
+    resolution: {integrity: sha512-Ls993zuzfayK269Svk9hzpeGUKob/sIgZzyHYdjQoAdQetRKpOLj+k/QQQ/6Qi0Yz65mlROrfd+Ev+1+7dz9Kw==}
+
   knip@5.82.1:
     resolution: {integrity: sha512-1nQk+5AcnkqL40kGQXfouzAEXkTR+eSrgo/8m1d0BMei4eAzFwghoXC4gOKbACgBiCof7hE8wkBVDsEvznf85w==}
     engines: {node: '>=18.18.0'}
@@ -3908,6 +4275,10 @@ packages:
       '@types/node': '>=18'
       typescript: '>=5.0.4 <7'
 
+  langium@4.2.1:
+    resolution: {integrity: sha512-zu9QWmjpzJcomzdJQAHgDVhLGq5bLosVak1KVa40NzQHXfqr4eAHupvnPOVXEoLkg6Ocefvf/93d//SB7du4YQ==}
+    engines: {node: '>=20.10.0', npm: '>=10.2.3'}
+
   language-subtag-registry@0.3.23:
     resolution: {integrity: sha512-0K65Lea881pHotoGEa5gDlMxt3pctLi2RplBb7Ezh4rRdLEOtgi7n4EwK9lamnUCkKBqaeKRVebTq6BAxSkpXQ==}
 
@@ -3915,6 +4286,12 @@ packages:
     resolution: {integrity: sha512-MbjN408fEndfiQXbFQ1vnd+1NoLDsnQW41410oQBXiyXDMYH5z505juWa4KUE1LqxRC7DgOgZDbKLxHIwm27hA==}
     engines: {node: '>=0.10'}
 
+  layout-base@1.0.2:
+    resolution: {integrity: sha512-8h2oVEZNktL4BH2JCOI90iD1yXwL6iNW7KcCKT2QZgQJR2vbqDsldCTPRU9NifTCqHZci57XvQQ15YTu+sTYPg==}
+
+  layout-base@2.0.1:
+    resolution: {integrity: sha512-dp3s92+uNI1hWIpPGH3jK2kxE2lMjdXdr+DH8ynZHpd6PUlH6x6cbuXnoMmiNumznqaNO31xu9e79F0uuZ0JFg==}
+
   lazy-val@1.0.5:
     resolution: {integrity: sha512-0/BnGCCfyUMkBpeDgWihanIAF9JmZhHBgUhEqzvf+adhNGLoP6TaiI5oF8oyb3I45P+PcnrqihSf01M0l0G5+Q==}
 
@@ -3949,6 +4326,9 @@ packages:
     resolution: {integrity: sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==}
     engines: {node: '>=10'}
 
+  lodash-es@4.17.23:
+    resolution: {integrity: sha512-kVI48u3PZr38HdYz98UmfPnXl2DXrpdctLrFLCd3kOx1xUkOmpFPx7gCWWM5MPkL/fD8zb+Ph0QzjGFs4+hHWg==}
+
   lodash.defaults@4.2.0:
     resolution: {integrity: sha512-qjxPLHd3r5DnsdGacqOMU6pb/avJzdh9tFX2ymgoZE27BmjXrNy/y4LoaiTeAb+O3gL8AfpJGtqfX/ae2leYYQ==}
 
@@ -4046,6 +4426,11 @@ packages:
   markdown-table@3.0.4:
     resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
 
+  marked@16.4.2:
+    resolution: {integrity: sha512-TI3V8YYWvkVf3KJe1dRkpnjs68JUPyEa5vjKrp1XEEJUAOaQc+Qj+L1qWbPd0SJuAdQkFU0h73sXXqwDYxsiDA==}
+    engines: {node: '>= 20'}
+    hasBin: true
+
   matcher@3.0.0:
     resolution: {integrity: sha512-OkeDaAZ/bQCxeFAozM55PKcKU0yJMPGifLwV4Qgjitu+5MoAfSQN4lsLJeXZ1b8w0x+/Emda6MZgXS1jvsapng==}
     engines: {node: '>=10'}
@@ -4103,6 +4488,9 @@ packages:
     resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==}
     engines: {node: '>= 8'}
 
+  mermaid@11.12.3:
+    resolution: {integrity: sha512-wN5ZSgJQIC+CHJut9xaKWsknLxaFBwCPwPkGTSUYrTiHORWvpT8RxGk849HPnpUAQ+/9BPRqYb80jTpearrHzQ==}
+
   micromark-core-commonmark@2.0.3:
     resolution: {integrity: sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==}
 
@@ -4300,6 +4688,9 @@ packages:
     engines: {node: '>=10'}
     hasBin: true
 
+  mlly@1.8.0:
+    resolution: {integrity: sha512-l8D9ODSRWLe2KHJSifWGwBqpTZXIXTeo8mlKjY+E2HAakaTeNpqAyBZ8GSqLzHgw4XmHmC8whvpjJNMbFZN7/g==}
+
   ms@2.1.3:
     resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
 
@@ -4486,6 +4877,9 @@ packages:
   package-json-from-dist@1.0.1:
     resolution: {integrity: sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==}
 
+  package-manager-detector@1.6.0:
+    resolution: {integrity: sha512-61A5ThoTiDG/C8s8UMZwSorAGwMJ0ERVGj2OjoW5pAalsNOg15+iQiPzrLJ4jhZ1HJzmC2PIHT2oEiH3R5fzNA==}
+
   parent-module@1.0.1:
     resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==}
     engines: {node: '>=6'}
@@ -4493,6 +4887,12 @@ packages:
   parse-entities@4.0.2:
     resolution: {integrity: sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==}
 
+  parse5@7.3.0:
+    resolution: {integrity: sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==}
+
+  path-data-parser@0.1.0:
+    resolution: {integrity: sha512-NOnmBpt5Y2RWbuv0LMzsayp3lVylAHLPUTut412ZA3l+C4uw4ZVkQbjShYCQ8TCpUMdPapr4YjUqLYD6v68j+w==}
+
   path-exists@4.0.0:
     resolution: {integrity: sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==}
     engines: {node: '>=8'}
@@ -4564,10 +4964,19 @@ packages:
     resolution: {integrity: sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==}
     engines: {node: '>= 6'}
 
+  pkg-types@1.3.1:
+    resolution: {integrity: sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==}
+
   plist@3.1.0:
     resolution: {integrity: sha512-uysumyrvkUX0rX/dEVqt8gC3sTBzd4zoWfLeS29nb53imdaXVvLINYXTI2GNqzaMuvacNx4uJQ8+b3zXR0pkgQ==}
     engines: {node: '>=10.4.0'}
 
+  points-on-curve@0.2.0:
+    resolution: {integrity: sha512-0mYKnYYe9ZcqMCWhUjItv/oHjvgEsfKvnUTg8sAtnHr3GVy7rGkXCb6d5cSyqrWqL4k81b9CPg3urd+T7aop3A==}
+
+  points-on-path@0.2.1:
+    resolution: {integrity: sha512-25ClnWWuw7JbWZcgqY/gJ4FQWadKxGWk+3kR/7kD0tCaDtPPMj7oHu2ToLaVhfpnHrZzYby2w6tUA0eOIuUg8g==}
+
   possible-typed-array-names@1.1.0:
     resolution: {integrity: sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg==}
     engines: {node: '>= 0.4'}
@@ -4847,6 +5256,9 @@ packages:
   rehype-highlight@7.0.2:
     resolution: {integrity: sha512-k158pK7wdC2qL3M5NcZROZ2tR/l7zOzjxXd5VGdcfIyoijjQqpHd3JKtYSBDpDZ38UI2WJWuFAtkMDxmx5kstA==}
 
+  rehype-raw@7.0.0:
+    resolution: {integrity: sha512-/aE8hCfKlQeA8LmyeyQvQF3eBiLRGNlfBJEvWH7ivp9sBqs7TNqBL5X3v157rM4IFETqDnIOO+z5M/biZbo9Ww==}
+
   remark-gfm@4.0.1:
     resolution: {integrity: sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==}
 
@@ -4925,14 +5337,23 @@ packages:
     resolution: {integrity: sha512-CHhPh+UNHD2GTXNYhPWLnU8ONHdI+5DI+4EYIAOaiD63rHeYlZvyh8P+in5999TTSFgUYuKUAjzRI4mdh/p+2A==}
     engines: {node: '>=8.0'}
 
+  robust-predicates@3.0.2:
+    resolution: {integrity: sha512-IXgzBWvWQwE6PrDI05OvmXUIruQTcoMDzRsOd5CDvHCVLcLHMTSYvOK5Cm46kWqlV3yAbuSpBZdJ5oP5OUoStg==}
+
   rollup@4.55.1:
     resolution: {integrity: sha512-wDv/Ht1BNHB4upNbK74s9usvl7hObDnvVzknxqY/E/O3X6rW1U1rV1aENEfJ54eFZDTNo7zv1f5N4edCluH7+A==}
     engines: {node: '>=18.0.0', npm: '>=8.0.0'}
     hasBin: true
 
+  roughjs@4.6.6:
+    resolution: {integrity: sha512-ZUz/69+SYpFN/g/lUlo2FXcIjRkSu3nDarreVdGGndHEBJ6cXPdKguS8JGxwj5HA5xIbVKSmLgr5b3AWxtRfvQ==}
+
   run-parallel@1.2.0:
     resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}
 
+  rw@1.3.3:
+    resolution: {integrity: sha512-PdhdWy89SiZogBLaw42zdeqtRJ//zFd2PgQavcICDUgJT5oW10QCRKbJ6bg4r0/UY2M6BWd5tkxuGFRvCkgfHQ==}
+
   safe-array-concat@1.1.3:
     resolution: {integrity: sha512-AURm5f0jYEOydBj7VQlVvDrjeFgthDdEF5H1dP+6mNpoXOMo1quQqJ4wvJDyRZ9+pO3kGWoOdmV08cSv2aJV6Q==}
     engines: {node: '>=0.4'}
@@ -5237,6 +5658,9 @@ packages:
   style-to-object@1.0.14:
     resolution: {integrity: sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==}
 
+  stylis@4.3.6:
+    resolution: {integrity: sha512-yQ3rwFWRfwNUY7H5vpU0wfdkNSnvnJinhF9830Swlaxl03zsOjCfmX0ugac+3LtK0lYSgwL/KXc8oYL3mG4YFQ==}
+
   sucrase@3.35.1:
     resolution: {integrity: sha512-DhuTmvZWux4H1UOnWMB3sk0sbaCVOoQZjv8u1rDoTV0HTdGem9hkAZtl4JZy8P2z4Bg0nT+YMeOFyVr4zcG5Tw==}
     engines: {node: '>=16 || 14 >=14.17'}
@@ -5312,6 +5736,10 @@ packages:
   tinyexec@0.3.2:
     resolution: {integrity: sha512-KQQR9yN7R5+OSwaK0XQoj22pwHoTlgYqmUscPYoknOoWCWfj/5/ABTMRi69FrKU5ffPVh5QcFikpWJI/P1ocHA==}
 
+  tinyexec@1.0.2:
+    resolution: {integrity: sha512-W/KYk+NFhkmsYpuHq5JykngiOCnxeVL8v8dFnqxSD8qEEdRfXk1SDM6JzNqcERbcGYj9tMrDQBYV9cjgnunFIg==}
+    engines: {node: '>=18'}
+
   tinyglobby@0.2.15:
     resolution: {integrity: sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==}
     engines: {node: '>=12.0.0'}
@@ -5362,6 +5790,10 @@ packages:
     peerDependencies:
       typescript: '>=4.8.4'
 
+  ts-dedent@2.2.0:
+    resolution: {integrity: sha512-q5W7tVM71e2xjHZTlgfTDoPF/SmqKG5hddq9SzR49CH2hayqRKJtQ4mtRlSxKaJlR/+9rEM+mnBHf7I2/BQcpQ==}
+    engines: {node: '>=6.10'}
+
   ts-interface-checker@0.1.13:
     resolution: {integrity: sha512-Y/arvbn+rrz3JCKl9C4kVNfTfSm2/mEp5FSz5EsZSANGPSlQrpRI5M4PKF+mJnE52jOO90PnPSc3Ur3bTQw0gA==}
 
@@ -5415,6 +5847,9 @@ packages:
     engines: {node: '>=14.17'}
     hasBin: true
 
+  ufo@1.6.3:
+    resolution: {integrity: sha512-yDJTmhydvl5lJzBmy/hyOAA0d+aqCBuwl818haVdYCRrWV84o7YyeVm4QlVHStqNrrJSTb6jKuFAVqAFsr+K3Q==}
+
   uglify-js@3.19.3:
     resolution: {integrity: sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==}
     engines: {node: '>=0.8.0'}
@@ -5521,10 +5956,17 @@ packages:
   util-deprecate@1.0.2:
     resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}
 
+  uuid@11.1.0:
+    resolution: {integrity: sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A==}
+    hasBin: true
+
   verror@1.10.1:
     resolution: {integrity: sha512-veufcmxri4e3XSrT0xwfUR7kguIkaxBeosDg00yDWhk49wdwkSUrvvsm7nc75e1PUyvIeZj6nS8VQRYz2/S4Xg==}
     engines: {node: '>=0.6.0'}
 
+  vfile-location@5.0.3:
+    resolution: {integrity: sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==}
+
   vfile-message@4.0.3:
     resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==}
 
@@ -5595,6 +6037,26 @@ packages:
       jsdom:
         optional: true
 
+  vscode-jsonrpc@8.2.0:
+    resolution: {integrity: sha512-C+r0eKJUIfiDIfwJhria30+TYWPtuHJXHtI7J0YlOmKAo7ogxP20T0zxB7HZQIFhIyvoBPwWskjxrvAtfjyZfA==}
+    engines: {node: '>=14.0.0'}
+
+  vscode-languageserver-protocol@3.17.5:
+    resolution: {integrity: sha512-mb1bvRJN8SVznADSGWM9u/b07H7Ecg0I3OgXDuLdn307rl/J3A9YD6/eYOssqhecL27hK1IPZAsaqh00i/Jljg==}
+
+  vscode-languageserver-textdocument@1.0.12:
+    resolution: {integrity: sha512-cxWNPesCnQCcMPeenjKKsOCKQZ/L6Tv19DTRIGuLWe32lyzWhihGVJ/rcckZXJxfdKCFvRLS3fpBIsV/ZGX4zA==}
+
+  vscode-languageserver-types@3.17.5:
+    resolution: {integrity: sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg==}
+
+  vscode-languageserver@9.0.1:
+    resolution: {integrity: sha512-woByF3PDpkHFUreUa7Hos7+pUWdeWMXRd26+ZX2A8cFx6v/JPTtd4/uN0/jB6XQHYaOlHbio03NTHCqrgG5n7g==}
+    hasBin: true
+
+  vscode-uri@3.1.0:
+    resolution: {integrity: sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==}
+
   w3c-keyname@2.2.8:
     resolution: {integrity: sha512-dpojBhNsCNN7T82Tm7k26A6G9ML3NkhDsnw9n/eoxSRlVBB4CEtIQ/KTCLI2Fwf3ataSXRhYFkQi3SlnFwPvPQ==}
 
@@ -5605,6 +6067,9 @@ packages:
   wcwidth@1.0.1:
     resolution: {integrity: sha512-XHPEwS0q6TaxcvG85+8EYkbiCux2XtWG2mkc47Ng2A77BQu9+DqIOJldST4HgPkuea7dvKSj5VgX3P1d4rW8Tg==}
 
+  web-namespaces@2.0.1:
+    resolution: {integrity: sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==}
+
   whatwg-mimetype@3.0.0:
     resolution: {integrity: sha512-nt+N2dzIutVRxARx1nghPKGv1xHikU7HKdfafKkLNLindmPU/ch3U31NOCGGA/dmPcmb1VlofO0vnKAcsm0o/Q==}
     engines: {node: '>=12'}
@@ -5745,6 +6210,11 @@ snapshots:
       '@jridgewell/gen-mapping': 0.3.13
       '@jridgewell/trace-mapping': 0.3.31
 
+  '@antfu/install-pkg@1.1.0':
+    dependencies:
+      package-manager-detector: 1.6.0
+      tinyexec: 1.0.2
+
   '@babel/code-frame@7.28.6':
     dependencies:
       '@babel/helper-validator-identifier': 7.28.5
@@ -5878,6 +6348,25 @@ snapshots:
       - eslint-import-resolver-webpack
       - supports-color
 
+  '@braintree/sanitize-url@7.1.2': {}
+
+  '@chevrotain/cst-dts-gen@11.1.2':
+    dependencies:
+      '@chevrotain/gast': 11.1.2
+      '@chevrotain/types': 11.1.2
+      lodash-es: 4.17.23
+
+  '@chevrotain/gast@11.1.2':
+    dependencies:
+      '@chevrotain/types': 11.1.2
+      lodash-es: 4.17.23
+
+  '@chevrotain/regexp-to-ast@11.1.2': {}
+
+  '@chevrotain/types@11.1.2': {}
+
+  '@chevrotain/utils@11.1.2': {}
+
   '@codemirror/autocomplete@6.20.0':
     dependencies:
       '@codemirror/language': 6.12.1
@@ -6583,6 +7072,14 @@ snapshots:
 
   '@humanwhocodes/retry@0.4.3': {}
 
+  '@iconify/types@2.0.0': {}
+
+  '@iconify/utils@3.1.0':
+    dependencies:
+      '@antfu/install-pkg': 1.1.0
+      '@iconify/types': 2.0.0
+      mlly: 1.8.0
+
   '@isaacs/balanced-match@4.0.1': {}
 
   '@isaacs/brace-expansion@5.0.1':
@@ -6751,6 +7248,10 @@ snapshots:
 
   '@marijn/find-cluster-break@1.0.2': {}
 
+  '@mermaid-js/parser@1.0.0':
+    dependencies:
+      langium: 4.2.1
+
   '@napi-rs/wasm-runtime@0.2.12':
     dependencies:
       '@emnapi/core': 1.8.1
@@ -7429,6 +7930,123 @@ snapshots:
       '@types/deep-eql': 4.0.2
       assertion-error: 2.0.1
 
+  '@types/d3-array@3.2.2': {}
+
+  '@types/d3-axis@3.0.6':
+    dependencies:
+      '@types/d3-selection': 3.0.11
+
+  '@types/d3-brush@3.0.6':
+    dependencies:
+      '@types/d3-selection': 3.0.11
+
+  '@types/d3-chord@3.0.6': {}
+
+  '@types/d3-color@3.1.3': {}
+
+  '@types/d3-contour@3.0.6':
+    dependencies:
+      '@types/d3-array': 3.2.2
+      '@types/geojson': 7946.0.16
+
+  '@types/d3-delaunay@6.0.4': {}
+
+  '@types/d3-dispatch@3.0.7': {}
+
+  '@types/d3-drag@3.0.7':
+    dependencies:
+      '@types/d3-selection': 3.0.11
+
+  '@types/d3-dsv@3.0.7': {}
+
+  '@types/d3-ease@3.0.2': {}
+
+  '@types/d3-fetch@3.0.7':
+    dependencies:
+      '@types/d3-dsv': 3.0.7
+
+  '@types/d3-force@3.0.10': {}
+
+  '@types/d3-format@3.0.4': {}
+
+  '@types/d3-geo@3.1.0':
+    dependencies:
+      '@types/geojson': 7946.0.16
+
+  '@types/d3-hierarchy@3.1.7': {}
+
+  '@types/d3-interpolate@3.0.4':
+    dependencies:
+      '@types/d3-color': 3.1.3
+
+  '@types/d3-path@3.1.1': {}
+
+  '@types/d3-polygon@3.0.2': {}
+
+  '@types/d3-quadtree@3.0.6': {}
+
+  '@types/d3-random@3.0.3': {}
+
+  '@types/d3-scale-chromatic@3.1.0': {}
+
+  '@types/d3-scale@4.0.9':
+    dependencies:
+      '@types/d3-time': 3.0.4
+
+  '@types/d3-selection@3.0.11': {}
+
+  '@types/d3-shape@3.1.8':
+    dependencies:
+      '@types/d3-path': 3.1.1
+
+  '@types/d3-time-format@4.0.3': {}
+
+  '@types/d3-time@3.0.4': {}
+
+  '@types/d3-timer@3.0.2': {}
+
+  '@types/d3-transition@3.0.9':
+    dependencies:
+      '@types/d3-selection': 3.0.11
+
+  '@types/d3-zoom@3.0.8':
+    dependencies:
+      '@types/d3-interpolate': 3.0.4
+      '@types/d3-selection': 3.0.11
+
+  '@types/d3@7.4.3':
+    dependencies:
+      '@types/d3-array': 3.2.2
+      '@types/d3-axis': 3.0.6
+      '@types/d3-brush': 3.0.6
+      '@types/d3-chord': 3.0.6
+      '@types/d3-color': 3.1.3
+      '@types/d3-contour': 3.0.6
+      '@types/d3-delaunay': 6.0.4
+      '@types/d3-dispatch': 3.0.7
+      '@types/d3-drag': 3.0.7
+      '@types/d3-dsv': 3.0.7
+      '@types/d3-ease': 3.0.2
+      '@types/d3-fetch': 3.0.7
+      '@types/d3-force': 3.0.10
+      '@types/d3-format': 3.0.4
+      '@types/d3-geo': 3.1.0
+      '@types/d3-hierarchy': 3.1.7
+      '@types/d3-interpolate': 3.0.4
+      '@types/d3-path': 3.1.1
+      '@types/d3-polygon': 3.0.2
+      '@types/d3-quadtree': 3.0.6
+      '@types/d3-random': 3.0.3
+      '@types/d3-scale': 4.0.9
+      '@types/d3-scale-chromatic': 3.1.0
+      '@types/d3-selection': 3.0.11
+      '@types/d3-shape': 3.1.8
+      '@types/d3-time': 3.0.4
+      '@types/d3-time-format': 4.0.3
+      '@types/d3-timer': 3.0.2
+      '@types/d3-transition': 3.0.9
+      '@types/d3-zoom': 3.0.8
+
   '@types/debug@4.1.12':
     dependencies:
       '@types/ms': 2.1.0
@@ -7445,6 +8063,8 @@ snapshots:
     dependencies:
       '@types/node': 25.0.7
 
+  '@types/geojson@7946.0.16': {}
+
   '@types/hast@3.0.4':
     dependencies:
       '@types/unist': 3.0.3
@@ -7506,6 +8126,9 @@ snapshots:
     dependencies:
       '@types/node': 18.19.130
 
+  '@types/trusted-types@2.0.7':
+    optional: true
+
   '@types/unist@2.0.11': {}
 
   '@types/unist@3.0.3': {}
@@ -7765,8 +8388,7 @@ snapshots:
 
   acorn@8.15.0: {}
 
-  acorn@8.16.0:
-    optional: true
+  acorn@8.16.0: {}
 
   agent-base@6.0.2:
     dependencies:
@@ -8317,6 +8939,20 @@ snapshots:
 
   check-error@2.1.3: {}
 
+  chevrotain-allstar@0.3.1(chevrotain@11.1.2):
+    dependencies:
+      chevrotain: 11.1.2
+      lodash-es: 4.17.23
+
+  chevrotain@11.1.2:
+    dependencies:
+      '@chevrotain/cst-dts-gen': 11.1.2
+      '@chevrotain/gast': 11.1.2
+      '@chevrotain/regexp-to-ast': 11.1.2
+      '@chevrotain/types': 11.1.2
+      '@chevrotain/utils': 11.1.2
+      lodash-es: 4.17.23
+
   chokidar@3.6.0:
     dependencies:
       anymatch: 3.1.3
@@ -8419,6 +9055,10 @@ snapshots:
 
   commander@5.1.0: {}
 
+  commander@7.2.0: {}
+
+  commander@8.3.0: {}
+
   compare-version@0.1.2: {}
 
   compress-commons@4.1.2:
@@ -8430,6 +9070,8 @@ snapshots:
 
   concat-map@0.0.1: {}
 
+  confbox@0.1.8: {}
+
   config-file-ts@0.2.6:
     dependencies:
       glob: 10.5.0
@@ -8453,6 +9095,14 @@ snapshots:
 
   core-util-is@1.0.3: {}
 
+  cose-base@1.0.3:
+    dependencies:
+      layout-base: 1.0.2
+
+  cose-base@2.2.0:
+    dependencies:
+      layout-base: 2.0.1
+
   cpu-features@0.0.10:
     dependencies:
       buildcheck: 0.0.7
@@ -8483,6 +9133,190 @@ snapshots:
 
   csstype@3.2.3: {}
 
+  cytoscape-cose-bilkent@4.1.0(cytoscape@3.33.1):
+    dependencies:
+      cose-base: 1.0.3
+      cytoscape: 3.33.1
+
+  cytoscape-fcose@2.2.0(cytoscape@3.33.1):
+    dependencies:
+      cose-base: 2.2.0
+      cytoscape: 3.33.1
+
+  cytoscape@3.33.1: {}
+
+  d3-array@2.12.1:
+    dependencies:
+      internmap: 1.0.1
+
+  d3-array@3.2.4:
+    dependencies:
+      internmap: 2.0.3
+
+  d3-axis@3.0.0: {}
+
+  d3-brush@3.0.0:
+    dependencies:
+      d3-dispatch: 3.0.1
+      d3-drag: 3.0.0
+      d3-interpolate: 3.0.1
+      d3-selection: 3.0.0
+      d3-transition: 3.0.1(d3-selection@3.0.0)
+
+  d3-chord@3.0.1:
+    dependencies:
+      d3-path: 3.1.0
+
+  d3-color@3.1.0: {}
+
+  d3-contour@4.0.2:
+    dependencies:
+      d3-array: 3.2.4
+
+  d3-delaunay@6.0.4:
+    dependencies:
+      delaunator: 5.0.1
+
+  d3-dispatch@3.0.1: {}
+
+  d3-drag@3.0.0:
+    dependencies:
+      d3-dispatch: 3.0.1
+      d3-selection: 3.0.0
+
+  d3-dsv@3.0.1:
+    dependencies:
+      commander: 7.2.0
+      iconv-lite: 0.6.3
+      rw: 1.3.3
+
+  d3-ease@3.0.1: {}
+
+  d3-fetch@3.0.1:
+    dependencies:
+      d3-dsv: 3.0.1
+
+  d3-force@3.0.0:
+    dependencies:
+      d3-dispatch: 3.0.1
+      d3-quadtree: 3.0.1
+      d3-timer: 3.0.1
+
+  d3-format@3.1.2: {}
+
+  d3-geo@3.1.1:
+    dependencies:
+      d3-array: 3.2.4
+
+  d3-hierarchy@3.1.2: {}
+
+  d3-interpolate@3.0.1:
+    dependencies:
+      d3-color: 3.1.0
+
+  d3-path@1.0.9: {}
+
+  d3-path@3.1.0: {}
+
+  d3-polygon@3.0.1: {}
+
+  d3-quadtree@3.0.1: {}
+
+  d3-random@3.0.1: {}
+
+  d3-sankey@0.12.3:
+    dependencies:
+      d3-array: 2.12.1
+      d3-shape: 1.3.7
+
+  d3-scale-chromatic@3.1.0:
+    dependencies:
+      d3-color: 3.1.0
+      d3-interpolate: 3.0.1
+
+  d3-scale@4.0.2:
+    dependencies:
+      d3-array: 3.2.4
+      d3-format: 3.1.2
+      d3-interpolate: 3.0.1
+      d3-time: 3.1.0
+      d3-time-format: 4.1.0
+
+  d3-selection@3.0.0: {}
+
+  d3-shape@1.3.7:
+    dependencies:
+      d3-path: 1.0.9
+
+  d3-shape@3.2.0:
+    dependencies:
+      d3-path: 3.1.0
+
+  d3-time-format@4.1.0:
+    dependencies:
+      d3-time: 3.1.0
+
+  d3-time@3.1.0:
+    dependencies:
+      d3-array: 3.2.4
+
+  d3-timer@3.0.1: {}
+
+  d3-transition@3.0.1(d3-selection@3.0.0):
+    dependencies:
+      d3-color: 3.1.0
+      d3-dispatch: 3.0.1
+      d3-ease: 3.0.1
+      d3-interpolate: 3.0.1
+      d3-selection: 3.0.0
+      d3-timer: 3.0.1
+
+  d3-zoom@3.0.0:
+    dependencies:
+      d3-dispatch: 3.0.1
+      d3-drag: 3.0.0
+      d3-interpolate: 3.0.1
+      d3-selection: 3.0.0
+      d3-transition: 3.0.1(d3-selection@3.0.0)
+
+  d3@7.9.0:
+    dependencies:
+      d3-array: 3.2.4
+      d3-axis: 3.0.0
+      d3-brush: 3.0.0
+      d3-chord: 3.0.1
+      d3-color: 3.1.0
+      d3-contour: 4.0.2
+      d3-delaunay: 6.0.4
+      d3-dispatch: 3.0.1
+      d3-drag: 3.0.0
+      d3-dsv: 3.0.1
+      d3-ease: 3.0.1
+      d3-fetch: 3.0.1
+      d3-force: 3.0.0
+      d3-format: 3.1.2
+      d3-geo: 3.1.1
+      d3-hierarchy: 3.1.2
+      d3-interpolate: 3.0.1
+      d3-path: 3.1.0
+      d3-polygon: 3.0.1
+      d3-quadtree: 3.0.1
+      d3-random: 3.0.1
+      d3-scale: 4.0.2
+      d3-scale-chromatic: 3.1.0
+      d3-selection: 3.0.0
+      d3-shape: 3.2.0
+      d3-time: 3.1.0
+      d3-time-format: 4.1.0
+      d3-timer: 3.0.1
+      d3-transition: 3.0.1(d3-selection@3.0.0)
+      d3-zoom: 3.0.0
+
+  dagre-d3-es@7.0.13:
+    dependencies:
+      d3: 7.9.0
+      lodash-es: 4.17.23
+
   damerau-levenshtein@1.0.8: {}
 
   data-view-buffer@1.0.2:
@@ -8505,6 +9339,8 @@ snapshots:
 
   date-fns@3.6.0: {}
 
+  dayjs@1.11.19: {}
+
   debug@3.2.7:
     dependencies:
       ms: 2.1.3
@@ -8543,6 +9379,10 @@ snapshots:
       has-property-descriptors: 1.0.2
       object-keys: 1.1.1
 
+  delaunator@5.0.1:
+    dependencies:
+      robust-predicates: 3.0.2
+
   delayed-stream@1.0.0: {}
 
   delegates@1.0.0: {}
@@ -8609,6 +9449,10 @@ snapshots:
     dependencies:
       esutils: 2.0.3
 
+  dompurify@3.3.1:
+    optionalDependencies:
+      '@types/trusted-types': 2.0.7
+
   dotenv-expand@11.0.7:
     dependencies:
       dotenv: 16.6.1
@@ -8732,6 +9576,8 @@ snapshots:
     dependencies:
       once: 1.4.0
 
+  entities@6.0.1: {}
+
   env-paths@2.2.1: {}
 
   environment@1.1.0: {}
@@ -9479,6 +10325,8 @@ snapshots:
 
   graceful-fs@4.2.11: {}
 
+  hachure-fill@0.5.2: {}
+
   handlebars@4.7.8:
     dependencies:
       minimist: 1.2.8
@@ -9518,10 +10366,41 @@ snapshots:
     dependencies:
       function-bind: 1.1.2
 
+  hast-util-from-parse5@8.0.3:
+    dependencies:
+      '@types/hast': 3.0.4
+      '@types/unist': 3.0.3
+      devlop: 1.1.0
+      hastscript: 9.0.1
+      property-information: 7.1.0
+      vfile: 6.0.3
+      vfile-location: 5.0.3
+      web-namespaces: 2.0.1
+
   hast-util-is-element@3.0.0:
     dependencies:
       '@types/hast': 3.0.4
 
+  hast-util-parse-selector@4.0.0:
+    dependencies:
+      '@types/hast': 3.0.4
+
+  hast-util-raw@9.1.0:
+    dependencies:
+      '@types/hast': 3.0.4
+      '@types/unist': 3.0.3
+      '@ungap/structured-clone': 1.3.0
+      hast-util-from-parse5: 8.0.3
+      hast-util-to-parse5: 8.0.1
+      html-void-elements: 3.0.0
+      mdast-util-to-hast: 13.2.1
+      parse5: 7.3.0
+      unist-util-position: 5.0.0
+      unist-util-visit: 5.0.0
+      vfile: 6.0.3
+      web-namespaces: 2.0.1
+      zwitch: 2.0.4
+
   hast-util-to-jsx-runtime@2.3.6:
     dependencies:
       '@types/estree': 1.0.8
@@ -9542,6 +10421,16 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  hast-util-to-parse5@8.0.1:
+    dependencies:
+      '@types/hast': 3.0.4
+      comma-separated-tokens: 2.0.3
+      devlop: 1.1.0
+      property-information: 7.1.0
+      space-separated-tokens: 2.0.2
+      web-namespaces: 2.0.1
+      zwitch: 2.0.4
+
   hast-util-to-text@4.0.2:
     dependencies:
       '@types/hast': 3.0.4
@@ -9553,6 +10442,14 @@ snapshots:
     dependencies:
       '@types/hast': 3.0.4
 
+  hastscript@9.0.1:
+    dependencies:
+      '@types/hast': 3.0.4
+      comma-separated-tokens: 2.0.3
+      hast-util-parse-selector: 4.0.0
+      property-information: 7.1.0
+      space-separated-tokens: 2.0.2
+
   hermes-estree@0.25.1: {}
 
   hermes-parser@0.25.1:
@@ -9569,6 +10466,8 @@ snapshots:
 
   html-url-attributes@3.0.1: {}
 
+  html-void-elements@3.0.0: {}
+
   http-cache-semantics@4.2.0: {}
 
   http-errors@2.0.1:
@@ -9663,6 +10562,10 @@ snapshots:
       hasown: 2.0.2
       side-channel: 1.1.0
 
+  internmap@1.0.1: {}
+
+  internmap@2.0.3: {}
+
   ip-address@10.1.0: {}
 
   ipaddr.js@2.3.0: {}
@@ -9922,10 +10825,16 @@ snapshots:
       object.assign: 4.1.7
       object.values: 1.2.1
 
+  katex@0.16.33:
+    dependencies:
+      commander: 8.3.0
+
   keyv@4.5.4:
     dependencies:
       json-buffer: 3.0.1
 
+  khroma@2.1.0: {}
+
   knip@5.82.1(@types/node@25.0.7)(typescript@5.9.3):
     dependencies:
       '@nodelib/fs.walk': 1.2.8
@@ -9943,12 +10852,24 @@ snapshots:
       typescript: 5.9.3
       zod: 4.3.6
 
+  langium@4.2.1:
+    dependencies:
+      chevrotain: 11.1.2
+      chevrotain-allstar: 0.3.1(chevrotain@11.1.2)
+      vscode-languageserver: 9.0.1
+      vscode-languageserver-textdocument: 1.0.12
+      vscode-uri: 3.1.0
+
   language-subtag-registry@0.3.23: {}
 
   language-tags@1.0.9:
     dependencies:
       language-subtag-registry: 0.3.23
 
+  layout-base@1.0.2: {}
+
+  layout-base@2.0.1: {}
+
   lazy-val@1.0.5: {}
 
   lazystream@1.0.1:
@@ -9993,6 +10914,8 @@ snapshots:
     dependencies:
       p-locate: 5.0.0
 
+  lodash-es@4.17.23: {}
+
   lodash.defaults@4.2.0: {}
 
   lodash.difference@4.5.0: {}
@@ -10112,6 +11035,8 @@ snapshots:
 
   markdown-table@3.0.4: {}
 
+  marked@16.4.2: {}
+
   matcher@3.0.0:
     dependencies:
       escape-string-regexp: 4.0.0
@@ -10274,6 +11199,29 @@ snapshots:
 
   merge2@1.4.1: {}
 
+  mermaid@11.12.3:
+    dependencies:
+      '@braintree/sanitize-url': 7.1.2
+      '@iconify/utils': 3.1.0
+      '@mermaid-js/parser': 1.0.0
+      '@types/d3': 7.4.3
+      cytoscape: 3.33.1
+      cytoscape-cose-bilkent: 4.1.0(cytoscape@3.33.1)
+      cytoscape-fcose: 2.2.0(cytoscape@3.33.1)
+      d3: 7.9.0
+      d3-sankey: 0.12.3
+      dagre-d3-es: 7.0.13
+      dayjs: 1.11.19
+      dompurify: 3.3.1
+      katex: 0.16.33
+      khroma: 2.1.0
+      lodash-es: 4.17.23
+      marked: 16.4.2
+      roughjs: 4.6.6
+      stylis: 4.3.6
+      ts-dedent: 2.2.0
+      uuid: 11.1.0
+
   micromark-core-commonmark@2.0.3:
     dependencies:
       decode-named-character-reference: 1.2.0
@@ -10565,6 +11513,13 @@ snapshots:
 
   mkdirp@1.0.4: {}
 
+  mlly@1.8.0:
+    dependencies:
+      acorn: 8.16.0
+      pathe: 2.0.3
+      pkg-types: 1.3.1
+      ufo: 1.6.3
+
   ms@2.1.3: {}
 
   mz@2.7.0:
@@ -10792,6 +11747,8 @@ snapshots:
 
   package-json-from-dist@1.0.1: {}
 
+  package-manager-detector@1.6.0: {}
+
   parent-module@1.0.1:
     dependencies:
       callsites: 3.1.0
@@ -10806,6 +11763,12 @@ snapshots:
       is-decimal: 2.0.1
       is-hexadecimal: 2.0.1
 
+  parse5@7.3.0:
+    dependencies:
+      entities: 6.0.1
+
+  path-data-parser@0.1.0: {}
+
   path-exists@4.0.0: {}
 
   path-is-absolute@1.0.1: {}
@@ -10864,12 +11827,25 @@ snapshots:
 
   pirates@4.0.7: {}
 
+  pkg-types@1.3.1:
+    dependencies:
+      confbox: 0.1.8
+      mlly: 1.8.0
+      pathe: 2.0.3
+
   plist@3.1.0:
     dependencies:
       '@xmldom/xmldom': 0.8.11
       base64-js: 1.5.1
       xmlbuilder: 15.1.1
 
+  points-on-curve@0.2.0: {}
+
+  points-on-path@0.2.1:
+    dependencies:
+      path-data-parser: 0.1.0
+      points-on-curve: 0.2.0
+
   possible-typed-array-names@1.1.0: {}
 
   postcss-import@15.1.0(postcss@8.5.6):
@@ -11107,6 +12083,12 @@ snapshots:
       unist-util-visit: 5.0.0
       vfile: 6.0.3
 
+  rehype-raw@7.0.0:
+    dependencies:
+      '@types/hast': 3.0.4
+      hast-util-raw: 9.1.0
+      vfile: 6.0.3
+
   remark-gfm@4.0.1:
     dependencies:
       '@types/mdast': 4.0.4
@@ -11203,6 +12185,8 @@ snapshots:
       sprintf-js: 1.1.3
     optional: true
 
+  robust-predicates@3.0.2: {}
+
   rollup@4.55.1:
     dependencies:
       '@types/estree': 1.0.8
@@ -11234,10 +12218,19 @@ snapshots:
       '@rollup/rollup-win32-x64-msvc': 4.55.1
       fsevents: 2.3.3
 
+  roughjs@4.6.6:
+    dependencies:
+      hachure-fill: 0.5.2
+      path-data-parser: 0.1.0
+      points-on-curve: 0.2.0
+      points-on-path: 0.2.1
+
   run-parallel@1.2.0:
     dependencies:
       queue-microtask: 1.2.3
 
+  rw@1.3.3: {}
+
   safe-array-concat@1.1.3:
     dependencies:
       call-bind: 1.0.8
@@ -11591,6 +12584,8 @@ snapshots:
     dependencies:
       inline-style-parser: 0.2.7
 
+  stylis@4.3.6: {}
+
   sucrase@3.35.1:
     dependencies:
       '@jridgewell/gen-mapping': 0.3.13
@@ -11709,6 +12704,8 @@ snapshots:
 
   tinyexec@0.3.2: {}
 
+  tinyexec@1.0.2: {}
+
   tinyglobby@0.2.15:
     dependencies:
       fdir: 6.5.0(picomatch@4.0.3)
@@ -11746,6 +12743,8 @@ snapshots:
     dependencies:
       typescript: 5.9.3
 
+  ts-dedent@2.2.0: {}
+
   ts-interface-checker@0.1.13: {}
 
   tsconfig-paths@3.15.0:
@@ -11819,6 +12818,8 @@ snapshots:
 
   typescript@5.9.3: {}
 
+  ufo@1.6.3: {}
+
   uglify-js@3.19.3:
     optional: true
 
@@ -11950,6 +12951,8 @@ snapshots:
 
   util-deprecate@1.0.2: {}
 
+  uuid@11.1.0: {}
+
   verror@1.10.1:
     dependencies:
       assert-plus: 1.0.0
@@ -11957,6 +12960,11 @@ snapshots:
       extsprintf: 1.4.1
     optional: true
 
+  vfile-location@5.0.3:
+    dependencies:
+      '@types/unist': 3.0.3
+      vfile: 6.0.3
+
   vfile-message@4.0.3:
     dependencies:
       '@types/unist': 3.0.3
@@ -12035,6 +13043,23 @@ snapshots:
       - supports-color
       - terser
 
+  vscode-jsonrpc@8.2.0: {}
+
+  vscode-languageserver-protocol@3.17.5:
+    dependencies:
+      vscode-jsonrpc: 8.2.0
+      vscode-languageserver-types: 3.17.5
+
+  vscode-languageserver-textdocument@1.0.12: {}
+
+  vscode-languageserver-types@3.17.5: {}
+
+  vscode-languageserver@9.0.1:
+    dependencies:
+      vscode-languageserver-protocol: 3.17.5
+
+  vscode-uri@3.1.0: {}
+
   w3c-keyname@2.2.8: {}
 
   walk-up-path@4.0.0: {}
@@ -12043,6 +13068,8 @@ snapshots:
     dependencies:
       defaults: 1.0.4
 
+  web-namespaces@2.0.1: {}
+
   whatwg-mimetype@3.0.0: {}
 
   which-boxed-primitive@1.1.1:
diff --git a/src/main/constants/worktreePatterns.ts b/src/main/constants/worktreePatterns.ts
index f2ed2c02..26a355f4 100644
--- a/src/main/constants/worktreePatterns.ts
+++ b/src/main/constants/worktreePatterns.ts
@@ -42,3 +42,6 @@ export const CLAUDE_WORKTREES_DIR = '.claude-worktrees';
 
 /** ccswitch worktrees directory */
 export const CCSWITCH_DIR = '.ccswitch';
+
+/** Claude Code CLI worktrees directory (.claude/worktrees/) */
+export const CLAUDE_CODE_DIR = '.claude';
diff --git a/src/main/http/config.ts b/src/main/http/config.ts
index 6d35c66d..c5acd2fc 100644
--- a/src/main/http/config.ts
+++ b/src/main/http/config.ts
@@ -17,6 +17,8 @@
  * - POST /api/config/triggers/:triggerId/test - Test trigger
  * - POST /api/config/pin-session - Pin session
  * - POST /api/config/unpin-session - Unpin session
+ * - POST /api/config/add-custom-project-path - Add custom project path
+ * - POST /api/config/remove-custom-project-path - Remove custom project path
  * - POST /api/config/select-folders - No-op in browser
  * - POST /api/config/open-in-editor - No-op in browser
  */
@@ -470,6 +472,44 @@ export function registerConfigRoutes(app: FastifyInstance): void {
     }
   );
 
+  // Add custom project path
+  app.post<{ Body: { projectPath: string } }>(
+    '/api/config/add-custom-project-path',
+    async (request): Promise<ConfigResult> => {
+      try {
+        const { projectPath } = request.body;
+        if (!projectPath || typeof projectPath !== 'string') {
+          return { success: false, error: 'Project path is required and must be a string' };
+        }
+
+        configManager.addCustomProjectPath(projectPath);
+        return { success: true };
+      } catch (error) {
+        logger.error('Error in POST /api/config/add-custom-project-path:', error);
+        return { success: false, error: getErrorMessage(error) };
+      }
+    }
+  );
+
+  // Remove custom project path
+  app.post<{ Body: { projectPath: string } }>(
+    '/api/config/remove-custom-project-path',
+    async (request): Promise<ConfigResult> => {
+      try {
+        const { projectPath } = request.body;
+        if (!projectPath || typeof projectPath !== 'string') {
+          return { success: false, error: 'Project path is required and must be a string' };
+        }
+
+        configManager.removeCustomProjectPath(projectPath);
+        return { success: true };
+      } catch (error) {
+        logger.error('Error in POST /api/config/remove-custom-project-path:', error);
+        return { success: false, error: getErrorMessage(error) };
+      }
+    }
+  );
+
   // Select folders - no-op in browser mode
   app.post('/api/config/select-folders', async (): Promise<ConfigResult<string[]>> => {
     return { success: true, data: [] };
diff --git a/src/main/index.ts b/src/main/index.ts
index 724e0ec3..20fc9ded 100644
--- a/src/main/index.ts
+++ b/src/main/index.ts
@@ -44,6 +44,7 @@ import { initializeIpcHandlers, removeIpcHandlers } from './ipc/handlers';
 import { showTeamNativeNotification } from './ipc/teams';
 import { HttpServer } from './services/infrastructure/HttpServer';
 import { TeamInboxReader } from './services/team/TeamInboxReader';
+import { getAppIconPath } from './utils/appIcon';
 import { getProjectsBasePath, getTodosBasePath } from './utils/pathDecoder';
 import {
   CliInstallerService,
@@ -125,19 +126,89 @@ async function resolveTeamDisplayName(teamName: string): Promise<string> {
   return resolved;
 }
 
+/**
+ * Inbox message types that are internal coordination noise — not useful as OS notifications.
+ * Matches renderer-side NOISE_TYPES in agentMessageFormatting.ts.
+ */
+const INBOX_NOISE_TYPES = new Set([
+  'idle_notification',
+  'shutdown_approved',
+  'teammate_terminated',
+  'shutdown_request',
+]);
+
+/**
+ * Parses an inbox message text that may be serialized JSON.
+ * Returns null if not valid JSON or not an object.
+ */
+function parseInboxJson(text: string): Record<string, unknown> | null {
+  const trimmed = text.trim();
+  if (!trimmed.startsWith('{')) return null;
+  try {
+    const parsed = JSON.parse(trimmed) as unknown;
+    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+      return parsed as Record<string, unknown>;
+    }
+  } catch {
+    // not JSON — plain text message
+  }
+  return null;
+}
+
+/** Returns true if the inbox message text is a noise type that should not trigger an OS notification. */
+function isInboxNoiseMessage(text: string): boolean {
+  const parsed = parseInboxJson(text);
+  if (!parsed) return false;
+  return typeof parsed.type === 'string' && INBOX_NOISE_TYPES.has(parsed.type);
+}
+
+/**
+ * Extracts human-readable summary and body from an inbox message.
+ * Handles both plain text and serialized JSON ({"type":"message","content":"...","summary":"..."}).
+ */
+function extractNotificationContent(text: string): { summary: string; body: string } {
+  const parsed = parseInboxJson(text);
+  if (!parsed) return { summary: text.slice(0, 80), body: text };
+
+  const content = typeof parsed.content === 'string' ? parsed.content : null;
+  const summary = typeof parsed.summary === 'string' ? parsed.summary : null;
+  const message = typeof parsed.message === 'string' ? parsed.message : null;
+
+  const bestBody = content || message || summary || text;
+  const bestSummary =
+    summary || (content ? content.slice(0, 80) : null) || message || text.slice(0, 80);
+
+  return { summary: bestSummary, body: bestBody };
+}
+
 async function notifyNewInboxMessages(teamName: string, detail: string): Promise<void> {
+  // Check global toggle
+  const config = configManager.getConfig();
+  if (!config.notifications.enabled) return;
+
   // detail is like "inboxes/carol.json" — extract member name
   const match = /^inboxes\/(.+)\.json$/.exec(detail);
   if (!match) return;
   const memberName = match[1];
+
+  // Determine inbox type and check per-inbox toggle
+  const leadName = teamDataService ? await teamDataService.getLeadMemberName(teamName) : null;
+  const isLeadInbox = leadName !== null && memberName === leadName;
+  const isUserInbox = memberName === 'user';
+
+  if (isLeadInbox && !config.notifications.notifyOnLeadInbox) return;
+  if (isUserInbox && !config.notifications.notifyOnUserInbox) return;
+  if (!isLeadInbox && !isUserInbox) return;
+
   const key = `${teamName}:${memberName}`;
 
   try {
     const messages = await teamInboxReader.getMessagesFor(teamName, memberName);
+    const isFirstLoad = !inboxMessageCounts.has(key);
     const prevCount = inboxMessageCounts.get(key) ?? 0;
 
-    if (prevCount === 0) {
-      // First load — seed count, don't notify
+    if (isFirstLoad) {
+      // First load — seed count, don't notify for pre-existing messages
       inboxMessageCounts.set(key, messages.length);
       return;
     }
@@ -154,18 +225,19 @@ async function notifyNewInboxMessages(teamName: string, detail: string): Promise
     const teamDisplayName = await resolveTeamDisplayName(teamName);
 
     for (const msg of newMessages) {
-      // Only notify for messages addressed to the human user
-      if (msg.to !== 'user') continue;
       // Skip messages sent from our own UI
       if (msg.source && suppressedSources.has(msg.source)) continue;
+      // Skip internal coordination noise (idle_notification, shutdown_*, etc.)
+      if (isInboxNoiseMessage(msg.text)) continue;
 
       const fromLabel = msg.from || 'Unknown';
-      const summary = msg.summary || msg.text.slice(0, 60);
+      const extracted = extractNotificationContent(msg.text);
+      const summary = msg.summary || extracted.summary;
 
       showTeamNativeNotification({
         title: teamDisplayName,
         subtitle: `${fromLabel}: ${summary}`,
-        body: msg.text,
+        body: extracted.body,
       });
     }
   } catch (error) {
@@ -173,24 +245,6 @@ async function notifyNewInboxMessages(teamName: string, detail: string): Promise
   }
 }
 
-// Window icon path for non-mac platforms.
-const getWindowIconPath = (): string | undefined => {
-  const isDev = process.env.NODE_ENV === 'development';
-  const candidates = isDev
-    ? [join(process.cwd(), 'resources/icon.png')]
-    : [
-        join(process.resourcesPath, 'resources/icon.png'),
-        join(__dirname, '../../resources/icon.png'),
-      ];
-
-  for (const candidate of candidates) {
-    if (existsSync(candidate)) {
-      return candidate;
-    }
-  }
-  return undefined;
-};
-
 process.on('unhandledRejection', (reason) => {
   logger.error('Unhandled promise rejection in main process:', reason);
 });
@@ -349,21 +403,25 @@ function wireFileWatcherEvents(context: ServiceContext): void {
       // Show native OS notification for live lead process replies.
       // These don't go through inbox files — they're held in-memory by TeamProvisioningService.
       if (detail === 'lead-process-reply' || detail === 'lead-direct-reply') {
-        const messages = teamProvisioningService.getLiveLeadProcessMessages(teamName);
-        const latest = messages.length > 0 ? messages[messages.length - 1] : undefined;
-        // Only notify for messages addressed to the human user
-        if (latest?.to === 'user') {
-          const fromLabel = latest.from || 'team-lead';
-          const summary = latest.summary || latest.text.slice(0, 60);
-          void resolveTeamDisplayName(teamName)
-            .then((displayName) => {
-              showTeamNativeNotification({
-                title: displayName,
-                subtitle: `${fromLabel}: ${summary}`,
-                body: latest.text,
-              });
-            })
-            .catch(() => undefined);
+        const cfg = configManager.getConfig();
+        if (cfg.notifications.enabled && cfg.notifications.notifyOnUserInbox) {
+          const messages = teamProvisioningService.getLiveLeadProcessMessages(teamName);
+          const latest = messages.length > 0 ? messages[messages.length - 1] : undefined;
+          // Only notify for messages addressed to the human user, skip noise
+          if (latest?.to === 'user' && !isInboxNoiseMessage(latest.text)) {
+            const fromLabel = latest.from || 'team-lead';
+            const extracted = extractNotificationContent(latest.text);
+            const summary = latest.summary || extracted.summary;
+            void resolveTeamDisplayName(teamName)
+              .then((displayName) => {
+                showTeamNativeNotification({
+                  title: displayName,
+                  subtitle: `${fromLabel}: ${summary}`,
+                  body: extracted.body,
+                });
+              })
+              .catch(() => undefined);
+          }
         }
       }
     } catch {
@@ -690,7 +748,7 @@ function syncTrafficLightPosition(win: BrowserWindow): void {
  */
 function createWindow(): void {
   const isMac = process.platform === 'darwin';
-  const iconPath = isMac ? undefined : getWindowIconPath();
+  const iconPath = isMac ? undefined : getAppIconPath();
   const useNativeTitleBar = !isMac && configManager.getConfig().general.useNativeTitleBar;
   mainWindow = new BrowserWindow({
     width: DEFAULT_WINDOW_WIDTH,
diff --git a/src/main/ipc/config.ts b/src/main/ipc/config.ts
index 0655fe3c..85eb0c76 100644
--- a/src/main/ipc/config.ts
+++ b/src/main/ipc/config.ts
@@ -114,6 +114,10 @@ export function registerConfigHandlers(ipcMain: IpcMain): void {
   ipcMain.handle('config:getClaudeRootInfo', handleGetClaudeRootInfo);
   ipcMain.handle('config:findWslClaudeRoots', handleFindWslClaudeRoots);
 
+  // Custom project path handlers
+  ipcMain.handle('config:addCustomProjectPath', handleAddCustomProjectPath);
+  ipcMain.handle('config:removeCustomProjectPath', handleRemoveCustomProjectPath);
+
   // Editor handlers
   ipcMain.handle('config:openInEditor', handleOpenInEditor);
 
@@ -624,6 +628,46 @@ async function handleOpenInEditor(_event: IpcMainInvokeEvent): Promise<IpcResult
   }
 }
 
+/**
+ * Handler for 'config:addCustomProjectPath' - Persists a custom project path.
+ */
+async function handleAddCustomProjectPath(
+  _event: IpcMainInvokeEvent,
+  projectPath: string
+): Promise<IpcResult> {
+  try {
+    if (!projectPath || typeof projectPath !== 'string') {
+      return { success: false, error: 'Project path is required and must be a string' };
+    }
+
+    configManager.addCustomProjectPath(projectPath);
+    return { success: true };
+  } catch (error) {
+    logger.error('Error in config:addCustomProjectPath:', error);
+    return { success: false, error: getErrorMessage(error) };
+  }
+}
+
+/**
+ * Handler for 'config:removeCustomProjectPath' - Removes a custom project path.
+ */
+async function handleRemoveCustomProjectPath(
+  _event: IpcMainInvokeEvent,
+  projectPath: string
+): Promise<IpcResult> {
+  try {
+    if (!projectPath || typeof projectPath !== 'string') {
+      return { success: false, error: 'Project path is required and must be a string' };
+    }
+
+    configManager.removeCustomProjectPath(projectPath);
+    return { success: true };
+  } catch (error) {
+    logger.error('Error in config:removeCustomProjectPath:', error);
+    return { success: false, error: getErrorMessage(error) };
+  }
+}
+
 /**
  * Handler for 'config:selectFolders' - Opens native folder selection dialog.
  * Allows users to select one or more folders for trigger project scope.
@@ -1091,6 +1135,8 @@ export function removeConfigHandlers(ipcMain: IpcMain): void {
   ipcMain.removeHandler('config:unhideSession');
   ipcMain.removeHandler('config:hideSessions');
   ipcMain.removeHandler('config:unhideSessions');
+  ipcMain.removeHandler('config:addCustomProjectPath');
+  ipcMain.removeHandler('config:removeCustomProjectPath');
   ipcMain.removeHandler('config:selectFolders');
   ipcMain.removeHandler('config:selectClaudeRootFolder');
   ipcMain.removeHandler('config:getClaudeRootInfo');
diff --git a/src/main/ipc/editor.ts b/src/main/ipc/editor.ts
index 741447ce..9ae47eab 100644
--- a/src/main/ipc/editor.ts
+++ b/src/main/ipc/editor.ts
@@ -17,11 +17,16 @@ import {
   EDITOR_LIST_FILES,
   EDITOR_MOVE_FILE,
   EDITOR_OPEN,
+  EDITOR_READ_BINARY_PREVIEW,
   EDITOR_READ_DIR,
   EDITOR_READ_FILE,
+  EDITOR_RENAME_FILE,
   EDITOR_SEARCH_IN_FILES,
+  EDITOR_SET_WATCHED_DIRS,
+  EDITOR_SET_WATCHED_FILES,
   EDITOR_WATCH_DIR,
   EDITOR_WRITE_FILE,
+  PROJECT_LIST_FILES,
   // eslint-disable-next-line boundaries/element-types -- IPC channel constants are shared between main and preload by design
 } from '@preload/constants/ipcChannels';
 import { createLogger } from '@shared/utils/logger';
@@ -40,6 +45,7 @@ import {
 import { createIpcWrapper } from './ipcWrapper';
 
 import type {
+  BinaryPreviewResult,
   CreateDirResponse,
   CreateFileResponse,
   DeleteFileResponse,
@@ -244,6 +250,20 @@ async function handleEditorMoveFile(
   });
 }
 
+/**
+ * Rename a file or directory in place.
+ */
+async function handleEditorRenameFile(
+  _event: IpcMainInvokeEvent,
+  sourcePath: string,
+  newName: string
+): Promise<IpcResult<MoveFileResponse>> {
+  return wrapHandler('renameFile', async () => {
+    if (!activeProjectRoot) throw new Error('Editor not initialized');
+    return projectFileService.renameFile(activeProjectRoot, sourcePath, newName);
+  });
+}
+
 /**
  * Search in files (literal string search, SEC-8 timeout).
  */
@@ -282,6 +302,24 @@ async function handleEditorListFiles(): Promise<IpcResult<QuickOpenFile[]>> {
   });
 }
 
+/**
+ * List project files by explicit path (for @file mentions).
+ * Independent of editor state — works without editor:open.
+ */
+async function handleProjectListFiles(
+  _event: IpcMainInvokeEvent,
+  projectPath: string
+): Promise<IpcResult<QuickOpenFile[]>> {
+  return wrapHandler('project:listFiles', async () => {
+    if (typeof projectPath !== 'string' || projectPath.length === 0) {
+      throw new Error('projectPath is required');
+    }
+    const normalized = path.resolve(projectPath);
+    await fs.access(normalized);
+    return fileSearchService.listFiles(normalized);
+  });
+}
+
 /**
  * Get git status for current project (cached 5s).
  */
@@ -292,6 +330,19 @@ async function handleEditorGitStatus(): Promise<IpcResult<GitStatusResult>> {
   });
 }
 
+/**
+ * Read binary file as base64 for inline preview.
+ */
+async function handleEditorReadBinaryPreview(
+  _event: IpcMainInvokeEvent,
+  filePath: string
+): Promise<IpcResult<BinaryPreviewResult>> {
+  return wrapHandler('readBinaryPreview', async () => {
+    if (!activeProjectRoot) throw new Error('Editor not initialized');
+    return projectFileService.readBinaryPreview(activeProjectRoot, filePath);
+  });
+}
+
 /**
  * Enable/disable file watcher for current project.
  */
@@ -304,8 +355,13 @@ async function handleEditorWatchDir(
 
     if (enable) {
       editorFileWatcher.start(activeProjectRoot, (event) => {
-        // Invalidate git cache on file changes
-        gitStatusService.invalidateCache();
+        // Structural changes (create/delete): immediate invalidation.
+        // Content changes: debounced (500ms) to coalesce rapid saves/builds.
+        if (event.type === 'create' || event.type === 'delete') {
+          gitStatusService.invalidateCache();
+        } else {
+          gitStatusService.invalidateCacheDebounced();
+        }
 
         // Forward event to renderer
         if (mainWindowRef && !mainWindowRef.isDestroyed()) {
@@ -318,6 +374,32 @@ async function handleEditorWatchDir(
   });
 }
 
+/**
+ * Update watched file list (open tabs).
+ */
+async function handleEditorSetWatchedFiles(
+  _event: IpcMainInvokeEvent,
+  filePaths: string[]
+): Promise<IpcResult<void>> {
+  return wrapHandler('setWatchedFiles', async () => {
+    if (!activeProjectRoot) throw new Error('Editor not initialized');
+    editorFileWatcher.setWatchedFiles(Array.isArray(filePaths) ? filePaths : []);
+  });
+}
+
+/**
+ * Update watched directory list (shallow, depth=0).
+ */
+async function handleEditorSetWatchedDirs(
+  _event: IpcMainInvokeEvent,
+  dirPaths: string[]
+): Promise<IpcResult<void>> {
+  return wrapHandler('setWatchedDirs', async () => {
+    if (!activeProjectRoot) throw new Error('Editor not initialized');
+    editorFileWatcher.setWatchedDirs(Array.isArray(dirPaths) ? dirPaths : []);
+  });
+}
+
 // =============================================================================
 // Registration
 // =============================================================================
@@ -344,10 +426,15 @@ export function registerEditorHandlers(ipcMain: IpcMain): void {
   ipcMain.handle(EDITOR_CREATE_DIR, handleEditorCreateDir);
   ipcMain.handle(EDITOR_DELETE_FILE, handleEditorDeleteFile);
   ipcMain.handle(EDITOR_MOVE_FILE, handleEditorMoveFile);
+  ipcMain.handle(EDITOR_RENAME_FILE, handleEditorRenameFile);
   ipcMain.handle(EDITOR_SEARCH_IN_FILES, handleEditorSearchInFiles);
   ipcMain.handle(EDITOR_LIST_FILES, handleEditorListFiles);
+  ipcMain.handle(EDITOR_READ_BINARY_PREVIEW, handleEditorReadBinaryPreview);
   ipcMain.handle(EDITOR_GIT_STATUS, handleEditorGitStatus);
   ipcMain.handle(EDITOR_WATCH_DIR, handleEditorWatchDir);
+  ipcMain.handle(EDITOR_SET_WATCHED_FILES, handleEditorSetWatchedFiles);
+  ipcMain.handle(EDITOR_SET_WATCHED_DIRS, handleEditorSetWatchedDirs);
+  ipcMain.handle(PROJECT_LIST_FILES, handleProjectListFiles);
 }
 
 export function removeEditorHandlers(ipcMain: IpcMain): void {
@@ -360,10 +447,15 @@ export function removeEditorHandlers(ipcMain: IpcMain): void {
   ipcMain.removeHandler(EDITOR_CREATE_DIR);
   ipcMain.removeHandler(EDITOR_DELETE_FILE);
   ipcMain.removeHandler(EDITOR_MOVE_FILE);
+  ipcMain.removeHandler(EDITOR_RENAME_FILE);
   ipcMain.removeHandler(EDITOR_SEARCH_IN_FILES);
   ipcMain.removeHandler(EDITOR_LIST_FILES);
+  ipcMain.removeHandler(EDITOR_READ_BINARY_PREVIEW);
   ipcMain.removeHandler(EDITOR_GIT_STATUS);
   ipcMain.removeHandler(EDITOR_WATCH_DIR);
+  ipcMain.removeHandler(EDITOR_SET_WATCHED_FILES);
+  ipcMain.removeHandler(EDITOR_SET_WATCHED_DIRS);
+  ipcMain.removeHandler(PROJECT_LIST_FILES);
 }
 
 /**
diff --git a/src/main/ipc/guards.ts b/src/main/ipc/guards.ts
index 26f4aa74..9829be8a 100644
--- a/src/main/ipc/guards.ts
+++ b/src/main/ipc/guards.ts
@@ -12,7 +12,7 @@ const SESSION_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/;
 const SUBAGENT_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/;
 const NOTIFICATION_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/;
 const TRIGGER_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/;
-const TEAM_NAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/;
+const TEAM_NAME_PATTERN = /^[a-z0-9][a-z0-9-]{0,127}$/;
 const TASK_ID_PATTERN = /^\d{1,10}$/;
 const MEMBER_NAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/;
 const FROM_FIELD_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/;
diff --git a/src/main/ipc/review.ts b/src/main/ipc/review.ts
index f800a045..92cc2541 100644
--- a/src/main/ipc/review.ts
+++ b/src/main/ipc/review.ts
@@ -221,7 +221,44 @@ async function handleApplyDecisions(
   if (!request || !Array.isArray(request.decisions)) {
     return { success: false, error: 'Invalid request: decisions array required' };
   }
-  return wrapReviewHandler('applyDecisions', () => getApplier().applyReviewDecisions(request));
+  return wrapReviewHandler('applyDecisions', async () => {
+    // Build file contents map for the applier. Prefer renderer-provided context
+    // (snippets + full contents), falling back to resolver when missing.
+    const fileContents = new Map<string, FileChangeWithContent>();
+    const memberName = request.memberName ?? '';
+
+    for (const d of request.decisions) {
+      const snippets = d.snippets ?? [];
+
+      // If renderer provided full contents, use them directly.
+      if (d.originalFullContent !== undefined || d.modifiedFullContent !== undefined) {
+        fileContents.set(d.filePath, {
+          filePath: d.filePath,
+          relativePath: d.filePath.split('/').slice(-3).join('/'),
+          snippets,
+          linesAdded: 0,
+          linesRemoved: 0,
+          isNewFile: d.isNewFile ?? snippets.some((s) => s.type === 'write-new'),
+          originalFullContent: d.originalFullContent ?? null,
+          modifiedFullContent: d.modifiedFullContent ?? null,
+          // Source is informational only; "unavailable" avoids lying.
+          contentSource: 'unavailable',
+        });
+        continue;
+      }
+
+      // Fallback: resolve in main process (best-effort; task mode may not have memberName).
+      const resolved = await getContentResolver().getFileContent(
+        request.teamName,
+        memberName,
+        d.filePath,
+        snippets
+      );
+      fileContents.set(d.filePath, resolved);
+    }
+
+    return getApplier().applyReviewDecisions(request, fileContents);
+  });
 }
 
 async function handleGetFileContent(
@@ -241,12 +278,14 @@ async function handleGetFileContent(
 async function handleSaveEditedFile(
   _event: IpcMainInvokeEvent,
   filePath: string,
-  content: string
+  content: string,
+  projectPath?: string
 ): Promise<IpcResult<{ success: boolean }>> {
   if (!filePath || typeof content !== 'string') {
     return { success: false, error: 'Invalid parameters' };
   }
-  const pathCheck = validateFilePath(filePath, null);
+  const resolvedProjectPath = projectPath && typeof projectPath === 'string' ? projectPath : null;
+  const pathCheck = validateFilePath(filePath, resolvedProjectPath);
   if (!pathCheck.valid) {
     logger.error(`saveEditedFile blocked: ${String(pathCheck.error)} (path: ${String(filePath)})`);
     return { success: false, error: `Path validation failed: ${String(pathCheck.error)}` };
@@ -284,6 +323,7 @@ async function handleLoadDecisions(
   IpcResult<{
     hunkDecisions: Record<string, HunkDecision>;
     fileDecisions: Record<string, HunkDecision>;
+    hunkContextHashesByFile?: Record<string, Record<number, string>>;
   } | null>
 > {
   return wrapReviewHandler('loadDecisions', () => reviewDecisionStore.load(teamName, scopeKey));
@@ -294,10 +334,15 @@ async function handleSaveDecisions(
   teamName: string,
   scopeKey: string,
   hunkDecisions: Record<string, HunkDecision>,
-  fileDecisions: Record<string, HunkDecision>
+  fileDecisions: Record<string, HunkDecision>,
+  hunkContextHashesByFile: Record<string, Record<number, string>> | null = null
 ): Promise<IpcResult<void>> {
   return wrapReviewHandler('saveDecisions', () =>
-    reviewDecisionStore.save(teamName, scopeKey, { hunkDecisions, fileDecisions })
+    reviewDecisionStore.save(teamName, scopeKey, {
+      hunkDecisions,
+      fileDecisions,
+      hunkContextHashesByFile: hunkContextHashesByFile ?? undefined,
+    })
   );
 }
 
diff --git a/src/main/ipc/teams.ts b/src/main/ipc/teams.ts
index ae290c87..f033393d 100644
--- a/src/main/ipc/teams.ts
+++ b/src/main/ipc/teams.ts
@@ -1,8 +1,10 @@
 import { randomUUID } from 'node:crypto';
 
+import { getAppIconPath } from '@main/utils/appIcon';
 import {
   TEAM_ADD_MEMBER,
   TEAM_ADD_TASK_COMMENT,
+  TEAM_ADD_TASK_RELATIONSHIP,
   TEAM_ALIVE_LIST,
   TEAM_CANCEL_PROVISIONING,
   TEAM_CREATE,
@@ -28,6 +30,7 @@ import {
   TEAM_PROVISIONING_PROGRESS,
   TEAM_PROVISIONING_STATUS,
   TEAM_REMOVE_MEMBER,
+  TEAM_REMOVE_TASK_RELATIONSHIP,
   TEAM_REQUEST_REVIEW,
   TEAM_RESTORE,
   TEAM_RESTORE_TASK,
@@ -215,6 +218,8 @@ export function registerTeamHandlers(ipcMain: IpcMain): void {
   ipcMain.handle(TEAM_GET_DELETED_TASKS, handleGetDeletedTasks);
   ipcMain.handle(TEAM_SET_TASK_CLARIFICATION, handleSetTaskClarification);
   ipcMain.handle(TEAM_SHOW_MESSAGE_NOTIFICATION, handleShowMessageNotification);
+  ipcMain.handle(TEAM_ADD_TASK_RELATIONSHIP, handleAddTaskRelationship);
+  ipcMain.handle(TEAM_REMOVE_TASK_RELATIONSHIP, handleRemoveTaskRelationship);
   logger.info('Team handlers registered');
 }
 
@@ -261,6 +266,8 @@ export function removeTeamHandlers(ipcMain: IpcMain): void {
   ipcMain.removeHandler(TEAM_GET_DELETED_TASKS);
   ipcMain.removeHandler(TEAM_SET_TASK_CLARIFICATION);
   ipcMain.removeHandler(TEAM_SHOW_MESSAGE_NOTIFICATION);
+  ipcMain.removeHandler(TEAM_ADD_TASK_RELATIONSHIP);
+  ipcMain.removeHandler(TEAM_REMOVE_TASK_RELATIONSHIP);
 }
 
 function getTeamDataService(): TeamDataService {
@@ -1306,6 +1313,14 @@ async function handleCreateConfig(
   if (payload.color !== undefined && typeof payload.color !== 'string') {
     return { success: false, error: 'color must be a string' };
   }
+  if (payload.cwd !== undefined) {
+    if (typeof payload.cwd !== 'string' || payload.cwd.trim().length === 0) {
+      return { success: false, error: 'cwd must be a non-empty string if provided' };
+    }
+    if (!path.isAbsolute(payload.cwd.trim())) {
+      return { success: false, error: 'cwd must be an absolute path' };
+    }
+  }
 
   const seenNames = new Set<string>();
   const members: TeamCreateConfigRequest['members'] = [];
@@ -1337,6 +1352,7 @@ async function handleCreateConfig(
       description: payload.description?.trim() || undefined,
       color: typeof payload.color === 'string' ? payload.color.trim() || undefined : undefined,
       members,
+      cwd: typeof payload.cwd === 'string' ? payload.cwd.trim() || undefined : undefined,
     })
   );
 }
@@ -1370,7 +1386,12 @@ async function handleGetLogsForTask(
   _event: IpcMainInvokeEvent,
   teamName: unknown,
   taskId: unknown,
-  options?: { owner?: string; status?: string }
+  options?: {
+    owner?: string;
+    status?: string;
+    intervals?: { startedAt: string; completedAt?: string }[];
+    since?: string;
+  }
 ): Promise<IpcResult<MemberLogSummary[]>> {
   const vTeam = validateTeamName(teamName);
   if (!vTeam.valid) {
@@ -1385,6 +1406,17 @@ async function handleGetLogsForTask(
       ? {
           owner: typeof options.owner === 'string' ? options.owner : undefined,
           status: typeof options.status === 'string' ? options.status : undefined,
+          since: typeof options.since === 'string' ? options.since : undefined,
+          intervals: Array.isArray(options.intervals)
+            ? (options.intervals as unknown[]).filter(
+                (i): i is { startedAt: string; completedAt?: string } =>
+                  Boolean(i) &&
+                  typeof i === 'object' &&
+                  typeof (i as Record<string, unknown>).startedAt === 'string' &&
+                  ((i as Record<string, unknown>).completedAt === undefined ||
+                    typeof (i as Record<string, unknown>).completedAt === 'string')
+              )
+            : undefined,
         }
       : undefined;
   return wrapTeamHandler('getLogsForTask', () =>
@@ -1714,22 +1746,31 @@ export function showTeamNativeNotification(opts: {
   body: string;
 }): void {
   const config = ConfigManager.getInstance().getConfig();
-  if (!config.notifications.enabled) return;
-  if (config.notifications.snoozedUntil && Date.now() < config.notifications.snoozedUntil) return;
+  if (!config.notifications.enabled) {
+    logger.debug('[native-notification] skipped: notifications disabled');
+    return;
+  }
+  if (config.notifications.snoozedUntil && Date.now() < config.notifications.snoozedUntil) {
+    logger.debug('[native-notification] skipped: snoozed');
+    return;
+  }
 
   if (
     typeof Notification === 'undefined' ||
     typeof Notification.isSupported !== 'function' ||
     !Notification.isSupported()
   ) {
+    logger.warn('[native-notification] skipped: Notification not supported on this platform');
     return;
   }
 
+  const iconPath = getAppIconPath();
   const notification = new Notification({
     title: opts.title,
     subtitle: opts.subtitle,
     body: opts.body.slice(0, 300),
     sound: config.notifications.soundEnabled ? 'default' : undefined,
+    ...(iconPath ? { icon: iconPath } : {}),
   });
 
   notification.on('click', () => {
@@ -1741,6 +1782,14 @@ export function showTeamNativeNotification(opts: {
     }
   });
 
+  notification.on('show', () => {
+    logger.debug(`[native-notification] shown: "${opts.title}" — ${opts.subtitle ?? ''}`);
+  });
+
+  notification.on('failed', (_, error) => {
+    logger.warn(`[native-notification] failed: ${error}`);
+  });
+
   notification.show();
 }
 
@@ -1763,3 +1812,66 @@ async function handleAddTaskComment(
     getTeamDataService().addTaskComment(vTeam.value!, vTask.value!, text.trim())
   );
 }
+
+const VALID_RELATIONSHIP_TYPES = ['blockedBy', 'blocks', 'related'] as const;
+type RelationshipType = (typeof VALID_RELATIONSHIP_TYPES)[number];
+
+async function handleAddTaskRelationship(
+  _event: IpcMainInvokeEvent,
+  teamName: unknown,
+  taskId: unknown,
+  targetId: unknown,
+  type: unknown
+): Promise<IpcResult<void>> {
+  const vTeam = validateTeamName(teamName);
+  if (!vTeam.valid) return { success: false, error: vTeam.error ?? 'Invalid teamName' };
+  const vTask = validateTaskId(taskId);
+  if (!vTask.valid) return { success: false, error: vTask.error ?? 'Invalid taskId' };
+  const vTarget = validateTaskId(targetId);
+  if (!vTarget.valid) return { success: false, error: vTarget.error ?? 'Invalid targetId' };
+  if (typeof type !== 'string' || !VALID_RELATIONSHIP_TYPES.includes(type as RelationshipType)) {
+    return {
+      success: false,
+      error: `type must be one of: ${VALID_RELATIONSHIP_TYPES.join(', ')}`,
+    };
+  }
+
+  return wrapTeamHandler('addTaskRelationship', () =>
+    getTeamDataService().addTaskRelationship(
+      vTeam.value!,
+      vTask.value!,
+      vTarget.value!,
+      type as RelationshipType
+    )
+  );
+}
+
+async function handleRemoveTaskRelationship(
+  _event: IpcMainInvokeEvent,
+  teamName: unknown,
+  taskId: unknown,
+  targetId: unknown,
+  type: unknown
+): Promise<IpcResult<void>> {
+  const vTeam = validateTeamName(teamName);
+  if (!vTeam.valid) return { success: false, error: vTeam.error ?? 'Invalid teamName' };
+  const vTask = validateTaskId(taskId);
+  if (!vTask.valid) return { success: false, error: vTask.error ?? 'Invalid taskId' };
+  const vTarget = validateTaskId(targetId);
+  if (!vTarget.valid) return { success: false, error: vTarget.error ?? 'Invalid targetId' };
+  if (typeof type !== 'string' || !VALID_RELATIONSHIP_TYPES.includes(type as RelationshipType)) {
+    return {
+      success: false,
+      error: `type must be one of: ${VALID_RELATIONSHIP_TYPES.join(', ')}`,
+    };
+  }
+
+  return wrapTeamHandler('removeTaskRelationship', () =>
+    getTeamDataService().removeTaskRelationship(
+      vTeam.value!,
+      vTask.value!,
+      vTarget.value!,
+      type as RelationshipType
+    )
+  );
+}
diff --git a/src/main/services/discovery/ProjectScanner.ts b/src/main/services/discovery/ProjectScanner.ts
index 2acfc29f..4d2e9109 100644
--- a/src/main/services/discovery/ProjectScanner.ts
+++ b/src/main/services/discovery/ProjectScanner.ts
@@ -196,10 +196,6 @@ export class ProjectScanner {
       // 1. Scan all projects using existing logic
       const projects = await this.scan();
 
-      if (projects.length === 0) {
-        return [];
-      }
-
       // 2. Convert each project to a simple RepositoryGroup (git resolution disabled)
       // Git identity resolution is bypassed to avoid blocking I/O on startup.
       // Each project becomes a single-worktree group.
@@ -223,6 +219,40 @@ export class ProjectScanner {
         totalSessions: project.sessions.length,
       }));
 
+      // 3. Merge custom project paths from config (persisted "Select Folder" picks)
+      const { configManager } = await import('../infrastructure/ConfigManager');
+      const customPaths = configManager.getCustomProjectPaths();
+      const existingPaths = new Set(groups.flatMap((g) => g.worktrees.map((w) => w.path)));
+
+      for (const customPath of customPaths) {
+        if (existingPaths.has(customPath)) {
+          continue; // Already discovered by scanner — skip
+        }
+
+        const encodedId = customPath.replace(/[/\\]/g, '-');
+        const folderName = customPath.split(/[/\\]/).filter(Boolean).pop() ?? customPath;
+        const now = Date.now();
+
+        groups.push({
+          id: encodedId,
+          identity: null,
+          worktrees: [
+            {
+              id: encodedId,
+              path: customPath,
+              name: folderName,
+              isMainWorktree: true,
+              source: 'unknown' as const,
+              sessions: [],
+              createdAt: now,
+            },
+          ],
+          name: folderName,
+          mostRecentSession: undefined,
+          totalSessions: 0,
+        });
+      }
+
       // Sort by most recent activity (same order as the full git-aware version)
       groups.sort((a, b) => (b.mostRecentSession ?? 0) - (a.mostRecentSession ?? 0));
 
@@ -309,7 +339,8 @@ export class ProjectScanner {
 
       // Group sessions by cwd
       const cwdGroups = new Map<string, SessionInfo[]>();
-      const baseName = extractProjectName(encodedName);
+      const firstCwd = sessionInfos.find((s) => s.cwd)?.cwd ?? undefined;
+      const baseName = extractProjectName(encodedName, firstCwd);
       const decodedFallback = baseName; // Used when cwd is null
 
       for (const info of sessionInfos) {
@@ -341,11 +372,15 @@ export class ProjectScanner {
           sessionPaths,
         });
 
+        // Derive name from resolved path — more reliable than decodePath for
+        // paths containing dashes (e.g. "test-project" encodes lossily).
+        const resolvedName = path.basename(actualPath) || baseName;
+
         return [
           {
             id: encodedName,
             path: actualPath,
-            name: baseName,
+            name: resolvedName,
             sessions: allSessionIds,
             createdAt: Math.floor(createdAt),
             mostRecentSession: mostRecentSession ? Math.floor(mostRecentSession) : undefined,
@@ -362,6 +397,8 @@ export class ProjectScanner {
         (shortest, cwd) => (cwd.length <= shortest.length ? cwd : shortest),
         cwdKeys[0] ?? ''
       );
+      // Derive root name from actual cwd path (more reliable than decodePath)
+      const rootName = path.basename(rootCwd) || baseName;
 
       for (const [cwdKey, sessions] of cwdGroups) {
         const isDecodedFallback = cwdKey.startsWith('__decoded__');
@@ -387,14 +424,14 @@ export class ProjectScanner {
           }
         }
 
-        // Build display name
+        // Build display name from actual cwd paths
         let displayName: string;
         if (!actualCwd || actualCwd === rootCwd) {
-          displayName = baseName;
+          displayName = rootName;
         } else {
           // Use last segment of cwd for disambiguation
           const lastSegment = path.basename(actualCwd);
-          displayName = `${baseName} (${lastSegment})`;
+          displayName = `${rootName} (${lastSegment})`;
         }
 
         projects.push({
diff --git a/src/main/services/editor/EditorFileWatcher.ts b/src/main/services/editor/EditorFileWatcher.ts
index 9aaf31b7..fbb9c306 100644
--- a/src/main/services/editor/EditorFileWatcher.ts
+++ b/src/main/services/editor/EditorFileWatcher.ts
@@ -22,11 +22,8 @@ const log = createLogger('EditorFileWatcher');
 // Constants
 // =============================================================================
 
-/** Directories to ignore (regex for chokidar's `ignored` option) */
-const IGNORED_PATTERN =
-  /(node_modules|\.git|dist|__pycache__|\.cache|\.next|\.venv|\.tox|vendor|\.DS_Store)/;
-
-const MAX_DEPTH = 20;
+const STARTUP_IGNORE_CHANGE_MS = 3000;
+const MAX_EMITTED_EVENTS_PER_FLUSH = 300;
 
 // =============================================================================
 // Service
@@ -34,32 +31,80 @@ const MAX_DEPTH = 20;
 
 export class EditorFileWatcher {
   private watcher: FSWatcher | null = null;
+  private dirWatcher: FSWatcher | null = null;
   private projectRoot: string | null = null;
+  private pendingEvents = new Map<string, EditorFileChangeEvent['type']>();
+  private flushTimer: ReturnType<typeof setTimeout> | null = null;
+  private onChangeCallback: ((event: EditorFileChangeEvent) => void) | null = null;
+  // Higher debounce = fewer IPC events during large bursts (checkout/build/format).
+  private readonly DEBOUNCE_MS = 350;
+  private ignoreChangeUntilMs = 0;
+  private watchedFilesKey = '';
+  private watchedDirsKey = '';
 
   /**
-   * Start watching a project directory.
-   * Idempotent: stops any existing watcher first.
+   * Initialize watcher context for a project root.
+   *
+   * Performance: does NOT watch the entire project directory.
+   * Use setWatchedFiles() to watch only open files (tabs).
    */
   start(projectRoot: string, onChange: (event: EditorFileChangeEvent) => void): void {
     this.stop();
     this.projectRoot = projectRoot;
+    this.ignoreChangeUntilMs = Date.now() + STARTUP_IGNORE_CHANGE_MS;
+    this.watchedFilesKey = '';
+    this.watchedDirsKey = '';
 
-    log.info('Starting file watcher for:', projectRoot);
+    log.info('Starting file watcher (open files only) for:', projectRoot);
+    this.onChangeCallback = onChange;
+  }
 
-    this.watcher = watch(projectRoot, {
-      ignored: IGNORED_PATTERN,
+  /**
+   * Update list of watched file paths (open tabs).
+   * Rebuilds chokidar watcher when the set changes.
+   */
+  setWatchedFiles(filePaths: string[]): void {
+    if (!this.projectRoot) {
+      return; // Watcher not initialized yet — will sync when start() is called
+    }
+
+    const normalized = filePaths
+      .filter((p): p is string => typeof p === 'string' && p.length > 0)
+      .filter((p) => isPathWithinRoot(p, this.projectRoot!));
+
+    normalized.sort((a, b) => a.localeCompare(b));
+    const key = normalized.join('\n');
+    if (key === this.watchedFilesKey) return;
+    this.watchedFilesKey = key;
+
+    // Close existing watcher first (if any)
+    if (this.watcher) {
+      void this.watcher.close();
+      this.watcher = null;
+    }
+
+    if (normalized.length === 0) {
+      return;
+    }
+
+    // Build a new watcher for the given file set.
+    // disableGlobbing prevents chokidar from treating file names as patterns.
+    this.watcher = watch(normalized, {
       ignoreInitial: true,
+      ignorePermissionErrors: true,
       followSymlinks: false,
-      depth: MAX_DEPTH,
     });
 
     const emitSafe = (type: EditorFileChangeEvent['type'], filePath: string): void => {
-      // SEC-2: validate path is within project root before sending to renderer
-      if (!isPathWithinRoot(filePath, projectRoot)) {
+      if (type === 'change' && Date.now() < this.ignoreChangeUntilMs) {
+        return;
+      }
+      if (!isPathWithinRoot(filePath, this.projectRoot!)) {
         log.warn('Watcher event outside project root, ignoring:', filePath);
         return;
       }
-      onChange({ type, path: filePath });
+      this.pendingEvents.set(filePath, type);
+      this.scheduleFlush();
     };
 
     this.watcher.on('change', (p) => emitSafe('change', p));
@@ -71,18 +116,122 @@ export class EditorFileWatcher {
     });
   }
 
+  /**
+   * Update list of watched directory paths (shallow: depth=0).
+   * Watches only immediate children changes (create/delete/rename) in those folders.
+   */
+  setWatchedDirs(dirPaths: string[]): void {
+    if (!this.projectRoot) {
+      return; // Watcher not initialized yet — will sync when start() is called
+    }
+
+    const normalized = dirPaths
+      .filter((p): p is string => typeof p === 'string' && p.length > 0)
+      .filter((p) => isPathWithinRoot(p, this.projectRoot!));
+
+    normalized.sort((a, b) => a.localeCompare(b));
+    const key = normalized.join('\n');
+    if (key === this.watchedDirsKey) return;
+    this.watchedDirsKey = key;
+
+    if (this.dirWatcher) {
+      void this.dirWatcher.close();
+      this.dirWatcher = null;
+    }
+
+    if (normalized.length === 0) {
+      return;
+    }
+
+    this.dirWatcher = watch(normalized, {
+      ignoreInitial: true,
+      ignorePermissionErrors: true,
+      followSymlinks: false,
+      depth: 0,
+    });
+
+    const emitSafe = (type: EditorFileChangeEvent['type'], filePath: string): void => {
+      if (!isPathWithinRoot(filePath, this.projectRoot!)) {
+        log.warn('Watcher event outside project root, ignoring:', filePath);
+        return;
+      }
+      this.pendingEvents.set(filePath, type);
+      this.scheduleFlush();
+    };
+
+    // For directories, we only care about structural changes.
+    this.dirWatcher.on('add', (p) => emitSafe('create', p));
+    this.dirWatcher.on('unlink', (p) => emitSafe('delete', p));
+    this.dirWatcher.on('addDir', (p) => emitSafe('create', p));
+    this.dirWatcher.on('unlinkDir', (p) => emitSafe('delete', p));
+
+    this.dirWatcher.on('error', (error) => {
+      log.error('Dir watcher error:', error);
+    });
+  }
+
   /**
    * Stop watching. Safe to call multiple times.
    */
   stop(): void {
+    if (this.flushTimer) {
+      clearTimeout(this.flushTimer);
+      this.flushTimer = null;
+    }
+    this.pendingEvents.clear();
+    this.onChangeCallback = null;
+    this.ignoreChangeUntilMs = 0;
+    this.watchedFilesKey = '';
+    this.watchedDirsKey = '';
     if (this.watcher) {
       log.info('Stopping file watcher');
       void this.watcher.close();
       this.watcher = null;
     }
+    if (this.dirWatcher) {
+      log.info('Stopping directory watcher');
+      void this.dirWatcher.close();
+      this.dirWatcher = null;
+    }
     this.projectRoot = null;
   }
 
+  /**
+   * Flush pending events — debounced to aggregate rapid FS changes
+   * (e.g. git checkout, bulk format). Fires once after 150ms of quiet.
+   */
+  private scheduleFlush(): void {
+    if (this.flushTimer) return;
+    this.flushTimer = setTimeout(() => {
+      this.flushTimer = null;
+      const events = new Map(this.pendingEvents);
+      this.pendingEvents.clear();
+      if (!this.onChangeCallback) return;
+      // Cap emitted events per flush to protect renderer from floods.
+      // Prefer create/delete events over change events.
+      let emitted = 0;
+
+      if (events.size > MAX_EMITTED_EVENTS_PER_FLUSH) {
+        log.warn(
+          `Watcher burst: ${events.size} events pending, capping to ${MAX_EMITTED_EVENTS_PER_FLUSH}`
+        );
+      }
+
+      const emit = (type: EditorFileChangeEvent['type']): void => {
+        for (const [filePath, t] of events) {
+          if (t !== type) continue;
+          this.onChangeCallback?.({ type: t, path: filePath });
+          emitted++;
+          if (emitted >= MAX_EMITTED_EVENTS_PER_FLUSH) return;
+        }
+      };
+
+      emit('delete');
+      if (emitted < MAX_EMITTED_EVENTS_PER_FLUSH) emit('create');
+      if (emitted < MAX_EMITTED_EVENTS_PER_FLUSH) emit('change');
+    }, this.DEBOUNCE_MS);
+  }
+
   /**
    * Whether the watcher is currently active.
    */
diff --git a/src/main/services/editor/FileSearchService.ts b/src/main/services/editor/FileSearchService.ts
index 14357444..eb85bfe3 100644
--- a/src/main/services/editor/FileSearchService.ts
+++ b/src/main/services/editor/FileSearchService.ts
@@ -147,6 +147,7 @@ export class FileSearchService {
     }
 
     const sorted = [...entries].sort((a, b) => a.name.localeCompare(b.name));
+    const subdirs: string[] = [];
 
     for (const entry of sorted) {
       if (signal?.aborted || files.length >= MAX_FILES) break;
@@ -158,7 +159,7 @@ export class FileSearchService {
 
       if (entry.isDirectory()) {
         if (IGNORED_DIRS.has(entry.name) || entry.name.startsWith('.')) continue;
-        await this.collectFilePaths(projectRoot, fullPath, files, signal);
+        subdirs.push(fullPath);
       } else if (entry.isFile()) {
         if (IGNORED_FILES.has(entry.name)) continue;
         const relativePath = fullPath.startsWith(projectRoot)
@@ -167,6 +168,14 @@ export class FileSearchService {
         files.push({ path: fullPath, name: entry.name, relativePath });
       }
     }
+
+    // Parallel subdirectory traversal (batched)
+    const DIR_CONCURRENCY = 10;
+    for (let i = 0; i < subdirs.length; i += DIR_CONCURRENCY) {
+      if (signal?.aborted || files.length >= MAX_FILES) break;
+      const batch = subdirs.slice(i, i + DIR_CONCURRENCY);
+      await Promise.all(batch.map((dir) => this.collectFilePaths(projectRoot, dir, files, signal)));
+    }
   }
 
   /**
@@ -194,8 +203,11 @@ export class FileSearchService {
       return a.name.localeCompare(b.name);
     });
 
+    const candidates: string[] = [];
+    const subdirs: string[] = [];
+
     for (const entry of sorted) {
-      if (signal?.aborted || files.length >= MAX_FILES) break;
+      if (signal?.aborted) break;
 
       const fullPath = path.join(dirPath, entry.name);
 
@@ -207,32 +219,48 @@ export class FileSearchService {
 
       if (entry.isDirectory()) {
         if (IGNORED_DIRS.has(entry.name) || entry.name.startsWith('.')) continue;
-        await this.collectFiles(projectRoot, fullPath, files, signal);
+        subdirs.push(fullPath);
       } else if (entry.isFile()) {
         if (IGNORED_FILES.has(entry.name)) continue;
-
-        // Skip files > 1MB
-        try {
-          const stat = await fs.stat(fullPath);
-          if (stat.size > MAX_FILE_SIZE) continue;
-        } catch {
-          continue;
-        }
-
-        // Skip binary files (quick check via first 512 bytes)
-        try {
-          if (await isBinaryFile(fullPath)) continue;
-        } catch {
-          continue;
-        }
-
-        files.push(fullPath);
+        candidates.push(fullPath);
       }
     }
+
+    // Parallel stat + binary check (batched by 20 for I/O concurrency)
+    const CHECK_CONCURRENCY = 20;
+    for (let i = 0; i < candidates.length; i += CHECK_CONCURRENCY) {
+      if (signal?.aborted || files.length >= MAX_FILES) break;
+      const batch = candidates.slice(i, i + CHECK_CONCURRENCY);
+      const results = await Promise.all(
+        batch.map(async (fp) => {
+          try {
+            const stat = await fs.stat(fp);
+            if (stat.size > MAX_FILE_SIZE) return null;
+            if (await isBinaryFile(fp)) return null;
+            return fp;
+          } catch {
+            return null;
+          }
+        })
+      );
+      for (const fp of results) {
+        if (fp && files.length < MAX_FILES) files.push(fp);
+      }
+    }
+
+    // Parallel subdirectory traversal (batched)
+    const DIR_CONCURRENCY = 10;
+    for (let i = 0; i < subdirs.length; i += DIR_CONCURRENCY) {
+      if (signal?.aborted || files.length >= MAX_FILES) break;
+      const batch = subdirs.slice(i, i + DIR_CONCURRENCY);
+      await Promise.all(batch.map((dir) => this.collectFiles(projectRoot, dir, files, signal)));
+    }
   }
 
   /**
    * Search a single file for literal string matches.
+   * Uses indexOf on the full content instead of split() — avoids 50k+ string allocations
+   * for a 1MB file. Running line counter keeps O(n) total regardless of match count.
    */
   private async searchFile(
     filePath: string,
@@ -242,29 +270,38 @@ export class FileSearchService {
   ): Promise<SearchMatch[]> {
     if (signal?.aborted) return [];
 
-    const content = await fs.readFile(filePath, 'utf8');
-    const lines = content.split('\n');
+    const raw = await fs.readFile(filePath, 'utf8');
+    const content = caseSensitive ? raw : raw.toLowerCase();
     const matches: SearchMatch[] = [];
 
-    for (let i = 0; i < lines.length; i++) {
+    let searchFrom = 0;
+    let line = 1;
+    let lastCountedPos = 0;
+
+    while (true) {
       if (signal?.aborted) break;
+      const idx = content.indexOf(query, searchFrom);
+      if (idx === -1) break;
 
-      const line = lines[i];
-      const searchLine = caseSensitive ? line : line.toLowerCase();
-      let startIndex = 0;
-
-      while (true) {
-        const idx = searchLine.indexOf(query, startIndex);
-        if (idx === -1) break;
-
-        matches.push({
-          line: i + 1,
-          column: idx,
-          lineContent: line.trim(),
-        });
-
-        startIndex = idx + query.length;
+      // Running line counter — count \n from lastCountedPos to idx
+      for (let i = lastCountedPos; i < idx; i++) {
+        if (content.charCodeAt(i) === 10) line++;
       }
+      lastCountedPos = idx;
+
+      // Extract line content from raw text
+      let lineStart = raw.lastIndexOf('\n', idx);
+      lineStart = lineStart === -1 ? 0 : lineStart + 1;
+      let lineEnd = raw.indexOf('\n', idx);
+      if (lineEnd === -1) lineEnd = raw.length;
+
+      matches.push({
+        line,
+        column: idx - lineStart,
+        lineContent: raw.slice(lineStart, lineEnd).trim(),
+      });
+
+      searchFrom = idx + query.length;
     }
 
     return matches;
diff --git a/src/main/services/editor/GitStatusService.ts b/src/main/services/editor/GitStatusService.ts
index 7f26278a..1758b278 100644
--- a/src/main/services/editor/GitStatusService.ts
+++ b/src/main/services/editor/GitStatusService.ts
@@ -20,6 +20,8 @@ const log = createLogger('GitStatusService');
 
 const GIT_TIMEOUT_MS = 10_000;
 const CACHE_TTL_MS = 5_000;
+const CHANGE_INVALIDATION_DEBOUNCE_MS = 500;
+const GIT_STATUS_ARGS: string[] = ['--untracked-files=no'];
 
 // =============================================================================
 // Service
@@ -28,10 +30,13 @@ const CACHE_TTL_MS = 5_000;
 export class GitStatusService {
   private git: SimpleGit | null = null;
   private projectRoot: string | null = null;
+  /** Set to true when we confirm the project is not a git repo — skip all future git calls. */
+  private notAGitRepo = false;
 
   // Cache
   private cachedResult: GitStatusResult | null = null;
   private cacheTimestamp = 0;
+  private changeDebounceTimer: ReturnType<typeof setTimeout> | null = null;
 
   /**
    * Initialize service for a project root.
@@ -39,6 +44,7 @@ export class GitStatusService {
    */
   init(projectRoot: string): void {
     this.projectRoot = projectRoot;
+    this.notAGitRepo = false;
     this.git = simpleGit({
       baseDir: projectRoot,
       timeout: { block: GIT_TIMEOUT_MS },
@@ -50,64 +56,91 @@ export class GitStatusService {
    * Reset service state.
    */
   destroy(): void {
+    this.clearDebounceTimer();
     this.git = null;
     this.projectRoot = null;
+    this.notAGitRepo = false;
     this.cachedResult = null;
     this.cacheTimestamp = 0;
   }
 
   /**
-   * Invalidate cached status (e.g. on file watcher event).
+   * Immediate cache invalidation for structural changes (create/delete).
+   * Also cancels any pending debounced invalidation.
    */
   invalidateCache(): void {
+    this.clearDebounceTimer();
     this.cachedResult = null;
     this.cacheTimestamp = 0;
   }
 
+  /**
+   * Debounced cache invalidation for content changes.
+   * Coalesces rapid file saves (typing, format-on-save, build output)
+   * into a single invalidation after the burst settles.
+   */
+  invalidateCacheDebounced(): void {
+    this.clearDebounceTimer();
+    this.changeDebounceTimer = setTimeout(() => {
+      this.changeDebounceTimer = null;
+      this.cachedResult = null;
+      this.cacheTimestamp = 0;
+    }, CHANGE_INVALIDATION_DEBOUNCE_MS);
+  }
+
   /**
    * Get git status for the current project.
    * Returns cached result if within TTL.
    */
   async getStatus(): Promise<GitStatusResult> {
-    if (!this.git || !this.projectRoot) {
-      return { files: [], isGitRepo: false, branch: null };
+    const notGitResult: GitStatusResult = { files: [], isGitRepo: false, branch: null };
+
+    if (!this.git || !this.projectRoot || this.notAGitRepo) {
+      return notGitResult;
+    }
+
+    // Flush pending debounced invalidation — when data is actually requested,
+    // stale cache must not be served even if the debounce hasn't settled yet.
+    if (this.changeDebounceTimer) {
+      this.invalidateCache();
     }
 
     // Return cached if fresh
     if (this.cachedResult && Date.now() - this.cacheTimestamp < CACHE_TTL_MS) {
+      log.info('[perf] gitStatus: cache hit');
       return this.cachedResult;
     }
 
     try {
-      // Check if it's a git repo first
-      const isRepo = await this.isGitRepo();
-      if (!isRepo) {
-        const result: GitStatusResult = { files: [], isGitRepo: false, branch: null };
-        this.setCacheResult(result);
-        return result;
-      }
-
-      const statusResult = await this.git.status();
+      const t0 = performance.now();
+      // `--untracked-files=no` is a major performance win for large repos with many untracked files.
+      // Most editors treat untracked as a separate concern; showing them can overwhelm the UI.
+      const statusResult = await this.git.status(GIT_STATUS_ARGS);
+      const gitMs = performance.now() - t0;
       const files = mapStatusResult(statusResult);
       const branch = statusResult.current ?? null;
+      log.info(
+        `[perf] gitStatus: git=${gitMs.toFixed(1)}ms, files=${files.length}, branch=${branch ?? 'detached'}, untracked=off`
+      );
 
       const result: GitStatusResult = { files, isGitRepo: true, branch };
       this.setCacheResult(result);
       return result;
     } catch (error) {
-      log.error('Failed to get git status:', error);
-      // Graceful degradation: return empty non-repo result
-      return { files: [], isGitRepo: false, branch: null };
-    }
-  }
+      const message = error instanceof Error ? error.message : String(error);
 
-  private async isGitRepo(): Promise<boolean> {
-    if (!this.git) return false;
-    try {
-      await this.git.revparse(['--is-inside-work-tree']);
-      return true;
-    } catch {
-      return false;
+      if (message.includes('not a git repository')) {
+        // Expected condition — project is not a git repo. Stop all future git calls
+        // until init() is called again with a different project.
+        log.info('Project is not a git repository, disabling git status');
+        this.notAGitRepo = true;
+        return notGitResult;
+      }
+
+      log.error('Failed to get git status:', error);
+      // Transient error — cache negative result to avoid hammering git, but allow retry after TTL
+      this.setCacheResult(notGitResult);
+      return notGitResult;
     }
   }
 
@@ -115,6 +148,13 @@ export class GitStatusService {
     this.cachedResult = result;
     this.cacheTimestamp = Date.now();
   }
+
+  private clearDebounceTimer(): void {
+    if (this.changeDebounceTimer) {
+      clearTimeout(this.changeDebounceTimer);
+      this.changeDebounceTimer = null;
+    }
+  }
 }
 
 // =============================================================================
diff --git a/src/main/services/editor/ProjectFileService.ts b/src/main/services/editor/ProjectFileService.ts
index 7ac0a2ee..e203770c 100644
--- a/src/main/services/editor/ProjectFileService.ts
+++ b/src/main/services/editor/ProjectFileService.ts
@@ -23,6 +23,7 @@ import { isBinaryFile } from 'isbinaryfile';
 import * as path from 'path';
 
 import type {
+  BinaryPreviewResult,
   CreateDirResponse,
   CreateFileResponse,
   DeleteFileResponse,
@@ -43,6 +44,32 @@ const MAX_WRITE_SIZE = 2 * 1024 * 1024; // 2 MB
 const MAX_DIR_ENTRIES = 500;
 const PREVIEW_LINE_COUNT = 100;
 
+/**
+ * Extract the first N lines from text using indexOf — O(1) allocations vs split().
+ * For a 5MB file with 100k lines, avoids creating 100k string objects.
+ */
+function sliceFirstNLines(text: string, n: number): string {
+  let pos = 0;
+  for (let i = 0; i < n; i++) {
+    const next = text.indexOf('\n', pos);
+    if (next === -1) return text;
+    pos = next + 1;
+  }
+  return text.slice(0, pos > 0 ? pos - 1 : 0);
+}
+
+const PREVIEW_MIME_MAP: Record<string, string> = {
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.webp': 'image/webp',
+  '.svg': 'image/svg+xml',
+  '.bmp': 'image/bmp',
+  '.ico': 'image/x-icon',
+};
+const MAX_PREVIEW_SIZE = 10 * 1024 * 1024; // 10 MB
+
 const IGNORED_DIRS = new Set([
   '.git',
   'node_modules',
@@ -77,6 +104,7 @@ export class ProjectFileService {
     dirPath: string,
     maxEntries: number = MAX_DIR_ENTRIES
   ): Promise<ReadDirResult> {
+    const t0 = performance.now();
     const normalizedDir = path.resolve(dirPath);
 
     // Containment check (allow sensitive files to be listed with flag)
@@ -90,51 +118,58 @@ export class ProjectFileService {
     }
 
     const dirents = await fs.readdir(normalizedDir, { withFileTypes: true });
-    const entries: FileTreeEntry[] = [];
-    let truncated = false;
+
+    // Phase 1: classify entries without I/O (instant)
+    const pendingEntries: {
+      dirent: { name: string };
+      entryPath: string;
+      type: 'file' | 'directory' | 'symlink';
+    }[] = [];
 
     for (const dirent of dirents) {
-      // Ignore well-known noise
       if (dirent.isDirectory() && IGNORED_DIRS.has(dirent.name)) continue;
       if (dirent.isFile() && IGNORED_FILES.has(dirent.name)) continue;
 
       const entryPath = path.join(normalizedDir, dirent.name);
+      if (!isPathWithinRoot(entryPath, projectRoot)) continue;
+      if (isGitInternalPath(entryPath)) continue;
 
-      // Symlink handling: resolve and re-check containment
       if (dirent.isSymbolicLink()) {
-        try {
-          const realPath = await fs.realpath(entryPath);
-          if (!isPathWithinAllowedDirectories(realPath, projectRoot)) {
-            continue; // Silently skip symlinks that escape project root (SEC-2)
-          }
-          const realStat = await fs.stat(realPath);
-          const entry = this.buildEntry(
-            dirent.name,
-            entryPath,
-            realStat.isDirectory() ? 'directory' : 'file',
-            realStat.isFile() ? realStat.size : undefined
-          );
-          entries.push(entry);
-        } catch {
-          // Broken symlink — skip silently
-          continue;
-        }
+        pendingEntries.push({ dirent, entryPath, type: 'symlink' });
       } else if (dirent.isDirectory()) {
-        entries.push(this.buildEntry(dirent.name, entryPath, 'directory'));
+        pendingEntries.push({ dirent, entryPath, type: 'directory' });
       } else if (dirent.isFile()) {
-        try {
-          const fileStat = await fs.stat(entryPath);
-          entries.push(this.buildEntry(dirent.name, entryPath, 'file', fileStat.size));
-        } catch {
-          // Can't stat — include without size
-          entries.push(this.buildEntry(dirent.name, entryPath, 'file'));
-        }
+        pendingEntries.push({ dirent, entryPath, type: 'file' });
       }
-      // Skip other types (block devices, sockets, etc.)
 
-      if (entries.length >= maxEntries) {
-        truncated = true;
-        break;
+      if (pendingEntries.length >= maxEntries) break;
+    }
+
+    // Phase 2: resolve entries in parallel (I/O-bound)
+    const STAT_CONCURRENCY = 50;
+    const entries: FileTreeEntry[] = [];
+
+    for (let i = 0; i < pendingEntries.length; i += STAT_CONCURRENCY) {
+      const batch = pendingEntries.slice(i, i + STAT_CONCURRENCY);
+      const resolved = await Promise.all(
+        batch.map(async ({ dirent, entryPath, type }) => {
+          if (type === 'directory') {
+            return this.buildEntry(dirent.name, entryPath, 'directory');
+          }
+          if (type === 'symlink') {
+            return this.resolveSymlinkEntry(dirent.name, entryPath, projectRoot);
+          }
+          // file — stat for size
+          try {
+            const fileStat = await fs.stat(entryPath);
+            return this.buildEntry(dirent.name, entryPath, 'file', fileStat.size);
+          } catch {
+            return this.buildEntry(dirent.name, entryPath, 'file');
+          }
+        })
+      );
+      for (const entry of resolved) {
+        if (entry) entries.push(entry);
       }
     }
 
@@ -144,7 +179,14 @@ export class ProjectFileService {
       return a.name.localeCompare(b.name);
     });
 
-    return { entries, truncated };
+    const totalMs = performance.now() - t0;
+    if (totalMs > 50) {
+      log.info(
+        `[perf] readDir: ${totalMs.toFixed(1)}ms, entries=${entries.length}, dirents=${dirents.length}, dir=${path.basename(normalizedDir)}`
+      );
+    }
+
+    return { entries, truncated: pendingEntries.length >= maxEntries };
   }
 
   /**
@@ -209,7 +251,7 @@ export class ProjectFileService {
 
     // 8. Tiered response
     const isPreview = stats.size > MAX_FILE_SIZE_FULL;
-    const content = isPreview ? raw.split('\n').slice(0, PREVIEW_LINE_COUNT).join('\n') : raw;
+    const content = isPreview ? sliceFirstNLines(raw, PREVIEW_LINE_COUNT) : raw;
 
     return {
       content,
@@ -505,7 +547,7 @@ export class ProjectFileService {
     const newPath = path.join(normalizedDest, path.basename(normalizedSrc));
 
     // 8. Prevent parent → child move (moving dir into itself)
-    if (normalizedDest.startsWith(normalizedSrc + '/') || normalizedDest === normalizedSrc) {
+    if (normalizedDest.startsWith(normalizedSrc + path.sep) || normalizedDest === normalizedSrc) {
       throw new Error('Cannot move a directory into itself');
     }
 
@@ -529,8 +571,8 @@ export class ProjectFileService {
       await fs.rename(normalizedSrc, newPath);
     } catch (err) {
       if ((err as NodeJS.ErrnoException).code === 'EXDEV') {
-        const stat = await fs.lstat(normalizedSrc);
-        if (stat.isDirectory()) {
+        // Reuse srcStat from step 5 — no need for another fs.lstat
+        if (isDirectory) {
           await fs.cp(normalizedSrc, newPath, { recursive: true });
         } else {
           await fs.copyFile(normalizedSrc, newPath);
@@ -545,10 +587,152 @@ export class ProjectFileService {
     return { newPath, isDirectory };
   }
 
+  /**
+   * Rename a file or directory in place (same parent directory).
+   */
+  async renameFile(
+    projectRoot: string,
+    sourcePath: string,
+    newName: string
+  ): Promise<MoveFileResponse> {
+    // 1. Validate new name
+    const nameValidation = validateFileName(newName);
+    if (!nameValidation.valid) {
+      throw new Error(nameValidation.error);
+    }
+
+    // 2. Validate source path
+    const srcValidation = validateFilePath(sourcePath, projectRoot);
+    if (!srcValidation.valid) {
+      throw new Error(srcValidation.error);
+    }
+    const normalizedSrc = srcValidation.normalizedPath!;
+
+    // 3. Project containment
+    if (!isPathWithinRoot(normalizedSrc, projectRoot)) {
+      throw new Error('Source path is outside project root');
+    }
+
+    // 4. Block .git/ paths
+    if (isGitInternalPath(normalizedSrc)) {
+      throw new Error('Cannot rename files in .git/ directory');
+    }
+
+    // 5. Verify source exists
+    const srcStat = await fs.lstat(normalizedSrc);
+    const isDirectory = srcStat.isDirectory();
+
+    // 6. Build new path (same parent, new name)
+    const parentDir = path.dirname(normalizedSrc);
+    const newPath = path.join(parentDir, newName);
+
+    // 7. Check new path doesn't already exist
+    try {
+      await fs.access(newPath);
+      throw new Error('A file or folder with that name already exists');
+    } catch (err) {
+      if ((err as NodeJS.ErrnoException).code !== 'ENOENT') {
+        throw err;
+      }
+    }
+
+    // 8. Block sensitive destination
+    if (matchesSensitivePattern(newPath)) {
+      throw new Error('Cannot rename to a sensitive file name');
+    }
+
+    // 9. Perform rename
+    await fs.rename(normalizedSrc, newPath);
+
+    log.info('File renamed:', normalizedSrc, '→', newPath);
+    return { newPath, isDirectory };
+  }
+
+  /**
+   * Read a binary file as base64 for inline preview (images, etc.).
+   *
+   * Security:
+   * - validateFilePath for traversal + sensitive check (SEC-1)
+   * - Device path blocking (SEC-4)
+   * - lstat + isFile check (SEC-4)
+   * - Size limit (10MB)
+   * - Post-read TOCTOU realpath verify (SEC-3)
+   */
+  async readBinaryPreview(projectRoot: string, filePath: string): Promise<BinaryPreviewResult> {
+    // 1. Path validation
+    const validation = validateFilePath(filePath, projectRoot);
+    if (!validation.valid) {
+      throw new Error(validation.error);
+    }
+
+    const normalizedPath = validation.normalizedPath!;
+
+    // 2. Device path block
+    if (isDevicePath(normalizedPath)) {
+      throw new Error('Cannot read device files');
+    }
+
+    // 3. File type check
+    const stats = await fs.lstat(normalizedPath);
+    if (!stats.isFile()) {
+      throw new Error('Not a regular file');
+    }
+
+    // 4. Size check
+    if (stats.size > MAX_PREVIEW_SIZE) {
+      throw new Error(
+        `File too large for preview (${(stats.size / 1024 / 1024).toFixed(1)}MB). Maximum is 10MB.`
+      );
+    }
+
+    // 5. MIME type from extension
+    const ext = path.extname(normalizedPath).toLowerCase();
+    const mimeType = PREVIEW_MIME_MAP[ext];
+    if (!mimeType) {
+      throw new Error(`Unsupported preview format: ${ext}`);
+    }
+
+    // 6. Read file as Buffer → base64
+    const buffer = await fs.readFile(normalizedPath);
+
+    // 7. Post-read TOCTOU verify
+    const realPath = await fs.realpath(normalizedPath);
+    const postValidation = validateFilePath(realPath, projectRoot);
+    if (!postValidation.valid) {
+      throw new Error('Path changed during read (TOCTOU)');
+    }
+
+    return {
+      base64: buffer.toString('base64'),
+      mimeType,
+      size: stats.size,
+    };
+  }
+
   // ---------------------------------------------------------------------------
   // Helpers
   // ---------------------------------------------------------------------------
 
+  private async resolveSymlinkEntry(
+    name: string,
+    entryPath: string,
+    projectRoot: string
+  ): Promise<FileTreeEntry | null> {
+    try {
+      const realPath = await fs.realpath(entryPath);
+      if (!isPathWithinAllowedDirectories(realPath, projectRoot)) return null;
+      const realStat = await fs.stat(realPath);
+      return this.buildEntry(
+        name,
+        entryPath,
+        realStat.isDirectory() ? 'directory' : 'file',
+        realStat.isFile() ? realStat.size : undefined
+      );
+    } catch {
+      return null; // broken symlink
+    }
+  }
+
   private buildEntry(
     name: string,
     entryPath: string,
diff --git a/src/main/services/infrastructure/CliInstallerService.ts b/src/main/services/infrastructure/CliInstallerService.ts
index 42dee30c..04a66b13 100644
--- a/src/main/services/infrastructure/CliInstallerService.ts
+++ b/src/main/services/infrastructure/CliInstallerService.ts
@@ -58,7 +58,10 @@ const MAX_REDIRECTS = 5;
 const HTTP_CONNECT_TIMEOUT_MS = 15_000;
 
 /** Overall timeout for getStatus() to prevent UI hanging indefinitely (ms) */
-const GET_STATUS_TIMEOUT_MS = 25_000;
+const GET_STATUS_TIMEOUT_MS = 30_000;
+
+/** Overall timeout for the auth status check (covers both attempts + retry delay) (ms) */
+const AUTH_TOTAL_TIMEOUT_MS = 15_000;
 
 /** Max retries for EBUSY (antivirus scanning the new binary) */
 const EBUSY_MAX_RETRIES = 3;
@@ -66,6 +69,12 @@ const EBUSY_MAX_RETRIES = 3;
 /** Delay between EBUSY retries (multiplied by attempt number) */
 const EBUSY_RETRY_DELAY_MS = 2000;
 
+/** Max retries for auth status check (covers stale locks after Ctrl+C) */
+const AUTH_STATUS_MAX_RETRIES = 2;
+
+/** Delay before retrying auth status check (ms) — gives previous process time to clean up */
+const AUTH_STATUS_RETRY_DELAY_MS = 1500;
+
 /**
  * Build env for child processes with correct HOME.
  * On Windows with non-ASCII usernames, process.env may have a broken HOME/USERPROFILE.
@@ -263,6 +272,8 @@ export class CliInstallerService {
    * Gathers CLI status information, mutating the provided result object.
    * Split from getStatus() to enable overall timeout via Promise.race —
    * on timeout, getStatus() returns whatever fields were populated so far.
+   *
+   * Flow: binary resolve → --version (sequential) → Promise.all([auth, GCS]) (parallel)
    */
   private async gatherStatus(ref: { current: CliInstallationStatus }): Promise<void> {
     const r = ref.current;
@@ -284,31 +295,84 @@ export class CliInstallerService {
         logger.warn('Failed to get CLI version:', getErrorMessage(err));
       }
 
-      // Check auth status
-      try {
-        const { stdout: authStdout } = await execCli(binaryPath, ['auth', 'status'], {
-          timeout: VERSION_TIMEOUT_MS,
-          env: buildChildEnv(),
-        });
-        const auth = JSON.parse(authStdout.trim()) as { loggedIn?: boolean; authMethod?: string };
-        r.authLoggedIn = auth.loggedIn === true;
-        r.authMethod = auth.authMethod ?? null;
-        logger.info(`Auth status: loggedIn=${r.authLoggedIn}, method=${r.authMethod ?? 'null'}`);
-      } catch (err) {
-        logger.warn('Failed to check auth status:', getErrorMessage(err));
-        r.authLoggedIn = false;
-      }
+      // Auth and GCS version check are independent — run in parallel.
+      // Both mutate `r` directly so partial results survive the outer timeout.
+      await Promise.all([this.checkAuthStatus(binaryPath, r), this.fetchLatestVersion(r)]);
+    } else {
+      // No binary — still check latest version for "install" prompt
+      await this.fetchLatestVersion(r);
     }
+  }
 
+  /**
+   * Check auth status with retry — covers stale lock files after Ctrl+C interruption.
+   * Wrapped in its own timeout to prevent slow auth from blocking the overall status.
+   * Mutates `r` directly so results survive even if the outer Promise.all hasn't resolved.
+   */
+
+  private async checkAuthStatus(binaryPath: string, result: CliInstallationStatus): Promise<void> {
+    const doCheck = async (): Promise<void> => {
+      for (let authAttempt = 1; authAttempt <= AUTH_STATUS_MAX_RETRIES; authAttempt++) {
+        try {
+          const { stdout: authStdout } = await execCli(binaryPath, ['auth', 'status'], {
+            timeout: VERSION_TIMEOUT_MS,
+            env: buildChildEnv(),
+          });
+          const auth = JSON.parse(authStdout.trim()) as {
+            loggedIn?: boolean;
+            authMethod?: string;
+          };
+          result.authLoggedIn = auth.loggedIn === true; // eslint-disable-line no-param-reassign -- intentional mutation of shared result object
+          result.authMethod = auth.authMethod ?? null; // eslint-disable-line no-param-reassign -- intentional mutation of shared result object
+          logger.info(
+            `Auth status: loggedIn=${result.authLoggedIn}, method=${result.authMethod ?? 'null'}` +
+              (authAttempt > 1 ? ` (attempt ${authAttempt})` : '')
+          );
+          return;
+        } catch (err) {
+          if (authAttempt < AUTH_STATUS_MAX_RETRIES) {
+            logger.warn(
+              `Auth status check failed (attempt ${authAttempt}/${AUTH_STATUS_MAX_RETRIES}), ` +
+                `retrying in ${AUTH_STATUS_RETRY_DELAY_MS}ms: ${getErrorMessage(err)}`
+            );
+            await new Promise((resolve) => setTimeout(resolve, AUTH_STATUS_RETRY_DELAY_MS));
+          } else {
+            logger.warn(
+              `Auth status check failed after ${AUTH_STATUS_MAX_RETRIES} attempts: ${getErrorMessage(err)}`
+            );
+            result.authLoggedIn = false; // eslint-disable-line no-param-reassign -- intentional mutation of shared result object
+          }
+        }
+      }
+    };
+
+    // Own timeout so slow auth doesn't eat the overall getStatus budget
+    await Promise.race([
+      doCheck(),
+      new Promise<void>((resolve) =>
+        setTimeout(() => {
+          logger.warn(`Auth status check timed out after ${AUTH_TOTAL_TIMEOUT_MS}ms`);
+          resolve();
+        }, AUTH_TOTAL_TIMEOUT_MS)
+      ),
+    ]);
+  }
+
+  /**
+   * Fetch latest CLI version from GCS and update the result object.
+   */
+  private async fetchLatestVersion(result: CliInstallationStatus): Promise<void> {
     try {
       const latestRaw = await fetchText(`${GCS_BASE}/latest`);
-      r.latestVersion = normalizeVersion(latestRaw);
-      logger.info(`Latest CLI version: "${latestRaw.trim()}" → normalized: "${r.latestVersion}"`);
+      result.latestVersion = normalizeVersion(latestRaw); // eslint-disable-line no-param-reassign -- intentional mutation of shared result object
+      logger.info(
+        `Latest CLI version: "${latestRaw.trim()}" → normalized: "${result.latestVersion}"`
+      );
 
-      if (r.installedVersion && r.latestVersion) {
-        r.updateAvailable = isVersionOlder(r.installedVersion, r.latestVersion);
+      if (result.installedVersion && result.latestVersion) {
+        result.updateAvailable = isVersionOlder(result.installedVersion, result.latestVersion); // eslint-disable-line no-param-reassign -- intentional mutation of shared result object
         logger.info(
-          `Update available: ${r.updateAvailable} (${r.installedVersion} → ${r.latestVersion})`
+          `Update available: ${result.updateAvailable} (${result.installedVersion} → ${result.latestVersion})`
         );
       }
     } catch (err) {
diff --git a/src/main/services/infrastructure/ConfigManager.ts b/src/main/services/infrastructure/ConfigManager.ts
index 645213a9..0fb40631 100644
--- a/src/main/services/infrastructure/ConfigManager.ts
+++ b/src/main/services/infrastructure/ConfigManager.ts
@@ -40,6 +40,12 @@ export interface NotificationConfig {
   snoozeMinutes: number; // Default snooze duration
   /** Whether to include errors from subagent sessions */
   includeSubagentErrors: boolean;
+  /** Whether to show native OS notifications when teammates send messages to the team lead */
+  notifyOnLeadInbox: boolean;
+  /** Whether to show native OS notifications when teammates send messages to you (the user) */
+  notifyOnUserInbox: boolean;
+  /** Whether to show native OS notifications when a task needs user clarification */
+  notifyOnClarifications: boolean;
   /** Notification triggers - define when to generate notifications */
   triggers: NotificationTrigger[];
 }
@@ -184,6 +190,8 @@ export interface GeneralConfig {
   agentLanguage: string;
   autoExpandAIGroups: boolean;
   useNativeTitleBar: boolean;
+  /** Paths manually added via "Select Folder" that persist across app restarts */
+  customProjectPaths: string[];
 }
 
 export interface DisplayConfig {
@@ -243,6 +251,9 @@ const DEFAULT_CONFIG: AppConfig = {
     snoozedUntil: null,
     snoozeMinutes: 30,
     includeSubagentErrors: true,
+    notifyOnLeadInbox: false,
+    notifyOnUserInbox: true,
+    notifyOnClarifications: true,
     triggers: DEFAULT_TRIGGERS,
   },
   general: {
@@ -254,6 +265,7 @@ const DEFAULT_CONFIG: AppConfig = {
     agentLanguage: 'system',
     autoExpandAIGroups: false,
     useNativeTitleBar: false,
+    customProjectPaths: [],
   },
   display: {
     showTimestamps: true,
@@ -407,6 +419,7 @@ export class ConfigManager {
   private mergeWithDefaults(loaded: Partial<AppConfig>): AppConfig {
     const loadedNotifications = loaded.notifications ?? ({} as Partial<NotificationConfig>);
     const loadedTriggers = loadedNotifications.triggers ?? [];
+
     const mergedGeneral: GeneralConfig = {
       ...DEFAULT_CONFIG.general,
       ...(loaded.general ?? {}),
@@ -839,6 +852,58 @@ export class ConfigManager {
     this.saveConfig();
   }
 
+  // ===========================================================================
+  // Custom Project Path Management
+  // ===========================================================================
+
+  /**
+   * Adds a custom project path (from "Select Folder" dialog).
+   * Persisted across app restarts.
+   * @param projectPath - Absolute filesystem path to the project
+   */
+  addCustomProjectPath(projectPath: string): void {
+    if (!projectPath || projectPath.trim().length === 0) {
+      return;
+    }
+
+    const normalized = path.normalize(projectPath.trim());
+    if (!path.isAbsolute(normalized)) {
+      return;
+    }
+
+    if (this.config.general.customProjectPaths.includes(normalized)) {
+      return;
+    }
+
+    this.config.general.customProjectPaths.push(normalized);
+    this.saveConfig();
+    logger.info(`Custom project path added: ${normalized}`);
+  }
+
+  /**
+   * Removes a custom project path.
+   * @param projectPath - The path to remove
+   */
+  removeCustomProjectPath(projectPath: string): void {
+    const normalized = path.normalize(projectPath.trim());
+    const index = this.config.general.customProjectPaths.indexOf(normalized);
+    if (index === -1) {
+      return;
+    }
+
+    this.config.general.customProjectPaths.splice(index, 1);
+    this.saveConfig();
+    logger.info(`Custom project path removed: ${normalized}`);
+  }
+
+  /**
+   * Gets all custom project paths.
+   * @returns Array of absolute filesystem paths
+   */
+  getCustomProjectPaths(): string[] {
+    return [...this.config.general.customProjectPaths];
+  }
+
   // ===========================================================================
   // SSH Profile Management
   // ===========================================================================
diff --git a/src/main/services/infrastructure/NotificationManager.ts b/src/main/services/infrastructure/NotificationManager.ts
index b1f8a2bc..274df86a 100644
--- a/src/main/services/infrastructure/NotificationManager.ts
+++ b/src/main/services/infrastructure/NotificationManager.ts
@@ -12,6 +12,7 @@
  * - Emit IPC events to renderer: notification:new, notification:updated
  */
 
+import { getAppIconPath } from '@main/utils/appIcon';
 import { getHomeDir } from '@main/utils/pathDecoder';
 import { createLogger } from '@shared/utils/logger';
 import { type BrowserWindow, Notification } from 'electron';
@@ -394,11 +395,13 @@ export class NotificationManager extends EventEmitter {
 
     const config = this.configManager.getConfig();
 
+    const iconPath = getAppIconPath();
     const notification = new Notification({
       title: 'Claude Code Error',
       subtitle: error.context.projectName,
       body: error.message.slice(0, 200),
       sound: config.notifications.soundEnabled ? 'default' : undefined,
+      ...(iconPath ? { icon: iconPath } : {}),
     });
 
     notification.on('click', () => {
diff --git a/src/main/services/parsing/GitIdentityResolver.ts b/src/main/services/parsing/GitIdentityResolver.ts
index bed2c1f3..03043082 100644
--- a/src/main/services/parsing/GitIdentityResolver.ts
+++ b/src/main/services/parsing/GitIdentityResolver.ts
@@ -18,6 +18,7 @@
 import {
   AUTO_CLAUDE_DIR,
   CCSWITCH_DIR,
+  CLAUDE_CODE_DIR,
   CLAUDE_WORKTREES_DIR,
   CONDUCTOR_DIR,
   CURSOR_DIR,
@@ -242,6 +243,15 @@ class GitIdentityResolver {
       return parts[claudeWorktreesIdx + 1];
     }
 
+    // Pattern 6b: /.claude/worktrees/{name} (Claude Code CLI)
+    const claudeCodeDirIdx = parts.indexOf(CLAUDE_CODE_DIR);
+    if (claudeCodeDirIdx >= 0 && parts[claudeCodeDirIdx + 1] === WORKTREES_DIR) {
+      // Repo is the directory containing .claude
+      if (claudeCodeDirIdx > 0) {
+        return parts[claudeCodeDirIdx - 1];
+      }
+    }
+
     // Pattern 7: /.ccswitch/worktrees/{repo}/{name}
     const ccswitchIdx = parts.indexOf(CCSWITCH_DIR);
     if (ccswitchIdx >= 0 && parts[ccswitchIdx + 1] === WORKTREES_DIR) {
@@ -282,6 +292,11 @@ class GitIdentityResolver {
     if (parts.includes(CCSWITCH_DIR) && parts.includes(WORKTREES_DIR)) {
       return true;
     }
+    // Pattern: .claude/worktrees/{name} (Claude Code CLI worktrees)
+    const claudeCodeIdx = parts.indexOf(CLAUDE_CODE_DIR);
+    if (claudeCodeIdx >= 0 && parts[claudeCodeIdx + 1] === WORKTREES_DIR) {
+      return true;
+    }
     if (parts.includes(CONDUCTOR_DIR) && parts.includes(WORKSPACES_DIR)) {
       // Subpaths in conductor/workspaces are worktrees
       const conductorIdx = parts.indexOf(CONDUCTOR_DIR);
@@ -569,6 +584,15 @@ class GitIdentityResolver {
       return 'ccswitch';
     }
 
+    // Pattern: claude-code (Claude Code CLI)
+    // /Users/.../.claude/worktrees/{name}
+    {
+      const claudeCodeIdx = parts.indexOf(CLAUDE_CODE_DIR);
+      if (claudeCodeIdx >= 0 && parts[claudeCodeIdx + 1] === WORKTREES_DIR) {
+        return 'claude-code';
+      }
+    }
+
     // Check if it's a standard git repo (only if filesystem exists)
     // For deleted repos, we'll return 'git' as fallback since we can't verify
     if (await fileExists(path.join(projectPath, '.git'))) {
@@ -668,6 +692,19 @@ class GitIdentityResolver {
         break;
       }
 
+      case 'claude-code': {
+        // Pattern: .claude/worktrees/{name}
+        // Display: {name} (e.g., "editor-feature")
+        const claudeCodeDirIdx = parts.indexOf(CLAUDE_CODE_DIR);
+        if (claudeCodeDirIdx >= 0) {
+          const worktreesIdx = parts.indexOf(WORKTREES_DIR, claudeCodeDirIdx);
+          if (worktreesIdx >= 0 && parts[worktreesIdx + 1]) {
+            return parts[worktreesIdx + 1];
+          }
+        }
+        break;
+      }
+
       case 'git':
         // Standard git worktree - use branch or path-based name
         if (isMainWorktree) {
diff --git a/src/main/services/team/HunkSnippetMatcher.ts b/src/main/services/team/HunkSnippetMatcher.ts
index 5aa9d04c..173c964b 100644
--- a/src/main/services/team/HunkSnippetMatcher.ts
+++ b/src/main/services/team/HunkSnippetMatcher.ts
@@ -1,3 +1,4 @@
+import { computeDiffContextHash } from '@shared/utils/diffContextHash';
 import { structuredPatch } from 'diff';
 
 import type { SnippetDiff } from '@shared/types';
@@ -36,6 +37,7 @@ export class HunkSnippetMatcher {
       if (hunkIdx < 0 || hunkIdx >= patch.hunks.length) continue;
       const hunk = patch.hunks[hunkIdx];
       const snippetSet = new Set<number>();
+      const strongMatches = new Set<number>();
 
       // Reconstruct old/new side of hunk INCLUDING context lines.
       // Context lines (` ` prefix) are critical — without them, snippets whose
@@ -55,9 +57,18 @@ export class HunkSnippetMatcher {
         if (this.hasContentOverlap(snippet, oldSideContent, newSideContent)) {
           snippetSet.add(sIdx);
         }
+
+        // Strong match: contextHash matches the hunk's contextual fingerprint.
+        // This reduces false positives when repeated patterns exist in a file.
+        if (snippet.contextHash) {
+          const h = computeDiffContextHash(oldSideContent, newSideContent);
+          if (h === snippet.contextHash) {
+            strongMatches.add(sIdx);
+          }
+        }
       }
 
-      mapping.set(hunkIdx, snippetSet);
+      mapping.set(hunkIdx, strongMatches.size > 0 ? strongMatches : snippetSet);
     }
 
     return mapping;
@@ -134,17 +145,20 @@ export class HunkSnippetMatcher {
     if (!snippet.newString && !snippet.oldString) return false;
 
     if (snippet.type === 'write-new' || snippet.type === 'write-update') {
-      // For Write: snippet.newString is the full file content — check if hunk's new side is within it
-      if (snippet.newString && hunkNewSide) {
-        return snippet.newString.includes(hunkNewSide);
-      }
+      // Full-file writes are intentionally excluded from localized hunk↔snippet matching.
+      // They are handled by whole-file reject logic or hunk-level inverse patch.
       return false;
     }
 
     // For Edit/MultiEdit: check if snippet falls within hunk's file range
-    const matchesOld = snippet.oldString ? hunkOldSide.includes(snippet.oldString) : false;
-    const matchesNew = snippet.newString ? hunkNewSide.includes(snippet.newString) : false;
+    const hasOld = snippet.oldString.length > 0;
+    const hasNew = snippet.newString.length > 0;
+    const matchesOld = hasOld ? hunkOldSide.includes(snippet.oldString) : false;
+    const matchesNew = hasNew ? hunkNewSide.includes(snippet.newString) : false;
 
-    return matchesOld || matchesNew;
+    // Prefer stricter matching when both sides exist to avoid over-matching.
+    if (hasOld && hasNew) return matchesOld && matchesNew;
+    if (hasOld) return matchesOld;
+    return matchesNew;
   }
 }
diff --git a/src/main/services/team/ReviewApplierService.ts b/src/main/services/team/ReviewApplierService.ts
index 1b47be59..380fa0f2 100644
--- a/src/main/services/team/ReviewApplierService.ts
+++ b/src/main/services/team/ReviewApplierService.ts
@@ -1,6 +1,7 @@
+import { computeDiffContextHash } from '@shared/utils/diffContextHash';
 import { createLogger } from '@shared/utils/logger';
 import { applyPatch, structuredPatch } from 'diff';
-import { readFile, writeFile } from 'fs/promises';
+import { readFile, unlink, writeFile } from 'fs/promises';
 import { diff3Merge } from 'node-diff3';
 
 import { HunkSnippetMatcher } from './HunkSnippetMatcher';
@@ -247,6 +248,68 @@ export class ReviewApplierService {
       const original = fileContent.originalFullContent;
       const modified = fileContent.modifiedFullContent;
 
+      const rejectedHunkIndices = Object.entries(decision.hunkDecisions)
+        .filter(([, d]) => d === 'rejected')
+        .map(([idx]) => parseInt(idx, 10));
+
+      const allHunksRejected =
+        Object.keys(decision.hunkDecisions).length > 0 &&
+        Object.values(decision.hunkDecisions).every((d) => d === 'rejected');
+      const hasWriteNewSnippet = fileContent.snippets.some((s) => s.type === 'write-new');
+
+      // Special case: rejecting an entirely new file should remove it from disk.
+      // IMPORTANT: Do NOT delete on partial reject — users may want to keep parts of the new file.
+      const shouldDeleteNewFile =
+        fileContent.isNewFile &&
+        hasWriteNewSnippet &&
+        original === '' &&
+        (decision.fileDecision === 'rejected' || allHunksRejected);
+
+      if (shouldDeleteNewFile) {
+        // If we have an expected modified baseline, guard against deleting a user-modified file.
+        if (modified !== null) {
+          const conflict = await this.checkConflict(decision.filePath, modified);
+          if (conflict.hasConflict) {
+            conflicts++;
+            errors.push({
+              filePath: decision.filePath,
+              error:
+                'File was modified since review was computed; refusing to delete new file automatically.',
+            });
+            continue;
+          }
+        } else {
+          // No baseline — safest behavior is to only treat "already missing" as success.
+          try {
+            await readFile(decision.filePath, 'utf8');
+          } catch {
+            applied++;
+            continue;
+          }
+          errors.push({
+            filePath: decision.filePath,
+            error: 'Cannot delete new file: expected modified content is unavailable.',
+          });
+          continue;
+        }
+
+        try {
+          await unlink(decision.filePath);
+          applied++;
+        } catch (err) {
+          const msg = String(err);
+          if (msg.includes('ENOENT')) {
+            applied++;
+          } else {
+            errors.push({
+              filePath: decision.filePath,
+              error: `Failed to delete new file: ${msg}`,
+            });
+          }
+        }
+        continue;
+      }
+
       if (original === null || modified === null) {
         errors.push({
           filePath: decision.filePath,
@@ -275,21 +338,27 @@ export class ReviewApplierService {
           }
         } else {
           // Partial reject — only specific hunks
-          const rejectedHunkIndices = Object.entries(decision.hunkDecisions)
-            .filter(([, d]) => d === 'rejected')
-            .map(([idx]) => parseInt(idx, 10));
-
           if (rejectedHunkIndices.length === 0) {
             skipped++;
             continue;
           }
 
+          const mappedRejected =
+            decision.hunkContextHashes && Object.keys(decision.hunkContextHashes).length > 0
+              ? mapRejectedHunkIndicesByHash(
+                  original,
+                  modified,
+                  rejectedHunkIndices,
+                  decision.hunkContextHashes
+                )
+              : rejectedHunkIndices;
+
           const result = await this.rejectHunks(
             request.teamName,
             decision.filePath,
             original,
             modified,
-            rejectedHunkIndices,
+            mappedRejected,
             fileContent.snippets
           );
 
@@ -336,7 +405,12 @@ export class ReviewApplierService {
     hunkIndices: number[],
     snippets: SnippetDiff[]
   ): RejectResult | null {
-    const validSnippets = snippets.filter((s) => !s.isError);
+    // Safety: never use full-file Write snippets for snippet-level rejection.
+    // They are not localized, and matching a single hunk to a full-file write
+    // can incorrectly delete/overwrite large parts of the file.
+    const validSnippets = snippets.filter(
+      (s) => !s.isError && s.type !== 'write-new' && s.type !== 'write-update'
+    );
     if (validSnippets.length === 0) return null;
 
     // Pass pre-filtered snippets — matcher returns indices relative to this array
@@ -347,6 +421,15 @@ export class ReviewApplierService {
       validSnippets
     );
 
+    // Safety: if any requested hunk maps ambiguously, do NOT attempt snippet-level replacement.
+    // Fall back to hunk-level inverse patch which is positional and safer.
+    for (const hunkIdx of hunkIndices) {
+      const set = hunkToSnippets.get(hunkIdx);
+      if (set?.size !== 1) {
+        return null;
+      }
+    }
+
     // Collect all unique snippet indices to reject
     const snippetIndices = new Set<number>();
     for (const indices of hunkToSnippets.values()) {
@@ -450,6 +533,55 @@ export class ReviewApplierService {
   }
 }
 
+function buildHunkHashIndexMap(original: string, modified: string): Map<string, number[]> {
+  const patch = structuredPatch('file', 'file', original, modified);
+  const hunks = patch.hunks ?? [];
+  const map = new Map<string, number[]>();
+  for (let i = 0; i < hunks.length; i++) {
+    const hunk = hunks[i];
+    const oldSideContent = hunk.lines
+      .filter((l) => !l.startsWith('+'))
+      .map((l) => l.slice(1))
+      .join('\n');
+    const newSideContent = hunk.lines
+      .filter((l) => !l.startsWith('-'))
+      .map((l) => l.slice(1))
+      .join('\n');
+    const hash = computeDiffContextHash(oldSideContent, newSideContent);
+    const arr = map.get(hash);
+    if (arr) arr.push(i);
+    else map.set(hash, [i]);
+  }
+  return map;
+}
+
+function mapRejectedHunkIndicesByHash(
+  original: string,
+  modified: string,
+  rejectedIndices: number[],
+  hunkContextHashes: Record<number, string>
+): number[] {
+  const hashMap = buildHunkHashIndexMap(original, modified);
+  const out = new Set<number>();
+
+  for (const idx of rejectedIndices) {
+    const hash = hunkContextHashes[idx];
+    if (!hash) {
+      out.add(idx);
+      continue;
+    }
+    const candidates = hashMap.get(hash);
+    if (candidates?.length === 1) {
+      out.add(candidates[0]);
+    } else {
+      // Ambiguous or missing — fall back to index to preserve prior behavior.
+      out.add(idx);
+    }
+  }
+
+  return [...out].sort((a, b) => a - b);
+}
+
 // ── Module-level helpers ──
 
 /**
diff --git a/src/main/services/team/ReviewDecisionStore.ts b/src/main/services/team/ReviewDecisionStore.ts
index 6efcd708..83bb97c7 100644
--- a/src/main/services/team/ReviewDecisionStore.ts
+++ b/src/main/services/team/ReviewDecisionStore.ts
@@ -12,6 +12,8 @@ const logger = createLogger('ReviewDecisionStore');
 export interface ReviewDecisionsData {
   hunkDecisions: Record<string, HunkDecision>;
   fileDecisions: Record<string, HunkDecision>;
+  /** filePath -> (hunkIndex -> contextHash) */
+  hunkContextHashesByFile?: Record<string, Record<number, string>>;
   updatedAt: string;
 }
 
@@ -30,6 +32,7 @@ export class ReviewDecisionStore {
   ): Promise<{
     hunkDecisions: Record<string, HunkDecision>;
     fileDecisions: Record<string, HunkDecision>;
+    hunkContextHashesByFile?: Record<string, Record<number, string>>;
   } | null> {
     const filePath = this.getFilePath(teamName, scopeKey);
 
@@ -62,8 +65,12 @@ export class ReviewDecisionStore {
       data.hunkDecisions && typeof data.hunkDecisions === 'object' ? data.hunkDecisions : {};
     const fileDecisions: Record<string, HunkDecision> =
       data.fileDecisions && typeof data.fileDecisions === 'object' ? data.fileDecisions : {};
+    const hunkContextHashesByFile: Record<string, Record<number, string>> | undefined =
+      data.hunkContextHashesByFile && typeof data.hunkContextHashesByFile === 'object'
+        ? data.hunkContextHashesByFile
+        : undefined;
 
-    return { hunkDecisions, fileDecisions };
+    return { hunkDecisions, fileDecisions, hunkContextHashesByFile };
   }
 
   async save(
@@ -72,12 +79,14 @@ export class ReviewDecisionStore {
     data: {
       hunkDecisions: Record<string, HunkDecision>;
       fileDecisions: Record<string, HunkDecision>;
+      hunkContextHashesByFile?: Record<string, Record<number, string>>;
     }
   ): Promise<void> {
     try {
       const payload: ReviewDecisionsData = {
         hunkDecisions: data.hunkDecisions,
         fileDecisions: data.fileDecisions,
+        hunkContextHashesByFile: data.hunkContextHashesByFile,
         updatedAt: new Date().toISOString(),
       };
       await atomicWriteAsync(
diff --git a/src/main/services/team/TeamAgentToolsInstaller.ts b/src/main/services/team/TeamAgentToolsInstaller.ts
index 9f4e4975..5bc3ab57 100644
--- a/src/main/services/team/TeamAgentToolsInstaller.ts
+++ b/src/main/services/team/TeamAgentToolsInstaller.ts
@@ -9,7 +9,6 @@ import { version as APP_VERSION } from '../../../../package.json';
 import { atomicWriteAsync } from './atomicWrite';
 
 const TOOL_FILE_NAME = 'teamctl.js';
-const TOOL_VERSION = 11;
 
 function buildTeamCtlScript(version: string): string {
   const script = String.raw`#!/usr/bin/env node
@@ -196,10 +195,37 @@ function writeTask(taskPath, task) {
   return verify;
 }
 
+function applyWorkIntervalsForStatusTransition(task, prevStatus, nextStatus, now) {
+  var wasInProgress = prevStatus === 'in_progress';
+  var isInProgress = nextStatus === 'in_progress';
+  var intervals = Array.isArray(task.workIntervals) ? task.workIntervals.slice() : [];
+  var last = intervals.length ? intervals[intervals.length - 1] : null;
+
+  if (!wasInProgress && isInProgress) {
+    if (!last || typeof last.completedAt === 'string') {
+      intervals.push({ startedAt: now });
+    }
+  } else if (wasInProgress && !isInProgress) {
+    // Close the most recent open interval (if any).
+    for (var i = intervals.length - 1; i >= 0; i--) {
+      if (intervals[i] && typeof intervals[i].startedAt === 'string' && !intervals[i].completedAt) {
+        intervals[i].completedAt = now;
+        break;
+      }
+    }
+  }
+
+  if (intervals.length > 0) task.workIntervals = intervals;
+  else delete task.workIntervals;
+}
+
 function setTaskStatus(paths, taskId, status) {
   const normalized = normalizeStatus(status);
   if (!normalized) die('Invalid status: ' + String(status));
   const { taskPath, task } = readTask(paths, taskId);
+  var prev = task.status;
+  var now = nowIso();
+  applyWorkIntervalsForStatusTransition(task, prev, normalized, now);
   task.status = normalized;
   writeTask(taskPath, task);
 }
@@ -245,6 +271,7 @@ function addTaskComment(paths, taskId, flags) {
         id: commentId,
         author: from,
         text: text,
+        type: 'regular',
         createdAt: nowIso(),
       };
       task.comments = existing.concat([comment]);
@@ -306,6 +333,103 @@ function updateHighwatermark(paths, taskId) {
   atomicWrite(hwmPath, String(taskId));
 }
 
+function parseIdList(value) {
+  if (!value || value === true) return [];
+  var ids = String(value).split(',').map(function(s) { return s.trim(); }).filter(Boolean);
+  for (var k = 0; k < ids.length; k++) {
+    if (!/^\d+$/.test(ids[k])) die('Invalid task ID in list: ' + ids[k]);
+  }
+  return ids;
+}
+
+function taskExists(paths, taskId) {
+  try {
+    fs.accessSync(path.join(paths.tasksDir, String(taskId) + '.json'), fs.constants.F_OK);
+    return true;
+  } catch (e) { return false; }
+}
+
+function readTaskObject(paths, taskId) {
+  var taskPath = path.join(paths.tasksDir, String(taskId) + '.json');
+  var t = readJson(taskPath, null);
+  if (!t) die('Task not found: #' + taskId);
+  return { task: t, taskPath: taskPath };
+}
+
+function wouldCreateBlockCycle(paths, sourceId, targetId) {
+  var visited = {};
+  var stack = [String(targetId)];
+  while (stack.length > 0) {
+    var current = stack.pop();
+    if (current === String(sourceId)) return true;
+    if (visited[current]) continue;
+    visited[current] = true;
+    try {
+      var t = readJson(path.join(paths.tasksDir, current + '.json'), null);
+      if (t && Array.isArray(t.blockedBy)) {
+        for (var i = 0; i < t.blockedBy.length; i++) stack.push(String(t.blockedBy[i]));
+      }
+    } catch (e) { /* skip */ }
+  }
+  return false;
+}
+
+function linkTasks(paths, taskId, targetId, type) {
+  var id = String(taskId), target = String(targetId);
+  if (id === target) die('Cannot link a task to itself');
+  if (!taskExists(paths, id)) die('Task not found: #' + id);
+  if (!taskExists(paths, target)) die('Task not found: #' + target);
+
+  if (type === 'blocked-by') {
+    if (wouldCreateBlockCycle(paths, id, target))
+      die('Circular dependency: #' + target + ' already depends on #' + id);
+    var refA = readTaskObject(paths, id);
+    var bb = Array.isArray(refA.task.blockedBy) ? refA.task.blockedBy : [];
+    if (!bb.includes(target)) { refA.task.blockedBy = bb.concat([target]); atomicWrite(refA.taskPath, JSON.stringify(refA.task, null, 2)); }
+    var refB = readTaskObject(paths, target);
+    var bl = Array.isArray(refB.task.blocks) ? refB.task.blocks : [];
+    if (!bl.includes(id)) { refB.task.blocks = bl.concat([id]); atomicWrite(refB.taskPath, JSON.stringify(refB.task, null, 2)); }
+  } else if (type === 'blocks') {
+    linkTasks(paths, target, id, 'blocked-by');
+    return;
+  } else if (type === 'related') {
+    var rA = readTaskObject(paths, id);
+    var relA = Array.isArray(rA.task.related) ? rA.task.related : [];
+    if (!relA.includes(target)) { rA.task.related = relA.concat([target]); atomicWrite(rA.taskPath, JSON.stringify(rA.task, null, 2)); }
+    var rB = readTaskObject(paths, target);
+    var relB = Array.isArray(rB.task.related) ? rB.task.related : [];
+    if (!relB.includes(id)) { rB.task.related = relB.concat([id]); atomicWrite(rB.taskPath, JSON.stringify(rB.task, null, 2)); }
+  }
+}
+
+function unlinkTasks(paths, taskId, targetId, type) {
+  var id = String(taskId), target = String(targetId);
+  if (!taskExists(paths, id)) die('Task not found: #' + id);
+
+  if (type === 'blocked-by') {
+    var refA = readTaskObject(paths, id);
+    refA.task.blockedBy = (Array.isArray(refA.task.blockedBy) ? refA.task.blockedBy : []).filter(function(x) { return x !== target; });
+    atomicWrite(refA.taskPath, JSON.stringify(refA.task, null, 2));
+    if (taskExists(paths, target)) {
+      var refB = readTaskObject(paths, target);
+      refB.task.blocks = (Array.isArray(refB.task.blocks) ? refB.task.blocks : []).filter(function(x) { return x !== id; });
+      atomicWrite(refB.taskPath, JSON.stringify(refB.task, null, 2));
+    }
+  } else if (type === 'blocks') {
+    unlinkTasks(paths, target, id, 'blocked-by');
+    return;
+  } else if (type === 'related') {
+    var rA = readTaskObject(paths, id);
+    rA.task.related = (Array.isArray(rA.task.related) ? rA.task.related : []).filter(function(x) { return x !== target; });
+    atomicWrite(rA.taskPath, JSON.stringify(rA.task, null, 2));
+    if (taskExists(paths, target)) {
+      var rB = readTaskObject(paths, target);
+      rB.task.related = (Array.isArray(rB.task.related) ? rB.task.related : []).filter(function(x) { return x !== id; });
+      atomicWrite(rB.taskPath, JSON.stringify(rB.task, null, 2));
+    }
+  }
+}
+
 function createTask(paths, flags) {
   const subject = typeof flags.subject === 'string' ? flags.subject.trim() : '';
   if (!subject) die('Missing --subject');
@@ -317,7 +441,6 @@ function createTask(paths, flags) {
         : '';
   const owner = typeof flags.owner === 'string' && flags.owner.trim() ? flags.owner.trim() : undefined;
   const explicitStatus = typeof flags.status === 'string' ? flags.status : '';
-  const status = normalizeStatus(explicitStatus) || (owner ? 'in_progress' : 'pending');
   const activeForm =
     typeof flags.activeForm === 'string'
       ? flags.activeForm
@@ -325,6 +448,18 @@ function createTask(paths, flags) {
         ? flags['active-form']
         : undefined;
 
+  var blockedByIds = parseIdList(flags['blocked-by']);
+  var relatedIds = parseIdList(flags.related);
+  // Default status rule:
+  // - explicit --status always wins
+  // - tasks with dependencies should start as pending, even if assigned (owner)
+  // - otherwise, assigned tasks default to in_progress, unassigned to pending
+  const status =
+    normalizeStatus(explicitStatus) ||
+    (blockedByIds.length > 0 ? 'pending' : owner ? 'in_progress' : 'pending');
+  for (var v = 0; v < blockedByIds.length; v++) { if (!taskExists(paths, blockedByIds[v])) die('Blocked-by task not found: #' + blockedByIds[v]); }
+  for (var w = 0; w < relatedIds.length; w++) { if (!taskExists(paths, relatedIds[w])) die('Related task not found: #' + relatedIds[w]); }
+
   ensureDir(paths.tasksDir);
   const from = typeof flags.from === 'string' && flags.from.trim() ? flags.from.trim() : undefined;
   let nextId;
@@ -333,6 +468,7 @@ function createTask(paths, flags) {
   while (true) {
     nextId = getNextTaskId(paths);
     taskPath = path.join(paths.tasksDir, String(nextId) + '.json');
+    var createdAt = nowIso();
     task = {
       id: nextId,
       subject,
@@ -341,8 +477,11 @@ function createTask(paths, flags) {
       owner,
       createdBy: from,
       status,
+      createdAt: createdAt,
+      workIntervals: status === 'in_progress' ? [{ startedAt: createdAt }] : undefined,
       blocks: [],
-      blockedBy: [],
+      blockedBy: blockedByIds,
+      related: relatedIds.length > 0 ? relatedIds : undefined,
     };
     try {
       const fd = fs.openSync(taskPath, 'wx');
@@ -357,6 +496,20 @@ function createTask(paths, flags) {
     }
   }
   updateHighwatermark(paths, nextId);
+
+  // Set reverse links for blockedBy (target.blocks += nextId)
+  for (var bi = 0; bi < blockedByIds.length; bi++) {
+    var dep = readTaskObject(paths, blockedByIds[bi]);
+    var depBl = Array.isArray(dep.task.blocks) ? dep.task.blocks : [];
+    if (!depBl.includes(nextId)) { dep.task.blocks = depBl.concat([nextId]); atomicWrite(dep.taskPath, JSON.stringify(dep.task, null, 2)); }
+  }
+  // Set reverse links for related (bidirectional)
+  for (var ri = 0; ri < relatedIds.length; ri++) {
+    var rel = readTaskObject(paths, relatedIds[ri]);
+    var relL = Array.isArray(rel.task.related) ? rel.task.related : [];
+    if (!relL.includes(nextId)) { rel.task.related = relL.concat([nextId]); atomicWrite(rel.taskPath, JSON.stringify(rel.task, null, 2)); }
+  }
+
   return task;
 }
 
@@ -447,18 +600,32 @@ function sendInboxMessage(paths, teamName, flags) {
 
 function reviewApprove(paths, teamName, taskId, flags) {
   setKanbanColumn(paths, teamName, taskId, 'approved');
-  const notify = flags.notify === true || flags['notify-owner'] === true;
-  if (!notify) return;
-  const { task } = readTask(paths, taskId);
-  if (!task.owner) return;
+  const { taskPath, task } = readTask(paths, taskId);
   const from = typeof flags.from === 'string' && flags.from.trim() ? flags.from.trim() : inferLeadName(paths);
   const note = typeof flags.note === 'string' ? flags.note.trim() : '';
-  const text = note
+
+  // Record review comment in task.comments
+  var existing = Array.isArray(task.comments) ? task.comments : [];
+  var reviewCommentId = crypto.randomUUID
+    ? crypto.randomUUID()
+    : String(Date.now()) + '-' + String(Math.random());
+  task.comments = existing.concat([{
+    id: reviewCommentId,
+    author: from,
+    text: note || 'Approved',
+    type: 'review_approved',
+    createdAt: nowIso(),
+  }]);
+  writeTask(taskPath, task);
+
+  const notify = flags.notify === true || flags['notify-owner'] === true;
+  if (!notify || !task.owner) return;
+  const inboxText = note
     ? 'Task #' + String(taskId) + ' approved.\n\n' + note
     : 'Task #' + String(taskId) + ' approved.';
   sendInboxMessage(paths, teamName, {
     to: task.owner,
-    text,
+    text: inboxText,
     summary: 'Approved #' + String(taskId),
     from,
   });
@@ -469,12 +636,29 @@ function reviewRequestChanges(paths, teamName, taskId, flags) {
   const { taskPath, task } = readTask(paths, taskId);
   if (!task.owner) die('No owner found for task ' + String(taskId));
 
+  const from = typeof flags.from === 'string' && flags.from.trim() ? flags.from.trim() : inferLeadName(paths);
+
   clearKanban(paths, teamName, taskId);
+  var now = nowIso();
+  applyWorkIntervalsForStatusTransition(task, task.status, 'in_progress', now);
   task.status = 'in_progress';
+
+  // Record review comment in task.comments
+  var existing = Array.isArray(task.comments) ? task.comments : [];
+  var reviewCommentId = crypto.randomUUID
+    ? crypto.randomUUID()
+    : String(Date.now()) + '-' + String(Math.random());
+  task.comments = existing.concat([{
+    id: reviewCommentId,
+    author: from,
+    text: comment || 'Reviewer requested changes.',
+    type: 'review_request',
+    createdAt: now,
+  }]);
+
   writeTask(taskPath, task);
 
-  const from = typeof flags.from === 'string' && flags.from.trim() ? flags.from.trim() : inferLeadName(paths);
-  const text =
+  const inboxText =
     'Task #' +
     String(taskId) +
     ' needs fixes.\n\n' +
@@ -483,7 +667,7 @@ function reviewRequestChanges(paths, teamName, taskId, flags) {
     'Please fix and mark it as completed when ready.';
   sendInboxMessage(paths, teamName, {
     to: task.owner,
-    text,
+    text: inboxText,
     summary: 'Fix request for #' + String(taskId),
     from,
   });
@@ -639,6 +823,9 @@ function taskBriefing(paths, teamName, flags) {
     if (t.description && t.description !== t.subject) {
       parts.push('  Description: ' + t.description.slice(0, 500));
     }
+    if (t.blocks && t.blocks.length > 0) {
+      parts.push('  Blocks: ' + t.blocks.map(function(id) { return '#' + id; }).join(', '));
+    }
     if (t.blockedBy && t.blockedBy.length > 0) {
       parts.push('  Blocked by: ' + t.blockedBy.map(function(id) { return '#' + id; }).join(', '));
     }
@@ -704,7 +891,13 @@ function printHelp() {
       '  node teamctl.js task set-status <id> <pending|in_progress|completed|deleted> [--team <team>]',
       '  node teamctl.js task complete <id> [--team <team>]',
       '  node teamctl.js task start <id> [--team <team>]',
-      '  node teamctl.js task create --subject "..." [--description "..."] [--prompt "..."] [--owner "member"] [--status pending|in_progress|completed|deleted] [--notify --from "member"] [--team <team>]',
+      '  node teamctl.js task create --subject "..." [--description "..."] [--prompt "..."] [--owner "member"] [--blocked-by 2,3] [--related 5] [--status ...] [--notify --from "member"] [--team <team>]',
+      '  node teamctl.js task link <id> --blocked-by <targetId> [--team <team>]',
+      '  node teamctl.js task link <id> --blocks <targetId> [--team <team>]',
+      '  node teamctl.js task link <id> --related <targetId> [--team <team>]',
+      '  node teamctl.js task unlink <id> --blocked-by <targetId> [--team <team>]',
+      '  node teamctl.js task unlink <id> --blocks <targetId> [--team <team>]',
+      '  node teamctl.js task unlink <id> --related <targetId> [--team <team>]',
       '  node teamctl.js task set-owner <id> <member|clear> [--notify --from "member"] [--team <team>]',
       '  node teamctl.js task comment <id> --text "..." [--from "member"] [--team <team>]',
       '  node teamctl.js task set-clarification <id> <lead|user|clear> [--from "member"] [--team <team>]',
@@ -877,6 +1070,30 @@ async function main() {
       taskBriefing(paths, teamName, args.flags);
       return;
     }
+    if (action === 'link') {
+      var linkId = rest[0] || args.flags.id;
+      if (!linkId) die('Usage: task link <id> --blocked-by|--blocks|--related <targetId>');
+      var linkBbF = args.flags['blocked-by'], linkBlF = args.flags.blocks, linkRelF = args.flags.related;
+      var linkCnt = (linkBbF ? 1 : 0) + (linkBlF ? 1 : 0) + (linkRelF ? 1 : 0);
+      if (linkCnt !== 1) die('Specify exactly one: --blocked-by, --blocks, or --related');
+      var linkTp = linkBbF ? 'blocked-by' : linkBlF ? 'blocks' : 'related';
+      var linkTv = linkBbF || linkBlF || linkRelF;
+      linkTasks(paths, String(linkId), String(linkTv), linkTp);
+      process.stdout.write('OK task #' + linkId + ' ' + linkTp + ' #' + linkTv + '\n');
+      return;
+    }
+    if (action === 'unlink') {
+      var unlinkId = rest[0] || args.flags.id;
+      if (!unlinkId) die('Usage: task unlink <id> --blocked-by|--blocks|--related <targetId>');
+      var unlinkBbF = args.flags['blocked-by'], unlinkBlF = args.flags.blocks, unlinkRelF = args.flags.related;
+      var unlinkCnt = (unlinkBbF ? 1 : 0) + (unlinkBlF ? 1 : 0) + (unlinkRelF ? 1 : 0);
+      if (unlinkCnt !== 1) die('Specify exactly one: --blocked-by, --blocks, or --related');
+      var unlinkTp = unlinkBbF ? 'blocked-by' : unlinkBlF ? 'blocks' : 'related';
+      var unlinkTv = unlinkBbF || unlinkBlF || unlinkRelF;
+      unlinkTasks(paths, String(unlinkId), String(unlinkTv), unlinkTp);
+      process.stdout.write('OK task #' + unlinkId + ' unlinked ' + unlinkTp + ' #' + unlinkTv + '\n');
+      return;
+    }
     die('Unknown task action: ' + String(action));
   }
 
diff --git a/src/main/services/team/TeamConfigReader.ts b/src/main/services/team/TeamConfigReader.ts
index d16b776c..6a7c5314 100644
--- a/src/main/services/team/TeamConfigReader.ts
+++ b/src/main/services/team/TeamConfigReader.ts
@@ -146,14 +146,16 @@ export class TeamConfigReader {
             return null;
           }
 
+          // Case-insensitive dedup: key is lowercase name, value keeps the original casing
           const memberMap = new Map<string, TeamSummaryMember>();
 
-          const addMember = (m: TeamMember): void => {
+          const mergeMember = (m: TeamMember): void => {
             const name = m.name?.trim();
             if (!name) return;
-            const existing = memberMap.get(name);
-            memberMap.set(name, {
-              name,
+            const key = name.toLowerCase();
+            const existing = memberMap.get(key);
+            memberMap.set(key, {
+              name: existing?.name ?? name,
               role: m.role?.trim() || existing?.role,
               color: m.color?.trim() || existing?.color,
             });
@@ -162,11 +164,24 @@ export class TeamConfigReader {
           if (config && Array.isArray(config.members)) {
             for (const member of config.members) {
               if (member && typeof member.name === 'string') {
-                addMember(member);
+                mergeMember(member);
               }
             }
           }
 
+          // Also read members.meta.json — UI-created teams store members there,
+          // and CLI-created teams may have additional members added via the UI.
+          try {
+            const metaMembers = await this.membersMetaStore.getMembers(teamName);
+            for (const member of metaMembers) {
+              if (!member.removedAt) {
+                mergeMember(member);
+              }
+            }
+          } catch {
+            // best-effort — don't fail listing if meta file is broken
+          }
+
           const members = Array.from(memberMap.values());
           const summary: TeamSummary = {
             teamName,
diff --git a/src/main/services/team/TeamDataService.ts b/src/main/services/team/TeamDataService.ts
index 66f70a9a..3223aa54 100644
--- a/src/main/services/team/TeamDataService.ts
+++ b/src/main/services/team/TeamDataService.ts
@@ -783,6 +783,24 @@ export class TeamDataService {
     await this.taskWriter.setNeedsClarification(teamName, taskId, value);
   }
 
+  async addTaskRelationship(
+    teamName: string,
+    taskId: string,
+    targetId: string,
+    type: 'blockedBy' | 'blocks' | 'related'
+  ): Promise<void> {
+    await this.taskWriter.addRelationship(teamName, taskId, targetId, type);
+  }
+
+  async removeTaskRelationship(
+    teamName: string,
+    taskId: string,
+    targetId: string,
+    type: 'blockedBy' | 'blocks' | 'related'
+  ): Promise<void> {
+    await this.taskWriter.removeRelationship(teamName, taskId, targetId, type);
+  }
+
   async addTaskComment(teamName: string, taskId: string, text: string): Promise<TaskComment> {
     const comment = await this.taskWriter.addComment(teamName, taskId, text);
 
@@ -938,11 +956,15 @@ export class TeamDataService {
     await fs.promises.mkdir(tasksDir, { recursive: true });
 
     const joinedAt = Date.now();
-    const config = {
+    const config: Record<string, unknown> = {
       name: request.displayName?.trim() || request.teamName,
       description: request.description?.trim() || undefined,
       color: request.color?.trim() || undefined,
     };
+    if (request.cwd?.trim()) {
+      config.projectPath = request.cwd.trim();
+      config.projectPathHistory = [request.cwd.trim()];
+    }
 
     await atomicWriteAsync(configPath, JSON.stringify(config, null, 2));
     await this.membersMetaStore.writeMembers(
diff --git a/src/main/services/team/TeamMemberLogsFinder.ts b/src/main/services/team/TeamMemberLogsFinder.ts
index e9749189..6345664e 100644
--- a/src/main/services/team/TeamMemberLogsFinder.ts
+++ b/src/main/services/team/TeamMemberLogsFinder.ts
@@ -110,7 +110,12 @@ export class TeamMemberLogsFinder {
   async findLogsForTask(
     teamName: string,
     taskId: string,
-    options?: { owner?: string; status?: string }
+    options?: {
+      owner?: string;
+      status?: string;
+      intervals?: { startedAt: string; completedAt?: string }[];
+      since?: string;
+    }
   ): Promise<MemberLogSummary[]> {
     const discovery = await this.discoverProjectSessions(teamName);
     if (!discovery) return [];
@@ -171,6 +176,56 @@ export class TeamMemberLogsFinder {
       options.owner.trim().length > 0;
     if (includeOwnerSessions) {
       const ownerLogs = await this.findMemberLogs(teamName, options.owner!.trim());
+
+      const TASK_LOG_INTERVAL_GRACE_MS = 10_000;
+      const fallbackRecentMs = 30 * 60_000; // if caller doesn't supply intervals/since, avoid pulling in old owner history
+      const now = Date.now();
+
+      const normalizedIntervals = Array.isArray(options?.intervals)
+        ? options.intervals
+            .map((i) => {
+              const startMs = Date.parse(i.startedAt);
+              const endMsRaw =
+                typeof i.completedAt === 'string' ? Date.parse(i.completedAt) : Number.NaN;
+              const endMs = Number.isFinite(endMsRaw) ? endMsRaw : null;
+              return Number.isFinite(startMs) ? { startMs, endMs } : null;
+            })
+            .filter((v): v is { startMs: number; endMs: number | null } => v !== null)
+        : [];
+
+      // Back-compat: single since timestamp -> treat as open interval.
+      const sinceMsRaw = typeof options?.since === 'string' ? Date.parse(options.since) : NaN;
+      const sinceMs = Number.isFinite(sinceMsRaw) ? sinceMsRaw : null;
+      const effectiveIntervals =
+        normalizedIntervals.length > 0
+          ? normalizedIntervals
+          : sinceMs != null
+            ? [{ startMs: sinceMs, endMs: null }]
+            : [];
+
+      const overlapsAnyInterval = (logStartMs: number, logEndMs: number): boolean => {
+        for (const it of effectiveIntervals) {
+          const start = it.startMs - TASK_LOG_INTERVAL_GRACE_MS;
+          const end = (it.endMs ?? now) + TASK_LOG_INTERVAL_GRACE_MS;
+          if (logStartMs <= end && logEndMs >= start) return true;
+        }
+        return false;
+      };
+
+      const filteredOwnerLogs = ownerLogs.filter((log) => {
+        if (log.isOngoing) return true;
+        const startMs = new Date(log.startTime).getTime();
+        if (!Number.isFinite(startMs)) return false;
+        const durationMs =
+          typeof log.durationMs === 'number' && log.durationMs > 0 ? log.durationMs : 0;
+        const endMs = startMs + durationMs;
+
+        if (effectiveIntervals.length > 0) {
+          return overlapsAnyInterval(startMs, endMs);
+        }
+
+        return startMs >= now - fallbackRecentMs;
+      });
       const seen = new Set<string>();
       for (const log of results) {
         const key =
@@ -179,7 +234,7 @@ export class TeamMemberLogsFinder {
             : `lead:${log.sessionId}`;
         seen.add(key);
       }
-      for (const log of ownerLogs) {
+      for (const log of filteredOwnerLogs) {
         const key =
           log.kind === 'subagent'
             ? `subagent:${log.sessionId}:${log.subagentId}`
@@ -409,12 +464,17 @@ export class TeamMemberLogsFinder {
     const patterns: RegExp[] = [
       new RegExp(`"task_id"\\s*:\\s*"${escaped}"`, 'i'),
       new RegExp(`"taskId"\\s*:\\s*"${escaped}"`, 'i'),
-      new RegExp(`#${escaped}\\b`),
     ];
     if (numericTaskId) {
       patterns.push(
         new RegExp(`"task_id"\\s*:\\s*${numericTaskId}\\b`),
-        new RegExp(`"taskId"\\s*:\\s*${numericTaskId}\\b`)
+        new RegExp(`"taskId"\\s*:\\s*${numericTaskId}\\b`),
+        // Support teamctl command lines (may appear in tool output).
+        // Example: node ".../teamctl.js" --team "t" task start 10
+        new RegExp(
+          `\\bteamctl(?:\\.js)?\\b.{0,250}\\b(?:task|review)\\b.{0,250}\\b${numericTaskId}\\b`,
+          'i'
+        )
       );
     }
     try {
diff --git a/src/main/services/team/TeamProvisioningService.ts b/src/main/services/team/TeamProvisioningService.ts
index cce0adf6..27df5d34 100644
--- a/src/main/services/team/TeamProvisioningService.ts
+++ b/src/main/services/team/TeamProvisioningService.ts
@@ -59,6 +59,8 @@ const UI_LOGS_TAIL_LIMIT = 128 * 1024;
 const SHELL_ENV_TIMEOUT_MS = 12000;
 const CLI_PREPARE_TIMEOUT_MS = 10000;
 const PREFLIGHT_TIMEOUT_MS = 30000;
+const PREFLIGHT_AUTH_RETRY_DELAY_MS = 2000;
+const PREFLIGHT_AUTH_MAX_RETRIES = 2;
 const KEYCHAIN_TIMEOUT_MS = 5000;
 const FS_MONITOR_POLL_MS = 2000;
 const TASK_WAIT_FALLBACK_MS = 15_000;
@@ -144,6 +146,18 @@ interface ProvisioningRun {
   detectedSessionId: string | null;
   /** Lead process activity: 'active' during turn processing, 'idle' waiting for input, 'offline' after exit. */
   leadActivityState: LeadActivityState;
+  /** Whether an auth failure retry was already attempted for this run. */
+  authFailureRetried: boolean;
+  /** Set to true while auth-failure respawn is in progress to prevent duplicate handling. */
+  authRetryInProgress: boolean;
+  /** Saved spawn context for auth-failure respawn. */
+  spawnContext: {
+    claudePath: string;
+    args: string[];
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    prompt: string;
+  } | null;
 }
 
 type LeadActivityState = 'active' | 'idle' | 'offline';
@@ -336,6 +350,9 @@ function buildTaskStatusProtocol(teamName: string): string {
        If the lead replies via SendMessage instead, clear the flag yourself once you have the answer:
        node "$HOME/.claude/tools/teamctl.js" --team "${teamName}" task set-clarification <taskId> clear --from "<your-name>"
     d) Do NOT set clarification to "user" yourself — only the team lead escalates to the user.
+11. DEPENDENCY AWARENESS:
+    When your task has blockedBy dependencies, check if they are completed before starting.
+    When you complete a task that blocks others, mention this in your completion message so blocked teammates can proceed.
 Failure to follow this protocol means the task board will show incorrect status.`);
 }
 
@@ -358,11 +375,31 @@ function buildTeamCtlOpsInstructions(teamName: string, leadName: string): string
       `Internal task board tooling (teamctl.js):`,
       `- Use teamctl.js (via Bash) for tasks that must appear on the team board (assigned work, substantial work, or when the user explicitly asks to create a task).`,
       ``,
+      `Parallelization guideline (IMPORTANT):`,
+      `- If a task is genuinely parallelizable, split it into multiple smaller tasks owned by different members.`,
+      `  - Prefer splitting by independent deliverables (e.g. frontend/backend, API/UI, parsing/rendering, tests/docs) rather than arbitrary slices.`,
+      `  - Use --blocked-by only when one piece truly cannot start without another; otherwise link with --related.`,
+      `  - Do NOT split when work is inherently sequential, requires one person to keep consistent context, or the overhead would exceed the benefit.`,
+      `  - When splitting, make each task have a clear completion criterion and a single accountable owner.`,
+      ``,
       `Task board operations — use teamctl.js via Bash:`,
       `- Create task: node "$HOME/.claude/tools/teamctl.js" --team "${teamName}" task create --subject "..." --description "..." --owner "<actual-member-name>" --notify --from "${leadName}"`,
       `- Assign/reassign owner: node "$HOME/.claude/tools/teamctl.js" --team "${teamName}" task set-owner <id> <member-name> --notify --from "${leadName}"`,
       `- Clear owner: node "$HOME/.claude/tools/teamctl.js" --team "${teamName}" task set-owner <id> clear`,
       `- Update status: node "$HOME/.claude/tools/teamctl.js" --team "${teamName}" task set-status <id> <pending|in_progress|completed|deleted>`,
+      `- Create with deps (blocked work MUST be pending): node "$HOME/.claude/tools/teamctl.js" --team "${teamName}" task create --subject "..." --blocked-by 1,2 --related 3 --status pending --owner "<member>" --notify --from "${leadName}"`,
+      `- Link dependency: node "$HOME/.claude/tools/teamctl.js" --team "${teamName}" task link <id> --blocked-by <targetId>`,
+      `- Link related: node "$HOME/.claude/tools/teamctl.js" --team "${teamName}" task link <id> --related <targetId>`,
+      `- Unlink: node "$HOME/.claude/tools/teamctl.js" --team "${teamName}" task unlink <id> --blocked-by <targetId>`,
+      ``,
+      `Dependency guidelines:`,
+      `- Use --blocked-by when a task cannot start until another is done.`,
+      `- If you set --blocked-by, create the task in pending (use --status pending). Do NOT put blocked tasks into in_progress.`,
+      `- Use --related to link related work (e.g. frontend + backend) without blocking.`,
+      `- Review tasks: Prefer NOT creating a separate "review task". Reviews apply to the work task (#X) via: review approve/request-changes #X.`,
+      `  - If you must create a separate review reminder/assignment task, keep it pending and link it to #X with --related (and optionally --blocked-by #X if it truly cannot start yet).`,
+      `  - Dependencies do not auto-start tasks; the owner must explicitly start it when ready.`,
+      `- Avoid over-specifying. Only add dependencies when execution order matters.`,
       ``,
       `Notification policy:`,
       `- The --notify flag sends the assignment to the member automatically, so do NOT send a separate SendMessage for the same task.`,
@@ -431,7 +468,10 @@ function buildMemberTaskSnapshot(memberName: string, tasks: TeamTask[]): string
 
   const lines = activeTasks.map((t) => {
     const desc = t.description ? ` — ${t.description.slice(0, 120)}` : '';
-    return `  - #${t.id} [${t.status}] ${t.subject}${desc}`;
+    const deps = t.blockedBy?.length
+      ? ` [blocked by: ${t.blockedBy.map((id) => '#' + id).join(', ')}]`
+      : '';
+    return `  - #${t.id} [${t.status}] ${t.subject}${deps}${desc}`;
   });
   return `\nYour pending tasks from last session (RESUME these immediately):\n${lines.join('\n')}\n`;
 }
@@ -446,7 +486,10 @@ function buildTaskBoardSnapshot(tasks: TeamTask[]): string {
   const lines = active.map((t) => {
     const owner = t.owner ? ` (owner: ${t.owner})` : ' (unassigned)';
     const desc = t.description ? ` — ${t.description.slice(0, 120)}` : '';
-    return `  - #${t.id} [${t.status}]${owner} ${t.subject}${desc}`;
+    const deps = t.blockedBy?.length
+      ? ` [blocked by: ${t.blockedBy.map((id) => '#' + id).join(', ')}]`
+      : '';
+    return `  - #${t.id} [${t.status}]${owner} ${t.subject}${deps}${desc}`;
   });
   return `\nCurrent task board (pending/in_progress):\n${lines.join('\n')}\n`;
 }
@@ -521,6 +564,15 @@ ${processRegistration}
 3) If user instructions explicitly ask to create tasks OR describe substantial/assigned work that should be tracked — create tasks on the team board.
    - Prefer fewer, broader tasks over many micro-tasks.
    - Avoid duplicate notifications for the same assignment.
+   - When tasks have natural ordering (e.g. setup → implementation → testing), use --blocked-by.
+   - If a task is blocked (uses --blocked-by), it MUST be created as pending (use --status pending). Do NOT mark blocked tasks in_progress.
+     - Review guidance:
+       - Prefer NOT creating a separate "review task". Our workflow reviews the work task itself: run review approve/request-changes on the implementation task #X.
+       - If you MUST create a separate review reminder/assignment task, create it as pending and link it to the work task:
+         - Use --related to connect it to #X (non-blocking link).
+         - If the review truly cannot start until #X is done, ALSO add --blocked-by #X.
+       - There is no automatic status transition when dependencies resolve — the owner must explicitly start it (task start / set-status in_progress) when ready.
+   - Use --related to connect tasks working on the same feature without blocking.
 
 4) After all steps, output a short summary.
 
@@ -872,6 +924,231 @@ export class TeamProvisioningService {
     );
   }
 
+  /**
+   * Detects auth failure keywords in stderr/stdout during provisioning.
+   * On first detection: kills process, waits, and respawns automatically.
+   * On second detection (after retry): fails fast with a clear error.
+   */
+  private handleAuthFailureInOutput(run: ProvisioningRun, text: string, source: string): void {
+    if (run.provisioningComplete || run.processKilled || run.authRetryInProgress) return;
+    if (!this.isAuthFailureWarning(text)) return;
+
+    if (!run.authFailureRetried) {
+      logger.warn(
+        `[${run.teamName}] Auth failure detected in ${source} during provisioning — ` +
+          `will kill process and retry after ${PREFLIGHT_AUTH_RETRY_DELAY_MS}ms`
+      );
+      run.authRetryInProgress = true;
+      void this.respawnAfterAuthFailure(run);
+    } else {
+      logger.error(`[${run.teamName}] Auth failure detected in ${source} after retry — giving up`);
+      run.processKilled = true;
+      killProcessTree(run.child);
+      const progress = updateProgress(run, 'failed', 'Authentication failed — CLI requires login', {
+        error:
+          'Claude CLI is not authenticated. Run `claude` in a terminal to complete login, ' +
+          'or set ANTHROPIC_API_KEY / CLAUDE_CODE_OAUTH_TOKEN and try again.',
+        cliLogsTail: extractLogsTail(run.stdoutBuffer, run.stderrBuffer),
+      });
+      run.onProgress(progress);
+      this.cleanupRun(run);
+    }
+  }
+
+  /**
+   * Kills the current process, waits for lock release, and respawns with saved context.
+   * Reattaches all stream listeners and resends the prompt.
+   */
+  private async respawnAfterAuthFailure(run: ProvisioningRun): Promise<void> {
+    const ctx = run.spawnContext;
+    if (!ctx) {
+      logger.error(`[${run.teamName}] Cannot respawn — no spawn context saved`);
+      run.authRetryInProgress = false;
+      return;
+    }
+
+    // Tear down current process without full cleanupRun (keep run alive)
+    if (run.timeoutHandle) {
+      clearTimeout(run.timeoutHandle);
+      run.timeoutHandle = null;
+    }
+    this.stopFilesystemMonitor(run);
+    if (run.child) {
+      run.child.stdout?.removeAllListeners('data');
+      run.child.stderr?.removeAllListeners('data');
+      run.child.removeAllListeners('error');
+      run.child.removeAllListeners('exit');
+      killProcessTree(run.child);
+      run.child = null;
+    }
+
+    // Reset buffers for fresh attempt
+    run.stdoutBuffer = '';
+    run.stderrBuffer = '';
+    run.authFailureRetried = true;
+
+    updateProgress(run, 'spawning', 'Auth failed — retrying after short delay');
+    run.onProgress(run.progress);
+
+    await sleep(PREFLIGHT_AUTH_RETRY_DELAY_MS);
+
+    if (run.cancelRequested) {
+      run.authRetryInProgress = false;
+      return;
+    }
+
+    // Respawn
+    let child: ReturnType<typeof spawn>;
+    try {
+      child = spawnCli(ctx.claudePath, ctx.args, {
+        cwd: ctx.cwd,
+        env: { ...ctx.env },
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+    } catch (error) {
+      run.authRetryInProgress = false;
+      const progress = updateProgress(run, 'failed', 'Failed to respawn Claude CLI', {
+        error: error instanceof Error ? error.message : String(error),
+      });
+      run.onProgress(progress);
+      this.cleanupRun(run);
+      return;
+    }
+
+    logger.info(
+      `[${run.teamName}] Respawned CLI process after auth failure (pid=${child.pid ?? '?'})`
+    );
+    run.child = child;
+    run.authRetryInProgress = false;
+
+    updateProgress(run, 'spawning', 'CLI respawned — sending prompt', {
+      pid: child.pid ?? undefined,
+    });
+    run.onProgress(run.progress);
+
+    // Resend prompt
+    if (child.stdin?.writable) {
+      const message = JSON.stringify({
+        type: 'user',
+        message: {
+          role: 'user',
+          content: [{ type: 'text', text: ctx.prompt }],
+        },
+      });
+      child.stdin.write(message + '\n');
+    }
+
+    // Reattach stdout handler
+    this.attachStdoutHandler(run);
+
+    // Reattach stderr handler
+    this.attachStderrHandler(run);
+
+    // Restart filesystem monitor for createTeam (launch skips it)
+    if (!run.isLaunch) {
+      this.startFilesystemMonitor(run, run.request);
+    } else {
+      updateProgress(run, 'monitoring', 'CLI running — reconnecting with teammates');
+      run.onProgress(run.progress);
+    }
+
+    // Restart timeout
+    run.timeoutHandle = setTimeout(() => {
+      if (!run.processKilled && !run.provisioningComplete) {
+        run.processKilled = true;
+        run.finalizingByTimeout = true;
+        void (async () => {
+          const readyOnTimeout = await this.tryCompleteAfterTimeout(run);
+          run.child?.stdin?.end();
+          killProcessTree(run.child);
+          if (readyOnTimeout) return;
+
+          const hint = run.isLaunch ? ' (launch)' : '';
+          const progress = updateProgress(run, 'failed', `Timed out waiting for CLI${hint}`, {
+            error: `Timed out waiting for CLI${hint}.`,
+            cliLogsTail: extractLogsTail(run.stdoutBuffer, run.stderrBuffer),
+          });
+          run.onProgress(progress);
+          this.cleanupRun(run);
+        })();
+      }
+    }, RUN_TIMEOUT_MS);
+
+    child.once('error', (error) => {
+      const hint = run.isLaunch ? ' (launch)' : '';
+      const progress = updateProgress(run, 'failed', `Failed to start Claude CLI${hint}`, {
+        error: error.message,
+        cliLogsTail: extractLogsTail(run.stdoutBuffer, run.stderrBuffer),
+      });
+      run.onProgress(progress);
+      this.cleanupRun(run);
+    });
+
+    child.once('exit', (code) => {
+      void this.handleProcessExit(run, code);
+    });
+  }
+
+  /** Attaches the stdout stream-json parser to the current child process. */
+  private attachStdoutHandler(run: ProvisioningRun): void {
+    const child = run.child;
+    if (!child?.stdout) return;
+
+    let stdoutLineBuf = '';
+    child.stdout.on('data', (chunk: Buffer) => {
+      const text = chunk.toString('utf8');
+      run.stdoutBuffer += text;
+      if (run.stdoutBuffer.length > STDOUT_RING_LIMIT) {
+        run.stdoutBuffer = run.stdoutBuffer.slice(run.stdoutBuffer.length - STDOUT_RING_LIMIT);
+      }
+
+      // Parse stream-json lines (newline-delimited JSON)
+      stdoutLineBuf += text;
+      const lines = stdoutLineBuf.split('\n');
+      stdoutLineBuf = lines.pop() ?? '';
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed) continue;
+        try {
+          const msg = JSON.parse(trimmed) as Record<string, unknown>;
+          this.handleStreamJsonMessage(run, msg);
+        } catch {
+          // Not valid JSON — check for auth failure in raw text output
+          this.handleAuthFailureInOutput(run, trimmed, 'stdout');
+        }
+      }
+
+      const currentTs = Date.now();
+      if (currentTs - run.lastLogProgressAt >= LOG_PROGRESS_THROTTLE_MS) {
+        run.lastLogProgressAt = currentTs;
+        emitLogsProgress(run);
+      }
+    });
+  }
+
+  /** Attaches the stderr handler with auth failure detection. */
+  private attachStderrHandler(run: ProvisioningRun): void {
+    const child = run.child;
+    if (!child?.stderr) return;
+
+    child.stderr.on('data', (chunk: Buffer) => {
+      const text = chunk.toString('utf8');
+      run.stderrBuffer += text;
+      if (run.stderrBuffer.length > STDERR_RING_LIMIT) {
+        run.stderrBuffer = run.stderrBuffer.slice(run.stderrBuffer.length - STDERR_RING_LIMIT);
+      }
+
+      // Detect auth failure early instead of waiting for 5-minute timeout
+      this.handleAuthFailureInOutput(run, text, 'stderr');
+
+      const currentTs = Date.now();
+      if (currentTs - run.lastLogProgressAt >= LOG_PROGRESS_THROTTLE_MS) {
+        run.lastLogProgressAt = currentTs;
+        emitLogsProgress(run);
+      }
+    });
+  }
+
   async createTeam(
     request: TeamCreateRequest,
     onProgress: (progress: TeamProvisioningProgress) => void
@@ -924,6 +1201,9 @@ export class TeamProvisioningService {
       provisioningOutputParts: [],
       detectedSessionId: null,
       leadActivityState: 'active',
+      authFailureRetried: false,
+      authRetryInProgress: false,
+      spawnContext: null,
       progress: {
         runId,
         teamName: request.teamName,
@@ -948,30 +1228,25 @@ export class TeamProvisioningService {
           'Attempting spawn anyway — CLI may authenticate via apiKeyHelper, SSO, or other mechanism.'
       );
     }
+    const spawnArgs = [
+      '--input-format',
+      'stream-json',
+      '--output-format',
+      'stream-json',
+      '--verbose',
+      '--setting-sources',
+      'user,project,local',
+      '--disallowedTools',
+      'TeamDelete,TodoWrite',
+      '--dangerously-skip-permissions',
+      ...(request.model ? ['--model', request.model] : []),
+    ];
     try {
-      child = spawnCli(
-        claudePath,
-        [
-          '--input-format',
-          'stream-json',
-          '--output-format',
-          'stream-json',
-          '--verbose',
-          '--setting-sources',
-          'user,project,local',
-          '--disallowedTools',
-          'TeamDelete,TodoWrite',
-          '--dangerously-skip-permissions',
-          ...(request.model ? ['--model', request.model] : []),
-        ],
-        {
-          cwd: request.cwd,
-          env: {
-            ...shellEnv,
-          },
-          stdio: ['pipe', 'pipe', 'pipe'],
-        }
-      );
+      child = spawnCli(claudePath, spawnArgs, {
+        cwd: request.cwd,
+        env: { ...shellEnv },
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
     } catch (error) {
       this.runs.delete(runId);
       this.activeByTeam.delete(request.teamName);
@@ -981,6 +1256,13 @@ export class TeamProvisioningService {
     updateProgress(run, 'spawning', 'Starting Claude CLI process', { pid: child.pid ?? undefined });
     run.onProgress(run.progress);
     run.child = child;
+    run.spawnContext = {
+      claudePath,
+      args: spawnArgs,
+      cwd: request.cwd,
+      env: { ...shellEnv },
+      prompt,
+    };
 
     // Send provisioning prompt as first stream-json message (SDKUserMessage format)
     if (child.stdin?.writable) {
@@ -994,51 +1276,8 @@ export class TeamProvisioningService {
       child.stdin.write(message + '\n');
     }
 
-    if (child.stdout) {
-      let stdoutLineBuf = '';
-      child.stdout.on('data', (chunk: Buffer) => {
-        const text = chunk.toString('utf8');
-        run.stdoutBuffer += text;
-        if (run.stdoutBuffer.length > STDOUT_RING_LIMIT) {
-          run.stdoutBuffer = run.stdoutBuffer.slice(run.stdoutBuffer.length - STDOUT_RING_LIMIT);
-        }
-
-        // Parse stream-json lines (newline-delimited JSON)
-        stdoutLineBuf += text;
-        const lines = stdoutLineBuf.split('\n');
-        stdoutLineBuf = lines.pop() ?? '';
-        for (const line of lines) {
-          const trimmed = line.trim();
-          if (!trimmed) continue;
-          try {
-            const msg = JSON.parse(trimmed) as Record<string, unknown>;
-            this.handleStreamJsonMessage(run, msg);
-          } catch {
-            // Not valid JSON — raw text output, ignore
-          }
-        }
-
-        const currentTs = Date.now();
-        if (currentTs - run.lastLogProgressAt >= LOG_PROGRESS_THROTTLE_MS) {
-          run.lastLogProgressAt = currentTs;
-          emitLogsProgress(run);
-        }
-      });
-    }
-
-    if (child.stderr) {
-      child.stderr.on('data', (chunk: Buffer) => {
-        run.stderrBuffer += chunk.toString('utf8');
-        if (run.stderrBuffer.length > STDERR_RING_LIMIT) {
-          run.stderrBuffer = run.stderrBuffer.slice(run.stderrBuffer.length - STDERR_RING_LIMIT);
-        }
-        const currentTs = Date.now();
-        if (currentTs - run.lastLogProgressAt >= LOG_PROGRESS_THROTTLE_MS) {
-          run.lastLogProgressAt = currentTs;
-          emitLogsProgress(run);
-        }
-      });
-    }
+    this.attachStdoutHandler(run);
+    this.attachStderrHandler(run);
 
     // Filesystem-based progress monitor: actively polls team files instead
     // of relying on stdout (which only arrives at the end in text mode).
@@ -1126,23 +1365,35 @@ export class TeamProvisioningService {
           configParsed.leadSessionId.trim().length > 0
         ) {
           const candidateId = configParsed.leadSessionId.trim();
-          const projectPath =
+          const storedProjectPath =
             typeof configParsed.projectPath === 'string' &&
             configParsed.projectPath.trim().length > 0
               ? configParsed.projectPath.trim()
-              : request.cwd;
-          const projectId = encodePath(projectPath);
-          const baseDir = extractBaseDir(projectId);
-          const jsonlPath = path.join(getProjectsBasePath(), baseDir, `${candidateId}.jsonl`);
-          if (await this.pathExists(jsonlPath)) {
-            previousSessionId = candidateId;
+              : null;
+
+          // Sessions are stored per-project (~/.claude/projects/{encodePath(cwd)}/).
+          // If the project path changed, the old session JSONL won't be found by the CLI
+          // at the new project directory. Skip resume to avoid passing an invalid --resume arg.
+          if (storedProjectPath && path.resolve(storedProjectPath) !== path.resolve(request.cwd)) {
             logger.info(
-              `[${request.teamName}] Found previous session JSONL for resume: ${candidateId}`
+              `[${request.teamName}] Project path changed: ${storedProjectPath} → ${request.cwd}. ` +
+                `Skipping session resume — sessions are per-project.`
             );
           } else {
-            logger.info(
-              `[${request.teamName}] Previous session JSONL not found at ${jsonlPath}, starting fresh`
-            );
+            const resumeProjectPath = storedProjectPath ?? request.cwd;
+            const projectId = encodePath(resumeProjectPath);
+            const baseDir = extractBaseDir(projectId);
+            const jsonlPath = path.join(getProjectsBasePath(), baseDir, `${candidateId}.jsonl`);
+            if (await this.pathExists(jsonlPath)) {
+              previousSessionId = candidateId;
+              logger.info(
+                `[${request.teamName}] Found previous session JSONL for resume: ${candidateId}`
+              );
+            } else {
+              logger.info(
+                `[${request.teamName}] Previous session JSONL not found at ${jsonlPath}, starting fresh`
+              );
+            }
           }
         }
       } catch {
@@ -1156,6 +1407,11 @@ export class TeamProvisioningService {
     // Normalize config.json to keep only the team-lead before spawning the CLI, so we get stable names.
     await this.normalizeTeamConfigForLaunch(request.teamName, configRaw);
 
+    // Update projectPath in config IMMEDIATELY so TeamDetailView shows the correct path
+    // even if provisioning is interrupted or the user stops the team early.
+    // If launch fails, restorePrelaunchConfig() will revert to the backup (old projectPath).
+    await this.updateConfigProjectPath(request.teamName, request.cwd);
+
     let claudePath: string | null;
     try {
       await ensureCwdExists(request.cwd);
@@ -1207,6 +1463,9 @@ export class TeamProvisioningService {
       provisioningOutputParts: [],
       detectedSessionId: null,
       leadActivityState: 'active',
+      authFailureRetried: false,
+      authRetryInProgress: false,
+      spawnContext: null,
       progress: {
         runId,
         teamName: request.teamName,
@@ -1291,6 +1550,13 @@ export class TeamProvisioningService {
     });
     run.onProgress(run.progress);
     run.child = child;
+    run.spawnContext = {
+      claudePath,
+      args: launchArgs,
+      cwd: request.cwd,
+      env: { ...shellEnv },
+      prompt,
+    };
 
     // Send launch prompt
     if (child.stdin?.writable) {
@@ -1304,50 +1570,8 @@ export class TeamProvisioningService {
       child.stdin.write(message + '\n');
     }
 
-    if (child.stdout) {
-      let stdoutLineBuf = '';
-      child.stdout.on('data', (chunk: Buffer) => {
-        const text = chunk.toString('utf8');
-        run.stdoutBuffer += text;
-        if (run.stdoutBuffer.length > STDOUT_RING_LIMIT) {
-          run.stdoutBuffer = run.stdoutBuffer.slice(run.stdoutBuffer.length - STDOUT_RING_LIMIT);
-        }
-
-        stdoutLineBuf += text;
-        const lines = stdoutLineBuf.split('\n');
-        stdoutLineBuf = lines.pop() ?? '';
-        for (const line of lines) {
-          const trimmed = line.trim();
-          if (!trimmed) continue;
-          try {
-            const msg = JSON.parse(trimmed) as Record<string, unknown>;
-            this.handleStreamJsonMessage(run, msg);
-          } catch {
-            // Not valid JSON
-          }
-        }
-
-        const currentTs = Date.now();
-        if (currentTs - run.lastLogProgressAt >= LOG_PROGRESS_THROTTLE_MS) {
-          run.lastLogProgressAt = currentTs;
-          emitLogsProgress(run);
-        }
-      });
-    }
-
-    if (child.stderr) {
-      child.stderr.on('data', (chunk: Buffer) => {
-        run.stderrBuffer += chunk.toString('utf8');
-        if (run.stderrBuffer.length > STDERR_RING_LIMIT) {
-          run.stderrBuffer = run.stderrBuffer.slice(run.stderrBuffer.length - STDERR_RING_LIMIT);
-        }
-        const currentTs = Date.now();
-        if (currentTs - run.lastLogProgressAt >= LOG_PROGRESS_THROTTLE_MS) {
-          run.lastLogProgressAt = currentTs;
-          emitLogsProgress(run);
-        }
-      });
-    }
+    this.attachStdoutHandler(run);
+    this.attachStderrHandler(run);
 
     // For launch, skip the filesystem monitor — files (config, inboxes, tasks)
     // already exist from the previous run and would trigger immediate false
@@ -2217,6 +2441,13 @@ export class TeamProvisioningService {
     if (run.progress.state === 'failed' || run.cancelRequested) {
       return;
     }
+    // Skip if respawn after auth failure is in progress — the old process is being replaced
+    if (run.authRetryInProgress) {
+      logger.info(
+        `[${run.teamName}] Process exited (code ${code ?? '?'}) during auth-failure respawn — ignoring`
+      );
+      return;
+    }
 
     // === Process exited AFTER provisioning completed ===
     // This means the team went offline (crash, kill, or natural exit).
@@ -2610,6 +2841,35 @@ export class TeamProvisioningService {
     return token.length > 0 ? token : null;
   }
 
+  /**
+   * Immediately update projectPath in config.json at launch start, before CLI spawn.
+   * Ensures TeamDetailView shows the correct project path even if provisioning
+   * is interrupted. On failure, restorePrelaunchConfig() reverts to the backup.
+   */
+  private async updateConfigProjectPath(teamName: string, cwd: string): Promise<void> {
+    const configPath = path.join(getTeamsBasePath(), teamName, 'config.json');
+    try {
+      const raw = await fs.promises.readFile(configPath, 'utf8');
+      const config = JSON.parse(raw) as Record<string, unknown>;
+
+      config.projectPath = cwd;
+
+      const pathHistory = Array.isArray(config.projectPathHistory)
+        ? (config.projectPathHistory as string[]).filter((p) => typeof p === 'string' && p !== cwd)
+        : [];
+      pathHistory.push(cwd);
+      config.projectPathHistory = pathHistory.slice(-500);
+
+      await atomicWriteAsync(configPath, JSON.stringify(config, null, 2));
+      logger.info(`[${teamName}] Updated config.projectPath immediately: ${cwd}`);
+    } catch (error) {
+      // Non-fatal: updateConfigPostLaunch will update it later if provisioning succeeds.
+      logger.warn(
+        `[${teamName}] Failed to update projectPath early: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+
   /**
    * Single atomic read-mutate-write for post-launch config updates.
    * Combines session history append and projectPath update to avoid
@@ -3119,40 +3379,67 @@ export class TeamProvisioningService {
       throw new Error(`Failed to warm up Claude CLI: ${errorText}`);
     }
 
-    // Stage 2: verify `-p` mode auth actually works
-    let pingProbe: { exitCode: number | null; stdout: string; stderr: string } | null = null;
-    try {
-      pingProbe = await this.spawnProbe(
-        claudePath,
-        ['-p', 'Reply with the single word PONG and nothing else', '--output-format', 'text'],
-        cwd,
-        env,
-        PREFLIGHT_TIMEOUT_MS
-      );
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      return {
-        warning:
-          'Preflight check for `claude -p` did not complete. ' +
-          `Proceeding anyway. Details: ${message}`,
-      };
-    }
+    // Stage 2: verify `-p` mode auth actually works (with retry for stale locks after Ctrl+C)
+    for (let attempt = 1; attempt <= PREFLIGHT_AUTH_MAX_RETRIES; attempt++) {
+      let pingProbe: { exitCode: number | null; stdout: string; stderr: string } | null = null;
+      try {
+        pingProbe = await this.spawnProbe(
+          claudePath,
+          ['-p', 'Reply with the single word PONG and nothing else', '--output-format', 'text'],
+          cwd,
+          env,
+          PREFLIGHT_TIMEOUT_MS
+        );
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (attempt < PREFLIGHT_AUTH_MAX_RETRIES) {
+          logger.warn(
+            `Preflight ping failed (attempt ${attempt}/${PREFLIGHT_AUTH_MAX_RETRIES}), ` +
+              `retrying in ${PREFLIGHT_AUTH_RETRY_DELAY_MS}ms: ${message}`
+          );
+          await new Promise((resolve) => setTimeout(resolve, PREFLIGHT_AUTH_RETRY_DELAY_MS));
+          continue;
+        }
+        return {
+          warning:
+            'Preflight check for `claude -p` did not complete. ' +
+            `Proceeding anyway. Details: ${message}`,
+        };
+      }
 
-    const combinedOutput = buildCombinedLogs(pingProbe.stdout, pingProbe.stderr);
-    const lowerOutput = combinedOutput.toLowerCase();
-    const isAuthFailure =
-      lowerOutput.includes('not logged in') ||
-      lowerOutput.includes('please run /login') ||
-      lowerOutput.includes('missing api key') ||
-      lowerOutput.includes('invalid api key');
+      const combinedOutput = buildCombinedLogs(pingProbe.stdout, pingProbe.stderr);
+      const lowerOutput = combinedOutput.toLowerCase();
+      const isAuthFailure =
+        lowerOutput.includes('not logged in') ||
+        lowerOutput.includes('please run /login') ||
+        lowerOutput.includes('missing api key') ||
+        lowerOutput.includes('invalid api key');
 
-    if (isAuthFailure || pingProbe.exitCode !== 0) {
-      const hint = isAuthFailure
-        ? 'Claude CLI `-p` mode is not authenticated. ' +
-          'Set ANTHROPIC_API_KEY, or run `claude setup-token` to generate a long-lived OAuth token, ' +
-          'then export it as CLAUDE_CODE_OAUTH_TOKEN.'
-        : `Claude CLI preflight check failed (exit code ${pingProbe.exitCode ?? 'unknown'}).`;
-      return { warning: hint };
+      if (isAuthFailure && attempt < PREFLIGHT_AUTH_MAX_RETRIES) {
+        logger.warn(
+          `Preflight auth failure detected (attempt ${attempt}/${PREFLIGHT_AUTH_MAX_RETRIES}), ` +
+            `retrying in ${PREFLIGHT_AUTH_RETRY_DELAY_MS}ms — likely stale locks from interrupted process`
+        );
+        await new Promise((resolve) => setTimeout(resolve, PREFLIGHT_AUTH_RETRY_DELAY_MS));
+        continue;
+      }
+
+      if (isAuthFailure || pingProbe.exitCode !== 0) {
+        const hint = isAuthFailure
+          ? 'Claude CLI `-p` mode is not authenticated. ' +
+            'Set ANTHROPIC_API_KEY, or run `claude setup-token` to generate a long-lived OAuth token, ' +
+            'then export it as CLAUDE_CODE_OAUTH_TOKEN.' +
+            (attempt > 1 ? ` (failed after ${attempt} attempts)` : '')
+          : `Claude CLI preflight check failed (exit code ${pingProbe.exitCode ?? 'unknown'}).`;
+        return { warning: hint };
+      }
+
+      if (attempt > 1) {
+        logger.info(
+          `Preflight auth succeeded on attempt ${attempt} (previous attempt had auth failure)`
+        );
+      }
+      return {};
     }
 
     return {};
diff --git a/src/main/services/team/TeamTaskReader.ts b/src/main/services/team/TeamTaskReader.ts
index 96406b62..59166f54 100644
--- a/src/main/services/team/TeamTaskReader.ts
+++ b/src/main/services/team/TeamTaskReader.ts
@@ -3,7 +3,7 @@ import { createLogger } from '@shared/utils/logger';
 import * as fs from 'fs';
 import * as path from 'path';
 
-import type { TaskComment, TeamTask } from '@shared/types';
+import type { TaskComment, TaskWorkInterval, TeamTask } from '@shared/types';
 
 const logger = createLogger('Service:TeamTaskReader');
 
@@ -97,6 +97,21 @@ export class TeamTaskReader {
         // `satisfies Record<keyof TeamTask, unknown>` ensures compile-time
         // safety: if a field is added to TeamTask but not mapped here,
         // TypeScript will error. This prevents silently dropping new fields.
+        const workIntervals: TaskWorkInterval[] | undefined = Array.isArray(parsed.workIntervals)
+          ? (parsed.workIntervals as unknown[])
+              .filter(
+                (i): i is { startedAt: string; completedAt?: string } =>
+                  Boolean(i) &&
+                  typeof i === 'object' &&
+                  typeof (i as Record<string, unknown>).startedAt === 'string' &&
+                  ((i as Record<string, unknown>).completedAt === undefined ||
+                    typeof (i as Record<string, unknown>).completedAt === 'string')
+              )
+              .map((i) => ({
+                startedAt: i.startedAt,
+                completedAt: i.completedAt,
+              }))
+          : undefined;
         const task: TeamTask = {
           id:
             typeof parsed.id === 'string' || typeof parsed.id === 'number' ? String(parsed.id) : '',
@@ -110,6 +125,7 @@ export class TeamTaskReader {
           )
             ? (parsed.status as TeamTask['status'])
             : 'pending',
+          workIntervals,
           blocks: Array.isArray(parsed.blocks) ? (parsed.blocks as string[]) : undefined,
           blockedBy: Array.isArray(parsed.blockedBy) ? (parsed.blockedBy as string[]) : undefined,
           related: Array.isArray(parsed.related)
@@ -119,15 +135,22 @@ export class TeamTaskReader {
           updatedAt,
           projectPath: typeof parsed.projectPath === 'string' ? parsed.projectPath : undefined,
           comments: Array.isArray(parsed.comments)
-            ? (parsed.comments as TaskComment[]).filter(
-                (c) =>
-                  c &&
-                  typeof c === 'object' &&
-                  typeof c.id === 'string' &&
-                  typeof c.author === 'string' &&
-                  typeof c.text === 'string' &&
-                  typeof c.createdAt === 'string'
-              )
+            ? (parsed.comments as TaskComment[])
+                .filter(
+                  (c) =>
+                    c &&
+                    typeof c === 'object' &&
+                    typeof c.id === 'string' &&
+                    typeof c.author === 'string' &&
+                    typeof c.text === 'string' &&
+                    typeof c.createdAt === 'string'
+                )
+                .map((c) => ({
+                  ...c,
+                  type: (['regular', 'review_request', 'review_approved'] as const).includes(c.type)
+                    ? c.type
+                    : ('regular' as const),
+                }))
             : undefined,
           needsClarification: (['lead', 'user'] as const).includes(
             parsed.needsClarification as 'lead' | 'user'
diff --git a/src/main/services/team/TeamTaskWriter.ts b/src/main/services/team/TeamTaskWriter.ts
index 94e9b9ba..8dee48d6 100644
--- a/src/main/services/team/TeamTaskWriter.ts
+++ b/src/main/services/team/TeamTaskWriter.ts
@@ -5,7 +5,7 @@ import * as path from 'path';
 
 import { atomicWriteAsync } from './atomicWrite';
 
-import type { TaskComment, TeamTask, TeamTaskStatus } from '@shared/types';
+import type { TaskComment, TaskCommentType, TeamTask, TeamTaskStatus } from '@shared/types';
 
 const taskWriteLocks = new Map<string, Promise<void>>();
 
@@ -46,13 +46,23 @@ export class TeamTaskWriter {
 
       // Ensure CLI-compatible format: description, blocks, blockedBy are required
       // by Claude Code CLI's Zod schema validation (safeParse fails without them)
+      const createdAt = task.createdAt ?? new Date().toISOString();
       const cliCompatibleTask: TeamTask = {
         ...task,
         description: task.description ?? '',
         blocks: task.blocks ?? [],
         blockedBy: task.blockedBy ?? [],
         related: task.related ?? [],
-        createdAt: task.createdAt ?? new Date().toISOString(),
+        createdAt,
+        workIntervals:
+          task.status === 'in_progress'
+            ? // Start the first work interval on creation when task starts immediately.
+              [
+                ...(Array.isArray(task.workIntervals) && task.workIntervals.length > 0
+                  ? task.workIntervals
+                  : [{ startedAt: createdAt }]),
+              ]
+            : task.workIntervals,
       };
 
       await atomicWriteAsync(taskPath, JSON.stringify(cliCompatibleTask, null, 2));
@@ -92,6 +102,176 @@ export class TeamTaskWriter {
     });
   }
 
+  async addRelationship(
+    teamName: string,
+    taskId: string,
+    targetId: string,
+    type: 'blockedBy' | 'blocks' | 'related'
+  ): Promise<void> {
+    if (taskId === targetId) {
+      throw new Error('Cannot link a task to itself');
+    }
+
+    // For 'blocks', delegate as reverse blockedBy (swap task/target intentionally)
+    if (type === 'blocks') {
+      const swappedTask = targetId;
+      const swappedTarget = taskId;
+      return this.addRelationship(teamName, swappedTask, swappedTarget, 'blockedBy');
+    }
+
+    const tasksDir = path.join(getTasksBasePath(), teamName);
+    const taskPath = path.join(tasksDir, `${taskId}.json`);
+    const targetPath = path.join(tasksDir, `${targetId}.json`);
+
+    // Lock both paths in sorted order to avoid deadlocks
+    const [firstPath, secondPath] =
+      taskPath < targetPath ? [taskPath, targetPath] : [targetPath, taskPath];
+
+    await withTaskLock(firstPath, () =>
+      withTaskLock(secondPath, async () => {
+        // Read both tasks
+        const taskRaw = await this.readTaskFile(taskPath, taskId);
+        const targetRaw = await this.readTaskFile(targetPath, targetId);
+        const task = JSON.parse(taskRaw) as TeamTask;
+        const target = JSON.parse(targetRaw) as TeamTask;
+
+        if (type === 'blockedBy') {
+          // Cycle detection: walk target's blockedBy chain to check if taskId is reachable
+          await this.checkBlockCycle(tasksDir, taskId, targetId);
+
+          // task.blockedBy += targetId
+          const blockedBy = task.blockedBy ?? [];
+          if (!blockedBy.includes(targetId)) {
+            task.blockedBy = [...blockedBy, targetId];
+            await atomicWriteAsync(taskPath, JSON.stringify(task, null, 2));
+          }
+          // target.blocks += taskId (reverse)
+          const blocks = target.blocks ?? [];
+          if (!blocks.includes(taskId)) {
+            target.blocks = [...blocks, taskId];
+            await atomicWriteAsync(targetPath, JSON.stringify(target, null, 2));
+          }
+        } else {
+          // related — bidirectional
+          const relA = task.related ?? [];
+          if (!relA.includes(targetId)) {
+            task.related = [...relA, targetId];
+            await atomicWriteAsync(taskPath, JSON.stringify(task, null, 2));
+          }
+          const relB = target.related ?? [];
+          if (!relB.includes(taskId)) {
+            target.related = [...relB, taskId];
+            await atomicWriteAsync(targetPath, JSON.stringify(target, null, 2));
+          }
+        }
+      })
+    );
+  }
+
+  async removeRelationship(
+    teamName: string,
+    taskId: string,
+    targetId: string,
+    type: 'blockedBy' | 'blocks' | 'related'
+  ): Promise<void> {
+    // For 'blocks', delegate as reverse blockedBy (swap task/target intentionally)
+    if (type === 'blocks') {
+      const swappedTask = targetId;
+      const swappedTarget = taskId;
+      return this.removeRelationship(teamName, swappedTask, swappedTarget, 'blockedBy');
+    }
+
+    const tasksDir = path.join(getTasksBasePath(), teamName);
+    const taskPath = path.join(tasksDir, `${taskId}.json`);
+    const targetPath = path.join(tasksDir, `${targetId}.json`);
+
+    const [firstPath, secondPath] =
+      taskPath < targetPath ? [taskPath, targetPath] : [targetPath, taskPath];
+
+    await withTaskLock(firstPath, () =>
+      withTaskLock(secondPath, async () => {
+        // Read task (must exist)
+        const taskRaw = await this.readTaskFile(taskPath, taskId);
+        const task = JSON.parse(taskRaw) as TeamTask;
+
+        if (type === 'blockedBy') {
+          task.blockedBy = (task.blockedBy ?? []).filter((id) => id !== targetId);
+          await atomicWriteAsync(taskPath, JSON.stringify(task, null, 2));
+
+          // Remove reverse from target if it exists
+          try {
+            const targetRaw = await fs.promises.readFile(targetPath, 'utf8');
+            const target = JSON.parse(targetRaw) as TeamTask;
+            target.blocks = (target.blocks ?? []).filter((id) => id !== taskId);
+            await atomicWriteAsync(targetPath, JSON.stringify(target, null, 2));
+          } catch (error) {
+            if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
+            // Target doesn't exist — skip silently
+          }
+        } else {
+          // related — remove bidirectional
+          task.related = (task.related ?? []).filter((id) => id !== targetId);
+          await atomicWriteAsync(taskPath, JSON.stringify(task, null, 2));
+
+          try {
+            const targetRaw = await fs.promises.readFile(targetPath, 'utf8');
+            const target = JSON.parse(targetRaw) as TeamTask;
+            target.related = (target.related ?? []).filter((id) => id !== taskId);
+            await atomicWriteAsync(targetPath, JSON.stringify(target, null, 2));
+          } catch (error) {
+            if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
+          }
+        }
+      })
+    );
+  }
+
+  private async readTaskFile(taskPath: string, taskId: string): Promise<string> {
+    try {
+      return await fs.promises.readFile(taskPath, 'utf8');
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
+        throw new Error(`Task not found: ${taskId}`);
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Walks targetId's blockedBy chain to detect if sourceId is reachable.
+   * Reads are outside locks (deliberate TOCTOU trade-off — the calling method
+   * holds locks on both source and target, and only other tasks are read here).
+   */
+  private async checkBlockCycle(
+    tasksDir: string,
+    sourceId: string,
+    targetId: string
+  ): Promise<void> {
+    const visited = new Set<string>();
+    const stack = [targetId];
+
+    while (stack.length > 0) {
+      const current = stack.pop()!;
+      if (current === sourceId) {
+        throw new Error(`Circular dependency: #${targetId} already depends on #${sourceId}`);
+      }
+      if (visited.has(current)) continue;
+      visited.add(current);
+
+      try {
+        const raw = await fs.promises.readFile(path.join(tasksDir, `${current}.json`), 'utf8');
+        const task = JSON.parse(raw) as TeamTask;
+        if (Array.isArray(task.blockedBy)) {
+          for (const dep of task.blockedBy) {
+            stack.push(dep);
+          }
+        }
+      } catch {
+        // Skip unreadable tasks
+      }
+    }
+  }
+
   async updateStatus(teamName: string, taskId: string, status: TeamTaskStatus): Promise<void> {
     const taskPath = path.join(getTasksBasePath(), teamName, `${taskId}.json`);
 
@@ -107,6 +287,29 @@ export class TeamTaskWriter {
       }
 
       const task = JSON.parse(raw) as TeamTask;
+      const prevStatus = task.status;
+      const nowIso = new Date().toISOString();
+
+      // Maintain workIntervals as periods of time where status === 'in_progress'.
+      const intervals = Array.isArray(task.workIntervals) ? [...task.workIntervals] : [];
+      const last = intervals.length > 0 ? intervals[intervals.length - 1] : undefined;
+
+      const wasInProgress = prevStatus === 'in_progress';
+      const isInProgress = status === 'in_progress';
+
+      if (!wasInProgress && isInProgress) {
+        // Entering in_progress: open a new interval if none is open.
+        if (!last || typeof last.completedAt === 'string') {
+          intervals.push({ startedAt: nowIso });
+        }
+      } else if (wasInProgress && !isInProgress) {
+        // Leaving in_progress: close open interval if present.
+        if (last && last.completedAt === undefined) {
+          last.completedAt = nowIso;
+        }
+      }
+
+      task.workIntervals = intervals.length > 0 ? intervals : undefined;
       task.status = status;
       await atomicWriteAsync(taskPath, JSON.stringify(task, null, 2));
 
@@ -157,8 +360,20 @@ export class TeamTaskWriter {
       }
 
       const task = JSON.parse(raw) as TeamTask;
+      const nowIso = new Date().toISOString();
+
+      // Ensure any open in_progress interval is closed on delete.
+      if (task.status === 'in_progress') {
+        const intervals = Array.isArray(task.workIntervals) ? [...task.workIntervals] : [];
+        const last = intervals.length > 0 ? intervals[intervals.length - 1] : undefined;
+        if (last && last.completedAt === undefined) {
+          last.completedAt = nowIso;
+        }
+        task.workIntervals = intervals.length > 0 ? intervals : task.workIntervals;
+      }
+
       task.status = 'deleted';
-      task.deletedAt = new Date().toISOString();
+      task.deletedAt = nowIso;
       await atomicWriteAsync(taskPath, JSON.stringify(task, null, 2));
 
       const verifyRaw = await fs.promises.readFile(taskPath, 'utf8');
@@ -251,7 +466,7 @@ export class TeamTaskWriter {
     teamName: string,
     taskId: string,
     text: string,
-    options?: { id?: string; author?: string; createdAt?: string }
+    options?: { id?: string; author?: string; createdAt?: string; type?: TaskCommentType }
   ): Promise<TaskComment> {
     const taskPath = path.join(getTasksBasePath(), teamName, `${taskId}.json`);
     const comment: TaskComment = {
@@ -259,6 +474,7 @@ export class TeamTaskWriter {
       author: options?.author ?? 'user',
       text,
       createdAt: options?.createdAt ?? new Date().toISOString(),
+      type: options?.type ?? 'regular',
     };
 
     await withTaskLock(taskPath, async () => {
diff --git a/src/main/types/domain.ts b/src/main/types/domain.ts
index 9b1abde8..6f7342b7 100644
--- a/src/main/types/domain.ts
+++ b/src/main/types/domain.ts
@@ -147,6 +147,7 @@ export type WorktreeSource =
   | 'auto-claude' // /Users/.../.auto-claude/worktrees/tasks/{task-id}
   | '21st' // /Users/.../.21st/worktrees/{id}/{name [bracket-id]}
   | 'claude-desktop' // /Users/.../.claude-worktrees/{repo}/{name}
+  | 'claude-code' // /Users/.../.claude/worktrees/{name}
   | 'ccswitch' // /Users/.../.ccswitch/worktrees/{repo}/{name}
   | 'git' // Standard git worktree (main repo or detached)
   | 'unknown'; // Non-git project or undetectable
diff --git a/src/main/utils/appIcon.ts b/src/main/utils/appIcon.ts
new file mode 100644
index 00000000..9d5117a3
--- /dev/null
+++ b/src/main/utils/appIcon.ts
@@ -0,0 +1,38 @@
+/**
+ * Resolves the application icon path for native notifications and windows.
+ *
+ * On macOS the signed bundle provides the icon automatically,
+ * so this is primarily needed for Windows and Linux.
+ */
+
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+let cachedPath: string | undefined;
+let resolved = false;
+
+/**
+ * Returns the absolute path to the app icon (PNG), or undefined if not found.
+ * Result is cached after the first call.
+ */
+export function getAppIconPath(): string | undefined {
+  if (resolved) return cachedPath;
+
+  const isDev = process.env.NODE_ENV === 'development';
+  const candidates = isDev
+    ? [join(process.cwd(), 'resources/icon.png')]
+    : [
+        join(process.resourcesPath, 'resources/icon.png'),
+        join(__dirname, '../../resources/icon.png'),
+      ];
+
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      cachedPath = candidate;
+      break;
+    }
+  }
+
+  resolved = true;
+  return cachedPath;
+}
diff --git a/src/main/utils/pathValidation.ts b/src/main/utils/pathValidation.ts
index 223be737..63e50334 100644
--- a/src/main/utils/pathValidation.ts
+++ b/src/main/utils/pathValidation.ts
@@ -3,6 +3,9 @@
  *
  * Provides security sandboxing for file path access to prevent
  * unauthorized access to sensitive system files.
+ *
+ * Cross-platform: uses path.resolve() for consistent drive-letter
+ * handling on Windows (normalizeForCompare, isPathWithinRoot).
  */
 
 import * as fs from 'fs';
@@ -62,12 +65,14 @@ export interface PathValidationResult {
 }
 
 function normalizeForCompare(input: string, isWindows: boolean): string {
-  const normalized = path.normalize(input);
+  const normalized = path.resolve(path.normalize(input));
   return isWindows ? normalized.toLowerCase() : normalized;
 }
 
 export function isPathWithinRoot(targetPath: string, rootPath: string): boolean {
-  return targetPath === rootPath || targetPath.startsWith(rootPath + path.sep);
+  const target = path.resolve(targetPath);
+  const root = path.resolve(rootPath);
+  return target === root || target.startsWith(root + path.sep);
 }
 
 function resolveRealPathIfExists(inputPath: string): string | null {
diff --git a/src/preload/constants/ipcChannels.ts b/src/preload/constants/ipcChannels.ts
index 550a7038..a24a6284 100644
--- a/src/preload/constants/ipcChannels.ts
+++ b/src/preload/constants/ipcChannels.ts
@@ -62,6 +62,12 @@ export const CONFIG_FIND_WSL_CLAUDE_ROOTS = 'config:findWslClaudeRoots';
 /** Open config file in external editor */
 export const CONFIG_OPEN_IN_EDITOR = 'config:openInEditor';
 
+/** Add a custom project path (Select Folder persistence) */
+export const CONFIG_ADD_CUSTOM_PROJECT_PATH = 'config:addCustomProjectPath';
+
+/** Remove a custom project path */
+export const CONFIG_REMOVE_CUSTOM_PROJECT_PATH = 'config:removeCustomProjectPath';
+
 /** Pin a session */
 export const CONFIG_PIN_SESSION = 'config:pinSession';
 
@@ -315,6 +321,12 @@ export const TEAM_SET_TASK_CLARIFICATION = 'team:setTaskClarification';
 /** Show native OS notification for a team message */
 export const TEAM_SHOW_MESSAGE_NOTIFICATION = 'team:showMessageNotification';
 
+/** Add a relationship (blockedBy/blocks/related) between two tasks */
+export const TEAM_ADD_TASK_RELATIONSHIP = 'team:addTaskRelationship';
+
+/** Remove a relationship (blockedBy/blocks/related) between two tasks */
+export const TEAM_REMOVE_TASK_RELATIONSHIP = 'team:removeTaskRelationship';
+
 // =============================================================================
 // CLI Installer API Channels
 // =============================================================================
@@ -431,6 +443,9 @@ export const EDITOR_DELETE_FILE = 'editor:deleteFile';
 /** Move file or directory to a new location */
 export const EDITOR_MOVE_FILE = 'editor:moveFile';
 
+/** Rename file or directory in place */
+export const EDITOR_RENAME_FILE = 'editor:renameFile';
+
 /** Search in files (literal string search) */
 export const EDITOR_SEARCH_IN_FILES = 'editor:searchInFiles';
 
@@ -443,5 +458,17 @@ export const EDITOR_GIT_STATUS = 'editor:gitStatus';
 /** Enable/disable file watcher for current project */
 export const EDITOR_WATCH_DIR = 'editor:watchDir';
 
+/** Update list of watched file paths (open tabs) */
+export const EDITOR_SET_WATCHED_FILES = 'editor:setWatchedFiles';
+
+/** Update list of watched directories (shallow: depth=0) */
+export const EDITOR_SET_WATCHED_DIRS = 'editor:setWatchedDirs';
+
+/** Read binary file as base64 for inline preview */
+export const EDITOR_READ_BINARY_PREVIEW = 'editor:readBinaryPreview';
+
 /** File change event from watcher (main -> renderer) */
 export const EDITOR_CHANGE = 'editor:change';
+
+/** List project files by path (for @file mentions, independent of editor state) */
+export const PROJECT_LIST_FILES = 'project:listFiles';
diff --git a/src/preload/index.ts b/src/preload/index.ts
index 5db557bb..91decfa3 100644
--- a/src/preload/index.ts
+++ b/src/preload/index.ts
@@ -19,14 +19,19 @@ import {
   EDITOR_LIST_FILES,
   EDITOR_MOVE_FILE,
   EDITOR_OPEN,
+  EDITOR_READ_BINARY_PREVIEW,
   EDITOR_READ_DIR,
   EDITOR_READ_FILE,
+  EDITOR_RENAME_FILE,
   EDITOR_SEARCH_IN_FILES,
+  EDITOR_SET_WATCHED_DIRS,
+  EDITOR_SET_WATCHED_FILES,
   EDITOR_WATCH_DIR,
   EDITOR_WRITE_FILE,
   HTTP_SERVER_GET_STATUS,
   HTTP_SERVER_START,
   HTTP_SERVER_STOP,
+  PROJECT_LIST_FILES,
   REVIEW_APPLY_DECISIONS,
   REVIEW_CHECK_CONFLICT,
   REVIEW_CLEAR_DECISIONS,
@@ -52,6 +57,7 @@ import {
   SSH_TEST,
   TEAM_ADD_MEMBER,
   TEAM_ADD_TASK_COMMENT,
+  TEAM_ADD_TASK_RELATIONSHIP,
   TEAM_ALIVE_LIST,
   TEAM_CANCEL_PROVISIONING,
   TEAM_CHANGE,
@@ -78,6 +84,7 @@ import {
   TEAM_PROVISIONING_PROGRESS,
   TEAM_PROVISIONING_STATUS,
   TEAM_REMOVE_MEMBER,
+  TEAM_REMOVE_TASK_RELATIONSHIP,
   TEAM_REQUEST_REVIEW,
   TEAM_RESTORE,
   TEAM_RESTORE_TASK,
@@ -112,6 +119,7 @@ import {
   WINDOW_MINIMIZE,
 } from './constants/ipcChannels';
 import {
+  CONFIG_ADD_CUSTOM_PROJECT_PATH,
   CONFIG_ADD_IGNORE_REGEX,
   CONFIG_ADD_IGNORE_REPOSITORY,
   CONFIG_ADD_TRIGGER,
@@ -124,6 +132,7 @@ import {
   CONFIG_HIDE_SESSIONS,
   CONFIG_OPEN_IN_EDITOR,
   CONFIG_PIN_SESSION,
+  CONFIG_REMOVE_CUSTOM_PROJECT_PATH,
   CONFIG_REMOVE_IGNORE_REGEX,
   CONFIG_REMOVE_IGNORE_REPOSITORY,
   CONFIG_REMOVE_TRIGGER,
@@ -195,6 +204,7 @@ import type {
   WslClaudeRootCandidate,
 } from '@shared/types';
 import type {
+  BinaryPreviewResult,
   CreateDirResponse,
   CreateFileResponse,
   DeleteFileResponse,
@@ -441,6 +451,12 @@ const electronAPI: ElectronAPI = {
     unhideSessions: async (projectId: string, sessionIds: string[]): Promise<void> => {
       return invokeIpcWithResult<void>(CONFIG_UNHIDE_SESSIONS, projectId, sessionIds);
     },
+    addCustomProjectPath: async (projectPath: string): Promise<void> => {
+      return invokeIpcWithResult<void>(CONFIG_ADD_CUSTOM_PROJECT_PATH, projectPath);
+    },
+    removeCustomProjectPath: async (projectPath: string): Promise<void> => {
+      return invokeIpcWithResult<void>(CONFIG_REMOVE_CUSTOM_PROJECT_PATH, projectPath);
+    },
   },
 
   // Deep link navigation
@@ -696,7 +712,12 @@ const electronAPI: ElectronAPI = {
     getLogsForTask: async (
       teamName: string,
       taskId: string,
-      options?: { owner?: string; status?: string }
+      options?: {
+        owner?: string;
+        status?: string;
+        intervals?: { startedAt: string; completedAt?: string }[];
+        since?: string;
+      }
     ) => {
       return invokeIpcWithResult<MemberLogSummary[]>(
         TEAM_GET_LOGS_FOR_TASK,
@@ -758,6 +779,34 @@ const electronAPI: ElectronAPI = {
     showMessageNotification: async (data: TeamMessageNotificationData) => {
       return invokeIpcWithResult<void>(TEAM_SHOW_MESSAGE_NOTIFICATION, data);
     },
+    addTaskRelationship: async (
+      teamName: string,
+      taskId: string,
+      targetId: string,
+      type: 'blockedBy' | 'blocks' | 'related'
+    ) => {
+      return invokeIpcWithResult<void>(
+        TEAM_ADD_TASK_RELATIONSHIP,
+        teamName,
+        taskId,
+        targetId,
+        type
+      );
+    },
+    removeTaskRelationship: async (
+      teamName: string,
+      taskId: string,
+      targetId: string,
+      type: 'blockedBy' | 'blocks' | 'related'
+    ) => {
+      return invokeIpcWithResult<void>(
+        TEAM_REMOVE_TASK_RELATIONSHIP,
+        teamName,
+        taskId,
+        targetId,
+        type
+      );
+    },
     onTeamChange: (callback: (event: unknown, data: TeamChangeEvent) => void): (() => void) => {
       ipcRenderer.on(
         TEAM_CHANGE,
@@ -858,28 +907,36 @@ const electronAPI: ElectronAPI = {
       );
     },
     // Editable diff
-    saveEditedFile: async (filePath: string, content: string) => {
-      return invokeIpcWithResult<{ success: boolean }>(REVIEW_SAVE_EDITED_FILE, filePath, content);
+    saveEditedFile: async (filePath: string, content: string, projectPath?: string) => {
+      return invokeIpcWithResult<{ success: boolean }>(
+        REVIEW_SAVE_EDITED_FILE,
+        filePath,
+        content,
+        projectPath
+      );
     },
     // Decision persistence
     loadDecisions: async (teamName: string, scopeKey: string) => {
       return invokeIpcWithResult<{
         hunkDecisions: Record<string, HunkDecision>;
         fileDecisions: Record<string, HunkDecision>;
+        hunkContextHashesByFile?: Record<string, Record<number, string>>;
       } | null>(REVIEW_LOAD_DECISIONS, teamName, scopeKey);
     },
     saveDecisions: async (
       teamName: string,
       scopeKey: string,
       hunkDecisions: Record<string, HunkDecision>,
-      fileDecisions: Record<string, HunkDecision>
+      fileDecisions: Record<string, HunkDecision>,
+      hunkContextHashesByFile?: Record<string, Record<number, string>>
     ) => {
       return invokeIpcWithResult<void>(
         REVIEW_SAVE_DECISIONS,
         teamName,
         scopeKey,
         hunkDecisions,
-        fileDecisions
+        fileDecisions,
+        hunkContextHashesByFile ?? null
       );
     },
     clearDecisions: async (teamName: string, scopeKey: string) => {
@@ -957,6 +1014,12 @@ const electronAPI: ElectronAPI = {
     },
   },
 
+  // ===== Project API (editor-independent) =====
+  project: {
+    listFiles: (projectPath: string) =>
+      invokeIpcWithResult<QuickOpenFile[]>(PROJECT_LIST_FILES, projectPath),
+  },
+
   // ===== Editor API =====
   editor: {
     open: (projectPath: string) => invokeIpcWithResult<void>(EDITOR_OPEN, projectPath),
@@ -974,11 +1037,19 @@ const electronAPI: ElectronAPI = {
       invokeIpcWithResult<DeleteFileResponse>(EDITOR_DELETE_FILE, filePath),
     moveFile: (sourcePath: string, destDir: string) =>
       invokeIpcWithResult<MoveFileResponse>(EDITOR_MOVE_FILE, sourcePath, destDir),
+    renameFile: (sourcePath: string, newName: string) =>
+      invokeIpcWithResult<MoveFileResponse>(EDITOR_RENAME_FILE, sourcePath, newName),
     searchInFiles: (options: SearchInFilesOptions) =>
       invokeIpcWithResult<SearchInFilesResult>(EDITOR_SEARCH_IN_FILES, options),
     listFiles: () => invokeIpcWithResult<QuickOpenFile[]>(EDITOR_LIST_FILES),
+    readBinaryPreview: (filePath: string) =>
+      invokeIpcWithResult<BinaryPreviewResult>(EDITOR_READ_BINARY_PREVIEW, filePath),
     gitStatus: () => invokeIpcWithResult<GitStatusResult>(EDITOR_GIT_STATUS),
     watchDir: (enable: boolean) => invokeIpcWithResult<void>(EDITOR_WATCH_DIR, enable),
+    setWatchedFiles: (filePaths: string[]) =>
+      invokeIpcWithResult<void>(EDITOR_SET_WATCHED_FILES, filePaths),
+    setWatchedDirs: (dirPaths: string[]) =>
+      invokeIpcWithResult<void>(EDITOR_SET_WATCHED_DIRS, dirPaths),
     onEditorChange: (callback: (event: EditorFileChangeEvent) => void): (() => void) => {
       const listener = (_event: Electron.IpcRendererEvent, data: EditorFileChangeEvent): void =>
         callback(data);
diff --git a/src/renderer/api/httpClient.ts b/src/renderer/api/httpClient.ts
index db014947..90628029 100644
--- a/src/renderer/api/httpClient.ts
+++ b/src/renderer/api/httpClient.ts
@@ -63,7 +63,7 @@ import type {
   WslClaudeRootCandidate,
 } from '@shared/types';
 import type { AgentConfig } from '@shared/types/api';
-import type { EditorAPI } from '@shared/types/editor';
+import type { EditorAPI, ProjectAPI } from '@shared/types/editor';
 import type { TerminalAPI } from '@shared/types/terminal';
 
 export class HttpAPIClient implements ElectronAPI {
@@ -481,6 +481,10 @@ export class HttpAPIClient implements ElectronAPI {
       this.post('/api/config/hide-sessions', { projectId, sessionIds }),
     unhideSessions: (projectId: string, sessionIds: string[]): Promise<void> =>
       this.post('/api/config/unhide-sessions', { projectId, sessionIds }),
+    addCustomProjectPath: (projectPath: string): Promise<void> =>
+      this.post('/api/config/add-custom-project-path', { projectPath }),
+    removeCustomProjectPath: (projectPath: string): Promise<void> =>
+      this.post('/api/config/remove-custom-project-path', { projectPath }),
   };
 
   // ---------------------------------------------------------------------------
@@ -808,6 +812,22 @@ export class HttpAPIClient implements ElectronAPI {
     showMessageNotification: async (): Promise<void> => {
       // Not available via HTTP client — native notifications require Electron
     },
+    addTaskRelationship: async (
+      _teamName: string,
+      _taskId: string,
+      _targetId: string,
+      _type: 'blockedBy' | 'blocks' | 'related'
+    ): Promise<void> => {
+      throw new Error('Task relationships are not available in browser mode');
+    },
+    removeTaskRelationship: async (
+      _teamName: string,
+      _taskId: string,
+      _targetId: string,
+      _type: 'blockedBy' | 'blocks' | 'related'
+    ): Promise<void> => {
+      throw new Error('Task relationships are not available in browser mode');
+    },
     onTeamChange: (callback: (event: unknown, data: TeamChangeEvent) => void): (() => void) => {
       return this.addEventListener('team-change', (data: unknown) =>
         callback(null, data as TeamChangeEvent)
@@ -863,7 +883,13 @@ export class HttpAPIClient implements ElectronAPI {
     loadDecisions: async (): Promise<never> => {
       throw new Error('Review is not available in browser mode');
     },
-    saveDecisions: async (): Promise<never> => {
+    saveDecisions: async (
+      _teamName: string,
+      _scopeKey: string,
+      _hunkDecisions: Record<string, unknown>,
+      _fileDecisions: Record<string, unknown>,
+      _hunkContextHashesByFile?: Record<string, Record<number, string>>
+    ): Promise<never> => {
       throw new Error('Review is not available in browser mode');
     },
     clearDecisions: async (): Promise<never> => {
@@ -912,6 +938,16 @@ export class HttpAPIClient implements ElectronAPI {
     onExit: (): (() => void) => () => {},
   };
 
+  // ---------------------------------------------------------------------------
+  // Project (not available in browser mode)
+  // ---------------------------------------------------------------------------
+
+  project: ProjectAPI = {
+    listFiles: async () => {
+      throw new Error('Project API not available in browser mode');
+    },
+  };
+
   // ---------------------------------------------------------------------------
   // Editor (not available in browser mode)
   // ---------------------------------------------------------------------------
@@ -944,18 +980,30 @@ export class HttpAPIClient implements ElectronAPI {
     moveFile: async () => {
       throw new Error('Editor not available in browser mode');
     },
+    renameFile: async () => {
+      throw new Error('Editor not available in browser mode');
+    },
     searchInFiles: async () => {
       throw new Error('Editor not available in browser mode');
     },
     listFiles: async () => {
       throw new Error('Editor not available in browser mode');
     },
+    readBinaryPreview: async () => {
+      throw new Error('Editor not available in browser mode');
+    },
     gitStatus: async () => {
       throw new Error('Editor not available in browser mode');
     },
     watchDir: async () => {
       throw new Error('Editor not available in browser mode');
     },
+    setWatchedFiles: async () => {
+      throw new Error('Editor not available in browser mode');
+    },
+    setWatchedDirs: async () => {
+      throw new Error('Editor not available in browser mode');
+    },
     onEditorChange: () => {
       return () => {};
     },
diff --git a/src/renderer/components/chat/ChatHistory.tsx b/src/renderer/components/chat/ChatHistory.tsx
index 93b30be2..243a635e 100644
--- a/src/renderer/components/chat/ChatHistory.tsx
+++ b/src/renderer/components/chat/ChatHistory.tsx
@@ -224,6 +224,46 @@ export const ChatHistory = ({ tabId }: ChatHistoryProps): JSX.Element => {
     return map;
   }, [conversation]);
 
+  // --- New-item animation tracking ---
+  const knownGroupIdsRef = useRef<Set<string>>(new Set());
+  const isInitialRenderRef = useRef(true);
+  const prevTabIdRef = useRef(effectiveTabId);
+
+  // Reset animation tracking when switching tabs/sessions
+  if (prevTabIdRef.current !== effectiveTabId) {
+    prevTabIdRef.current = effectiveTabId;
+    knownGroupIdsRef.current.clear();
+    isInitialRenderRef.current = true;
+  }
+
+  const newGroupIds = useMemo(() => {
+    const items = conversation?.items;
+    if (!items || items.length === 0) {
+      knownGroupIdsRef.current.clear();
+      isInitialRenderRef.current = true;
+      return new Set<string>();
+    }
+
+    // First render: seed all known IDs, no animations
+    if (isInitialRenderRef.current) {
+      isInitialRenderRef.current = false;
+      for (const item of items) {
+        knownGroupIdsRef.current.add(item.group.id);
+      }
+      return new Set<string>();
+    }
+
+    // Subsequent updates: detect new items
+    const newIds = new Set<string>();
+    for (const item of items) {
+      if (!knownGroupIdsRef.current.has(item.group.id)) {
+        newIds.add(item.group.id);
+        knownGroupIdsRef.current.add(item.group.id);
+      }
+    }
+    return newIds;
+  }, [conversation]);
+
   const rowVirtualizer = useVirtualizer({
     count: shouldVirtualize ? (conversation?.items.length ?? 0) : 0,
     getScrollElement: () => scrollContainerRef.current,
@@ -849,6 +889,7 @@ export const ChatHistory = ({ tabId }: ChatHistoryProps): JSX.Element => {
                           isSearchHighlight={isSearchHighlight}
                           isNavigationHighlight={isNavigationHighlight}
                           highlightColor={effectiveHighlightColor}
+                          isNew={newGroupIds.has(item.group.id)}
                           registerChatItemRef={registerChatItemRef}
                           registerAIGroupRef={registerAIGroupRefCombined}
                           registerToolRef={registerToolRef}
@@ -867,6 +908,7 @@ export const ChatHistory = ({ tabId }: ChatHistoryProps): JSX.Element => {
                     isSearchHighlight={isSearchHighlight}
                     isNavigationHighlight={isNavigationHighlight}
                     highlightColor={effectiveHighlightColor}
+                    isNew={newGroupIds.has(item.group.id)}
                     registerChatItemRef={registerChatItemRef}
                     registerAIGroupRef={registerAIGroupRefCombined}
                     registerToolRef={registerToolRef}
diff --git a/src/renderer/components/chat/ChatHistoryItem.tsx b/src/renderer/components/chat/ChatHistoryItem.tsx
index 8e049138..60238de8 100644
--- a/src/renderer/components/chat/ChatHistoryItem.tsx
+++ b/src/renderer/components/chat/ChatHistoryItem.tsx
@@ -21,6 +21,8 @@ interface ChatHistoryItemProps {
   readonly isSearchHighlight: boolean;
   readonly isNavigationHighlight: boolean;
   readonly highlightColor?: TriggerColor;
+  /** Whether this item just appeared (triggers enter animation) */
+  readonly isNew?: boolean;
   readonly registerChatItemRef: (groupId: string) => (el: HTMLElement | null) => void;
   readonly registerAIGroupRef: (groupId: string) => (el: HTMLElement | null) => void;
   /** Register ref for individual tool items (for precise scroll targeting) */
@@ -54,10 +56,13 @@ const ChatHistoryItemInner = ({
   isSearchHighlight,
   isNavigationHighlight,
   highlightColor,
+  isNew,
   registerChatItemRef,
   registerAIGroupRef,
   registerToolRef,
 }: ChatHistoryItemProps): JSX.Element | null => {
+  const enterClass = isNew ? 'chat-message-enter-animate' : '';
+
   switch (item.type) {
     case 'user': {
       const isHighlighted = highlightedGroupId === item.group.id;
@@ -70,7 +75,7 @@ const ChatHistoryItemInner = ({
       return (
         <div
           ref={registerChatItemRef(item.group.id)}
-          className={`duration-[3000ms] rounded-lg transition-all ease-out ${hl.className}`}
+          className={`duration-[3000ms] rounded-lg transition-all ease-out ${hl.className} ${enterClass}`}
           style={hl.style}
         >
           <UserChatGroup userGroup={item.group} />
@@ -88,7 +93,7 @@ const ChatHistoryItemInner = ({
       return (
         <div
           ref={registerChatItemRef(item.group.id)}
-          className={`duration-[3000ms] rounded-lg transition-all ease-out ${hl.className}`}
+          className={`duration-[3000ms] rounded-lg transition-all ease-out ${hl.className} ${enterClass}`}
           style={hl.style}
         >
           <SystemChatGroup systemGroup={item.group} />
@@ -110,7 +115,7 @@ const ChatHistoryItemInner = ({
       return (
         <div
           ref={registerAIGroupRef(item.group.id)}
-          className={`duration-[3000ms] rounded-lg transition-all ease-out ${hl.className}`}
+          className={`duration-[3000ms] rounded-lg transition-all ease-out ${hl.className} ${enterClass}`}
           style={hl.style}
         >
           <AIChatGroup
@@ -123,7 +128,13 @@ const ChatHistoryItemInner = ({
       );
     }
     case 'compact':
-      return <CompactBoundary compactGroup={item.group} />;
+      return isNew ? (
+        <div className={enterClass}>
+          <CompactBoundary compactGroup={item.group} />
+        </div>
+      ) : (
+        <CompactBoundary compactGroup={item.group} />
+      );
     default:
       return null;
   }
diff --git a/src/renderer/components/chat/viewers/MarkdownViewer.tsx b/src/renderer/components/chat/viewers/MarkdownViewer.tsx
index a7fc3ae0..1c730df2 100644
--- a/src/renderer/components/chat/viewers/MarkdownViewer.tsx
+++ b/src/renderer/components/chat/viewers/MarkdownViewer.tsx
@@ -23,7 +23,7 @@ import {
   PROSE_TABLE_HEADER_BG,
 } from '@renderer/constants/cssVariables';
 import { useStore } from '@renderer/store';
-import { REHYPE_PLUGINS } from '@renderer/utils/markdownPlugins';
+import { REHYPE_PLUGINS, REHYPE_PLUGINS_NO_HIGHLIGHT } from '@renderer/utils/markdownPlugins';
 import { FileText } from 'lucide-react';
 import remarkGfm from 'remark-gfm';
 import { useShallow } from 'zustand/react/shallow';
@@ -34,6 +34,8 @@ import {
   type SearchContext,
 } from '../searchHighlightUtils';
 
+import { MermaidDiagram } from './MermaidDiagram';
+
 // =============================================================================
 // Types
 // =============================================================================
@@ -49,6 +51,100 @@ interface MarkdownViewerProps {
   copyable?: boolean;
   /** When true, renders without wrapper background/border (for embedding inside cards) */
   bare?: boolean;
+  /** Base directory for resolving relative URLs (images, links) via local-resource:// protocol */
+  baseDir?: string;
+}
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+/** Check if a URL is relative (not absolute, not data, not mailto, not hash) */
+function isRelativeUrl(url: string): boolean {
+  return (
+    !!url &&
+    !url.startsWith('http://') &&
+    !url.startsWith('https://') &&
+    !url.startsWith('data:') &&
+    !url.startsWith('#') &&
+    !url.startsWith('mailto:')
+  );
+}
+
+/** Resolve a relative path to an absolute path given a base directory */
+function resolveRelativePath(relativeSrc: string, baseDir: string): string {
+  const cleaned = relativeSrc.startsWith('./') ? relativeSrc.slice(2) : relativeSrc;
+  return `${baseDir}/${cleaned}`;
+}
+
+// =============================================================================
+// LocalImage — loads images via IPC (readBinaryPreview) for local file access
+// =============================================================================
+
+interface LocalImageProps {
+  src: string;
+  alt?: string;
+  baseDir: string;
+}
+
+const LocalImage = React.memo(function LocalImage({
+  src,
+  alt,
+  baseDir,
+}: LocalImageProps): React.ReactElement {
+  const [dataUrl, setDataUrl] = React.useState<string | null>(null);
+  const [error, setError] = React.useState(false);
+
+  React.useEffect(() => {
+    let cancelled = false;
+    setDataUrl(null);
+    setError(false);
+
+    const fullPath = resolveRelativePath(src, baseDir);
+    window.electronAPI.editor
+      .readBinaryPreview(fullPath)
+      .then((result) => {
+        if (!cancelled) {
+          setDataUrl(`data:${result.mimeType};base64,${result.base64}`);
+        }
+      })
+      .catch(() => {
+        if (!cancelled) setError(true);
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [src, baseDir]);
+
+  if (error) {
+    return (
+      <span className="inline-flex items-center gap-1 text-xs text-text-muted">
+        [Image: {alt || src}]
+      </span>
+    );
+  }
+
+  if (!dataUrl) {
+    return (
+      <span className="inline-block size-4 animate-pulse rounded bg-surface-raised align-middle" />
+    );
+  }
+
+  return <img src={dataUrl} alt={alt || ''} className="my-2 max-w-full rounded" />;
+});
+
+/** Extract plain text from a hast (HTML AST) node tree */
+interface HastNode {
+  type: string;
+  value?: string;
+  children?: HastNode[];
+}
+
+function hastToText(node: HastNode): string {
+  if (node.type === 'text') return node.value ?? '';
+  if (node.children) return node.children.map(hastToText).join('');
+  return '';
 }
 
 // =============================================================================
@@ -180,18 +276,29 @@ function createViewerMarkdownComponents(searchCtx: SearchContext | null): Compon
       );
     },
 
-    // Code blocks
-    pre: ({ children }) => (
-      <pre
-        className="my-3 max-w-full overflow-x-auto rounded-lg p-3 text-xs leading-relaxed"
-        style={{
-          backgroundColor: PROSE_PRE_BG,
-          border: `1px solid ${PROSE_PRE_BORDER}`,
-        }}
-      >
-        {children}
-      </pre>
-    ),
+    // Code blocks — intercept mermaid diagrams at the pre level
+    pre: ({ children, node }) => {
+      // Check if this pre contains a mermaid code block
+      const codeEl = node?.children?.[0];
+      if (codeEl && 'tagName' in codeEl && codeEl.tagName === 'code' && 'properties' in codeEl) {
+        const cls = (codeEl.properties as Record<string, unknown>)?.className;
+        if (Array.isArray(cls) && cls.some((c) => String(c) === 'language-mermaid')) {
+          return <MermaidDiagram code={hastToText(codeEl as unknown as HastNode)} />;
+        }
+      }
+
+      return (
+        <pre
+          className="my-3 max-w-full overflow-x-auto rounded-lg p-3 text-xs leading-relaxed"
+          style={{
+            backgroundColor: PROSE_PRE_BG,
+            border: `1px solid ${PROSE_PRE_BORDER}`,
+          }}
+        >
+          {children}
+        </pre>
+      );
+    },
 
     // Blockquotes
     blockquote: ({ children }) => (
@@ -288,6 +395,7 @@ export const MarkdownViewer: React.FC<MarkdownViewerProps> = ({
   itemId,
   copyable = false,
   bare = false,
+  baseDir,
 }) => {
   const [showRaw, setShowRaw] = React.useState(false);
   const [rawLimit, setRawLimit] = React.useState(LARGE_PREVIEW_CHARS);
@@ -435,7 +543,20 @@ export const MarkdownViewer: React.FC<MarkdownViewerProps> = ({
   // Create markdown components with optional search highlighting
   // When search is active, create fresh each render (match counter is stateful and must start at 0)
   // useMemo would cache stale closures when parent re-renders without search deps changing
-  const components = searchCtx ? createViewerMarkdownComponents(searchCtx) : defaultComponents;
+  const baseComponents = searchCtx ? createViewerMarkdownComponents(searchCtx) : defaultComponents;
+
+  // When baseDir is set (editor preview), override img to load local files via IPC
+  const components = baseDir
+    ? {
+        ...baseComponents,
+        img: ({ src, alt }: { src?: string; alt?: string }) => {
+          if (src && isRelativeUrl(src)) {
+            return <LocalImage src={src} alt={alt} baseDir={baseDir} />;
+          }
+          return <img src={src} alt={alt || ''} className="my-2 max-w-full rounded" />;
+        },
+      }
+    : baseComponents;
 
   return (
     <div
@@ -481,8 +602,7 @@ export const MarkdownViewer: React.FC<MarkdownViewerProps> = ({
         <div className="min-w-0 break-words p-4">
           <ReactMarkdown
             remarkPlugins={[remarkGfm]}
-            rehypePlugins={disableHighlight ? [] : REHYPE_PLUGINS}
-            urlTransform={(url) => url}
+            rehypePlugins={disableHighlight ? REHYPE_PLUGINS_NO_HIGHLIGHT : REHYPE_PLUGINS}
             components={components}
           >
             {content}
diff --git a/src/renderer/components/chat/viewers/MermaidDiagram.tsx b/src/renderer/components/chat/viewers/MermaidDiagram.tsx
new file mode 100644
index 00000000..41833bdc
--- /dev/null
+++ b/src/renderer/components/chat/viewers/MermaidDiagram.tsx
@@ -0,0 +1,116 @@
+/**
+ * Renders a Mermaid diagram from code string to SVG.
+ *
+ * Lazy-initializes mermaid once with dark theme.
+ * Each render call uses a unique ID to avoid collisions.
+ * SVG output is sanitized with DOMPurify before DOM insertion.
+ * Falls back to raw code display on parse errors.
+ */
+
+import React, { useEffect, useRef, useState } from 'react';
+
+import { PROSE_PRE_BG, PROSE_PRE_BORDER } from '@renderer/constants/cssVariables';
+import DOMPurify from 'dompurify';
+import mermaid from 'mermaid';
+
+// =============================================================================
+// Mermaid initialization (once per app lifecycle)
+// =============================================================================
+
+let initialized = false;
+
+function ensureMermaidInit(): void {
+  if (initialized) return;
+  mermaid.initialize({
+    startOnLoad: false,
+    theme: 'dark',
+    themeVariables: {
+      darkMode: true,
+      background: 'transparent',
+      primaryColor: '#3b82f6',
+      primaryTextColor: '#fafafa',
+      primaryBorderColor: '#3b82f6',
+      lineColor: '#71717a',
+      secondaryColor: '#27272a',
+      tertiaryColor: '#1f1f23',
+    },
+  });
+  initialized = true;
+}
+
+// Monotonic counter for unique diagram IDs
+let idCounter = 0;
+
+// =============================================================================
+// Component
+// =============================================================================
+
+interface MermaidDiagramProps {
+  code: string;
+}
+
+export const MermaidDiagram = React.memo(function MermaidDiagram({
+  code,
+}: MermaidDiagramProps): React.ReactElement {
+  const containerRef = useRef<HTMLDivElement>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!code.trim()) return;
+
+    ensureMermaidInit();
+
+    let cancelled = false;
+    const diagramId = `mermaid-${++idCounter}`;
+
+    mermaid
+      .render(diagramId, code.trim())
+      .then(({ svg }) => {
+        if (!cancelled && containerRef.current) {
+          const sanitized = DOMPurify.sanitize(svg, {
+            USE_PROFILES: { svg: true, svgFilters: true },
+            ADD_TAGS: ['foreignObject'],
+          });
+          containerRef.current.replaceChildren();
+          containerRef.current.insertAdjacentHTML('afterbegin', sanitized);
+          setError(null);
+        }
+      })
+      .catch((err: unknown) => {
+        if (!cancelled) {
+          const msg = err instanceof Error ? err.message : String(err);
+          setError(msg);
+        }
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [code]);
+
+  if (error) {
+    return (
+      <div
+        className="my-3 overflow-auto rounded-lg p-3 text-xs"
+        style={{
+          backgroundColor: PROSE_PRE_BG,
+          border: `1px solid ${PROSE_PRE_BORDER}`,
+        }}
+      >
+        <div className="mb-2 text-amber-400">Mermaid syntax error</div>
+        <pre className="whitespace-pre-wrap font-mono text-text-muted">{code}</pre>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      ref={containerRef}
+      className="my-3 flex justify-center overflow-auto rounded-lg p-3"
+      style={{
+        backgroundColor: PROSE_PRE_BG,
+        border: `1px solid ${PROSE_PRE_BORDER}`,
+      }}
+    />
+  );
+});
diff --git a/src/renderer/components/common/WorktreeBadge.tsx b/src/renderer/components/common/WorktreeBadge.tsx
index ad6febc0..7d9686ac 100644
--- a/src/renderer/components/common/WorktreeBadge.tsx
+++ b/src/renderer/components/common/WorktreeBadge.tsx
@@ -52,6 +52,11 @@ const SOURCE_CONFIG: Record<WorktreeSource, SourceConfig> = {
     bgColor: WORKTREE_BADGE_BG,
     textColor: WORKTREE_BADGE_TEXT,
   },
+  'claude-code': {
+    label: 'Worktree',
+    bgColor: WORKTREE_BADGE_BG,
+    textColor: WORKTREE_BADGE_TEXT,
+  },
   ccswitch: {
     label: 'ccswitch',
     bgColor: WORKTREE_BADGE_BG,
diff --git a/src/renderer/components/dashboard/DashboardView.tsx b/src/renderer/components/dashboard/DashboardView.tsx
index 6efb75bf..d06451df 100644
--- a/src/renderer/components/dashboard/DashboardView.tsx
+++ b/src/renderer/components/dashboard/DashboardView.tsx
@@ -24,8 +24,9 @@ import { createLogger } from '@shared/utils/logger';
 import { useShallow } from 'zustand/react/shallow';
 
 const logger = createLogger('Component:DashboardView');
+import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { formatDistanceToNow } from 'date-fns';
-import { Command, FolderGit2, FolderOpen, GitBranch, Search, Users } from 'lucide-react';
+import { Command, FolderGit2, FolderOpen, GitBranch, GitFork, Search, Users } from 'lucide-react';
 
 import { CliStatusBanner } from './CliStatusBanner';
 
@@ -52,7 +53,7 @@ const CommandSearch = ({ value, onChange }: Readonly<CommandSearchProps>): React
   // Handle Cmd+K to open full command palette
   useEffect(() => {
     const handleKeyDown = (e: KeyboardEvent): void => {
-      if ((e.metaKey || e.ctrlKey) && e.key === 'k') {
+      if ((e.metaKey || e.ctrlKey) && e.code === 'KeyK') {
         e.preventDefault();
         openCommandPalette();
       }
@@ -138,6 +139,41 @@ const RepositoryCard = ({
   const mainWorktree = repo.worktrees.find((w) => w.isMainWorktree) ?? repo.worktrees[0];
   const mainBranch = mainWorktree?.gitBranch;
 
+  // Detect if this is a worktree project:
+  // 1. No main worktree in the group (isMainWorktree flag)
+  // 2. OR the shown worktree has a tool-created source
+  // 3. OR path-based fallback for .claude/worktrees/ directories
+  const WORKTREE_PATH_MARKERS = [
+    '/.claude/worktrees/',
+    '/.claude-worktrees/',
+    '/.auto-claude/worktrees/',
+    '/.21st/worktrees/',
+    '/.ccswitch/worktrees/',
+    '/.cursor/worktrees/',
+    '/vibe-kanban/worktrees/',
+    '/conductor/workspaces/',
+  ];
+
+  const shownWorktree = repo.worktrees[0];
+  const isWorktreeBySource =
+    shownWorktree?.source && !['git', 'unknown'].includes(shownWorktree.source);
+  const isWorktreeByPath =
+    shownWorktree && WORKTREE_PATH_MARKERS.some((m) => shownWorktree.path.includes(m));
+  const isWorktreeProject =
+    !repo.worktrees.some((w) => w.isMainWorktree) || isWorktreeBySource || isWorktreeByPath;
+
+  // Get the source label for worktree badge
+  const SOURCE_LABELS: Record<string, string> = {
+    'vibe-kanban': 'Vibe',
+    conductor: 'Conductor',
+    'auto-claude': 'Auto',
+    '21st': '21st',
+    'claude-desktop': 'Desktop',
+    'claude-code': 'Worktree',
+    ccswitch: 'ccswitch',
+  };
+  const worktreeSourceLabel = shownWorktree?.source && SOURCE_LABELS[shownWorktree.source];
+
   const color = useMemo(() => projectColor(repo.name), [repo.name]);
   const cardRef = useRef<HTMLButtonElement>(null);
   const [isHovered, setIsHovered] = useState(false);
@@ -171,30 +207,49 @@ const RepositoryCard = ({
       {/* Icon + Project name */}
       <div className="mb-1 flex items-center gap-2.5">
         <div className="flex size-8 shrink-0 items-center justify-center rounded-md border border-border bg-surface-overlay transition-colors duration-300 group-hover:border-border-emphasis">
-          <FolderGit2
-            className="size-4 transition-colors group-hover:text-text"
-            style={{ color: color.icon }}
-          />
+          {isWorktreeProject ? (
+            <GitFork
+              className="size-4 transition-colors group-hover:text-text"
+              style={{ color: color.icon }}
+            />
+          ) : (
+            <FolderGit2
+              className="size-4 transition-colors group-hover:text-text"
+              style={{ color: color.icon }}
+            />
+          )}
         </div>
         <h3 className="min-w-0 truncate text-sm font-medium text-text transition-colors duration-200 group-hover:text-text">
           {repo.name}
         </h3>
+        {isWorktreeProject && (
+          <span className="inline-flex shrink-0 items-center gap-1 rounded-full bg-purple-500/15 px-1.5 py-0.5 text-[9px] font-medium text-purple-400">
+            {worktreeSourceLabel ?? 'Worktree'}
+          </span>
+        )}
       </div>
 
       {/* Project path - monospace, muted, clickable to open in file manager */}
-      <div
-        role="button"
-        tabIndex={0}
-        onClick={handleOpenPath}
-        onKeyDown={(e) => {
-          if (e.key === 'Enter' || e.key === ' ') handleOpenPath(e as unknown as React.MouseEvent);
-        }}
-        className="flex w-full min-w-0 cursor-pointer items-center gap-1 truncate text-left font-mono text-[10px] text-text-muted transition-colors hover:text-text-secondary"
-        title={`Open in file manager: ${projectPath}`}
-      >
-        <FolderOpen className="size-3 shrink-0" />
-        <span className="truncate">{formattedPath}</span>
-      </div>
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <div
+            role="button"
+            tabIndex={0}
+            onClick={handleOpenPath}
+            onKeyDown={(e) => {
+              if (e.key === 'Enter' || e.key === ' ')
+                handleOpenPath(e as unknown as React.MouseEvent);
+            }}
+            className="flex w-full min-w-0 cursor-pointer items-center gap-1 truncate text-left font-mono text-[10px] text-text-muted transition-colors hover:text-text-secondary"
+          >
+            <FolderOpen className="size-3 shrink-0" />
+            <span className="truncate">{formattedPath}</span>
+          </div>
+        </TooltipTrigger>
+        <TooltipContent side="bottom" align="start">
+          <p className="font-mono text-[11px]">{projectPath}</p>
+        </TooltipContent>
+      </Tooltip>
 
       {/* Git branch / worktree info */}
       {mainBranch ? (
@@ -316,10 +371,11 @@ function findMatchingWorktree(
 }
 
 const NewProjectCard = (): React.JSX.Element => {
-  const { repositoryGroups, fetchRepositoryGroups } = useStore(
+  const { repositoryGroups, fetchRepositoryGroups, openTeamsTab } = useStore(
     useShallow((s) => ({
       repositoryGroups: s.repositoryGroups,
       fetchRepositoryGroups: s.fetchRepositoryGroups,
+      openTeamsTab: s.openTeamsTab,
     }))
   );
 
@@ -341,6 +397,7 @@ const NewProjectCard = (): React.JSX.Element => {
       const match = findMatchingWorktree(repositoryGroups, selectedPath);
       if (match) {
         navigateToMatch(match);
+        openTeamsTab();
         return;
       }
 
@@ -350,11 +407,15 @@ const NewProjectCard = (): React.JSX.Element => {
       const matchAfterRefresh = findMatchingWorktree(refreshedGroups, selectedPath);
       if (matchAfterRefresh) {
         navigateToMatch(matchAfterRefresh);
+        openTeamsTab();
         return;
       }
 
       // Still no match — create a synthetic group for this new folder and navigate to it.
       // This allows launching teams in projects that don't have Claude sessions yet.
+      // Persist the path so it survives app restarts.
+      await api.config.addCustomProjectPath(selectedPath);
+
       const encodedId = selectedPath.replace(/[/\\]/g, '-');
       const folderName = selectedPath.split(/[/\\]/).filter(Boolean).pop() ?? selectedPath;
       const now = Date.now();
@@ -382,6 +443,7 @@ const NewProjectCard = (): React.JSX.Element => {
         repositoryGroups: [syntheticGroup, ...state.repositoryGroups],
       }));
       navigateToMatch({ repoId: encodedId, worktreeId: encodedId });
+      openTeamsTab();
     } catch (error) {
       logger.error('Error selecting folder:', error);
     }
diff --git a/src/renderer/components/search/CommandPalette.tsx b/src/renderer/components/search/CommandPalette.tsx
index 4777fb91..70703c9b 100644
--- a/src/renderer/components/search/CommandPalette.tsx
+++ b/src/renderer/components/search/CommandPalette.tsx
@@ -330,7 +330,7 @@ export const CommandPalette = (): React.JSX.Element | null => {
   // Handle keyboard navigation
   const handleKeyDown = useCallback(
     (e: React.KeyboardEvent) => {
-      if (e.key === 'g' && (e.metaKey || e.ctrlKey)) {
+      if (e.code === 'KeyG' && (e.metaKey || e.ctrlKey)) {
         e.preventDefault();
         setGlobalSearchEnabled((prev) => !prev);
         return;
diff --git a/src/renderer/components/settings/hooks/useSettingsConfig.ts b/src/renderer/components/settings/hooks/useSettingsConfig.ts
index 5c4d8386..4ff8b090 100644
--- a/src/renderer/components/settings/hooks/useSettingsConfig.ts
+++ b/src/renderer/components/settings/hooks/useSettingsConfig.ts
@@ -42,6 +42,9 @@ export interface SafeConfig {
     snoozedUntil: number | null;
     snoozeMinutes: number;
     includeSubagentErrors: boolean;
+    notifyOnLeadInbox: boolean;
+    notifyOnUserInbox: boolean;
+    notifyOnClarifications: boolean;
     triggers: AppConfig['notifications']['triggers'];
   };
   display: {
@@ -169,6 +172,9 @@ export function useSettingsConfig(): UseSettingsConfigReturn {
         snoozedUntil: displayConfig?.notifications?.snoozedUntil ?? null,
         snoozeMinutes: displayConfig?.notifications?.snoozeMinutes ?? 30,
         includeSubagentErrors: displayConfig?.notifications?.includeSubagentErrors ?? true,
+        notifyOnLeadInbox: displayConfig?.notifications?.notifyOnLeadInbox ?? false,
+        notifyOnUserInbox: displayConfig?.notifications?.notifyOnUserInbox ?? true,
+        notifyOnClarifications: displayConfig?.notifications?.notifyOnClarifications ?? true,
         triggers: displayConfig?.notifications?.triggers ?? [],
       },
       display: {
diff --git a/src/renderer/components/settings/hooks/useSettingsHandlers.ts b/src/renderer/components/settings/hooks/useSettingsHandlers.ts
index b1169648..669b8687 100644
--- a/src/renderer/components/settings/hooks/useSettingsHandlers.ts
+++ b/src/renderer/components/settings/hooks/useSettingsHandlers.ts
@@ -287,6 +287,9 @@ export function useSettingsHandlers({
           snoozedUntil: null,
           snoozeMinutes: 30,
           includeSubagentErrors: true,
+          notifyOnLeadInbox: false,
+          notifyOnUserInbox: true,
+          notifyOnClarifications: true,
           triggers: defaultTriggers,
         },
         general: {
diff --git a/src/renderer/components/settings/sections/NotificationsSection.tsx b/src/renderer/components/settings/sections/NotificationsSection.tsx
index c1766eb7..5c47e69f 100644
--- a/src/renderer/components/settings/sections/NotificationsSection.tsx
+++ b/src/renderer/components/settings/sections/NotificationsSection.tsx
@@ -32,7 +32,13 @@ interface NotificationsSectionProps {
   readonly ignoredRepositoryItems: RepositoryDropdownItem[];
   readonly excludedRepositoryIds: string[];
   readonly onNotificationToggle: (
-    key: 'enabled' | 'soundEnabled' | 'includeSubagentErrors',
+    key:
+      | 'enabled'
+      | 'soundEnabled'
+      | 'includeSubagentErrors'
+      | 'notifyOnLeadInbox'
+      | 'notifyOnUserInbox'
+      | 'notifyOnClarifications',
     value: boolean
   ) => void;
   readonly onSnooze: (minutes: number) => Promise<void>;
@@ -130,6 +136,36 @@ export const NotificationsSection = ({
           disabled={saving || !safeConfig.notifications.enabled}
         />
       </SettingRow>
+      <SettingRow
+        label="Lead inbox notifications"
+        description="Notify when teammates send messages to the team lead"
+      >
+        <SettingsToggle
+          enabled={safeConfig.notifications.notifyOnLeadInbox}
+          onChange={(v) => onNotificationToggle('notifyOnLeadInbox', v)}
+          disabled={saving || !safeConfig.notifications.enabled}
+        />
+      </SettingRow>
+      <SettingRow
+        label="User inbox notifications"
+        description="Notify when teammates send messages to you"
+      >
+        <SettingsToggle
+          enabled={safeConfig.notifications.notifyOnUserInbox}
+          onChange={(v) => onNotificationToggle('notifyOnUserInbox', v)}
+          disabled={saving || !safeConfig.notifications.enabled}
+        />
+      </SettingRow>
+      <SettingRow
+        label="Task clarification notifications"
+        description="Show native OS notifications when a task needs your input"
+      >
+        <SettingsToggle
+          enabled={safeConfig.notifications.notifyOnClarifications}
+          onChange={(v) => onNotificationToggle('notifyOnClarifications', v)}
+          disabled={saving || !safeConfig.notifications.enabled}
+        />
+      </SettingRow>
       <SettingRow
         label="Snooze notifications"
         description={
diff --git a/src/renderer/components/sidebar/DateGroupedSessions.tsx b/src/renderer/components/sidebar/DateGroupedSessions.tsx
index c72701fc..6d09260b 100644
--- a/src/renderer/components/sidebar/DateGroupedSessions.tsx
+++ b/src/renderer/components/sidebar/DateGroupedSessions.tsx
@@ -57,6 +57,7 @@ const SOURCE_LABELS: Record<WorktreeSource, string> = {
   'auto-claude': 'Auto Claude',
   '21st': '21st',
   'claude-desktop': 'Claude Desktop',
+  'claude-code': 'Claude Code',
   ccswitch: 'ccswitch',
   git: 'Git',
   unknown: 'Other',
diff --git a/src/renderer/components/team/MemberBadge.tsx b/src/renderer/components/team/MemberBadge.tsx
index e3dfaaa2..bca37d17 100644
--- a/src/renderer/components/team/MemberBadge.tsx
+++ b/src/renderer/components/team/MemberBadge.tsx
@@ -6,6 +6,8 @@ interface MemberBadgeProps {
   color?: string;
   /** Avatar + badge size variant */
   size?: 'sm' | 'md';
+  /** Hide the avatar icon, show only the name badge */
+  hideAvatar?: boolean;
   onClick?: (name: string) => void;
 }
 
@@ -18,6 +20,7 @@ export const MemberBadge = ({
   name,
   color,
   size = 'sm',
+  hideAvatar,
   onClick,
 }: MemberBadgeProps): React.JSX.Element => {
   const colors = getTeamColorSet(color ?? '');
@@ -59,7 +62,7 @@ export const MemberBadge = ({
           onClick(name);
         }}
       >
-        {avatar}
+        {!hideAvatar && avatar}
         {badge}
       </button>
     );
@@ -67,7 +70,7 @@ export const MemberBadge = ({
 
   return (
     <span className="inline-flex items-center gap-1">
-      {avatar}
+      {!hideAvatar && avatar}
       {badge}
     </span>
   );
diff --git a/src/renderer/components/team/TeamDetailView.tsx b/src/renderer/components/team/TeamDetailView.tsx
index e6c6bd6d..8bede8b4 100644
--- a/src/renderer/components/team/TeamDetailView.tsx
+++ b/src/renderer/components/team/TeamDetailView.tsx
@@ -16,6 +16,7 @@ import { getTeamColorSet } from '@renderer/constants/teamColors';
 import { useTeamMessagesRead } from '@renderer/hooks/useTeamMessagesRead';
 import { cn } from '@renderer/lib/utils';
 import { useStore } from '@renderer/store';
+import { createChipFromSelection } from '@renderer/utils/chipUtils';
 import { formatProjectPath } from '@renderer/utils/pathDisplay';
 import { buildTaskCountsByOwner } from '@renderer/utils/pathNormalize';
 import { nameColorSet } from '@renderer/utils/projectColor';
@@ -26,6 +27,7 @@ import {
   AlertTriangle,
   Bell,
   CheckCheck,
+  Code,
   Columns3,
   FolderOpen,
   GitBranch,
@@ -74,6 +76,7 @@ import { TeamSessionsSection } from './TeamSessionsSection';
 import type { KanbanFilterState } from './kanban/KanbanFilterPopover';
 import type { MessagesFilterState } from './messages/MessagesFilterPopover';
 import type { Session } from '@renderer/types/data';
+import type { InlineChip } from '@renderer/types/inlineChip';
 import type { InboxMessage, ResolvedTeamMember, TeamTaskWithKanban } from '@shared/types';
 import type { EditorSelectionAction } from '@shared/types/editor';
 
@@ -89,6 +92,7 @@ interface CreateTaskDialogState {
   defaultDescription: string;
   defaultOwner: string;
   defaultStartImmediately?: boolean;
+  defaultChip?: InlineChip;
 }
 
 interface TimeWindow {
@@ -148,6 +152,9 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
   const [trashOpen, setTrashOpen] = useState(false);
   const [sendDialogRecipient, setSendDialogRecipient] = useState<string | undefined>(undefined);
   const [sendDialogDefaultText, setSendDialogDefaultText] = useState<string | undefined>(undefined);
+  const [sendDialogDefaultChip, setSendDialogDefaultChip] = useState<InlineChip | undefined>(
+    undefined
+  );
   const [replyQuote, setReplyQuote] = useState<{ from: string; text: string } | undefined>(
     undefined
   );
@@ -259,6 +266,14 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
   });
   const [messagesFilterOpen, setMessagesFilterOpen] = useState(false);
 
+  // Open editor overlay when a file reveal is requested (e.g. from chip click)
+  const pendingRevealFile = useStore((s) => s.editorPendingRevealFile);
+  useEffect(() => {
+    if (pendingRevealFile && data?.config.projectPath) {
+      setEditorOpen(true);
+    }
+  }, [pendingRevealFile, data?.config.projectPath]);
+
   useEffect(() => {
     if (!teamName) {
       return;
@@ -526,13 +541,26 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
 
   const handleEditorAction = useCallback(
     (action: EditorSelectionAction) => {
+      const chip = createChipFromSelection(action, []) ?? undefined;
       if (action.type === 'sendMessage') {
-        setSendDialogDefaultText(action.formattedContext);
+        setSendDialogDefaultText(chip ? undefined : action.formattedContext);
+        setSendDialogDefaultChip(chip);
         setSendDialogRecipient(undefined);
         setReplyQuote(undefined);
         setSendDialogOpen(true);
       } else if (action.type === 'createTask') {
-        openCreateTaskDialog('', action.formattedContext);
+        if (chip) {
+          setCreateTaskDialog({
+            open: true,
+            defaultSubject: '',
+            defaultDescription: '',
+            defaultOwner: '',
+            defaultStartImmediately: undefined,
+            defaultChip: chip,
+          });
+        } else {
+          openCreateTaskDialog('', action.formattedContext);
+        }
       }
     },
 
@@ -805,13 +833,17 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
                   <span className="max-w-60 truncate font-mono">
                     {formatProjectPath(data.config.projectPath)}
                   </span>
-                  <button
-                    onClick={() => setEditorOpen(true)}
-                    className="ml-1 rounded px-1 py-0.5 text-[10px] text-[var(--color-text-muted)] transition-colors hover:bg-[var(--color-surface-raised)] hover:text-[var(--color-text-secondary)]"
-                    title="Open in Editor"
-                  >
-                    <Pencil size={10} />
-                  </button>
+                  <Tooltip>
+                    <TooltipTrigger asChild>
+                      <button
+                        onClick={() => setEditorOpen(true)}
+                        className="ml-1 flex items-center gap-0.5 rounded border border-[var(--color-border-emphasis)] bg-[var(--color-surface-raised)] px-1.5 py-0.5 text-[10px] text-[var(--color-text-secondary)] transition-colors hover:bg-[var(--color-border-emphasis)] hover:text-[var(--color-text)]"
+                      >
+                        <Code size={10} className="shrink-0" /> Edit code
+                      </button>
+                    </TooltipTrigger>
+                    <TooltipContent>Open project in built-in editor</TooltipContent>
+                  </Tooltip>
                 </span>
               )}
               {leadBranch && (
@@ -921,6 +953,7 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
             onSendMessage={(member) => {
               setSendDialogRecipient(member.name);
               setSendDialogDefaultText(undefined);
+              setSendDialogDefaultChip(undefined);
               setReplyQuote(undefined);
               setSendDialogOpen(true);
             }}
@@ -1238,6 +1271,7 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
             onReplyToMessage={(message) => {
               setSendDialogRecipient(message.from);
               setSendDialogDefaultText(undefined);
+              setSendDialogDefaultChip(undefined);
               setReplyQuote({ from: message.from, text: stripAgentBlocks(message.text) });
               setSendDialogOpen(true);
             }}
@@ -1288,6 +1322,7 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
             setSelectedMember(null);
             setSendDialogRecipient(name || undefined);
             setSendDialogDefaultText(undefined);
+            setSendDialogDefaultChip(undefined);
             setReplyQuote(undefined);
             setSendDialogOpen(true);
           }}
@@ -1342,6 +1377,7 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
           defaultDescription={createTaskDialog.defaultDescription}
           defaultOwner={createTaskDialog.defaultOwner}
           defaultStartImmediately={createTaskDialog.defaultStartImmediately}
+          defaultChip={createTaskDialog.defaultChip}
           onClose={closeCreateTaskDialog}
           onSubmit={handleCreateTask}
           submitting={creatingTask}
@@ -1450,6 +1486,7 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
           members={activeMembers}
           defaultRecipient={sendDialogRecipient}
           defaultText={sendDialogDefaultText}
+          defaultChip={sendDialogDefaultChip}
           quotedMessage={replyQuote}
           sending={sendingMessage}
           sendError={sendMessageError}
@@ -1474,6 +1511,7 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
             setSendDialogOpen(false);
             setReplyQuote(undefined);
             setSendDialogDefaultText(undefined);
+            setSendDialogDefaultChip(undefined);
           }}
         />
 
@@ -1524,6 +1562,8 @@ export const TeamDetailView = ({ teamName }: TeamDetailViewProps): React.JSX.Ele
           memberName={reviewDialogState.memberName}
           taskId={reviewDialogState.taskId}
           initialFilePath={reviewDialogState.initialFilePath}
+          projectPath={data.config.projectPath}
+          onEditorAction={handleEditorAction}
         />
       </div>
 
diff --git a/src/renderer/components/team/TeamListView.tsx b/src/renderer/components/team/TeamListView.tsx
index 0ebb1ba0..b473646f 100644
--- a/src/renderer/components/team/TeamListView.tsx
+++ b/src/renderer/components/team/TeamListView.tsx
@@ -541,7 +541,7 @@ export const TeamListView = (): React.JSX.Element => {
   const renderHeader = (): React.JSX.Element => (
     <div className="mb-4">
       <div className="flex items-center justify-between">
-        <h2 className="text-base font-semibold text-[var(--color-text)]">Teams</h2>
+        <h2 className="text-base font-semibold text-[var(--color-text)]">Select Team</h2>
         <div className="flex items-center gap-2">
           <Button
             variant="outline"
diff --git a/src/renderer/components/team/activity/ActivityItem.tsx b/src/renderer/components/team/activity/ActivityItem.tsx
index 09e21be9..219a1a3b 100644
--- a/src/renderer/components/team/activity/ActivityItem.tsx
+++ b/src/renderer/components/team/activity/ActivityItem.tsx
@@ -317,7 +317,12 @@ export const ActivityItem = ({
             <span style={{ color: CARD_ICON_MUTED }} className="text-[10px]">
               &rarr;
             </span>
-            <MemberBadge name={message.to} color={recipientColor} onClick={onMemberNameClick} />
+            <MemberBadge
+              name={message.to}
+              color={recipientColor}
+              hideAvatar={message.to === 'user'}
+              onClick={onMemberNameClick}
+            />
           </>
         ) : null}
 
diff --git a/src/renderer/components/team/activity/ActivityTimeline.tsx b/src/renderer/components/team/activity/ActivityTimeline.tsx
index dd79755e..5ae3bf92 100644
--- a/src/renderer/components/team/activity/ActivityTimeline.tsx
+++ b/src/renderer/components/team/activity/ActivityTimeline.tsx
@@ -34,6 +34,7 @@ const MessageRowWithObserver = ({
   memberColor,
   recipientColor,
   isUnread,
+  isNew,
   onMemberNameClick,
   onCreateTask,
   onReply,
@@ -46,6 +47,7 @@ const MessageRowWithObserver = ({
   memberColor?: string;
   recipientColor?: string;
   isUnread?: boolean;
+  isNew?: boolean;
   onMemberNameClick?: (name: string) => void;
   onCreateTask?: (subject: string, description: string) => void;
   onReply?: (message: InboxMessage) => void;
@@ -83,7 +85,7 @@ const MessageRowWithObserver = ({
   }, [onVisible]);
 
   return (
-    <div ref={ref} className="min-h-px">
+    <div ref={ref} className={isNew ? 'message-enter-animate min-h-px' : 'min-h-px'}>
       <ActivityItem
         message={message}
         teamName={teamName}
@@ -113,6 +115,11 @@ export const ActivityTimeline = ({
 }: ActivityTimelineProps): React.JSX.Element => {
   const [visibleCount, setVisibleCount] = useState(MESSAGES_PAGE_SIZE);
 
+  // --- New-message animation tracking ---
+  const knownKeysRef = useRef<Set<string>>(new Set<string>());
+  const isInitializedRef = useRef(false);
+  const prevVisibleCountRef = useRef(visibleCount);
+
   // Track whether the user was seeing ALL messages (no hidden ones).
   // If so, auto-expand when new messages push count past the limit,
   // so previously visible messages don't silently disappear.
@@ -152,19 +159,59 @@ export const ActivityTimeline = ({
 
   // Auto-expand when user was seeing all and new messages arrive — derived state sync.
   // Reading/updating ref during render is intentional (React docs: derived state sync).
-  /* eslint-disable react-hooks/refs -- ref stores previous frame's "showing all" for derived state sync */
+  /* eslint-disable react-hooks/refs -- intentional ref access during render for animation tracking */
+
   const wasShowingAll = wasShowingAllRef.current;
   if (wasShowingAll && hiddenCount > 0) {
     setVisibleCount(messages.length);
   }
   wasShowingAllRef.current = hiddenCount === 0;
-  /* eslint-enable react-hooks/refs -- end of intentional ref access during render */
 
   const visibleMessages = useMemo(
     () => (hiddenCount > 0 ? messages.slice(0, visibleCount) : messages),
     [messages, visibleCount, hiddenCount]
   );
 
+  // Determine which messages are "new" (should animate).
+
+  const newMessageKeys = useMemo(() => {
+    const getKey = (msg: InboxMessage, idx: number): string =>
+      `${msg.messageId ?? idx}-${msg.timestamp}-${msg.from}`;
+
+    // First render: seed known keys, no animations
+    if (!isInitializedRef.current) {
+      isInitializedRef.current = true;
+      for (let i = 0; i < visibleMessages.length; i++) {
+        knownKeysRef.current.add(getKey(visibleMessages[i], i));
+      }
+      prevVisibleCountRef.current = visibleCount;
+      return new Set<string>();
+    }
+
+    // Pagination expansion ("Show more" / "Show all"): add keys silently
+    const isPaginationExpansion = visibleCount > prevVisibleCountRef.current;
+    prevVisibleCountRef.current = visibleCount;
+
+    if (isPaginationExpansion) {
+      for (let i = 0; i < visibleMessages.length; i++) {
+        knownKeysRef.current.add(getKey(visibleMessages[i], i));
+      }
+      return new Set<string>();
+    }
+
+    // Normal update: unknown keys are new messages
+    const newKeys = new Set<string>();
+    for (let i = 0; i < visibleMessages.length; i++) {
+      const key = getKey(visibleMessages[i], i);
+      if (!knownKeysRef.current.has(key)) {
+        newKeys.add(key);
+        knownKeysRef.current.add(key);
+      }
+    }
+    return newKeys;
+  }, [visibleMessages, visibleCount]);
+  /* eslint-enable react-hooks/refs -- end animation tracking block */
+
   const handleShowMore = (): void => {
     setVisibleCount((prev) => prev + MESSAGES_PAGE_SIZE);
   };
@@ -203,6 +250,7 @@ export const ActivityTimeline = ({
             memberColor={info?.color}
             recipientColor={recipientColor}
             isUnread={isUnread}
+            isNew={newMessageKeys.has(messageKey)}
             onMemberNameClick={onMemberClick ? handleMemberNameClick : undefined}
             onCreateTask={onCreateTaskFromMessage}
             onReply={onReplyToMessage}
diff --git a/src/renderer/components/team/dialogs/CreateTaskDialog.tsx b/src/renderer/components/team/dialogs/CreateTaskDialog.tsx
index e8de42bc..8e5bbc09 100644
--- a/src/renderer/components/team/dialogs/CreateTaskDialog.tsx
+++ b/src/renderer/components/team/dialogs/CreateTaskDialog.tsx
@@ -22,11 +22,16 @@ import {
   SelectValue,
 } from '@renderer/components/ui/select';
 import { getTeamColorSet } from '@renderer/constants/teamColors';
+import { useChipDraftPersistence } from '@renderer/hooks/useChipDraftPersistence';
 import { useDraftPersistence } from '@renderer/hooks/useDraftPersistence';
+import { useStore } from '@renderer/store';
+import { chipToken, serializeChipsWithText } from '@renderer/types/inlineChip';
+import { removeChipTokenFromText } from '@renderer/utils/chipUtils';
 import { formatAgentRole } from '@renderer/utils/formatAgentRole';
 import { buildMemberColorMap } from '@renderer/utils/memberHelpers';
 import { AlertTriangle, Search } from 'lucide-react';
 
+import type { InlineChip } from '@renderer/types/inlineChip';
 import type { MentionSuggestion } from '@renderer/types/mention';
 import type { ResolvedTeamMember, TeamTaskWithKanban } from '@shared/types';
 
@@ -40,6 +45,7 @@ interface CreateTaskDialogProps {
   defaultDescription?: string;
   defaultOwner?: string;
   defaultStartImmediately?: boolean;
+  defaultChip?: InlineChip;
   onClose: () => void;
   onSubmit: (
     subject: string,
@@ -63,16 +69,19 @@ export const CreateTaskDialog = ({
   defaultDescription = '',
   defaultOwner = '',
   defaultStartImmediately,
+  defaultChip,
   onClose,
   onSubmit,
   submitting = false,
 }: CreateTaskDialogProps): React.JSX.Element => {
   const colorMap = useMemo(() => buildMemberColorMap(members), [members]);
+  const projectPath = useStore((s) => s.selectedTeamData?.config.projectPath ?? null);
   const [subject, setSubject] = useState(defaultSubject);
   const descriptionDraft = useDraftPersistence({
     key: `createTask:${teamName}:description`,
     initialValue: defaultDescription || undefined,
   });
+  const descChipDraft = useChipDraftPersistence(`createTask:${teamName}:descChips`);
   const [owner, setOwner] = useState<string>(defaultOwner);
   const [blockedBy, setBlockedBy] = useState<string[]>([]);
   const [related, setRelated] = useState<string[]>([]);
@@ -84,7 +93,11 @@ export const CreateTaskDialog = ({
 
   if (open && !prevOpen) {
     setSubject(defaultSubject);
-    if (defaultDescription) {
+    if (defaultChip) {
+      const token = chipToken(defaultChip);
+      descriptionDraft.setValue(token + '\n');
+      descChipDraft.setChips([defaultChip]);
+    } else if (defaultDescription) {
       descriptionDraft.setValue(defaultDescription);
     }
     setOwner(defaultOwner);
@@ -130,11 +143,23 @@ export const CreateTaskDialog = ({
     );
   };
 
+  const handleDescChipRemove = (chipId: string): void => {
+    const chip = descChipDraft.chips.find((c) => c.id === chipId);
+    if (chip) {
+      descriptionDraft.setValue(removeChipTokenFromText(descriptionDraft.value, chip));
+    }
+    descChipDraft.setChips(descChipDraft.chips.filter((c) => c.id !== chipId));
+  };
+
   const handleSubmit = (): void => {
     if (!canSubmit) return;
+    const serializedDesc = serializeChipsWithText(
+      descriptionDraft.value.trim(),
+      descChipDraft.chips
+    );
     onSubmit(
       subject.trim(),
-      descriptionDraft.value.trim(),
+      serializedDesc,
       owner || undefined,
       blockedBy.length > 0 ? blockedBy : undefined,
       related.length > 0 ? related : undefined,
@@ -142,6 +167,7 @@ export const CreateTaskDialog = ({
       startImmediately
     );
     descriptionDraft.clearDraft();
+    descChipDraft.clearChipDraft();
     promptDraft.clearDraft();
   };
 
@@ -239,6 +265,10 @@ export const CreateTaskDialog = ({
               value={descriptionDraft.value}
               onValueChange={descriptionDraft.setValue}
               suggestions={mentionSuggestions}
+              chips={descChipDraft.chips}
+              onChipRemove={handleDescChipRemove}
+              projectPath={projectPath}
+              onFileChipInsert={(chip) => descChipDraft.setChips([...descChipDraft.chips, chip])}
               minRows={3}
               maxRows={12}
               footerRight={
@@ -259,6 +289,7 @@ export const CreateTaskDialog = ({
               value={promptDraft.value}
               onValueChange={promptDraft.setValue}
               suggestions={mentionSuggestions}
+              projectPath={projectPath}
               minRows={3}
               maxRows={12}
               footerRight={
diff --git a/src/renderer/components/team/dialogs/CreateTeamDialog.tsx b/src/renderer/components/team/dialogs/CreateTeamDialog.tsx
index 17be5289..a5023b59 100644
--- a/src/renderer/components/team/dialogs/CreateTeamDialog.tsx
+++ b/src/renderer/components/team/dialogs/CreateTeamDialog.tsx
@@ -29,6 +29,7 @@ import { normalizePath } from '@renderer/utils/pathNormalize';
 import { getMemberColor } from '@shared/constants/memberColors';
 import { AlertTriangle, CheckCircle2, Loader2 } from 'lucide-react';
 
+import { ExtendedContextCheckbox } from './ExtendedContextCheckbox';
 import { MembersJsonEditor } from './MembersJsonEditor';
 import { ProjectPathSelector } from './ProjectPathSelector';
 
@@ -142,15 +143,33 @@ function buildMembers(members: MemberDraft[]): TeamCreateRequest['members'] {
     .filter((member): member is NonNullable<typeof member> => member !== null);
 }
 
-// eslint-disable-next-line security/detect-unsafe-regex -- kebab-case pattern is linear, no ReDoS
-const TEAM_NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-const MEMBER_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/;
+/** Mirrors Claude CLI's `zuA()` sanitization: non-alphanumeric → `-`, then lowercase. */
+function sanitizeTeamName(name: string): string {
+  let result = name
+    .replace(/[^a-zA-Z0-9]/g, '-')
+    .replace(/-{2,}/g, '-')
+    .toLowerCase();
+  // Trim leading/trailing dashes without backtracking-vulnerable regex
+  while (result.startsWith('-')) result = result.slice(1);
+  while (result.endsWith('-')) result = result.slice(0, -1);
+  return result;
+}
+
+function isValidMemberName(name: string): boolean {
+  if (name.length < 1 || name.length > 128) return false;
+  if (!/^[a-zA-Z0-9]/.test(name)) return false;
+  return /^[a-zA-Z0-9._-]+$/.test(name);
+}
 
 function validateTeamNameInline(name: string): string | null {
   const trimmed = name.trim();
   if (!trimmed) return null;
-  if (!TEAM_NAME_RE.test(trimmed) || trimmed.length > 64) {
-    return 'Use kebab-case [a-z0-9-], max 64 chars';
+  const sanitized = sanitizeTeamName(trimmed);
+  if (!sanitized) {
+    return 'Name must contain at least one letter or digit';
+  }
+  if (sanitized.length > 128) {
+    return 'Name is too long (max 128 chars)';
   }
   return null;
 }
@@ -158,7 +177,7 @@ function validateTeamNameInline(name: string): string | null {
 function validateMemberNameInline(name: string): string | null {
   const trimmed = name.trim();
   if (!trimmed) return null;
-  if (!MEMBER_NAME_RE.test(trimmed)) {
+  if (!isValidMemberName(trimmed)) {
     return 'Start with alphanumeric, use only [a-zA-Z0-9._-], max 128 chars';
   }
   return null;
@@ -169,11 +188,20 @@ function validateRequest(
   options?: { requireCwd?: boolean }
 ): ValidationResult {
   const requireCwd = options?.requireCwd ?? true;
-  if (!TEAM_NAME_RE.test(request.teamName) || request.teamName.length > 64) {
+  const sanitized = sanitizeTeamName(request.teamName);
+  if (!sanitized) {
     return {
       valid: false,
       errors: {
-        teamName: 'Use kebab-case [a-z0-9-], max 64 chars',
+        teamName: 'Name must contain at least one letter or digit',
+      },
+    };
+  }
+  if (sanitized.length > 128) {
+    return {
+      valid: false,
+      errors: {
+        teamName: 'Name is too long (max 128 chars)',
       },
     };
   }
@@ -201,7 +229,7 @@ function validateRequest(
       },
     };
   }
-  if (request.members.some((member) => !MEMBER_NAME_RE.test(member.name.trim()))) {
+  if (request.members.some((member) => !isValidMemberName(member.name.trim()))) {
     return {
       valid: false,
       errors: {
@@ -257,11 +285,26 @@ export const CreateTeamDialog = ({
   const [isSubmitting, setIsSubmitting] = useState(false);
   const [launchTeam, setLaunchTeam] = useState(true);
   const [teamColor, setTeamColor] = useState('');
-  const [selectedModel, setSelectedModel] = useState('');
+  const [selectedModel, setSelectedModelRaw] = useState(
+    () => localStorage.getItem('team:lastSelectedModel') ?? ''
+  );
+  const [extendedContext, setExtendedContextRaw] = useState(
+    () => localStorage.getItem('team:lastExtendedContext') === 'true'
+  );
   const [jsonEditorOpen, setJsonEditorOpen] = useState(false);
   const [jsonText, setJsonText] = useState('');
   const [jsonError, setJsonError] = useState<string | null>(null);
 
+  const setSelectedModel = (value: string): void => {
+    setSelectedModelRaw(value);
+    localStorage.setItem('team:lastSelectedModel', value);
+  };
+
+  const setExtendedContext = (value: boolean): void => {
+    setExtendedContextRaw(value);
+    localStorage.setItem('team:lastExtendedContext', String(value));
+  };
+
   const resetUIState = (): void => {
     setLocalError(null);
     setFieldErrors({});
@@ -281,7 +324,6 @@ export const CreateTeamDialog = ({
     setSelectedProjectPath('');
     setCustomCwd('');
     setLaunchTeam(true);
-    setSelectedModel('');
     setJsonEditorOpen(false);
     setJsonText('');
     setJsonError(null);
@@ -516,12 +558,19 @@ export const CreateTeamDialog = ({
     [members]
   );
 
-  const effectiveModel =
-    selectedModel && selectedModel !== '__default__' ? selectedModel : undefined;
+  const effectiveModel = useMemo(() => {
+    const base = selectedModel && selectedModel !== '__default__' ? selectedModel : undefined;
+    if (!extendedContext) return base;
+    // 1M context is only supported for opus and sonnet
+    if (base === 'haiku') return base;
+    return base ? `${base}[1m]` : 'sonnet[1m]';
+  }, [selectedModel, extendedContext]);
+
+  const sanitizedTeamName = sanitizeTeamName(teamName.trim());
 
   const request = useMemo<TeamCreateRequest>(
     () => ({
-      teamName: teamName.trim(),
+      teamName: sanitizedTeamName,
       description: description.trim() || undefined,
       color: teamColor || undefined,
       members: buildMembers(members),
@@ -529,7 +578,7 @@ export const CreateTeamDialog = ({
       prompt: prompt.trim() || undefined,
       model: effectiveModel,
     }),
-    [teamName, description, teamColor, members, effectiveCwd, prompt, effectiveModel]
+    [sanitizedTeamName, description, teamColor, members, effectiveCwd, prompt, effectiveModel]
   );
 
   const activeError = localError ?? provisioningError;
@@ -576,7 +625,7 @@ export const CreateTeamDialog = ({
   };
 
   const handleSubmit = (): void => {
-    if (existingTeamNames.includes(request.teamName)) {
+    if (existingTeamNames.includes(sanitizedTeamName)) {
       setFieldErrors({ teamName: 'Team name already exists' });
       setLocalError('Check form fields');
       return;
@@ -600,6 +649,7 @@ export const CreateTeamDialog = ({
             description: request.description,
             color: request.color,
             members: request.members,
+            cwd: effectiveCwd || undefined,
           });
           onOpenTeam(request.teamName, effectiveCwd || undefined);
           resetFormState();
@@ -710,13 +760,18 @@ export const CreateTeamDialog = ({
               onChange={(event) => setTeamName(event.target.value)}
               placeholder="team-alpha"
             />
-            {existingTeamNames.includes(teamName.trim()) ? (
+            {existingTeamNames.includes(sanitizedTeamName) ? (
               <p className="text-[11px] text-red-300">Team name already exists</p>
             ) : validateTeamNameInline(teamName) ? (
               <p className="text-[11px] text-red-300">{validateTeamNameInline(teamName)}</p>
             ) : fieldErrors.teamName ? (
               <p className="text-[11px] text-red-300">{fieldErrors.teamName}</p>
             ) : null}
+            {sanitizedTeamName && sanitizedTeamName !== teamName.trim() ? (
+              <p className="text-[11px] text-[var(--color-text-muted)]">
+                On disk: <span className="font-mono">{sanitizedTeamName}</span>
+              </p>
+            ) : null}
           </div>
 
           <div className="space-y-1.5 md:col-span-2">
@@ -870,6 +925,7 @@ export const CreateTeamDialog = ({
                     value={prompt}
                     onValueChange={promptDraft.setValue}
                     suggestions={mentionSuggestions}
+                    projectPath={effectiveCwd || null}
                     placeholder="Instructions for the team lead during provisioning..."
                     footerRight={
                       promptDraft.isSaved ? (
@@ -881,19 +937,27 @@ export const CreateTeamDialog = ({
                   />
                 </div>
 
-                <div className="space-y-1.5">
-                  <Label className="label-optional">Model (optional)</Label>
-                  <Select value={selectedModel} onValueChange={setSelectedModel}>
-                    <SelectTrigger className="h-8 text-xs">
-                      <SelectValue placeholder="Default (account setting)" />
-                    </SelectTrigger>
-                    <SelectContent>
-                      <SelectItem value="__default__">Default (account setting)</SelectItem>
-                      <SelectItem value="opus">Opus 4.6</SelectItem>
-                      <SelectItem value="sonnet">Sonnet 4.5</SelectItem>
-                      <SelectItem value="haiku">Haiku 4.5</SelectItem>
-                    </SelectContent>
-                  </Select>
+                <div>
+                  <div className="flex items-center gap-2.5">
+                    <Label className="label-optional shrink-0">Model (optional)</Label>
+                    <Select value={selectedModel} onValueChange={setSelectedModel}>
+                      <SelectTrigger className="h-8 w-auto min-w-[180px] text-xs">
+                        <SelectValue placeholder="Default (account setting)" />
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectItem value="__default__">Default (account setting)</SelectItem>
+                        <SelectItem value="opus">Opus 4.6</SelectItem>
+                        <SelectItem value="sonnet">Sonnet 4.5</SelectItem>
+                        <SelectItem value="haiku">Haiku 4.5</SelectItem>
+                      </SelectContent>
+                    </Select>
+                  </div>
+                  <ExtendedContextCheckbox
+                    id="create-extended-context"
+                    checked={extendedContext}
+                    onCheckedChange={setExtendedContext}
+                    disabled={selectedModel === 'haiku'}
+                  />
                 </div>
 
                 {canCreate && (prepareState === 'idle' || prepareState === 'loading') ? (
diff --git a/src/renderer/components/team/dialogs/ExtendedContextCheckbox.tsx b/src/renderer/components/team/dialogs/ExtendedContextCheckbox.tsx
new file mode 100644
index 00000000..fbfca008
--- /dev/null
+++ b/src/renderer/components/team/dialogs/ExtendedContextCheckbox.tsx
@@ -0,0 +1,66 @@
+import React from 'react';
+
+import { Checkbox } from '@renderer/components/ui/checkbox';
+import { Label } from '@renderer/components/ui/label';
+import { AlertTriangle } from 'lucide-react';
+
+interface ExtendedContextCheckboxProps {
+  id: string;
+  checked: boolean;
+  onCheckedChange: (checked: boolean) => void;
+  disabled?: boolean;
+}
+
+export const ExtendedContextCheckbox: React.FC<ExtendedContextCheckboxProps> = ({
+  id,
+  checked,
+  onCheckedChange,
+  disabled = false,
+}) => (
+  <>
+    <div className="mt-2 flex items-center gap-2">
+      <Checkbox
+        id={id}
+        checked={checked && !disabled}
+        disabled={disabled}
+        onCheckedChange={(value) => onCheckedChange(value === true)}
+      />
+      <Label
+        htmlFor={id}
+        className={`flex cursor-pointer items-center gap-1.5 text-xs font-normal ${
+          disabled ? 'cursor-not-allowed text-text-muted opacity-50' : 'text-text-secondary'
+        }`}
+      >
+        Extended context (1M tokens)
+        {disabled && <span className="text-[10px] italic">(not available for this model)</span>}
+      </Label>
+    </div>
+    {checked && (
+      <div className="mt-1.5 rounded-md border border-amber-500/40 bg-amber-500/10 px-3 py-2 text-xs">
+        <div className="flex items-start gap-2">
+          <AlertTriangle className="mt-0.5 size-3.5 shrink-0 text-amber-400" />
+          <div className="space-y-1 text-amber-300/90">
+            <p>
+              Beyond 200K tokens, premium pricing applies: 2x input cost, 1.5x output cost. For
+              subscribers, extra usage is billed separately.
+            </p>
+            <p>
+              Requires API tier 4+ or extra usage enabled.{' '}
+              <button
+                type="button"
+                className="underline underline-offset-2 hover:text-amber-200"
+                onClick={() =>
+                  window.electronAPI.openExternal(
+                    'https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window'
+                  )
+                }
+              >
+                Learn more
+              </button>
+            </p>
+          </div>
+        </div>
+      </div>
+    )}
+  </>
+);
diff --git a/src/renderer/components/team/dialogs/LaunchTeamDialog.tsx b/src/renderer/components/team/dialogs/LaunchTeamDialog.tsx
index 034dc872..03793207 100644
--- a/src/renderer/components/team/dialogs/LaunchTeamDialog.tsx
+++ b/src/renderer/components/team/dialogs/LaunchTeamDialog.tsx
@@ -1,6 +1,7 @@
 import React, { useEffect, useMemo, useState } from 'react';
 
 import { api } from '@renderer/api';
+import { ExtendedContextCheckbox } from '@renderer/components/team/dialogs/ExtendedContextCheckbox';
 import { Button } from '@renderer/components/ui/button';
 import { Checkbox } from '@renderer/components/ui/checkbox';
 import {
@@ -65,9 +66,24 @@ export const LaunchTeamDialog = ({
   const [prepareMessage, setPrepareMessage] = useState<string | null>(null);
   const [prepareWarnings, setPrepareWarnings] = useState<string[]>([]);
   const [isSubmitting, setIsSubmitting] = useState(false);
-  const [selectedModel, setSelectedModel] = useState('');
+  const [selectedModel, setSelectedModelRaw] = useState(
+    () => localStorage.getItem('team:lastSelectedModel') ?? ''
+  );
+  const [extendedContext, setExtendedContextRaw] = useState(
+    () => localStorage.getItem('team:lastExtendedContext') === 'true'
+  );
   const [clearContext, setClearContext] = useState(false);
 
+  const setSelectedModel = (value: string): void => {
+    setSelectedModelRaw(value);
+    localStorage.setItem('team:lastSelectedModel', value);
+  };
+
+  const setExtendedContext = (value: boolean): void => {
+    setExtendedContextRaw(value);
+    localStorage.setItem('team:lastExtendedContext', String(value));
+  };
+
   const resetFormState = (): void => {
     setLocalError(null);
     setIsSubmitting(false);
@@ -77,7 +93,6 @@ export const LaunchTeamDialog = ({
     setCwdMode('project');
     setSelectedProjectPath('');
     setCustomCwd('');
-    setSelectedModel('');
     setClearContext(false);
   };
 
@@ -240,7 +255,12 @@ export const LaunchTeamDialog = ({
           teamName,
           cwd: effectiveCwd,
           prompt: promptDraft.value.trim() || undefined,
-          model: selectedModel || undefined,
+          model: (() => {
+            if (!extendedContext) return selectedModel || undefined;
+            // 1M context is only supported for opus and sonnet
+            if (selectedModel === 'haiku') return selectedModel;
+            return selectedModel ? `${selectedModel}[1m]` : 'sonnet[1m]';
+          })(),
           clearContext: clearContext || undefined,
         });
         resetFormState();
@@ -344,6 +364,7 @@ export const LaunchTeamDialog = ({
               value={promptDraft.value}
               onValueChange={promptDraft.setValue}
               suggestions={mentionSuggestions}
+              projectPath={effectiveCwd || null}
               placeholder="Instructions for team lead... Use @ to mention team members."
               footerRight={
                 promptDraft.isSaved ? (
@@ -353,30 +374,38 @@ export const LaunchTeamDialog = ({
             />
           </div>
 
-          <div className="space-y-1.5">
-            <Label className="label-optional">Model (optional)</Label>
-            <div className="inline-flex rounded-md border border-[var(--color-border)] bg-[var(--color-surface)] p-0.5">
-              {[
-                { value: '', label: 'Default' },
-                { value: 'opus', label: 'Opus 4.6' },
-                { value: 'sonnet', label: 'Sonnet 4.5' },
-                { value: 'haiku', label: 'Haiku 4.5' },
-              ].map((opt) => (
-                <button
-                  key={opt.value}
-                  type="button"
-                  className={cn(
-                    'rounded-[3px] px-3 py-1 text-xs font-medium transition-colors',
-                    selectedModel === opt.value
-                      ? 'bg-[var(--color-surface-raised)] text-[var(--color-text)] shadow-sm'
-                      : 'text-[var(--color-text-muted)] hover:text-[var(--color-text-secondary)]'
-                  )}
-                  onClick={() => setSelectedModel(opt.value)}
-                >
-                  {opt.label}
-                </button>
-              ))}
+          <div>
+            <div className="flex items-center gap-2.5">
+              <Label className="label-optional shrink-0">Model (optional)</Label>
+              <div className="inline-flex rounded-md border border-[var(--color-border)] bg-[var(--color-surface)] p-0.5">
+                {[
+                  { value: '', label: 'Default' },
+                  { value: 'opus', label: 'Opus 4.6' },
+                  { value: 'sonnet', label: 'Sonnet 4.5' },
+                  { value: 'haiku', label: 'Haiku 4.5' },
+                ].map((opt) => (
+                  <button
+                    key={opt.value}
+                    type="button"
+                    className={cn(
+                      'rounded-[3px] px-3 py-1 text-xs font-medium transition-colors',
+                      selectedModel === opt.value
+                        ? 'bg-[var(--color-surface-raised)] text-[var(--color-text)] shadow-sm'
+                        : 'text-[var(--color-text-muted)] hover:text-[var(--color-text-secondary)]'
+                    )}
+                    onClick={() => setSelectedModel(opt.value)}
+                  >
+                    {opt.label}
+                  </button>
+                ))}
+              </div>
             </div>
+            <ExtendedContextCheckbox
+              id="launch-extended-context"
+              checked={extendedContext}
+              onCheckedChange={setExtendedContext}
+              disabled={selectedModel === 'haiku'}
+            />
           </div>
 
           <div className="space-y-2">
diff --git a/src/renderer/components/team/dialogs/ReviewDialog.tsx b/src/renderer/components/team/dialogs/ReviewDialog.tsx
index 45725ad0..83a5a50f 100644
--- a/src/renderer/components/team/dialogs/ReviewDialog.tsx
+++ b/src/renderer/components/team/dialogs/ReviewDialog.tsx
@@ -12,6 +12,7 @@ import {
 import { Label } from '@renderer/components/ui/label';
 import { MentionableTextarea } from '@renderer/components/ui/MentionableTextarea';
 import { useDraftPersistence } from '@renderer/hooks/useDraftPersistence';
+import { useStore } from '@renderer/store';
 import { formatAgentRole } from '@renderer/utils/formatAgentRole';
 import { buildMemberColorMap } from '@renderer/utils/memberHelpers';
 
@@ -35,6 +36,7 @@ export const ReviewDialog = ({
   onCancel,
   onSubmit,
 }: ReviewDialogProps): React.JSX.Element => {
+  const projectPath = useStore((s) => s.selectedTeamData?.config.projectPath ?? null);
   const draft = useDraftPersistence({
     key: `requestChanges:${teamName}:${taskId ?? ''}`,
     enabled: Boolean(teamName && taskId),
@@ -88,7 +90,7 @@ export const ReviewDialog = ({
             onValueChange={draft.setValue}
             placeholder="Describe what needs to change..."
             suggestions={mentionSuggestions}
-            hintText="Use @ to mention team members"
+            projectPath={projectPath}
             footerRight={
               draft.isSaved ? (
                 <span className="text-[10px] text-[var(--color-text-muted)]">Draft saved</span>
diff --git a/src/renderer/components/team/dialogs/SendMessageDialog.tsx b/src/renderer/components/team/dialogs/SendMessageDialog.tsx
index 4a00b710..2e40d154 100644
--- a/src/renderer/components/team/dialogs/SendMessageDialog.tsx
+++ b/src/renderer/components/team/dialogs/SendMessageDialog.tsx
@@ -1,5 +1,6 @@
-import { useEffect, useMemo, useState } from 'react';
+import React, { useEffect, useMemo, useState } from 'react';
 
+import { MarkdownViewer } from '@renderer/components/chat/viewers/MarkdownViewer';
 import { Button } from '@renderer/components/ui/button';
 import {
   Dialog,
@@ -21,12 +22,19 @@ import {
 } from '@renderer/components/ui/select';
 import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { getTeamColorSet } from '@renderer/constants/teamColors';
+import { useChipDraftPersistence } from '@renderer/hooks/useChipDraftPersistence';
 import { useDraftPersistence } from '@renderer/hooks/useDraftPersistence';
+import { useStore } from '@renderer/store';
+import { chipToken, serializeChipsWithText } from '@renderer/types/inlineChip';
 import { buildReplyBlock } from '@renderer/utils/agentMessageFormatting';
+import { removeChipTokenFromText } from '@renderer/utils/chipUtils';
 import { formatAgentRole } from '@renderer/utils/formatAgentRole';
 import { buildMemberColorMap } from '@renderer/utils/memberHelpers';
 import { X } from 'lucide-react';
 
+import { MemberBadge } from '../MemberBadge';
+
+import type { InlineChip } from '@renderer/types/inlineChip';
 import type { MentionSuggestion } from '@renderer/types/mention';
 import type { ResolvedTeamMember, SendMessageResult } from '@shared/types';
 
@@ -41,6 +49,8 @@ interface SendMessageDialogProps {
   defaultRecipient?: string;
   /** Pre-filled message text (e.g. from editor selection action) */
   defaultText?: string;
+  /** Pre-filled inline code chip (from editor selection action) */
+  defaultChip?: InlineChip;
   quotedMessage?: QuotedMessage;
   sending: boolean;
   sendError: string | null;
@@ -56,6 +66,7 @@ export const SendMessageDialog = ({
   members,
   defaultRecipient,
   defaultText,
+  defaultChip,
   quotedMessage,
   sending,
   sendError,
@@ -64,9 +75,12 @@ export const SendMessageDialog = ({
   onClose,
 }: SendMessageDialogProps): React.JSX.Element => {
   const colorMap = useMemo(() => buildMemberColorMap(members), [members]);
+  const projectPath = useStore((s) => s.selectedTeamData?.config.projectPath ?? null);
   const [quote, setQuote] = useState<QuotedMessage | undefined>(undefined);
+  const [quoteExpanded, setQuoteExpanded] = useState(false);
   const [member, setMember] = useState('');
   const textDraft = useDraftPersistence({ key: 'sendMessage:text' });
+  const chipDraft = useChipDraftPersistence('sendMessage:chips');
   const [summary, setSummary] = useState('');
   const [prevOpen, setPrevOpen] = useState(false);
   const [prevResult, setPrevResult] = useState<SendMessageResult | null>(null);
@@ -76,8 +90,13 @@ export const SendMessageDialog = ({
     setMember(defaultRecipient ?? '');
     setSummary('');
     setQuote(quotedMessage);
+    setQuoteExpanded(false);
     setPrevResult(lastResult);
-    if (defaultText) {
+    if (defaultChip) {
+      const token = chipToken(defaultChip);
+      textDraft.setValue(token + '\n');
+      chipDraft.setChips([defaultChip]);
+    } else if (defaultText) {
       textDraft.setValue(defaultText);
     }
   }
@@ -98,12 +117,16 @@ export const SendMessageDialog = ({
   useEffect(() => {
     if (pendingAutoClose) {
       textDraft.clearDraft();
+      chipDraft.clearChipDraft();
       setPendingAutoClose(false);
       onClose();
     }
     // eslint-disable-next-line react-hooks/exhaustive-deps -- only trigger on pendingAutoClose flag
   }, [pendingAutoClose]);
 
+  const QUOTE_COLLAPSE_THRESHOLD = 120;
+  const isQuoteLong = (quote?.text.length ?? 0) > QUOTE_COLLAPSE_THRESHOLD;
+
   const mentionSuggestions = useMemo<MentionSuggestion[]>(
     () =>
       members.map((m) => ({
@@ -121,12 +144,21 @@ export const SendMessageDialog = ({
     summary.trim().length > 0 &&
     !sending;
 
+  const handleChipRemove = (chipId: string): void => {
+    const chip = chipDraft.chips.find((c) => c.id === chipId);
+    if (chip) {
+      textDraft.setValue(removeChipTokenFromText(textDraft.value, chip));
+    }
+    chipDraft.setChips(chipDraft.chips.filter((c) => c.id !== chipId));
+  };
+
   const handleSubmit = (): void => {
     if (!canSend) return;
-    const rawText = textDraft.value.trim();
-    const finalText = quote ? buildReplyBlock(quote.from, quote.text, rawText) : rawText;
+    const serialized = serializeChipsWithText(textDraft.value.trim(), chipDraft.chips);
+    const finalText = quote ? buildReplyBlock(quote.from, quote.text, serialized) : serialized;
     onSend(member.trim(), finalText, summary.trim());
     textDraft.clearDraft();
+    chipDraft.clearChipDraft();
   };
 
   const handleOpenChange = (nextOpen: boolean): void => {
@@ -182,45 +214,73 @@ export const SendMessageDialog = ({
             </Select>
           </div>
 
-          {quote ? (
-            <div className="relative rounded-md border border-[var(--color-border)] bg-[var(--color-surface)] p-2.5">
-              <Tooltip>
-                <TooltipTrigger asChild>
-                  <button
-                    type="button"
-                    className="absolute right-1.5 top-1.5 rounded p-0.5 text-[var(--color-text-muted)] hover:text-[var(--color-text)]"
-                    onClick={() => setQuote(undefined)}
-                  >
-                    <X size={12} />
-                  </button>
-                </TooltipTrigger>
-                <TooltipContent side="left">Remove quote</TooltipContent>
-              </Tooltip>
-              <span className="mb-0.5 block text-[10px] font-medium text-[var(--color-text-muted)]">
-                Replying to @{quote.from}
-              </span>
-              <p className="line-clamp-3 pr-5 text-xs text-[var(--color-text-muted)]">
-                {quote.text}
-              </p>
-            </div>
-          ) : null}
-
           <div className="grid gap-2">
             <Label htmlFor="smd-message">Message</Label>
-            <MentionableTextarea
-              id="smd-message"
-              placeholder="Write your message..."
-              value={textDraft.value}
-              onValueChange={textDraft.setValue}
-              suggestions={mentionSuggestions}
-              minRows={4}
-              maxRows={12}
-              footerRight={
-                textDraft.isSaved ? (
-                  <span className="text-[10px] text-[var(--color-text-muted)]">Draft saved</span>
-                ) : null
-              }
-            />
+            <div className={quote ? 'flex flex-col' : 'contents'}>
+              {quote ? (
+                <div className="relative overflow-hidden rounded-t-md border border-b-0 border-blue-500/20 bg-blue-950/20 py-2 pl-3 pr-2">
+                  {/* Decorative quotation mark */}
+                  <span className="pointer-events-none absolute -right-1 top-1/2 -translate-y-1/2 select-none font-serif text-[64px] leading-none text-blue-400/[0.08]">
+                    &ldquo;
+                  </span>
+
+                  <Tooltip>
+                    <TooltipTrigger asChild>
+                      <button
+                        type="button"
+                        className="absolute right-1.5 top-1.5 z-10 rounded p-0.5 text-blue-300/40 hover:text-blue-200"
+                        onClick={() => setQuote(undefined)}
+                      >
+                        <X size={12} />
+                      </button>
+                    </TooltipTrigger>
+                    <TooltipContent side="left">Remove quote</TooltipContent>
+                  </Tooltip>
+
+                  <div className="mb-1 flex items-center gap-1.5">
+                    <span className="text-[10px] text-blue-300/60">Replying to</span>
+                    <MemberBadge name={quote.from} color={colorMap.get(quote.from)} size="sm" />
+                  </div>
+                  <div
+                    className={`pr-5 opacity-50 ${quoteExpanded ? '' : 'max-h-[3.75rem] overflow-hidden'}`}
+                  >
+                    <MarkdownViewer
+                      content={quote.text}
+                      bare
+                      maxHeight={quoteExpanded ? 'max-h-48' : 'max-h-[3.75rem]'}
+                    />
+                  </div>
+                  {isQuoteLong ? (
+                    <button
+                      type="button"
+                      className="mt-0.5 text-[10px] text-blue-400/60 hover:text-blue-300"
+                      onClick={() => setQuoteExpanded((v) => !v)}
+                    >
+                      {quoteExpanded ? 'less' : 'more'}
+                    </button>
+                  ) : null}
+                </div>
+              ) : null}
+              <MentionableTextarea
+                id="smd-message"
+                className={quote ? 'rounded-t-none' : undefined}
+                placeholder="Write your message..."
+                value={textDraft.value}
+                onValueChange={textDraft.setValue}
+                suggestions={mentionSuggestions}
+                chips={chipDraft.chips}
+                onChipRemove={handleChipRemove}
+                projectPath={projectPath}
+                onFileChipInsert={(chip) => chipDraft.setChips([...chipDraft.chips, chip])}
+                minRows={4}
+                maxRows={12}
+                footerRight={
+                  textDraft.isSaved ? (
+                    <span className="text-[10px] text-[var(--color-text-muted)]">Draft saved</span>
+                  ) : null
+                }
+              />
+            </div>
           </div>
 
           <div className="grid gap-2">
diff --git a/src/renderer/components/team/dialogs/TaskCommentInput.tsx b/src/renderer/components/team/dialogs/TaskCommentInput.tsx
index d44615eb..602253a4 100644
--- a/src/renderer/components/team/dialogs/TaskCommentInput.tsx
+++ b/src/renderer/components/team/dialogs/TaskCommentInput.tsx
@@ -33,6 +33,7 @@ export const TaskCommentInput = ({
 }: TaskCommentInputProps): React.JSX.Element => {
   const addTaskComment = useStore((s) => s.addTaskComment);
   const addingComment = useStore((s) => s.addingComment);
+  const projectPath = useStore((s) => s.selectedTeamData?.config.projectPath ?? null);
 
   const draft = useDraftPersistence({ key: `taskComment:${teamName}:${taskId}` });
   const colorMap = useMemo(() => buildMemberColorMap(members), [members]);
@@ -109,6 +110,7 @@ export const TaskCommentInput = ({
           value={draft.value}
           onValueChange={draft.setValue}
           suggestions={mentionSuggestions}
+          projectPath={projectPath}
           minRows={2}
           maxRows={8}
           maxLength={MAX_COMMENT_LENGTH}
diff --git a/src/renderer/components/team/dialogs/TaskCommentsSection.tsx b/src/renderer/components/team/dialogs/TaskCommentsSection.tsx
index 426ec636..b5be0f98 100644
--- a/src/renderer/components/team/dialogs/TaskCommentsSection.tsx
+++ b/src/renderer/components/team/dialogs/TaskCommentsSection.tsx
@@ -1,4 +1,4 @@
-import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useCallback, useMemo, useState } from 'react';
 
 import { MarkdownViewer } from '@renderer/components/chat/viewers/MarkdownViewer';
 import { ReplyQuoteBlock } from '@renderer/components/team/activity/ReplyQuoteBlock';
@@ -54,11 +54,16 @@ export const TaskCommentsSection = ({
   const [expandedCommentIds, setExpandedCommentIds] = useState<Set<string>>(new Set());
   const [visibleCount, setVisibleCount] = useState(INITIAL_VISIBLE_COMMENTS);
 
-  useEffect(() => {
+  // Reset local state when team/task changes (React-recommended pattern for
+  // adjusting state based on props without using effects or refs during render)
+  const currentKey = teamIdKey(teamName, taskId);
+  const [prevKey, setPrevKey] = useState(currentKey);
+  if (prevKey !== currentKey) {
+    setPrevKey(currentKey);
     setVisibleCount(INITIAL_VISIBLE_COMMENTS);
     setExpandedCommentIds(new Set());
     setReplyTo(null);
-  }, [teamIdKey(teamName, taskId)]);
+  }
 
   const toggleCommentExpanded = useCallback((commentId: string) => {
     setExpandedCommentIds((prev) => {
diff --git a/src/renderer/components/team/dialogs/TaskDetailDialog.tsx b/src/renderer/components/team/dialogs/TaskDetailDialog.tsx
index 3b1e5d8d..1b9c5402 100644
--- a/src/renderer/components/team/dialogs/TaskDetailDialog.tsx
+++ b/src/renderer/components/team/dialogs/TaskDetailDialog.tsx
@@ -598,6 +598,7 @@ export const TaskDetailDialog = ({
                 taskId={currentTask.id}
                 taskOwner={currentTask.owner}
                 taskStatus={currentTask.status}
+                taskWorkIntervals={currentTask.workIntervals}
               />
             </div>
           </CollapsibleTeamSection>
diff --git a/src/renderer/components/team/editor/CodeMirrorEditor.tsx b/src/renderer/components/team/editor/CodeMirrorEditor.tsx
index de84e7b1..d8830b36 100644
--- a/src/renderer/components/team/editor/CodeMirrorEditor.tsx
+++ b/src/renderer/components/team/editor/CodeMirrorEditor.tsx
@@ -9,8 +9,14 @@
 import { useCallback, useEffect, useRef } from 'react';
 
 import { defaultKeymap, history, historyKeymap, redo, undo } from '@codemirror/commands';
-import { bracketMatching, indentOnInput, syntaxHighlighting } from '@codemirror/language';
-import { search, searchKeymap } from '@codemirror/search';
+import {
+  bracketMatching,
+  foldGutter,
+  foldKeymap,
+  indentOnInput,
+  syntaxHighlighting,
+} from '@codemirror/language';
+import { gotoLine, search, searchKeymap } from '@codemirror/search';
 import { Compartment, EditorState } from '@codemirror/state';
 import { oneDarkHighlightStyle } from '@codemirror/theme-one-dark';
 import {
@@ -20,11 +26,16 @@ import {
   keymap,
   lineNumbers,
 } from '@codemirror/view';
+import {
+  createSearchPanel,
+  editorSearchPanelTheme,
+} from '@renderer/components/team/editor/EditorSearchPanel';
 import { useStore } from '@renderer/store';
 import {
   getAsyncLanguageDesc,
   getSyncLanguageExtension,
 } from '@renderer/utils/codemirrorLanguages';
+import { buildSelectionInfo, SELECTION_DEBOUNCE_MS } from '@renderer/utils/codemirrorSelectionInfo';
 import { baseEditorTheme } from '@renderer/utils/codemirrorTheme';
 import { editorBridge } from '@renderer/utils/editorBridge';
 
@@ -40,9 +51,6 @@ const DIRTY_DEBOUNCE_MS = 300;
 const AUTOSAVE_DELAY_MS = 30_000;
 const MAX_DRAFT_SIZE = 500 * 1024; // 500KB
 const MAX_DRAFTS = 10;
-const SELECTION_DEBOUNCE_MS = 150;
-const MAX_SELECTION_TEXT = 5000;
-
 /** Compartment for dynamic line wrap toggling */
 const lineWrapCompartment = new Compartment();
 
@@ -65,35 +73,8 @@ interface CodeMirrorEditorProps {
   onDraftRecovered?: (filePath: string) => void;
   /** Called when text selection changes (for floating action menu) */
   onSelectionChange?: (info: EditorSelectionInfo | null) => void;
-}
-
-// =============================================================================
-// Selection info helper
-// =============================================================================
-
-function buildSelectionInfo(
-  view: EditorView,
-  sel: { from: number; to: number }
-): EditorSelectionInfo | null {
-  const coords = view.coordsAtPos(sel.to);
-  if (!coords) return null; // selection end is off-screen
-
-  let text = view.state.sliceDoc(sel.from, sel.to);
-  if (text.length > MAX_SELECTION_TEXT) {
-    text = text.slice(0, MAX_SELECTION_TEXT) + '…';
-  }
-
-  return {
-    text,
-    filePath: '', // filled by parent (CodeMirrorEditor has no file context in buildEditableExtensions)
-    fromLine: view.state.doc.lineAt(sel.from).number,
-    toLine: view.state.doc.lineAt(sel.to).number,
-    screenRect: {
-      top: coords.top,
-      right: coords.right ?? coords.left,
-      bottom: coords.bottom,
-    },
-  };
+  /** Called with the current document text on changes (debounced, for live preview) */
+  onDocChange?: (content: string) => void;
 }
 
 // =============================================================================
@@ -122,12 +103,14 @@ function buildEditableExtensions(
     highlightActiveLineGutter(),
     bracketMatching(),
     indentOnInput(),
+    foldGutter(),
 
     // History
     history(),
 
-    // Search (Cmd+F)
-    search(),
+    // Search (Cmd+F) — custom panel with UI Kit
+    search({ createPanel: createSearchPanel }),
+    editorSearchPanelTheme,
 
     // Save keymap (Cmd+S / Ctrl+S)
     keymap.of([
@@ -150,7 +133,13 @@ function buildEditableExtensions(
     ]),
 
     // Keymaps
-    keymap.of([...defaultKeymap, ...historyKeymap, ...searchKeymap]),
+    // Filter out built-in gotoLine (Alt-g) — replaced by custom GoToLineDialog
+    keymap.of([
+      ...defaultKeymap,
+      ...historyKeymap,
+      ...searchKeymap.filter((k) => k.run !== gotoLine),
+      ...foldKeymap,
+    ]),
 
     // Update listener for dirty flag + cursor position + selection
     EditorView.updateListener.of((update) => {
@@ -241,6 +230,8 @@ function enforceDraftLimit(): void {
 // Component
 // =============================================================================
 
+const DOC_CHANGE_DEBOUNCE_MS = 150;
+
 export const CodeMirrorEditor = ({
   filePath,
   content,
@@ -249,6 +240,7 @@ export const CodeMirrorEditor = ({
   onCursorChange,
   onDraftRecovered,
   onSelectionChange,
+  onDocChange,
 }: CodeMirrorEditorProps): React.ReactElement => {
   const containerRef = useRef<HTMLDivElement>(null);
   const viewRef = useRef<EditorView | null>(null);
@@ -262,6 +254,8 @@ export const CodeMirrorEditor = ({
   const autosaveTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   // Selection debounce
   const selectionTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  // Doc change debounce (live preview)
+  const docChangeTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
   const markFileModified = useStore((s) => s.markFileModified);
   const discardChanges = useStore((s) => s.discardChanges);
@@ -281,6 +275,9 @@ export const CodeMirrorEditor = ({
   const onSelectionChangeRef = useRef(onSelectionChange);
   onSelectionChangeRef.current = onSelectionChange;
 
+  const onDocChangeRef = useRef(onDocChange);
+  onDocChangeRef.current = onDocChange;
+
   const lineWrapRef = useRef(lineWrap);
   lineWrapRef.current = lineWrap;
 
@@ -303,6 +300,13 @@ export const CodeMirrorEditor = ({
         saveDraft(filePathRef.current, view.state.doc.toString());
       }
     }, AUTOSAVE_DELAY_MS);
+
+    // Live content callback for markdown preview
+    if (docChangeTimerRef.current) clearTimeout(docChangeTimerRef.current);
+    docChangeTimerRef.current = setTimeout(() => {
+      const view = viewRef.current;
+      if (view) onDocChangeRef.current?.(view.state.doc.toString());
+    }, DOC_CHANGE_DEBOUNCE_MS);
   }, [markFileModified]);
 
   const handleCursorMove = useCallback((line: number, col: number) => {
@@ -442,6 +446,7 @@ export const CodeMirrorEditor = ({
     const dirtyTimer = dirtyTimerRef;
     const autosaveTimer = autosaveTimerRef;
     const selectionTimer = selectionTimerRef;
+    const docChangeTimer = docChangeTimerRef;
 
     return () => {
       // Save scroll position before destroying
@@ -454,6 +459,7 @@ export const CodeMirrorEditor = ({
       if (dirtyTimer.current) clearTimeout(dirtyTimer.current);
       if (autosaveTimer.current) clearTimeout(autosaveTimer.current);
       if (selectionTimer.current) clearTimeout(selectionTimer.current);
+      if (docChangeTimer.current) clearTimeout(docChangeTimer.current);
 
       view.destroy();
       viewRef.current = null;
@@ -496,5 +502,5 @@ export const CodeMirrorEditor = ({
     };
   }, []);
 
-  return <div ref={containerRef} className="size-full overflow-auto" />;
+  return <div ref={containerRef} className="size-full overflow-hidden" />;
 };
diff --git a/src/renderer/components/team/editor/EditorBinaryPlaceholder.tsx b/src/renderer/components/team/editor/EditorBinaryPlaceholder.tsx
new file mode 100644
index 00000000..3b19beea
--- /dev/null
+++ b/src/renderer/components/team/editor/EditorBinaryPlaceholder.tsx
@@ -0,0 +1,42 @@
+/**
+ * Placeholder for non-previewable binary files — shows file info and "Open in System Viewer" button.
+ */
+
+import { Button } from '@renderer/components/ui/button';
+import { useStore } from '@renderer/store';
+import { FileQuestion } from 'lucide-react';
+
+interface EditorBinaryPlaceholderProps {
+  filePath: string;
+  fileName: string;
+  size: number;
+}
+
+export const EditorBinaryPlaceholder = ({
+  filePath,
+  fileName,
+  size,
+}: EditorBinaryPlaceholderProps): React.ReactElement => {
+  const projectPath = useStore((s) => s.editorProjectPath);
+  const sizeFormatted =
+    size < 1024
+      ? `${size} B`
+      : size < 1024 * 1024
+        ? `${(size / 1024).toFixed(1)} KB`
+        : `${(size / 1024 / 1024).toFixed(1)} MB`;
+
+  const handleOpenExternal = (): void => {
+    window.electronAPI.openPath(filePath, projectPath ?? undefined).catch(console.error);
+  };
+
+  return (
+    <div className="flex h-full flex-col items-center justify-center gap-3 text-text-muted">
+      <FileQuestion className="size-12 opacity-30" />
+      <p className="text-sm font-medium text-text-secondary">{fileName}</p>
+      <p className="text-xs">Binary file ({sizeFormatted})</p>
+      <Button variant="outline" size="sm" className="mt-2" onClick={handleOpenExternal}>
+        Open in System Viewer
+      </Button>
+    </div>
+  );
+};
diff --git a/src/renderer/components/team/editor/EditorBinaryState.tsx b/src/renderer/components/team/editor/EditorBinaryState.tsx
index f67d8ff8..d239dd11 100644
--- a/src/renderer/components/team/editor/EditorBinaryState.tsx
+++ b/src/renderer/components/team/editor/EditorBinaryState.tsx
@@ -1,8 +1,12 @@
 /**
- * Placeholder for binary files — shows file info and "Open in System Viewer" button.
+ * Router for binary file display — picks the right preview component
+ * based on file type from the preview registry.
  */
 
-import { FileQuestion } from 'lucide-react';
+import { getPreviewType, isPreviewable } from '@renderer/utils/previewRegistry';
+
+import { EditorBinaryPlaceholder } from './EditorBinaryPlaceholder';
+import { EditorImagePreview } from './EditorImagePreview';
 
 interface EditorBinaryStateProps {
   filePath: string;
@@ -14,28 +18,11 @@ export const EditorBinaryState = ({
   size,
 }: EditorBinaryStateProps): React.ReactElement => {
   const fileName = filePath.split('/').pop() ?? filePath;
-  const sizeFormatted =
-    size < 1024
-      ? `${size} B`
-      : size < 1024 * 1024
-        ? `${(size / 1024).toFixed(1)} KB`
-        : `${(size / 1024 / 1024).toFixed(1)} MB`;
+  const previewType = getPreviewType(fileName);
 
-  const handleOpenExternal = (): void => {
-    window.electronAPI.openPath(filePath).catch(console.error);
-  };
+  if (previewType === 'image' && isPreviewable(fileName, size)) {
+    return <EditorImagePreview filePath={filePath} fileName={fileName} size={size} />;
+  }
 
-  return (
-    <div className="flex h-full flex-col items-center justify-center gap-3 text-text-muted">
-      <FileQuestion className="size-12 opacity-30" />
-      <p className="text-sm font-medium text-text-secondary">{fileName}</p>
-      <p className="text-xs">Binary file ({sizeFormatted})</p>
-      <button
-        onClick={handleOpenExternal}
-        className="mt-2 rounded border border-border px-3 py-1.5 text-xs text-text-secondary transition-colors hover:bg-surface-raised"
-      >
-        Open in System Viewer
-      </button>
-    </div>
-  );
+  return <EditorBinaryPlaceholder filePath={filePath} fileName={fileName} size={size} />;
 };
diff --git a/src/renderer/components/team/editor/EditorBreadcrumb.tsx b/src/renderer/components/team/editor/EditorBreadcrumb.tsx
index 5b0475bd..d3735a55 100644
--- a/src/renderer/components/team/editor/EditorBreadcrumb.tsx
+++ b/src/renderer/components/team/editor/EditorBreadcrumb.tsx
@@ -4,20 +4,25 @@
  * Each segment is clickable — expands and scrolls the folder in the file tree.
  */
 
-import { useMemo } from 'react';
+import { useCallback, useMemo } from 'react';
 
 import { useStore } from '@renderer/store';
 import { ChevronRight } from 'lucide-react';
+import { useShallow } from 'zustand/react/shallow';
 
-import { getFileIcon } from './fileIcons';
+import { FileIcon } from './FileIcon';
 
 // =============================================================================
 // Component
 // =============================================================================
 
 export const EditorBreadcrumb = (): React.ReactElement | null => {
-  const activeTabId = useStore((s) => s.editorActiveTabId);
-  const projectPath = useStore((s) => s.editorProjectPath);
+  const { activeTabId, projectPath } = useStore(
+    useShallow((s) => ({
+      activeTabId: s.editorActiveTabId,
+      projectPath: s.editorProjectPath,
+    }))
+  );
   const expandDirectory = useStore((s) => s.expandDirectory);
 
   const segments = useMemo(() => {
@@ -30,19 +35,19 @@ export const EditorBreadcrumb = (): React.ReactElement | null => {
     return relativePath.split('/');
   }, [activeTabId, projectPath]);
 
+  const handleSegmentClick = useCallback(
+    (segmentIndex: number): void => {
+      if (!projectPath) return;
+      const dirSegments = segments.slice(0, segmentIndex + 1);
+      const dirPath = `${projectPath}/${dirSegments.join('/')}`;
+      void expandDirectory(dirPath);
+    },
+    [segments, projectPath, expandDirectory]
+  );
+
   if (segments.length === 0) return null;
 
   const fileName = segments[segments.length - 1];
-  const iconInfo = getFileIcon(fileName);
-  const Icon = iconInfo.icon;
-
-  const handleSegmentClick = (segmentIndex: number): void => {
-    if (!projectPath) return;
-    // Build absolute path up to this segment (it's a directory)
-    const dirSegments = segments.slice(0, segmentIndex + 1);
-    const dirPath = `${projectPath}/${dirSegments.join('/')}`;
-    void expandDirectory(dirPath);
-  };
 
   return (
     <div className="flex items-center gap-0.5 overflow-x-auto px-3 py-1 text-xs text-text-muted">
@@ -53,7 +58,7 @@ export const EditorBreadcrumb = (): React.ReactElement | null => {
             {idx > 0 && <ChevronRight className="text-text-muted/50 size-3" />}
             {isLast ? (
               <span className="flex items-center gap-1 text-text-secondary">
-                <Icon className="size-3" style={{ color: iconInfo.color }} />
+                <FileIcon fileName={fileName} className="size-3" />
                 {segment}
               </span>
             ) : (
diff --git a/src/renderer/components/team/editor/EditorContextMenu.tsx b/src/renderer/components/team/editor/EditorContextMenu.tsx
index beb3a65d..4f18608f 100644
--- a/src/renderer/components/team/editor/EditorContextMenu.tsx
+++ b/src/renderer/components/team/editor/EditorContextMenu.tsx
@@ -9,7 +9,16 @@
 import React, { useCallback, useRef, useState } from 'react';
 
 import * as ContextMenu from '@radix-ui/react-context-menu';
-import { FilePlus, FolderOpen, FolderPlus, Trash2 } from 'lucide-react';
+import {
+  ClipboardCopy,
+  FilePlus,
+  FolderOpen,
+  FolderPlus,
+  ListTodo,
+  MessageSquare,
+  Pencil,
+  Trash2,
+} from 'lucide-react';
 
 // =============================================================================
 // Types
@@ -23,9 +32,15 @@ interface TargetEntry {
 
 interface EditorContextMenuProps {
   children: React.ReactNode;
+  projectPath: string | null;
   onNewFile: (parentDir: string) => void;
   onNewFolder: (parentDir: string) => void;
   onDelete: (path: string) => void;
+  onRename: (path: string) => void;
+  /** Trigger "Create Task" with a file mention (files only, not directories) */
+  onCreateTask?: (filePath: string) => void;
+  /** Trigger "Write Teammate" with a file mention (files only, not directories) */
+  onSendMessage?: (filePath: string) => void;
 }
 
 // =============================================================================
@@ -34,9 +49,13 @@ interface EditorContextMenuProps {
 
 export const EditorContextMenu = ({
   children,
+  projectPath,
   onNewFile,
   onNewFolder,
   onDelete,
+  onRename,
+  onCreateTask,
+  onSendMessage,
 }: EditorContextMenuProps): React.ReactElement => {
   const [target, setTarget] = useState<TargetEntry | null>(null);
   const triggerRef = useRef<HTMLDivElement>(null);
@@ -71,7 +90,7 @@ export const EditorContextMenu = ({
   return (
     <ContextMenu.Root>
       <ContextMenu.Trigger asChild>
-        <div ref={triggerRef} onContextMenu={handleContextMenu}>
+        <div ref={triggerRef} onContextMenu={handleContextMenu} className="h-full">
           {children}
         </div>
       </ContextMenu.Trigger>
@@ -102,6 +121,15 @@ export const EditorContextMenu = ({
 
           {target && (
             <>
+              <ContextMenu.Item
+                className="flex cursor-pointer items-center gap-2 rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised disabled:cursor-not-allowed disabled:opacity-50"
+                disabled={target.isSensitive}
+                onSelect={() => onRename(target.path)}
+              >
+                <Pencil className="size-3.5 text-text-muted" />
+                Rename
+              </ContextMenu.Item>
+
               <ContextMenu.Item
                 className="flex cursor-pointer items-center gap-2 rounded px-2 py-1.5 text-xs text-red-400 outline-none hover:bg-surface-raised focus:bg-surface-raised disabled:cursor-not-allowed disabled:opacity-50"
                 disabled={target.isSensitive}
@@ -116,15 +144,65 @@ export const EditorContextMenu = ({
           )}
 
           {target && (
-            <ContextMenu.Item
-              className="flex cursor-pointer items-center gap-2 rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised"
-              onSelect={() => {
-                void window.electronAPI.showInFolder(target.path);
-              }}
-            >
-              <FolderOpen className="size-3.5 text-text-muted" />
-              Reveal in Finder
-            </ContextMenu.Item>
+            <>
+              <ContextMenu.Item
+                className="flex cursor-pointer items-center gap-2 rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised"
+                onSelect={() => void navigator.clipboard.writeText(target.path)}
+              >
+                <ClipboardCopy className="size-3.5 text-text-muted" />
+                Copy Path
+              </ContextMenu.Item>
+
+              {projectPath && target.path.startsWith(projectPath) && (
+                <ContextMenu.Item
+                  className="flex cursor-pointer items-center gap-2 rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised"
+                  onSelect={() => {
+                    const relative = target.path.slice(projectPath.length + 1);
+                    void navigator.clipboard.writeText(relative);
+                  }}
+                >
+                  <ClipboardCopy className="size-3.5 text-text-muted" />
+                  Copy Relative Path
+                </ContextMenu.Item>
+              )}
+
+              <ContextMenu.Separator className="my-1 h-px bg-border" />
+
+              <ContextMenu.Item
+                className="flex cursor-pointer items-center gap-2 rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised"
+                onSelect={() => {
+                  void window.electronAPI.showInFolder(target.path);
+                }}
+              >
+                <FolderOpen className="size-3.5 text-text-muted" />
+                Reveal in Finder
+              </ContextMenu.Item>
+            </>
+          )}
+
+          {/* Team actions — file only */}
+          {target && !target.isDir && (onCreateTask || onSendMessage) && (
+            <>
+              <ContextMenu.Separator className="my-1 h-px bg-border" />
+              {onSendMessage && (
+                <ContextMenu.Item
+                  className="flex cursor-pointer items-center gap-2 rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised"
+                  onSelect={() => onSendMessage(target.path)}
+                >
+                  <MessageSquare className="size-3.5 text-text-muted" />
+                  Write Teammate
+                </ContextMenu.Item>
+              )}
+              {onCreateTask && (
+                <ContextMenu.Item
+                  className="flex cursor-pointer items-center gap-2 rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised"
+                  onSelect={() => onCreateTask(target.path)}
+                >
+                  <ListTodo className="size-3.5 text-text-muted" />
+                  Create Task
+                </ContextMenu.Item>
+              )}
+            </>
           )}
         </ContextMenu.Content>
       </ContextMenu.Portal>
diff --git a/src/renderer/components/team/editor/EditorErrorState.tsx b/src/renderer/components/team/editor/EditorErrorState.tsx
index 9896e1b7..c0b64d2b 100644
--- a/src/renderer/components/team/editor/EditorErrorState.tsx
+++ b/src/renderer/components/team/editor/EditorErrorState.tsx
@@ -2,6 +2,7 @@
  * Error state for file read failures (EACCES, ENOENT, etc.).
  */
 
+import { Button } from '@renderer/components/ui/button';
 import { AlertTriangle } from 'lucide-react';
 
 interface EditorErrorStateProps {
@@ -25,22 +26,14 @@ export const EditorErrorState = ({
       <p className="max-w-md text-center text-sm text-text-secondary">{error}</p>
       <div className="flex gap-2">
         {onRetry && (
-          <button
-            type="button"
-            onClick={onRetry}
-            className="rounded border border-border px-3 py-1.5 text-xs text-text-secondary transition-colors hover:bg-surface-raised"
-          >
+          <Button variant="outline" size="sm" onClick={onRetry}>
             Retry
-          </button>
+          </Button>
         )}
         {onClose && (
-          <button
-            type="button"
-            onClick={onClose}
-            className="rounded border border-border px-3 py-1.5 text-xs text-text-secondary transition-colors hover:bg-surface-raised"
-          >
+          <Button variant="outline" size="sm" onClick={onClose}>
             Close Tab
-          </button>
+          </Button>
         )}
       </div>
     </div>
diff --git a/src/renderer/components/team/editor/EditorFileTree.tsx b/src/renderer/components/team/editor/EditorFileTree.tsx
index 6beae5d1..7ec14c4f 100644
--- a/src/renderer/components/team/editor/EditorFileTree.tsx
+++ b/src/renderer/components/team/editor/EditorFileTree.tsx
@@ -16,13 +16,23 @@ import {
   useSensor,
   useSensors,
 } from '@dnd-kit/core';
+import { Button } from '@renderer/components/ui/button';
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from '@renderer/components/ui/dialog';
 import { useStore } from '@renderer/store';
 import { sortTreeNodes } from '@renderer/utils/fileTreeBuilder';
 import { useVirtualizer } from '@tanstack/react-virtual';
 import { ChevronDown, ChevronRight, Folder, FolderOpen, Lock } from 'lucide-react';
+import { useShallow } from 'zustand/react/shallow';
 
 import { EditorContextMenu } from './EditorContextMenu';
-import { getFileIcon } from './fileIcons';
+import { FileIcon } from './FileIcon';
 import { GitStatusBadge } from './GitStatusBadge';
 import { NewFileDialog } from './NewFileDialog';
 
@@ -37,6 +47,10 @@ import type { FileTreeEntry, GitFileStatusType } from '@shared/types/editor';
 interface EditorFileTreeProps {
   selectedFilePath: string | null;
   onFileSelect: (filePath: string) => void;
+  /** Trigger "Create Task" with a file mention from context menu */
+  onCreateTask?: (filePath: string) => void;
+  /** Trigger "Write Teammate" with a file mention from context menu */
+  onSendMessage?: (filePath: string) => void;
 }
 
 interface NewItemState {
@@ -64,30 +78,58 @@ const AUTO_EXPAND_DELAY_MS = 500;
 // Component
 // =============================================================================
 
+// Render counter for debugging — tracks how often the tree re-renders
+let fileTreeRenderCount = 0;
+
 export const EditorFileTree = ({
   selectedFilePath,
   onFileSelect,
+  onCreateTask,
+  onSendMessage,
 }: EditorFileTreeProps): React.ReactElement => {
-  const fileTree = useStore((s) => s.editorFileTree);
-  const expandedDirs = useStore((s) => s.editorExpandedDirs);
+  fileTreeRenderCount++;
+  if (fileTreeRenderCount % 5 === 0) {
+    console.debug(`[perf] EditorFileTree render #${fileTreeRenderCount}`);
+  }
+  // Data selectors — grouped with useShallow to prevent unnecessary re-renders
+  const { fileTree, expandedDirs, loading, error, gitFiles, projectPath } = useStore(
+    useShallow((s) => ({
+      fileTree: s.editorFileTree,
+      expandedDirs: s.editorExpandedDirs,
+      loading: s.editorFileTreeLoading,
+      error: s.editorFileTreeError,
+      gitFiles: s.editorGitFiles,
+      projectPath: s.editorProjectPath,
+    }))
+  );
+
+  // Actions — stable references in Zustand, no grouping needed
   const expandDirectory = useStore((s) => s.expandDirectory);
   const collapseDirectory = useStore((s) => s.collapseDirectory);
-  const loading = useStore((s) => s.editorFileTreeLoading);
-  const error = useStore((s) => s.editorFileTreeError);
   const createFileInTree = useStore((s) => s.createFileInTree);
   const createDirInTree = useStore((s) => s.createDirInTree);
   const deleteFileFromTree = useStore((s) => s.deleteFileFromTree);
   const moveFileInTree = useStore((s) => s.moveFileInTree);
+  const renameFileInTree = useStore((s) => s.renameFileInTree);
   const openFile = useStore((s) => s.openFile);
-  const gitFiles = useStore((s) => s.editorGitFiles);
-  const projectPath = useStore((s) => s.editorProjectPath);
 
   const [newItemState, setNewItemState] = useState<NewItemState | null>(null);
+  const [renamingPath, setRenamingPath] = useState<string | null>(null);
+  const [deleteConfirmPath, setDeleteConfirmPath] = useState<string | null>(null);
   const [draggedItem, setDraggedItem] = useState<FlatTreeItem | null>(null);
   const [dropTargetPath, setDropTargetPath] = useState<string | null>(null);
   const autoExpandTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const scrollRef = useRef<HTMLDivElement>(null);
 
+  // Defer DnD initialization — mount tree without drag/drop first, enable after idle
+  const [dndReady, setDndReady] = useState(false);
+  useEffect(() => {
+    const id = requestAnimationFrame(() => {
+      requestAnimationFrame(() => setDndReady(true));
+    });
+    return () => cancelAnimationFrame(id);
+  }, []);
+
   // Cleanup auto-expand timer on unmount
   useEffect(() => {
     return () => {
@@ -101,14 +143,21 @@ export const EditorFileTree = ({
   // Convert hierarchical FileTreeEntry[] → TreeNode[] (respects entry.type)
   const treeNodes = useMemo(() => {
     if (!fileTree) return [];
-    return sortTreeNodes(convertEntriesToNodes(fileTree));
+    const t0 = performance.now();
+    const nodes = sortTreeNodes(convertEntriesToNodes(fileTree));
+    const ms = performance.now() - t0;
+    if (ms > 2) console.debug(`[perf] treeNodes: ${ms.toFixed(1)}ms, nodes=${nodes.length}`);
+    return nodes;
   }, [fileTree]);
 
   // Flatten tree into visible items list for virtualization
   // expandedDirs is keyed by absolute path, and node.fullPath = entry.path (absolute)
   const flatItems = useMemo(() => {
+    const t0 = performance.now();
     const items: FlatTreeItem[] = [];
     flattenVisible(treeNodes, expandedDirs, items, 0);
+    const ms = performance.now() - t0;
+    if (ms > 2) console.debug(`[perf] flatItems: ${ms.toFixed(1)}ms, items=${items.length}`);
     return items;
   }, [treeNodes, expandedDirs]);
 
@@ -121,16 +170,42 @@ export const EditorFileTree = ({
     return map;
   }, [flatItems]);
 
-  // Virtual scrolling — increase overscan during drag for more drop targets
+  // Compute insertion index for inline new-item input
+  const newItemInsert = useMemo(() => {
+    if (!newItemState) return null;
+    const { parentDir } = newItemState;
+
+    const parentIdx = flatItems.findIndex((fi) => fi.node.fullPath === parentDir);
+
+    if (parentIdx === -1) {
+      // parentDir is the project root (not a node in flatItems) — insert at top
+      return { index: 0, depth: 0 };
+    }
+
+    // Insert right after the parent directory node (top of its children)
+    return { index: parentIdx + 1, depth: flatItems[parentIdx].depth + 1 };
+  }, [newItemState, flatItems]);
+
+  // Virtual scrolling — reduced overscan during initial mount, increase during drag
   const virtualizer = useVirtualizer({
-    count: flatItems.length,
+    count: flatItems.length + (newItemInsert ? 1 : 0),
     getScrollElement: () => scrollRef.current,
     estimateSize: () => ITEM_HEIGHT,
-    overscan: draggedItem ? 20 : 10,
+    overscan: !dndReady ? 3 : draggedItem ? 20 : 10,
   });
 
+  // Scroll to file when selectedFilePath changes (e.g. from revealFileInEditor)
+  useEffect(() => {
+    if (!selectedFilePath) return;
+    const idx = flatItems.findIndex((fi) => fi.node.fullPath === selectedFilePath);
+    if (idx >= 0) {
+      virtualizer.scrollToIndex(idx, { align: 'center' });
+    }
+  }, [selectedFilePath, flatItems, virtualizer]);
+
   // Git status lookup: absolute path → status type
   const gitStatusMap = useMemo(() => {
+    const t0 = performance.now();
     const map = new Map<string, GitFileStatusType>();
     if (!gitFiles.length || !projectPath) return map;
     for (const file of gitFiles) {
@@ -139,6 +214,8 @@ export const EditorFileTree = ({
         : `${projectPath}/${file.path}`;
       map.set(absPath, file.status);
     }
+    const ms = performance.now() - t0;
+    if (ms > 2) console.debug(`[perf] gitStatusMap: ${ms.toFixed(1)}ms, files=${gitFiles.length}`);
     return map;
   }, [gitFiles, projectPath]);
 
@@ -163,25 +240,58 @@ export const EditorFileTree = ({
     [onFileSelect, expandedDirs, expandDirectory, collapseDirectory]
   );
 
-  // Context menu handlers
-  const handleNewFile = useCallback((parentDir: string) => {
-    setNewItemState({ parentDir, type: 'file' });
-  }, []);
-
-  const handleNewFolder = useCallback((parentDir: string) => {
-    setNewItemState({ parentDir, type: 'directory' });
-  }, []);
-
-  const handleDelete = useCallback(
-    async (path: string) => {
-      const fileName = path.split('/').pop() ?? path;
-      const confirmed = window.confirm(`Move "${fileName}" to Trash?`);
-      if (!confirmed) return;
-      await deleteFileFromTree(path);
+  // Context menu handlers — expand parent directory so the input appears inline
+  const handleNewFile = useCallback(
+    (parentDir: string) => {
+      if (parentDir !== projectPath && !expandedDirs[parentDir]) {
+        void expandDirectory(parentDir);
+      }
+      setNewItemState({ parentDir, type: 'file' });
     },
-    [deleteFileFromTree]
+    [projectPath, expandedDirs, expandDirectory]
   );
 
+  const handleNewFolder = useCallback(
+    (parentDir: string) => {
+      if (parentDir !== projectPath && !expandedDirs[parentDir]) {
+        void expandDirectory(parentDir);
+      }
+      setNewItemState({ parentDir, type: 'directory' });
+    },
+    [projectPath, expandedDirs, expandDirectory]
+  );
+
+  const handleDelete = useCallback((path: string) => {
+    setDeleteConfirmPath(path);
+  }, []);
+
+  const handleConfirmDelete = useCallback(async () => {
+    if (!deleteConfirmPath) return;
+    await deleteFileFromTree(deleteConfirmPath);
+    setDeleteConfirmPath(null);
+  }, [deleteConfirmPath, deleteFileFromTree]);
+
+  const handleCancelDelete = useCallback(() => {
+    setDeleteConfirmPath(null);
+  }, []);
+
+  const handleRename = useCallback((path: string) => {
+    setRenamingPath(path);
+  }, []);
+
+  const handleRenameSubmit = useCallback(
+    async (newName: string) => {
+      if (!renamingPath) return;
+      await renameFileInTree(renamingPath, newName);
+      setRenamingPath(null);
+    },
+    [renamingPath, renameFileInTree]
+  );
+
+  const handleRenameCancel = useCallback(() => {
+    setRenamingPath(null);
+  }, []);
+
   const handleNewItemSubmit = useCallback(
     async (name: string) => {
       if (!newItemState) return;
@@ -332,9 +442,13 @@ export const EditorFileTree = ({
 
   return (
     <EditorContextMenu
+      projectPath={projectPath}
       onNewFile={handleNewFile}
       onNewFolder={handleNewFolder}
       onDelete={handleDelete}
+      onRename={handleRename}
+      onCreateTask={onCreateTask}
+      onSendMessage={onSendMessage}
     >
       <DndContext
         sensors={sensors}
@@ -344,7 +458,11 @@ export const EditorFileTree = ({
         onDragCancel={handleDragCancel}
         autoScroll={{ threshold: { x: 0, y: 0.15 } }}
       >
-        <RootDropZone ref={scrollRef} projectPath={projectPath}>
+        <RootDropZone
+          ref={scrollRef}
+          projectPath={projectPath}
+          isDropTarget={dropTargetPath === projectPath}
+        >
           <div
             style={{
               height: `${virtualizer.getTotalSize()}px`,
@@ -353,41 +471,91 @@ export const EditorFileTree = ({
             }}
           >
             {virtualizer.getVirtualItems().map((virtualItem) => {
-              const item = flatItems[virtualItem.index];
+              const { index } = virtualItem;
+
+              // Render inline new-item input at the correct tree position
+              if (index === newItemInsert?.index) {
+                return (
+                  <div
+                    key="__new-item-input__"
+                    style={{
+                      position: 'absolute',
+                      top: `${virtualItem.start}px`,
+                      left: 0,
+                      width: '100%',
+                      height: `${virtualItem.size}px`,
+                      paddingLeft: `${Math.min(newItemInsert.depth, MAX_DEPTH) * INDENT_PX}px`,
+                    }}
+                  >
+                    <NewFileDialog
+                      type={newItemState!.type}
+                      parentDir={newItemState!.parentDir}
+                      onSubmit={handleNewItemSubmit}
+                      onCancel={handleNewItemCancel}
+                    />
+                  </div>
+                );
+              }
+
+              // Adjust index for items after the insertion point
+              const flatIdx = newItemInsert && index > newItemInsert.index ? index - 1 : index;
+              const item = flatItems[flatIdx];
+
               return (
-                <DraggableTreeItem
+                <div
                   key={item.node.fullPath}
-                  item={item}
-                  activeNodePath={activeNodePath}
-                  gitStatusMap={gitStatusMap}
-                  dropTargetPath={dropTargetPath}
-                  isDragActive={!!draggedItem}
-                  onClick={handleNodeClick}
                   style={{
                     position: 'absolute',
-                    top: 0,
+                    top: `${virtualItem.start}px`,
                     left: 0,
                     width: '100%',
                     height: `${virtualItem.size}px`,
-                    transform: `translateY(${virtualItem.start}px)`,
                   }}
-                />
+                >
+                  <DraggableTreeItem
+                    item={item}
+                    activeNodePath={activeNodePath}
+                    gitStatus={gitStatusMap.get(item.node.fullPath)}
+                    dropTargetPath={dropTargetPath}
+                    isDragActive={!!draggedItem}
+                    onClick={handleNodeClick}
+                    isRenaming={renamingPath === item.node.fullPath}
+                    onRenameSubmit={handleRenameSubmit}
+                    onRenameCancel={handleRenameCancel}
+                  />
+                </div>
               );
             })}
           </div>
+          {/* Spacer at bottom — drop here to move to project root */}
+          {draggedItem && (
+            <div className="h-16 w-full shrink-0" aria-label="Drop here for project root" />
+          )}
         </RootDropZone>
         <DragOverlay dropAnimation={null}>
           {draggedItem && <DragOverlayFileItem item={draggedItem} />}
         </DragOverlay>
       </DndContext>
-      {newItemState && (
-        <NewFileDialog
-          type={newItemState.type}
-          parentDir={newItemState.parentDir}
-          onSubmit={handleNewItemSubmit}
-          onCancel={handleNewItemCancel}
-        />
-      )}
+
+      {/* Delete confirmation dialog */}
+      <Dialog open={!!deleteConfirmPath} onOpenChange={(open) => !open && handleCancelDelete()}>
+        <DialogContent className="w-96 max-w-96">
+          <DialogHeader>
+            <DialogTitle className="text-sm">Move to Trash</DialogTitle>
+            <DialogDescription>
+              Move &ldquo;{deleteConfirmPath?.split('/').pop() ?? ''}&rdquo; to Trash?
+            </DialogDescription>
+          </DialogHeader>
+          <DialogFooter>
+            <Button variant="ghost" size="sm" onClick={handleCancelDelete}>
+              Cancel
+            </Button>
+            <Button variant="destructive" size="sm" onClick={() => void handleConfirmDelete()}>
+              Move to Trash
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
     </EditorContextMenu>
   );
 };
@@ -398,8 +566,8 @@ export const EditorFileTree = ({
 
 const RootDropZone = React.forwardRef<
   HTMLDivElement,
-  { projectPath: string | null; children: React.ReactNode }
->(({ projectPath, children }, ref) => {
+  { projectPath: string | null; isDropTarget: boolean; children: React.ReactNode }
+>(({ projectPath, isDropTarget, children }, ref) => {
   const { setNodeRef } = useDroppable({
     id: 'root-drop-zone',
     data: { isRoot: true, path: projectPath },
@@ -417,7 +585,13 @@ const RootDropZone = React.forwardRef<
   );
 
   return (
-    <div ref={combinedRef} className="h-full overflow-y-auto" role="tree">
+    <div
+      ref={combinedRef}
+      className={`scrollbar-thin h-full overflow-y-auto transition-colors ${
+        isDropTarget ? 'bg-blue-400/5 ring-1 ring-inset ring-blue-400/30' : ''
+      }`}
+      role="tree"
+    >
       {children}
     </div>
   );
@@ -432,11 +606,13 @@ RootDropZone.displayName = 'RootDropZone';
 interface DraggableTreeItemProps {
   item: FlatTreeItem;
   activeNodePath: string | null;
-  gitStatusMap: Map<string, GitFileStatusType>;
+  gitStatus?: GitFileStatusType;
   dropTargetPath: string | null;
   isDragActive: boolean;
   onClick: (node: TreeNode<FileTreeEntry>) => void;
-  style: React.CSSProperties;
+  isRenaming?: boolean;
+  onRenameSubmit?: (newName: string) => void;
+  onRenameCancel?: () => void;
 }
 
 /* eslint-disable react/jsx-props-no-spreading -- dnd-kit requires prop spreading for drag attributes, listeners, and data attributes */
@@ -444,11 +620,13 @@ const DraggableTreeItem = React.memo(
   ({
     item,
     activeNodePath,
-    gitStatusMap,
+    gitStatus,
     dropTargetPath,
     isDragActive,
     onClick,
-    style,
+    isRenaming,
+    onRenameSubmit,
+    onRenameCancel,
   }: DraggableTreeItemProps): React.ReactElement => {
     const { node, depth, isExpanded } = item;
     const isSelected = activeNodePath === node.fullPath;
@@ -483,8 +661,10 @@ const DraggableTreeItem = React.memo(
       [setDragRef, setDropRef, node.isFile]
     );
 
-    // Visual: highlight drop target directory
+    // Visual: highlight drop target directory and its visible children
     const isDropTarget = !node.isFile && dropTargetPath === node.fullPath;
+    const isInsideDropTarget =
+      dropTargetPath != null && node.fullPath.startsWith(dropTargetPath + '/');
 
     const dataAttrs: Record<string, string> = {};
     if (node.data) {
@@ -508,9 +688,7 @@ const DraggableTreeItem = React.memo(
     if (node.data?.isSensitive) {
       icon = <Lock className="size-3.5 shrink-0 text-yellow-500" />;
     } else if (node.isFile) {
-      const fileIcon = getFileIcon(node.name);
-      const FileIcon = fileIcon.icon;
-      icon = <FileIcon className="size-3.5 shrink-0" style={{ color: fileIcon.color }} />;
+      icon = <FileIcon fileName={node.name} className="size-3.5" />;
     } else if (isExpanded) {
       icon = <FolderOpen className="size-3.5 shrink-0 text-text-muted" />;
     } else {
@@ -525,17 +703,12 @@ const DraggableTreeItem = React.memo(
         role="treeitem"
         aria-selected={node.isFile ? isSelected : undefined}
         aria-expanded={!node.isFile ? isExpanded : undefined}
-        className={`flex cursor-pointer select-none items-center gap-1 truncate px-2 text-xs transition-colors hover:bg-surface-raised ${
+        className={`flex h-full cursor-pointer select-none items-center gap-1 truncate px-2 text-xs transition-colors hover:bg-surface-raised ${
           isSelected ? 'bg-surface-raised text-text' : 'text-text-secondary'
         } ${isDragging ? 'opacity-30' : ''} ${
           isDropTarget ? 'rounded bg-blue-400/10 ring-2 ring-blue-400/50' : ''
-        }`}
-        style={{
-          ...style,
-          paddingLeft: `${visualDepth * INDENT_PX + 8}px`,
-          display: 'flex',
-          alignItems: 'center',
-        }}
+        } ${isInsideDropTarget && !isDropTarget ? 'border-l-2 border-l-blue-400/40 bg-blue-400/5' : ''}`}
+        style={{ paddingLeft: `${visualDepth * INDENT_PX + 8}px` }}
         onClick={handleClick}
         onKeyDown={handleKeyDown}
         tabIndex={0}
@@ -549,10 +722,16 @@ const DraggableTreeItem = React.memo(
             <ChevronRight className="size-3 shrink-0 text-text-muted" />
           ))}
         {icon}
-        <span className="truncate">{node.name}</span>
-        {node.data && gitStatusMap.has(node.data.path) && (
-          <GitStatusBadge status={gitStatusMap.get(node.data.path)!} />
+        {isRenaming ? (
+          <InlineRenameInput
+            initialName={node.name}
+            onSubmit={onRenameSubmit!}
+            onCancel={onRenameCancel!}
+          />
+        ) : (
+          <span className="truncate">{node.name}</span>
         )}
+        {!isRenaming && gitStatus && <GitStatusBadge status={gitStatus} />}
       </div>
     );
   }
@@ -570,9 +749,7 @@ const DragOverlayFileItem = ({ item }: { item: FlatTreeItem }): React.ReactEleme
 
   let icon: React.ReactNode;
   if (node.isFile) {
-    const fileIcon = getFileIcon(node.name);
-    const FileIcon = fileIcon.icon;
-    icon = <FileIcon className="size-3.5" style={{ color: fileIcon.color }} />;
+    icon = <FileIcon fileName={node.name} className="size-3.5" />;
   } else {
     icon = <FolderOpen className="size-3.5 text-text-muted" />;
   }
@@ -585,6 +762,89 @@ const DragOverlayFileItem = ({ item }: { item: FlatTreeItem }): React.ReactEleme
   );
 };
 
+// =============================================================================
+// Inline rename input
+// =============================================================================
+
+const InlineRenameInput = ({
+  initialName,
+  onSubmit,
+  onCancel,
+}: {
+  initialName: string;
+  onSubmit: (newName: string) => void;
+  onCancel: () => void;
+}): React.ReactElement => {
+  const [value, setValue] = useState(initialName);
+  const submitted = useRef(false);
+  const inputRef = useRef<HTMLInputElement>(null);
+
+  // Focus + select on mount (delayed to survive Radix/DnD focus interference)
+  useEffect(() => {
+    const timer = setTimeout(() => {
+      const input = inputRef.current;
+      if (!input) return;
+      input.focus();
+      const dotIdx = initialName.lastIndexOf('.');
+      if (dotIdx > 0) {
+        input.setSelectionRange(0, dotIdx);
+      } else {
+        input.select();
+      }
+    }, 100);
+    return () => clearTimeout(timer);
+  }, [initialName]);
+
+  // Click-outside → submit (replaces unreliable onBlur)
+  useEffect(() => {
+    const handlePointerDown = (e: PointerEvent): void => {
+      if (inputRef.current && !inputRef.current.contains(e.target as Node)) {
+        doSubmit();
+      }
+    };
+    const timer = setTimeout(() => {
+      document.addEventListener('pointerdown', handlePointerDown, true);
+    }, 150);
+    return () => {
+      clearTimeout(timer);
+      document.removeEventListener('pointerdown', handlePointerDown, true);
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- doSubmit reads value via ref pattern
+  }, []);
+
+  const doSubmit = (): void => {
+    if (submitted.current) return;
+    submitted.current = true;
+    const trimmed = inputRef.current?.value.trim() ?? '';
+    if (trimmed && trimmed !== initialName) {
+      onSubmit(trimmed);
+    } else {
+      onCancel();
+    }
+  };
+
+  return (
+    <input
+      ref={inputRef}
+      value={value}
+      onChange={(e) => setValue(e.target.value)}
+      onKeyDown={(e) => {
+        if (e.key === 'Enter') {
+          e.preventDefault();
+          doSubmit();
+        } else if (e.key === 'Escape') {
+          e.preventDefault();
+          onCancel();
+        }
+        e.stopPropagation();
+      }}
+      onBlur={() => requestAnimationFrame(() => inputRef.current?.focus())}
+      onClick={(e) => e.stopPropagation()}
+      className="min-w-0 flex-1 rounded border border-blue-400/50 bg-surface px-1 py-0 text-xs text-text outline-none focus:ring-1 focus:ring-blue-400/50"
+    />
+  );
+};
+
 // =============================================================================
 // Helpers
 // =============================================================================
diff --git a/src/renderer/components/team/editor/EditorImagePreview.tsx b/src/renderer/components/team/editor/EditorImagePreview.tsx
new file mode 100644
index 00000000..eff4b230
--- /dev/null
+++ b/src/renderer/components/team/editor/EditorImagePreview.tsx
@@ -0,0 +1,137 @@
+/**
+ * Inline image preview for the project editor.
+ *
+ * Loads binary file as base64 data URL via IPC, displays centered image
+ * with checkerboard background for transparency, metadata, and lightbox on click.
+ */
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+
+import { ImageLightbox } from '@renderer/components/team/attachments/ImageLightbox';
+import { Button } from '@renderer/components/ui/button';
+import { useStore } from '@renderer/store';
+import { Loader2 } from 'lucide-react';
+
+import { EditorBinaryPlaceholder } from './EditorBinaryPlaceholder';
+
+interface EditorImagePreviewProps {
+  filePath: string;
+  fileName: string;
+  size: number;
+}
+
+export const EditorImagePreview = ({
+  filePath,
+  fileName,
+  size,
+}: EditorImagePreviewProps): React.ReactElement => {
+  const projectPath = useStore((s) => s.editorProjectPath);
+  const [dataUrl, setDataUrl] = useState<string | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  const [lightboxOpen, setLightboxOpen] = useState(false);
+  const [dimensions, setDimensions] = useState<{ w: number; h: number } | null>(null);
+  const imgRef = useRef<HTMLImageElement>(null);
+
+  // Reset state when filePath changes (setState-during-render, React-approved pattern)
+  const [prevFilePath, setPrevFilePath] = useState(filePath);
+  if (prevFilePath !== filePath) {
+    setPrevFilePath(filePath);
+    setLoading(true);
+    setError(null);
+    setDataUrl(null);
+    setDimensions(null);
+  }
+
+  useEffect(() => {
+    let cancelled = false;
+
+    window.electronAPI.editor
+      .readBinaryPreview(filePath)
+      .then((result) => {
+        if (cancelled) return;
+        setDataUrl(`data:${result.mimeType};base64,${result.base64}`);
+      })
+      .catch((err: Error) => {
+        if (cancelled) return;
+        setError(err.message);
+      })
+      .finally(() => {
+        if (!cancelled) setLoading(false);
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [filePath]);
+
+  const handleImageLoad = useCallback(() => {
+    const img = imgRef.current;
+    if (img) {
+      setDimensions({ w: img.naturalWidth, h: img.naturalHeight });
+    }
+  }, []);
+
+  const handleOpenExternal = useCallback((): void => {
+    window.electronAPI.openPath(filePath, projectPath ?? undefined).catch(console.error);
+  }, [filePath, projectPath]);
+
+  const sizeFormatted =
+    size < 1024
+      ? `${size} B`
+      : size < 1024 * 1024
+        ? `${(size / 1024).toFixed(1)} KB`
+        : `${(size / 1024 / 1024).toFixed(1)} MB`;
+
+  if (loading) {
+    return (
+      <div className="flex h-full flex-col items-center justify-center gap-3 text-text-muted">
+        <Loader2 className="size-8 animate-spin opacity-40" />
+        <p className="text-xs">Loading preview…</p>
+      </div>
+    );
+  }
+
+  if (error || !dataUrl) {
+    return <EditorBinaryPlaceholder filePath={filePath} fileName={fileName} size={size} />;
+  }
+
+  return (
+    <div className="flex h-full flex-col items-center justify-center gap-4 p-6">
+      <button
+        type="button"
+        className="checkerboard-bg flex max-h-[60vh] max-w-[80%] cursor-zoom-in items-center justify-center overflow-hidden rounded-lg border border-border-subtle p-1"
+        onClick={() => setLightboxOpen(true)}
+        aria-label="Open full-size preview"
+      >
+        <img
+          ref={imgRef}
+          src={dataUrl}
+          alt={fileName}
+          className="max-h-[60vh] object-contain"
+          onLoad={handleImageLoad}
+          draggable={false}
+        />
+      </button>
+
+      <p className="text-xs text-text-muted">
+        {fileName}
+        {dimensions ? ` — ${dimensions.w}×${dimensions.h}` : ''}
+        {` — ${sizeFormatted}`}
+      </p>
+
+      <div className="flex gap-2">
+        <Button variant="outline" size="sm" onClick={handleOpenExternal}>
+          Open in System Viewer
+        </Button>
+      </div>
+
+      <ImageLightbox
+        src={dataUrl}
+        alt={fileName}
+        open={lightboxOpen}
+        onClose={() => setLightboxOpen(false)}
+      />
+    </div>
+  );
+};
diff --git a/src/renderer/components/team/editor/EditorSearchPanel.tsx b/src/renderer/components/team/editor/EditorSearchPanel.tsx
new file mode 100644
index 00000000..4af3a3ab
--- /dev/null
+++ b/src/renderer/components/team/editor/EditorSearchPanel.tsx
@@ -0,0 +1,508 @@
+/**
+ * Custom CodeMirror search/replace panel using the project UI Kit.
+ *
+ * Replaces the default CodeMirror search panel with a styled version
+ * that uses our Input, Button, and Tooltip components for consistent
+ * design language across the app.
+ */
+
+import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+
+import {
+  closeSearchPanel,
+  findNext,
+  findPrevious,
+  getSearchQuery,
+  replaceAll,
+  replaceNext,
+  SearchQuery,
+  setSearchQuery,
+} from '@codemirror/search';
+import { EditorView, type Panel } from '@codemirror/view';
+import { Button } from '@renderer/components/ui/button';
+import { Input } from '@renderer/components/ui/input';
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from '@renderer/components/ui/tooltip';
+import { cn } from '@renderer/lib/utils';
+import {
+  ArrowDown,
+  ArrowUp,
+  CaseSensitive,
+  ChevronDown,
+  ChevronRight,
+  Regex,
+  WholeWord,
+  X,
+} from 'lucide-react';
+
+import type { EditorState } from '@codemirror/state';
+import type { ViewUpdate } from '@codemirror/view';
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+const MAX_MATCH_COUNT = 999;
+
+// =============================================================================
+// SearchToggleButton
+// =============================================================================
+
+interface SearchToggleButtonProps {
+  active: boolean;
+  onClick: () => void;
+  tooltip: string;
+  shortcut?: string;
+  children: React.ReactNode;
+}
+
+const SearchToggleButton = React.memo(function SearchToggleButton({
+  active,
+  onClick,
+  tooltip,
+  shortcut,
+  children,
+}: SearchToggleButtonProps) {
+  return (
+    <Tooltip>
+      <TooltipTrigger asChild>
+        <button
+          type="button"
+          className={cn(
+            'flex size-[22px] items-center justify-center rounded transition-colors',
+            active
+              ? 'bg-blue-500/20 text-blue-400'
+              : 'text-[var(--color-text-muted)] hover:bg-[var(--color-surface-raised)] hover:text-[var(--color-text-secondary)]'
+          )}
+          onClick={onClick}
+          tabIndex={-1}
+        >
+          {children}
+        </button>
+      </TooltipTrigger>
+      <TooltipContent side="bottom">
+        <span>{tooltip}</span>
+        {shortcut && <span className="ml-1.5 text-[var(--color-text-muted)]">{shortcut}</span>}
+      </TooltipContent>
+    </Tooltip>
+  );
+});
+
+// =============================================================================
+// Match counter
+// =============================================================================
+
+function countMatches(query: SearchQuery, state: EditorState): number {
+  if (!query.valid || !query.search) return 0;
+
+  try {
+    const cursor = query.getCursor(state);
+    let count = 0;
+    while (!cursor.next().done) {
+      count++;
+      if (count > MAX_MATCH_COUNT) return -1;
+    }
+    return count;
+  } catch {
+    return 0;
+  }
+}
+
+// =============================================================================
+// EditorSearchPanelContent
+// =============================================================================
+
+interface EditorSearchPanelContentProps {
+  view: EditorView;
+  initialSearch: string;
+  initialReplace: string;
+  initialCaseSensitive: boolean;
+  initialRegexp: boolean;
+  initialWholeWord: boolean;
+  registerUpdateNotifier: (cb: () => void) => void;
+}
+
+const EditorSearchPanelContent = ({
+  view,
+  initialSearch,
+  initialReplace,
+  initialCaseSensitive,
+  initialRegexp,
+  initialWholeWord,
+  registerUpdateNotifier,
+}: EditorSearchPanelContentProps) => {
+  const [searchText, setSearchText] = useState(initialSearch);
+  const [replaceText, setReplaceText] = useState(initialReplace);
+  const [caseSensitive, setCaseSensitive] = useState(initialCaseSensitive);
+  const [useRegexp, setUseRegexp] = useState(initialRegexp);
+  const [wholeWord, setWholeWord] = useState(initialWholeWord);
+  const [showReplace, setShowReplace] = useState(false);
+  const [updateTick, setUpdateTick] = useState(0);
+
+  const searchInputRef = useRef<HTMLInputElement>(null);
+
+  // Focus search input on mount
+  useEffect(() => {
+    requestAnimationFrame(() => {
+      searchInputRef.current?.focus();
+      searchInputRef.current?.select();
+    });
+  }, []);
+
+  // Build query object (memoized)
+  const query = useMemo(
+    () =>
+      new SearchQuery({
+        search: searchText,
+        replace: replaceText,
+        caseSensitive,
+        regexp: useRegexp,
+        wholeWord,
+      }),
+    [searchText, replaceText, caseSensitive, useRegexp, wholeWord]
+  );
+
+  // Dispatch search query to CodeMirror for highlighting
+  useEffect(() => {
+    view.dispatch({ effects: setSearchQuery.of(query) });
+  }, [query, view]);
+
+  // Register for editor updates (doc changes → recount via updateTick)
+  useEffect(() => {
+    registerUpdateNotifier(() => setUpdateTick((t) => t + 1));
+  }, [registerUpdateNotifier]);
+
+  // Match count — derived from query + document state
+  // updateTick triggers recount on document changes (e.g. after replace)
+  const matchCount = useMemo(
+    () => countMatches(query, view.state),
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- updateTick is a proxy dep for view.state changes
+    [query, view, updateTick]
+  );
+
+  // Navigation
+  const handleFindNext = useCallback(() => {
+    findNext(view);
+  }, [view]);
+
+  const handleFindPrev = useCallback(() => {
+    findPrevious(view);
+  }, [view]);
+
+  // Replace
+  const handleReplaceNext = useCallback(() => {
+    replaceNext(view);
+  }, [view]);
+
+  const handleReplaceAll = useCallback(() => {
+    replaceAll(view);
+  }, [view]);
+
+  // Close
+  const handleClose = useCallback(() => {
+    closeSearchPanel(view);
+    view.focus();
+  }, [view]);
+
+  // Keyboard handlers
+  const handleSearchKeyDown = useCallback(
+    (e: React.KeyboardEvent) => {
+      if (e.key === 'Escape') {
+        e.preventDefault();
+        handleClose();
+      } else if (e.key === 'Enter') {
+        e.preventDefault();
+        if (e.shiftKey) {
+          findPrevious(view);
+        } else {
+          findNext(view);
+        }
+      }
+    },
+    [view, handleClose]
+  );
+
+  const handleReplaceKeyDown = useCallback(
+    (e: React.KeyboardEvent) => {
+      if (e.key === 'Escape') {
+        e.preventDefault();
+        handleClose();
+      } else if (e.key === 'Enter') {
+        e.preventDefault();
+        handleReplaceNext();
+      }
+    },
+    [handleClose, handleReplaceNext]
+  );
+
+  // Match count display
+  const matchCountText = searchText
+    ? matchCount === -1
+      ? `${MAX_MATCH_COUNT}+`
+      : matchCount === 0
+        ? 'No results'
+        : `${matchCount} found`
+    : '';
+
+  return (
+    <TooltipProvider delayDuration={400}>
+      <div className="flex flex-col gap-1 px-2 py-1.5">
+        {/* Search row */}
+        <div className="flex items-center gap-1">
+          {/* Toggle replace visibility */}
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <button
+                type="button"
+                className="flex h-[22px] w-5 items-center justify-center rounded text-[var(--color-text-muted)] transition-colors hover:text-[var(--color-text-secondary)]"
+                onClick={() => setShowReplace((prev) => !prev)}
+                tabIndex={-1}
+              >
+                {showReplace ? (
+                  <ChevronDown className="size-3.5" />
+                ) : (
+                  <ChevronRight className="size-3.5" />
+                )}
+              </button>
+            </TooltipTrigger>
+            <TooltipContent side="bottom">Toggle Replace</TooltipContent>
+          </Tooltip>
+
+          {/* Search input */}
+          <Input
+            ref={searchInputRef}
+            className="h-[26px] min-w-[180px] flex-1 rounded border-[var(--color-border)] bg-[var(--color-surface)] px-2 text-xs"
+            placeholder="Search"
+            value={searchText}
+            onChange={(e) => setSearchText(e.target.value)}
+            onKeyDown={handleSearchKeyDown}
+            spellCheck={false}
+          />
+
+          {/* Toggle buttons */}
+          <SearchToggleButton
+            active={caseSensitive}
+            onClick={() => setCaseSensitive((prev) => !prev)}
+            tooltip="Match Case"
+          >
+            <CaseSensitive className="size-[14px]" />
+          </SearchToggleButton>
+
+          <SearchToggleButton
+            active={wholeWord}
+            onClick={() => setWholeWord((prev) => !prev)}
+            tooltip="Match Whole Word"
+          >
+            <WholeWord className="size-[14px]" />
+          </SearchToggleButton>
+
+          <SearchToggleButton
+            active={useRegexp}
+            onClick={() => setUseRegexp((prev) => !prev)}
+            tooltip="Use Regular Expression"
+          >
+            <Regex className="size-[14px]" />
+          </SearchToggleButton>
+
+          {/* Separator */}
+          <div className="mx-0.5 h-4 w-px bg-[var(--color-border)]" />
+
+          {/* Match count */}
+          {matchCountText && (
+            <span
+              className={cn(
+                'min-w-[60px] whitespace-nowrap text-center text-xs tabular-nums',
+                matchCount === 0 && searchText ? 'text-red-400' : 'text-[var(--color-text-muted)]'
+              )}
+            >
+              {matchCountText}
+            </span>
+          )}
+
+          {/* Navigation */}
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <Button
+                variant="ghost"
+                size="icon"
+                className="size-[22px] text-[var(--color-text-muted)] hover:text-[var(--color-text)]"
+                onClick={handleFindPrev}
+                disabled={matchCount === 0}
+                tabIndex={-1}
+              >
+                <ArrowUp className="size-3.5" />
+              </Button>
+            </TooltipTrigger>
+            <TooltipContent side="bottom">
+              Previous Match <span className="text-[var(--color-text-muted)]">⇧Enter</span>
+            </TooltipContent>
+          </Tooltip>
+
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <Button
+                variant="ghost"
+                size="icon"
+                className="size-[22px] text-[var(--color-text-muted)] hover:text-[var(--color-text)]"
+                onClick={handleFindNext}
+                disabled={matchCount === 0}
+                tabIndex={-1}
+              >
+                <ArrowDown className="size-3.5" />
+              </Button>
+            </TooltipTrigger>
+            <TooltipContent side="bottom">
+              Next Match <span className="text-[var(--color-text-muted)]">Enter</span>
+            </TooltipContent>
+          </Tooltip>
+
+          {/* Close */}
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <Button
+                variant="ghost"
+                size="icon"
+                className="size-[22px] text-[var(--color-text-muted)] hover:text-[var(--color-text)]"
+                onClick={handleClose}
+                tabIndex={-1}
+              >
+                <X className="size-3.5" />
+              </Button>
+            </TooltipTrigger>
+            <TooltipContent side="bottom">
+              Close <span className="text-[var(--color-text-muted)]">Esc</span>
+            </TooltipContent>
+          </Tooltip>
+        </div>
+
+        {/* Replace row */}
+        {showReplace && (
+          <div className="flex items-center gap-1">
+            {/* Spacer to align with search input */}
+            <div className="w-5 shrink-0" />
+
+            <Input
+              className="h-[26px] min-w-[180px] flex-1 rounded border-[var(--color-border)] bg-[var(--color-surface)] px-2 text-xs"
+              placeholder="Replace"
+              value={replaceText}
+              onChange={(e) => setReplaceText(e.target.value)}
+              onKeyDown={handleReplaceKeyDown}
+              spellCheck={false}
+            />
+
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <Button
+                  variant="ghost"
+                  size="sm"
+                  className="h-[22px] px-2 text-xs text-[var(--color-text-muted)] hover:text-[var(--color-text)]"
+                  onClick={handleReplaceNext}
+                  disabled={matchCount === 0}
+                  tabIndex={-1}
+                >
+                  Replace
+                </Button>
+              </TooltipTrigger>
+              <TooltipContent side="bottom">Replace Next</TooltipContent>
+            </Tooltip>
+
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <Button
+                  variant="ghost"
+                  size="sm"
+                  className="h-[22px] px-2 text-xs text-[var(--color-text-muted)] hover:text-[var(--color-text)]"
+                  onClick={handleReplaceAll}
+                  disabled={matchCount === 0}
+                  tabIndex={-1}
+                >
+                  All
+                </Button>
+              </TooltipTrigger>
+              <TooltipContent side="bottom">Replace All</TooltipContent>
+            </Tooltip>
+          </div>
+        )}
+      </div>
+    </TooltipProvider>
+  );
+};
+
+// =============================================================================
+// Panel factory for CodeMirror
+// =============================================================================
+
+export function createSearchPanel(view: EditorView): Panel {
+  const dom = document.createElement('div');
+
+  const root = createRoot(dom);
+
+  // Get initial values
+  const existingQuery = getSearchQuery(view.state);
+  const sel = view.state.selection.main;
+  const selText = sel.empty ? '' : view.state.sliceDoc(sel.from, sel.to);
+  const initialSearch = selText && !selText.includes('\n') ? selText : existingQuery.search;
+
+  // Mutable ref for update notifications from CodeMirror
+  let notifyUpdate: (() => void) | null = null;
+
+  root.render(
+    <EditorSearchPanelContent
+      view={view}
+      initialSearch={initialSearch}
+      initialReplace={existingQuery.replace}
+      initialCaseSensitive={existingQuery.caseSensitive}
+      initialRegexp={existingQuery.regexp}
+      initialWholeWord={existingQuery.wholeWord}
+      registerUpdateNotifier={(cb) => {
+        notifyUpdate = cb;
+      }}
+    />
+  );
+
+  return {
+    dom,
+    top: true,
+    update(update: ViewUpdate) {
+      if (update.docChanged) {
+        notifyUpdate?.();
+      }
+    },
+    destroy() {
+      notifyUpdate = null;
+      root.unmount();
+    },
+  };
+}
+
+// =============================================================================
+// Theme: panel container + search match highlighting
+// =============================================================================
+
+export const editorSearchPanelTheme = EditorView.theme({
+  '.cm-panels': {
+    backgroundColor: 'var(--color-surface)',
+    color: 'var(--color-text)',
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+  },
+  '.cm-panels-top': {
+    borderBottom: '1px solid var(--color-border)',
+  },
+  '.cm-panels-bottom': {
+    borderTop: '1px solid var(--color-border)',
+  },
+  // Search match highlighting in editor content
+  '.cm-searchMatch': {
+    backgroundColor: 'var(--highlight-bg-inactive)',
+    borderRadius: '2px',
+  },
+  '.cm-searchMatch-selected': {
+    backgroundColor: 'var(--highlight-bg) !important',
+    borderRadius: '2px',
+  },
+});
diff --git a/src/renderer/components/team/editor/EditorSelectionMenu.tsx b/src/renderer/components/team/editor/EditorSelectionMenu.tsx
index 700ddf7a..ec2c05e9 100644
--- a/src/renderer/components/team/editor/EditorSelectionMenu.tsx
+++ b/src/renderer/components/team/editor/EditorSelectionMenu.tsx
@@ -5,6 +5,7 @@
  * Uses onMouseDown preventDefault to avoid deselecting text in CM6.
  */
 
+import { Button } from '@renderer/components/ui/button';
 import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { ListTodo, MessageSquare } from 'lucide-react';
 
@@ -92,16 +93,17 @@ interface MenuButtonProps {
 const MenuButton = ({ icon, label, onClick }: MenuButtonProps): React.ReactElement => (
   <Tooltip>
     <TooltipTrigger asChild>
-      <button
-        type="button"
+      <Button
+        variant="ghost"
+        size="icon"
         tabIndex={-1}
         aria-label={label}
         onClick={onClick}
         onMouseDown={(e) => e.preventDefault()} // prevent CM6 selection loss
-        className="rounded p-1.5 text-text-secondary transition-colors hover:bg-surface-raised hover:text-text"
+        className="size-7 p-1.5 text-text-secondary"
       >
         {icon}
-      </button>
+      </Button>
     </TooltipTrigger>
     <TooltipContent side="top" sideOffset={6}>
       {label}
diff --git a/src/renderer/components/team/editor/EditorShortcutsHelp.tsx b/src/renderer/components/team/editor/EditorShortcutsHelp.tsx
index 493d9168..eb79fa90 100644
--- a/src/renderer/components/team/editor/EditorShortcutsHelp.tsx
+++ b/src/renderer/components/team/editor/EditorShortcutsHelp.tsx
@@ -5,10 +5,10 @@
  * the appropriate modifier symbols.
  */
 
-import { useEffect, useMemo } from 'react';
+import { useMemo } from 'react';
 
+import { Dialog, DialogContent, DialogHeader, DialogTitle } from '@renderer/components/ui/dialog';
 import { IS_MAC } from '@renderer/utils/platformKeys';
-import { X } from 'lucide-react';
 
 // =============================================================================
 // Types
@@ -64,6 +64,13 @@ const SHORTCUT_GROUPS: { title: string; shortcuts: ShortcutDef[] }[] = [
       { mac: '⌘ /', other: 'Ctrl+/', description: 'Toggle Comment' },
     ],
   },
+  {
+    title: 'Markdown',
+    shortcuts: [
+      { mac: '⌘ ⇧ M', other: 'Ctrl+Shift+M', description: 'Split Preview' },
+      { mac: '⌘ ⇧ V', other: 'Ctrl+Shift+V', description: 'Full Preview' },
+    ],
+  },
   {
     title: 'General',
     shortcuts: [{ mac: 'Esc', other: 'Esc', description: 'Close Editor' }],
@@ -75,19 +82,6 @@ const SHORTCUT_GROUPS: { title: string; shortcuts: ShortcutDef[] }[] = [
 // =============================================================================
 
 export const EditorShortcutsHelp = ({ onClose }: EditorShortcutsHelpProps): React.ReactElement => {
-  // Escape closes help (capture phase)
-  useEffect(() => {
-    const handleKeyDown = (e: KeyboardEvent) => {
-      if (e.key === 'Escape') {
-        e.preventDefault();
-        e.stopPropagation();
-        onClose();
-      }
-    };
-    window.addEventListener('keydown', handleKeyDown, true);
-    return () => window.removeEventListener('keydown', handleKeyDown, true);
-  }, [onClose]);
-
   // Resolve platform-specific keys once
   const resolvedGroups = useMemo(
     () =>
@@ -102,29 +96,11 @@ export const EditorShortcutsHelp = ({ onClose }: EditorShortcutsHelpProps): Reac
   );
 
   return (
-    <div className="fixed inset-0 z-[60] flex items-center justify-center" role="presentation">
-      {/* Backdrop */}
-      <div className="fixed inset-0 bg-black/50" onClick={onClose} />
-
-      {/* Dialog */}
-      <div
-        role="dialog"
-        aria-modal="true"
-        aria-labelledby="shortcuts-dialog-title"
-        className="relative z-10 w-[480px] rounded-lg border border-border-emphasis bg-surface p-6 shadow-2xl"
-      >
-        <div className="mb-4 flex items-center justify-between">
-          <h2 id="shortcuts-dialog-title" className="text-sm font-semibold text-text">
-            Keyboard Shortcuts
-          </h2>
-          <button
-            onClick={onClose}
-            className="rounded p-1 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
-            aria-label="Close"
-          >
-            <X className="size-4" />
-          </button>
-        </div>
+    <Dialog open onOpenChange={(open) => !open && onClose()}>
+      <DialogContent className="w-[480px] max-w-[480px]">
+        <DialogHeader>
+          <DialogTitle className="text-sm">Keyboard Shortcuts</DialogTitle>
+        </DialogHeader>
 
         <div className="grid grid-cols-2 gap-x-6 gap-y-4">
           {resolvedGroups.map((group) => (
@@ -143,7 +119,7 @@ export const EditorShortcutsHelp = ({ onClose }: EditorShortcutsHelpProps): Reac
             </div>
           ))}
         </div>
-      </div>
-    </div>
+      </DialogContent>
+    </Dialog>
   );
 };
diff --git a/src/renderer/components/team/editor/EditorStatusBar.tsx b/src/renderer/components/team/editor/EditorStatusBar.tsx
index ac4bf959..7637e234 100644
--- a/src/renderer/components/team/editor/EditorStatusBar.tsx
+++ b/src/renderer/components/team/editor/EditorStatusBar.tsx
@@ -2,8 +2,12 @@
  * Status bar: cursor position, language, encoding, indent style, git branch.
  */
 
+import React from 'react';
+
+import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { useStore } from '@renderer/store';
 import { GitBranch } from 'lucide-react';
+import { useShallow } from 'zustand/react/shallow';
 
 interface EditorStatusBarProps {
   line: number;
@@ -11,14 +15,19 @@ interface EditorStatusBarProps {
   language: string;
 }
 
-export const EditorStatusBar = ({
+export const EditorStatusBar = React.memo(function EditorStatusBar({
   line,
   col,
   language,
-}: EditorStatusBarProps): React.ReactElement => {
-  const gitBranch = useStore((s) => s.editorGitBranch);
-  const isGitRepo = useStore((s) => s.editorIsGitRepo);
-  const watcherEnabled = useStore((s) => s.editorWatcherEnabled);
+}: EditorStatusBarProps): React.ReactElement {
+  const { gitBranch, isGitRepo, watcherEnabled } = useStore(
+    useShallow((s) => ({
+      gitBranch: s.editorGitBranch,
+      isGitRepo: s.editorIsGitRepo,
+      watcherEnabled: s.editorWatcherEnabled,
+    }))
+  );
+  const toggleWatcher = useStore((s) => s.toggleWatcher);
 
   return (
     <div className="flex h-6 shrink-0 items-center justify-between border-t border-border bg-surface-sidebar px-3 text-[11px] text-text-muted">
@@ -34,15 +43,30 @@ export const EditorStatusBar = ({
         )}
       </div>
       <div className="flex items-center gap-4">
-        {watcherEnabled && (
-          <span className="text-green-400" title="File watcher active">
-            watching
-          </span>
-        )}
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <button
+              type="button"
+              onClick={() => void toggleWatcher(!watcherEnabled)}
+              className={`rounded px-1.5 py-0.5 text-[10px] font-medium transition-colors ${
+                watcherEnabled
+                  ? 'bg-green-500/15 text-green-400 hover:bg-green-500/20'
+                  : 'text-text-muted hover:bg-surface-raised hover:text-text-secondary'
+              }`}
+              aria-label={watcherEnabled ? 'Disable file watcher' : 'Enable file watcher'}
+              aria-pressed={watcherEnabled}
+            >
+              {watcherEnabled ? 'watching' : 'watch'}
+            </button>
+          </TooltipTrigger>
+          <TooltipContent side="top">
+            {watcherEnabled ? 'Disable external change watcher' : 'Watch for external changes'}
+          </TooltipContent>
+        </Tooltip>
         <span>{language}</span>
         <span>UTF-8</span>
         <span>Spaces: 2</span>
       </div>
     </div>
   );
-};
+});
diff --git a/src/renderer/components/team/editor/EditorTabBar.tsx b/src/renderer/components/team/editor/EditorTabBar.tsx
index b5192a93..b624e02f 100644
--- a/src/renderer/components/team/editor/EditorTabBar.tsx
+++ b/src/renderer/components/team/editor/EditorTabBar.tsx
@@ -1,14 +1,31 @@
 /**
  * Tab bar for the project editor.
- * Shows open files as tabs with dirty indicator (dot) and close button.
+ * Shows open files as tabs with dirty indicator (dot), close button,
+ * right-click context menu (close others, close to left/right, close all),
+ * and drag-and-drop reordering via @dnd-kit.
  */
 
+import { useCallback, useMemo, useState } from 'react';
+
+import {
+  closestCenter,
+  DndContext,
+  DragOverlay,
+  PointerSensor,
+  useSensor,
+  useSensors,
+} from '@dnd-kit/core';
+import { horizontalListSortingStrategy, SortableContext, useSortable } from '@dnd-kit/sortable';
+import { CSS } from '@dnd-kit/utilities';
 import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { useStore } from '@renderer/store';
 import { X } from 'lucide-react';
+import { useShallow } from 'zustand/react/shallow';
 
-import { getFileIcon } from './fileIcons';
+import { EditorTabContextMenu } from './EditorTabContextMenu';
+import { FileIcon } from './FileIcon';
 
+import type { DragEndEvent, DragStartEvent } from '@dnd-kit/core';
 import type { EditorFileTab } from '@shared/types/editor';
 
 // =============================================================================
@@ -27,99 +44,222 @@ interface EditorTabBarProps {
 export const EditorTabBar = ({
   onRequestCloseTab,
 }: EditorTabBarProps): React.ReactElement | null => {
-  const tabs = useStore((s) => s.editorOpenTabs);
-  const activeTabId = useStore((s) => s.editorActiveTabId);
-  const modifiedFiles = useStore((s) => s.editorModifiedFiles);
+  const { tabs, activeTabId, modifiedFiles } = useStore(
+    useShallow((s) => ({
+      tabs: s.editorOpenTabs,
+      activeTabId: s.editorActiveTabId,
+      modifiedFiles: s.editorModifiedFiles,
+    }))
+  );
   const setActiveEditorTab = useStore((s) => s.setActiveEditorTab);
+  const reorderEditorTabs = useStore((s) => s.reorderEditorTabs);
+  const closeOtherEditorTabs = useStore((s) => s.closeOtherEditorTabs);
+  const closeEditorTabsToLeft = useStore((s) => s.closeEditorTabsToLeft);
+  const closeEditorTabsToRight = useStore((s) => s.closeEditorTabsToRight);
+  const closeAllEditorTabs = useStore((s) => s.closeAllEditorTabs);
+
+  const [draggedTab, setDraggedTab] = useState<EditorFileTab | null>(null);
+
+  const tabIds = useMemo(() => tabs.map((t) => t.id), [tabs]);
+
+  const sensors = useSensors(
+    useSensor(PointerSensor, {
+      activationConstraint: { distance: 5 },
+    })
+  );
+
+  const handleDragStart = useCallback(
+    (event: DragStartEvent) => {
+      const tab = tabs.find((t) => t.id === event.active.id);
+      setDraggedTab(tab ?? null);
+    },
+    [tabs]
+  );
+
+  const handleDragEnd = useCallback(
+    (event: DragEndEvent) => {
+      setDraggedTab(null);
+      const { active, over } = event;
+      if (over && active.id !== over.id) {
+        reorderEditorTabs(String(active.id), String(over.id));
+      }
+    },
+    [reorderEditorTabs]
+  );
+
+  const handleDragCancel = useCallback(() => {
+    setDraggedTab(null);
+  }, []);
 
   if (tabs.length === 0) return null;
 
   return (
-    <div
-      className="flex h-8 shrink-0 items-center overflow-x-auto border-b border-border bg-surface-sidebar"
-      role="tablist"
+    <DndContext
+      sensors={sensors}
+      collisionDetection={closestCenter}
+      onDragStart={handleDragStart}
+      onDragEnd={handleDragEnd}
+      onDragCancel={handleDragCancel}
     >
-      {tabs.map((tab) => (
-        <Tab
-          key={tab.id}
-          tab={tab}
-          isActive={tab.id === activeTabId}
-          isModified={!!modifiedFiles[tab.filePath]}
-          onActivate={() => setActiveEditorTab(tab.id)}
-          onClose={() => onRequestCloseTab(tab.id)}
-        />
-      ))}
-    </div>
+      <div
+        className="flex h-8 shrink-0 items-center overflow-x-auto border-b border-border bg-surface-sidebar"
+        role="tablist"
+      >
+        <SortableContext items={tabIds} strategy={horizontalListSortingStrategy}>
+          {tabs.map((tab, index) => (
+            <SortableEditorTab
+              key={tab.id}
+              tab={tab}
+              tabIndex={index}
+              totalTabs={tabs.length}
+              isActive={tab.id === activeTabId}
+              isModified={!!modifiedFiles[tab.filePath]}
+              onActivate={() => setActiveEditorTab(tab.id)}
+              onRequestClose={onRequestCloseTab}
+              onCloseOthers={closeOtherEditorTabs}
+              onCloseToLeft={closeEditorTabsToLeft}
+              onCloseToRight={closeEditorTabsToRight}
+              onCloseAll={closeAllEditorTabs}
+            />
+          ))}
+        </SortableContext>
+      </div>
+
+      <DragOverlay dropAnimation={null}>
+        {draggedTab && <EditorTabOverlay tab={draggedTab} />}
+      </DragOverlay>
+    </DndContext>
   );
 };
 
 // =============================================================================
-// Tab item
+// Sortable tab item
 // =============================================================================
 
-interface TabProps {
+interface SortableEditorTabProps {
   tab: EditorFileTab;
+  tabIndex: number;
+  totalTabs: number;
   isActive: boolean;
   isModified: boolean;
   onActivate: () => void;
-  onClose: () => void;
+  onRequestClose: (tabId: string) => void;
+  onCloseOthers: (tabId: string) => void;
+  onCloseToLeft: (tabId: string) => void;
+  onCloseToRight: (tabId: string) => void;
+  onCloseAll: () => void;
 }
 
-const Tab = ({ tab, isActive, isModified, onActivate, onClose }: TabProps): React.ReactElement => {
+const SortableEditorTab = ({
+  tab,
+  tabIndex,
+  totalTabs,
+  isActive,
+  isModified,
+  onActivate,
+  onRequestClose,
+  onCloseOthers,
+  onCloseToLeft,
+  onCloseToRight,
+  onCloseAll,
+}: SortableEditorTabProps): React.ReactElement => {
+  const { attributes, listeners, setNodeRef, transform, transition, isDragging } = useSortable({
+    id: tab.id,
+  });
+
+  const style: React.CSSProperties = {
+    transform: CSS.Transform.toString(transform),
+    transition: isDragging ? 'none' : transition,
+    opacity: isDragging ? 0.3 : 1,
+  };
+
   const handleClose = (e: React.MouseEvent) => {
     e.stopPropagation();
-    onClose();
+    onRequestClose(tab.id);
   };
 
   const handleAuxClick = (e: React.MouseEvent) => {
     if (e.button === 1) {
       e.preventDefault();
-      onClose();
+      onRequestClose(tab.id);
     }
   };
 
-  const iconInfo = getFileIcon(tab.fileName);
-  const FileIcon = iconInfo.icon;
-
   return (
-    <Tooltip>
-      <TooltipTrigger asChild>
-        <button
-          onClick={onActivate}
-          onAuxClick={handleAuxClick}
-          role="tab"
-          aria-selected={isActive}
-          className={`group flex h-full shrink-0 items-center gap-1.5 border-r border-border px-3 text-xs transition-colors ${
-            isActive
-              ? 'bg-surface text-text'
-              : 'bg-surface-sidebar text-text-muted hover:bg-surface-raised hover:text-text-secondary'
-          }`}
-        >
-          {isModified && (
-            <span
-              className="size-1.5 shrink-0 rounded-full bg-amber-400"
-              aria-label="Unsaved changes"
-            />
-          )}
-          <FileIcon className="size-3.5 shrink-0" style={{ color: iconInfo.color }} />
-          <span className="max-w-40 truncate">
-            {tab.fileName}
-            {tab.disambiguatedLabel && (
-              <span className="ml-1 text-text-muted">{tab.disambiguatedLabel}</span>
-            )}
-          </span>
-          <span
-            onClick={handleClose}
-            className="ml-1 rounded p-0.5 opacity-0 transition-opacity hover:bg-surface-raised group-hover:opacity-100"
-            role="button"
-            aria-label={`Close ${tab.fileName}`}
-            tabIndex={-1}
-          >
-            <X className="size-3" />
-          </span>
-        </button>
-      </TooltipTrigger>
-      <TooltipContent side="bottom">{tab.filePath}</TooltipContent>
-    </Tooltip>
+    // Sortable wrapper — must be the outermost element so @dnd-kit controls its position.
+    // ContextMenu.Trigger inside EditorTabContextMenu adds an extra <div>,
+    // so the useSortable ref/transform CANNOT live on the inner <button>.
+    <div
+      ref={setNodeRef}
+      style={style}
+      className="flex h-full shrink-0"
+      // eslint-disable-next-line react/jsx-props-no-spreading -- @dnd-kit useSortable requires prop spreading
+      {...attributes}
+      // eslint-disable-next-line react/jsx-props-no-spreading -- @dnd-kit useSortable requires prop spreading
+      {...listeners}
+    >
+      <EditorTabContextMenu
+        tabId={tab.id}
+        tabIndex={tabIndex}
+        totalTabs={totalTabs}
+        onClose={onRequestClose}
+        onCloseOthers={onCloseOthers}
+        onCloseToLeft={onCloseToLeft}
+        onCloseToRight={onCloseToRight}
+        onCloseAll={onCloseAll}
+      >
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <button
+              onClick={onActivate}
+              onAuxClick={handleAuxClick}
+              role="tab"
+              aria-selected={isActive}
+              className={`group flex h-full shrink-0 cursor-grab items-center gap-1.5 border-r border-border px-3 text-xs transition-colors ${
+                isActive
+                  ? 'bg-surface text-text'
+                  : 'bg-surface-sidebar text-text-muted hover:bg-surface-raised hover:text-text-secondary'
+              }`}
+            >
+              {isModified && (
+                <span
+                  className="size-1.5 shrink-0 rounded-full bg-amber-400"
+                  aria-label="Unsaved changes"
+                />
+              )}
+              <FileIcon fileName={tab.fileName} className="size-3.5" />
+              <span className="max-w-40 truncate">
+                {tab.fileName}
+                {tab.disambiguatedLabel && (
+                  <span className="ml-1 text-text-muted">{tab.disambiguatedLabel}</span>
+                )}
+              </span>
+              <span
+                onClick={handleClose}
+                onPointerDown={(e) => e.stopPropagation()}
+                className="ml-1 rounded p-0.5 opacity-0 transition-opacity hover:bg-surface-raised group-hover:opacity-100"
+                role="button"
+                aria-label={`Close ${tab.fileName}`}
+                tabIndex={-1}
+              >
+                <X className="size-3" />
+              </span>
+            </button>
+          </TooltipTrigger>
+          <TooltipContent side="bottom">{tab.filePath}</TooltipContent>
+        </Tooltip>
+      </EditorTabContextMenu>
+    </div>
   );
 };
+
+// =============================================================================
+// Drag overlay (ghost shown while dragging)
+// =============================================================================
+
+const EditorTabOverlay = ({ tab }: { tab: EditorFileTab }): React.ReactElement => (
+  <div className="flex items-center gap-1.5 rounded border border-border-emphasis bg-surface-raised px-3 py-1 text-xs text-text shadow-lg">
+    <FileIcon fileName={tab.fileName} className="size-3.5" />
+    <span className="max-w-40 truncate">{tab.fileName}</span>
+  </div>
+);
diff --git a/src/renderer/components/team/editor/EditorTabContextMenu.tsx b/src/renderer/components/team/editor/EditorTabContextMenu.tsx
new file mode 100644
index 00000000..69021db2
--- /dev/null
+++ b/src/renderer/components/team/editor/EditorTabContextMenu.tsx
@@ -0,0 +1,88 @@
+/**
+ * Context menu for editor tabs.
+ * Supports: close, close others, close to left/right, close all.
+ */
+
+import * as ContextMenu from '@radix-ui/react-context-menu';
+
+interface EditorTabContextMenuProps {
+  children: React.ReactNode;
+  tabId: string;
+  tabIndex: number;
+  totalTabs: number;
+  onClose: (tabId: string) => void;
+  onCloseOthers: (tabId: string) => void;
+  onCloseToLeft: (tabId: string) => void;
+  onCloseToRight: (tabId: string) => void;
+  onCloseAll: () => void;
+}
+
+export const EditorTabContextMenu = ({
+  children,
+  tabId,
+  tabIndex,
+  totalTabs,
+  onClose,
+  onCloseOthers,
+  onCloseToLeft,
+  onCloseToRight,
+  onCloseAll,
+}: EditorTabContextMenuProps): React.ReactElement => {
+  const hasLeft = tabIndex > 0;
+  const hasRight = tabIndex < totalTabs - 1;
+  const hasOthers = totalTabs > 1;
+
+  return (
+    <ContextMenu.Root>
+      <ContextMenu.Trigger asChild>
+        <div className="flex h-full">{children}</div>
+      </ContextMenu.Trigger>
+
+      <ContextMenu.Portal>
+        <ContextMenu.Content className="z-50 min-w-[180px] rounded-md border border-border-emphasis bg-surface-overlay p-1 shadow-lg animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95">
+          <ContextMenu.Item
+            className="flex cursor-pointer items-center rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised"
+            onSelect={() => onClose(tabId)}
+          >
+            Close
+          </ContextMenu.Item>
+
+          <ContextMenu.Item
+            className="flex cursor-pointer items-center rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised disabled:cursor-not-allowed disabled:opacity-40"
+            disabled={!hasOthers}
+            onSelect={() => onCloseOthers(tabId)}
+          >
+            Close Others
+          </ContextMenu.Item>
+
+          <ContextMenu.Separator className="my-1 h-px bg-border" />
+
+          <ContextMenu.Item
+            className="flex cursor-pointer items-center rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised disabled:cursor-not-allowed disabled:opacity-40"
+            disabled={!hasLeft}
+            onSelect={() => onCloseToLeft(tabId)}
+          >
+            Close Tabs to the Left
+          </ContextMenu.Item>
+
+          <ContextMenu.Item
+            className="flex cursor-pointer items-center rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised disabled:cursor-not-allowed disabled:opacity-40"
+            disabled={!hasRight}
+            onSelect={() => onCloseToRight(tabId)}
+          >
+            Close Tabs to the Right
+          </ContextMenu.Item>
+
+          <ContextMenu.Separator className="my-1 h-px bg-border" />
+
+          <ContextMenu.Item
+            className="flex cursor-pointer items-center rounded px-2 py-1.5 text-xs text-text outline-none hover:bg-surface-raised focus:bg-surface-raised"
+            onSelect={onCloseAll}
+          >
+            Close All
+          </ContextMenu.Item>
+        </ContextMenu.Content>
+      </ContextMenu.Portal>
+    </ContextMenu.Root>
+  );
+};
diff --git a/src/renderer/components/team/editor/EditorToolbar.tsx b/src/renderer/components/team/editor/EditorToolbar.tsx
index a2db2bda..bc0123ec 100644
--- a/src/renderer/components/team/editor/EditorToolbar.tsx
+++ b/src/renderer/components/team/editor/EditorToolbar.tsx
@@ -2,23 +2,49 @@
  * Toolbar with Save, Undo, Redo buttons.
  */
 
+import React from 'react';
+
 import { redo, undo } from '@codemirror/commands';
+import { Button } from '@renderer/components/ui/button';
 import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { useStore } from '@renderer/store';
 import { editorBridge } from '@renderer/utils/editorBridge';
 import { shortcutLabel } from '@renderer/utils/platformKeys';
-import { Redo2, Save, Undo2, WrapText } from 'lucide-react';
+import { Columns2, Eye, Redo2, Save, Undo2, WrapText } from 'lucide-react';
+import { useShallow } from 'zustand/react/shallow';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export type MdPreviewMode = 'off' | 'split' | 'preview';
 
 // =============================================================================
 // Component
 // =============================================================================
 
-export const EditorToolbar = (): React.ReactElement | null => {
-  const activeTabId = useStore((s) => s.editorActiveTabId);
-  const modifiedFiles = useStore((s) => s.editorModifiedFiles);
-  const saving = useStore((s) => s.editorSaving);
+interface EditorToolbarProps {
+  isMarkdown?: boolean;
+  mdPreviewMode?: MdPreviewMode;
+  onToggleSplit?: () => void;
+  onToggleFullPreview?: () => void;
+}
+
+export const EditorToolbar = ({
+  isMarkdown = false,
+  mdPreviewMode = 'off',
+  onToggleSplit,
+  onToggleFullPreview,
+}: EditorToolbarProps): React.ReactElement | null => {
+  const { activeTabId, modifiedFiles, saving, lineWrap } = useStore(
+    useShallow((s) => ({
+      activeTabId: s.editorActiveTabId,
+      modifiedFiles: s.editorModifiedFiles,
+      saving: s.editorSaving,
+      lineWrap: s.editorLineWrap,
+    }))
+  );
   const saveFile = useStore((s) => s.saveFile);
-  const lineWrap = useStore((s) => s.editorLineWrap);
   const toggleLineWrap = useStore((s) => s.toggleLineWrap);
 
   if (!activeTabId) return null;
@@ -69,6 +95,25 @@ export const EditorToolbar = (): React.ReactElement | null => {
         onClick={toggleLineWrap}
         active={lineWrap}
       />
+      {isMarkdown && (
+        <>
+          <div className="mx-1 h-4 w-px bg-border" />
+          <ToolbarButton
+            icon={<Columns2 className="size-3.5" />}
+            label={mdPreviewMode === 'split' ? 'Close split preview' : 'Split preview'}
+            shortcut={shortcutLabel('⌘ ⇧ M', 'Ctrl+Shift+M')}
+            onClick={onToggleSplit ?? (() => {})}
+            active={mdPreviewMode === 'split'}
+          />
+          <ToolbarButton
+            icon={<Eye className="size-3.5" />}
+            label={mdPreviewMode === 'preview' ? 'Close preview' : 'Full preview'}
+            shortcut={shortcutLabel('⌘ ⇧ V', 'Ctrl+Shift+V')}
+            onClick={onToggleFullPreview ?? (() => {})}
+            active={mdPreviewMode === 'preview'}
+          />
+        </>
+      )}
     </div>
   );
 };
@@ -86,30 +131,33 @@ interface ToolbarButtonProps {
   active?: boolean;
 }
 
-const ToolbarButton = ({
+const ToolbarButton = React.memo(function ToolbarButton({
   icon,
   label,
   shortcut,
   onClick,
   disabled = false,
   active = false,
-}: ToolbarButtonProps): React.ReactElement => (
-  <Tooltip>
-    <TooltipTrigger asChild>
-      <button
-        onClick={onClick}
-        disabled={disabled}
-        className={`flex items-center gap-1 rounded px-1.5 py-0.5 text-xs transition-colors hover:bg-surface-raised hover:text-text disabled:opacity-40 disabled:hover:bg-transparent ${
-          active ? 'bg-surface-raised text-text' : 'text-text-muted'
-        }`}
-        aria-label={`${label} (${shortcut})`}
-        aria-pressed={active}
-      >
-        {icon}
-      </button>
-    </TooltipTrigger>
-    <TooltipContent side="bottom">
-      {label} ({shortcut})
-    </TooltipContent>
-  </Tooltip>
-);
+}: ToolbarButtonProps): React.ReactElement {
+  return (
+    <Tooltip>
+      <TooltipTrigger asChild>
+        <Button
+          variant="ghost"
+          onClick={onClick}
+          disabled={disabled}
+          className={`h-auto gap-1 px-1.5 py-0.5 text-xs ${
+            active ? 'bg-surface-raised text-text' : 'text-text-muted'
+          }`}
+          aria-label={`${label} (${shortcut})`}
+          aria-pressed={active}
+        >
+          {icon}
+        </Button>
+      </TooltipTrigger>
+      <TooltipContent side="bottom">
+        {label} ({shortcut})
+      </TooltipContent>
+    </Tooltip>
+  );
+});
diff --git a/src/renderer/components/team/editor/FileIcon.tsx b/src/renderer/components/team/editor/FileIcon.tsx
new file mode 100644
index 00000000..0191fc1c
--- /dev/null
+++ b/src/renderer/components/team/editor/FileIcon.tsx
@@ -0,0 +1,66 @@
+/**
+ * FileIcon — renders a file-type icon.
+ *
+ * For programming languages/frameworks: uses Devicon CDN SVG (real colorful logos).
+ * For generic types (images, fonts, configs): uses lucide-react icons with tinted color.
+ * Falls back to lucide if the Devicon image fails to load.
+ *
+ * Applies a subtle glow (drop-shadow) in dark mode so dark-colored icons
+ * remain visible against dark backgrounds (e.g. Go, Rust, C).
+ */
+
+import { memo, useCallback, useState } from 'react';
+
+import { cn } from '@renderer/lib/utils';
+
+import { getDeviconUrl, getFileIcon } from './fileIcons';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+interface FileIconProps {
+  /** File name (e.g. "index.ts", "Dockerfile", "logo.png") */
+  fileName: string;
+  /** Tailwind size class (e.g. "size-3.5", "size-4"). Defaults to "size-3.5" */
+  className?: string;
+}
+
+// Track slugs that failed to load so we don't retry them across mounts
+const failedSlugs = new Set<string>();
+
+// =============================================================================
+// Component
+// =============================================================================
+
+export const FileIcon = memo(({ fileName, className = 'size-3.5' }: FileIconProps) => {
+  const info = getFileIcon(fileName);
+  const slug = info.deviconSlug;
+  const canUseDevicon = slug != null && !failedSlugs.has(slug);
+
+  const [imgFailed, setImgFailed] = useState(false);
+
+  const handleError = useCallback(() => {
+    if (slug) failedSlugs.add(slug);
+    setImgFailed(true);
+  }, [slug]);
+
+  if (canUseDevicon && !imgFailed) {
+    return (
+      <img
+        src={getDeviconUrl(slug)}
+        className={cn('file-icon-glow shrink-0', className)}
+        onError={handleError}
+        alt=""
+        draggable={false}
+        loading="lazy"
+      />
+    );
+  }
+
+  // Fallback to lucide icon
+  const Icon = info.icon;
+  return <Icon className={cn('shrink-0', className)} style={{ color: info.color }} />;
+});
+
+FileIcon.displayName = 'FileIcon';
diff --git a/src/renderer/components/team/editor/GitStatusBadge.tsx b/src/renderer/components/team/editor/GitStatusBadge.tsx
index 61695503..e2a5caba 100644
--- a/src/renderer/components/team/editor/GitStatusBadge.tsx
+++ b/src/renderer/components/team/editor/GitStatusBadge.tsx
@@ -10,6 +10,8 @@
  * - R (renamed) — cyan
  */
 
+import React from 'react';
+
 import type { GitFileStatusType } from '@shared/types/editor';
 
 // =============================================================================
@@ -33,11 +35,13 @@ interface GitStatusBadgeProps {
   status: GitFileStatusType;
 }
 
-export const GitStatusBadge = ({ status }: GitStatusBadgeProps): React.ReactElement => {
+export const GitStatusBadge = React.memo(function GitStatusBadge({
+  status,
+}: GitStatusBadgeProps): React.ReactElement {
   const config = STATUS_CONFIG[status];
   return (
     <span className={`ml-auto shrink-0 text-[10px] leading-none ${config.color}`} title={status}>
       {config.letter}
     </span>
   );
-};
+});
diff --git a/src/renderer/components/team/editor/GoToLineDialog.tsx b/src/renderer/components/team/editor/GoToLineDialog.tsx
new file mode 100644
index 00000000..dd1c9ef8
--- /dev/null
+++ b/src/renderer/components/team/editor/GoToLineDialog.tsx
@@ -0,0 +1,186 @@
+/**
+ * Go to Line dialog (Cmd+G) — custom replacement for CodeMirror's built-in gotoLine.
+ *
+ * Supports: line numbers, relative offsets (+5, -3), percentages (50%),
+ * and optional column positions (42:10).
+ */
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+
+import { EditorView } from '@codemirror/view';
+import { Button } from '@renderer/components/ui/button';
+import { Input } from '@renderer/components/ui/input';
+import { editorBridge } from '@renderer/utils/editorBridge';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+interface GoToLineDialogProps {
+  onClose: () => void;
+}
+
+// =============================================================================
+// Line parsing
+// =============================================================================
+
+interface ParsedTarget {
+  line: number;
+  col?: number;
+}
+
+function parseLineInput(input: string, view: EditorView): ParsedTarget | null {
+  const trimmed = input.trim();
+  if (!trimmed) return null;
+
+  // Split line:col
+  const [linePart, colPart] = trimmed.split(':');
+  const col = colPart ? parseInt(colPart, 10) : undefined;
+  if (col !== undefined && (isNaN(col) || col < 1)) return null;
+
+  const lineStr = linePart.trim();
+  if (!lineStr) return null;
+
+  const totalLines = view.state.doc.lines;
+
+  // Percentage: "50%"
+  if (lineStr.endsWith('%')) {
+    const pct = parseFloat(lineStr.slice(0, -1));
+    if (isNaN(pct)) return null;
+    const line = Math.max(1, Math.min(totalLines, Math.round((pct / 100) * totalLines)));
+    return { line, col };
+  }
+
+  // Relative: "+5" or "-3"
+  if (lineStr.startsWith('+') || lineStr.startsWith('-')) {
+    const offset = parseInt(lineStr, 10);
+    if (isNaN(offset)) return null;
+    const currentPos = view.state.selection.main.head;
+    const currentLine = view.state.doc.lineAt(currentPos).number;
+    const line = Math.max(1, Math.min(totalLines, currentLine + offset));
+    return { line, col };
+  }
+
+  // Absolute: "42"
+  const lineNum = parseInt(lineStr, 10);
+  if (isNaN(lineNum)) return null;
+  const line = Math.max(1, Math.min(totalLines, lineNum));
+  return { line, col };
+}
+
+// =============================================================================
+// Component
+// =============================================================================
+
+export const GoToLineDialog = ({ onClose }: GoToLineDialogProps): React.ReactElement => {
+  const [value, setValue] = useState('');
+  const inputRef = useRef<HTMLInputElement>(null);
+
+  // Focus on mount
+  useEffect(() => {
+    inputRef.current?.focus();
+  }, []);
+
+  // Escape to close
+  useEffect(() => {
+    const handleKeyDown = (e: KeyboardEvent): void => {
+      if (e.key === 'Escape') {
+        e.preventDefault();
+        e.stopPropagation();
+        onClose();
+      }
+    };
+    window.addEventListener('keydown', handleKeyDown, true);
+    return () => window.removeEventListener('keydown', handleKeyDown, true);
+  }, [onClose]);
+
+  const handleGo = useCallback(() => {
+    const view = editorBridge.getView();
+    if (!view) return;
+
+    const target = parseLineInput(value, view);
+    if (!target) return;
+
+    const lineInfo = view.state.doc.line(target.line);
+    const colOffset = target.col ? Math.min(target.col - 1, lineInfo.length) : 0;
+    const pos = lineInfo.from + colOffset;
+
+    view.dispatch({
+      selection: { anchor: pos },
+      effects: EditorView.scrollIntoView(pos, { y: 'center' }),
+    });
+
+    view.focus();
+    onClose();
+  }, [value, onClose]);
+
+  const handleKeyDown = useCallback(
+    (e: React.KeyboardEvent) => {
+      if (e.key === 'Enter') {
+        e.preventDefault();
+        handleGo();
+      }
+    },
+    [handleGo]
+  );
+
+  // Current line info for placeholder
+  const view = editorBridge.getView();
+  const totalLines = view?.state.doc.lines ?? 0;
+  const currentLine = view ? view.state.doc.lineAt(view.state.selection.main.head).number : 0;
+
+  return (
+    <div className="fixed inset-0 z-[60] flex items-start justify-center pt-[15vh]">
+      {/* Backdrop */}
+      <div
+        className="fixed inset-0 bg-black/40"
+        onClick={onClose}
+        onKeyDown={(e) => {
+          if (e.key === 'Escape') onClose();
+        }}
+        role="presentation"
+      />
+
+      {/* Dialog */}
+      <div
+        role="dialog"
+        aria-modal="true"
+        aria-label="Go to Line"
+        className="relative z-10 w-[360px] overflow-hidden rounded-lg border border-border-emphasis bg-surface shadow-2xl"
+      >
+        <div className="flex flex-col gap-2 p-3">
+          <div className="flex items-center justify-between">
+            <span className="text-xs text-text-secondary">
+              Go to Line{' '}
+              <span className="text-text-muted">
+                (current: {currentLine}, total: {totalLines})
+              </span>
+            </span>
+          </div>
+
+          <div className="flex items-center gap-2">
+            <Input
+              ref={inputRef}
+              className="h-8 flex-1 bg-transparent text-sm"
+              placeholder="Line number, +offset, -offset, or %"
+              value={value}
+              onChange={(e) => setValue(e.target.value)}
+              onKeyDown={handleKeyDown}
+              spellCheck={false}
+              autoComplete="off"
+            />
+            <Button
+              variant="secondary"
+              size="sm"
+              className="h-8 px-4"
+              onClick={handleGo}
+              disabled={!value.trim()}
+            >
+              Go
+            </Button>
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+};
diff --git a/src/renderer/components/team/editor/MarkdownPreviewPane.tsx b/src/renderer/components/team/editor/MarkdownPreviewPane.tsx
new file mode 100644
index 00000000..ea871ba2
--- /dev/null
+++ b/src/renderer/components/team/editor/MarkdownPreviewPane.tsx
@@ -0,0 +1,57 @@
+/**
+ * Scrollable markdown preview pane for the editor split view.
+ *
+ * Wraps MarkdownViewer in a scrollable container with ref access
+ * for external scroll synchronization (code ↔ preview).
+ */
+
+import React from 'react';
+
+import { MarkdownViewer } from '@renderer/components/chat/viewers/MarkdownViewer';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+interface MarkdownPreviewPaneProps {
+  content: string;
+  className?: string;
+  scrollRef?: React.RefObject<HTMLDivElement | null>;
+  onScroll?: () => void;
+  /** Base directory for resolving relative image/link URLs */
+  baseDir?: string;
+}
+
+// =============================================================================
+// Component
+// =============================================================================
+
+export const MarkdownPreviewPane = React.memo(function MarkdownPreviewPane({
+  content,
+  className = '',
+  scrollRef,
+  onScroll,
+  baseDir,
+}: MarkdownPreviewPaneProps): React.ReactElement {
+  // Callback ref to wire scrollRef (RefObject<T | null>) to the div
+  const internalRef = React.useRef<HTMLDivElement | null>(null);
+  const setRef = React.useCallback(
+    (el: HTMLDivElement | null) => {
+      internalRef.current = el;
+      if (scrollRef && 'current' in scrollRef) {
+        // Forward ref — the mutable cast is the standard pattern for forwarding refs
+        const mutableRef = scrollRef as React.MutableRefObject<HTMLDivElement | null>;
+        mutableRef.current = el;
+      }
+    },
+    [scrollRef]
+  );
+
+  return (
+    <div ref={setRef} className={`h-full overflow-y-auto ${className}`} onScroll={onScroll}>
+      <div className="p-4">
+        <MarkdownViewer content={content} bare maxHeight="" baseDir={baseDir} />
+      </div>
+    </div>
+  );
+});
diff --git a/src/renderer/components/team/editor/MarkdownSplitView.tsx b/src/renderer/components/team/editor/MarkdownSplitView.tsx
new file mode 100644
index 00000000..d2f83052
--- /dev/null
+++ b/src/renderer/components/team/editor/MarkdownSplitView.tsx
@@ -0,0 +1,128 @@
+/**
+ * Right-side panel for markdown split/preview mode.
+ *
+ * In split mode: renders a drag-resizable handle + MarkdownPreviewPane.
+ * In preview mode: renders MarkdownPreviewPane at full width (no handle).
+ *
+ * CodeMirrorEditor is NOT rendered here — it stays in ProjectEditorOverlay
+ * and is controlled via CSS display/width.
+ */
+
+import React, { useCallback, useEffect, useRef, useState } from 'react';
+
+import { useMarkdownScrollSync } from '@renderer/hooks/useMarkdownScrollSync';
+
+import { MarkdownPreviewPane } from './MarkdownPreviewPane';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+interface MarkdownSplitViewProps {
+  content: string;
+  mode: 'split' | 'preview';
+  splitRatio: number;
+  onSplitRatioChange: (ratio: number) => void;
+  /** Key that changes when the EditorView changes (e.g. activeTabId) — triggers scroll re-attach */
+  viewKey?: string | null;
+  /** Base directory for resolving relative image/link URLs */
+  baseDir?: string;
+}
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+const MIN_RATIO = 0.2;
+const MAX_RATIO = 0.8;
+const HANDLE_WIDTH = 4; // px
+
+// =============================================================================
+// Component
+// =============================================================================
+
+export const MarkdownSplitView = React.memo(function MarkdownSplitView({
+  content,
+  mode,
+  splitRatio,
+  onSplitRatioChange,
+  viewKey,
+  baseDir,
+}: MarkdownSplitViewProps): React.ReactElement {
+  const [isResizing, setIsResizing] = useState(false);
+  const containerRef = useRef<HTMLDivElement>(null);
+
+  // Scroll sync auto-manages its own listener lifecycle via viewKey
+  const scrollSync = useMarkdownScrollSync(mode === 'split', viewKey);
+
+  // --- Resize drag logic ---
+
+  const handleMouseMove = useCallback(
+    (e: MouseEvent) => {
+      const parent = containerRef.current?.parentElement;
+      if (!parent) return;
+
+      const parentRect = parent.getBoundingClientRect();
+      const relativeX = e.clientX - parentRect.left;
+      const newRatio = Math.min(MAX_RATIO, Math.max(MIN_RATIO, relativeX / parentRect.width));
+      onSplitRatioChange(newRatio);
+    },
+    [onSplitRatioChange]
+  );
+
+  const handleMouseUp = useCallback(() => {
+    setIsResizing(false);
+  }, []);
+
+  useEffect(() => {
+    if (!isResizing) return;
+
+    document.addEventListener('mousemove', handleMouseMove);
+    document.addEventListener('mouseup', handleMouseUp);
+    document.body.style.cursor = 'col-resize';
+    document.body.style.userSelect = 'none';
+
+    return () => {
+      document.removeEventListener('mousemove', handleMouseMove);
+      document.removeEventListener('mouseup', handleMouseUp);
+      document.body.style.cursor = '';
+      document.body.style.userSelect = '';
+    };
+  }, [isResizing, handleMouseMove, handleMouseUp]);
+
+  const handleMouseDown = (e: React.MouseEvent): void => {
+    e.preventDefault();
+    setIsResizing(true);
+  };
+
+  // --- Preview width ---
+
+  const previewWidth =
+    mode === 'preview' ? '100%' : `calc(${(1 - splitRatio) * 100}% - ${HANDLE_WIDTH}px)`;
+
+  return (
+    <div ref={containerRef} className="flex h-full" style={{ width: previewWidth }}>
+      {/* Resize handle — only in split mode */}
+      {mode === 'split' && (
+        // eslint-disable-next-line jsx-a11y/no-static-element-interactions -- resize handle
+        <div
+          className={`shrink-0 cursor-col-resize border-x border-border transition-colors ${
+            isResizing ? 'bg-blue-500/50' : 'hover:bg-blue-500/30'
+          }`}
+          style={{ width: HANDLE_WIDTH }}
+          onMouseDown={handleMouseDown}
+        />
+      )}
+
+      {/* Preview pane */}
+      <div className="flex-1 overflow-hidden bg-surface">
+        <MarkdownPreviewPane
+          content={content}
+          scrollRef={scrollSync.previewScrollRef}
+          onScroll={scrollSync.handlePreviewScroll}
+          baseDir={baseDir}
+        />
+      </div>
+    </div>
+  );
+});
diff --git a/src/renderer/components/team/editor/NewFileDialog.tsx b/src/renderer/components/team/editor/NewFileDialog.tsx
index 880d8756..8e5ad5a9 100644
--- a/src/renderer/components/team/editor/NewFileDialog.tsx
+++ b/src/renderer/components/team/editor/NewFileDialog.tsx
@@ -1,7 +1,10 @@
 /**
  * Inline input for creating a new file or directory in the file tree.
  *
- * Auto-focuses, validates on the client side, submits on Enter, cancels on Escape/blur.
+ * Auto-focuses, validates on the client side, submits on Enter, cancels on Escape.
+ * Uses click-outside detection instead of onBlur for dismissal — onBlur is
+ * unreliable when the input lives inside a virtualizer + DnD context + Radix
+ * context menu (all of which can steal focus transiently).
  */
 
 import React, { useCallback, useEffect, useRef, useState } from 'react';
@@ -48,12 +51,33 @@ export const NewFileDialog = ({
   const [value, setValue] = useState('');
   const [error, setError] = useState<string | null>(null);
   const inputRef = useRef<HTMLInputElement>(null);
+  const containerRef = useRef<HTMLDivElement>(null);
 
+  // Focus input after Radix context menu finishes its focus restoration
   useEffect(() => {
-    // Auto-focus on mount
-    inputRef.current?.focus();
+    const timer = setTimeout(() => {
+      inputRef.current?.focus();
+    }, 100);
+    return () => clearTimeout(timer);
   }, []);
 
+  // Click-outside → cancel (replaces unreliable onBlur)
+  useEffect(() => {
+    const handlePointerDown = (e: PointerEvent): void => {
+      if (containerRef.current && !containerRef.current.contains(e.target as Node)) {
+        onCancel();
+      }
+    };
+    // Delay listener registration so the context menu close click isn't caught
+    const timer = setTimeout(() => {
+      document.addEventListener('pointerdown', handlePointerDown, true);
+    }, 150);
+    return () => {
+      clearTimeout(timer);
+      document.removeEventListener('pointerdown', handlePointerDown, true);
+    };
+  }, [onCancel]);
+
   const handleSubmit = useCallback(() => {
     const trimmed = value.trim();
     const validationError = validateName(trimmed);
@@ -73,6 +97,7 @@ export const NewFileDialog = ({
         e.preventDefault();
         onCancel();
       }
+      e.stopPropagation();
     },
     [handleSubmit, onCancel]
   );
@@ -85,7 +110,7 @@ export const NewFileDialog = ({
   const Icon = type === 'file' ? FilePlus : FolderPlus;
 
   return (
-    <div className="flex flex-col px-2 py-1">
+    <div ref={containerRef} className="flex flex-col px-2 py-1">
       <div className="flex items-center gap-1.5">
         <Icon className="size-3.5 shrink-0 text-text-muted" />
         <input
@@ -94,7 +119,7 @@ export const NewFileDialog = ({
           value={value}
           onChange={handleChange}
           onKeyDown={handleKeyDown}
-          onBlur={onCancel}
+          onBlur={() => requestAnimationFrame(() => inputRef.current?.focus())}
           placeholder={type === 'file' ? 'File name...' : 'Folder name...'}
           className="min-w-0 flex-1 rounded border border-border-emphasis bg-surface px-1.5 py-0.5 text-xs text-text outline-none focus:border-blue-500"
           aria-label={type === 'file' ? 'New file name' : 'New folder name'}
diff --git a/src/renderer/components/team/editor/ProjectEditorOverlay.tsx b/src/renderer/components/team/editor/ProjectEditorOverlay.tsx
index 781048d1..9d76234c 100644
--- a/src/renderer/components/team/editor/ProjectEditorOverlay.tsx
+++ b/src/renderer/components/team/editor/ProjectEditorOverlay.tsx
@@ -7,10 +7,19 @@
 
 import { useCallback, useEffect, useRef, useState } from 'react';
 
+import { Button } from '@renderer/components/ui/button';
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from '@renderer/components/ui/dialog';
 import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { useEditorKeyboardShortcuts } from '@renderer/hooks/useEditorKeyboardShortcuts';
 import { useStore } from '@renderer/store';
-import { buildSelectionAction } from '@renderer/utils/buildSelectionAction';
+import { buildFileAction, buildSelectionAction } from '@renderer/utils/buildSelectionAction';
 import { shortcutLabel } from '@renderer/utils/platformKeys';
 import {
   AlertTriangle,
@@ -22,6 +31,7 @@ import {
   RotateCcw,
   X,
 } from 'lucide-react';
+import { useShallow } from 'zustand/react/shallow';
 
 import { CodeMirrorEditor } from './CodeMirrorEditor';
 import { EditorBinaryState } from './EditorBinaryState';
@@ -34,9 +44,12 @@ import { EditorShortcutsHelp } from './EditorShortcutsHelp';
 import { EditorStatusBar } from './EditorStatusBar';
 import { EditorTabBar } from './EditorTabBar';
 import { EditorToolbar } from './EditorToolbar';
+import { GoToLineDialog } from './GoToLineDialog';
+import { MarkdownSplitView } from './MarkdownSplitView';
 import { QuickOpenDialog } from './QuickOpenDialog';
 import { SearchInFilesPanel } from './SearchInFilesPanel';
 
+import type { MdPreviewMode } from './EditorToolbar';
 import type {
   EditorSelectionAction,
   EditorSelectionInfo,
@@ -63,23 +76,29 @@ export const ProjectEditorOverlay = ({
   onClose,
   onEditorAction,
 }: ProjectEditorOverlayProps): React.ReactElement => {
+  // Data selectors — grouped with useShallow to prevent unnecessary re-renders
+  const { activeTabId, openTabs, modifiedFiles, saveErrors, externalChanges, conflictFile } =
+    useStore(
+      useShallow((s) => ({
+        activeTabId: s.editorActiveTabId,
+        openTabs: s.editorOpenTabs,
+        modifiedFiles: s.editorModifiedFiles,
+        saveErrors: s.editorSaveError,
+        externalChanges: s.editorExternalChanges,
+        conflictFile: s.editorConflictFile,
+      }))
+    );
+
+  // Actions — stable references in Zustand, no grouping needed
   const openEditor = useStore((s) => s.openEditor);
   const closeEditor = useStore((s) => s.closeEditor);
   const openFile = useStore((s) => s.openFile);
   const closeEditorTab = useStore((s) => s.closeEditorTab);
   const saveFile = useStore((s) => s.saveFile);
-  const activeTabId = useStore((s) => s.editorActiveTabId);
-  const openTabs = useStore((s) => s.editorOpenTabs);
-  const modifiedFiles = useStore((s) => s.editorModifiedFiles);
-  const saveErrors = useStore((s) => s.editorSaveError);
   const hasUnsavedChanges = useStore((s) => s.hasUnsavedChanges);
   const saveAllFiles = useStore((s) => s.saveAllFiles);
   const discardChanges = useStore((s) => s.discardChanges);
-
-  // Iter-5: git, watcher, conflict
-  const externalChanges = useStore((s) => s.editorExternalChanges);
   const clearExternalChange = useStore((s) => s.clearExternalChange);
-  const conflictFile = useStore((s) => s.editorConflictFile);
   const forceOverwrite = useStore((s) => s.forceOverwrite);
   const resolveConflict = useStore((s) => s.resolveConflict);
   const setFileMtime = useStore((s) => s.setFileMtime);
@@ -104,9 +123,22 @@ export const ProjectEditorOverlay = ({
   const editorContentRef = useRef<HTMLDivElement>(null);
   const [containerRect, setContainerRect] = useState<DOMRect>(() => new DOMRect());
 
+  // Markdown preview state
+  const [mdPreviewMode, setMdPreviewMode] = useState<MdPreviewMode>('off');
+  const [liveContent, setLiveContent] = useState('');
+  const [splitRatio, setSplitRatio] = useState(() => {
+    try {
+      const stored = localStorage.getItem('editor:mdSplitRatio');
+      return stored ? Math.max(0.2, Math.min(0.8, Number(stored))) : 0.5;
+    } catch {
+      return 0.5;
+    }
+  });
+
   // Iter-4: New state
   const [quickOpenVisible, setQuickOpenVisible] = useState(false);
   const [searchPanelVisible, setSearchPanelVisible] = useState(false);
+  const [goToLineVisible, setGoToLineVisible] = useState(false);
   const [shortcutsHelpVisible, setShortcutsHelpVisible] = useState(false);
   const [sidebarVisible, setSidebarVisibleRaw] = useState(() => {
     try {
@@ -123,6 +155,48 @@ export const ProjectEditorOverlay = ({
 
   // Active tab metadata
   const activeTab = openTabs.find((t) => t.id === activeTabId) ?? null;
+  const isMarkdown = activeTab?.language === 'Markdown';
+
+  // Auto-enable split preview for markdown tabs, reset for non-markdown
+  useEffect(() => {
+    if (isMarkdown) {
+      setMdPreviewMode((m) => (m === 'off' ? 'split' : m));
+    } else {
+      setMdPreviewMode('off');
+    }
+  }, [isMarkdown, activeTabId]);
+
+  // Persist split ratio
+  const handleSplitRatioChange = useCallback((ratio: number) => {
+    setSplitRatio(ratio);
+    try {
+      localStorage.setItem('editor:mdSplitRatio', String(ratio));
+    } catch {
+      // localStorage unavailable
+    }
+  }, []);
+
+  const handleLiveContent = useCallback((content: string) => {
+    setLiveContent(content);
+  }, []);
+
+  const toggleMdSplit = useCallback(() => {
+    setMdPreviewMode((m) => (m === 'split' ? 'off' : 'split'));
+  }, []);
+
+  const toggleMdPreview = useCallback(() => {
+    setMdPreviewMode((m) => (m === 'preview' ? 'off' : 'preview'));
+  }, []);
+
+  // Initialize live content when entering preview mode or switching files
+  useEffect(() => {
+    if (mdPreviewMode !== 'off' && fileContent?.content) {
+      setLiveContent(fileContent.content);
+    }
+  }, [mdPreviewMode, fileContent?.content]);
+
+  // Content for preview: use live content when available, fallback to file content
+  const previewContent = liveContent || fileContent?.content || '';
 
   const loadFileContent = useCallback(
     async (filePath: string) => {
@@ -131,13 +205,19 @@ export const ProjectEditorOverlay = ({
       setFileContent(null);
 
       try {
+        const t0 = performance.now();
         let promise = pendingReads.current.get(filePath);
+        const wasCached = !!promise;
         if (!promise) {
           promise = window.electronAPI.editor.readFile(filePath);
           pendingReads.current.set(filePath, promise);
           void promise.finally(() => pendingReads.current.delete(filePath));
         }
         const result = await promise;
+        const ipcMs = performance.now() - t0;
+        console.debug(
+          `[perf] loadFileContent: IPC=${ipcMs.toFixed(1)}ms, size=${result.size}, truncated=${result.truncated}, cached=${wasCached}, file=${filePath.split('/').pop() ?? ''}`
+        );
         setFileContent(result);
 
         // Track baseline mtime for conflict detection
@@ -157,6 +237,9 @@ export const ProjectEditorOverlay = ({
   // Active tab save error
   const activeSaveError = activeTabId ? (saveErrors[activeTabId] ?? null) : null;
 
+  const pendingRevealFile = useStore((s) => s.editorPendingRevealFile);
+  const revealAndOpenFile = useStore((s) => s.revealAndOpenFile);
+
   // Initialize editor on mount
   useEffect(() => {
     void openEditor(projectPath);
@@ -165,6 +248,18 @@ export const ProjectEditorOverlay = ({
     };
   }, [projectPath, openEditor, closeEditor]);
 
+  // Process pending file reveal after editor initializes.
+  // Guard: wait until the file tree is actually loaded (not null) and not loading.
+  // Without the fileTree check, the effect fires on mount when fileTreeLoading is
+  // still at its initial `false` value — before openEditor sets it to `true`.
+  const fileTreeLoading = useStore((s) => s.editorFileTreeLoading);
+  const fileTreeLoaded = useStore((s) => s.editorFileTree !== null);
+  useEffect(() => {
+    if (pendingRevealFile && !fileTreeLoading && fileTreeLoaded) {
+      void revealAndOpenFile(pendingRevealFile);
+    }
+  }, [pendingRevealFile, fileTreeLoading, fileTreeLoaded, revealAndOpenFile]);
+
   // Keep container rect fresh for selection menu positioning (resize, sidebar toggle)
   useEffect(() => {
     const el = editorContentRef.current;
@@ -180,6 +275,9 @@ export const ProjectEditorOverlay = ({
   useEffect(() => {
     const handleKeyDown = (e: KeyboardEvent) => {
       if (e.key === 'Escape') {
+        // Skip if another handler already consumed this Escape
+        // (e.g. CodeMirror search panel close, or React search input onKeyDown)
+        if (e.defaultPrevented) return;
         // Don't close overlay if a dialog is open — dialog handles its own Escape
         if (quickOpenVisible || searchPanelVisible || shortcutsHelpVisible) return;
         if (showConfirmClose || confirmCloseTabId) return;
@@ -381,6 +479,10 @@ export const ProjectEditorOverlay = ({
     setSearchPanelVisible((v) => !v);
   }, []);
 
+  const toggleGoToLine = useCallback(() => {
+    setGoToLineVisible((v) => !v);
+  }, []);
+
   const toggleSidebar = useCallback(() => {
     setSidebarVisibleRaw((v) => {
       const next = !v;
@@ -410,8 +512,11 @@ export const ProjectEditorOverlay = ({
   useEditorKeyboardShortcuts({
     onToggleQuickOpen: toggleQuickOpen,
     onToggleSearchPanel: toggleSearchPanel,
+    onToggleGoToLine: toggleGoToLine,
     onToggleSidebar: toggleSidebar,
     onClose: handleCloseRequest,
+    onToggleMdSplit: isMarkdown ? toggleMdSplit : undefined,
+    onToggleMdPreview: isMarkdown ? toggleMdPreview : undefined,
   });
 
   const projectName = projectPath.split('/').pop() ?? projectPath;
@@ -437,35 +542,46 @@ export const ProjectEditorOverlay = ({
         <div className="flex items-center gap-1">
           <Tooltip>
             <TooltipTrigger asChild>
-              <button
+              <Button
+                variant="ghost"
+                size="icon"
+                className="size-7 text-text-muted"
                 onClick={handleManualRefresh}
-                className="rounded p-1 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
                 aria-label="Refresh (F5)"
               >
                 <RefreshCw className="size-4" />
-              </button>
+              </Button>
             </TooltipTrigger>
             <TooltipContent side="bottom">Refresh git status (F5)</TooltipContent>
           </Tooltip>
           <Tooltip>
             <TooltipTrigger asChild>
-              <button
+              <Button
+                variant="ghost"
+                size="icon"
+                className="size-7 text-text-muted"
                 onClick={() => setShortcutsHelpVisible(true)}
-                className="rounded p-1 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
                 aria-label="Keyboard shortcuts"
               >
                 <HelpCircle className="size-4" />
-              </button>
+              </Button>
             </TooltipTrigger>
             <TooltipContent side="bottom">Keyboard shortcuts</TooltipContent>
           </Tooltip>
-          <button
-            onClick={handleCloseRequest}
-            className="rounded p-1 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
-            aria-label="Close editor"
-          >
-            <X className="size-4" />
-          </button>
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <Button
+                variant="ghost"
+                size="icon"
+                className="size-7 text-text-muted"
+                onClick={handleCloseRequest}
+                aria-label="Close editor"
+              >
+                <X className="size-4" />
+              </Button>
+            </TooltipTrigger>
+            <TooltipContent side="bottom">Close editor (Esc)</TooltipContent>
+          </Tooltip>
         </div>
       </div>
 
@@ -491,13 +607,15 @@ export const ProjectEditorOverlay = ({
               </span>
               <Tooltip>
                 <TooltipTrigger asChild>
-                  <button
+                  <Button
+                    variant="ghost"
+                    size="icon"
+                    className="size-6 text-text-muted"
                     onClick={toggleSidebar}
-                    className="rounded p-0.5 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
                     aria-label="Hide sidebar"
                   >
                     <PanelLeftClose className="size-3.5" />
-                  </button>
+                  </Button>
                 </TooltipTrigger>
                 <TooltipContent side="bottom">
                   Hide sidebar ({shortcutLabel('⌘ B', 'Ctrl+B')})
@@ -505,7 +623,22 @@ export const ProjectEditorOverlay = ({
               </Tooltip>
             </div>
             <div className="flex-1 overflow-hidden">
-              <EditorFileTree selectedFilePath={activeTabId} onFileSelect={handleFileSelect} />
+              <EditorFileTree
+                selectedFilePath={activeTabId}
+                onFileSelect={handleFileSelect}
+                onCreateTask={
+                  onEditorAction
+                    ? (filePath: string) =>
+                        onEditorAction(buildFileAction('createTask', filePath, projectPath))
+                    : undefined
+                }
+                onSendMessage={
+                  onEditorAction
+                    ? (filePath: string) =>
+                        onEditorAction(buildFileAction('sendMessage', filePath, projectPath))
+                    : undefined
+                }
+              />
             </div>
           </div>
         )}
@@ -514,13 +647,14 @@ export const ProjectEditorOverlay = ({
         {!sidebarVisible && !searchPanelVisible && (
           <Tooltip>
             <TooltipTrigger asChild>
-              <button
+              <Button
+                variant="ghost"
+                className="flex h-full w-6 shrink-0 items-start justify-center rounded-none border-r border-border bg-surface-sidebar pt-2 text-text-muted"
                 onClick={toggleSidebar}
-                className="flex h-full w-6 shrink-0 items-start justify-center border-r border-border bg-surface-sidebar pt-2 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
                 aria-label="Show sidebar"
               >
                 <PanelLeftOpen className="size-3.5" />
-              </button>
+              </Button>
             </TooltipTrigger>
             <TooltipContent side="right">
               Show sidebar ({shortcutLabel('⌘ B', 'Ctrl+B')})
@@ -534,25 +668,34 @@ export const ProjectEditorOverlay = ({
           <EditorTabBar onRequestCloseTab={handleRequestCloseTab} />
 
           {/* Toolbar */}
-          <EditorToolbar />
+          <EditorToolbar
+            isMarkdown={isMarkdown}
+            mdPreviewMode={mdPreviewMode}
+            onToggleSplit={toggleMdSplit}
+            onToggleFullPreview={toggleMdPreview}
+          />
 
           {/* Draft recovery banner */}
           {draftRecoveredFile && activeTabId === draftRecoveredFile && (
             <div className="flex shrink-0 items-center gap-2 border-b border-amber-500/30 bg-amber-500/10 px-3 py-1.5 text-xs text-amber-300">
               <RotateCcw className="size-3.5 shrink-0" />
               <span>Recovered unsaved changes from a previous session.</span>
-              <button
+              <Button
+                variant="ghost"
+                size="sm"
+                className="ml-auto h-auto px-2 py-0.5"
                 onClick={handleDismissDraftBanner}
-                className="ml-auto rounded px-2 py-0.5 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
               >
                 Keep
-              </button>
-              <button
+              </Button>
+              <Button
+                variant="destructive"
+                size="sm"
+                className="h-auto px-2 py-0.5"
                 onClick={handleDiscardDraft}
-                className="rounded px-2 py-0.5 text-red-400 transition-colors hover:bg-red-400/10"
               >
                 Discard
-              </button>
+              </Button>
             </div>
           )}
 
@@ -561,12 +704,14 @@ export const ProjectEditorOverlay = ({
             <div className="flex shrink-0 items-center gap-2 border-b border-red-500/30 bg-red-500/10 px-3 py-1.5 text-xs text-red-300">
               <AlertTriangle className="size-3.5 shrink-0" />
               <span className="truncate">Save failed: {activeSaveError}</span>
-              <button
+              <Button
+                variant="ghost"
+                size="sm"
+                className="ml-auto h-auto shrink-0 px-2 py-0.5"
                 onClick={() => activeTabId && void saveFile(activeTabId)}
-                className="ml-auto shrink-0 rounded px-2 py-0.5 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
               >
                 Retry
-              </button>
+              </Button>
             </div>
           )}
 
@@ -580,26 +725,32 @@ export const ProjectEditorOverlay = ({
                   : 'File changed on disk.'}
               </span>
               {externalChanges[activeTabId] === 'delete' ? (
-                <button
+                <Button
+                  variant="ghost"
+                  size="sm"
+                  className="ml-auto h-auto px-2 py-0.5"
                   onClick={() => closeEditorTab(activeTabId)}
-                  className="ml-auto rounded px-2 py-0.5 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
                 >
                   Close tab
-                </button>
+                </Button>
               ) : (
                 <>
-                  <button
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    className="ml-auto h-auto px-2 py-0.5"
                     onClick={handleReloadExternalChange}
-                    className="ml-auto rounded px-2 py-0.5 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
                   >
                     Reload
-                  </button>
-                  <button
+                  </Button>
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    className="h-auto px-2 py-0.5"
                     onClick={handleKeepMine}
-                    className="rounded px-2 py-0.5 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
                   >
                     Keep mine
-                  </button>
+                  </Button>
                 </>
               )}
             </div>
@@ -620,18 +771,42 @@ export const ProjectEditorOverlay = ({
             )}
 
             {fileContent && !fileContent.isBinary && activeTabId && (
-              <EditorErrorBoundary filePath={activeTabId} onRetry={handleRetry}>
-                <CodeMirrorEditor
-                  key={`${activeTabId}-${editorResetKey}`}
-                  filePath={activeTabId}
-                  content={fileContent.content}
-                  fileName={activeTabId.split('/').pop() ?? 'file'}
-                  mtimeMs={fileContent.mtimeMs}
-                  onCursorChange={handleCursorChange}
-                  onDraftRecovered={handleDraftRecovered}
-                  onSelectionChange={setSelectionInfo}
-                />
-              </EditorErrorBoundary>
+              <div className="flex h-full">
+                {/* Code editor — always mounted, hidden via display:none in preview mode */}
+                <div
+                  className="h-full overflow-hidden"
+                  style={{
+                    display: mdPreviewMode === 'preview' ? 'none' : 'block',
+                    width: mdPreviewMode === 'split' ? `${splitRatio * 100}%` : '100%',
+                  }}
+                >
+                  <EditorErrorBoundary filePath={activeTabId} onRetry={handleRetry}>
+                    <CodeMirrorEditor
+                      key={`${activeTabId}-${editorResetKey}`}
+                      filePath={activeTabId}
+                      content={fileContent.content}
+                      fileName={activeTabId.split('/').pop() ?? 'file'}
+                      mtimeMs={fileContent.mtimeMs}
+                      onCursorChange={handleCursorChange}
+                      onDraftRecovered={handleDraftRecovered}
+                      onSelectionChange={setSelectionInfo}
+                      onDocChange={mdPreviewMode !== 'off' ? handleLiveContent : undefined}
+                    />
+                  </EditorErrorBoundary>
+                </div>
+
+                {/* Resize handle + Preview pane */}
+                {mdPreviewMode !== 'off' && (
+                  <MarkdownSplitView
+                    content={previewContent}
+                    mode={mdPreviewMode}
+                    splitRatio={splitRatio}
+                    onSplitRatioChange={handleSplitRatioChange}
+                    viewKey={activeTabId}
+                    baseDir={activeTabId?.substring(0, activeTabId.lastIndexOf('/'))}
+                  />
+                )}
+              </div>
             )}
 
             {!fileLoading && !fileError && !fileContent && !activeTabId && <EditorEmptyState />}
@@ -668,101 +843,80 @@ export const ProjectEditorOverlay = ({
         />
       )}
 
+      {/* Go to Line dialog */}
+      {goToLineVisible && <GoToLineDialog onClose={() => setGoToLineVisible(false)} />}
+
       {/* Shortcuts help modal */}
       {shortcutsHelpVisible && (
         <EditorShortcutsHelp onClose={() => setShortcutsHelpVisible(false)} />
       )}
 
       {/* Unsaved changes confirmation dialog — overlay close */}
-      {showConfirmClose && (
-        <div className="fixed inset-0 z-[60] flex items-center justify-center bg-black/50">
-          <div className="w-96 rounded-lg border border-border bg-surface p-6 shadow-xl">
-            <h3 className="mb-2 text-sm font-semibold text-text">Unsaved Changes</h3>
-            <p className="mb-4 text-sm text-text-secondary">
+      <Dialog open={showConfirmClose} onOpenChange={(open) => !open && handleCancelClose()}>
+        <DialogContent className="w-96 max-w-96">
+          <DialogHeader>
+            <DialogTitle className="text-sm">Unsaved Changes</DialogTitle>
+            <DialogDescription>
               You have unsaved changes. What would you like to do?
-            </p>
-            <div className="flex justify-end gap-2">
-              <button
-                onClick={handleCancelClose}
-                className="rounded px-3 py-1.5 text-sm text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
-              >
-                Cancel
-              </button>
-              <button
-                onClick={handleDiscardAndClose}
-                className="rounded px-3 py-1.5 text-sm text-red-400 transition-colors hover:bg-red-400/10"
-              >
-                Discard & Close
-              </button>
-              <button
-                onClick={() => void handleSaveAndClose()}
-                className="rounded bg-blue-600 px-3 py-1.5 text-sm text-white transition-colors hover:bg-blue-500"
-              >
-                Save All & Close
-              </button>
-            </div>
-          </div>
-        </div>
-      )}
+            </DialogDescription>
+          </DialogHeader>
+          <DialogFooter>
+            <Button variant="ghost" size="sm" onClick={handleCancelClose}>
+              Cancel
+            </Button>
+            <Button variant="destructive" size="sm" onClick={handleDiscardAndClose}>
+              Discard & Close
+            </Button>
+            <Button size="sm" onClick={() => void handleSaveAndClose()}>
+              Save All & Close
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
 
       {/* Save conflict dialog */}
-      {conflictFile && (
-        <div className="fixed inset-0 z-[60] flex items-center justify-center bg-black/50">
-          <div className="w-96 rounded-lg border border-border bg-surface p-6 shadow-xl">
-            <h3 className="mb-2 text-sm font-semibold text-text">Save Conflict</h3>
-            <p className="mb-4 text-sm text-text-secondary">
+      <Dialog open={!!conflictFile} onOpenChange={(open) => !open && handleCancelConflict()}>
+        <DialogContent className="w-96 max-w-96">
+          <DialogHeader>
+            <DialogTitle className="text-sm">Save Conflict</DialogTitle>
+            <DialogDescription>
               The file has been modified externally since you opened it. Overwrite with your
               changes?
-            </p>
-            <div className="flex justify-end gap-2">
-              <button
-                onClick={handleCancelConflict}
-                className="rounded px-3 py-1.5 text-sm text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
-              >
-                Cancel
-              </button>
-              <button
-                onClick={handleForceOverwrite}
-                className="rounded bg-orange-600 px-3 py-1.5 text-sm text-white transition-colors hover:bg-orange-500"
-              >
-                Overwrite
-              </button>
-            </div>
-          </div>
-        </div>
-      )}
+            </DialogDescription>
+          </DialogHeader>
+          <DialogFooter>
+            <Button variant="ghost" size="sm" onClick={handleCancelConflict}>
+              Cancel
+            </Button>
+            <Button variant="destructive" size="sm" onClick={handleForceOverwrite}>
+              Overwrite
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
 
       {/* Unsaved changes confirmation dialog — single tab close */}
-      {confirmCloseTabId && (
-        <div className="fixed inset-0 z-[60] flex items-center justify-center bg-black/50">
-          <div className="w-96 rounded-lg border border-border bg-surface p-6 shadow-xl">
-            <h3 className="mb-2 text-sm font-semibold text-text">Unsaved Changes</h3>
-            <p className="mb-4 text-sm text-text-secondary">
+      <Dialog open={!!confirmCloseTabId} onOpenChange={(open) => !open && handleCancelCloseTab()}>
+        <DialogContent className="w-96 max-w-96">
+          <DialogHeader>
+            <DialogTitle className="text-sm">Unsaved Changes</DialogTitle>
+            <DialogDescription>
               This file has unsaved changes. What would you like to do?
-            </p>
-            <div className="flex justify-end gap-2">
-              <button
-                onClick={handleCancelCloseTab}
-                className="rounded px-3 py-1.5 text-sm text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
-              >
-                Cancel
-              </button>
-              <button
-                onClick={handleDiscardAndCloseTab}
-                className="rounded px-3 py-1.5 text-sm text-red-400 transition-colors hover:bg-red-400/10"
-              >
-                Discard
-              </button>
-              <button
-                onClick={() => void handleSaveAndCloseTab()}
-                className="rounded bg-blue-600 px-3 py-1.5 text-sm text-white transition-colors hover:bg-blue-500"
-              >
-                Save
-              </button>
-            </div>
-          </div>
-        </div>
-      )}
+            </DialogDescription>
+          </DialogHeader>
+          <DialogFooter>
+            <Button variant="ghost" size="sm" onClick={handleCancelCloseTab}>
+              Cancel
+            </Button>
+            <Button variant="destructive" size="sm" onClick={handleDiscardAndCloseTab}>
+              Discard
+            </Button>
+            <Button size="sm" onClick={() => void handleSaveAndCloseTab()}>
+              Save
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
     </div>
   );
 };
diff --git a/src/renderer/components/team/editor/QuickOpenDialog.tsx b/src/renderer/components/team/editor/QuickOpenDialog.tsx
index 3e8d2c37..eaca7c3e 100644
--- a/src/renderer/components/team/editor/QuickOpenDialog.tsx
+++ b/src/renderer/components/team/editor/QuickOpenDialog.tsx
@@ -37,10 +37,17 @@ export const QuickOpenDialog = ({
   const [allFiles, setAllFiles] = useState<QuickOpenFile[]>([]);
   const [loading, setLoading] = useState(true);
 
+  // Reset loading state when projectPath changes (React-recommended
+  // "adjusting state when props change" pattern without effects or refs)
+  const [prevProjectPath, setPrevProjectPath] = useState(projectPath);
+  if (prevProjectPath !== projectPath) {
+    setPrevProjectPath(projectPath);
+    setLoading(true);
+  }
+
   // Load all project files on mount via backend API
   useEffect(() => {
     let cancelled = false;
-    setLoading(true);
 
     window.electronAPI.editor
       .listFiles()
diff --git a/src/renderer/components/team/editor/SearchInFilesPanel.tsx b/src/renderer/components/team/editor/SearchInFilesPanel.tsx
index cfcbc802..46de8da7 100644
--- a/src/renderer/components/team/editor/SearchInFilesPanel.tsx
+++ b/src/renderer/components/team/editor/SearchInFilesPanel.tsx
@@ -5,13 +5,14 @@
  * Results are clickable to open the file at the matched line.
  */
 
-import { useCallback, useEffect, useRef, useState } from 'react';
+import React, { useCallback, useEffect, useRef, useState } from 'react';
 
 import { api } from '@renderer/api';
+import { Button } from '@renderer/components/ui/button';
 import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { Loader2, Search, X } from 'lucide-react';
 
-import { getFileIcon } from './fileIcons';
+import { FileIcon } from './FileIcon';
 
 import type { SearchFileResult, SearchInFilesResult } from '@shared/types/editor';
 
@@ -154,13 +155,20 @@ export const SearchInFilesPanel = ({
       {/* Header */}
       <div className="flex items-center justify-between border-b border-border px-3 py-2">
         <span className="text-xs font-medium text-text-secondary">Search in Files</span>
-        <button
-          onClick={onClose}
-          className="rounded p-0.5 text-text-muted transition-colors hover:bg-surface-raised hover:text-text"
-          aria-label="Close search"
-        >
-          <X className="size-3.5" />
-        </button>
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <Button
+              variant="ghost"
+              size="icon"
+              className="size-6 text-text-muted"
+              onClick={onClose}
+              aria-label="Close search"
+            >
+              <X className="size-3.5" />
+            </Button>
+          </TooltipTrigger>
+          <TooltipContent side="bottom">Close search (Esc)</TooltipContent>
+        </Tooltip>
       </div>
 
       {/* Search input */}
@@ -259,9 +267,6 @@ const SearchFileGroup = ({
   const dirPath = relativePath.includes('/')
     ? relativePath.slice(0, relativePath.lastIndexOf('/'))
     : '';
-  const iconInfo = getFileIcon(fileName);
-  const Icon = iconInfo.icon;
-
   return (
     <div className="border-border/50 border-b">
       <button
@@ -269,7 +274,7 @@ const SearchFileGroup = ({
         className="flex w-full items-center gap-1.5 px-3 py-1 text-left transition-colors hover:bg-surface-raised"
       >
         <span className="text-[10px] text-text-muted">{expanded ? '▼' : '▶'}</span>
-        <Icon className="size-3.5 shrink-0" style={{ color: iconInfo.color }} />
+        <FileIcon fileName={fileName} className="size-3.5" />
         <span className="truncate text-xs font-medium text-text">{fileName}</span>
         {dirPath && <span className="ml-1 truncate text-[10px] text-text-muted">{dirPath}</span>}
         <span className="ml-auto shrink-0 text-[10px] text-text-muted">
@@ -310,11 +315,11 @@ interface HighlightedLineProps {
   caseSensitive: boolean;
 }
 
-const HighlightedLine = ({
+const HighlightedLine = React.memo(function HighlightedLine({
   text,
   query,
   caseSensitive,
-}: HighlightedLineProps): React.ReactElement => {
+}: HighlightedLineProps): React.ReactElement {
   if (!query) {
     return <span className="truncate text-[11px] text-text-secondary">{text}</span>;
   }
@@ -351,4 +356,4 @@ const HighlightedLine = ({
   }
 
   return <span className="truncate text-[11px]">{parts}</span>;
-};
+});
diff --git a/src/renderer/components/team/editor/fileIcons.ts b/src/renderer/components/team/editor/fileIcons.ts
index bb833f84..435dd737 100644
--- a/src/renderer/components/team/editor/fileIcons.ts
+++ b/src/renderer/components/team/editor/fileIcons.ts
@@ -1,5 +1,8 @@
 /**
- * File icon mapping — maps file extensions to lucide-react icon names and colors.
+ * File icon mapping — maps file extensions/names to icon info.
+ *
+ * For programming languages and dev tools, uses Devicon CDN SVGs (colorful logos).
+ * For generic file types (images, fonts, configs), falls back to lucide-react icons.
  */
 
 import {
@@ -7,7 +10,6 @@ import {
   Code,
   Database,
   File,
-  FileCode,
   FileJson,
   FileText,
   FileType,
@@ -26,6 +28,22 @@ import type { LucideIcon } from 'lucide-react';
 export interface FileIconInfo {
   icon: LucideIcon;
   color: string;
+  /** Devicon slug — when set, FileIcon component renders the real logo from CDN */
+  deviconSlug?: string;
+}
+
+// =============================================================================
+// Devicon CDN
+// =============================================================================
+
+const DEVICON_BASE = 'https://cdn.jsdelivr.net/gh/devicons/devicon@latest/icons';
+
+/**
+ * Build Devicon CDN URL for a given slug.
+ * Uses `-original` variant (colorful) with `-wordmark` fallback.
+ */
+export function getDeviconUrl(slug: string): string {
+  return `${DEVICON_BASE}/${slug}/${slug}-original.svg`;
 }
 
 // =============================================================================
@@ -34,74 +52,75 @@ export interface FileIconInfo {
 
 const EXTENSION_MAP: Record<string, FileIconInfo> = {
   // TypeScript / JavaScript
-  ts: { icon: FileCode, color: '#3178c6' },
-  tsx: { icon: FileCode, color: '#3178c6' },
-  js: { icon: FileCode, color: '#f7df1e' },
-  jsx: { icon: FileCode, color: '#61dafb' },
-  mjs: { icon: FileCode, color: '#f7df1e' },
-  cjs: { icon: FileCode, color: '#f7df1e' },
+  ts: { icon: Code, color: '#3178c6', deviconSlug: 'typescript' },
+  tsx: { icon: Code, color: '#3178c6', deviconSlug: 'react' },
+  js: { icon: Code, color: '#f7df1e', deviconSlug: 'javascript' },
+  jsx: { icon: Code, color: '#61dafb', deviconSlug: 'react' },
+  mjs: { icon: Code, color: '#f7df1e', deviconSlug: 'javascript' },
+  cjs: { icon: Code, color: '#f7df1e', deviconSlug: 'javascript' },
 
   // Web
-  html: { icon: Code, color: '#e34c26' },
-  htm: { icon: Code, color: '#e34c26' },
-  css: { icon: FileCode, color: '#563d7c' },
-  scss: { icon: FileCode, color: '#c6538c' },
-  less: { icon: FileCode, color: '#1d365d' },
-  vue: { icon: FileCode, color: '#42b883' },
-  svelte: { icon: FileCode, color: '#ff3e00' },
+  html: { icon: Code, color: '#e34c26', deviconSlug: 'html5' },
+  htm: { icon: Code, color: '#e34c26', deviconSlug: 'html5' },
+  css: { icon: Code, color: '#1572b6', deviconSlug: 'css3' },
+  scss: { icon: Code, color: '#c6538c', deviconSlug: 'sass' },
+  less: { icon: Code, color: '#1d365d', deviconSlug: 'less' },
+  vue: { icon: Code, color: '#42b883', deviconSlug: 'vuejs' },
+  svelte: { icon: Code, color: '#ff3e00', deviconSlug: 'svelte' },
 
-  // Data / Config
-  json: { icon: FileJson, color: '#cbcb41' },
+  // Data / Config (no devicon — lucide fallbacks)
+  json: { icon: FileJson, color: '#cbcb41', deviconSlug: 'json' },
   jsonl: { icon: FileJson, color: '#cbcb41' },
-  yaml: { icon: Settings, color: '#cb171e' },
-  yml: { icon: Settings, color: '#cb171e' },
+  yaml: { icon: Settings, color: '#cb171e', deviconSlug: 'yaml' },
+  yml: { icon: Settings, color: '#cb171e', deviconSlug: 'yaml' },
   toml: { icon: Settings, color: '#9c4121' },
-  xml: { icon: Code, color: '#e37933' },
+  xml: { icon: Code, color: '#e37933', deviconSlug: 'xml' },
   csv: { icon: Database, color: '#4caf50' },
 
   // Markdown / Text
-  md: { icon: FileText, color: '#519aba' },
-  mdx: { icon: FileText, color: '#519aba' },
+  md: { icon: FileText, color: '#519aba', deviconSlug: 'markdown' },
+  mdx: { icon: FileText, color: '#519aba', deviconSlug: 'markdown' },
   txt: { icon: FileText, color: '#89949f' },
   rst: { icon: FileText, color: '#89949f' },
 
   // Python
-  py: { icon: FileCode, color: '#3572a5' },
-  pyx: { icon: FileCode, color: '#3572a5' },
-  pyi: { icon: FileCode, color: '#3572a5' },
+  py: { icon: Code, color: '#3572a5', deviconSlug: 'python' },
+  pyx: { icon: Code, color: '#3572a5', deviconSlug: 'python' },
+  pyi: { icon: Code, color: '#3572a5', deviconSlug: 'python' },
 
   // Rust
-  rs: { icon: FileCode, color: '#dea584' },
+  rs: { icon: Code, color: '#dea584', deviconSlug: 'rust' },
 
   // Go
-  go: { icon: FileCode, color: '#00add8' },
+  go: { icon: Code, color: '#00add8', deviconSlug: 'go' },
 
   // Ruby
-  rb: { icon: FileCode, color: '#cc342d' },
-  gemspec: { icon: FileCode, color: '#cc342d' },
+  rb: { icon: Code, color: '#cc342d', deviconSlug: 'ruby' },
+  gemspec: { icon: Code, color: '#cc342d', deviconSlug: 'ruby' },
 
   // Java / Kotlin
-  java: { icon: FileCode, color: '#b07219' },
-  kt: { icon: FileCode, color: '#a97bff' },
-  kts: { icon: FileCode, color: '#a97bff' },
+  java: { icon: Code, color: '#b07219', deviconSlug: 'java' },
+  kt: { icon: Code, color: '#a97bff', deviconSlug: 'kotlin' },
+  kts: { icon: Code, color: '#a97bff', deviconSlug: 'kotlin' },
 
-  // C / C++
-  c: { icon: FileCode, color: '#555555' },
-  h: { icon: FileCode, color: '#555555' },
-  cpp: { icon: FileCode, color: '#f34b7d' },
-  hpp: { icon: FileCode, color: '#f34b7d' },
-  cc: { icon: FileCode, color: '#f34b7d' },
+  // C / C++ / C#
+  c: { icon: Code, color: '#555555', deviconSlug: 'c' },
+  h: { icon: Code, color: '#555555', deviconSlug: 'c' },
+  cpp: { icon: Code, color: '#f34b7d', deviconSlug: 'cplusplus' },
+  hpp: { icon: Code, color: '#f34b7d', deviconSlug: 'cplusplus' },
+  cc: { icon: Code, color: '#f34b7d', deviconSlug: 'cplusplus' },
+  cs: { icon: Code, color: '#178600', deviconSlug: 'csharp' },
 
   // Shell
-  sh: { icon: Terminal, color: '#89e051' },
-  bash: { icon: Terminal, color: '#89e051' },
-  zsh: { icon: Terminal, color: '#89e051' },
+  sh: { icon: Terminal, color: '#89e051', deviconSlug: 'bash' },
+  bash: { icon: Terminal, color: '#89e051', deviconSlug: 'bash' },
+  zsh: { icon: Terminal, color: '#89e051', deviconSlug: 'bash' },
   fish: { icon: Terminal, color: '#89e051' },
 
   // SQL
-  sql: { icon: Database, color: '#e38c00' },
+  sql: { icon: Database, color: '#e38c00', deviconSlug: 'azuresqldatabase' },
 
-  // Images
+  // Images (no devicon — lucide Image icon)
   png: { icon: Image, color: '#a074c4' },
   jpg: { icon: Image, color: '#a074c4' },
   jpeg: { icon: Image, color: '#a074c4' },
@@ -110,46 +129,76 @@ const EXTENSION_MAP: Record<string, FileIconInfo> = {
   ico: { icon: Image, color: '#a074c4' },
   webp: { icon: Image, color: '#a074c4' },
 
-  // Fonts
+  // Fonts (no devicon — lucide FileType icon)
   woff: { icon: FileType, color: '#89949f' },
   woff2: { icon: FileType, color: '#89949f' },
   ttf: { icon: FileType, color: '#89949f' },
   otf: { icon: FileType, color: '#89949f' },
 
-  // Config files
+  // Config files (no devicon — lucide icons)
   env: { icon: Lock, color: '#e5a00d' },
   ini: { icon: Settings, color: '#89949f' },
   conf: { icon: Settings, color: '#89949f' },
   cfg: { icon: Settings, color: '#89949f' },
 
-  // Other
-  graphql: { icon: Braces, color: '#e535ab' },
-  gql: { icon: Braces, color: '#e535ab' },
-  proto: { icon: Code, color: '#89949f' },
-  dart: { icon: FileCode, color: '#00b4ab' },
-  swift: { icon: FileCode, color: '#f05138' },
-  php: { icon: FileCode, color: '#4f5d95' },
+  // Other languages
+  graphql: { icon: Braces, color: '#e535ab', deviconSlug: 'graphql' },
+  gql: { icon: Braces, color: '#e535ab', deviconSlug: 'graphql' },
+  proto: { icon: Code, color: '#89949f', deviconSlug: 'protobuf' },
+  dart: { icon: Code, color: '#00b4ab', deviconSlug: 'dart' },
+  swift: { icon: Code, color: '#f05138', deviconSlug: 'swift' },
+  php: { icon: Code, color: '#4f5d95', deviconSlug: 'php' },
+  r: { icon: Code, color: '#276dc3', deviconSlug: 'r' },
+  lua: { icon: Code, color: '#000080', deviconSlug: 'lua' },
+  pl: { icon: Code, color: '#39457e', deviconSlug: 'perl' },
+  scala: { icon: Code, color: '#dc322f', deviconSlug: 'scala' },
+  groovy: { icon: Code, color: '#4298b8', deviconSlug: 'groovy' },
+  ex: { icon: Code, color: '#6e4a7e', deviconSlug: 'elixir' },
+  exs: { icon: Code, color: '#6e4a7e', deviconSlug: 'elixir' },
+  erl: { icon: Code, color: '#b83998', deviconSlug: 'erlang' },
+  hs: { icon: Code, color: '#5e5086', deviconSlug: 'haskell' },
+  clj: { icon: Code, color: '#db5855', deviconSlug: 'clojure' },
+  fs: { icon: Code, color: '#b845fc', deviconSlug: 'fsharp' },
+  zig: { icon: Code, color: '#f7a41d', deviconSlug: 'zig' },
+  nim: { icon: Code, color: '#ffc200', deviconSlug: 'nimble' },
+  tf: { icon: Code, color: '#7b42bc', deviconSlug: 'terraform' },
+  hcl: { icon: Code, color: '#7b42bc', deviconSlug: 'terraform' },
 };
 
 // Special full filename mapping
 const FILENAME_MAP: Record<string, FileIconInfo> = {
-  Dockerfile: { icon: FileCode, color: '#2496ed' },
-  'docker-compose.yml': { icon: FileCode, color: '#2496ed' },
-  'docker-compose.yaml': { icon: FileCode, color: '#2496ed' },
+  Dockerfile: { icon: Code, color: '#2496ed', deviconSlug: 'docker' },
+  'docker-compose.yml': { icon: Code, color: '#2496ed', deviconSlug: 'docker' },
+  'docker-compose.yaml': { icon: Code, color: '#2496ed', deviconSlug: 'docker' },
   Makefile: { icon: Terminal, color: '#427819' },
-  Rakefile: { icon: Terminal, color: '#cc342d' },
-  Gemfile: { icon: FileCode, color: '#cc342d' },
-  '.gitignore': { icon: Settings, color: '#f05032' },
-  '.gitattributes': { icon: Settings, color: '#f05032' },
-  '.eslintrc': { icon: Settings, color: '#4b32c3' },
+  Rakefile: { icon: Terminal, color: '#cc342d', deviconSlug: 'ruby' },
+  Gemfile: { icon: Code, color: '#cc342d', deviconSlug: 'ruby' },
+  '.gitignore': { icon: Settings, color: '#f05032', deviconSlug: 'git' },
+  '.gitattributes': { icon: Settings, color: '#f05032', deviconSlug: 'git' },
+  '.eslintrc': { icon: Settings, color: '#4b32c3', deviconSlug: 'eslint' },
   '.prettierrc': { icon: Settings, color: '#56b3b4' },
-  'tsconfig.json': { icon: Settings, color: '#3178c6' },
-  'package.json': { icon: FileJson, color: '#cb3837' },
+  'tsconfig.json': { icon: Settings, color: '#3178c6', deviconSlug: 'typescript' },
+  'package.json': { icon: FileJson, color: '#cb3837', deviconSlug: 'nodejs' },
   'pnpm-lock.yaml': { icon: Lock, color: '#f69220' },
-  'package-lock.json': { icon: Lock, color: '#cb3837' },
-  'yarn.lock': { icon: Lock, color: '#2c8ebb' },
+  'package-lock.json': { icon: Lock, color: '#cb3837', deviconSlug: 'npm' },
+  'yarn.lock': { icon: Lock, color: '#2c8ebb', deviconSlug: 'yarn' },
   LICENSE: { icon: FileText, color: '#d9b611' },
   'CLAUDE.md': { icon: FileText, color: '#d97706' },
+  'Cargo.toml': { icon: Settings, color: '#dea584', deviconSlug: 'rust' },
+  'go.mod': { icon: Settings, color: '#00add8', deviconSlug: 'go' },
+  'go.sum': { icon: Lock, color: '#00add8', deviconSlug: 'go' },
+  '.dockerignore': { icon: Settings, color: '#2496ed', deviconSlug: 'docker' },
+  'vite.config.ts': { icon: Settings, color: '#646cff', deviconSlug: 'vitejs' },
+  'vite.config.js': { icon: Settings, color: '#646cff', deviconSlug: 'vitejs' },
+  'webpack.config.js': { icon: Settings, color: '#8dd6f9', deviconSlug: 'webpack' },
+  'webpack.config.ts': { icon: Settings, color: '#8dd6f9', deviconSlug: 'webpack' },
+  '.babelrc': { icon: Settings, color: '#f5da55', deviconSlug: 'babel' },
+  'babel.config.js': { icon: Settings, color: '#f5da55', deviconSlug: 'babel' },
+  'tailwind.config.js': { icon: Settings, color: '#06b6d4', deviconSlug: 'tailwindcss' },
+  'tailwind.config.ts': { icon: Settings, color: '#06b6d4', deviconSlug: 'tailwindcss' },
+  'next.config.js': { icon: Settings, color: '#000000', deviconSlug: 'nextjs' },
+  'next.config.mjs': { icon: Settings, color: '#000000', deviconSlug: 'nextjs' },
+  'nuxt.config.ts': { icon: Settings, color: '#00dc82', deviconSlug: 'nuxtjs' },
 };
 
 const DEFAULT_ICON: FileIconInfo = { icon: File, color: '#89949f' };
diff --git a/src/renderer/components/team/kanban/KanbanTaskCard.tsx b/src/renderer/components/team/kanban/KanbanTaskCard.tsx
index b9d3345d..9ced4abf 100644
--- a/src/renderer/components/team/kanban/KanbanTaskCard.tsx
+++ b/src/renderer/components/team/kanban/KanbanTaskCard.tsx
@@ -1,10 +1,11 @@
-import { useEffect, useMemo, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 
 import { MemberBadge } from '@renderer/components/team/MemberBadge';
 import { UnreadCommentsBadge } from '@renderer/components/team/UnreadCommentsBadge';
 import { Badge } from '@renderer/components/ui/badge';
 import { Button } from '@renderer/components/ui/button';
 import { Popover, PopoverContent, PopoverTrigger } from '@renderer/components/ui/popover';
+import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { useUnreadCommentCount } from '@renderer/hooks/useUnreadCommentCount';
 import { useStore } from '@renderer/store';
 import { buildMemberColorMap } from '@renderer/utils/memberHelpers';
@@ -76,6 +77,41 @@ const DependencyBadge = ({
   );
 };
 
+const TruncatedTitle = ({
+  text,
+  className,
+}: {
+  text: string;
+  className?: string;
+}): React.JSX.Element => {
+  const ref = useRef<HTMLHeadingElement>(null);
+  const [isTruncated, setIsTruncated] = useState(false);
+
+  const checkTruncation = useCallback(() => {
+    const el = ref.current;
+    if (el) {
+      setIsTruncated(el.scrollWidth > el.clientWidth);
+    }
+  }, []);
+
+  return (
+    <Tooltip open={isTruncated ? undefined : false}>
+      <TooltipTrigger asChild>
+        <h5
+          ref={ref}
+          className={`truncate text-sm font-medium text-[var(--color-text)] ${className ?? ''}`}
+          onMouseEnter={checkTruncation}
+        >
+          {text}
+        </h5>
+      </TooltipTrigger>
+      <TooltipContent side="top" align="start">
+        {text}
+      </TooltipContent>
+    </Tooltip>
+  );
+};
+
 const CancelTaskButton = ({
   taskId,
   onConfirm,
@@ -228,11 +264,7 @@ export const KanbanTaskCard = ({
             #{task.id}
           </Badge>
           {task.owner ? <MemberBadge name={task.owner} color={colorMap.get(task.owner)} /> : null}
-          {!compact && (
-            <h5 className="min-w-0 truncate text-sm font-medium text-[var(--color-text)]">
-              {task.subject}
-            </h5>
-          )}
+          {!compact && <TruncatedTitle text={task.subject} className="min-w-0" />}
         </div>
         {task.needsClarification ? (
           <span
@@ -246,11 +278,7 @@ export const KanbanTaskCard = ({
             {task.needsClarification === 'user' ? 'Awaiting user' : 'Awaiting lead'}
           </span>
         ) : null}
-        {compact && (
-          <h5 className="mt-1 truncate text-sm font-medium text-[var(--color-text)]">
-            {task.subject}
-          </h5>
-        )}
+        {compact && <TruncatedTitle text={task.subject} className="mt-1" />}
       </div>
 
       {hasBlockedBy ? (
diff --git a/src/renderer/components/team/members/MemberList.tsx b/src/renderer/components/team/members/MemberList.tsx
index 39dec4ac..f7ac46aa 100644
--- a/src/renderer/components/team/members/MemberList.tsx
+++ b/src/renderer/components/team/members/MemberList.tsx
@@ -32,7 +32,13 @@ export const MemberList = ({
   onAssignTask,
   onOpenTask,
 }: MemberListProps): React.JSX.Element => {
-  const activeMembers = members.filter((m) => !m.removedAt);
+  const activeMembers = members
+    .filter((m) => !m.removedAt)
+    .sort((a, b) => {
+      if (a.agentType === 'team-lead') return -1;
+      if (b.agentType === 'team-lead') return 1;
+      return 0;
+    });
   const removedMembers = members.filter((m) => m.removedAt);
   const colorMap = buildMemberColorMap(members);
 
diff --git a/src/renderer/components/team/members/MemberLogsTab.tsx b/src/renderer/components/team/members/MemberLogsTab.tsx
index b553227a..bd9d5108 100644
--- a/src/renderer/components/team/members/MemberLogsTab.tsx
+++ b/src/renderer/components/team/members/MemberLogsTab.tsx
@@ -24,6 +24,8 @@ interface MemberLogsTabProps {
   /** When viewing task logs: include owner's sessions when task is in_progress */
   taskOwner?: string;
   taskStatus?: string;
+  /** Persisted work intervals for filtering owner sessions (avoid unrelated tasks) */
+  taskWorkIntervals?: { startedAt: string; completedAt?: string }[];
 }
 
 export const MemberLogsTab = ({
@@ -32,6 +34,7 @@ export const MemberLogsTab = ({
   taskId,
   taskOwner,
   taskStatus,
+  taskWorkIntervals,
 }: MemberLogsTabProps): React.JSX.Element => {
   const [logs, setLogs] = useState<MemberLogSummary[]>([]);
   const [loading, setLoading] = useState(true);
@@ -61,6 +64,7 @@ export const MemberLogsTab = ({
             ? await api.teams.getLogsForTask(teamName, taskId, {
                 owner: taskOwner,
                 status: taskStatus,
+                intervals: taskWorkIntervals,
               })
             : await api.teams.getMemberLogs(teamName, memberName!);
         if (!cancelled) {
@@ -86,7 +90,7 @@ export const MemberLogsTab = ({
       cancelled = true;
       if (interval) clearInterval(interval);
     };
-  }, [teamName, memberName, taskId, taskOwner, taskStatus]);
+  }, [teamName, memberName, taskId, taskOwner, taskStatus, taskWorkIntervals]);
 
   const handleExpand = useCallback(
     async (log: MemberLogSummary) => {
diff --git a/src/renderer/components/team/messages/MessageComposer.tsx b/src/renderer/components/team/messages/MessageComposer.tsx
index 4dcdc5cd..774f358a 100644
--- a/src/renderer/components/team/messages/MessageComposer.tsx
+++ b/src/renderer/components/team/messages/MessageComposer.tsx
@@ -7,8 +7,12 @@ import { Popover, PopoverContent, PopoverTrigger } from '@renderer/components/ui
 import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { getTeamColorSet } from '@renderer/constants/teamColors';
 import { useAttachments } from '@renderer/hooks/useAttachments';
+import { useChipDraftPersistence } from '@renderer/hooks/useChipDraftPersistence';
 import { useDraftPersistence } from '@renderer/hooks/useDraftPersistence';
 import { cn } from '@renderer/lib/utils';
+import { useStore } from '@renderer/store';
+import { serializeChipsWithText } from '@renderer/types/inlineChip';
+import { removeChipTokenFromText } from '@renderer/utils/chipUtils';
 import { formatAgentRole } from '@renderer/utils/formatAgentRole';
 import { getModifierKeyName } from '@renderer/utils/keyboardUtils';
 import { buildMemberColorMap } from '@renderer/utils/memberHelpers';
@@ -50,7 +54,9 @@ export const MessageComposer = ({
   const dragCounterRef = useRef(0);
   const fileInputRef = useRef<HTMLInputElement>(null);
 
+  const projectPath = useStore((s) => s.selectedTeamData?.config.projectPath ?? null);
   const draft = useDraftPersistence({ key: `compose:${teamName}` });
+  const chipDraft = useChipDraftPersistence(`compose:${teamName}:chips`);
   const {
     attachments,
     error: attachmentError,
@@ -88,11 +94,23 @@ export const MessageComposer = ({
   // Track whether we initiated a send — clear draft only on confirmed success
   const pendingSendRef = useRef(false);
 
+  const handleChipRemove = useCallback(
+    (chipId: string) => {
+      const chip = chipDraft.chips.find((c) => c.id === chipId);
+      if (chip) {
+        draft.setValue(removeChipTokenFromText(draft.value, chip));
+      }
+      chipDraft.setChips(chipDraft.chips.filter((c) => c.id !== chipId));
+    },
+    [chipDraft, draft]
+  );
+
   const handleSend = useCallback(() => {
     if (!canSend) return;
     pendingSendRef.current = true;
-    onSend(recipient, trimmed, trimmed, attachments.length > 0 ? attachments : undefined);
-  }, [canSend, recipient, trimmed, onSend, attachments]);
+    const serialized = serializeChipsWithText(trimmed, chipDraft.chips);
+    onSend(recipient, serialized, serialized, attachments.length > 0 ? attachments : undefined);
+  }, [canSend, recipient, trimmed, onSend, attachments, chipDraft.chips]);
 
   // Clear draft only after send completes successfully (sending: true → false, no error)
   useEffect(() => {
@@ -100,10 +118,12 @@ export const MessageComposer = ({
       pendingSendRef.current = false;
       if (!sendError) {
         draft.clearDraft();
+        chipDraft.clearChipDraft();
         clearAttachments();
       }
     }
-  }, [sending, sendError, draft, clearAttachments]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- clearChipDraft is stable (useCallback with [])
+  }, [sending, sendError, draft, clearAttachments, chipDraft.clearChipDraft]);
 
   const handleKeyDownCapture = useCallback(
     (e: React.KeyboardEvent) => {
@@ -304,6 +324,10 @@ export const MessageComposer = ({
         value={draft.value}
         onValueChange={draft.setValue}
         suggestions={mentionSuggestions}
+        chips={chipDraft.chips}
+        onChipRemove={handleChipRemove}
+        projectPath={projectPath}
+        onFileChipInsert={(chip) => chipDraft.setChips([...chipDraft.chips, chip])}
         minRows={2}
         maxRows={6}
         maxLength={MAX_MESSAGE_LENGTH}
diff --git a/src/renderer/components/team/review/ChangeReviewDialog.tsx b/src/renderer/components/team/review/ChangeReviewDialog.tsx
index 149d3205..7757a8d7 100644
--- a/src/renderer/components/team/review/ChangeReviewDialog.tsx
+++ b/src/renderer/components/team/review/ChangeReviewDialog.tsx
@@ -1,17 +1,20 @@
 import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 
 import { undo } from '@codemirror/commands';
-import { goToNextChunk, rejectChunk } from '@codemirror/merge';
+import { rejectChunk } from '@codemirror/merge';
 import { isElectronMode } from '@renderer/api';
+import { EditorSelectionMenu } from '@renderer/components/team/editor/EditorSelectionMenu';
 import { useContinuousScrollNav } from '@renderer/hooks/useContinuousScrollNav';
-import { isLastChunkInFile, useDiffNavigation } from '@renderer/hooks/useDiffNavigation';
+import { useDiffNavigation } from '@renderer/hooks/useDiffNavigation';
 import { useViewedFiles } from '@renderer/hooks/useViewedFiles';
 import { cn } from '@renderer/lib/utils';
 import { useStore } from '@renderer/store';
 import { getFileHunkCount, REVIEW_INSTANT_APPLY } from '@renderer/store/slices/changeReviewSlice';
+import { buildSelectionAction } from '@renderer/utils/buildSelectionAction';
+import { buildSelectionInfo, SELECTION_DEBOUNCE_MS } from '@renderer/utils/codemirrorSelectionInfo';
 import { ChevronDown, Clock, X } from 'lucide-react';
 
-import { acceptAllChunks, rejectAllChunks } from './CodeMirrorDiffUtils';
+import { acceptAllChunks, computeChunkIndexAtPos, rejectAllChunks } from './CodeMirrorDiffUtils';
 import { ContinuousScrollView } from './ContinuousScrollView';
 import { FileEditTimeline } from './FileEditTimeline';
 import { KeyboardShortcutsHelp } from './KeyboardShortcutsHelp';
@@ -22,6 +25,7 @@ import { ViewedProgressBar } from './ViewedProgressBar';
 
 import type { EditorView } from '@codemirror/view';
 import type { HunkDecision, TaskChangeSetV2 } from '@shared/types';
+import type { EditorSelectionAction, EditorSelectionInfo } from '@shared/types/editor';
 
 interface ChangeReviewDialogProps {
   open: boolean;
@@ -31,6 +35,8 @@ interface ChangeReviewDialogProps {
   memberName?: string;
   taskId?: string;
   initialFilePath?: string;
+  projectPath?: string;
+  onEditorAction?: (action: EditorSelectionAction) => void;
 }
 
 function isTaskChangeSetV2(cs: { teamName: string }): cs is TaskChangeSetV2 {
@@ -45,6 +51,8 @@ export const ChangeReviewDialog = ({
   memberName,
   taskId,
   initialFilePath,
+  projectPath,
+  onEditorAction,
 }: ChangeReviewDialogProps): React.ReactElement | null => {
   const {
     activeChangeSet,
@@ -61,6 +69,7 @@ export const ChangeReviewDialog = ({
     applying,
     applyError,
     setHunkDecision,
+    clearHunkDecisionByOriginalIndex,
     setCollapseUnchanged,
     fetchFileContent,
     acceptAllFile,
@@ -79,6 +88,7 @@ export const ChangeReviewDialog = ({
     pushReviewUndoSnapshot,
     undoBulkReview,
     reviewUndoStack,
+    hunkContextHashesByFile,
   } = useStore();
 
   // Active file from scroll-spy (replaces selectedReviewFilePath for continuous scroll)
@@ -87,11 +97,23 @@ export const ChangeReviewDialog = ({
   const [timelineOpen, setTimelineOpen] = useState(false);
   const [discardCounters, setDiscardCounters] = useState<Record<string, number>>({});
 
+  // Selection menu state
+  const [selectionInfo, setSelectionInfo] = useState<EditorSelectionInfo | null>(null);
+  const [containerRect, setContainerRect] = useState<DOMRect>(new DOMRect());
+  const diffContentRef = useRef<HTMLDivElement>(null);
+  const selectionTimerRef = useRef<ReturnType<typeof setTimeout>>();
+  const activeSelectionFileRef = useRef<string | null>(null);
+
   // EditorView map for all visible file editors
   const editorViewMapRef = useRef(new Map<string, EditorView>());
   const scrollContainerRef = useRef<HTMLDivElement>(null);
   // Last focused CM editor — for Cmd+Z outside editor
   const lastFocusedEditorRef = useRef<EditorView | null>(null);
+  // Timestamp of last bulk accept/reject-all operation (for Ctrl/Cmd+Z UX)
+  const lastBulkActionAtRef = useRef<number>(0);
+  // Track recent per-hunk actions so Ctrl/Cmd+Z can clear persisted decisions (reopen-safe)
+  const lastHunkActionAtRef = useRef<Record<string, number>>({});
+  const hunkDecisionUndoStackRef = useRef<Record<string, number[]>>({});
 
   // Proxy ref for useDiffNavigation (points to active file's editor)
   const activeEditorViewRef = useRef<EditorView | null>(null);
@@ -155,6 +177,7 @@ export const ChangeReviewDialog = ({
   const handleAcceptAll = useCallback(() => {
     if (!activeChangeSet) return;
     pushReviewUndoSnapshot();
+    lastBulkActionAtRef.current = Date.now();
     for (const file of activeChangeSet.files) {
       acceptAllFile(file.filePath);
     }
@@ -168,6 +191,7 @@ export const ChangeReviewDialog = ({
   const handleRejectAll = useCallback(() => {
     if (!activeChangeSet) return;
     pushReviewUndoSnapshot();
+    lastBulkActionAtRef.current = Date.now();
     for (const file of activeChangeSet.files) {
       rejectAllFile(file.filePath);
     }
@@ -181,14 +205,24 @@ export const ChangeReviewDialog = ({
   // Per-file callbacks for ContinuousScrollView
   const handleHunkAccepted = useCallback(
     (filePath: string, hunkIndex: number) => {
-      setHunkDecision(filePath, hunkIndex, 'accepted');
+      const originalIndex = setHunkDecision(filePath, hunkIndex, 'accepted');
+      lastHunkActionAtRef.current[filePath] = Date.now();
+      if (!hunkDecisionUndoStackRef.current[filePath]) {
+        hunkDecisionUndoStackRef.current[filePath] = [];
+      }
+      hunkDecisionUndoStackRef.current[filePath].push(originalIndex);
     },
     [setHunkDecision]
   );
 
   const handleHunkRejected = useCallback(
     (filePath: string, hunkIndex: number) => {
-      setHunkDecision(filePath, hunkIndex, 'rejected');
+      const originalIndex = setHunkDecision(filePath, hunkIndex, 'rejected');
+      lastHunkActionAtRef.current[filePath] = Date.now();
+      if (!hunkDecisionUndoStackRef.current[filePath]) {
+        hunkDecisionUndoStackRef.current[filePath] = [];
+      }
+      hunkDecisionUndoStackRef.current[filePath].push(originalIndex);
       if (REVIEW_INSTANT_APPLY) {
         void applySingleFileDecision(teamName, filePath, taskId, memberName);
       }
@@ -214,9 +248,18 @@ export const ChangeReviewDialog = ({
 
   const handleSaveFile = useCallback(
     (filePath: string) => {
-      void saveEditedFile(filePath);
+      void saveEditedFile(filePath, projectPath);
     },
-    [saveEditedFile]
+    [saveEditedFile, projectPath]
+  );
+
+  const handleRestoreMissingFile = useCallback(
+    (filePath: string, content: string) => {
+      updateEditedContent(filePath, content);
+      // Ensure editedContents is set before saveEditedFile reads it.
+      void Promise.resolve().then(() => saveEditedFile(filePath, projectPath));
+    },
+    [updateEditedContent, saveEditedFile, projectPath]
   );
 
   const handleDiscardFile = useCallback(
@@ -242,10 +285,72 @@ export const ChangeReviewDialog = ({
     }
   }, [undoBulkReview, activeChangeSet]);
 
-  // Save active file (for Cmd+Enter keyboard shortcut)
+  // Selection change handler (debounced for non-empty, immediate for clear)
+  const handleSelectionChange = useCallback((info: EditorSelectionInfo | null) => {
+    if (!info) {
+      if (selectionTimerRef.current) clearTimeout(selectionTimerRef.current);
+      setSelectionInfo(null);
+      return;
+    }
+    activeSelectionFileRef.current = info.filePath;
+    if (selectionTimerRef.current) clearTimeout(selectionTimerRef.current);
+    selectionTimerRef.current = setTimeout(() => {
+      setSelectionInfo(info);
+    }, SELECTION_DEBOUNCE_MS);
+  }, []);
+
+  // Scroll repositioning — re-query coords when parent scrolls (rAF-throttled)
+  const hasData = !changeSetLoading && !changeSetError && !!activeChangeSet;
+  useEffect(() => {
+    if (!hasData) return;
+    const container = scrollContainerRef.current;
+    if (!container) return;
+
+    let rafId = 0;
+    const onScroll = (): void => {
+      cancelAnimationFrame(rafId);
+      rafId = requestAnimationFrame(() => {
+        const fp = activeSelectionFileRef.current;
+        if (!fp) return;
+        const view = editorViewMapRef.current.get(fp);
+        if (!view) return;
+        const sel = view.state.selection.main;
+        if (sel.empty) {
+          setSelectionInfo(null);
+          return;
+        }
+        const info = buildSelectionInfo(view, sel);
+        if (info) {
+          setSelectionInfo({ ...info, filePath: fp });
+        } else {
+          setSelectionInfo(null);
+        }
+      });
+    };
+
+    container.addEventListener('scroll', onScroll, { passive: true });
+    return () => {
+      cancelAnimationFrame(rafId);
+      container.removeEventListener('scroll', onScroll);
+    };
+  }, [hasData]);
+
+  // Track container rect for menu positioning
+  useEffect(() => {
+    const el = diffContentRef.current;
+    if (!el) return;
+    const observer = new ResizeObserver(() => {
+      setContainerRect(el.getBoundingClientRect());
+    });
+    observer.observe(el);
+    setContainerRect(el.getBoundingClientRect());
+    return () => observer.disconnect();
+  }, [hasData]);
+
+  // Save active file (for Cmd+S keyboard shortcut)
   const handleSaveActiveFile = useCallback(() => {
-    if (activeFilePath) void saveEditedFile(activeFilePath);
-  }, [activeFilePath, saveEditedFile]);
+    if (activeFilePath) void saveEditedFile(activeFilePath, projectPath);
+  }, [activeFilePath, saveEditedFile, projectPath]);
 
   // Continuous navigation options for cross-file hunk navigation
   const continuousOptions = useMemo(
@@ -268,7 +373,9 @@ export const ChangeReviewDialog = ({
     handleHunkRejected,
     () => onOpenChange(false),
     handleSaveActiveFile,
-    continuousOptions
+    continuousOptions,
+    (filePath, fallbackSnippetsLength) =>
+      getFileHunkCount(filePath, fallbackSnippetsLength, fileChunkCounts)
   );
 
   // Load data on open
@@ -342,6 +449,23 @@ export const ChangeReviewDialog = ({
     });
   }, [activeChangeSet, initialFilePath, scrollToFile]);
 
+  // Clear selection state on close (React-approved setState-during-render pattern)
+  const [prevOpen, setPrevOpen] = useState(open);
+  if (prevOpen !== open) {
+    setPrevOpen(open);
+    if (!open) {
+      setSelectionInfo(null);
+    }
+  }
+
+  // Cleanup refs/timers on close
+  useEffect(() => {
+    if (!open) {
+      activeSelectionFileRef.current = null;
+      if (selectionTimerRef.current) clearTimeout(selectionTimerRef.current);
+    }
+  }, [open]);
+
   // Escape to close
   useEffect(() => {
     if (!open) return;
@@ -379,53 +503,74 @@ export const ChangeReviewDialog = ({
   useEffect(() => {
     if (!open) return;
     const handler = (e: KeyboardEvent): void => {
-      if ((e.metaKey || e.ctrlKey) && e.key === 'z' && !e.shiftKey) {
-        // Don't intercept if focus is inside a CM editor — let CM handle its own undo
-        if (document.activeElement?.closest('.cm-editor')) return;
+      if ((e.metaKey || e.ctrlKey) && e.code === 'KeyZ' && !e.shiftKey) {
         // Don't intercept native undo in input/textarea
         const tag = document.activeElement?.tagName;
         if (tag === 'INPUT' || tag === 'TEXTAREA') return;
 
-        // Try to undo in the last focused CM editor
+        // Prefer bulk undo (Accept All / Reject All) shortly after bulk action,
+        // even if focus is inside a CM editor (focus often remains there after clicking buttons).
+        const now = Date.now();
+        const bulkRecently = now - lastBulkActionAtRef.current < 10_000;
+        if (bulkRecently && useStore.getState().reviewUndoStack.length > 0) {
+          e.preventDefault();
+          e.stopPropagation();
+          handleUndoBulk();
+          return;
+        }
+
+        // If the last action was a hunk keep/undo (accept/reject) and we're undoing immediately,
+        // we must also clear the persisted decision. Otherwise reopening the dialog will replay it.
+        if (document.activeElement?.closest('.cm-editor')) {
+          const lastView = lastFocusedEditorRef.current;
+          const fp = activeFilePathRef.current;
+          const stack = fp ? hunkDecisionUndoStackRef.current[fp] : undefined;
+          const lastAt = fp ? (lastHunkActionAtRef.current[fp] ?? 0) : 0;
+          const hunkRecently = fp ? now - lastAt < 5_000 : false;
+
+          if (fp && stack && stack.length > 0 && hunkRecently && lastView?.dom.isConnected) {
+            e.preventDefault();
+            e.stopPropagation();
+            undo(lastView);
+            const originalIndex = stack.pop()!;
+            clearHunkDecisionByOriginalIndex(fp, originalIndex);
+            return;
+          }
+
+          // Otherwise, let CM handle its own undo
+          return;
+        }
+
+        // Otherwise try to undo in the last focused CM editor
         const lastView = lastFocusedEditorRef.current;
         if (lastView?.dom.isConnected) {
           e.preventDefault();
           e.stopPropagation();
           undo(lastView);
-          return;
-        }
-
-        // Fall back to bulk undo (Accept All / Reject All)
-        if (useStore.getState().reviewUndoStack.length > 0) {
-          e.preventDefault();
-          e.stopPropagation();
-          handleUndoBulk();
         }
       }
     };
     document.addEventListener('keydown', handler, true);
     return () => document.removeEventListener('keydown', handler, true);
-  }, [open, handleUndoBulk]);
+  }, [open, handleUndoBulk, clearHunkDecisionByOriginalIndex]);
 
   // Cmd+N IPC listener (forwarded from main process)
   useEffect(() => {
     if (!open) return;
     const cleanup = window.electronAPI?.review.onCmdN?.(() => {
       const fp = activeFilePathRef.current;
-      const view = fp ? editorViewMapRef.current.get(fp) : null;
-      if (view) {
-        rejectChunk(view);
-        requestAnimationFrame(() => {
-          if (isLastChunkInFile(view)) {
-            diffNav.goToNextFile();
-          } else {
-            goToNextChunk(view);
-          }
-        });
-      }
+      if (!fp) return;
+      const view = editorViewMapRef.current.get(fp);
+      if (!view) return;
+
+      const cursorPos = view.state.selection.main.head;
+      const idx = computeChunkIndexAtPos(view.state, cursorPos);
+      handleHunkRejected(fp, idx);
+      rejectChunk(view);
+      requestAnimationFrame(() => diffNav.goToNextHunk());
     });
     return cleanup ?? undefined;
-  }, [open, diffNav]);
+  }, [open, diffNav, handleHunkRejected]);
 
   // Compute toolbar stats using actual CM chunk count (not snippet count)
   const reviewStats = useMemo(() => {
@@ -636,33 +781,55 @@ export const ChangeReviewDialog = ({
               )}
             </div>
 
-            {/* Continuous scroll diff content */}
-            <ContinuousScrollView
-              files={activeChangeSet.files}
-              fileContents={fileContents}
-              fileContentsLoading={fileContentsLoading}
-              viewedSet={viewedSet}
-              editedContents={editedContents}
-              hunkDecisions={hunkDecisions}
-              fileDecisions={fileDecisions}
-              collapseUnchanged={collapseUnchanged}
-              applying={applying}
-              autoViewed={autoViewed}
-              discardCounters={discardCounters}
-              onHunkAccepted={handleHunkAccepted}
-              onHunkRejected={handleHunkRejected}
-              onFullyViewed={handleFullyViewed}
-              onContentChanged={handleContentChanged}
-              onDiscard={handleDiscardFile}
-              onSave={handleSaveFile}
-              onVisibleFileChange={handleVisibleFileChange}
-              scrollContainerRef={scrollContainerRef}
-              editorViewMapRef={editorViewMapRef}
-              isProgrammaticScroll={isProgrammaticScroll}
-              teamName={teamName}
-              memberName={memberName}
-              fetchFileContent={fetchFileContent}
-            />
+            {/* Continuous scroll diff content with selection menu */}
+            <div
+              ref={diffContentRef}
+              className="relative flex min-h-0 flex-1 flex-col overflow-hidden"
+            >
+              <ContinuousScrollView
+                files={activeChangeSet.files}
+                fileContents={fileContents}
+                fileContentsLoading={fileContentsLoading}
+                viewedSet={viewedSet}
+                editedContents={editedContents}
+                hunkDecisions={hunkDecisions}
+                fileDecisions={fileDecisions}
+                hunkContextHashesByFile={hunkContextHashesByFile}
+                collapseUnchanged={collapseUnchanged}
+                applying={applying}
+                autoViewed={autoViewed}
+                discardCounters={discardCounters}
+                onHunkAccepted={handleHunkAccepted}
+                onHunkRejected={handleHunkRejected}
+                onFullyViewed={handleFullyViewed}
+                onContentChanged={handleContentChanged}
+                onDiscard={handleDiscardFile}
+                onSave={handleSaveFile}
+                onRestoreMissingFile={handleRestoreMissingFile}
+                onVisibleFileChange={handleVisibleFileChange}
+                scrollContainerRef={scrollContainerRef}
+                editorViewMapRef={editorViewMapRef}
+                isProgrammaticScroll={isProgrammaticScroll}
+                teamName={teamName}
+                memberName={memberName}
+                fetchFileContent={fetchFileContent}
+                onSelectionChange={onEditorAction ? handleSelectionChange : undefined}
+              />
+              {selectionInfo && onEditorAction && (
+                <EditorSelectionMenu
+                  info={selectionInfo}
+                  containerRect={containerRect}
+                  onSendMessage={() => {
+                    onEditorAction(buildSelectionAction('sendMessage', selectionInfo));
+                    setSelectionInfo(null);
+                  }}
+                  onCreateTask={() => {
+                    onEditorAction(buildSelectionAction('createTask', selectionInfo));
+                    setSelectionInfo(null);
+                  }}
+                />
+              )}
+            </div>
           </>
         )}
 
diff --git a/src/renderer/components/team/review/CodeMirrorDiffUtils.ts b/src/renderer/components/team/review/CodeMirrorDiffUtils.ts
index aed9aa95..7eda04af 100644
--- a/src/renderer/components/team/review/CodeMirrorDiffUtils.ts
+++ b/src/renderer/components/team/review/CodeMirrorDiffUtils.ts
@@ -9,6 +9,8 @@ import {
 } from '@codemirror/merge';
 import { ChangeSet, type ChangeSpec, EditorState, type StateEffect } from '@codemirror/state';
 import { type EditorView } from '@codemirror/view';
+import { computeDiffContextHash } from '@shared/utils/diffContextHash';
+import { structuredPatch } from 'diff';
 
 /**
  * Teaches CM history to undo acceptChunk operations (updateOriginalDoc effects).
@@ -40,15 +42,13 @@ export function acceptAllChunks(view: EditorView): boolean {
   if (!result || result.chunks.length === 0) return false;
 
   const orig = getOriginalDoc(view.state);
-  const specs: ChangeSpec[] = [];
-  for (const chunk of result.chunks) {
-    specs.push({
-      from: chunk.fromA,
-      to: chunk.toA,
-      insert: view.state.doc.sliceString(chunk.fromB, chunk.toB),
-    });
-  }
-  const changes = ChangeSet.of(specs, orig.length);
+  // More robust than per-chunk: merge chunk ranges can be inconsistent for "empty" originals
+  // (e.g. whitespace-only or reconstruction edge cases), which can throw RangeError.
+  // Accept-all semantics are simply: make original equal to current modified doc.
+  const changes = ChangeSet.of(
+    [{ from: 0, to: orig.length, insert: view.state.doc.toString() }],
+    orig.length
+  );
   view.dispatch({
     effects: updateOriginalDoc.of({ doc: changes.apply(orig), changes }),
   });
@@ -61,15 +61,11 @@ export function rejectAllChunks(view: EditorView): boolean {
   if (!result || result.chunks.length === 0) return false;
 
   const orig = getOriginalDoc(view.state);
-  const specs: ChangeSpec[] = [];
-  for (const chunk of result.chunks) {
-    specs.push({
-      from: chunk.fromB,
-      to: chunk.toB,
-      insert: orig.sliceString(chunk.fromA, chunk.toA),
-    });
-  }
-  view.dispatch({ changes: specs });
+  // Same robustness principle as acceptAllChunks: reject-all semantics are simply
+  // "restore the current doc to the original baseline" in one edit.
+  view.dispatch({
+    changes: [{ from: 0, to: view.state.doc.length, insert: orig.toString() }],
+  });
   return true;
 }
 
@@ -130,4 +126,116 @@ export function replayHunkDecisions(
   }
 }
 
+/**
+ * Replay persisted decisions, attempting to map original hunk indices to the current
+ * CodeMirror chunk indices using context hashes when available.
+ *
+ * Falls back to index-based replay when hashes are missing or ambiguous.
+ */
+export function replayHunkDecisionsSmart(
+  view: EditorView,
+  filePath: string,
+  hunkDecisions: Record<string, string>,
+  hunkContextHashes?: Record<number, string>
+): void {
+  const result = getChunks(view.state);
+  if (!result || result.chunks.length === 0) return;
+
+  const chunkCount = result.chunks.length;
+
+  // Build current hunk hash -> indices map (only if we can build a patch that matches chunk count)
+  let hashToIndices: Map<string, number[]> | null = null;
+  if (hunkContextHashes && Object.keys(hunkContextHashes).length > 0) {
+    const original = getOriginalDoc(view.state).toString();
+    const modified = view.state.doc.toString();
+    const patch = structuredPatch('file', 'file', original, modified);
+    const hunks = patch.hunks ?? [];
+    if (hunks.length === chunkCount) {
+      hashToIndices = new Map<string, number[]>();
+      for (let i = 0; i < hunks.length; i++) {
+        const hunk = hunks[i];
+        const oldSideContent = hunk.lines
+          .filter((l) => !l.startsWith('+'))
+          .map((l) => l.slice(1))
+          .join('\n');
+        const newSideContent = hunk.lines
+          .filter((l) => !l.startsWith('-'))
+          .map((l) => l.slice(1))
+          .join('\n');
+        const hash = computeDiffContextHash(oldSideContent, newSideContent);
+        const arr = hashToIndices.get(hash);
+        if (arr) arr.push(i);
+        else hashToIndices.set(hash, [i]);
+      }
+    }
+  }
+
+  // Collect all decided indices from the decision map (don't assume contiguous 0..N)
+  const prefix = `${filePath}:`;
+  const decided: { mappedIndex: number; decision: 'accepted' | 'rejected' }[] = [];
+  const usedMapped = new Set<number>();
+
+  for (const [key, val] of Object.entries(hunkDecisions)) {
+    if (!key.startsWith(prefix)) continue;
+    if (val !== 'accepted' && val !== 'rejected') continue;
+    const raw = key.slice(prefix.length);
+    const origIndex = Number.parseInt(raw, 10);
+    if (Number.isNaN(origIndex)) continue;
+
+    let mappedIndex = origIndex;
+    const hash = hunkContextHashes?.[origIndex];
+    if (hash && hashToIndices) {
+      const candidates = hashToIndices.get(hash);
+      if (candidates?.length === 1) {
+        mappedIndex = candidates[0];
+      }
+    }
+
+    if (mappedIndex < 0 || mappedIndex >= chunkCount) continue;
+    if (usedMapped.has(mappedIndex)) continue;
+    usedMapped.add(mappedIndex);
+    decided.push({ mappedIndex, decision: val });
+  }
+
+  if (decided.length === 0) return;
+
+  // Replay from later to earlier indices so chunk removals don't shift earlier ones.
+  decided.sort((a, b) => b.mappedIndex - a.mappedIndex);
+
+  for (const { mappedIndex, decision } of decided) {
+    const currentChunks = getChunks(view.state);
+    if (!currentChunks || mappedIndex >= currentChunks.chunks.length) continue;
+    const chunk = currentChunks.chunks[mappedIndex];
+    if (decision === 'accepted') {
+      acceptChunk(view, chunk.fromB);
+    } else {
+      rejectChunk(view, chunk.fromB);
+    }
+  }
+}
+
+/**
+ * Compute the chunk index at a given position in the modified document (B-side).
+ * Returns the index of the chunk containing pos, or the nearest chunk when pos is outside.
+ */
+export function computeChunkIndexAtPos(state: EditorState, pos: number): number {
+  const chunks = getChunks(state);
+  if (!chunks || chunks.chunks.length === 0) return 0;
+
+  let nearestIndex = 0;
+  let nearestDist = Infinity;
+
+  for (let i = 0; i < chunks.chunks.length; i++) {
+    const chunk = chunks.chunks[i];
+    if (pos >= chunk.fromB && pos <= chunk.toB) return i;
+    const dist = Math.min(Math.abs(pos - chunk.fromB), Math.abs(pos - chunk.toB));
+    if (dist < nearestDist) {
+      nearestDist = dist;
+      nearestIndex = i;
+    }
+  }
+
+  return nearestIndex;
+}
+
 export { acceptChunk, getChunks, rejectChunk };
diff --git a/src/renderer/components/team/review/CodeMirrorDiffView.tsx b/src/renderer/components/team/review/CodeMirrorDiffView.tsx
index 68f415e5..e1d532e7 100644
--- a/src/renderer/components/team/review/CodeMirrorDiffView.tsx
+++ b/src/renderer/components/team/review/CodeMirrorDiffView.tsx
@@ -1,7 +1,7 @@
 import React, { useCallback, useEffect, useRef } from 'react';
 
 import { defaultKeymap, history, historyKeymap, indentWithTab } from '@codemirror/commands';
-import { indentUnit, syntaxHighlighting } from '@codemirror/language';
+import { foldGutter, foldKeymap, indentUnit, syntaxHighlighting } from '@codemirror/language';
 import { goToNextChunk, goToPreviousChunk, unifiedMergeView } from '@codemirror/merge';
 import { Compartment, EditorState, type Extension } from '@codemirror/state';
 import { oneDarkHighlightStyle } from '@codemirror/theme-one-dark';
@@ -10,6 +10,7 @@ import {
   getAsyncLanguageDesc,
   getSyncLanguageExtension,
 } from '@renderer/utils/codemirrorLanguages';
+import { buildSelectionInfo } from '@renderer/utils/codemirrorSelectionInfo';
 import { baseEditorTheme } from '@renderer/utils/codemirrorTheme';
 
 import {
@@ -21,6 +22,8 @@ import {
 } from './CodeMirrorDiffUtils';
 import { portionCollapseExtension } from './portionCollapse';
 
+import type { EditorSelectionInfo } from '@shared/types/editor';
+
 interface CodeMirrorDiffViewProps {
   original: string;
   modified: string;
@@ -46,6 +49,8 @@ interface CodeMirrorDiffViewProps {
   usePortionCollapse?: boolean;
   /** Lines per "Expand N" click (only with usePortionCollapse). Default: 100 */
   portionSize?: number;
+  /** Called when text selection changes (for floating action menu) */
+  onSelectionChange?: (info: EditorSelectionInfo | null) => void;
 }
 
 /** Compute hunk index for the chunk at a given position (B-side / modified doc).
@@ -162,6 +167,17 @@ const diffSpecificTheme = EditorView.theme({
   },
 });
 
+/** When original is empty (all additions), avoid showing a stray "deleted" block at the top. */
+const emptyOriginalOverrideTheme = EditorView.theme({
+  '.cm-deletedChunk': {
+    backgroundColor: 'transparent !important',
+    paddingLeft: '0 !important',
+  },
+  '.cm-deletedLine': {
+    backgroundColor: 'transparent !important',
+  },
+});
+
 export const CodeMirrorDiffView = ({
   original,
   modified,
@@ -180,6 +196,7 @@ export const CodeMirrorDiffView = ({
   initialState,
   usePortionCollapse = false,
   portionSize = 100,
+  onSelectionChange,
 }: CodeMirrorDiffViewProps): React.ReactElement => {
   const containerRef = useRef<HTMLDivElement>(null);
   const viewRef = useRef<EditorView | null>(null);
@@ -192,14 +209,23 @@ export const CodeMirrorDiffView = ({
   const onRejectRef = useRef(onHunkRejected);
   const onContentChangedRef = useRef(onContentChanged);
   const onViewChangeRef = useRef(onViewChange);
+  const onSelectionChangeRef = useRef(onSelectionChange);
   const debounceTimer = useRef<ReturnType<typeof setTimeout>>();
   useEffect(() => {
     onAcceptRef.current = onHunkAccepted;
     onRejectRef.current = onHunkRejected;
     onContentChangedRef.current = onContentChanged;
     onViewChangeRef.current = onViewChange;
+    onSelectionChangeRef.current = onSelectionChange;
     externalViewRefHolder.current = externalViewRef;
-  }, [onHunkAccepted, onHunkRejected, onContentChanged, onViewChange, externalViewRef]);
+  }, [
+    onHunkAccepted,
+    onHunkRejected,
+    onContentChanged,
+    onViewChange,
+    onSelectionChange,
+    externalViewRef,
+  ]);
 
   // Auto-scroll to next chunk after accept/reject (deferred to let CM recalculate)
   const scrollToNextChunk = useCallback(() => {
@@ -231,6 +257,13 @@ export const CodeMirrorDiffView = ({
         syntaxHighlightDeletions: true,
       };
 
+      // IMPORTANT: @codemirror/merge shows accept/reject buttons by default.
+      // When our UI chooses to hide merge controls (e.g. "Missing on disk" preview),
+      // explicitly disable them rather than relying on default behavior.
+      if (!showMergeControls) {
+        mergeConfig.mergeControls = false;
+      }
+
       if (collapse && !usePortionCollapse) {
         mergeConfig.collapseUnchanged = {
           margin,
@@ -355,11 +388,14 @@ export const CodeMirrorDiffView = ({
   );
 
   const buildExtensions = useCallback(() => {
+    const isEffectivelyEmptyOriginal = original.trim().length === 0;
     const extensions: Extension[] = [
       baseEditorTheme,
       diffSpecificTheme,
+      ...(isEffectivelyEmptyOriginal ? [emptyOriginalOverrideTheme] : []),
       lineNumbers(),
       syntaxHighlighting(oneDarkHighlightStyle),
+      foldGutter(),
       EditorView.editable.of(!readOnly),
       EditorState.readOnly.of(readOnly),
     ];
@@ -370,7 +406,9 @@ export const CodeMirrorDiffView = ({
       extensions.push(mergeUndoSupport);
       extensions.push(mirrorEditsAfterResolve);
       extensions.push(indentUnit.of('  '));
-      extensions.push(keymap.of([indentWithTab, ...defaultKeymap, ...historyKeymap]));
+      extensions.push(
+        keymap.of([indentWithTab, ...defaultKeymap, ...historyKeymap, ...foldKeymap])
+      );
     }
 
     // Language placeholder — actual language injected async via compartment reconfigure
@@ -391,6 +429,7 @@ export const CodeMirrorDiffView = ({
           key: 'Ctrl-Alt-ArrowUp',
           run: goToPreviousChunk,
         },
+        ...foldKeymap,
       ])
     );
 
@@ -408,6 +447,20 @@ export const CodeMirrorDiffView = ({
       );
     }
 
+    // Selection change listener (for floating action menu)
+    extensions.push(
+      EditorView.updateListener.of((update) => {
+        if (update.selectionSet || update.docChanged) {
+          const sel = update.state.selection.main;
+          if (sel.empty) {
+            onSelectionChangeRef.current?.(null);
+          } else {
+            onSelectionChangeRef.current?.(buildSelectionInfo(update.view, sel));
+          }
+        }
+      })
+    );
+
     // Merge toolbar: always visible for nearest chunk, follows cursor when hovering on chunk
     if (showMergeControls) {
       // Helper: position a chunkButtons container so it's below the change block,
@@ -566,7 +619,7 @@ export const CodeMirrorDiffView = ({
     );
 
     return extensions;
-  }, [readOnly, showMergeControls, buildMergeExtension, usePortionCollapse, portionSize]);
+  }, [readOnly, showMergeControls, buildMergeExtension, usePortionCollapse, portionSize, original]);
 
   useEffect(() => {
     if (!containerRef.current) return;
diff --git a/src/renderer/components/team/review/ContinuousScrollView.tsx b/src/renderer/components/team/review/ContinuousScrollView.tsx
index 770d9f19..4f4f43e8 100644
--- a/src/renderer/components/team/review/ContinuousScrollView.tsx
+++ b/src/renderer/components/team/review/ContinuousScrollView.tsx
@@ -8,7 +8,7 @@ import {
   acceptAllChunks,
   getChunks,
   rejectAllChunks,
-  replayHunkDecisions,
+  replayHunkDecisionsSmart,
 } from './CodeMirrorDiffUtils';
 import { FileSectionDiff } from './FileSectionDiff';
 import { FileSectionHeader } from './FileSectionHeader';
@@ -16,6 +16,7 @@ import { FileSectionPlaceholder } from './FileSectionPlaceholder';
 
 import type { EditorView } from '@codemirror/view';
 import type { FileChangeWithContent, HunkDecision } from '@shared/types';
+import type { EditorSelectionInfo } from '@shared/types/editor';
 import type { FileChangeSummary } from '@shared/types/review';
 
 interface ContinuousScrollViewProps {
@@ -26,6 +27,7 @@ interface ContinuousScrollViewProps {
   editedContents: Record<string, string>;
   hunkDecisions: Record<string, HunkDecision>;
   fileDecisions: Record<string, HunkDecision>;
+  hunkContextHashesByFile: Record<string, Record<number, string>>;
   collapseUnchanged: boolean;
   applying: boolean;
   autoViewed: boolean;
@@ -36,6 +38,7 @@ interface ContinuousScrollViewProps {
   onContentChanged: (filePath: string, content: string) => void;
   onDiscard: (filePath: string) => void;
   onSave: (filePath: string) => void;
+  onRestoreMissingFile?: (filePath: string, content: string) => void;
   onVisibleFileChange: (filePath: string) => void;
   scrollContainerRef: React.RefObject<HTMLDivElement>;
   editorViewMapRef: React.MutableRefObject<Map<string, EditorView>>;
@@ -47,6 +50,7 @@ interface ContinuousScrollViewProps {
     memberName: string | undefined,
     filePath: string
   ) => Promise<void>;
+  onSelectionChange?: (info: EditorSelectionInfo | null) => void;
 }
 
 export const ContinuousScrollView = ({
@@ -57,6 +61,7 @@ export const ContinuousScrollView = ({
   editedContents,
   hunkDecisions,
   fileDecisions,
+  hunkContextHashesByFile,
   collapseUnchanged,
   applying,
   autoViewed,
@@ -67,6 +72,7 @@ export const ContinuousScrollView = ({
   onContentChanged,
   onDiscard,
   onSave,
+  onRestoreMissingFile,
   onVisibleFileChange,
   scrollContainerRef,
   editorViewMapRef,
@@ -74,6 +80,7 @@ export const ContinuousScrollView = ({
   teamName,
   memberName,
   fetchFileContent,
+  onSelectionChange,
 }: ContinuousScrollViewProps): React.ReactElement => {
   const setFileChunkCount = useStore((s) => s.setFileChunkCount);
   const [collapsedFiles, setCollapsedFiles] = useState<Set<string>>(new Set());
@@ -126,9 +133,11 @@ export const ContinuousScrollView = ({
   // Refs to avoid stale closures — decisions change frequently
   const fileDecisionsRef = useRef(fileDecisions);
   const hunkDecisionsRef = useRef(hunkDecisions);
+  const hunkHashesRef = useRef(hunkContextHashesByFile);
   useEffect(() => {
     fileDecisionsRef.current = fileDecisions;
     hunkDecisionsRef.current = hunkDecisions;
+    hunkHashesRef.current = hunkContextHashesByFile;
   });
 
   // Track which views have already had decisions replayed to prevent
@@ -166,7 +175,12 @@ export const ContinuousScrollView = ({
         } else {
           // Replay individual per-hunk decisions persisted from previous session
           requestAnimationFrame(() => {
-            replayHunkDecisions(view, filePath, hunkDecisionsRef.current);
+            replayHunkDecisionsSmart(
+              view,
+              filePath,
+              hunkDecisionsRef.current,
+              hunkHashesRef.current[filePath]
+            );
           });
         }
       } else {
@@ -210,6 +224,7 @@ export const ContinuousScrollView = ({
               onToggleCollapse={handleToggleCollapse}
               onDiscard={onDiscard}
               onSave={onSave}
+              onRestoreMissingFile={onRestoreMissingFile}
             />
 
             {!isCollapsed &&
@@ -227,6 +242,7 @@ export const ContinuousScrollView = ({
                   discardCounter={discardCounters[filePath] ?? 0}
                   autoViewed={autoViewed}
                   isViewed={isViewed}
+                  onSelectionChange={onSelectionChange}
                 />
               ) : (
                 <FileSectionPlaceholder fileName={file.relativePath} />
diff --git a/src/renderer/components/team/review/FileSectionDiff.tsx b/src/renderer/components/team/review/FileSectionDiff.tsx
index 701c3b68..e4a109cb 100644
--- a/src/renderer/components/team/review/FileSectionDiff.tsx
+++ b/src/renderer/components/team/review/FileSectionDiff.tsx
@@ -7,6 +7,7 @@ import { ReviewDiffContent } from './ReviewDiffContent';
 
 import type { EditorView } from '@codemirror/view';
 import type { FileChangeWithContent } from '@shared/types';
+import type { EditorSelectionInfo } from '@shared/types/editor';
 import type { FileChangeSummary } from '@shared/types/review';
 
 interface FileSectionDiffProps {
@@ -22,6 +23,7 @@ interface FileSectionDiffProps {
   discardCounter: number;
   autoViewed: boolean;
   isViewed: boolean;
+  onSelectionChange?: (info: EditorSelectionInfo | null) => void;
 }
 
 export const FileSectionDiff = ({
@@ -37,6 +39,7 @@ export const FileSectionDiff = ({
   discardCounter,
   autoViewed,
   isViewed,
+  onSelectionChange,
 }: FileSectionDiffProps): React.ReactElement => {
   const localEditorViewRef = useRef<EditorView | null>(null);
   const sentinelRef = useRef<HTMLDivElement>(null);
@@ -89,10 +92,17 @@ export const FileSectionDiff = ({
       return writeSnippets[writeSnippets.length - 1].newString;
     })();
 
-  const hasCodeMirrorContent =
-    fileContent && fileContent.contentSource !== 'unavailable' && resolvedModified !== null;
+  const resolvedOriginal = fileContent?.originalFullContent ?? null;
+  const isMissingOnDisk = fileContent?.contentSource === 'unavailable';
 
-  if (!hasCodeMirrorContent) {
+  // Show CodeMirror only when we have a trustworthy original baseline:
+  // - new files: original is legitimately empty
+  // - otherwise: original must be known (non-null). If original is unknown, do not
+  //   pretend it's empty — fall back to snippet-level diff.
+  const canRenderCodeMirror =
+    resolvedModified !== null && (file.isNewFile || resolvedOriginal !== null);
+
+  if (!canRenderCodeMirror) {
     return (
       <div className="overflow-auto">
         <ReviewDiffContent file={file} />
@@ -101,20 +111,28 @@ export const FileSectionDiff = ({
     );
   }
 
+  const originalForDiff = file.isNewFile ? '' : (resolvedOriginal ?? '');
+
   return (
     <div className="overflow-auto">
+      {isMissingOnDisk && (
+        <div className="border-b border-border bg-red-500/10 px-4 py-2 text-xs text-red-200">
+          File is missing on disk. This diff may be only a preview from agent logs. Use{' '}
+          <span className="font-medium text-red-100">Restore</span> to create the file on disk.
+        </div>
+      )}
       <DiffErrorBoundary
         filePath={file.filePath}
-        oldString={fileContent.originalFullContent ?? ''}
+        oldString={originalForDiff}
         newString={resolvedModified}
       >
         <CodeMirrorDiffView
           key={`${file.filePath}:${discardCounter}`}
-          original={fileContent.originalFullContent ?? ''}
+          original={originalForDiff}
           modified={resolvedModified}
           fileName={file.relativePath}
           readOnly={false}
-          showMergeControls={true}
+          showMergeControls={!isMissingOnDisk}
           collapseUnchanged={collapseUnchanged}
           usePortionCollapse={true}
           onHunkAccepted={(idx) => onHunkAccepted(file.filePath, idx)}
@@ -122,6 +140,11 @@ export const FileSectionDiff = ({
           onContentChanged={(content) => onContentChanged(file.filePath, content)}
           editorViewRef={localEditorViewRef}
           onViewChange={handleViewChange}
+          onSelectionChange={
+            onSelectionChange
+              ? (info) => onSelectionChange(info ? { ...info, filePath: file.filePath } : null)
+              : undefined
+          }
         />
       </DiffErrorBoundary>
       <div ref={sentinelRef} className="h-1 shrink-0" />
diff --git a/src/renderer/components/team/review/FileSectionHeader.tsx b/src/renderer/components/team/review/FileSectionHeader.tsx
index 04f51a76..318ab17b 100644
--- a/src/renderer/components/team/review/FileSectionHeader.tsx
+++ b/src/renderer/components/team/review/FileSectionHeader.tsx
@@ -1,7 +1,8 @@
 import React from 'react';
 
 import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
-import { ChevronDown, ChevronRight, Loader2, Save, Undo2 } from 'lucide-react';
+import { shortcutLabel } from '@renderer/utils/platformKeys';
+import { ChevronDown, ChevronRight, FilePlus, Loader2, Save, Undo2 } from 'lucide-react';
 
 import type { FileChangeWithContent, HunkDecision } from '@shared/types';
 import type { FileChangeSummary } from '@shared/types/review';
@@ -11,7 +12,7 @@ const CONTENT_SOURCE_LABELS: Record<string, string> = {
   'snippet-reconstruction': 'Reconstructed',
   'disk-current': 'Current Disk',
   'git-fallback': 'Git Fallback',
-  unavailable: 'Unavailable',
+  unavailable: 'Missing on disk',
 };
 
 interface FileSectionHeaderProps {
@@ -24,6 +25,7 @@ interface FileSectionHeaderProps {
   onToggleCollapse: (filePath: string) => void;
   onDiscard: (filePath: string) => void;
   onSave: (filePath: string) => void;
+  onRestoreMissingFile?: (filePath: string, content: string) => void;
 }
 
 export const FileSectionHeader = ({
@@ -36,7 +38,21 @@ export const FileSectionHeader = ({
   onToggleCollapse,
   onDiscard,
   onSave,
+  onRestoreMissingFile,
 }: FileSectionHeaderProps): React.ReactElement => {
+  const isMissingOnDisk = fileContent?.contentSource === 'unavailable';
+  const restoreContent =
+    fileContent?.modifiedFullContent ??
+    (() => {
+      const writeSnippets = file.snippets.filter(
+        (s) => !s.isError && (s.type === 'write-new' || s.type === 'write-update')
+      );
+      if (writeSnippets.length === 0) return null;
+      return writeSnippets[writeSnippets.length - 1].newString;
+    })();
+  const canRestore =
+    !!onRestoreMissingFile && isMissingOnDisk && !hasEdits && restoreContent != null;
+
   const handleHeaderClick = (e: React.MouseEvent): void => {
     // Don't collapse when clicking action buttons
     if ((e.target as HTMLElement).closest('[data-no-collapse]')) return;
@@ -70,9 +86,44 @@ export const FileSectionHeader = ({
       )}
 
       {fileContent?.contentSource && (
-        <span className="rounded bg-surface-raised px-1.5 py-0.5 text-[10px] text-text-muted">
-          {CONTENT_SOURCE_LABELS[fileContent.contentSource] ?? fileContent.contentSource}
-        </span>
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <span
+              className={[
+                'rounded px-1.5 py-0.5 text-[10px]',
+                fileContent.contentSource === 'unavailable'
+                  ? 'bg-red-500/20 text-red-300'
+                  : 'bg-surface-raised text-text-muted',
+              ].join(' ')}
+            >
+              {CONTENT_SOURCE_LABELS[fileContent.contentSource] ?? fileContent.contentSource}
+            </span>
+          </TooltipTrigger>
+          <TooltipContent side="bottom" className="max-w-xs">
+            {fileContent.contentSource === 'unavailable' ? (
+              <div className="space-y-1">
+                <div className="font-medium text-text">File is missing on disk</div>
+                <div className="text-text-muted">
+                  We can still show a preview from agent logs, but your filesystem is out of sync.
+                </div>
+                {restoreContent != null ? (
+                  <div className="text-text-muted">
+                    Use <span className="font-medium text-text">Restore</span> to write the preview
+                    content back to disk.
+                  </div>
+                ) : (
+                  <div className="text-text-muted">
+                    Full file content is not available to restore automatically.
+                  </div>
+                )}
+              </div>
+            ) : (
+              <span>
+                {CONTENT_SOURCE_LABELS[fileContent.contentSource] ?? fileContent.contentSource}
+              </span>
+            )}
+          </TooltipContent>
+        </Tooltip>
       )}
 
       {fileDecision && (
@@ -90,6 +141,23 @@ export const FileSectionHeader = ({
       )}
 
       <div className="ml-auto flex items-center gap-1.5" data-no-collapse>
+        {canRestore && restoreContent != null && (
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <button
+                onClick={() => onRestoreMissingFile?.(file.filePath, restoreContent)}
+                disabled={applying}
+                className="flex items-center gap-1 rounded bg-blue-500/15 px-2 py-1 text-xs text-blue-300 transition-colors hover:bg-blue-500/25 disabled:opacity-50"
+              >
+                <FilePlus className="size-3" />
+                Restore
+              </button>
+            </TooltipTrigger>
+            <TooltipContent side="bottom">
+              Create/restore this file on disk from the preview
+            </TooltipContent>
+          </Tooltip>
+        )}
         {hasEdits && (
           <>
             <Tooltip>
@@ -122,7 +190,7 @@ export const FileSectionHeader = ({
               <TooltipContent side="bottom">
                 <span>Save file to disk</span>
                 <kbd className="ml-2 rounded border border-border bg-surface-raised px-1 py-0.5 font-mono text-[10px] text-text-muted">
-                  ⌘↵
+                  {shortcutLabel('⌘ S', 'Ctrl+S')}
                 </kbd>
               </TooltipContent>
             </Tooltip>
diff --git a/src/renderer/components/team/review/KeyboardShortcutsHelp.tsx b/src/renderer/components/team/review/KeyboardShortcutsHelp.tsx
index baaaa0f6..1bb9fc06 100644
--- a/src/renderer/components/team/review/KeyboardShortcutsHelp.tsx
+++ b/src/renderer/components/team/review/KeyboardShortcutsHelp.tsx
@@ -1,5 +1,6 @@
 import React from 'react';
 
+import { IS_MAC } from '@renderer/utils/platformKeys';
 import { X } from 'lucide-react';
 
 interface KeyboardShortcutsHelpProps {
@@ -7,16 +8,20 @@ interface KeyboardShortcutsHelpProps {
   onOpenChange: (open: boolean) => void;
 }
 
+const mod = IS_MAC ? '\u2318' : 'Ctrl';
+const alt = IS_MAC ? '\u2325' : 'Alt';
+const shift = IS_MAC ? '\u21E7' : 'Shift';
+
 const shortcuts = [
-  { keys: ['\u2325+J'], action: 'Next change' },
-  { keys: ['\u2325+K'], action: 'Previous change' },
-  { keys: ['\u2325+\u2193'], action: 'Next file' },
-  { keys: ['\u2325+\u2191'], action: 'Previous file' },
-  { keys: ['\u2318+Y'], action: 'Accept change' },
-  { keys: ['\u2318+N'], action: 'Reject change' },
-  { keys: ['\u2318+\u21A9'], action: 'Save file' },
-  { keys: ['\u2318+Z'], action: 'Undo' },
-  { keys: ['\u2318+\u21E7+Z'], action: 'Redo' },
+  { keys: [`${alt}+J`], action: 'Next change' },
+  { keys: [`${alt}+K`], action: 'Previous change' },
+  { keys: [`${alt}+\u2193`], action: 'Next file' },
+  { keys: [`${alt}+\u2191`], action: 'Previous file' },
+  { keys: [`${mod}+Y`], action: 'Accept change' },
+  { keys: [`${mod}+N`], action: 'Reject change' },
+  { keys: [`${mod}+S`], action: 'Save file' },
+  { keys: [`${mod}+Z`], action: 'Undo' },
+  { keys: [`${mod}+${shift}+Z`], action: 'Redo' },
   { keys: ['?'], action: 'Toggle shortcuts' },
   { keys: ['Esc'], action: 'Close dialog' },
 ];
diff --git a/src/renderer/components/team/review/ReviewDiffContent.tsx b/src/renderer/components/team/review/ReviewDiffContent.tsx
index b2e57ffc..d5f775f9 100644
--- a/src/renderer/components/team/review/ReviewDiffContent.tsx
+++ b/src/renderer/components/team/review/ReviewDiffContent.tsx
@@ -1,25 +1,80 @@
 import { useMemo } from 'react';
 
+import { highlightLines } from '@renderer/utils/syntaxHighlighter';
 import { diffLines } from 'diff';
 
 import type { FileChangeSummary, SnippetDiff } from '@shared/types/review';
 
+// =============================================================================
+// Types
+// =============================================================================
+
 interface ReviewDiffContentProps {
   file: FileChangeSummary;
 }
 
-const SnippetDiffView = ({ snippet, index }: { snippet: SnippetDiff; index: number }) => {
-  const diffResult = useMemo(() => {
-    if (snippet.type === 'write-new') {
-      // Весь файл — новый
-      return diffLines('', snippet.newString);
+interface DiffLine {
+  type: 'added' | 'removed' | 'unchanged';
+  html: string;
+}
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+/** Build highlighted diff lines by mapping diff parts onto pre-highlighted old/new lines. */
+function buildHighlightedDiffLines(snippet: SnippetDiff, fileName: string): DiffLine[] {
+  const isFullNew = snippet.type === 'write-new' || snippet.type === 'write-update';
+  const oldCode = isFullNew ? '' : snippet.oldString;
+  const diffResult = diffLines(oldCode, snippet.newString);
+
+  const oldHighlighted = highlightLines(oldCode, fileName);
+  const newHighlighted = highlightLines(snippet.newString, fileName);
+
+  const result: DiffLine[] = [];
+  let oldIdx = 0;
+  let newIdx = 0;
+
+  for (const part of diffResult) {
+    const lineCount = part.value.replace(/\n$/, '').split('\n').length;
+    for (let i = 0; i < lineCount; i++) {
+      if (part.removed) {
+        result.push({
+          type: 'removed',
+          html: oldHighlighted[oldIdx++] ?? '',
+        });
+      } else if (part.added) {
+        result.push({
+          type: 'added',
+          html: newHighlighted[newIdx++] ?? '',
+        });
+      } else {
+        result.push({
+          type: 'unchanged',
+          html: oldHighlighted[oldIdx++] ?? '',
+        });
+        newIdx++;
+      }
     }
-    if (snippet.type === 'write-update') {
-      // Полная перезапись
-      return diffLines('', snippet.newString);
-    }
-    return diffLines(snippet.oldString, snippet.newString);
-  }, [snippet]);
+  }
+
+  return result;
+}
+
+// =============================================================================
+// SnippetDiffView
+// =============================================================================
+
+const SnippetDiffView = ({
+  snippet,
+  index,
+  fileName,
+}: {
+  snippet: SnippetDiff;
+  index: number;
+  fileName: string;
+}) => {
+  const lines = useMemo(() => buildHighlightedDiffLines(snippet, fileName), [snippet, fileName]);
 
   const toolLabel =
     snippet.type === 'write-new'
@@ -32,7 +87,7 @@ const SnippetDiffView = ({ snippet, index }: { snippet: SnippetDiff; index: numb
 
   return (
     <div className="overflow-hidden rounded-lg border border-border">
-      {/* Заголовок snippet */}
+      {/* Snippet header */}
       <div className="flex items-center justify-between border-b border-border bg-surface-raised px-3 py-1.5">
         <span className="text-xs text-text-muted">
           #{index + 1} {toolLabel}
@@ -42,61 +97,54 @@ const SnippetDiffView = ({ snippet, index }: { snippet: SnippetDiff; index: numb
         </span>
       </div>
 
-      {/* Строки диффа */}
+      {/* Diff lines with syntax highlighting (hljs HTML — safe, all input is escaped) */}
       <div className="overflow-x-auto font-mono text-xs leading-5">
-        {diffResult.map((part, i) => {
-          const lines = part.value.replace(/\n$/, '').split('\n');
-          return lines.map((line, j) => {
-            let bgClass = '';
-            let prefix = ' ';
-            let textClass = 'text-text-secondary';
+        {lines.map((line, i) => {
+          let bgClass = '';
+          let prefix = ' ';
 
-            if (part.added) {
-              bgClass = 'bg-[var(--diff-added-bg,rgba(46,160,67,0.15))]';
-              prefix = '+';
-              textClass = 'text-[var(--diff-added-text,#3fb950)]';
-            } else if (part.removed) {
-              bgClass = 'bg-[var(--diff-removed-bg,rgba(248,81,73,0.15))]';
-              prefix = '-';
-              textClass = 'text-[var(--diff-removed-text,#f85149)]';
-            }
+          if (line.type === 'added') {
+            bgClass = 'bg-[var(--diff-added-bg,rgba(46,160,67,0.15))]';
+            prefix = '+';
+          } else if (line.type === 'removed') {
+            bgClass = 'bg-[var(--diff-removed-bg,rgba(248,81,73,0.15))]';
+            prefix = '-';
+          }
 
-            return (
-              <div key={`${i}-${j}`} className={`px-3 ${bgClass} ${textClass}`}>
-                <span className="inline-block w-4 select-none text-text-muted opacity-50">
-                  {prefix}
-                </span>
-                <span className="whitespace-pre">{line}</span>
-              </div>
-            );
-          });
+          return (
+            <div key={i} className={`flex px-3 ${bgClass}`}>
+              <span className="inline-block w-4 shrink-0 select-none text-text-muted opacity-50">
+                {prefix}
+              </span>
+              {/* highlight.js escapes all input text — only produces <span class="hljs-*"> tags */}
+              <span
+                className="whitespace-pre text-text-secondary"
+                dangerouslySetInnerHTML={{ __html: line.html }}
+              />
+            </div>
+          );
         })}
       </div>
     </div>
   );
 };
 
+// =============================================================================
+// ReviewDiffContent
+// =============================================================================
+
 export const ReviewDiffContent = ({ file }: ReviewDiffContentProps) => {
   const nonErrorSnippets = useMemo(() => file.snippets.filter((s) => !s.isError), [file.snippets]);
 
   return (
     <div className="space-y-4 p-4">
-      {/* Заголовок файла */}
-      <div className="flex items-center gap-2">
-        <span className="text-sm font-medium text-text">{file.relativePath}</span>
-        {file.isNewFile && (
-          <span className="rounded bg-green-500/20 px-1.5 py-0.5 text-[10px] text-green-400">
-            NEW
-          </span>
-        )}
-        <span className="ml-auto text-xs text-text-muted">
-          {nonErrorSnippets.length} change{nonErrorSnippets.length !== 1 ? 's' : ''}
-        </span>
-      </div>
-
-      {/* Snippets */}
       {nonErrorSnippets.map((snippet, index) => (
-        <SnippetDiffView key={snippet.toolUseId} snippet={snippet} index={index} />
+        <SnippetDiffView
+          key={snippet.toolUseId}
+          snippet={snippet}
+          index={index}
+          fileName={file.relativePath}
+        />
       ))}
 
       {nonErrorSnippets.length === 0 && (
diff --git a/src/renderer/components/team/review/ReviewFileTree.tsx b/src/renderer/components/team/review/ReviewFileTree.tsx
index 97b92370..b410502b 100644
--- a/src/renderer/components/team/review/ReviewFileTree.tsx
+++ b/src/renderer/components/team/review/ReviewFileTree.tsx
@@ -1,5 +1,6 @@
 import { useCallback, useEffect, useMemo, useState } from 'react';
 
+import { FileIcon } from '@renderer/components/team/editor/FileIcon';
 import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
 import { cn } from '@renderer/lib/utils';
 import { useStore } from '@renderer/store';
@@ -11,7 +12,6 @@ import {
   Circle,
   CircleDot,
   Eye,
-  File,
   Folder,
   FolderOpen,
   X as XIcon,
@@ -139,7 +139,7 @@ const TreeItem = ({
         style={{ paddingLeft: `${depth * 12 + 8}px` }}
       >
         <FileStatusIcon status={status} />
-        <File className="size-3.5 shrink-0" />
+        <FileIcon fileName={node.name} className="size-3.5" />
         {viewedSet && viewedSet.has(node.data.filePath) && (
           <Tooltip>
             <TooltipTrigger asChild>
diff --git a/src/renderer/components/team/review/portionCollapse.ts b/src/renderer/components/team/review/portionCollapse.ts
index a9dc4976..ec29a460 100644
--- a/src/renderer/components/team/review/portionCollapse.ts
+++ b/src/renderer/components/team/review/portionCollapse.ts
@@ -281,29 +281,53 @@ const portionCollapseTheme = EditorView.theme({
 // CM recognizes it's the same field → keeps accumulated state (expanded regions) → no create() call.
 // Config is read from portionCollapseConfigFacet (controlled by compartment).
 
-const portionCollapseField = StateField.define<DecorationSet>({
-  create(state: EditorState): DecorationSet {
+interface PortionCollapseState {
+  decorations: DecorationSet;
+  /**
+   * Once the user expands everything (i.e. removes the last collapse widget),
+   * we should NOT re-initialize collapse on harmless transactions like cursor moves.
+   */
+  userExpandedAll: boolean;
+}
+
+const portionCollapseField = StateField.define<PortionCollapseState>({
+  create(state: EditorState): PortionCollapseState {
     const cfg = state.facet(portionCollapseConfigFacet);
-    return buildPortionRanges(state, cfg.margin, cfg.minSize, cfg.portionSize);
+    return {
+      decorations: buildPortionRanges(state, cfg.margin, cfg.minSize, cfg.portionSize),
+      userExpandedAll: false,
+    };
   },
 
-  update(deco: DecorationSet, tr: Transaction): DecorationSet {
+  update(value: PortionCollapseState, tr: Transaction): PortionCollapseState {
     const cfg = tr.state.facet(portionCollapseConfigFacet);
 
     // 1. Expand effects
-    let result = deco;
+    let nextDeco = value.decorations;
+    let userExpandedAll = value.userExpandedAll;
     let hasExpandEffect = false;
     for (const effect of tr.effects) {
       if (effect.is(expandPortion)) {
         hasExpandEffect = true;
-        result = handleExpandPortion(result, effect.value, tr.state, cfg.minSize, cfg.portionSize);
+        nextDeco = handleExpandPortion(
+          nextDeco,
+          effect.value,
+          tr.state,
+          cfg.minSize,
+          cfg.portionSize
+        );
       }
       if (effect.is(expandAllAtPos)) {
         hasExpandEffect = true;
-        result = handleExpandAll(result, effect.value);
+        nextDeco = handleExpandAll(nextDeco, effect.value);
       }
     }
-    if (hasExpandEffect) return result;
+    if (hasExpandEffect) {
+      if (nextDeco === Decoration.none) {
+        userExpandedAll = true;
+      }
+      return { decorations: nextDeco, userExpandedAll };
+    }
 
     // 2. Accept chunk (updateOriginalDoc) — editor doc unchanged, keep decorations.
     // Full rebuild here would destroy user's expanded state (Expand All / Expand N).
@@ -311,27 +335,47 @@ const portionCollapseField = StateField.define<DecorationSet>({
     // When mirrorEditsAfterResolve adds updateOriginalDoc to a docChanged transaction,
     // we must NOT short-circuit — fall through to docChanged handler for proper rebuild.
     if (tr.effects.some((e) => e.is(updateOriginalDoc)) && !tr.docChanged) {
-      return deco;
+      return value;
     }
 
-    // 3. Document changed (reject, user edit) → full rebuild
+    // 3. Document changed (reject, user edit)
+    //
+    // Rebuilding from scratch here causes a bad UX: after the user expands (or when a hunk is
+    // applied) the editor can suddenly re-collapse unchanged regions, hiding the code the user
+    // was actively looking at. Instead, keep the user's current collapsed/expanded state stable
+    // by mapping existing decorations through the document changes.
     if (tr.docChanged) {
-      return buildPortionRanges(tr.state, cfg.margin, cfg.minSize, cfg.portionSize);
+      const mapped = value.decorations.map(tr.changes);
+      // If we previously had no collapse decoration but chunks are now available, initialize once.
+      // BUT: if the user explicitly expanded everything, never re-collapse automatically.
+      if (!value.userExpandedAll && value.decorations === Decoration.none) {
+        const chunks = getChunks(tr.state);
+        if (chunks) {
+          return {
+            decorations: buildPortionRanges(tr.state, cfg.margin, cfg.minSize, cfg.portionSize),
+            userExpandedAll: false,
+          };
+        }
+      }
+      return { decorations: mapped, userExpandedAll: value.userExpandedAll };
     }
 
     // 4. Lazy init
-    if (deco === Decoration.none) {
+    if (!value.userExpandedAll && value.decorations === Decoration.none) {
       const chunks = getChunks(tr.state);
       if (chunks) {
-        return buildPortionRanges(tr.state, cfg.margin, cfg.minSize, cfg.portionSize);
+        return {
+          decorations: buildPortionRanges(tr.state, cfg.margin, cfg.minSize, cfg.portionSize),
+          userExpandedAll: false,
+        };
       }
     }
 
-    return deco;
+    return value;
   },
 
   provide(f) {
-    return EditorView.decorations.from(f);
+    return EditorView.decorations.from(f, (v) => v.decorations);
   },
 });
 
diff --git a/src/renderer/components/terminal/EmbeddedTerminal.tsx b/src/renderer/components/terminal/EmbeddedTerminal.tsx
index 57d15f48..895cf062 100644
--- a/src/renderer/components/terminal/EmbeddedTerminal.tsx
+++ b/src/renderer/components/terminal/EmbeddedTerminal.tsx
@@ -66,7 +66,7 @@ export const EmbeddedTerminal = ({
 
     // Ctrl+C with selection → copy to clipboard (instead of sending SIGINT)
     term.attachCustomKeyEventHandler((event) => {
-      if (event.type === 'keydown' && event.key === 'c' && (event.ctrlKey || event.metaKey)) {
+      if (event.type === 'keydown' && event.code === 'KeyC' && (event.ctrlKey || event.metaKey)) {
         const selection = term.getSelection();
         if (selection) {
           void navigator.clipboard.writeText(selection);
diff --git a/src/renderer/components/ui/ChipInteractionLayer.tsx b/src/renderer/components/ui/ChipInteractionLayer.tsx
new file mode 100644
index 00000000..719edfeb
--- /dev/null
+++ b/src/renderer/components/ui/ChipInteractionLayer.tsx
@@ -0,0 +1,229 @@
+/**
+ * Interactive overlay layer (z-20) for inline code chips.
+ *
+ * Positioned above the textarea, provides:
+ * - Hover tooltip with code preview (first ~12 lines, CodeMirror syntax highlighting)
+ * - X button to remove a chip
+ *
+ * Uses mirror div technique (calculateChipPositions) to position elements
+ * exactly over the corresponding chip tokens in the textarea.
+ */
+
+import * as React from 'react';
+
+import { syntaxHighlighting } from '@codemirror/language';
+import { EditorState } from '@codemirror/state';
+import { oneDarkHighlightStyle } from '@codemirror/theme-one-dark';
+import { EditorView } from '@codemirror/view';
+import { Tooltip, TooltipContent, TooltipTrigger } from '@renderer/components/ui/tooltip';
+import { useStore } from '@renderer/store';
+import { chipDisplayLabel } from '@renderer/types/inlineChip';
+import { calculateChipPositions } from '@renderer/utils/chipUtils';
+import { getSyncLanguageExtension } from '@renderer/utils/codemirrorLanguages';
+import { ExternalLink, X } from 'lucide-react';
+
+import type { InlineChip } from '@renderer/types/inlineChip';
+import type { ChipPosition } from '@renderer/utils/chipUtils';
+
+// =============================================================================
+// Compact read-only CodeMirror theme for tooltip preview
+// =============================================================================
+
+const chipPreviewTheme = EditorView.theme({
+  '&': {
+    fontSize: '11px',
+    backgroundColor: 'var(--code-bg, #1e1e2e)',
+    color: 'var(--color-text)',
+  },
+  '.cm-content': {
+    padding: '8px 10px',
+    fontFamily: 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, monospace',
+    lineHeight: '1.6',
+  },
+  '&.cm-focused': { outline: 'none' },
+  '.cm-scroller': { overflow: 'auto' },
+  '.cm-gutters': { display: 'none' },
+  '.cm-activeLine': { backgroundColor: 'transparent' },
+  '.cm-selectionBackground': { backgroundColor: 'transparent' },
+  '.cm-cursor': { display: 'none' },
+});
+
+// =============================================================================
+// Code preview subcomponent (CodeMirror read-only)
+// =============================================================================
+
+const MAX_PREVIEW_LINES = 12;
+
+/** Simple tooltip for file-level mention chips (no code preview). */
+const ChipFilePreview = ({
+  chip,
+  onOpenInEditor,
+}: {
+  chip: InlineChip;
+  onOpenInEditor?: (filePath: string) => void;
+}): React.JSX.Element => {
+  const displayPath = chip.displayPath ?? chip.filePath;
+  return (
+    <div className="max-w-md overflow-hidden rounded-md">
+      <div className="flex items-center gap-2 bg-[var(--code-bg,#1e1e2e)] px-2.5 py-2">
+        <span className="text-[11px] font-medium text-[var(--color-text)]">{chip.fileName}</span>
+        <span className="flex-1 text-[10px] text-[var(--color-text-muted)]">{displayPath}</span>
+        {onOpenInEditor ? (
+          <button
+            type="button"
+            className="flex items-center gap-1 rounded px-1.5 py-0.5 text-[10px] text-[var(--color-text-muted)] transition-colors hover:bg-[var(--color-surface-raised)] hover:text-[var(--color-text)]"
+            onClick={(e) => {
+              e.preventDefault();
+              e.stopPropagation();
+              onOpenInEditor(chip.filePath);
+            }}
+          >
+            <ExternalLink size={10} />
+            Open
+          </button>
+        ) : null}
+      </div>
+    </div>
+  );
+};
+
+const ChipCodePreview = ({ chip }: { chip: InlineChip }): React.JSX.Element => {
+  const containerRef = React.useRef<HTMLDivElement>(null);
+  const allLines = chip.codeText.split('\n');
+  const truncated = allLines.length > MAX_PREVIEW_LINES;
+  const visibleCode = truncated ? allLines.slice(0, MAX_PREVIEW_LINES).join('\n') : chip.codeText;
+  const label = chipDisplayLabel(chip);
+  const lineRef =
+    chip.fromLine === chip.toLine
+      ? `line ${String(chip.fromLine)}`
+      : `lines ${String(chip.fromLine)}-${String(chip.toLine)}`;
+
+  React.useEffect(() => {
+    const container = containerRef.current;
+    if (!container) return;
+
+    const langExt = getSyncLanguageExtension(chip.fileName);
+
+    const state = EditorState.create({
+      doc: visibleCode,
+      extensions: [
+        chipPreviewTheme,
+        syntaxHighlighting(oneDarkHighlightStyle),
+        EditorView.editable.of(false),
+        EditorState.readOnly.of(true),
+        ...(langExt ? [langExt] : []),
+      ],
+    });
+
+    const view = new EditorView({ state, parent: container });
+
+    return () => {
+      view.destroy();
+    };
+  }, [visibleCode, chip.fileName]);
+
+  return (
+    <div className="max-w-md overflow-hidden rounded-md">
+      <div className="flex items-center justify-between border-b border-[var(--color-border)] bg-[var(--code-bg,#1e1e2e)] px-2.5 py-1.5">
+        <span className="text-[11px] font-medium text-[var(--color-text)]">{label}</span>
+        <span className="text-[10px] text-[var(--color-text-muted)]">{lineRef}</span>
+      </div>
+      <div ref={containerRef} />
+      {truncated ? (
+        <div className="border-t border-[var(--color-border)] bg-[var(--code-bg,#1e1e2e)] px-2.5 py-1">
+          <span className="text-[10px] text-[var(--color-text-muted)]">
+            ({allLines.length - MAX_PREVIEW_LINES} more lines...)
+          </span>
+        </div>
+      ) : null}
+    </div>
+  );
+};
+
+// =============================================================================
+// Interaction layer
+// =============================================================================
+
+interface ChipInteractionLayerProps {
+  chips: InlineChip[];
+  value: string;
+  textareaRef: React.RefObject<HTMLTextAreaElement | null>;
+  scrollTop: number;
+  onRemove: (chipId: string) => void;
+}
+
+export const ChipInteractionLayer = ({
+  chips,
+  value,
+  textareaRef,
+  scrollTop,
+  onRemove,
+}: ChipInteractionLayerProps): React.JSX.Element | null => {
+  const [positions, setPositions] = React.useState<ChipPosition[]>([]);
+  const revealFileInEditor = useStore((s) => s.revealFileInEditor);
+
+  React.useLayoutEffect(() => {
+    if (chips.length === 0) {
+      setPositions([]);
+      return;
+    }
+    const textarea = textareaRef.current;
+    if (!textarea) return;
+    setPositions(calculateChipPositions(textarea, value, chips));
+  }, [chips, value, textareaRef]);
+
+  if (positions.length === 0) return null;
+
+  return (
+    <div className="pointer-events-none absolute inset-0 z-20 overflow-hidden">
+      <div style={{ transform: `translateY(-${scrollTop}px)` }}>
+        {positions.map((pos) => {
+          const isFileChip = pos.chip.fromLine == null;
+          return (
+            <Tooltip key={pos.chip.id}>
+              <TooltipTrigger asChild>
+                <div
+                  className={`group pointer-events-auto absolute ${isFileChip ? 'cursor-pointer' : 'cursor-default'}`}
+                  style={{
+                    top: pos.top,
+                    left: pos.left,
+                    width: pos.width,
+                    height: pos.height,
+                  }}
+                  onClick={
+                    isFileChip
+                      ? (e) => {
+                          e.preventDefault();
+                          e.stopPropagation();
+                          revealFileInEditor(pos.chip.filePath);
+                        }
+                      : undefined
+                  }
+                >
+                  <button
+                    type="button"
+                    className="absolute -right-1 -top-1.5 z-30 flex size-3.5 items-center justify-center rounded-full border border-[var(--color-border-emphasis)] bg-[var(--color-surface-raised)] opacity-0 transition-opacity group-hover:opacity-100"
+                    onClick={(e) => {
+                      e.preventDefault();
+                      e.stopPropagation();
+                      onRemove(pos.chip.id);
+                    }}
+                  >
+                    <X size={8} className="text-[var(--color-text-muted)]" />
+                  </button>
+                </div>
+              </TooltipTrigger>
+              <TooltipContent side="top" className="max-w-md p-0">
+                {isFileChip ? (
+                  <ChipFilePreview chip={pos.chip} onOpenInEditor={revealFileInEditor} />
+                ) : (
+                  <ChipCodePreview chip={pos.chip} />
+                )}
+              </TooltipContent>
+            </Tooltip>
+          );
+        })}
+      </div>
+    </div>
+  );
+};
diff --git a/src/renderer/components/ui/CodeChipBadge.tsx b/src/renderer/components/ui/CodeChipBadge.tsx
new file mode 100644
index 00000000..8ef4e6ef
--- /dev/null
+++ b/src/renderer/components/ui/CodeChipBadge.tsx
@@ -0,0 +1,32 @@
+/**
+ * Styled span for rendering inline code chip tokens in the backdrop overlay.
+ * Uses the same text as the textarea (transparent) to maintain pixel-perfect alignment.
+ *
+ * Purple color scheme to distinguish from @mention badges (blue).
+ */
+
+import type { InlineChip } from '@renderer/types/inlineChip';
+
+const CHIP_BG = 'rgba(139, 92, 246, 0.15)';
+const CHIP_TEXT = '#a78bfa';
+
+interface CodeChipBadgeProps {
+  chip: InlineChip;
+  /** The full chip token text (e.g. "📄auth.ts:10-15") */
+  tokenText: string;
+}
+
+export const CodeChipBadge = ({ tokenText }: CodeChipBadgeProps): React.JSX.Element => {
+  return (
+    <span
+      style={{
+        backgroundColor: CHIP_BG,
+        color: CHIP_TEXT,
+        borderRadius: '4px',
+        boxShadow: `0 0 0 1.5px ${CHIP_BG}`,
+      }}
+    >
+      {tokenText}
+    </span>
+  );
+};
diff --git a/src/renderer/components/ui/MentionSuggestionList.tsx b/src/renderer/components/ui/MentionSuggestionList.tsx
index df200374..20d994fc 100644
--- a/src/renderer/components/ui/MentionSuggestionList.tsx
+++ b/src/renderer/components/ui/MentionSuggestionList.tsx
@@ -1,6 +1,7 @@
 import { useEffect, useRef } from 'react';
 
 import { getTeamColorSet } from '@renderer/constants/teamColors';
+import { FileText } from 'lucide-react';
 
 import type { MentionSuggestion } from '@renderer/types/mention';
 
@@ -9,6 +10,8 @@ interface MentionSuggestionListProps {
   selectedIndex: number;
   onSelect: (s: MentionSuggestion) => void;
   query: string;
+  /** When true, adjusts empty state text to mention files */
+  hasFileSearch?: boolean;
 }
 
 const HighlightedName = ({ name, query }: { name: string; query: string }): React.JSX.Element => {
@@ -33,67 +36,108 @@ const HighlightedName = ({ name, query }: { name: string; query: string }): Reac
   );
 };
 
+/** Section header for grouped suggestion lists */
+const SectionHeader = ({ label }: { label: string }): React.JSX.Element => (
+  <li className="px-3 pb-0.5 pt-1.5 text-[10px] uppercase tracking-wider text-[var(--color-text-muted)]">
+    {label}
+  </li>
+);
+
 export const MentionSuggestionList = ({
   suggestions,
   selectedIndex,
   onSelect,
   query,
+  hasFileSearch,
 }: MentionSuggestionListProps): React.JSX.Element => {
   const listRef = useRef<HTMLUListElement>(null);
 
   useEffect(() => {
     const list = listRef.current;
     if (!list) return;
-    const selected = list.children[selectedIndex] as HTMLElement | undefined;
+    // Query by role=option to skip section headers
+    const options = list.querySelectorAll('[role="option"]');
+    const selected = options[selectedIndex] as HTMLElement | undefined;
     selected?.scrollIntoView({ block: 'nearest' });
   }, [selectedIndex]);
 
   if (suggestions.length === 0) {
     return (
       <div className="rounded-md border border-[var(--color-border)] bg-[var(--color-surface-overlay)] px-3 py-2 text-xs text-[var(--color-text-muted)]">
-        No matching members
+        {hasFileSearch ? 'No matching members or files' : 'No matching members'}
       </div>
     );
   }
 
+  // Determine if we need grouped sections
+  const hasMemberItems = suggestions.some((s) => s.type !== 'file');
+  const hasFileItems = suggestions.some((s) => s.type === 'file');
+  const showSections = hasMemberItems && hasFileItems;
+
+  // Build items with section headers inserted
+  const items: React.JSX.Element[] = [];
+  let currentSection: 'member' | 'file' | null = null;
+  let optionIndex = 0;
+
+  for (const s of suggestions) {
+    const isFile = s.type === 'file';
+    const section = isFile ? 'file' : 'member';
+
+    // Insert section header on transition
+    if (showSections && section !== currentSection) {
+      items.push(<SectionHeader key={`section-${section}`} label={isFile ? 'Files' : 'Members'} />);
+      currentSection = section;
+    }
+
+    const isSelected = optionIndex === selectedIndex;
+    const colorSet = !isFile && s.color ? getTeamColorSet(s.color) : null;
+    const idx = optionIndex;
+    optionIndex++;
+
+    items.push(
+      <li
+        key={s.id}
+        role="option"
+        aria-selected={isSelected}
+        data-index={idx}
+        className={`flex cursor-pointer items-center gap-2 rounded-sm px-3 py-1.5 text-xs transition-colors ${
+          isSelected
+            ? 'bg-[var(--color-accent)]/15 ring-[var(--color-accent)]/30 text-[var(--color-text)] ring-1 ring-inset'
+            : 'text-[var(--color-text-secondary)] hover:bg-[var(--color-surface-raised)]'
+        }`}
+        onMouseDown={(e) => {
+          e.preventDefault();
+          onSelect(s);
+        }}
+      >
+        {isFile ? (
+          <FileText size={10} className="shrink-0 text-[var(--color-text-muted)]" />
+        ) : (
+          <span
+            className="inline-block size-2.5 shrink-0 rounded-full"
+            style={{ backgroundColor: colorSet?.border ?? 'var(--color-text-muted)' }}
+          />
+        )}
+        <span
+          className={isFile ? 'truncate' : 'font-medium'}
+          style={colorSet ? { color: colorSet.text } : undefined}
+        >
+          <HighlightedName name={s.name} query={query} />
+        </span>
+        {s.subtitle ? (
+          <span className="truncate text-[var(--color-text-muted)]">{s.subtitle}</span>
+        ) : null}
+      </li>
+    );
+  }
+
   return (
     <ul
       ref={listRef}
       role="listbox"
-      className="max-h-40 overflow-y-auto rounded-md border border-[var(--color-border)] bg-[var(--color-surface-overlay)] py-1"
+      className="max-h-48 overflow-y-auto rounded-md border border-[var(--color-border)] bg-[var(--color-surface-overlay)] py-1"
     >
-      {suggestions.map((s, i) => {
-        const colorSet = s.color ? getTeamColorSet(s.color) : null;
-        const isSelected = i === selectedIndex;
-
-        return (
-          <li
-            key={s.id}
-            role="option"
-            aria-selected={isSelected}
-            className={`flex cursor-pointer items-center gap-2 px-3 py-1.5 text-xs transition-colors ${
-              isSelected
-                ? 'bg-[var(--color-surface-raised)] text-[var(--color-text)]'
-                : 'text-[var(--color-text-secondary)] hover:bg-[var(--color-surface-raised)]'
-            }`}
-            onMouseDown={(e) => {
-              e.preventDefault();
-              onSelect(s);
-            }}
-          >
-            <span
-              className="inline-block size-2.5 shrink-0 rounded-full"
-              style={{ backgroundColor: colorSet?.border ?? 'var(--color-text-muted)' }}
-            />
-            <span className="font-medium" style={colorSet ? { color: colorSet.text } : undefined}>
-              <HighlightedName name={s.name} query={query} />
-            </span>
-            {s.subtitle ? (
-              <span className="text-[var(--color-text-muted)]">{s.subtitle}</span>
-            ) : null}
-          </li>
-        );
-      })}
+      {items}
     </ul>
   );
 };
diff --git a/src/renderer/components/ui/MentionableTextarea.tsx b/src/renderer/components/ui/MentionableTextarea.tsx
index 5414bb56..0b54f7f8 100644
--- a/src/renderer/components/ui/MentionableTextarea.tsx
+++ b/src/renderer/components/ui/MentionableTextarea.tsx
@@ -1,17 +1,28 @@
 import * as React from 'react';
 
 import { getTeamColorSet } from '@renderer/constants/teamColors';
+import { useFileSuggestions } from '@renderer/hooks/useFileSuggestions';
 import { useMentionDetection } from '@renderer/hooks/useMentionDetection';
 import { cn } from '@renderer/lib/utils';
+import { chipToken } from '@renderer/types/inlineChip';
+import {
+  createChipFromSelection,
+  findChipBoundary,
+  reconcileChips,
+  removeChipTokenFromText,
+} from '@renderer/utils/chipUtils';
 
 import { AutoResizeTextarea } from './auto-resize-textarea';
+import { ChipInteractionLayer } from './ChipInteractionLayer';
+import { CodeChipBadge } from './CodeChipBadge';
 import { MentionSuggestionList } from './MentionSuggestionList';
 
 import type { AutoResizeTextareaProps } from './auto-resize-textarea';
+import type { InlineChip } from '@renderer/types/inlineChip';
 import type { MentionSuggestion } from '@renderer/types/mention';
 
 // ---------------------------------------------------------------------------
-// Mention segment parsing (splits text into plain text + @mention segments)
+// Segment types
 // ---------------------------------------------------------------------------
 
 interface TextSegment {
@@ -25,7 +36,17 @@ interface MentionSegment {
   suggestion: MentionSuggestion;
 }
 
-type Segment = TextSegment | MentionSegment;
+interface ChipSegment {
+  type: 'chip';
+  value: string;
+  chip: InlineChip;
+}
+
+type Segment = TextSegment | MentionSegment | ChipSegment;
+
+// ---------------------------------------------------------------------------
+// Mention segment parsing (splits text into plain text + @mention segments)
+// ---------------------------------------------------------------------------
 
 /**
  * Splits text into alternating text / @mention segments.
@@ -96,6 +117,64 @@ function parseMentionSegments(text: string, suggestions: MentionSuggestion[]): S
   return segments;
 }
 
+// ---------------------------------------------------------------------------
+// Extended segment parser: chips + mentions
+// ---------------------------------------------------------------------------
+
+/**
+ * Parses text into segments: first extracts chip tokens, then runs mention parsing
+ * on the text fragments between chips.
+ */
+function parseSegments(
+  text: string,
+  suggestions: MentionSuggestion[],
+  chips: InlineChip[]
+): Segment[] {
+  if (!text) return [{ type: 'text', value: text }];
+  if (chips.length === 0) return parseMentionSegments(text, suggestions);
+
+  // Build a map of chip tokens for fast lookup
+  const chipTokenMap = new Map<string, InlineChip>();
+  for (const chip of chips) {
+    chipTokenMap.set(chipToken(chip), chip);
+  }
+
+  // Find all chip token positions, sorted by index
+  const chipPositions: { start: number; end: number; token: string; chip: InlineChip }[] = [];
+  for (const [token, chip] of chipTokenMap) {
+    let searchFrom = 0;
+    while (searchFrom < text.length) {
+      const idx = text.indexOf(token, searchFrom);
+      if (idx === -1) break;
+      chipPositions.push({ start: idx, end: idx + token.length, token, chip });
+      searchFrom = idx + 1;
+    }
+  }
+  chipPositions.sort((a, b) => a.start - b.start);
+
+  if (chipPositions.length === 0) return parseMentionSegments(text, suggestions);
+
+  const segments: Segment[] = [];
+  let lastEnd = 0;
+
+  for (const pos of chipPositions) {
+    // Text before this chip → parse for mentions
+    if (pos.start > lastEnd) {
+      const fragment = text.slice(lastEnd, pos.start);
+      segments.push(...parseMentionSegments(fragment, suggestions));
+    }
+    segments.push({ type: 'chip', value: pos.token, chip: pos.chip });
+    lastEnd = pos.end;
+  }
+
+  // Remaining text after last chip → parse for mentions
+  if (lastEnd < text.length) {
+    segments.push(...parseMentionSegments(text.slice(lastEnd), suggestions));
+  }
+
+  return segments;
+}
+
 // Default fallback color for mentions without a team color
 const DEFAULT_MENTION_BG = 'rgba(59, 130, 246, 0.15)';
 const DEFAULT_MENTION_TEXT = '#60a5fa';
@@ -117,6 +196,14 @@ interface MentionableTextareaProps extends Omit<
   footerRight?: React.ReactNode;
   /** Content rendered in the bottom-right corner inside the textarea (e.g. send button) */
   cornerAction?: React.ReactNode;
+  /** Inline code chips to display as badges */
+  chips?: InlineChip[];
+  /** Called when a chip is removed (by X button, backspace, or reconciliation) */
+  onChipRemove?: (chipId: string) => void;
+  /** Project path for @file search. When provided, enables file suggestions alongside members. */
+  projectPath?: string | null;
+  /** Called when a file chip is created via @ selection. Parent must add chip to state. */
+  onFileChipInsert?: (chip: InlineChip) => void;
 }
 
 export const MentionableTextarea = React.forwardRef<HTMLTextAreaElement, MentionableTextareaProps>(
@@ -125,10 +212,14 @@ export const MentionableTextarea = React.forwardRef<HTMLTextAreaElement, Mention
       value,
       onValueChange,
       suggestions,
-      hintText = 'Use @ to mention team members',
+      hintText,
       showHint = true,
       footerRight,
       cornerAction,
+      chips = [],
+      onChipRemove,
+      projectPath,
+      onFileChipInsert,
       style,
       className,
       ...textareaProps
@@ -137,6 +228,10 @@ export const MentionableTextarea = React.forwardRef<HTMLTextAreaElement, Mention
   ) => {
     const internalRef = React.useRef<HTMLTextAreaElement | null>(null);
     const backdropRef = React.useRef<HTMLDivElement>(null);
+    const [scrollTop, setScrollTop] = React.useState(0);
+
+    // --- File search activation ---
+    const enableFiles = !!projectPath;
 
     const setRefs = React.useCallback(
       (node: HTMLTextAreaElement | null) => {
@@ -154,23 +249,120 @@ export const MentionableTextarea = React.forwardRef<HTMLTextAreaElement, Mention
     const {
       isOpen,
       query,
-      filteredSuggestions,
+      filteredSuggestions: memberSuggestions,
       selectedIndex,
       dropdownPosition,
       selectSuggestion,
-      handleKeyDown,
-      handleChange,
-      handleSelect,
+      dismiss,
+      triggerIndex,
+      handleKeyDown: mentionHandleKeyDown,
+      handleChange: mentionHandleChange,
+      handleSelect: mentionHandleSelect,
     } = useMentionDetection({
       suggestions,
       value,
       onValueChange,
       textareaRef: internalRef,
+      enableTriggerAlways: enableFiles,
     });
 
+    // --- File suggestions ---
+    const fileSuggestions = useFileSuggestions(
+      enableFiles ? projectPath : null,
+      query,
+      isOpen && enableFiles
+    );
+
+    // Merged suggestion list: members first, then files
+    const allSuggestions = React.useMemo(() => {
+      if (!enableFiles) return memberSuggestions;
+      if (fileSuggestions.length === 0) return memberSuggestions;
+      return [...memberSuggestions, ...fileSuggestions];
+    }, [enableFiles, memberSuggestions, fileSuggestions]);
+
+    // When files are enabled, manage our own selectedIndex for the merged list
+    const [mergedIndex, setMergedIndex] = React.useState(0);
+
+    // Reset merged index when suggestions change or query changes
+    React.useEffect(() => {
+      setMergedIndex(0);
+    }, [query, allSuggestions.length]);
+
+    // Effective index: use merged when files enabled, hook's index otherwise
+    const effectiveIndex = enableFiles ? mergedIndex : selectedIndex;
+    const effectiveSuggestions = enableFiles ? allSuggestions : memberSuggestions;
+
+    // --- File selection handler ---
+    const handleFileSelect = React.useCallback(
+      (s: MentionSuggestion) => {
+        const textarea = internalRef.current;
+        if (!textarea || triggerIndex < 0 || !s.filePath) return;
+
+        const replaceStart = triggerIndex;
+        const replaceEnd = triggerIndex + 1 + query.length;
+        const before = value.slice(0, replaceStart);
+        const after = value.slice(replaceEnd);
+
+        if (onFileChipInsert && onChipRemove) {
+          // Chip mode: create InlineChip and insert chip token
+          const chip = createChipFromSelection(
+            {
+              type: 'sendMessage',
+              filePath: s.filePath,
+              fromLine: null,
+              toLine: null,
+              selectedText: '',
+              formattedContext: '',
+              displayPath: s.relativePath,
+            },
+            chips
+          );
+
+          if (chip) {
+            const token = chipToken(chip);
+            const newValue = before + token + after;
+            onValueChange(newValue);
+            onFileChipInsert(chip);
+            dismiss();
+
+            requestAnimationFrame(() => {
+              const cursor = before.length + token.length;
+              textarea.setSelectionRange(cursor, cursor);
+            });
+          } else {
+            // Duplicate chip — just dismiss
+            dismiss();
+          }
+        } else {
+          // Text mode: insert backtick-wrapped relative path
+          const displayPath = s.relativePath ?? s.name;
+          const insertion = `\`${displayPath}\` `;
+          const newValue = before + insertion + after;
+          onValueChange(newValue);
+          dismiss();
+
+          requestAnimationFrame(() => {
+            const cursor = before.length + insertion.length;
+            textarea.setSelectionRange(cursor, cursor);
+          });
+        }
+      },
+      [triggerIndex, query, value, chips, onValueChange, onFileChipInsert, onChipRemove, dismiss]
+    );
+
+    // --- Merged selection handler ---
+    const handleMergedSelect = React.useCallback(
+      (s: MentionSuggestion) => {
+        if (s.type === 'file') {
+          handleFileSelect(s);
+        } else {
+          selectSuggestion(s);
+        }
+      },
+      [handleFileSelect, selectSuggestion]
+    );
+
     // Sync backdrop font with textarea computed font to prevent caret drift.
-    // Chromium UA stylesheet may apply different font-family / letter-spacing
-    // to <textarea> vs <div>, and sub-pixel differences accumulate over text length.
     React.useLayoutEffect(() => {
       const textarea = internalRef.current;
       const backdrop = backdropRef.current;
@@ -182,27 +374,207 @@ export const MentionableTextarea = React.forwardRef<HTMLTextAreaElement, Mention
       backdrop.style.textIndent = cs.textIndent;
       backdrop.style.textTransform = cs.textTransform;
       backdrop.style.tabSize = cs.tabSize;
-    }, [value]); // re-sync when value changes (textarea may reflow)
+    }, [value]);
 
-    // --- Mention overlay ---
-    const hasMentionOverlay = suggestions.length > 0;
+    // --- Overlay activation ---
+    const hasOverlay = suggestions.length > 0 || chips.length > 0;
 
     const segments = React.useMemo(
-      () => (hasMentionOverlay ? parseMentionSegments(value, suggestions) : []),
-      [hasMentionOverlay, value, suggestions]
+      () => (hasOverlay ? parseSegments(value, suggestions, chips) : []),
+      [hasOverlay, value, suggestions, chips]
     );
 
-    // Sync backdrop scroll with textarea scroll
+    // Sync backdrop scroll with textarea scroll + track scrollTop for interaction layer
     const handleScroll = React.useCallback(() => {
       const textarea = internalRef.current;
       const backdrop = backdropRef.current;
-      if (textarea && backdrop) {
-        backdrop.scrollTop = textarea.scrollTop;
+      if (textarea) {
+        if (backdrop) {
+          backdrop.scrollTop = textarea.scrollTop;
+        }
+        setScrollTop(textarea.scrollTop);
       }
     }, []);
 
+    // --- Chip keyboard handling (atomic cursor / backspace / delete) ---
+    const handleChipKeyDown = React.useCallback(
+      (e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+        if (chips.length === 0 || !onChipRemove) return;
+
+        const textarea = internalRef.current;
+        if (!textarea) return;
+
+        const { selectionStart, selectionEnd } = textarea;
+        // Only act on collapsed cursor
+        if (selectionStart !== selectionEnd && !e.shiftKey) return;
+
+        const cursorPos = selectionStart;
+
+        if (e.key === 'Backspace') {
+          // If cursor is at chip end → delete entire chip
+          const boundary = findChipBoundary(value, chips, cursorPos);
+          if (cursorPos === boundary?.end) {
+            e.preventDefault();
+            const newText = removeChipTokenFromText(value, boundary.chip);
+            onValueChange(newText);
+            onChipRemove(boundary.chip.id);
+            // Set cursor to where chip started
+            requestAnimationFrame(() => {
+              textarea.setSelectionRange(boundary.start, boundary.start);
+            });
+          }
+        } else if (e.key === 'Delete') {
+          // If cursor is at chip start → delete entire chip
+          const boundary = findChipBoundary(value, chips, cursorPos);
+          if (cursorPos === boundary?.start) {
+            e.preventDefault();
+            const newText = removeChipTokenFromText(value, boundary.chip);
+            onValueChange(newText);
+            onChipRemove(boundary.chip.id);
+            requestAnimationFrame(() => {
+              textarea.setSelectionRange(boundary.start, boundary.start);
+            });
+          }
+        } else if (e.key === 'ArrowLeft' && !e.shiftKey) {
+          // If cursor is at chip end → jump to chip start
+          const boundary = findChipBoundary(value, chips, cursorPos);
+          if (cursorPos === boundary?.end) {
+            e.preventDefault();
+            textarea.setSelectionRange(boundary.start, boundary.start);
+          }
+        } else if (e.key === 'ArrowRight' && !e.shiftKey) {
+          // If cursor is at chip start → jump to chip end
+          const boundary = findChipBoundary(value, chips, cursorPos);
+          if (cursorPos === boundary?.start) {
+            e.preventDefault();
+            textarea.setSelectionRange(boundary.end, boundary.end);
+          }
+        } else if (e.key === 'ArrowLeft' && e.shiftKey) {
+          // Extend selection past chip atomically
+          const boundary = findChipBoundary(value, chips, cursorPos);
+          if (cursorPos === boundary?.end) {
+            e.preventDefault();
+            textarea.setSelectionRange(boundary.start, selectionEnd);
+          }
+        } else if (e.key === 'ArrowRight' && e.shiftKey) {
+          const boundary = findChipBoundary(value, chips, cursorPos);
+          if (cursorPos === boundary?.start) {
+            e.preventDefault();
+            textarea.setSelectionRange(selectionStart, boundary.end);
+          }
+        }
+      },
+      [chips, onChipRemove, value, onValueChange]
+    );
+
+    // --- File-aware keyboard handler (replaces mention handler when files enabled) ---
+    const fileMentionHandleKeyDown = React.useCallback(
+      (e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+        if (!isOpen || allSuggestions.length === 0) return;
+
+        switch (e.key) {
+          case 'ArrowDown':
+            e.preventDefault();
+            setMergedIndex((prev) => (prev + 1) % allSuggestions.length);
+            break;
+          case 'ArrowUp':
+            e.preventDefault();
+            setMergedIndex((prev) => (prev - 1 + allSuggestions.length) % allSuggestions.length);
+            break;
+          case 'Enter':
+            e.preventDefault();
+            if (allSuggestions[mergedIndex]) {
+              handleMergedSelect(allSuggestions[mergedIndex]);
+            }
+            break;
+          case 'Escape':
+            e.preventDefault();
+            dismiss();
+            break;
+        }
+      },
+      [isOpen, allSuggestions, mergedIndex, handleMergedSelect, dismiss]
+    );
+
+    // Composed key handler: chip logic → (file-aware OR original) mention logic
+    const composedHandleKeyDown = React.useCallback(
+      (e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+        handleChipKeyDown(e);
+        if (!e.defaultPrevented) {
+          if (enableFiles) {
+            fileMentionHandleKeyDown(e);
+          } else {
+            mentionHandleKeyDown(e);
+          }
+        }
+      },
+      [handleChipKeyDown, enableFiles, fileMentionHandleKeyDown, mentionHandleKeyDown]
+    );
+
+    // --- Chip reconciliation on text change ---
+    const composedHandleChange = React.useCallback(
+      (e: React.ChangeEvent<HTMLTextAreaElement>) => {
+        mentionHandleChange(e);
+
+        // Reconcile chips after text changes (paste/cut/undo)
+        if (chips.length > 0 && onChipRemove) {
+          const newText = e.target.value;
+          const surviving = reconcileChips(chips, newText);
+          if (surviving.length < chips.length) {
+            const survivingIds = new Set(surviving.map((c) => c.id));
+            for (const chip of chips) {
+              if (!survivingIds.has(chip.id)) {
+                onChipRemove(chip.id);
+              }
+            }
+          }
+        }
+      },
+      [mentionHandleChange, chips, onChipRemove]
+    );
+
+    // --- Snap cursor on click/select if inside chip ---
+    const composedHandleSelect = React.useCallback(
+      (e: React.SyntheticEvent<HTMLTextAreaElement>) => {
+        mentionHandleSelect(e);
+
+        if (chips.length > 0) {
+          const textarea = internalRef.current;
+          if (!textarea) return;
+          const { selectionStart, selectionEnd } = textarea;
+          // Only snap collapsed cursor
+          if (selectionStart !== selectionEnd) return;
+
+          const boundary = findChipBoundary(value, chips, selectionStart);
+          if (boundary && selectionStart > boundary.start && selectionStart < boundary.end) {
+            // Snap to nearest boundary
+            const distToStart = selectionStart - boundary.start;
+            const distToEnd = boundary.end - selectionStart;
+            const snapTo = distToStart <= distToEnd ? boundary.start : boundary.end;
+            requestAnimationFrame(() => {
+              textarea.setSelectionRange(snapTo, snapTo);
+            });
+          }
+        }
+      },
+      [mentionHandleSelect, chips, value]
+    );
+
+    // --- Chip remove handler (from X button in interaction layer) ---
+    const handleChipRemove = React.useCallback(
+      (chipId: string) => {
+        const chip = chips.find((c) => c.id === chipId);
+        if (chip) {
+          const newText = removeChipTokenFromText(value, chip);
+          onValueChange(newText);
+        }
+        onChipRemove?.(chipId);
+      },
+      [chips, value, onValueChange, onChipRemove]
+    );
+
     // When overlay is active: textarea text is transparent, caret stays visible
-    const textareaStyle: React.CSSProperties | undefined = hasMentionOverlay
+    const textareaStyle: React.CSSProperties | undefined = hasOverlay
       ? {
           ...style,
           color: 'transparent',
@@ -213,13 +585,19 @@ export const MentionableTextarea = React.forwardRef<HTMLTextAreaElement, Mention
         }
       : style;
 
-    const showFooter = (showHint && suggestions.length > 0) || footerRight;
+    // --- Hint text ---
+    const defaultHintText = enableFiles
+      ? 'Use @ to mention team members or search files'
+      : 'Use @ to mention team members';
+    const resolvedHintText = hintText ?? defaultHintText;
+    const showHintRow = showHint && (suggestions.length > 0 || enableFiles);
+    const showFooter = showHintRow || footerRight;
 
     return (
       <div className="relative">
         {/* Inner wrapper for textarea + backdrop overlay */}
         <div className="relative">
-          {hasMentionOverlay ? (
+          {hasOverlay ? (
             <div
               ref={backdropRef}
               className={cn(
@@ -237,6 +615,10 @@ export const MentionableTextarea = React.forwardRef<HTMLTextAreaElement, Mention
                 if (seg.type === 'text') {
                   return <React.Fragment key={idx}>{seg.value}</React.Fragment>;
                 }
+                if (seg.type === 'chip') {
+                  return <CodeChipBadge key={idx} chip={seg.chip} tokenText={seg.value} />;
+                }
+                // mention
                 const colorSet = seg.suggestion.color
                   ? getTeamColorSet(seg.suggestion.color)
                   : null;
@@ -262,14 +644,25 @@ export const MentionableTextarea = React.forwardRef<HTMLTextAreaElement, Mention
           <AutoResizeTextarea
             ref={setRefs}
             value={value}
-            onChange={handleChange}
-            onKeyDown={handleKeyDown}
-            onSelect={handleSelect}
+            onChange={composedHandleChange}
+            onKeyDown={composedHandleKeyDown}
+            onSelect={composedHandleSelect}
             {...textareaProps}
             className={cn(className, cornerAction && 'pb-12 pr-[4.25rem]')}
             onScroll={handleScroll}
             style={textareaStyle}
           />
+
+          {chips.length > 0 && onChipRemove ? (
+            <ChipInteractionLayer
+              chips={chips}
+              value={value}
+              textareaRef={internalRef}
+              scrollTop={scrollTop}
+              onRemove={handleChipRemove}
+            />
+          ) : null}
+
           {cornerAction ? (
             <div className="pointer-events-none absolute bottom-2 right-2 z-20 flex items-end justify-end">
               <div className="pointer-events-auto">{cornerAction}</div>
@@ -279,8 +672,8 @@ export const MentionableTextarea = React.forwardRef<HTMLTextAreaElement, Mention
 
         {showFooter ? (
           <div className="mt-1 flex items-center justify-between">
-            {showHint && suggestions.length > 0 ? (
-              <span className="text-[10px] text-[var(--color-text-muted)]">{hintText}</span>
+            {showHintRow ? (
+              <span className="text-[10px] text-[var(--color-text-muted)]">{resolvedHintText}</span>
             ) : (
               <span />
             )}
@@ -290,10 +683,11 @@ export const MentionableTextarea = React.forwardRef<HTMLTextAreaElement, Mention
         {isOpen && dropdownPosition ? (
           <div className="absolute left-0 z-50 w-full" style={{ top: `${dropdownPosition.top}px` }}>
             <MentionSuggestionList
-              suggestions={filteredSuggestions}
-              selectedIndex={selectedIndex}
-              onSelect={selectSuggestion}
+              suggestions={effectiveSuggestions}
+              selectedIndex={effectiveIndex}
+              onSelect={enableFiles ? handleMergedSelect : selectSuggestion}
               query={query}
+              hasFileSearch={enableFiles}
             />
           </div>
         ) : null}
diff --git a/src/renderer/hooks/useChipDraftPersistence.ts b/src/renderer/hooks/useChipDraftPersistence.ts
new file mode 100644
index 00000000..16f16ad8
--- /dev/null
+++ b/src/renderer/hooks/useChipDraftPersistence.ts
@@ -0,0 +1,131 @@
+/**
+ * Draft persistence for InlineChip arrays.
+ *
+ * Uses the same draftStorage (IndexedDB + fallback) as useDraftPersistence,
+ * serializing chips as JSON strings.
+ */
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+
+import { draftStorage } from '@renderer/services/draftStorage';
+
+import type { InlineChip } from '@renderer/types/inlineChip';
+
+interface UseChipDraftResult {
+  chips: InlineChip[];
+  /** Accepts a direct value (not a callback). Saves to draftStorage with debounce. */
+  setChips: (chips: InlineChip[]) => void;
+  clearChipDraft: () => void;
+  isSaved: boolean;
+}
+
+const DEBOUNCE_MS = 500;
+
+function isValidChipArray(data: unknown): data is InlineChip[] {
+  if (!Array.isArray(data)) return false;
+  return data.every((raw) => {
+    if (typeof raw !== 'object' || raw === null) return false;
+    const item = raw as Record<string, unknown>;
+    return (
+      typeof item.id === 'string' &&
+      typeof item.filePath === 'string' &&
+      typeof item.fileName === 'string' &&
+      (typeof item.fromLine === 'number' || item.fromLine === null) &&
+      (typeof item.toLine === 'number' || item.toLine === null) &&
+      typeof item.codeText === 'string' &&
+      typeof item.language === 'string'
+    );
+  });
+}
+
+export function useChipDraftPersistence(key: string): UseChipDraftResult {
+  const [chips, setChipsState] = useState<InlineChip[]>([]);
+  const [isSaved, setIsSaved] = useState(false);
+  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const pendingRef = useRef<InlineChip[] | null>(null);
+  const keyRef = useRef(key);
+  // eslint-disable-next-line react-hooks/refs -- sync ref with prop for stable callbacks
+  keyRef.current = key;
+
+  // Load on mount
+  useEffect(() => {
+    let cancelled = false;
+    void (async () => {
+      const raw = await draftStorage.loadDraft(key);
+      if (cancelled || raw == null) return;
+      try {
+        const parsed: unknown = JSON.parse(raw);
+        if (isValidChipArray(parsed)) {
+          setChipsState(parsed);
+          setIsSaved(true);
+        }
+      } catch {
+        // Invalid JSON — ignore, start with empty array
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [key]);
+
+  const flushPending = useCallback(() => {
+    if (timerRef.current != null) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    if (pendingRef.current != null) {
+      const val = pendingRef.current;
+      pendingRef.current = null;
+      if (val.length === 0) {
+        void draftStorage.deleteDraft(keyRef.current);
+      } else {
+        void draftStorage.saveDraft(keyRef.current, JSON.stringify(val));
+      }
+    }
+  }, []);
+
+  // Flush on unmount
+  useEffect(() => {
+    return () => {
+      flushPending();
+    };
+  }, [flushPending]);
+
+  const setChips = useCallback((nextChips: InlineChip[]) => {
+    setChipsState(nextChips);
+    setIsSaved(false);
+    pendingRef.current = nextChips;
+
+    if (timerRef.current != null) {
+      clearTimeout(timerRef.current);
+    }
+
+    timerRef.current = setTimeout(() => {
+      timerRef.current = null;
+      const pending = pendingRef.current;
+      pendingRef.current = null;
+      if (pending == null) return;
+
+      if (pending.length === 0) {
+        void draftStorage.deleteDraft(keyRef.current);
+      } else {
+        void draftStorage.saveDraft(keyRef.current, JSON.stringify(pending)).then(() => {
+          setIsSaved(true);
+        });
+      }
+    }, DEBOUNCE_MS);
+  }, []);
+
+  const clearChipDraft = useCallback(() => {
+    if (timerRef.current != null) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    pendingRef.current = null;
+    setChipsState([]);
+    setIsSaved(false);
+    void draftStorage.deleteDraft(keyRef.current);
+  }, []);
+
+  return { chips, setChips, clearChipDraft, isSaved };
+}
diff --git a/src/renderer/hooks/useDiffNavigation.ts b/src/renderer/hooks/useDiffNavigation.ts
index c1fee310..8c2f46b1 100644
--- a/src/renderer/hooks/useDiffNavigation.ts
+++ b/src/renderer/hooks/useDiffNavigation.ts
@@ -1,7 +1,11 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
 
 import { acceptChunk, goToNextChunk, goToPreviousChunk } from '@codemirror/merge';
-import { getChunks } from '@renderer/components/team/review/CodeMirrorDiffUtils';
+import {
+  computeChunkIndexAtPos,
+  getChunks,
+} from '@renderer/components/team/review/CodeMirrorDiffUtils';
+import { physicalKey } from '@renderer/utils/keyboardUtils';
 
 import type { EditorView } from '@codemirror/view';
 import type { FileChangeSummary } from '@shared/types/review';
@@ -98,7 +102,8 @@ export function useDiffNavigation(
   onHunkRejected?: (filePath: string, hunkIndex: number) => void,
   onClose?: () => void,
   onSaveFile?: () => void,
-  continuousOptions?: ContinuousNavigationOptions
+  continuousOptions?: ContinuousNavigationOptions,
+  getHunkCountForFile?: (filePath: string, fallbackSnippetsLength: number) => number
 ): DiffNavigationState {
   const [hunkState, setHunkState] = useState<{ filePath: string | null; index: number }>({
     filePath: selectedFilePath,
@@ -108,7 +113,10 @@ export function useDiffNavigation(
 
   const activePath = getActiveFilePath(selectedFilePath, continuousOptions);
   const selectedFile = files.find((f) => f.filePath === activePath);
-  const totalHunks = selectedFile?.snippets.length ?? 0;
+  const totalHunks =
+    selectedFile && getHunkCountForFile
+      ? getHunkCountForFile(selectedFile.filePath, selectedFile.snippets.length)
+      : (selectedFile?.snippets.length ?? 0);
 
   const currentHunkIndex = hunkState.filePath === activePath ? hunkState.index : 0;
 
@@ -256,14 +264,18 @@ export function useDiffNavigation(
     }
   }, [selectedFilePath, currentHunkIndex, onHunkRejected]);
 
-  // Store refs for stable closure
+  // Store refs for stable closure (avoids re-registering keydown on every render)
   const onCloseRef = useRef(onClose);
   const onSaveFileRef = useRef(onSaveFile);
+  const onHunkAcceptedRef = useRef(onHunkAccepted);
+  const selectedFilePathRef = useRef(selectedFilePath);
 
   useEffect(() => {
     onCloseRef.current = onClose;
     onSaveFileRef.current = onSaveFile;
-  }, [onClose, onSaveFile]);
+    onHunkAcceptedRef.current = onHunkAccepted;
+    selectedFilePathRef.current = selectedFilePath;
+  }, [onClose, onSaveFile, onHunkAccepted, selectedFilePath]);
 
   // Keyboard handler
   useEffect(() => {
@@ -276,55 +288,60 @@ export function useDiffNavigation(
       }
 
       const isMeta = event.metaKey || event.ctrlKey;
+      // Layout-independent key (uses event.code for letters/symbols)
+      const key = physicalKey(event);
 
       // Alt+J -> next hunk (cross-file in continuous mode)
-      if (event.altKey && event.key.toLowerCase() === 'j') {
+      if (event.altKey && key === 'j') {
         event.preventDefault();
         goToNextHunk();
         return;
       }
 
       // Alt+K -> prev hunk (cross-file in continuous mode)
-      if (event.altKey && event.key.toLowerCase() === 'k') {
+      if (event.altKey && key === 'k') {
         event.preventDefault();
         goToPrevHunk();
         return;
       }
 
       // Alt+ArrowDown -> next file
-      if (event.altKey && event.key === 'ArrowDown') {
+      if (event.altKey && key === 'ArrowDown') {
         event.preventDefault();
         goToNextFile();
         return;
       }
 
       // Alt+ArrowUp -> prev file
-      if (event.altKey && event.key === 'ArrowUp') {
+      if (event.altKey && key === 'ArrowUp') {
         event.preventDefault();
         goToPrevFile();
         return;
       }
 
-      // Cmd+Enter -> save file
-      if (isMeta && event.key === 'Enter') {
+      // Cmd+S -> save file
+      if (isMeta && key === 's' && !event.shiftKey) {
         event.preventDefault();
         onSaveFileRef.current?.();
         return;
       }
 
       // Cmd+Y -> accept chunk + next (cross-file aware)
-      if (isMeta && event.key.toLowerCase() === 'y') {
+      if (isMeta && key === 'y') {
         event.preventDefault();
         const view = getActiveEditorView(editorViewRef, continuousOptionsRef.current);
         if (view) {
+          const filePath = getActiveFilePath(
+            selectedFilePathRef.current,
+            continuousOptionsRef.current
+          );
+          if (filePath && onHunkAcceptedRef.current) {
+            const cursorPos = view.state.selection.main.head;
+            const idx = computeChunkIndexAtPos(view.state, cursorPos);
+            onHunkAcceptedRef.current(filePath, idx);
+          }
           acceptChunk(view);
-          requestAnimationFrame(() => {
-            if (continuousOptionsRef.current?.enabled && isLastChunkInFile(view)) {
-              goToNextFile();
-            } else {
-              goToNextChunk(view);
-            }
-          });
+          requestAnimationFrame(() => goToNextHunk());
         }
         return;
       }
diff --git a/src/renderer/hooks/useEditorKeyboardShortcuts.ts b/src/renderer/hooks/useEditorKeyboardShortcuts.ts
index 58cf09e1..f4ecf217 100644
--- a/src/renderer/hooks/useEditorKeyboardShortcuts.ts
+++ b/src/renderer/hooks/useEditorKeyboardShortcuts.ts
@@ -5,11 +5,13 @@
  * CM6-internal shortcuts (Cmd+Z, Cmd+Shift+Z, Cmd+A, Cmd+D) are handled by CodeMirror directly.
  */
 
-import { useCallback, useEffect } from 'react';
+import { useCallback, useEffect, useRef } from 'react';
 
-import { gotoLine, openSearchPanel } from '@codemirror/search';
+import { openSearchPanel } from '@codemirror/search';
 import { useStore } from '@renderer/store';
 import { editorBridge } from '@renderer/utils/editorBridge';
+import { physicalKey } from '@renderer/utils/keyboardUtils';
+import { useShallow } from 'zustand/react/shallow';
 
 import type { EditorFileTab } from '@shared/types/editor';
 
@@ -20,8 +22,11 @@ import type { EditorFileTab } from '@shared/types/editor';
 interface UseEditorKeyboardShortcutsOptions {
   onToggleQuickOpen: () => void;
   onToggleSearchPanel: () => void;
+  onToggleGoToLine: () => void;
   onToggleSidebar: () => void;
   onClose: () => void;
+  onToggleMdSplit?: () => void;
+  onToggleMdPreview?: () => void;
 }
 
 /** Dependencies injected into the key handler for testability. */
@@ -34,8 +39,11 @@ export interface EditorKeyHandlerDeps {
   hasUnsavedChanges: () => boolean;
   onToggleQuickOpen: () => void;
   onToggleSearchPanel: () => void;
+  onToggleGoToLine: () => void;
   onToggleSidebar: () => void;
   onToggleLineWrap: () => void;
+  onToggleMdSplit?: () => void;
+  onToggleMdPreview?: () => void;
   getEditorView: () => { dispatch: unknown } | null;
 }
 
@@ -52,8 +60,11 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
     const isMod = e.metaKey || e.ctrlKey;
     if (!isMod) return;
 
+    // Layout-independent key (uses event.code for letters/symbols)
+    const key = physicalKey(e);
+
     // Cmd+P: Quick Open
-    if (e.key === 'p' && !e.shiftKey) {
+    if (key === 'p' && !e.shiftKey) {
       e.preventDefault();
       e.stopPropagation();
       deps.onToggleQuickOpen();
@@ -61,7 +72,7 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
     }
 
     // Cmd+Shift+F: Search in files
-    if (e.key === 'f' && e.shiftKey) {
+    if (key === 'f' && e.shiftKey) {
       e.preventDefault();
       e.stopPropagation();
       deps.onToggleSearchPanel();
@@ -69,7 +80,7 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
     }
 
     // Cmd+F: Find in current file (CM6)
-    if (e.key === 'f' && !e.shiftKey) {
+    if (key === 'f' && !e.shiftKey) {
       e.preventDefault();
       e.stopPropagation();
       const view = deps.getEditorView();
@@ -78,16 +89,15 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
     }
 
     // Cmd+G: Go to line
-    if (e.key === 'g' && !e.shiftKey) {
+    if (key === 'g' && !e.shiftKey) {
       e.preventDefault();
       e.stopPropagation();
-      const view = deps.getEditorView();
-      if (view) gotoLine(view as Parameters<typeof gotoLine>[0]);
+      deps.onToggleGoToLine();
       return;
     }
 
     // Cmd+S: Save current file
-    if (e.key === 's' && !e.shiftKey) {
+    if (key === 's' && !e.shiftKey) {
       e.preventDefault();
       e.stopPropagation();
       if (deps.activeTabId) void deps.saveFile(deps.activeTabId);
@@ -95,15 +105,31 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
     }
 
     // Cmd+Shift+S: Save all files
-    if (e.key === 's' && e.shiftKey) {
+    if (key === 's' && e.shiftKey) {
       e.preventDefault();
       e.stopPropagation();
       if (deps.hasUnsavedChanges()) void deps.saveAllFiles();
       return;
     }
 
+    // Cmd+Shift+M: Toggle markdown split preview
+    if (key === 'm' && e.shiftKey) {
+      e.preventDefault();
+      e.stopPropagation();
+      deps.onToggleMdSplit?.();
+      return;
+    }
+
+    // Cmd+Shift+V: Toggle markdown full preview
+    if (key === 'v' && e.shiftKey) {
+      e.preventDefault();
+      e.stopPropagation();
+      deps.onToggleMdPreview?.();
+      return;
+    }
+
     // Cmd+Shift+W: Toggle line wrap
-    if (e.key === 'w' && e.shiftKey && !e.altKey) {
+    if (key === 'w' && e.shiftKey && !e.altKey) {
       e.preventDefault();
       e.stopPropagation();
       deps.onToggleLineWrap();
@@ -111,7 +137,7 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
     }
 
     // Cmd+W: Close current editor tab
-    if (e.key === 'w' && !e.shiftKey && !e.altKey) {
+    if (key === 'w' && !e.shiftKey && !e.altKey) {
       e.preventDefault();
       e.stopPropagation();
       if (deps.activeTabId) {
@@ -123,7 +149,7 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
     }
 
     // Cmd+B: Toggle sidebar
-    if (e.key === 'b') {
+    if (key === 'b') {
       e.preventDefault();
       e.stopPropagation();
       deps.onToggleSidebar();
@@ -131,7 +157,7 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
     }
 
     // Cmd+Shift+]: Next tab
-    if (e.key === ']' && e.shiftKey) {
+    if (key === ']' && e.shiftKey) {
       e.preventDefault();
       e.stopPropagation();
       const idx = deps.openTabs.findIndex((t) => t.id === deps.activeTabId);
@@ -144,7 +170,7 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
     }
 
     // Cmd+Shift+[: Previous tab
-    if (e.key === '[' && e.shiftKey) {
+    if (key === '[' && e.shiftKey) {
       e.preventDefault();
       e.stopPropagation();
       const idx = deps.openTabs.findIndex((t) => t.id === deps.activeTabId);
@@ -157,7 +183,7 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
     }
 
     // Ctrl+Tab / Ctrl+Shift+Tab: Tab cycling
-    if (e.ctrlKey && e.key === 'Tab') {
+    if (e.ctrlKey && key === 'Tab') {
       e.preventDefault();
       e.stopPropagation();
       const idx = deps.openTabs.findIndex((t) => t.id === deps.activeTabId);
@@ -181,47 +207,48 @@ export function createEditorKeyHandler(deps: EditorKeyHandlerDeps): (e: Keyboard
 export function useEditorKeyboardShortcuts({
   onToggleQuickOpen,
   onToggleSearchPanel,
+  onToggleGoToLine,
   onToggleSidebar,
   onClose: _onClose,
+  onToggleMdSplit,
+  onToggleMdPreview,
 }: UseEditorKeyboardShortcutsOptions): void {
-  const openTabs = useStore((s) => s.editorOpenTabs);
-  const activeTabId = useStore((s) => s.editorActiveTabId);
+  const { openTabs, activeTabId } = useStore(
+    useShallow((s) => ({
+      openTabs: s.editorOpenTabs,
+      activeTabId: s.editorActiveTabId,
+    }))
+  );
   const setActiveEditorTab = useStore((s) => s.setActiveEditorTab);
   const saveFile = useStore((s) => s.saveFile);
   const saveAllFiles = useStore((s) => s.saveAllFiles);
   const hasUnsavedChanges = useStore((s) => s.hasUnsavedChanges);
   const toggleLineWrap = useStore((s) => s.toggleLineWrap);
 
-  const handleKeyDown = useCallback(
-    (e: KeyboardEvent) => {
-      const handler = createEditorKeyHandler({
-        activeTabId,
-        openTabs,
-        setActiveEditorTab,
-        saveFile,
-        saveAllFiles,
-        hasUnsavedChanges,
-        onToggleQuickOpen,
-        onToggleSearchPanel,
-        onToggleSidebar,
-        onToggleLineWrap: toggleLineWrap,
-        getEditorView: () => editorBridge.getView(),
-      });
-      handler(e);
-    },
-    [
-      activeTabId,
-      openTabs,
-      setActiveEditorTab,
-      saveFile,
-      saveAllFiles,
-      hasUnsavedChanges,
-      onToggleQuickOpen,
-      onToggleSearchPanel,
-      onToggleSidebar,
-      toggleLineWrap,
-    ]
-  );
+  // Store all deps in a ref so the keydown handler has a stable identity
+  const depsRef = useRef<EditorKeyHandlerDeps>(null!);
+  // eslint-disable-next-line react-hooks/refs -- sync ref with deps for stable keydown handler
+  depsRef.current = {
+    activeTabId,
+    openTabs,
+    setActiveEditorTab,
+    saveFile,
+    saveAllFiles,
+    hasUnsavedChanges,
+    onToggleQuickOpen,
+    onToggleSearchPanel,
+    onToggleGoToLine,
+    onToggleSidebar,
+    onToggleLineWrap: toggleLineWrap,
+    onToggleMdSplit,
+    onToggleMdPreview,
+    getEditorView: () => editorBridge.getView(),
+  };
+
+  const handleKeyDown = useCallback((e: KeyboardEvent) => {
+    const handler = createEditorKeyHandler(depsRef.current);
+    handler(e);
+  }, []);
 
   useEffect(() => {
     window.addEventListener('keydown', handleKeyDown, true); // capture phase
diff --git a/src/renderer/hooks/useFileSuggestions.ts b/src/renderer/hooks/useFileSuggestions.ts
new file mode 100644
index 00000000..02ac5703
--- /dev/null
+++ b/src/renderer/hooks/useFileSuggestions.ts
@@ -0,0 +1,128 @@
+/**
+ * Hook for loading and filtering project files as @-mention suggestions.
+ *
+ * Uses the Quick Open file list API with a 10s TTL cache.
+ * Returns up to 8 matching files filtered by name or relative path.
+ */
+
+import { useCallback, useEffect, useMemo, useState } from 'react';
+
+import {
+  getQuickOpenCache,
+  onQuickOpenCacheInvalidated,
+  setQuickOpenCache,
+} from '@renderer/utils/quickOpenCache';
+
+import type { MentionSuggestion } from '@renderer/types/mention';
+import type { QuickOpenFile } from '@shared/types/editor';
+
+const MAX_FILE_SUGGESTIONS = 8;
+
+/**
+ * Filters files by query (name or relative path) and converts to MentionSuggestion[].
+ * Exported for testing.
+ */
+export function filterFileSuggestions(files: QuickOpenFile[], query: string): MentionSuggestion[] {
+  if (!query || files.length === 0) return [];
+
+  const lower = query.toLowerCase();
+  const results: MentionSuggestion[] = [];
+
+  for (const f of files) {
+    if (results.length >= MAX_FILE_SUGGESTIONS) break;
+
+    if (f.name.toLowerCase().includes(lower) || f.relativePath.toLowerCase().includes(lower)) {
+      results.push({
+        id: `file:${f.path}`,
+        name: f.name,
+        subtitle: f.relativePath,
+        type: 'file',
+        filePath: f.path,
+        relativePath: f.relativePath,
+      });
+    }
+  }
+
+  return results;
+}
+
+/**
+ * Loads project files and returns filtered MentionSuggestion[] with type: 'file'.
+ *
+ * @param projectPath - Project root path (null disables)
+ * @param query - Current @-mention query string
+ * @param enabled - Whether file suggestions are active (isOpen && enableFiles)
+ */
+export function useFileSuggestions(
+  projectPath: string | null,
+  query: string,
+  enabled: boolean
+): MentionSuggestion[] {
+  const [allFiles, setAllFiles] = useState<QuickOpenFile[]>([]);
+  // Bumped on cache invalidation (file create/delete) to trigger refetch
+  const [fetchTrigger, setFetchTrigger] = useState(0);
+
+  // Seed from cache immediately when projectPath changes (setState-during-render pattern)
+  const [prevPath, setPrevPath] = useState(projectPath);
+  if (prevPath !== projectPath) {
+    setPrevPath(projectPath);
+    const cached = projectPath ? getQuickOpenCache(projectPath) : null;
+    if (cached) {
+      setAllFiles(cached.files);
+    } else {
+      setAllFiles([]);
+    }
+  }
+
+  // React to cache invalidation from EditorFileWatcher (create/delete events)
+  useEffect(() => {
+    return onQuickOpenCacheInvalidated(() => setFetchTrigger((n) => n + 1));
+  }, []);
+
+  // Lazy refetch: when dropdown opens and cache is stale, trigger a reload
+  const [prevEnabled, setPrevEnabled] = useState(enabled);
+  if (enabled && !prevEnabled && projectPath && !getQuickOpenCache(projectPath)) {
+    setFetchTrigger((n) => n + 1);
+  }
+  if (prevEnabled !== enabled) {
+    setPrevEnabled(enabled);
+  }
+
+  // Load files from API when cache is empty.
+  // Uses project:listFiles (not editor:listFiles) — works without editor being open.
+  const fetchFiles = useCallback(
+    (projectRoot: string) => {
+      let cancelled = false;
+      window.electronAPI.project
+        .listFiles(projectRoot)
+        .then((files) => {
+          if (cancelled) return;
+          setQuickOpenCache(projectRoot, files);
+          setAllFiles(files);
+        })
+        .catch(() => {
+          // Project path may be invalid — will retry on next trigger
+        });
+      return () => {
+        cancelled = true;
+      };
+    },
+    [] // listFiles API is stable
+  );
+
+  useEffect(() => {
+    if (!projectPath) return;
+
+    // Cache already seeded during render — only fetch if missing
+    const cached = getQuickOpenCache(projectPath);
+    if (cached) return;
+
+    return fetchFiles(projectPath);
+  }, [projectPath, fetchTrigger, fetchFiles]);
+
+  // Filter by query and convert to MentionSuggestion[]
+  return useMemo(
+    () => (enabled ? filterFileSuggestions(allFiles, query) : []),
+    [enabled, query, allFiles]
+  );
+}
diff --git a/src/renderer/hooks/useKeyboardShortcuts.ts b/src/renderer/hooks/useKeyboardShortcuts.ts
index de229a33..dbf9c56d 100644
--- a/src/renderer/hooks/useKeyboardShortcuts.ts
+++ b/src/renderer/hooks/useKeyboardShortcuts.ts
@@ -8,6 +8,7 @@
 
 import { useEffect } from 'react';
 
+import { physicalKey } from '@renderer/utils/keyboardUtils';
 import { createLogger } from '@shared/utils/logger';
 import { useShallow } from 'zustand/react/shallow';
 
@@ -78,27 +79,29 @@ export function useKeyboardShortcuts(): void {
     function handleKeyDown(event: KeyboardEvent): void {
       // Check if Cmd (macOS) or Ctrl (Windows/Linux) is pressed
       const isMod = event.metaKey || event.ctrlKey;
+      // Layout-independent key (uses event.code for letters/symbols)
+      const key = physicalKey(event);
 
       // Editor scope guard: when the editor overlay is open, these shortcuts are
       // handled by useEditorKeyboardShortcuts — yield control to avoid conflicts.
       if (editorOpen) {
         const isConflicting =
           // Ctrl+Tab — editor tab cycling
-          (event.ctrlKey && event.key === 'Tab') ||
+          (event.ctrlKey && key === 'Tab') ||
           // Cmd+W — editor close tab
-          (isMod && event.key === 'w' && !event.altKey && !event.shiftKey) ||
+          (isMod && key === 'w' && !event.altKey && !event.shiftKey) ||
           // Cmd+B — editor sidebar toggle
-          (isMod && event.key === 'b') ||
+          (isMod && key === 'b') ||
           // Cmd+F — editor find in file (CM6)
-          (isMod && event.key === 'f') ||
+          (isMod && key === 'f') ||
           // Cmd+Shift+[ / ] — editor tab switching
-          (isMod && event.shiftKey && (event.key === '[' || event.key === ']'));
+          (isMod && event.shiftKey && (key === '[' || key === ']'));
 
         if (isConflicting) return;
       }
 
       // Ctrl+Tab / Ctrl+Shift+Tab: Switch tabs within focused pane (universal shortcut)
-      if (event.ctrlKey && event.key === 'Tab') {
+      if (event.ctrlKey && key === 'Tab') {
         event.preventDefault();
         const currentIndex = openTabs.findIndex((t) => t.id === activeTabId);
 
@@ -128,7 +131,7 @@ export function useKeyboardShortcuts(): void {
 
       // Cmd+Option+1-4: Focus pane by index
       if (event.altKey && !event.shiftKey) {
-        const numKey = parseInt(event.key);
+        const numKey = parseInt(key);
         if (numKey >= 1 && numKey <= 4) {
           event.preventDefault();
           const targetPane = paneLayout.panes[numKey - 1];
@@ -139,7 +142,7 @@ export function useKeyboardShortcuts(): void {
         }
 
         // Cmd+Option+W: Close current pane
-        if (event.key === 'w') {
+        if (key === 'w') {
           event.preventDefault();
           if (paneLayout.panes.length > 1) {
             closePane(paneLayout.focusedPaneId);
@@ -149,7 +152,7 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+\: Split right with current tab
-      if (event.key === '\\' && !event.altKey && !event.shiftKey) {
+      if (key === '\\' && !event.altKey && !event.shiftKey) {
         event.preventDefault();
         if (activeTabId) {
           splitPane(paneLayout.focusedPaneId, activeTabId, 'right');
@@ -158,21 +161,21 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+T: New tab (Dashboard)
-      if (event.key === 't') {
+      if (key === 't') {
         event.preventDefault();
         openDashboard();
         return;
       }
 
       // Cmd+Shift+W: Close all tabs
-      if (event.key === 'w' && event.shiftKey && !event.altKey) {
+      if (key === 'w' && event.shiftKey && !event.altKey) {
         event.preventDefault();
         closeAllTabs();
         return;
       }
 
       // Cmd+W: Close selected tabs (if multi-selected) or active tab
-      if (event.key === 'w' && !event.altKey) {
+      if (key === 'w' && !event.altKey) {
         event.preventDefault();
         if (selectedTabIds.length > 0) {
           closeTabs(selectedTabIds);
@@ -183,7 +186,7 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+[1-9]: Switch to tab by index within focused pane
-      const numKey = parseInt(event.key);
+      const numKey = parseInt(key);
       if (numKey >= 1 && numKey <= 9 && !event.altKey) {
         event.preventDefault();
         const targetTab = openTabs[numKey - 1];
@@ -194,7 +197,7 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+Shift+]: Next tab within focused pane
-      if (event.key === ']' && event.shiftKey) {
+      if (key === ']' && event.shiftKey) {
         event.preventDefault();
         const currentIndex = openTabs.findIndex((t) => t.id === activeTabId);
         if (currentIndex !== -1 && currentIndex < openTabs.length - 1) {
@@ -204,7 +207,7 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+Shift+[: Previous tab within focused pane
-      if (event.key === '[' && event.shiftKey) {
+      if (key === '[' && event.shiftKey) {
         event.preventDefault();
         const currentIndex = openTabs.findIndex((t) => t.id === activeTabId);
         if (currentIndex > 0) {
@@ -214,7 +217,7 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+Option+Right: Next tab (browser-style) within focused pane
-      if (event.key === 'ArrowRight' && event.altKey) {
+      if (key === 'ArrowRight' && event.altKey) {
         event.preventDefault();
         const currentIndex = openTabs.findIndex((t) => t.id === activeTabId);
         if (currentIndex !== -1 && currentIndex < openTabs.length - 1) {
@@ -224,7 +227,7 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+Option+Left: Previous tab (browser-style) within focused pane
-      if (event.key === 'ArrowLeft' && event.altKey) {
+      if (key === 'ArrowLeft' && event.altKey) {
         event.preventDefault();
         const currentIndex = openTabs.findIndex((t) => t.id === activeTabId);
         if (currentIndex > 0) {
@@ -234,7 +237,7 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+Shift+K: Cycle to next workspace context
-      if (event.key === 'k' && event.shiftKey) {
+      if (key === 'k' && event.shiftKey) {
         event.preventDefault();
         if (!isContextSwitching && availableContexts.length > 1) {
           const currentIndex = availableContexts.findIndex((c) => c.id === activeContextId);
@@ -245,21 +248,21 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+K: Open command palette for global search
-      if (event.key === 'k') {
+      if (key === 'k') {
         event.preventDefault();
         openCommandPalette();
         return;
       }
 
       // Cmd+,: Open settings (standard macOS shortcut)
-      if (event.key === ',') {
+      if (key === ',') {
         event.preventDefault();
         openSettingsTab();
         return;
       }
 
       // Cmd+F: Find in session
-      if (event.key === 'f') {
+      if (key === 'f') {
         event.preventDefault();
         const activeTab = getActiveTab();
         // Only enable search in session views, not dashboard
@@ -270,14 +273,14 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+O: Open project (placeholder for future implementation)
-      if (event.key === 'o') {
+      if (key === 'o') {
         event.preventDefault();
         logger.debug('Open project shortcut triggered (not yet implemented)');
         return;
       }
 
       // Cmd+R: Refresh current session and sidebar session list
-      if (event.key === 'r') {
+      if (key === 'r') {
         event.preventDefault();
         if (selectedProjectId && selectedSessionId) {
           void Promise.all([
@@ -289,7 +292,7 @@ export function useKeyboardShortcuts(): void {
       }
 
       // Cmd+B: Toggle sidebar
-      if (event.key === 'b') {
+      if (key === 'b') {
         event.preventDefault();
         toggleSidebar();
       }
diff --git a/src/renderer/hooks/useMarkdownScrollSync.ts b/src/renderer/hooks/useMarkdownScrollSync.ts
new file mode 100644
index 00000000..b2fd8ad7
--- /dev/null
+++ b/src/renderer/hooks/useMarkdownScrollSync.ts
@@ -0,0 +1,147 @@
+/**
+ * Proportional scroll synchronization between CodeMirror and a preview pane.
+ *
+ * Uses the fraction-based approach: fraction = scrollTop / (scrollHeight - clientHeight).
+ * Feedback loop prevention via ref-based ignore flags reset with requestAnimationFrame.
+ *
+ * The hook auto-attaches/detaches the CodeMirror scroll listener internally:
+ * - Retry logic handles CodeMirror mount delay (up to 500ms)
+ * - `viewKey` triggers re-attachment when the EditorView changes (e.g. file switch)
+ * - Full cleanup on disable/unmount
+ */
+
+import { useCallback, useEffect, useRef } from 'react';
+
+import { editorBridge } from '@renderer/utils/editorBridge';
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+/** Max attempts to find CodeMirror scrollDOM before giving up */
+const MAX_ATTACH_ATTEMPTS = 10;
+/** Interval between retry attempts (ms) */
+const ATTACH_RETRY_INTERVAL = 50;
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export interface UseMarkdownScrollSyncResult {
+  previewScrollRef: React.RefObject<HTMLDivElement | null>;
+  /** Attach to preview div's onScroll */
+  handlePreviewScroll: () => void;
+}
+
+// =============================================================================
+// Hook
+// =============================================================================
+
+/**
+ * Bidirectional scroll sync between CodeMirror and a preview pane.
+ *
+ * @param enabled - Whether sync is active (typically `mode === 'split'`)
+ * @param viewKey - Changes when the underlying EditorView changes (e.g. `activeTabId`).
+ *                  Triggers re-attachment of the code scroll listener.
+ */
+export function useMarkdownScrollSync(
+  enabled: boolean,
+  viewKey?: string | null
+): UseMarkdownScrollSyncResult {
+  const previewScrollRef = useRef<HTMLDivElement | null>(null);
+  const ignoreCodeScroll = useRef(false);
+  const ignorePreviewScroll = useRef(false);
+  const codeRafRef = useRef(0);
+  const previewRafRef = useRef(0);
+
+  // Code → Preview: proportional scroll
+  const handleCodeScroll = useCallback(() => {
+    if (!enabled) return;
+    if (ignoreCodeScroll.current) {
+      ignoreCodeScroll.current = false;
+      return;
+    }
+
+    const scrollDOM = editorBridge.getView()?.scrollDOM;
+    const preview = previewScrollRef.current;
+    if (!scrollDOM || !preview) return;
+
+    const maxCode = scrollDOM.scrollHeight - scrollDOM.clientHeight;
+    if (maxCode <= 0) return;
+
+    const fraction = scrollDOM.scrollTop / maxCode;
+    const maxPreview = preview.scrollHeight - preview.clientHeight;
+    if (maxPreview <= 0) return;
+
+    cancelAnimationFrame(previewRafRef.current);
+    previewRafRef.current = requestAnimationFrame(() => {
+      ignorePreviewScroll.current = true;
+      preview.scrollTop = fraction * maxPreview;
+    });
+  }, [enabled]);
+
+  // Preview → Code: proportional scroll
+  const handlePreviewScroll = useCallback(() => {
+    if (!enabled) return;
+    if (ignorePreviewScroll.current) {
+      ignorePreviewScroll.current = false;
+      return;
+    }
+
+    const scrollDOM = editorBridge.getView()?.scrollDOM;
+    const preview = previewScrollRef.current;
+    if (!scrollDOM || !preview) return;
+
+    const maxPreview = preview.scrollHeight - preview.clientHeight;
+    if (maxPreview <= 0) return;
+
+    const fraction = preview.scrollTop / maxPreview;
+    const maxCode = scrollDOM.scrollHeight - scrollDOM.clientHeight;
+    if (maxCode <= 0) return;
+
+    cancelAnimationFrame(codeRafRef.current);
+    codeRafRef.current = requestAnimationFrame(() => {
+      ignoreCodeScroll.current = true;
+      scrollDOM.scrollTop = fraction * maxCode;
+    });
+  }, [enabled]);
+
+  // Auto-attach code scroll listener with retry on mount/viewKey change
+  useEffect(() => {
+    if (!enabled) return;
+
+    let scrollCleanup: (() => void) | undefined;
+    let retryTimer: ReturnType<typeof setTimeout>;
+    let attempts = 0;
+
+    const tryAttach = (): void => {
+      const scrollDOM = editorBridge.getView()?.scrollDOM;
+      if (!scrollDOM) {
+        if (attempts < MAX_ATTACH_ATTEMPTS) {
+          attempts++;
+          retryTimer = setTimeout(tryAttach, ATTACH_RETRY_INTERVAL);
+        }
+        return;
+      }
+
+      scrollDOM.addEventListener('scroll', handleCodeScroll, { passive: true });
+      scrollCleanup = () => {
+        scrollDOM.removeEventListener('scroll', handleCodeScroll);
+      };
+    };
+
+    tryAttach();
+
+    return () => {
+      clearTimeout(retryTimer);
+      scrollCleanup?.();
+      cancelAnimationFrame(codeRafRef.current);
+      cancelAnimationFrame(previewRafRef.current);
+    };
+  }, [enabled, viewKey, handleCodeScroll]);
+
+  return {
+    previewScrollRef,
+    handlePreviewScroll,
+  };
+}
diff --git a/src/renderer/hooks/useMentionDetection.ts b/src/renderer/hooks/useMentionDetection.ts
index 0230dab6..36027a0e 100644
--- a/src/renderer/hooks/useMentionDetection.ts
+++ b/src/renderer/hooks/useMentionDetection.ts
@@ -7,6 +7,8 @@ interface UseMentionDetectionOptions {
   value: string;
   onValueChange: (v: string) => void;
   textareaRef: React.RefObject<HTMLTextAreaElement | null>;
+  /** When true, detect @-trigger even if suggestions list is empty (e.g. for file-only search) */
+  enableTriggerAlways?: boolean;
 }
 
 export interface DropdownPosition {
@@ -25,6 +27,8 @@ interface UseMentionDetectionResult {
   handleKeyDown: (e: React.KeyboardEvent<HTMLTextAreaElement>) => void;
   handleChange: (e: React.ChangeEvent<HTMLTextAreaElement>) => void;
   handleSelect: (e: React.SyntheticEvent<HTMLTextAreaElement>) => void;
+  /** Current @-trigger character position in text (-1 if no active trigger) */
+  triggerIndex: number;
 }
 
 interface MentionTrigger {
@@ -154,12 +158,16 @@ export function useMentionDetection({
   value,
   onValueChange,
   textareaRef,
+  enableTriggerAlways,
 }: UseMentionDetectionOptions): UseMentionDetectionResult {
   const [isOpen, setIsOpen] = useState(false);
   const [query, setQuery] = useState('');
   const [selectedIndex, setSelectedIndex] = useState(0);
   const [dropdownPosition, setDropdownPosition] = useState<DropdownPosition | null>(null);
   const triggerIndexRef = useRef<number>(-1);
+  // Track current query in a ref so detectTrigger can avoid resetting selectedIndex
+  // on redundant selectionchange events (e.g. after ArrowDown/Up keyboard navigation)
+  const queryRef = useRef('');
 
   const filteredSuggestions = useMemo(() => {
     if (!isOpen) return [];
@@ -174,6 +182,7 @@ export function useMentionDetection({
     setSelectedIndex(0);
     setDropdownPosition(null);
     triggerIndexRef.current = -1;
+    queryRef.current = '';
   }, []);
 
   const computeDropdownPosition = useCallback(
@@ -212,20 +221,34 @@ export function useMentionDetection({
     [value, query, onValueChange, textareaRef, dismiss]
   );
 
+  /**
+   * Detects whether cursor is inside an @-trigger region and opens/dismisses the dropdown.
+   *
+   * Called from handleSelect (selectionchange) — must NOT reset selectedIndex when
+   * the trigger is already active with the same query, otherwise ArrowDown/Up navigation
+   * gets immediately undone by the selectionchange event that follows keydown.
+   */
   const detectTrigger = useCallback(
     (cursorPos: number) => {
       const trigger = findMentionTrigger(value, cursorPos);
-      if (trigger && suggestions.length > 0) {
+      if (trigger && (suggestions.length > 0 || enableTriggerAlways)) {
+        const sameQuery =
+          triggerIndexRef.current === trigger.triggerIndex && queryRef.current === trigger.query;
         triggerIndexRef.current = trigger.triggerIndex;
+        queryRef.current = trigger.query;
         setQuery(trigger.query);
         setIsOpen(true);
-        setSelectedIndex(0);
+        // Only reset selection when trigger/query actually changed —
+        // preserves keyboard navigation index across redundant selectionchange events
+        if (!sameQuery) {
+          setSelectedIndex(0);
+        }
         computeDropdownPosition(trigger.triggerIndex, value);
       } else {
         dismiss();
       }
     },
-    [value, suggestions.length, dismiss, computeDropdownPosition]
+    [value, suggestions.length, enableTriggerAlways, dismiss, computeDropdownPosition]
   );
 
   const handleChange = useCallback(
@@ -236,17 +259,19 @@ export function useMentionDetection({
       // Detect trigger based on cursor position after the change
       const cursorPos = e.target.selectionStart;
       const trigger = findMentionTrigger(newValue, cursorPos);
-      if (trigger && suggestions.length > 0) {
+      if (trigger && (suggestions.length > 0 || enableTriggerAlways)) {
         triggerIndexRef.current = trigger.triggerIndex;
+        queryRef.current = trigger.query;
         setQuery(trigger.query);
         setIsOpen(true);
+        // Text changed — always reset selection to first item
         setSelectedIndex(0);
         computeDropdownPosition(trigger.triggerIndex, newValue);
       } else {
         dismiss();
       }
     },
-    [onValueChange, suggestions.length, dismiss, computeDropdownPosition]
+    [onValueChange, suggestions.length, enableTriggerAlways, dismiss, computeDropdownPosition]
   );
 
   const handleSelect = useCallback(
@@ -296,5 +321,7 @@ export function useMentionDetection({
     handleKeyDown,
     handleChange,
     handleSelect,
+    // eslint-disable-next-line react-hooks/refs -- expose current trigger position to caller
+    triggerIndex: triggerIndexRef.current,
   };
 }
diff --git a/src/renderer/index.css b/src/renderer/index.css
index 80c0415f..9a9a9bf1 100644
--- a/src/renderer/index.css
+++ b/src/renderer/index.css
@@ -199,6 +199,11 @@
   --skeleton-base-dim: rgba(26, 28, 40, 0.6);
 }
 
+/* File icon glow — halo so dark icons stay visible on dark backgrounds */
+.file-icon-glow {
+  filter: drop-shadow(0 0 6px rgba(255, 255, 255, 0.45));
+}
+
 /* Light theme overrides - Warm neutral palette for eye comfort */
 :root.light {
   --color-surface: #f9f9f7; /* Warm off-white (not pure white) */
@@ -537,6 +542,15 @@ body {
   scrollbar-color: var(--scrollbar-thumb) transparent;
 }
 
+/* Thin scrollbar for narrow panels (sidebar, search) */
+.scrollbar-thin::-webkit-scrollbar {
+  width: 6px;
+}
+
+.scrollbar-thin::-webkit-scrollbar-thumb {
+  border-radius: 3px;
+}
+
 /* Dashboard skeleton shimmer animation */
 @keyframes shimmer {
   0% {
@@ -558,6 +572,36 @@ body {
   }
 }
 
+@keyframes message-enter {
+  from {
+    opacity: 0;
+    transform: translateY(-8px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+.message-enter-animate {
+  animation: message-enter 300ms ease-out both;
+}
+
+@keyframes chat-message-enter {
+  from {
+    opacity: 0;
+    transform: translateY(12px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+.chat-message-enter-animate {
+  animation: chat-message-enter 350ms ease-out both;
+}
+
 .skeleton-card {
   animation: skeleton-fade-in 0.4s ease-out both;
   position: relative;
@@ -580,6 +624,10 @@ body {
   animation: shimmer 1.2s ease-in-out infinite;
 }
 
+:root.light .file-icon-glow {
+  filter: none;
+}
+
 :root.light .skeleton-card::after {
   background: linear-gradient(
     90deg,
@@ -629,3 +677,28 @@ body {
 .label-optional {
   color: var(--color-text-muted);
 }
+
+/* Checkerboard background for transparent image previews */
+.checkerboard-bg {
+  background-image:
+    linear-gradient(45deg, #1a1a2e 25%, transparent 25%),
+    linear-gradient(-45deg, #1a1a2e 25%, transparent 25%),
+    linear-gradient(45deg, transparent 75%, #1a1a2e 75%),
+    linear-gradient(-45deg, transparent 75%, #1a1a2e 75%);
+  background-size: 16px 16px;
+  background-position:
+    0 0,
+    0 8px,
+    8px -8px,
+    -8px 0;
+  background-color: #12131a;
+}
+
+:root.light .checkerboard-bg {
+  background-image:
+    linear-gradient(45deg, #e2e8f0 25%, transparent 25%),
+    linear-gradient(-45deg, #e2e8f0 25%, transparent 25%),
+    linear-gradient(45deg, transparent 75%, #e2e8f0 75%),
+    linear-gradient(-45deg, transparent 75%, #e2e8f0 75%);
+  background-color: #ffffff;
+}
diff --git a/src/renderer/store/slices/changeReviewSlice.ts b/src/renderer/store/slices/changeReviewSlice.ts
index ac1262fb..c854f9e4 100644
--- a/src/renderer/store/slices/changeReviewSlice.ts
+++ b/src/renderer/store/slices/changeReviewSlice.ts
@@ -1,5 +1,7 @@
 import { api } from '@renderer/api';
+import { computeDiffContextHash } from '@shared/utils/diffContextHash';
 import { createLogger } from '@shared/utils/logger';
+import { structuredPatch } from 'diff';
 
 /** Tracks in-flight checkTaskHasChanges calls to avoid duplicate requests */
 const taskChangesCheckInFlight = new Set<string>();
@@ -63,6 +65,8 @@ export interface ChangeReviewSlice {
   fileChunkCounts: Record<string, number>;
   /** Undo stack for bulk review operations (Accept All / Reject All) */
   reviewUndoStack: DecisionSnapshot[];
+  /** filePath -> (hunkIndex -> contextHash), persisted for robust replay */
+  hunkContextHashesByFile: Record<string, Record<number, string>>;
   fileContents: Record<string, FileChangeWithContent>;
   fileContentsLoading: Record<string, boolean>;
   collapseUnchanged: boolean;
@@ -90,7 +94,13 @@ export interface ChangeReviewSlice {
   clearDecisionsFromDisk: (teamName: string, scopeKey: string) => Promise<void>;
 
   // Phase 2 actions
-  setHunkDecision: (filePath: string, hunkIndex: number, decision: HunkDecision) => void;
+  /**
+   * Set decision for a hunk at the current (visible) CM index.
+   * Returns the stable/original hunk index used as the decision key.
+   */
+  setHunkDecision: (filePath: string, hunkIndex: number, decision: HunkDecision) => number;
+  /** Clear a persisted decision using the stable/original hunk index */
+  clearHunkDecisionByOriginalIndex: (filePath: string, originalIndex: number) => void;
   setFileDecision: (filePath: string, decision: HunkDecision) => void;
   setFileChunkCount: (filePath: string, count: number) => void;
   pushReviewUndoSnapshot: () => void;
@@ -118,7 +128,7 @@ export interface ChangeReviewSlice {
   updateEditedContent: (filePath: string, content: string) => void;
   discardFileEdits: (filePath: string) => void;
   discardAllEdits: () => void;
-  saveEditedFile: (filePath: string) => Promise<void>;
+  saveEditedFile: (filePath: string, projectPath?: string) => Promise<void>;
 
   // Task change availability
   checkTaskHasChanges: (teamName: string, taskId: string) => Promise<void>;
@@ -164,6 +174,52 @@ export function getFileHunkCount(
   return fileChunkCounts[filePath] ?? snippetsLength;
 }
 
+function getMaxDecisionIndexForFile(
+  filePath: string,
+  hunkDecisions: Record<string, HunkDecision>
+): number {
+  let max = -1;
+  const prefix = `${filePath}:`;
+  for (const key of Object.keys(hunkDecisions)) {
+    if (!key.startsWith(prefix)) continue;
+    const raw = key.slice(prefix.length);
+    const idx = Number.parseInt(raw, 10);
+    if (!Number.isNaN(idx)) {
+      max = Math.max(max, idx);
+    }
+  }
+  return max;
+}
+
+function buildHunkContextHashesForFile(
+  original: string | null | undefined,
+  modified: string | null | undefined,
+  expectedHunkCount: number
+): Record<number, string> | undefined {
+  if (original === null || original === undefined) return undefined;
+  if (modified === null || modified === undefined) return undefined;
+
+  const patch = structuredPatch('file', 'file', original, modified);
+  const hunks = patch.hunks ?? [];
+  if (hunks.length === 0) return undefined;
+  if (hunks.length !== expectedHunkCount) return undefined;
+
+  const out: Record<number, string> = {};
+  for (let i = 0; i < hunks.length; i++) {
+    const hunk = hunks[i];
+    const oldSideContent = hunk.lines
+      .filter((l) => !l.startsWith('+'))
+      .map((l) => l.slice(1))
+      .join('\n');
+    const newSideContent = hunk.lines
+      .filter((l) => !l.startsWith('-'))
+      .map((l) => l.slice(1))
+      .join('\n');
+    out[i] = computeDiffContextHash(oldSideContent, newSideContent);
+  }
+  return out;
+}
+
 export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeReviewSlice> = (
   set,
   get
@@ -180,6 +236,7 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
   fileDecisions: {},
   fileChunkCounts: {},
   reviewUndoStack: [],
+  hunkContextHashesByFile: {},
   fileContents: {},
   fileContentsLoading: {},
   collapseUnchanged: true,
@@ -239,6 +296,7 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
       fileDecisions: {},
       fileChunkCounts: {},
       reviewUndoStack: [],
+      hunkContextHashesByFile: {},
       fileContents: {},
       fileContentsLoading: {},
       applyError: null,
@@ -255,6 +313,7 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
       selectedReviewFilePath: null,
       fileChunkCounts: {},
       reviewUndoStack: [],
+      hunkContextHashesByFile: {},
       fileContents: {},
       fileContentsLoading: {},
       applyError: null,
@@ -273,6 +332,7 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
       fileDecisions: {},
       fileChunkCounts: {},
       reviewUndoStack: [],
+      hunkContextHashesByFile: {},
       fileContents: {},
       fileContentsLoading: {},
       applyError: null,
@@ -291,6 +351,7 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
       set({
         hunkDecisions: data?.hunkDecisions ?? {},
         fileDecisions: data?.fileDecisions ?? {},
+        hunkContextHashesByFile: data?.hunkContextHashesByFile ?? {},
       });
     } catch (error) {
       logger.error('loadDecisionsFromDisk error:', error);
@@ -302,8 +363,40 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
       clearTimeout(persistDebounceTimer);
     }
     persistDebounceTimer = setTimeout(() => {
-      const { hunkDecisions, fileDecisions } = get();
-      void api.review.saveDecisions(teamName, scopeKey, hunkDecisions, fileDecisions);
+      const {
+        hunkDecisions,
+        fileDecisions,
+        hunkContextHashesByFile,
+        activeChangeSet,
+        fileContents,
+        fileChunkCounts,
+      } = get();
+
+      const computed: Record<string, Record<number, string>> = {};
+      for (const file of activeChangeSet?.files ?? []) {
+        const fp = file.filePath;
+        const content = fileContents[fp];
+        if (!content) continue;
+        const expected = getFileHunkCount(fp, file.snippets.length, fileChunkCounts);
+        const hashes = buildHunkContextHashesForFile(
+          content.originalFullContent,
+          content.modifiedFullContent,
+          expected
+        );
+        if (hashes) computed[fp] = hashes;
+      }
+
+      // Prune to only files in the current scope. This avoids persisting stale file paths
+      // (e.g. from older sessions) that could confuse future replays.
+      const mergedHashes: Record<string, Record<number, string>> = {};
+      for (const file of activeChangeSet?.files ?? []) {
+        const fp = file.filePath;
+        mergedHashes[fp] = computed[fp] ?? hunkContextHashesByFile[fp] ?? {};
+      }
+      // Keep store in sync so replay can use hashes without reload.
+      set({ hunkContextHashesByFile: mergedHashes });
+
+      void api.review.saveDecisions(teamName, scopeKey, hunkDecisions, fileDecisions, mergedHashes);
     }, PERSIST_DEBOUNCE_MS);
   },
 
@@ -342,6 +435,17 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
     set((s) => ({
       hunkDecisions: { ...s.hunkDecisions, [key]: decision },
     }));
+    return originalIndex;
+  },
+
+  clearHunkDecisionByOriginalIndex: (filePath: string, originalIndex: number) => {
+    const key = `${filePath}:${originalIndex}`;
+    set((s) => {
+      if (!(key in s.hunkDecisions)) return s;
+      const next = { ...s.hunkDecisions };
+      delete next[key];
+      return { hunkDecisions: next };
+    });
   },
 
   setFileDecision: (filePath: string, decision: HunkDecision) => {
@@ -540,7 +644,8 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
       }
 
       // Build FileReviewDecision[] from hunkDecisions/fileDecisions
-      const { hunkDecisions, fileDecisions, fileChunkCounts, activeChangeSet } = get();
+      const { hunkDecisions, fileDecisions, fileChunkCounts, activeChangeSet, fileContents } =
+        get();
       if (!activeChangeSet) {
         set({ applying: false });
         return;
@@ -552,7 +657,9 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
         const fileDecision = fileDecisions[file.filePath] ?? 'pending';
         const hunkDecs: Record<number, HunkDecision> = {};
 
-        const count = getFileHunkCount(file.filePath, file.snippets.length, fileChunkCounts);
+        const baseCount = getFileHunkCount(file.filePath, file.snippets.length, fileChunkCounts);
+        const maxIdx = getMaxDecisionIndexForFile(file.filePath, hunkDecisions);
+        const count = Math.max(baseCount, maxIdx + 1);
         for (let i = 0; i < count; i++) {
           const key = `${file.filePath}:${i}`;
           hunkDecs[i] = hunkDecisions[key] ?? 'pending';
@@ -562,10 +669,26 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
         const hasRejected =
           fileDecision === 'rejected' || Object.values(hunkDecs).some((d) => d === 'rejected');
         if (hasRejected) {
+          const content = fileContents[file.filePath];
+          const hunkContextHashes =
+            maxIdx < baseCount
+              ? buildHunkContextHashesForFile(
+                  content?.originalFullContent,
+                  content?.modifiedFullContent,
+                  baseCount
+                )
+              : undefined;
           decisions.push({
             filePath: file.filePath,
             fileDecision,
             hunkDecisions: hunkDecs,
+            hunkContextHashes,
+            // Provide optional context so main can apply without re-resolving.
+            // If full contents are missing (lazy not loaded yet), still pass snippets.
+            snippets: content?.snippets ?? file.snippets,
+            originalFullContent: content?.originalFullContent,
+            modifiedFullContent: content?.modifiedFullContent,
+            isNewFile: content?.isNewFile ?? file.isNewFile,
           });
         }
       }
@@ -600,7 +723,7 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
     taskId?: string,
     memberName?: string
   ) => {
-    const { hunkDecisions, fileDecisions, fileChunkCounts, activeChangeSet } = get();
+    const { hunkDecisions, fileDecisions, fileChunkCounts, activeChangeSet, fileContents } = get();
     if (!activeChangeSet) return;
 
     const file = activeChangeSet.files.find((f) => f.filePath === filePath);
@@ -608,7 +731,9 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
 
     const fileDecision = fileDecisions[filePath] ?? 'pending';
     const hunkDecs: Record<number, HunkDecision> = {};
-    const count = getFileHunkCount(filePath, file.snippets.length, fileChunkCounts);
+    const baseCount = getFileHunkCount(filePath, file.snippets.length, fileChunkCounts);
+    const maxIdx = getMaxDecisionIndexForFile(filePath, hunkDecisions);
+    const count = Math.max(baseCount, maxIdx + 1);
     for (let i = 0; i < count; i++) {
       hunkDecs[i] = hunkDecisions[`${filePath}:${i}`] ?? 'pending';
     }
@@ -618,11 +743,33 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
     if (!hasRejected) return;
 
     try {
+      const content = fileContents[filePath];
+      const innerBaseCount = getFileHunkCount(filePath, file.snippets.length, fileChunkCounts);
+      const innerMaxIdx = getMaxDecisionIndexForFile(filePath, hunkDecisions);
+      const hunkContextHashes =
+        innerMaxIdx < innerBaseCount
+          ? buildHunkContextHashesForFile(
+              content?.originalFullContent,
+              content?.modifiedFullContent,
+              innerBaseCount
+            )
+          : undefined;
       await api.review.applyDecisions({
         teamName,
         taskId,
         memberName,
-        decisions: [{ filePath, fileDecision, hunkDecisions: hunkDecs }],
+        decisions: [
+          {
+            filePath,
+            fileDecision,
+            hunkDecisions: hunkDecs,
+            hunkContextHashes,
+            snippets: content?.snippets ?? file.snippets,
+            originalFullContent: content?.originalFullContent,
+            modifiedFullContent: content?.modifiedFullContent,
+            isNewFile: content?.isNewFile ?? file.isNewFile,
+          },
+        ],
       });
     } catch (error) {
       logger.error('applySingleFileDecision error:', error);
@@ -648,12 +795,12 @@ export const createChangeReviewSlice: StateCreator<AppState, [], [], ChangeRevie
 
   discardAllEdits: () => set({ editedContents: {} }),
 
-  saveEditedFile: async (filePath: string) => {
+  saveEditedFile: async (filePath: string, projectPath?: string) => {
     const content = get().editedContents[filePath];
     if (!(filePath in get().editedContents)) return;
     set({ applying: true, applyError: null });
     try {
-      await api.review.saveEditedFile(filePath, content);
+      await api.review.saveEditedFile(filePath, content, projectPath);
       set((s) => {
         const nextEdited = { ...s.editedContents };
         delete nextEdited[filePath];
diff --git a/src/renderer/store/slices/editorSlice.ts b/src/renderer/store/slices/editorSlice.ts
index b5b8888d..40ea0a75 100644
--- a/src/renderer/store/slices/editorSlice.ts
+++ b/src/renderer/store/slices/editorSlice.ts
@@ -10,6 +10,7 @@
 import { api } from '@renderer/api';
 import { getLanguageFromFileName } from '@renderer/utils/codemirrorLanguages';
 import { editorBridge } from '@renderer/utils/editorBridge';
+import { invalidateQuickOpenCache } from '@renderer/utils/quickOpenCache';
 import { computeDisambiguatedTabs } from '@renderer/utils/tabLabelDisambiguation';
 import { createLogger } from '@shared/utils/logger';
 
@@ -24,8 +25,9 @@ import type { StateCreator } from 'zustand';
 
 const log = createLogger('Store:editor');
 
-/** Remove a key from a record without triggering unused-variable linting. */
+/** Remove a key from a record. Returns the same reference if key doesn't exist. */
 function omitKey<V>(record: Record<string, V>, key: string): Record<string, V> {
+  if (!(key in record)) return record;
   const result = { ...record };
   delete result[key];
   return result;
@@ -43,6 +45,84 @@ function omitKey<V>(record: Record<string, V>, key: string): Record<string, V> {
 const recentSaveTimestamps = new Map<string, number>();
 const SAVE_COOLDOWN_MS = 2000;
 
+/**
+ * Throttle timers for watcher-driven updates.
+ * Keeping these module-level avoids store re-renders during bursts.
+ */
+let gitStatusThrottleTimer: ReturnType<typeof setTimeout> | null = null;
+const GIT_STATUS_THROTTLE_MS = 1500;
+const dirRefreshDebounceTimers = new Map<string, ReturnType<typeof setTimeout>>();
+const DIR_REFRESH_DEBOUNCE_MS = 350;
+
+// Watcher event logging can be extremely expensive during bursts.
+// Keep a lightweight aggregate counter instead of logging per event.
+let watcherEventLogTimer: ReturnType<typeof setTimeout> | null = null;
+let watcherEventCounts: Record<EditorFileChangeEvent['type'], number> = {
+  change: 0,
+  create: 0,
+  delete: 0,
+};
+
+let watchedFilesSyncTimer: ReturnType<typeof setTimeout> | null = null;
+let lastWatchedFilesKey = '';
+let watchedDirsSyncTimer: ReturnType<typeof setTimeout> | null = null;
+let lastWatchedDirsKey = '';
+const WATCHED_DIRS_DEBOUNCE_MS = 250;
+const MAX_WATCHED_DIRS = 120;
+
+function scheduleSyncWatchedFiles(get: () => AppState): void {
+  // Editor watcher is Electron-only. In browser mode, api.editor exists but throws.
+  if (!window.electronAPI?.editor) return;
+  const state = get();
+  if (!state.editorWatcherEnabled) return;
+  const projectPath = state.editorProjectPath;
+  if (!projectPath) return;
+
+  const filePaths = state.editorOpenTabs.map((t) => t.filePath).filter(Boolean);
+  filePaths.sort((a, b) => a.localeCompare(b));
+  const key = `${projectPath}\n${filePaths.join('\n')}`;
+  if (key === lastWatchedFilesKey) return;
+  lastWatchedFilesKey = key;
+
+  if (watchedFilesSyncTimer) clearTimeout(watchedFilesSyncTimer);
+  watchedFilesSyncTimer = setTimeout(() => {
+    watchedFilesSyncTimer = null;
+    void window.electronAPI.editor.setWatchedFiles(filePaths);
+  }, 150);
+}
+
+function scheduleSyncWatchedDirs(get: () => AppState): void {
+  if (!window.electronAPI?.editor) return;
+  const state = get();
+  if (!state.editorWatcherEnabled) return;
+  const projectPath = state.editorProjectPath;
+  if (!projectPath) return;
+
+  const expanded = Object.entries(state.editorExpandedDirs)
+    .filter(([, v]) => v === true)
+    .map(([k]) => k);
+
+  // Always include root (depth=0), plus expanded folders (depth=0).
+  // Cap to protect chokidar from too many watched paths if user expands a lot.
+  const dirs = [projectPath, ...expanded].slice(0, MAX_WATCHED_DIRS);
+  dirs.sort((a, b) => a.localeCompare(b));
+  const key = `${projectPath}\n${dirs.join('\n')}`;
+  if (key === lastWatchedDirsKey) return;
+  lastWatchedDirsKey = key;
+
+  if (watchedDirsSyncTimer) clearTimeout(watchedDirsSyncTimer);
+  watchedDirsSyncTimer = setTimeout(() => {
+    watchedDirsSyncTimer = null;
+    void window.electronAPI.editor.setWatchedDirs(dirs);
+  }, WATCHED_DIRS_DEBOUNCE_MS);
+}
+
+/**
+ * Open request sequence for editor initialization.
+ * Cancels stale async work (notably React 18 StrictMode dev effect mount/unmount).
+ */
+let editorOpenSeq = 0;
+
 /**
  * Cooldown map: filePath → timestamp of last successful move.
  * Suppresses watcher events triggered by our own move operations.
@@ -50,6 +130,27 @@ const SAVE_COOLDOWN_MS = 2000;
 const recentMoveTimestamps = new Map<string, number>();
 const MOVE_COOLDOWN_MS = 2000;
 
+function scheduleIdleWork(cb: () => void): void {
+  // Prefer requestIdleCallback when available; fall back to a short timeout.
+  // This keeps editor open responsive for large repos.
+  // timeout ensures the callback fires within 2s even if the event loop is busy
+  // (without it, requestIdleCallback can be delayed indefinitely).
+  try {
+    const ric = (
+      window as unknown as {
+        requestIdleCallback?: (fn: () => void, opts?: { timeout: number }) => number;
+      }
+    ).requestIdleCallback;
+    if (typeof ric === 'function') {
+      ric(cb, { timeout: 2000 });
+      return;
+    }
+  } catch {
+    // ignore
+  }
+  setTimeout(cb, 150);
+}
+
 // =============================================================================
 // Slice Interface
 // =============================================================================
@@ -78,7 +179,12 @@ export interface EditorSlice {
 
   openFile: (filePath: string) => void;
   closeEditorTab: (tabId: string) => void;
+  closeOtherEditorTabs: (keepTabId: string) => void;
+  closeEditorTabsToLeft: (tabId: string) => void;
+  closeEditorTabsToRight: (tabId: string) => void;
+  closeAllEditorTabs: () => void;
   setActiveEditorTab: (tabId: string) => void;
+  reorderEditorTabs: (activeId: string, overId: string) => void;
 
   // ═══════════════════════════════════════════════════════
   // Group 3: Content + Save
@@ -107,6 +213,7 @@ export interface EditorSlice {
   createDirInTree: (parentDir: string, dirName: string) => Promise<string | null>;
   deleteFileFromTree: (filePath: string) => Promise<boolean>;
   moveFileInTree: (sourcePath: string, destDir: string) => Promise<boolean>;
+  renameFileInTree: (sourcePath: string, newName: string) => Promise<boolean>;
 
   // ═══════════════════════════════════════════════════════
   // Group 5: Git status + file watcher + line wrap (iter-5)
@@ -128,6 +235,14 @@ export interface EditorSlice {
   editorPendingGoToLine: number | null;
   setPendingGoToLine: (line: number | null) => void;
 
+  /** File path to reveal in editor (opens editor, expands dirs, opens tab, focuses in tree). */
+  editorPendingRevealFile: string | null;
+  /** Request to reveal a file in the editor. Opens editor overlay if needed. */
+  revealFileInEditor: (filePath: string) => void;
+  /** Process the pending reveal: expand parent dirs and open the file tab. */
+  revealAndOpenFile: (filePath: string) => Promise<void>;
+  clearPendingRevealFile: () => void;
+
   fetchGitStatus: () => Promise<void>;
   toggleWatcher: (enable: boolean) => Promise<void>;
   toggleLineWrap: () => void;
@@ -181,14 +296,64 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
   editorFileMtimes: {},
   editorConflictFile: null,
   editorPendingGoToLine: null,
+  editorPendingRevealFile: null,
 
   setPendingGoToLine: (line: number | null) => set({ editorPendingGoToLine: line }),
 
+  revealFileInEditor: (filePath: string) => {
+    set({ editorPendingRevealFile: filePath });
+  },
+
+  clearPendingRevealFile: () => {
+    set({ editorPendingRevealFile: null });
+  },
+
+  revealAndOpenFile: async (filePath: string) => {
+    const { editorProjectPath, editorFileTree, expandDirectory, openFile } = get();
+    if (!editorProjectPath) return;
+
+    // Guard: file tree must be loaded before we can reveal.
+    // If it's still null, bail out WITHOUT clearing pendingRevealFile
+    // so the caller effect can retry after the tree loads.
+    if (!editorFileTree) {
+      log.info('revealAndOpenFile: tree not loaded yet, deferring reveal');
+      return;
+    }
+
+    // Compute parent directories from projectRoot to the file.
+    // Normalize: strip trailing slash from project path to avoid double-slash.
+    const normalizedRoot = editorProjectPath.endsWith('/')
+      ? editorProjectPath.slice(0, -1)
+      : editorProjectPath;
+    const relative = filePath.startsWith(normalizedRoot + '/')
+      ? filePath.slice(normalizedRoot.length + 1)
+      : null;
+
+    if (relative) {
+      const segments = relative.split('/');
+      // Expand each parent directory sequentially (root → child → grandchild).
+      // Skip the last segment (the file name itself).
+      // Each expandDirectory call is awaited so that its children are merged
+      // into the tree before the next level is expanded.
+      let currentDir = normalizedRoot;
+      for (let i = 0; i < segments.length - 1; i++) {
+        currentDir = `${currentDir}/${segments[i]}`;
+        await expandDirectory(currentDir);
+      }
+    }
+
+    // Open the file as a tab
+    openFile(filePath);
+    // Clear reveal state
+    set({ editorPendingRevealFile: null });
+  },
+
   // ═══════════════════════════════════════════════════════
   // Group 1: File tree actions
   // ═══════════════════════════════════════════════════════
 
   openEditor: async (projectPath: string) => {
+    const openSeq = ++editorOpenSeq;
     set({
       editorProjectPath: projectPath,
       editorFileTree: null,
@@ -215,19 +380,60 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
     });
 
     try {
+      const tOpen = performance.now();
       await api.editor.open(projectPath);
+      const openMs = performance.now() - tOpen;
+
+      // Cancel stale opens (e.g. StrictMode effect cleanup, or rapid project switching)
+      if (editorOpenSeq !== openSeq || get().editorProjectPath !== projectPath) {
+        return;
+      }
+
+      // Load file tree first so UI becomes interactive quickly.
+      // Git status and file watching can be expensive on large projects, so they are NOT awaited here.
+      const tReadDir = performance.now();
       const result = await api.editor.readDir(projectPath);
+      const readDirMs = performance.now() - tReadDir;
+
+      if (editorOpenSeq !== openSeq || get().editorProjectPath !== projectPath) {
+        return;
+      }
+
+      const tSet = performance.now();
       set({
         editorFileTree: result.entries,
         editorFileTreeLoading: false,
       });
+      const setMs = performance.now() - tSet;
 
-      // Fetch git status in background (non-blocking)
-      void get().fetchGitStatus();
+      log.info(
+        `[perf] openEditor: open=${openMs.toFixed(1)}ms, readDir=${readDirMs.toFixed(1)}ms, set=${setMs.toFixed(1)}ms, entries=${result.entries.length}`
+      );
 
-      // Auto-enable file watcher (standard editor behavior)
-      void get().toggleWatcher(true);
+      // Enable watcher by default (like most editors), but defer startup until idle so open stays fast.
+      // Allow users to persistently disable it via localStorage toggle.
+      const watcherDesired = (() => {
+        try {
+          return localStorage.getItem('editor-watcher-enabled') !== 'false';
+        } catch {
+          return true;
+        }
+      })();
+
+      scheduleIdleWork(() => {
+        if (editorOpenSeq !== openSeq || get().editorProjectPath !== projectPath) return;
+        if (watcherDesired) void get().toggleWatcher(true);
+        // Defer initial git status a bit more — it can be expensive on large repos.
+        setTimeout(() => {
+          if (editorOpenSeq !== openSeq || get().editorProjectPath !== projectPath) return;
+          void get().fetchGitStatus();
+        }, 1200);
+      });
     } catch (error) {
+      // Ignore errors from stale opens (e.g. StrictMode cleanup during dev)
+      if (editorOpenSeq !== openSeq || get().editorProjectPath !== projectPath) {
+        return;
+      }
       const message = error instanceof Error ? error.message : String(error);
       log.error('Failed to open editor:', message);
       set({
@@ -238,6 +444,20 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
   },
 
   closeEditor: () => {
+    // Cancel any in-flight openEditor async work
+    editorOpenSeq++;
+    // Cancel any pending watcher sync (avoid calling into main after close)
+    if (watchedFilesSyncTimer) {
+      clearTimeout(watchedFilesSyncTimer);
+      watchedFilesSyncTimer = null;
+    }
+    if (watchedDirsSyncTimer) {
+      clearTimeout(watchedDirsSyncTimer);
+      watchedDirsSyncTimer = null;
+    }
+    lastWatchedFilesKey = '';
+    lastWatchedDirsKey = '';
+
     // Clear cooldown timestamps (no stale entries across editor sessions)
     recentSaveTimestamps.clear();
     recentMoveTimestamps.clear();
@@ -280,11 +500,18 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
     set({ editorFileTreeLoading: true, editorFileTreeError: null });
 
     try {
+      const t0 = performance.now();
       const result = await api.editor.readDir(dirPath);
+      const ipcMs = performance.now() - t0;
+      const t1 = performance.now();
       set({
         editorFileTree: result.entries,
         editorFileTreeLoading: false,
       });
+      const setMs = performance.now() - t1;
+      log.info(
+        `[perf] loadFileTree: IPC=${ipcMs.toFixed(1)}ms, set=${setMs.toFixed(1)}ms, entries=${result.entries.length}`
+      );
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       log.error('Failed to load file tree:', message);
@@ -296,17 +523,32 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
   },
 
   expandDirectory: async (dirPath: string) => {
-    const { editorExpandedDirs, editorFileTree } = get();
+    const { editorExpandedDirs } = get();
 
-    // Mark as expanded immediately for responsive UI
-    set({
-      editorExpandedDirs: { ...editorExpandedDirs, [dirPath]: true },
-    });
+    // Skip set() if already expanded — prevents unnecessary re-render
+    const wasExpanded = !!editorExpandedDirs[dirPath];
+    if (!wasExpanded) {
+      set({
+        editorExpandedDirs: { ...editorExpandedDirs, [dirPath]: true },
+      });
+      scheduleSyncWatchedDirs(get);
+    }
 
     try {
+      const t0 = performance.now();
       const result = await api.editor.readDir(dirPath);
-      const updatedTree = mergeChildrenIntoTree(editorFileTree ?? [], dirPath, result.entries);
+      const ipcMs = performance.now() - t0;
+      // Use fresh tree from store after await to avoid overwriting concurrent updates
+      const currentTree = get().editorFileTree;
+      const t1 = performance.now();
+      const updatedTree = mergeChildrenIntoTree(currentTree ?? [], dirPath, result.entries);
+      const mergeMs = performance.now() - t1;
+      const t2 = performance.now();
       set({ editorFileTree: updatedTree });
+      const setMs = performance.now() - t2;
+      log.info(
+        `[perf] expandDirectory: IPC=${ipcMs.toFixed(1)}ms, merge=${mergeMs.toFixed(1)}ms, set=${setMs.toFixed(1)}ms, entries=${result.entries.length}, wasExpanded=${wasExpanded}`
+      );
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       log.error('Failed to expand directory:', message);
@@ -318,6 +560,7 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
   collapseDirectory: (dirPath: string) => {
     const { editorExpandedDirs } = get();
     set({ editorExpandedDirs: omitKey(editorExpandedDirs, dirPath) });
+    scheduleSyncWatchedDirs(get);
   },
 
   // ═══════════════════════════════════════════════════════
@@ -350,6 +593,8 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
       editorOpenTabs: newTabs,
       editorActiveTabId: tab.id,
     });
+
+    scheduleSyncWatchedFiles(get);
   },
 
   closeEditorTab: (tabId: string) => {
@@ -390,12 +635,54 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
       editorModifiedFiles: restModified,
       editorSaveError: restErrors,
     });
+
+    scheduleSyncWatchedFiles(get);
+  },
+
+  closeOtherEditorTabs: (keepTabId: string) => {
+    const { editorOpenTabs } = get();
+    const toClose = editorOpenTabs.filter((t) => t.id !== keepTabId);
+    for (const tab of toClose) get().closeEditorTab(tab.id);
+  },
+
+  closeEditorTabsToLeft: (tabId: string) => {
+    const { editorOpenTabs } = get();
+    const idx = editorOpenTabs.findIndex((t) => t.id === tabId);
+    if (idx <= 0) return;
+    const toClose = editorOpenTabs.slice(0, idx);
+    for (const tab of toClose) get().closeEditorTab(tab.id);
+  },
+
+  closeEditorTabsToRight: (tabId: string) => {
+    const { editorOpenTabs } = get();
+    const idx = editorOpenTabs.findIndex((t) => t.id === tabId);
+    if (idx < 0 || idx >= editorOpenTabs.length - 1) return;
+    const toClose = editorOpenTabs.slice(idx + 1);
+    for (const tab of toClose) get().closeEditorTab(tab.id);
+  },
+
+  closeAllEditorTabs: () => {
+    const { editorOpenTabs } = get();
+    for (const tab of [...editorOpenTabs]) get().closeEditorTab(tab.id);
   },
 
   setActiveEditorTab: (tabId: string) => {
     set({ editorActiveTabId: tabId });
   },
 
+  reorderEditorTabs: (activeId: string, overId: string) => {
+    if (activeId === overId) return;
+    const { editorOpenTabs } = get();
+    const oldIndex = editorOpenTabs.findIndex((t) => t.id === activeId);
+    const newIndex = editorOpenTabs.findIndex((t) => t.id === overId);
+    if (oldIndex === -1 || newIndex === -1) return;
+
+    const updated = [...editorOpenTabs];
+    const [moved] = updated.splice(oldIndex, 1);
+    updated.splice(newIndex, 0, moved);
+    set({ editorOpenTabs: updated });
+  },
+
   // ═══════════════════════════════════════════════════════
   // Group 3: Content + Save
   // ═══════════════════════════════════════════════════════
@@ -654,6 +941,9 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
         };
       });
 
+      // Keep open-files-only watcher in sync with remapped tab paths
+      scheduleSyncWatchedFiles(get);
+
       // Remap bridge state for each affected tab
       const { editorOpenTabs } = get();
       for (const tab of editorOpenTabs) {
@@ -708,6 +998,102 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
     }
   },
 
+  renameFileInTree: async (sourcePath: string, newName: string) => {
+    const { editorSaving } = get();
+
+    if (editorSaving[sourcePath]) {
+      log.error('renameFileInTree: blocked — file is being saved:', sourcePath);
+      return false;
+    }
+
+    try {
+      const result = await api.editor.renameFile(sourcePath, newName);
+      const { newPath, isDirectory } = result;
+      const parentDir = sourcePath.substring(0, sourcePath.lastIndexOf('/'));
+
+      recentMoveTimestamps.set(sourcePath, Date.now());
+      recentMoveTimestamps.set(newPath, Date.now());
+
+      set((s) => {
+        const tabs = s.editorOpenTabs.map((tab) => {
+          const remapped = remapPath(tab.filePath, sourcePath, newPath);
+          if (remapped === tab.filePath) return tab;
+          const fileName = remapped.split('/').pop() ?? 'file';
+          return {
+            ...tab,
+            id: remapped,
+            filePath: remapped,
+            fileName,
+            language: getLanguageFromFileName(fileName),
+          };
+        });
+
+        return {
+          editorOpenTabs: computeDisambiguatedTabs(tabs),
+          editorActiveTabId:
+            remapPath(s.editorActiveTabId ?? '', sourcePath, newPath) || s.editorActiveTabId,
+          editorModifiedFiles: remapRecord(s.editorModifiedFiles, sourcePath, newPath),
+          editorSaving: remapRecord(s.editorSaving, sourcePath, newPath),
+          editorSaveError: remapRecord(s.editorSaveError, sourcePath, newPath),
+          editorFileLoading: remapRecord(s.editorFileLoading, sourcePath, newPath),
+          editorExternalChanges: remapRecord(s.editorExternalChanges, sourcePath, newPath),
+          editorFileMtimes: remapRecord(s.editorFileMtimes, sourcePath, newPath),
+          editorExpandedDirs: remapRecord(s.editorExpandedDirs, sourcePath, newPath),
+        };
+      });
+
+      // Keep open-files-only watcher in sync with remapped tab paths
+      scheduleSyncWatchedFiles(get);
+
+      // Remap bridge state
+      const { editorOpenTabs } = get();
+      for (const tab of editorOpenTabs) {
+        const originalPath = reverseRemapPath(tab.filePath, sourcePath, newPath);
+        if (originalPath !== tab.filePath) {
+          editorBridge.remapState(originalPath, tab.filePath);
+        }
+      }
+      if (!isDirectory) {
+        editorBridge.remapState(sourcePath, newPath);
+      }
+
+      // Remap localStorage drafts
+      try {
+        for (let i = 0; i < localStorage.length; i++) {
+          const key = localStorage.key(i);
+          if (key?.startsWith('editor-draft:')) {
+            const draftPath = key.slice('editor-draft:'.length);
+            const remapped = remapPath(draftPath, sourcePath, newPath);
+            if (remapped !== draftPath) {
+              const value = localStorage.getItem(key);
+              localStorage.removeItem(key);
+              if (value !== null) localStorage.setItem(`editor-draft:${remapped}`, value);
+            }
+          }
+        }
+      } catch {
+        // localStorage may not be available
+      }
+
+      for (const [key, ts] of [...recentSaveTimestamps.entries()]) {
+        const remapped = remapPath(key, sourcePath, newPath);
+        if (remapped !== key) {
+          recentSaveTimestamps.delete(key);
+          recentSaveTimestamps.set(remapped, ts);
+        }
+      }
+
+      void refreshDirectory(get, set, parentDir);
+      void get().fetchGitStatus();
+
+      return true;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      log.error('renameFileInTree failed:', message);
+      return false;
+    }
+  },
+
   // ═══════════════════════════════════════════════════════
   // Group 5: Git status + file watcher + line wrap
   // ═══════════════════════════════════════════════════════
@@ -715,13 +1101,20 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
   fetchGitStatus: async () => {
     set({ editorGitLoading: true });
     try {
+      const t0 = performance.now();
       const result = await api.editor.gitStatus();
+      const ipcMs = performance.now() - t0;
+      const t1 = performance.now();
       set({
         editorGitFiles: result.files,
         editorGitBranch: result.branch,
         editorIsGitRepo: result.isGitRepo,
         editorGitLoading: false,
       });
+      const setMs = performance.now() - t1;
+      log.info(
+        `[perf] fetchGitStatus: IPC=${ipcMs.toFixed(1)}ms, set=${setMs.toFixed(1)}ms, files=${result.files.length}`
+      );
     } catch (error) {
       log.error('Failed to fetch git status:', error);
       set({ editorGitLoading: false });
@@ -732,6 +1125,21 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
     try {
       await api.editor.watchDir(enable);
       set({ editorWatcherEnabled: enable });
+      try {
+        localStorage.setItem('editor-watcher-enabled', String(enable));
+      } catch {
+        // localStorage may not be available
+      }
+      if (enable) {
+        scheduleSyncWatchedFiles(get);
+        scheduleSyncWatchedDirs(get);
+      } else {
+        // Ensure main process stops watching files promptly.
+        lastWatchedFilesKey = '';
+        lastWatchedDirsKey = '';
+        void api.editor.setWatchedFiles([]);
+        void api.editor.setWatchedDirs([]);
+      }
     } catch (error) {
       log.error('Failed to toggle watcher:', error);
     }
@@ -750,6 +1158,19 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
   },
 
   handleExternalFileChange: (event: EditorFileChangeEvent) => {
+    // Avoid per-event logging (can freeze renderer during bursts on large repos).
+    watcherEventCounts[event.type] = (watcherEventCounts[event.type] ?? 0) + 1;
+    if (!watcherEventLogTimer) {
+      watcherEventLogTimer = setTimeout(() => {
+        watcherEventLogTimer = null;
+        const counts = watcherEventCounts;
+        watcherEventCounts = { change: 0, create: 0, delete: 0 };
+        // Keep a single lightweight summary line.
+        log.info(
+          `[perf] editor watcher events (2s): change=${counts.change}, create=${counts.create}, delete=${counts.delete}`
+        );
+      }, 2000);
+    }
     const { editorOpenTabs, editorProjectPath, editorSaving } = get();
 
     // Ignore watcher events for files we are currently saving (our own write)
@@ -775,14 +1196,27 @@ export const createEditorSlice: StateCreator<AppState, [], [], EditorSlice> = (s
       }));
     }
 
-    // Refresh git status on any change
-    void get().fetchGitStatus();
+    // Refresh git status on change — throttled to avoid expensive work during bursts.
+    // Main process already caches git status for 5s, but IPC + store updates still cost.
+    if (!gitStatusThrottleTimer) {
+      gitStatusThrottleTimer = setTimeout(() => {
+        gitStatusThrottleTimer = null;
+        void get().fetchGitStatus();
+      }, GIT_STATUS_THROTTLE_MS);
+    }
 
     // Refresh parent directory in tree for create/delete
     if (event.type === 'create' || event.type === 'delete') {
+      invalidateQuickOpenCache();
       const parentDir = event.path.substring(0, event.path.lastIndexOf('/'));
       if (parentDir && editorProjectPath) {
-        void refreshDirectory(get, set, parentDir);
+        const existing = dirRefreshDebounceTimers.get(parentDir);
+        if (existing) clearTimeout(existing);
+        const timer = setTimeout(() => {
+          dirRefreshDebounceTimers.delete(parentDir);
+          void refreshDirectory(get, set, parentDir);
+        }, DIR_REFRESH_DEBOUNCE_MS);
+        dirRefreshDebounceTimers.set(parentDir, timer);
       }
     }
   },
@@ -858,9 +1292,32 @@ async function refreshDirectory(
   dirPath: string
 ): Promise<void> {
   try {
+    const t0 = performance.now();
     const result = await api.editor.readDir(dirPath);
+    log.info(
+      `[perf] refreshDirectory: IPC=${(performance.now() - t0).toFixed(1)}ms, entries=${result.entries.length}, dir=${dirPath.split('/').pop() ?? ''}`
+    );
     const currentTree = get().editorFileTree;
-    if (currentTree) {
+    if (!currentTree) return;
+
+    const projectPath = get().editorProjectPath;
+    if (dirPath === projectPath) {
+      // Root refresh — tree IS the root's children, so preserve expanded subtrees
+      // by merging new entries with existing children data
+      const existingByPath = new Map<string, FileTreeEntry>();
+      for (const entry of currentTree) {
+        existingByPath.set(entry.path, entry);
+      }
+      const merged = result.entries.map((entry) => {
+        const existing = existingByPath.get(entry.path);
+        // Preserve expanded subtree children for directories that still exist
+        if (existing?.children && entry.type === 'directory') {
+          return { ...entry, children: existing.children };
+        }
+        return entry;
+      });
+      set({ editorFileTree: merged });
+    } else {
       const updatedTree = mergeChildrenIntoTree(currentTree, dirPath, result.entries);
       set({ editorFileTree: updatedTree });
     }
@@ -913,22 +1370,27 @@ function remapRecord<V>(
 
 /**
  * Recursively merge children into the tree at the matching directory path.
+ * Returns the same array reference if nothing changed — preserves React.memo equality.
  */
 function mergeChildrenIntoTree(
   tree: FileTreeEntry[],
   targetPath: string,
   children: FileTreeEntry[]
 ): FileTreeEntry[] {
-  return tree.map((entry) => {
+  let changed = false;
+  const result = tree.map((entry) => {
     if (entry.path === targetPath && entry.type === 'directory') {
+      changed = true;
       return { ...entry, children };
     }
     if (entry.children) {
-      return {
-        ...entry,
-        children: mergeChildrenIntoTree(entry.children, targetPath, children),
-      };
+      const updated = mergeChildrenIntoTree(entry.children, targetPath, children);
+      if (updated !== entry.children) {
+        changed = true;
+        return { ...entry, children: updated };
+      }
     }
     return entry;
   });
+  return changed ? result : tree;
 }
diff --git a/src/renderer/store/slices/teamSlice.ts b/src/renderer/store/slices/teamSlice.ts
index 1b2a2646..8805a40f 100644
--- a/src/renderer/store/slices/teamSlice.ts
+++ b/src/renderer/store/slices/teamSlice.ts
@@ -50,14 +50,20 @@ const notifiedClarificationTaskKeys = new Set<string>();
 
 let isFirstFetchAllTasks = true;
 
-function detectClarificationNotifications(oldTasks: GlobalTask[], newTasks: GlobalTask[]): void {
+function detectClarificationNotifications(
+  oldTasks: GlobalTask[],
+  newTasks: GlobalTask[],
+  notifyEnabled: boolean
+): void {
   for (const task of newTasks) {
     const key = `${task.teamName}:${task.id}`;
     if (task.needsClarification === 'user') {
       const oldTask = oldTasks.find((t) => t.teamName === task.teamName && t.id === task.id);
       if (oldTask?.needsClarification !== 'user' && !notifiedClarificationTaskKeys.has(key)) {
         notifiedClarificationTaskKeys.add(key);
-        fireClarificationNotification(task);
+        if (notifyEnabled) {
+          fireClarificationNotification(task);
+        }
       }
     } else {
       notifiedClarificationTaskKeys.delete(key);
@@ -169,6 +175,18 @@ export interface TeamSlice {
     memberName: string,
     role: string | undefined
   ) => Promise<void>;
+  addTaskRelationship: (
+    teamName: string,
+    taskId: string,
+    targetId: string,
+    type: 'blockedBy' | 'blocks' | 'related'
+  ) => Promise<void>;
+  removeTaskRelationship: (
+    teamName: string,
+    taskId: string,
+    targetId: string,
+    type: 'blockedBy' | 'blocks' | 'related'
+  ) => Promise<void>;
   setTaskNeedsClarification: (
     teamName: string,
     taskId: string,
@@ -283,7 +301,9 @@ export const createTeamSlice: StateCreator<AppState, [], [], TeamSlice> = (set,
       const tasks = await unwrapIpc('team:getAllTasks', () => api.teams.getAllTasks());
 
       if (!wasFirst) {
-        detectClarificationNotifications(oldTasks, tasks);
+        const notifyOnClarifications =
+          get().appConfig?.notifications?.notifyOnClarifications ?? true;
+        detectClarificationNotifications(oldTasks, tasks, notifyOnClarifications);
       } else {
         // Initial load — seed the Set to prevent false notifications on next update
         for (const task of tasks) {
@@ -604,6 +624,20 @@ export const createTeamSlice: StateCreator<AppState, [], [], TeamSlice> = (set,
     await get().refreshTeamData(teamName);
   },
 
+  addTaskRelationship: async (teamName, taskId, targetId, type) => {
+    await unwrapIpc('team:addTaskRelationship', () =>
+      api.teams.addTaskRelationship(teamName, taskId, targetId, type)
+    );
+    await get().refreshTeamData(teamName);
+  },
+
+  removeTaskRelationship: async (teamName, taskId, targetId, type) => {
+    await unwrapIpc('team:removeTaskRelationship', () =>
+      api.teams.removeTaskRelationship(teamName, taskId, targetId, type)
+    );
+    await get().refreshTeamData(teamName);
+  },
+
   setTaskNeedsClarification: async (teamName, taskId, value) => {
     await unwrapIpc('team:setTaskClarification', () =>
       api.teams.setTaskClarification(teamName, taskId, value)
diff --git a/src/renderer/types/inlineChip.ts b/src/renderer/types/inlineChip.ts
new file mode 100644
index 00000000..74d15c7b
--- /dev/null
+++ b/src/renderer/types/inlineChip.ts
@@ -0,0 +1,95 @@
+/**
+ * Inline Code Chip types and pure functions.
+ *
+ * A chip is a visual badge representing a code selection from the editor,
+ * displayed inline in textareas alongside @mentions.
+ */
+
+import { getCodeFenceLanguage } from '@renderer/utils/buildSelectionAction';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export interface InlineChip {
+  id: string;
+  /** Absolute file path */
+  filePath: string;
+  /** Basename (e.g. "auth.ts") */
+  fileName: string;
+  /** 1-based start line, or null for file-level mentions */
+  fromLine: number | null;
+  /** 1-based end line, or null for file-level mentions */
+  toLine: number | null;
+  /** Selected source code text (empty for file mentions) */
+  codeText: string;
+  /** Language identifier (e.g. "typescript", "python") */
+  language: string;
+  /** Relative display path for file-level mentions */
+  displayPath?: string;
+}
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+/** Unicode marker character used as chip prefix in textarea text */
+export const CHIP_MARKER = '\u{1F4C4}'; // 📄
+
+// =============================================================================
+// Pure functions
+// =============================================================================
+
+/**
+ * Display label for a chip: "auth.ts:10-15", "auth.ts:42" for single-line,
+ * or just "auth.ts" for file-level mentions.
+ */
+export function chipDisplayLabel(chip: InlineChip): string {
+  if (chip.fromLine == null || chip.toLine == null) {
+    return chip.fileName;
+  }
+  if (chip.fromLine === chip.toLine) {
+    return `${chip.fileName}:${chip.fromLine}`;
+  }
+  return `${chip.fileName}:${chip.fromLine}-${chip.toLine}`;
+}
+
+/**
+ * Token string inserted into textarea text.
+ * Must match EXACTLY in textarea and overlay for pixel-perfect alignment.
+ */
+export function chipToken(chip: InlineChip): string {
+  return `${CHIP_MARKER}${chipDisplayLabel(chip)}`;
+}
+
+/**
+ * Converts a chip to markdown: code fence for code chips, file reference for file mentions.
+ */
+export function chipToMarkdown(chip: InlineChip): string {
+  // File-level mention — no code fence
+  if (chip.fromLine == null || chip.toLine == null) {
+    const path = chip.displayPath ?? chip.filePath;
+    return `**${chip.fileName}** (\`${path}\`)`;
+  }
+  const lang = chip.language || getCodeFenceLanguage(chip.fileName);
+  const lineRef =
+    chip.fromLine === chip.toLine
+      ? `line ${chip.fromLine}`
+      : `lines ${chip.fromLine}-${chip.toLine}`;
+  return `**${chip.fileName}** (${lineRef}):\n\`\`\`${lang}\n${chip.codeText}\n\`\`\``;
+}
+
+/**
+ * Serializes text with chip tokens back to markdown code fences for sending.
+ * Replaces each chip token in the text with its markdown representation.
+ */
+export function serializeChipsWithText(text: string, chips: InlineChip[]): string {
+  if (chips.length === 0) return text;
+
+  let result = text;
+  for (const chip of chips) {
+    const token = chipToken(chip);
+    result = result.split(token).join(chipToMarkdown(chip));
+  }
+  return result;
+}
diff --git a/src/renderer/types/mention.ts b/src/renderer/types/mention.ts
index bc1599cb..27ee8f82 100644
--- a/src/renderer/types/mention.ts
+++ b/src/renderer/types/mention.ts
@@ -7,4 +7,10 @@ export interface MentionSuggestion {
   subtitle?: string;
   /** Color name from TeamColorSet palette */
   color?: string;
+  /** Suggestion type — 'member' (default) or 'file' */
+  type?: 'member' | 'file';
+  /** Absolute file path (file suggestions only) */
+  filePath?: string;
+  /** Relative display path (file suggestions only) */
+  relativePath?: string;
 }
diff --git a/src/renderer/utils/buildSelectionAction.ts b/src/renderer/utils/buildSelectionAction.ts
index fc4adedc..b2833527 100644
--- a/src/renderer/utils/buildSelectionAction.ts
+++ b/src/renderer/utils/buildSelectionAction.ts
@@ -57,6 +57,31 @@ export function getCodeFenceLanguage(fileName: string): string {
   return CODE_FENCE_LANG[ext] ?? '';
 }
 
+/**
+ * Builds a file-mention action (no code selection, just the file reference).
+ * Used when triggering "Create Task" / "Write Teammate" from the file tree context menu.
+ */
+export function buildFileAction(
+  type: EditorSelectionAction['type'],
+  filePath: string,
+  projectPath?: string | null
+): EditorSelectionAction {
+  const fileName = filePath.split('/').pop() ?? 'file';
+  const displayPath =
+    projectPath && filePath.startsWith(projectPath + '/')
+      ? filePath.slice(projectPath.length + 1)
+      : filePath;
+  return {
+    type,
+    filePath,
+    fromLine: null,
+    toLine: null,
+    selectedText: '',
+    formattedContext: `**${fileName}** (\`${displayPath}\`)`,
+    displayPath,
+  };
+}
+
 /** Builds a selection action with a formatted markdown code fence context. */
 export function buildSelectionAction(
   type: EditorSelectionAction['type'],
diff --git a/src/renderer/utils/chipUtils.ts b/src/renderer/utils/chipUtils.ts
new file mode 100644
index 00000000..e4012c46
--- /dev/null
+++ b/src/renderer/utils/chipUtils.ts
@@ -0,0 +1,267 @@
+/**
+ * Utility functions for working with inline code chip tokens in text.
+ */
+
+import { chipToken } from '@renderer/types/inlineChip';
+import { getCodeFenceLanguage } from '@renderer/utils/buildSelectionAction';
+
+import type { InlineChip } from '@renderer/types/inlineChip';
+import type { EditorSelectionAction } from '@shared/types/editor';
+
+// =============================================================================
+// Chip creation
+// =============================================================================
+
+let chipCounter = 0;
+
+/**
+ * Creates an InlineChip from an EditorSelectionAction.
+ * Returns null if a chip with the same filePath + line range already exists.
+ */
+export function createChipFromSelection(
+  action: EditorSelectionAction,
+  existingChips: InlineChip[]
+): InlineChip | null {
+  const isFileMention = !action.selectedText || action.fromLine == null || action.toLine == null;
+
+  if (isFileMention) {
+    // File-level mention: deduplicate by filePath + null lines
+    const isDuplicate = existingChips.some(
+      (c) => c.filePath === action.filePath && c.fromLine == null
+    );
+    if (isDuplicate) return null;
+
+    const fileName = action.filePath.split('/').pop() ?? 'file';
+    return {
+      id: `chip-${++chipCounter}-${Date.now()}`,
+      filePath: action.filePath,
+      fileName,
+      fromLine: null,
+      toLine: null,
+      codeText: '',
+      language: getCodeFenceLanguage(fileName),
+      displayPath: action.displayPath,
+    };
+  }
+
+  // Code selection chip
+  const isDuplicate = existingChips.some(
+    (c) =>
+      c.filePath === action.filePath && c.fromLine === action.fromLine && c.toLine === action.toLine
+  );
+  if (isDuplicate) return null;
+
+  const fileName = action.filePath.split('/').pop() ?? 'file';
+  const language = getCodeFenceLanguage(fileName);
+
+  return {
+    id: `chip-${++chipCounter}-${Date.now()}`,
+    filePath: action.filePath,
+    fileName,
+    fromLine: action.fromLine,
+    toLine: action.toLine,
+    codeText: action.selectedText,
+    language,
+  };
+}
+
+// =============================================================================
+// Chip boundary detection
+// =============================================================================
+
+export interface ChipBoundary {
+  start: number;
+  end: number;
+  chip: InlineChip;
+}
+
+/**
+ * Finds the chip token boundary that contains or is adjacent to the cursor position.
+ * Returns null if cursor is not at/inside any chip token.
+ */
+export function findChipBoundary(
+  text: string,
+  chips: InlineChip[],
+  cursorPos: number
+): ChipBoundary | null {
+  for (const chip of chips) {
+    const token = chipToken(chip);
+    let searchFrom = 0;
+    while (searchFrom < text.length) {
+      const idx = text.indexOf(token, searchFrom);
+      if (idx === -1) break;
+      const end = idx + token.length;
+      if (cursorPos >= idx && cursorPos <= end) {
+        return { start: idx, end, chip };
+      }
+      searchFrom = idx + 1;
+    }
+  }
+  return null;
+}
+
+/**
+ * Returns true if cursor is strictly inside a chip token (not at boundaries).
+ */
+export function isInsideChip(text: string, chips: InlineChip[], cursorPos: number): boolean {
+  const boundary = findChipBoundary(text, chips, cursorPos);
+  if (!boundary) return false;
+  return cursorPos > boundary.start && cursorPos < boundary.end;
+}
+
+/**
+ * Snaps cursor to the nearest chip boundary (start or end) if inside a chip.
+ * Returns the original position if not inside any chip.
+ */
+export function snapCursorToChipBoundary(
+  text: string,
+  chips: InlineChip[],
+  cursorPos: number
+): number {
+  const boundary = findChipBoundary(text, chips, cursorPos);
+  if (!boundary) return cursorPos;
+  if (cursorPos <= boundary.start || cursorPos >= boundary.end) return cursorPos;
+
+  const distToStart = cursorPos - boundary.start;
+  const distToEnd = boundary.end - cursorPos;
+  return distToStart <= distToEnd ? boundary.start : boundary.end;
+}
+
+// =============================================================================
+// Reconciliation
+// =============================================================================
+
+/**
+ * Returns only those chips whose tokens are still present in the text.
+ * Used to keep chip state in sync after paste/cut/undo operations.
+ */
+export function reconcileChips(oldChips: InlineChip[], newText: string): InlineChip[] {
+  return oldChips.filter((chip) => newText.includes(chipToken(chip)));
+}
+
+/**
+ * Removes a chip token from text, including a trailing newline if present.
+ * This prevents orphan blank lines after chip removal.
+ */
+export function removeChipTokenFromText(text: string, chip: InlineChip): string {
+  const token = chipToken(chip);
+  const idx = text.indexOf(token);
+  if (idx === -1) return text;
+
+  const end = idx + token.length;
+  // Remove trailing newline if present
+  const removeEnd = end < text.length && text[end] === '\n' ? end + 1 : end;
+  return text.slice(0, idx) + text.slice(removeEnd);
+}
+
+// =============================================================================
+// Chip position calculation (mirror div technique)
+// =============================================================================
+
+export interface ChipPosition {
+  chip: InlineChip;
+  top: number;
+  left: number;
+  width: number;
+  height: number;
+}
+
+/**
+ * Calculates screen positions of chip tokens in textarea using the mirror div technique.
+ * Creates a temporary mirror div that replicates textarea layout and measures chip spans.
+ */
+export function calculateChipPositions(
+  textarea: HTMLTextAreaElement,
+  text: string,
+  chips: InlineChip[]
+): ChipPosition[] {
+  if (chips.length === 0) return [];
+
+  const cs = window.getComputedStyle(textarea);
+  const mirror = document.createElement('div');
+
+  // Copy all relevant styles to mirror div
+  mirror.style.font = cs.font;
+  mirror.style.letterSpacing = cs.letterSpacing;
+  mirror.style.wordSpacing = cs.wordSpacing;
+  mirror.style.textIndent = cs.textIndent;
+  mirror.style.textTransform = cs.textTransform;
+  mirror.style.tabSize = cs.tabSize;
+  mirror.style.whiteSpace = cs.whiteSpace;
+  mirror.style.overflowWrap = cs.overflowWrap;
+  mirror.style.paddingTop = cs.paddingTop;
+  mirror.style.paddingRight = cs.paddingRight;
+  mirror.style.paddingBottom = cs.paddingBottom;
+  mirror.style.paddingLeft = cs.paddingLeft;
+  mirror.style.borderTopWidth = cs.borderTopWidth;
+  mirror.style.borderRightWidth = cs.borderRightWidth;
+  mirror.style.borderBottomWidth = cs.borderBottomWidth;
+  mirror.style.borderLeftWidth = cs.borderLeftWidth;
+  mirror.style.boxSizing = cs.boxSizing;
+  mirror.style.width = cs.width;
+  mirror.style.lineHeight = cs.lineHeight;
+
+  mirror.style.position = 'absolute';
+  mirror.style.top = '-9999px';
+  mirror.style.left = '-9999px';
+  mirror.style.visibility = 'hidden';
+  mirror.style.overflow = 'hidden';
+  mirror.style.height = 'auto';
+
+  // Build content with chip tokens wrapped in spans
+  const chipSpans = new Map<string, HTMLSpanElement>();
+  const tokenPositions: { chip: InlineChip; token: string; index: number }[] = [];
+
+  // Find all chip token positions in text
+  for (const chip of chips) {
+    const token = chipToken(chip);
+    const idx = text.indexOf(token);
+    if (idx !== -1) {
+      tokenPositions.push({ chip, token, index: idx });
+    }
+  }
+
+  // Sort by position in text
+  tokenPositions.sort((a, b) => a.index - b.index);
+
+  // Build mirror content
+  let lastEnd = 0;
+  for (const { chip, token, index } of tokenPositions) {
+    // Text before this chip
+    if (index > lastEnd) {
+      const textNode = document.createTextNode(text.slice(lastEnd, index));
+      mirror.appendChild(textNode);
+    }
+
+    // Chip span
+    const span = document.createElement('span');
+    span.textContent = token;
+    mirror.appendChild(span);
+    chipSpans.set(chip.id, span);
+
+    lastEnd = index + token.length;
+  }
+
+  // Text after last chip
+  if (lastEnd < text.length) {
+    mirror.appendChild(document.createTextNode(text.slice(lastEnd)));
+  }
+
+  document.body.appendChild(mirror);
+
+  const positions: ChipPosition[] = [];
+  for (const { chip } of tokenPositions) {
+    const span = chipSpans.get(chip.id);
+    if (!span) continue;
+    positions.push({
+      chip,
+      top: span.offsetTop,
+      left: span.offsetLeft,
+      width: span.offsetWidth,
+      height: span.offsetHeight,
+    });
+  }
+
+  document.body.removeChild(mirror);
+  return positions;
+}
diff --git a/src/renderer/utils/codemirrorSelectionInfo.ts b/src/renderer/utils/codemirrorSelectionInfo.ts
new file mode 100644
index 00000000..49720e28
--- /dev/null
+++ b/src/renderer/utils/codemirrorSelectionInfo.ts
@@ -0,0 +1,41 @@
+/**
+ * Shared utility for building EditorSelectionInfo from a CodeMirror EditorView.
+ *
+ * Used by both CodeMirrorEditor (project editor) and CodeMirrorDiffView (review dialog)
+ * to extract selection details for the floating action menu.
+ */
+
+import type { EditorView } from '@codemirror/view';
+import type { EditorSelectionInfo } from '@shared/types/editor';
+
+export const SELECTION_DEBOUNCE_MS = 150;
+export const MAX_SELECTION_TEXT = 5000;
+
+/**
+ * Build selection info from a CM6 EditorView and selection range.
+ * Returns null if selection end is off-screen (coordsAtPos returns null).
+ */
+export function buildSelectionInfo(
+  view: EditorView,
+  sel: { from: number; to: number }
+): EditorSelectionInfo | null {
+  const coords = view.coordsAtPos(sel.to);
+  if (!coords) return null;
+
+  let text = view.state.sliceDoc(sel.from, sel.to);
+  if (text.length > MAX_SELECTION_TEXT) {
+    text = text.slice(0, MAX_SELECTION_TEXT) + '\u2026';
+  }
+
+  return {
+    text,
+    filePath: '', // filled by caller
+    fromLine: view.state.doc.lineAt(sel.from).number,
+    toLine: view.state.doc.lineAt(sel.to).number,
+    screenRect: {
+      top: coords.top,
+      right: coords.right ?? coords.left,
+      bottom: coords.bottom,
+    },
+  };
+}
diff --git a/src/renderer/utils/codemirrorTheme.ts b/src/renderer/utils/codemirrorTheme.ts
index be76b321..270bc360 100644
--- a/src/renderer/utils/codemirrorTheme.ts
+++ b/src/renderer/utils/codemirrorTheme.ts
@@ -14,6 +14,7 @@ export const baseEditorTheme = EditorView.theme({
     color: 'var(--color-text)',
     fontFamily: 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace',
     fontSize: '13px',
+    height: '100%',
   },
   '&.cm-focused': {
     outline: 'none',
diff --git a/src/renderer/utils/keyboardUtils.ts b/src/renderer/utils/keyboardUtils.ts
index c525ad06..a5bd7f12 100644
--- a/src/renderer/utils/keyboardUtils.ts
+++ b/src/renderer/utils/keyboardUtils.ts
@@ -9,6 +9,60 @@ export function isMacOS(): boolean {
   return navigator.userAgent.toLowerCase().includes('mac');
 }
 
+/**
+ * Resolve the physical key from a keyboard event, independent of keyboard layout.
+ *
+ * Uses `event.code` (physical key position on a QWERTY keyboard) to determine
+ * the key, so shortcuts work correctly regardless of active layout (Russian,
+ * Hebrew, Arabic, etc.).
+ *
+ * Returns a lowercase single character for letter keys, digit for number keys,
+ * the symbol for punctuation keys, or falls back to `event.key` for special
+ * keys (Tab, Enter, Escape, Arrow*, etc.) which are layout-independent.
+ */
+export function physicalKey(e: KeyboardEvent): string {
+  const { code, key } = e;
+
+  // Letter keys: KeyA → 'a', KeyF → 'f', KeyZ → 'z'
+  if (code.startsWith('Key') && code.length === 4) {
+    return code[3].toLowerCase();
+  }
+
+  // Digit keys: Digit0 → '0', Digit9 → '9'
+  if (code.startsWith('Digit') && code.length === 6) {
+    return code[5];
+  }
+
+  // Punctuation / symbol keys
+  switch (code) {
+    case 'BracketLeft':
+      return '[';
+    case 'BracketRight':
+      return ']';
+    case 'Backslash':
+      return '\\';
+    case 'Comma':
+      return ',';
+    case 'Period':
+      return '.';
+    case 'Slash':
+      return '/';
+    case 'Semicolon':
+      return ';';
+    case 'Quote':
+      return "'";
+    case 'Minus':
+      return '-';
+    case 'Equal':
+      return '=';
+    case 'Backquote':
+      return '`';
+    default:
+      // Special keys: Tab, Enter, Escape, ArrowUp, ArrowDown, Space, etc.
+      return key;
+  }
+}
+
 /**
  * Get the primary modifier key name for the current platform
  * @returns 'Cmd' on macOS, 'Ctrl' on other platforms
diff --git a/src/renderer/utils/markdownPlugins.ts b/src/renderer/utils/markdownPlugins.ts
index 74fda2c5..9540ea30 100644
--- a/src/renderer/utils/markdownPlugins.ts
+++ b/src/renderer/utils/markdownPlugins.ts
@@ -1,8 +1,15 @@
 /**
  * Rehype plugins for markdown rendering (used with react-markdown).
- * Rehype runs after remark; rehype-highlight adds syntax highlighting to code blocks.
+ *
+ * - rehype-raw: parse and render inline HTML in markdown
+ * - rehype-highlight: syntax highlighting for code blocks
  */
 
 import rehypeHighlight from 'rehype-highlight';
+import rehypeRaw from 'rehype-raw';
 
-export const REHYPE_PLUGINS = [rehypeHighlight];
+/** Full plugin chain: raw HTML + syntax highlighting */
+export const REHYPE_PLUGINS = [rehypeRaw, rehypeHighlight];
+
+/** Lightweight chain: raw HTML only (used when highlighting is disabled for large content) */
+export const REHYPE_PLUGINS_NO_HIGHLIGHT = [rehypeRaw];
diff --git a/src/renderer/utils/previewRegistry.ts b/src/renderer/utils/previewRegistry.ts
new file mode 100644
index 00000000..c0de7391
--- /dev/null
+++ b/src/renderer/utils/previewRegistry.ts
@@ -0,0 +1,45 @@
+/**
+ * Preview type registry for binary files.
+ *
+ * Extensible: add a new PreviewType + extension set + component to support new formats.
+ */
+
+export type PreviewType = 'image' | 'unknown';
+
+const IMAGE_EXTENSIONS = new Set(['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'bmp', 'ico']);
+
+const IMAGE_MAX_SIZE = 10 * 1024 * 1024; // 10 MB
+
+const MIME_MAP: Record<string, string> = {
+  png: 'image/png',
+  jpg: 'image/jpeg',
+  jpeg: 'image/jpeg',
+  gif: 'image/gif',
+  webp: 'image/webp',
+  svg: 'image/svg+xml',
+  bmp: 'image/bmp',
+  ico: 'image/x-icon',
+};
+
+function getExtension(fileName: string): string {
+  const dot = fileName.lastIndexOf('.');
+  if (dot === -1) return '';
+  return fileName.slice(dot + 1).toLowerCase();
+}
+
+export function getPreviewType(fileName: string): PreviewType {
+  const ext = getExtension(fileName);
+  if (IMAGE_EXTENSIONS.has(ext)) return 'image';
+  return 'unknown';
+}
+
+export function isPreviewable(fileName: string, size: number): boolean {
+  const type = getPreviewType(fileName);
+  if (type === 'image') return size <= IMAGE_MAX_SIZE;
+  return false;
+}
+
+export function getMimeType(fileName: string): string | null {
+  const ext = getExtension(fileName);
+  return MIME_MAP[ext] ?? null;
+}
diff --git a/src/renderer/utils/quickOpenCache.ts b/src/renderer/utils/quickOpenCache.ts
new file mode 100644
index 00000000..a3026f07
--- /dev/null
+++ b/src/renderer/utils/quickOpenCache.ts
@@ -0,0 +1,40 @@
+/**
+ * Module-level cache for Quick Open file list.
+ * Separated from QuickOpenDialog to avoid circular dependency with editorSlice.
+ */
+
+import type { QuickOpenFile } from '@shared/types/editor';
+
+const FILE_LIST_CACHE_TTL = 10_000; // 10 seconds
+
+let fileListCache: { files: QuickOpenFile[]; projectPath: string; timestamp: number } | null = null;
+
+const invalidationListeners = new Set<() => void>();
+
+/** Subscribe to cache invalidation events. Returns unsubscribe function. */
+export function onQuickOpenCacheInvalidated(listener: () => void): () => void {
+  invalidationListeners.add(listener);
+  return () => invalidationListeners.delete(listener);
+}
+
+/** Invalidate file list cache (call on file watcher create/delete events) */
+export function invalidateQuickOpenCache(): void {
+  fileListCache = null;
+  invalidationListeners.forEach((fn) => fn());
+}
+
+/** Get cached file list if fresh and for the same project */
+export function getQuickOpenCache(projectPath: string): { files: QuickOpenFile[] } | null {
+  if (
+    fileListCache?.projectPath === projectPath &&
+    Date.now() - fileListCache.timestamp < FILE_LIST_CACHE_TTL
+  ) {
+    return { files: fileListCache.files };
+  }
+  return null;
+}
+
+/** Store file list in cache */
+export function setQuickOpenCache(projectPath: string, files: QuickOpenFile[]): void {
+  fileListCache = { files, projectPath, timestamp: Date.now() };
+}
diff --git a/src/renderer/utils/syntaxHighlighter.ts b/src/renderer/utils/syntaxHighlighter.ts
new file mode 100644
index 00000000..7d0dc1f5
--- /dev/null
+++ b/src/renderer/utils/syntaxHighlighter.ts
@@ -0,0 +1,158 @@
+/**
+ * Standalone syntax highlighter using highlight.js.
+ *
+ * Highlights code without a full CodeMirror EditorView.
+ * Outputs HTML strings with `hljs-*` CSS classes (already styled in index.css).
+ */
+
+import hljs from 'highlight.js';
+
+// =============================================================================
+// File extension → highlight.js language mapping
+// =============================================================================
+
+const EXT_TO_LANG: Record<string, string> = {
+  '.js': 'javascript',
+  '.mjs': 'javascript',
+  '.cjs': 'javascript',
+  '.jsx': 'javascript',
+  '.ts': 'typescript',
+  '.tsx': 'typescript',
+  '.py': 'python',
+  '.rb': 'ruby',
+  '.go': 'go',
+  '.rs': 'rust',
+  '.java': 'java',
+  '.kt': 'kotlin',
+  '.swift': 'swift',
+  '.c': 'c',
+  '.cpp': 'cpp',
+  '.cc': 'cpp',
+  '.h': 'c',
+  '.hpp': 'cpp',
+  '.cs': 'csharp',
+  '.php': 'php',
+  '.sh': 'bash',
+  '.bash': 'bash',
+  '.zsh': 'bash',
+  '.json': 'json',
+  '.yaml': 'yaml',
+  '.yml': 'yaml',
+  '.xml': 'xml',
+  '.html': 'xml',
+  '.htm': 'xml',
+  '.css': 'css',
+  '.scss': 'scss',
+  '.less': 'less',
+  '.sql': 'sql',
+  '.md': 'markdown',
+  '.toml': 'ini',
+  '.ini': 'ini',
+  '.lua': 'lua',
+  '.r': 'r',
+  '.scala': 'scala',
+  '.dart': 'dart',
+  '.ex': 'elixir',
+  '.exs': 'elixir',
+  '.erl': 'erlang',
+  '.hs': 'haskell',
+  '.pl': 'perl',
+  '.pm': 'perl',
+  '.m': 'objectivec',
+  '.mm': 'objectivec',
+  '.makefile': 'makefile',
+  '.cmake': 'cmake',
+  '.dockerfile': 'dockerfile',
+  '.tf': 'hcl',
+  '.proto': 'protobuf',
+  '.graphql': 'graphql',
+  '.gql': 'graphql',
+  '.vue': 'xml',
+  '.svelte': 'xml',
+};
+
+function getLanguage(fileName: string): string | undefined {
+  const dotIndex = fileName.lastIndexOf('.');
+  if (dotIndex === -1) return undefined;
+  const ext = fileName.slice(dotIndex).toLowerCase();
+
+  // Explicit map first, then try extension as hljs alias (e.g. 'rb', 'py')
+  const mapped = EXT_TO_LANG[ext];
+  if (mapped) return mapped;
+
+  const bare = ext.slice(1); // '.ts' → 'ts'
+  if (bare && hljs.getLanguage(bare)) return bare;
+
+  return undefined;
+}
+
+// =============================================================================
+// HTML line splitting
+// =============================================================================
+
+/** Escape HTML and split into plain-text lines (fallback for unknown languages). */
+function escapeAndSplit(code: string): string[] {
+  const escaped = code.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+  return escaped.split('\n');
+}
+
+/**
+ * Split highlight.js HTML output into per-line strings with balanced tags.
+ * Multi-line spans (comments, strings) are properly closed/reopened at line breaks.
+ */
+function splitHtmlByLines(html: string): string[] {
+  const rawLines = html.split('\n');
+  const result: string[] = [];
+  const openTags: string[] = [];
+
+  for (const rawLine of rawLines) {
+    // Prefix with any spans still open from previous lines
+    const prefix = openTags.join('');
+    const fullLine = prefix + rawLine;
+
+    // Update open tags stack by scanning this line's tags
+    const tagRegex = /<span[^>]*>|<\/span>/g;
+    let match;
+    while ((match = tagRegex.exec(rawLine)) !== null) {
+      if (match[0] === '</span>') {
+        if (openTags.length > 0) openTags.pop();
+      } else {
+        openTags.push(match[0]);
+      }
+    }
+
+    // Close any unclosed spans for this line
+    const suffix = '</span>'.repeat(openTags.length);
+    result.push(fullLine + suffix);
+  }
+
+  return result;
+}
+
+// =============================================================================
+// Public API
+// =============================================================================
+
+/**
+ * Highlight code and return per-line HTML strings with `hljs-*` CSS classes.
+ * Uses highlight.js (same library as rehype-highlight in markdown rendering).
+ */
+export function highlightLines(code: string, fileName: string): string[] {
+  if (!code) return [''];
+
+  const lang = getLanguage(fileName);
+
+  let highlighted: string;
+  if (!lang) {
+    // Unknown extension — plain text is safer than unreliable auto-detection
+    return escapeAndSplit(code);
+  }
+
+  try {
+    highlighted = hljs.highlight(code, { language: lang }).value;
+  } catch {
+    return escapeAndSplit(code);
+  }
+
+  return splitHtmlByLines(highlighted);
+}
diff --git a/src/renderer/utils/unwrapIpc.ts b/src/renderer/utils/unwrapIpc.ts
index a86e6817..ab95e374 100644
--- a/src/renderer/utils/unwrapIpc.ts
+++ b/src/renderer/utils/unwrapIpc.ts
@@ -13,12 +13,19 @@ export class IpcError extends Error {
   }
 }
 
+/** Error messages that represent expected transient states, not real failures. */
+const EXPECTED_IPC_SIGNALS = ['TEAM_PROVISIONING'];
+
 export async function unwrapIpc<T>(operation: string, fn: () => Promise<T>): Promise<T> {
   try {
     return await fn();
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    logger.error(`[${operation}] ${message}`);
+    if (EXPECTED_IPC_SIGNALS.some((sig) => message.includes(sig))) {
+      logger.debug(`[${operation}] ${message}`);
+    } else {
+      logger.error(`[${operation}] ${message}`);
+    }
     throw new IpcError(operation, message, error);
   }
 }
diff --git a/src/shared/types/api.ts b/src/shared/types/api.ts
index c4d20348..04d4ee69 100644
--- a/src/shared/types/api.ts
+++ b/src/shared/types/api.ts
@@ -8,7 +8,7 @@
  */
 
 import type { CliInstallerAPI } from './cliInstaller';
-import type { EditorAPI } from './editor';
+import type { EditorAPI, ProjectAPI } from './editor';
 import type {
   AppConfig,
   DetectedError,
@@ -184,6 +184,10 @@ export interface ConfigAPI {
   hideSessions: (projectId: string, sessionIds: string[]) => Promise<void>;
   /** Bulk unhide sessions for a project */
   unhideSessions: (projectId: string, sessionIds: string[]) => Promise<void>;
+  /** Add a custom project path (persisted across restarts) */
+  addCustomProjectPath: (projectPath: string) => Promise<void>;
+  /** Remove a custom project path */
+  removeCustomProjectPath: (projectPath: string) => Promise<void>;
 }
 
 export interface ClaudeRootInfo {
@@ -422,7 +426,14 @@ export interface TeamsAPI {
   getLogsForTask: (
     teamName: string,
     taskId: string,
-    options?: { owner?: string; status?: string }
+    options?: {
+      owner?: string;
+      status?: string;
+      /** Persisted work intervals (preferred for reliable owner-log attribution). */
+      intervals?: { startedAt: string; completedAt?: string }[];
+      /** Back-compat: single since timestamp (deprecated). */
+      since?: string;
+    }
   ) => Promise<MemberLogSummary[]>;
   getMemberStats: (teamName: string, memberName: string) => Promise<MemberFullStats>;
   launchTeam: (request: TeamLaunchRequest) => Promise<TeamLaunchResponse>;
@@ -449,6 +460,18 @@ export interface TeamsAPI {
   restoreTask: (teamName: string, taskId: string) => Promise<void>;
   getDeletedTasks: (teamName: string) => Promise<TeamTask[]>;
   showMessageNotification: (data: TeamMessageNotificationData) => Promise<void>;
+  addTaskRelationship: (
+    teamName: string,
+    taskId: string,
+    targetId: string,
+    type: 'blockedBy' | 'blocks' | 'related'
+  ) => Promise<void>;
+  removeTaskRelationship: (
+    teamName: string,
+    taskId: string,
+    targetId: string,
+    type: 'blockedBy' | 'blocks' | 'related'
+  ) => Promise<void>;
   onTeamChange: (callback: (event: unknown, data: TeamChangeEvent) => void) => () => void;
   onProvisioningProgress: (
     callback: (event: unknown, data: TeamProvisioningProgress) => void
@@ -489,7 +512,11 @@ export interface ReviewAPI {
     snippets: SnippetDiff[]
   ) => Promise<{ preview: string; hasConflicts: boolean }>;
   // Editable diff
-  saveEditedFile: (filePath: string, content: string) => Promise<{ success: boolean }>;
+  saveEditedFile: (
+    filePath: string,
+    content: string,
+    projectPath?: string
+  ) => Promise<{ success: boolean }>;
   // Decision persistence
   loadDecisions: (
     teamName: string,
@@ -497,12 +524,18 @@ export interface ReviewAPI {
   ) => Promise<{
     hunkDecisions: Record<string, HunkDecision>;
     fileDecisions: Record<string, HunkDecision>;
+    /**
+     * Optional stable hunk fingerprints persisted from the renderer.
+     * filePath -> (hunkIndex -> contextHash)
+     */
+    hunkContextHashesByFile?: Record<string, Record<number, string>>;
   } | null>;
   saveDecisions: (
     teamName: string,
     scopeKey: string,
     hunkDecisions: Record<string, HunkDecision>,
-    fileDecisions: Record<string, HunkDecision>
+    fileDecisions: Record<string, HunkDecision>,
+    hunkContextHashesByFile?: Record<string, Record<number, string>>
   ) => Promise<void>;
   clearDecisions: (teamName: string, scopeKey: string) => Promise<void>;
   onCmdN?: (callback: () => void) => (() => void) | undefined;
@@ -645,6 +678,9 @@ export interface ElectronAPI {
   // Embedded Terminal API (xterm.js + node-pty)
   terminal: TerminalAPI;
 
+  // Project file operations (editor-independent)
+  project: ProjectAPI;
+
   // Project Editor API (file browser + CodeMirror)
   editor: EditorAPI;
 }
diff --git a/src/shared/types/editor.ts b/src/shared/types/editor.ts
index 2110f4f0..a8c9638d 100644
--- a/src/shared/types/editor.ts
+++ b/src/shared/types/editor.ts
@@ -190,14 +190,45 @@ export interface EditorAPI {
   createDir: (parentDir: string, dirName: string) => Promise<CreateDirResponse>;
   deleteFile: (filePath: string) => Promise<DeleteFileResponse>;
   moveFile: (sourcePath: string, destDir: string) => Promise<MoveFileResponse>;
+  renameFile: (sourcePath: string, newName: string) => Promise<MoveFileResponse>;
   searchInFiles: (options: SearchInFilesOptions) => Promise<SearchInFilesResult>;
   listFiles: () => Promise<QuickOpenFile[]>;
+  readBinaryPreview: (filePath: string) => Promise<BinaryPreviewResult>;
   gitStatus: () => Promise<GitStatusResult>;
   watchDir: (enable: boolean) => Promise<void>;
+  /**
+   * Provide the list of currently-open file paths (tabs) to watch.
+   * Intended as a performance optimization: avoids watching the whole project tree.
+   */
+  setWatchedFiles: (filePaths: string[]) => Promise<void>;
+  /**
+   * Provide the list of directories to watch shallowly (depth=0).
+   * Intended to keep the explorer tree in sync with external changes without
+   * recursively watching the whole project.
+   */
+  setWatchedDirs: (dirPaths: string[]) => Promise<void>;
   /** Subscribe to file change events (main → renderer). Returns cleanup function. */
   onEditorChange: (callback: (event: EditorFileChangeEvent) => void) => () => void;
 }
 
+/** Editor-independent project file operations (e.g. @file mentions). */
+export interface ProjectAPI {
+  listFiles: (projectPath: string) => Promise<QuickOpenFile[]>;
+}
+
+// =============================================================================
+// Binary Preview
+// =============================================================================
+
+export interface BinaryPreviewResult {
+  /** Base64-encoded file content */
+  base64: string;
+  /** MIME type (e.g. 'image/png') */
+  mimeType: string;
+  /** File size in bytes */
+  size: number;
+}
+
 // =============================================================================
 // Selection Action Menu
 // =============================================================================
@@ -214,9 +245,13 @@ export interface EditorSelectionInfo {
 export interface EditorSelectionAction {
   type: 'sendMessage' | 'createTask';
   filePath: string;
-  fromLine: number;
-  toLine: number;
+  /** 1-based start line, or null for file-level mentions (no code selection) */
+  fromLine: number | null;
+  /** 1-based end line, or null for file-level mentions (no code selection) */
+  toLine: number | null;
   selectedText: string;
-  /** Pre-formatted context block (markdown code fence) */
+  /** Pre-formatted context block (markdown code fence or file reference) */
   formattedContext: string;
+  /** Relative display path for file-level mentions */
+  displayPath?: string;
 }
diff --git a/src/shared/types/notifications.ts b/src/shared/types/notifications.ts
index a1125548..343ecf8e 100644
--- a/src/shared/types/notifications.ts
+++ b/src/shared/types/notifications.ts
@@ -247,6 +247,12 @@ export interface AppConfig {
     snoozeMinutes: number;
     /** Whether to include errors from subagent sessions */
     includeSubagentErrors: boolean;
+    /** Whether to show native OS notifications when teammates send messages to the team lead */
+    notifyOnLeadInbox: boolean;
+    /** Whether to show native OS notifications when teammates send messages to you (the user) */
+    notifyOnUserInbox: boolean;
+    /** Whether to show native OS notifications when a task needs user clarification */
+    notifyOnClarifications: boolean;
     /** Notification triggers - define when to generate notifications */
     triggers: NotificationTrigger[];
   };
diff --git a/src/shared/types/review.ts b/src/shared/types/review.ts
index 55701847..7adc5ff2 100644
--- a/src/shared/types/review.ts
+++ b/src/shared/types/review.ts
@@ -81,6 +81,16 @@ export interface FileReviewDecision {
   filePath: string;
   fileDecision: HunkDecision;
   hunkDecisions: Record<number, HunkDecision>;
+  /** Optional stable hunk fingerprints (index → contextHash). Used to map decisions when indices drift. */
+  hunkContextHashes?: Record<number, string>;
+  /**
+   * Optional context to apply decisions without re-resolving content in main process.
+   * When present, main can use these values directly (safer in task mode where memberName may be unknown).
+   */
+  snippets?: SnippetDiff[];
+  originalFullContent?: string | null;
+  modifiedFullContent?: string | null;
+  isNewFile?: boolean;
 }
 
 /** Запрос на применение review */
diff --git a/src/shared/types/team.ts b/src/shared/types/team.ts
index c11d44cc..eda87d33 100644
--- a/src/shared/types/team.ts
+++ b/src/shared/types/team.ts
@@ -55,11 +55,21 @@ export interface TeamSummary {
 
 export type TeamTaskStatus = 'pending' | 'in_progress' | 'completed' | 'deleted';
 
+export interface TaskWorkInterval {
+  /** ISO timestamp when task entered in_progress */
+  startedAt: string;
+  /** ISO timestamp when task left in_progress (optional for active interval) */
+  completedAt?: string;
+}
+
+export type TaskCommentType = 'regular' | 'review_request' | 'review_approved';
+
 export interface TaskComment {
   id: string;
   author: string;
   text: string;
   createdAt: string;
+  type: TaskCommentType;
 }
 
 // Fields are validated in TeamTaskReader.getTasks() using `satisfies Record<keyof TeamTask, unknown>`.
@@ -72,6 +82,11 @@ export interface TeamTask {
   owner?: string;
   createdBy?: string;
   status: TeamTaskStatus;
+  /**
+   * One task can be worked on in multiple disjoint periods (e.g. review sends it back to in_progress).
+   * We persist intervals for reliable log attribution without relying on heuristics.
+   */
+  workIntervals?: TaskWorkInterval[];
   blocks?: string[];
   blockedBy?: string[];
   /**
@@ -271,6 +286,7 @@ export interface TeamCreateConfigRequest {
   description?: string;
   color?: string;
   members: TeamProvisioningMemberInput[];
+  cwd?: string;
 }
 
 export interface TeamCreateResponse {
diff --git a/src/shared/utils/diffContextHash.ts b/src/shared/utils/diffContextHash.ts
new file mode 100644
index 00000000..514bd8f3
--- /dev/null
+++ b/src/shared/utils/diffContextHash.ts
@@ -0,0 +1,22 @@
+/**
+ * Computes a stable, lightweight hash for diff context matching.
+ *
+ * This is intentionally NON-cryptographic and designed for:
+ * - matching hunks/snippets across processes
+ * - tolerating small differences by using head/tail windows
+ */
+export function computeDiffContextHash(oldString: string, newString: string): string {
+  const take3 = (s: string): string => {
+    const lines = s.split('\n');
+    const head = lines.slice(0, 3).join('\n');
+    const tail = lines.length > 3 ? lines.slice(-3).join('\n') : '';
+    return `${head}|${tail}`;
+  };
+  const raw = `${take3(oldString)}::${take3(newString)}`;
+  // DJB2 variant
+  let hash = 5381;
+  for (let i = 0; i < raw.length; i++) {
+    hash = ((hash << 5) + hash + raw.charCodeAt(i)) | 0;
+  }
+  return (hash >>> 0).toString(36);
+}
diff --git a/test/main/ipc/editor.test.ts b/test/main/ipc/editor.test.ts
index e5ddb37e..3917a7c0 100644
--- a/test/main/ipc/editor.test.ts
+++ b/test/main/ipc/editor.test.ts
@@ -38,11 +38,16 @@ vi.mock('@preload/constants/ipcChannels', () => ({
   EDITOR_CREATE_DIR: 'editor:createDir',
   EDITOR_DELETE_FILE: 'editor:deleteFile',
   EDITOR_MOVE_FILE: 'editor:moveFile',
+  EDITOR_RENAME_FILE: 'editor:renameFile',
   EDITOR_SEARCH_IN_FILES: 'editor:searchInFiles',
   EDITOR_LIST_FILES: 'editor:listFiles',
+  EDITOR_READ_BINARY_PREVIEW: 'editor:readBinaryPreview',
   EDITOR_GIT_STATUS: 'editor:gitStatus',
   EDITOR_WATCH_DIR: 'editor:watchDir',
+  EDITOR_SET_WATCHED_FILES: 'editor:setWatchedFiles',
+  EDITOR_SET_WATCHED_DIRS: 'editor:setWatchedDirs',
   EDITOR_CHANGE: 'editor:change',
+  PROJECT_LIST_FILES: 'project:listFiles',
 }));
 
 // Mock atomicWrite used by ProjectFileService
@@ -145,8 +150,8 @@ describe('Editor IPC handlers', () => {
   });
 
   describe('registration', () => {
-    it('registers all 13 editor channels', () => {
-      expect(mockIpc.handle).toHaveBeenCalledTimes(13);
+    it('registers all 18 editor channels', () => {
+      expect(mockIpc.handle).toHaveBeenCalledTimes(18);
       expect(mockIpc._handlers.has('editor:open')).toBe(true);
       expect(mockIpc._handlers.has('editor:close')).toBe(true);
       expect(mockIpc._handlers.has('editor:readDir')).toBe(true);
@@ -156,15 +161,20 @@ describe('Editor IPC handlers', () => {
       expect(mockIpc._handlers.has('editor:createDir')).toBe(true);
       expect(mockIpc._handlers.has('editor:deleteFile')).toBe(true);
       expect(mockIpc._handlers.has('editor:moveFile')).toBe(true);
+      expect(mockIpc._handlers.has('editor:renameFile')).toBe(true);
       expect(mockIpc._handlers.has('editor:searchInFiles')).toBe(true);
       expect(mockIpc._handlers.has('editor:listFiles')).toBe(true);
+      expect(mockIpc._handlers.has('editor:readBinaryPreview')).toBe(true);
       expect(mockIpc._handlers.has('editor:gitStatus')).toBe(true);
       expect(mockIpc._handlers.has('editor:watchDir')).toBe(true);
+      expect(mockIpc._handlers.has('editor:setWatchedFiles')).toBe(true);
+      expect(mockIpc._handlers.has('editor:setWatchedDirs')).toBe(true);
+      expect(mockIpc._handlers.has('project:listFiles')).toBe(true);
     });
 
     it('removeEditorHandlers clears all channels', () => {
       removeEditorHandlers(mockIpc as unknown as IpcMain);
-      expect(mockIpc.removeHandler).toHaveBeenCalledTimes(13);
+      expect(mockIpc.removeHandler).toHaveBeenCalledTimes(18);
     });
   });
 
diff --git a/test/main/ipc/teams.test.ts b/test/main/ipc/teams.test.ts
index 3face9a8..3906797f 100644
--- a/test/main/ipc/teams.test.ts
+++ b/test/main/ipc/teams.test.ts
@@ -49,6 +49,8 @@ vi.mock('@preload/constants/ipcChannels', () => ({
   TEAM_GET_DELETED_TASKS: 'team:getDeletedTasks',
   TEAM_SET_TASK_CLARIFICATION: 'team:setTaskClarification',
   TEAM_SHOW_MESSAGE_NOTIFICATION: 'team:showMessageNotification',
+  TEAM_ADD_TASK_RELATIONSHIP: 'team:addTaskRelationship',
+  TEAM_REMOVE_TASK_RELATIONSHIP: 'team:removeTaskRelationship',
   TEAM_RESTORE: 'team:restoreTeam',
   TEAM_PERMANENTLY_DELETE: 'team:permanentlyDeleteTeam',
   TEAM_RESTORE_TASK: 'team:restoreTask',
@@ -93,6 +95,8 @@ import {
   TEAM_SET_TASK_CLARIFICATION,
   TEAM_SOFT_DELETE_TASK,
   TEAM_UPDATE_MEMBER_ROLE,
+  TEAM_ADD_TASK_RELATIONSHIP,
+  TEAM_REMOVE_TASK_RELATIONSHIP,
 } from '../../../src/preload/constants/ipcChannels';
 import {
   initializeTeamHandlers,
@@ -142,6 +146,8 @@ describe('ipc teams handlers', () => {
     softDeleteTask: vi.fn(async () => undefined),
     getDeletedTasks: vi.fn(async () => []),
     setTaskNeedsClarification: vi.fn(async () => undefined),
+    addTaskRelationship: vi.fn(async () => undefined),
+    removeTaskRelationship: vi.fn(async () => undefined),
   };
   const provisioningService = {
     prepareForProvisioning: vi.fn(async () => ({
@@ -216,6 +222,8 @@ describe('ipc teams handlers', () => {
     expect(handlers.has(TEAM_SET_TASK_CLARIFICATION)).toBe(true);
     expect(handlers.has(TEAM_RESTORE)).toBe(true);
     expect(handlers.has(TEAM_PERMANENTLY_DELETE)).toBe(true);
+    expect(handlers.has(TEAM_ADD_TASK_RELATIONSHIP)).toBe(true);
+    expect(handlers.has(TEAM_REMOVE_TASK_RELATIONSHIP)).toBe(true);
   });
 
   it('returns success false on invalid sendMessage args', async () => {
@@ -535,5 +543,77 @@ describe('ipc teams handlers', () => {
     expect(handlers.has(TEAM_SET_TASK_CLARIFICATION)).toBe(false);
     expect(handlers.has(TEAM_RESTORE)).toBe(false);
     expect(handlers.has(TEAM_PERMANENTLY_DELETE)).toBe(false);
+    expect(handlers.has(TEAM_ADD_TASK_RELATIONSHIP)).toBe(false);
+    expect(handlers.has(TEAM_REMOVE_TASK_RELATIONSHIP)).toBe(false);
+  });
+
+  describe('addTaskRelationship', () => {
+    it('calls service on valid input', async () => {
+      const handler = handlers.get(TEAM_ADD_TASK_RELATIONSHIP)!;
+      const result = (await handler({} as never, 'my-team', '1', '2', 'blockedBy')) as {
+        success: boolean;
+      };
+      expect(result.success).toBe(true);
+      expect(service.addTaskRelationship).toHaveBeenCalledWith('my-team', '1', '2', 'blockedBy');
+    });
+
+    it('rejects invalid team name', async () => {
+      const handler = handlers.get(TEAM_ADD_TASK_RELATIONSHIP)!;
+      const result = (await handler({} as never, '../bad', '1', '2', 'blockedBy')) as {
+        success: boolean;
+      };
+      expect(result.success).toBe(false);
+    });
+
+    it('rejects invalid task id', async () => {
+      const handler = handlers.get(TEAM_ADD_TASK_RELATIONSHIP)!;
+      const result = (await handler({} as never, 'my-team', 'abc', '2', 'blockedBy')) as {
+        success: boolean;
+      };
+      expect(result.success).toBe(false);
+    });
+
+    it('rejects invalid target id', async () => {
+      const handler = handlers.get(TEAM_ADD_TASK_RELATIONSHIP)!;
+      const result = (await handler({} as never, 'my-team', '1', '', 'blockedBy')) as {
+        success: boolean;
+      };
+      expect(result.success).toBe(false);
+    });
+
+    it('rejects invalid relationship type', async () => {
+      const handler = handlers.get(TEAM_ADD_TASK_RELATIONSHIP)!;
+      const result = (await handler({} as never, 'my-team', '1', '2', 'invalid')) as {
+        success: boolean;
+      };
+      expect(result.success).toBe(false);
+    });
+  });
+
+  describe('removeTaskRelationship', () => {
+    it('calls service on valid input', async () => {
+      const handler = handlers.get(TEAM_REMOVE_TASK_RELATIONSHIP)!;
+      const result = (await handler({} as never, 'my-team', '1', '2', 'related')) as {
+        success: boolean;
+      };
+      expect(result.success).toBe(true);
+      expect(service.removeTaskRelationship).toHaveBeenCalledWith('my-team', '1', '2', 'related');
+    });
+
+    it('rejects invalid team name', async () => {
+      const handler = handlers.get(TEAM_REMOVE_TASK_RELATIONSHIP)!;
+      const result = (await handler({} as never, '../bad', '1', '2', 'related')) as {
+        success: boolean;
+      };
+      expect(result.success).toBe(false);
+    });
+
+    it('rejects invalid relationship type', async () => {
+      const handler = handlers.get(TEAM_REMOVE_TASK_RELATIONSHIP)!;
+      const result = (await handler({} as never, 'my-team', '1', '2', 'unknown')) as {
+        success: boolean;
+      };
+      expect(result.success).toBe(false);
+    });
   });
 });
diff --git a/test/main/services/editor/EditorFileWatcher.test.ts b/test/main/services/editor/EditorFileWatcher.test.ts
index cf5e588a..aaffa720 100644
--- a/test/main/services/editor/EditorFileWatcher.test.ts
+++ b/test/main/services/editor/EditorFileWatcher.test.ts
@@ -2,7 +2,7 @@
  * Tests for EditorFileWatcher — start/stop, event filtering, path security.
  */
 
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 // Mock chokidar
 const mockOn = vi.fn().mockReturnThis();
@@ -41,29 +41,41 @@ import { EditorFileWatcher } from '../../../../src/main/services/editor/EditorFi
 
 describe('EditorFileWatcher', () => {
   let watcher: EditorFileWatcher;
+  const FLUSH_DEBOUNCE_MS = 350;
+  const STARTUP_IGNORE_CHANGE_MS = 3000;
 
   beforeEach(() => {
+    vi.useFakeTimers();
     vi.resetAllMocks();
     mockOn.mockReturnThis();
     watcher = new EditorFileWatcher();
   });
 
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
   describe('start', () => {
-    it('creates chokidar watcher with correct options', () => {
+    it('creates chokidar watcher with correct options (open files only)', () => {
       const onChange = vi.fn();
       watcher.start('/Users/test/project', onChange);
 
-      expect(watch).toHaveBeenCalledWith('/Users/test/project', {
-        ignored: expect.any(RegExp),
+      // start() does not create a watcher until we provide watched files
+      expect(watch).not.toHaveBeenCalled();
+
+      watcher.setWatchedFiles(['/Users/test/project/src/index.ts']);
+
+      expect(watch).toHaveBeenCalledWith(['/Users/test/project/src/index.ts'], {
         ignoreInitial: true,
+        ignorePermissionErrors: true,
         followSymlinks: false,
-        depth: 20,
       });
     });
 
     it('registers change, add, unlink, and error handlers', () => {
       const onChange = vi.fn();
       watcher.start('/Users/test/project', onChange);
+      watcher.setWatchedFiles(['/Users/test/project/src/index.ts']);
 
       const registeredEvents = mockOn.mock.calls.map((c) => c[0]);
       expect(registeredEvents).toContain('change');
@@ -75,10 +87,14 @@ describe('EditorFileWatcher', () => {
     it('emits normalized events through onChange callback', () => {
       const onChange = vi.fn();
       watcher.start('/Users/test/project', onChange);
+      watcher.setWatchedFiles(['/Users/test/project/src/index.ts']);
 
       // Simulate chokidar 'change' event
       const changeHandler = mockOn.mock.calls.find((c) => c[0] === 'change')?.[1];
+      // Startup grace period ignores 'change' events for first 3s
+      vi.advanceTimersByTime(STARTUP_IGNORE_CHANGE_MS);
       changeHandler?.('/Users/test/project/src/index.ts');
+      vi.advanceTimersByTime(FLUSH_DEBOUNCE_MS);
 
       expect(onChange).toHaveBeenCalledWith({
         type: 'change',
@@ -89,9 +105,11 @@ describe('EditorFileWatcher', () => {
     it('emits create event for add', () => {
       const onChange = vi.fn();
       watcher.start('/Users/test/project', onChange);
+      watcher.setWatchedFiles(['/Users/test/project/new-file.ts']);
 
       const addHandler = mockOn.mock.calls.find((c) => c[0] === 'add')?.[1];
       addHandler?.('/Users/test/project/new-file.ts');
+      vi.advanceTimersByTime(FLUSH_DEBOUNCE_MS);
 
       expect(onChange).toHaveBeenCalledWith({
         type: 'create',
@@ -102,9 +120,11 @@ describe('EditorFileWatcher', () => {
     it('emits delete event for unlink', () => {
       const onChange = vi.fn();
       watcher.start('/Users/test/project', onChange);
+      watcher.setWatchedFiles(['/Users/test/project/old-file.ts']);
 
       const unlinkHandler = mockOn.mock.calls.find((c) => c[0] === 'unlink')?.[1];
       unlinkHandler?.('/Users/test/project/old-file.ts');
+      vi.advanceTimersByTime(FLUSH_DEBOUNCE_MS);
 
       expect(onChange).toHaveBeenCalledWith({
         type: 'delete',
@@ -113,12 +133,12 @@ describe('EditorFileWatcher', () => {
     });
 
     it('ignores events outside project root (SEC-2)', () => {
-      vi.mocked(isPathWithinRoot).mockReturnValueOnce(false);
-
       const onChange = vi.fn();
       watcher.start('/Users/test/project', onChange);
+      watcher.setWatchedFiles(['/Users/test/project/src/index.ts']);
 
       const changeHandler = mockOn.mock.calls.find((c) => c[0] === 'change')?.[1];
+      vi.advanceTimersByTime(STARTUP_IGNORE_CHANGE_MS);
       changeHandler?.('/etc/passwd');
 
       expect(onChange).not.toHaveBeenCalled();
@@ -127,10 +147,11 @@ describe('EditorFileWatcher', () => {
     it('stops previous watcher on re-start (idempotent)', () => {
       const onChange = vi.fn();
       watcher.start('/Users/test/project1', onChange);
+      watcher.setWatchedFiles(['/Users/test/project1/a.ts']);
       watcher.start('/Users/test/project2', onChange);
 
       expect(mockClose).toHaveBeenCalledTimes(1);
-      expect(watch).toHaveBeenCalledTimes(2);
+      expect(watch).toHaveBeenCalledTimes(1);
     });
   });
 
@@ -138,6 +159,7 @@ describe('EditorFileWatcher', () => {
     it('closes the watcher', () => {
       const onChange = vi.fn();
       watcher.start('/Users/test/project', onChange);
+      watcher.setWatchedFiles(['/Users/test/project/a.ts']);
 
       watcher.stop();
 
@@ -151,18 +173,37 @@ describe('EditorFileWatcher', () => {
     });
   });
 
+  describe('setWatchedFiles before start', () => {
+    it('returns silently when watcher not initialized', () => {
+      // Should NOT throw — graceful no-op when projectRoot is null
+      expect(() => watcher.setWatchedFiles(['/some/file.ts'])).not.toThrow();
+      expect(watch).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('setWatchedDirs before start', () => {
+    it('returns silently when watcher not initialized', () => {
+      // Should NOT throw — graceful no-op when projectRoot is null
+      expect(() => watcher.setWatchedDirs(['/some/dir'])).not.toThrow();
+      expect(watch).not.toHaveBeenCalled();
+    });
+  });
+
   describe('isWatching', () => {
     it('returns false when not started', () => {
       expect(watcher.isWatching()).toBe(false);
     });
 
-    it('returns true after start', () => {
+    it('returns true after setWatchedFiles', () => {
       watcher.start('/Users/test/project', vi.fn());
+      expect(watcher.isWatching()).toBe(false);
+      watcher.setWatchedFiles(['/Users/test/project/a.ts']);
       expect(watcher.isWatching()).toBe(true);
     });
 
     it('returns false after stop', () => {
       watcher.start('/Users/test/project', vi.fn());
+      watcher.setWatchedFiles(['/Users/test/project/a.ts']);
       watcher.stop();
       expect(watcher.isWatching()).toBe(false);
     });
diff --git a/test/main/services/editor/FileSearchService.test.ts b/test/main/services/editor/FileSearchService.test.ts
index bbe40f34..f9fa4d45 100644
--- a/test/main/services/editor/FileSearchService.test.ts
+++ b/test/main/services/editor/FileSearchService.test.ts
@@ -29,7 +29,7 @@ import { isBinaryFile } from 'isbinaryfile';
 
 import { FileSearchService } from '@main/services/editor/FileSearchService';
 
-const PROJECT_ROOT = '/test/project';
+const PROJECT_ROOT = path.resolve('/test/project');
 
 describe('FileSearchService', () => {
   let service: FileSearchService;
@@ -40,6 +40,12 @@ describe('FileSearchService', () => {
   });
 
   function mockFileSystem(files: Record<string, string>) {
+    // Normalize keys so lookups work on Windows (backslash vs forward slash)
+    const normalizedFiles: Record<string, string> = {};
+    for (const [key, value] of Object.entries(files)) {
+      normalizedFiles[path.normalize(key)] = value;
+    }
+
     const entries = Object.keys(files).map((filePath) => {
       const name = path.basename(filePath);
       return { name, isFile: () => true, isDirectory: () => false };
@@ -49,15 +55,15 @@ describe('FileSearchService', () => {
     vi.mocked(isBinaryFile).mockResolvedValue(false);
 
     vi.mocked(fs.stat).mockImplementation(async (filePath: unknown) => {
-      const p = String(filePath);
-      const content = files[p];
+      const p = path.normalize(String(filePath));
+      const content = normalizedFiles[p];
       if (content === undefined) throw new Error('ENOENT');
       return { size: content.length } as never;
     });
 
     vi.mocked(fs.readFile).mockImplementation(async (filePath: unknown) => {
-      const p = String(filePath);
-      const content = files[p];
+      const p = path.normalize(String(filePath));
+      const content = normalizedFiles[p];
       if (content === undefined) throw new Error('ENOENT');
       return content as never;
     });
diff --git a/test/main/services/editor/ProjectFileService.test.ts b/test/main/services/editor/ProjectFileService.test.ts
index 73da1892..42843527 100644
--- a/test/main/services/editor/ProjectFileService.test.ts
+++ b/test/main/services/editor/ProjectFileService.test.ts
@@ -55,7 +55,7 @@ import { ProjectFileService } from '../../../../src/main/services/editor/Project
 // Setup
 // =============================================================================
 
-const PROJECT_ROOT = '/Users/test/my-project';
+const PROJECT_ROOT = path.resolve('/Users/test/my-project');
 let service: ProjectFileService;
 
 const mockLstat = vi.mocked(fs.lstat);
@@ -219,7 +219,7 @@ describe('ProjectFileService.readDir', () => {
 
     mockRealpath.mockImplementation(async (p) => {
       const name = path.basename(String(p));
-      if (name === 'safe-link') return PROJECT_ROOT + '/actual-dir';
+      if (name === 'safe-link') return path.join(PROJECT_ROOT, 'actual-dir');
       return '/etc/shadow'; // escapes project
     });
 
@@ -559,8 +559,8 @@ describe('ProjectFileService.deleteFile', () => {
 // =============================================================================
 
 describe('ProjectFileService.moveFile', () => {
-  const SRC_DIR = PROJECT_ROOT + '/src';
-  const DEST_DIR = PROJECT_ROOT + '/lib';
+  const SRC_DIR = path.join(PROJECT_ROOT, 'src');
+  const DEST_DIR = path.join(PROJECT_ROOT, 'lib');
 
   beforeEach(() => {
     mockRename.mockResolvedValue(undefined);
diff --git a/test/main/services/infrastructure/CliInstallerService.test.ts b/test/main/services/infrastructure/CliInstallerService.test.ts
index 58b36eb5..a8ebd83c 100644
--- a/test/main/services/infrastructure/CliInstallerService.test.ts
+++ b/test/main/services/infrastructure/CliInstallerService.test.ts
@@ -262,8 +262,8 @@ describe('CliInstallerService', () => {
 
       const statusPromise = service.getStatus();
 
-      // Advance past GET_STATUS_TIMEOUT_MS (25s)
-      await vi.advanceTimersByTimeAsync(26_000);
+      // Advance past GET_STATUS_TIMEOUT_MS (30s)
+      await vi.advanceTimersByTimeAsync(31_000);
 
       const status = await statusPromise;
 
@@ -295,6 +295,115 @@ describe('CliInstallerService', () => {
     });
   });
 
+  describe('auth parallelism', () => {
+    let httpsGet: ReturnType<typeof vi.fn>;
+
+    beforeEach(async () => {
+      // Reset execCli mock queue (clearAllMocks doesn't clear mockResolvedValueOnce queue)
+      vi.mocked(execCli).mockReset();
+      vi.mocked(execCli).mockRejectedValue(new Error('execCli not configured'));
+
+      // Get reference to the mocked https.get for per-test control
+      const httpsModule = await import('https');
+      httpsGet = vi.mocked(httpsModule.default.get);
+    });
+
+    afterEach(() => {
+      // Reset https.get so it doesn't leak into subsequent test groups
+      httpsGet.mockReset();
+      vi.useRealTimers();
+    });
+
+    it('auth is not blocked by slow GCS fetch', async () => {
+      allowConsoleLogs();
+      vi.useFakeTimers();
+
+      vi.mocked(ClaudeBinaryResolver.resolve).mockResolvedValue('/usr/local/bin/claude');
+
+      // --version resolves immediately, auth resolves immediately
+      vi.mocked(execCli)
+        .mockResolvedValueOnce({ stdout: '2.5.0 (Claude Code)', stderr: '' })
+        .mockResolvedValueOnce({
+          stdout: '{"loggedIn":true,"authMethod":"api_key"}',
+          stderr: '',
+        });
+
+      // GCS never responds — simulates slow/hanging network.
+      // Returns proper req-like object so httpsGetFollowRedirects doesn't crash,
+      // but never fires the response callback.
+      httpsGet.mockImplementation(() => ({
+        setTimeout: vi.fn(),
+        on: vi.fn(),
+        destroy: vi.fn(),
+      }));
+
+      const statusPromise = service.getStatus();
+
+      // Advance past GET_STATUS_TIMEOUT_MS (30s) — GCS still hanging,
+      // but auth already wrote its result to `r` directly
+      await vi.advanceTimersByTimeAsync(31_000);
+
+      const status = await statusPromise;
+
+      // Auth succeeded even though GCS is hanging
+      expect(status.authLoggedIn).toBe(true);
+      expect(status.authMethod).toBe('api_key');
+      expect(status.installed).toBe(true);
+      expect(status.installedVersion).toBe('2.5.0');
+    });
+
+    it('auth retry works when first attempt fails', async () => {
+      allowConsoleLogs();
+      vi.useFakeTimers();
+
+      vi.mocked(ClaudeBinaryResolver.resolve).mockResolvedValue('/usr/local/bin/claude');
+
+      // --version ok, auth attempt 1 fails, auth attempt 2 succeeds
+      vi.mocked(execCli)
+        .mockResolvedValueOnce({ stdout: '2.5.0', stderr: '' })
+        .mockRejectedValueOnce(new Error('ENOENT stale lock'))
+        .mockResolvedValueOnce({
+          stdout: '{"loggedIn":true,"authMethod":"oauth"}',
+          stderr: '',
+        });
+
+      const statusPromise = service.getStatus();
+
+      // Advance past retry delay (1.5s) + auth timeout + outer timeout
+      await vi.advanceTimersByTimeAsync(31_000);
+
+      const status = await statusPromise;
+
+      expect(status.authLoggedIn).toBe(true);
+      expect(status.authMethod).toBe('oauth');
+    });
+
+    it('auth times out independently when both attempts hang', async () => {
+      allowConsoleLogs();
+      vi.useFakeTimers();
+
+      vi.mocked(ClaudeBinaryResolver.resolve).mockResolvedValue('/usr/local/bin/claude');
+
+      // --version ok, auth hangs forever (never resolves)
+      vi.mocked(execCli)
+        .mockResolvedValueOnce({ stdout: '2.5.0', stderr: '' })
+        .mockReturnValue(new Promise(() => {}));
+
+      const statusPromise = service.getStatus();
+
+      // Advance past AUTH_TOTAL_TIMEOUT_MS (15s) and GET_STATUS_TIMEOUT_MS (30s)
+      await vi.advanceTimersByTimeAsync(31_000);
+
+      const status = await statusPromise;
+
+      // Auth timed out independently → stays false
+      expect(status.authLoggedIn).toBe(false);
+      expect(status.authMethod).toBeNull();
+      // Version was populated before auth started
+      expect(status.installedVersion).toBe('2.5.0');
+    });
+  });
+
   describe('sendProgress with destroyed window', () => {
     it('does not throw when window is destroyed', async () => {
       allowConsoleLogs();
diff --git a/test/main/services/team/ReviewApplierService.test.ts b/test/main/services/team/ReviewApplierService.test.ts
new file mode 100644
index 00000000..21dba9bd
--- /dev/null
+++ b/test/main/services/team/ReviewApplierService.test.ts
@@ -0,0 +1,38 @@
+import { describe, expect, it, vi } from 'vitest';
+
+import { structuredPatch } from 'diff';
+
+import type { SnippetDiff } from '@shared/types';
+
+describe('ReviewApplierService', () => {
+  it('previewReject avoids write-update snippet-level replacement', async () => {
+    const { ReviewApplierService } = await import('@main/services/team/ReviewApplierService');
+    const original = 'hello\nworld\n';
+    const modified = 'HELLO\nworld\n';
+
+    // Sanity: ensure there is at least one hunk for this change
+    const patch = structuredPatch('file', 'file', original, modified);
+    expect(patch.hunks.length).toBeGreaterThan(0);
+
+    const snippets: SnippetDiff[] = [
+      {
+        toolUseId: 't1',
+        filePath: '/tmp/file.txt',
+        toolName: 'Write',
+        type: 'write-update',
+        oldString: '',
+        newString: modified, // full file write
+        replaceAll: false,
+        timestamp: new Date().toISOString(),
+        isError: false,
+      },
+    ];
+
+    const svc = new ReviewApplierService();
+
+    // Preview should restore original content (and must not collapse to empty due to write-update).
+    const preview = await svc.previewReject('/tmp/file.txt', original, modified, [0], snippets);
+    expect(preview.hasConflicts).toBe(false);
+    expect(preview.preview).toBe(original);
+  });
+});
diff --git a/test/main/services/team/TeamMemberLogsFinder.test.ts b/test/main/services/team/TeamMemberLogsFinder.test.ts
index 2fad859d..39ad0a1a 100644
--- a/test/main/services/team/TeamMemberLogsFinder.test.ts
+++ b/test/main/services/team/TeamMemberLogsFinder.test.ts
@@ -245,4 +245,186 @@ describe('TeamMemberLogsFinder', () => {
     // Full file has 200 messages — must NOT be capped at 50 or 100
     expect(carolLogs[0]?.messageCount).toBe(200);
   });
+
+  it('findLogsForTask does not treat arbitrary "#<id>" as a task reference', async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'claude-team-task-logs-'));
+    setClaudeBasePathOverride(tmpDir);
+
+    const teamName = 't4';
+    const projectPath = '/Users/test/proj4';
+    const projectId = '-Users-test-proj4';
+    const leadSessionId = 's4';
+
+    await fs.mkdir(path.join(tmpDir, 'teams', teamName), { recursive: true });
+    await fs.writeFile(
+      path.join(tmpDir, 'teams', teamName, 'config.json'),
+      JSON.stringify({
+        name: teamName,
+        projectPath,
+        leadSessionId,
+        members: [
+          { name: 'team-lead', agentType: 'team-lead' },
+          { name: 'bob', agentType: 'general-purpose' },
+        ],
+      }),
+      'utf8'
+    );
+
+    const projectRoot = path.join(tmpDir, 'projects', projectId);
+    await fs.mkdir(path.join(projectRoot, leadSessionId, 'subagents'), { recursive: true });
+
+    // Lead session mentions "PR #1" but NOT a task reference
+    await fs.writeFile(
+      path.join(projectRoot, `${leadSessionId}.jsonl`),
+      [
+        JSON.stringify({
+          timestamp: '2026-01-01T00:00:00.000Z',
+          type: 'assistant',
+          message: { role: 'assistant', content: [{ type: 'text', text: 'Fix PR #1 please' }] },
+        }),
+      ].join('\n') + '\n',
+      'utf8'
+    );
+
+    // Subagent session includes a structured taskId reference (should match)
+    await fs.writeFile(
+      path.join(projectRoot, leadSessionId, 'subagents', 'agent-abc111.jsonl'),
+      [
+        JSON.stringify({
+          timestamp: '2026-01-01T00:00:01.000Z',
+          type: 'user',
+          message: { role: 'user', content: 'You are bob, a developer on team "t4" (t4).' },
+        }),
+        JSON.stringify({
+          timestamp: '2026-01-01T00:00:02.000Z',
+          type: 'assistant',
+          message: {
+            role: 'assistant',
+            content: [
+              {
+                type: 'tool_use',
+                name: 'TaskUpdate',
+                input: { taskId: '1', status: 'in_progress' },
+              },
+            ],
+          },
+        }),
+      ].join('\n') + '\n',
+      'utf8'
+    );
+
+    const finder = new TeamMemberLogsFinder();
+    const logs = await finder.findLogsForTask(teamName, '1');
+
+    // Should include the subagent log, but must NOT include the lead session just because it had "PR #1"
+    expect(logs.some((l) => l.kind === 'lead_session')).toBe(false);
+    expect(logs.some((l) => l.kind === 'subagent')).toBe(true);
+  });
+
+  it('findLogsForTask includes only owner sessions overlapping workIntervals', async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'claude-team-task-owner-since-'));
+    setClaudeBasePathOverride(tmpDir);
+
+    const teamName = 't5';
+    const projectPath = '/Users/test/proj5';
+    const projectId = '-Users-test-proj5';
+    const leadSessionId = 's5';
+
+    await fs.mkdir(path.join(tmpDir, 'teams', teamName), { recursive: true });
+    await fs.writeFile(
+      path.join(tmpDir, 'teams', teamName, 'config.json'),
+      JSON.stringify({
+        name: teamName,
+        projectPath,
+        leadSessionId,
+        members: [
+          { name: 'team-lead', agentType: 'team-lead' },
+          { name: 'bob', agentType: 'general-purpose' },
+          { name: 'alice', agentType: 'general-purpose' },
+        ],
+      }),
+      'utf8'
+    );
+
+    const projectRoot = path.join(tmpDir, 'projects', projectId);
+    await fs.mkdir(path.join(projectRoot, leadSessionId, 'subagents'), { recursive: true });
+
+    // Alice file references taskId 10 via structured tool input (so results is non-empty).
+    await fs.writeFile(
+      path.join(projectRoot, leadSessionId, 'subagents', 'agent-alice10.jsonl'),
+      [
+        JSON.stringify({
+          timestamp: '2026-01-01T00:00:01.000Z',
+          type: 'user',
+          message: { role: 'user', content: 'You are alice, a developer on team "t5" (t5).' },
+        }),
+        JSON.stringify({
+          timestamp: '2026-01-01T00:00:02.000Z',
+          type: 'assistant',
+          message: {
+            role: 'assistant',
+            content: [
+              { type: 'tool_use', name: 'TaskUpdate', input: { taskId: '10', status: 'pending' } },
+            ],
+          },
+        }),
+      ].join('\n') + '\n',
+      'utf8'
+    );
+
+    // Bob has an old session (should NOT be pulled in by owner include).
+    await fs.writeFile(
+      path.join(projectRoot, leadSessionId, 'subagents', 'agent-bob-old.jsonl'),
+      [
+        JSON.stringify({
+          timestamp: '2025-12-31T00:00:00.000Z',
+          type: 'user',
+          message: { role: 'user', content: 'You are bob, a developer on team "t5" (t5).' },
+        }),
+        JSON.stringify({
+          timestamp: '2025-12-31T00:00:01.000Z',
+          type: 'assistant',
+          message: { role: 'assistant', content: [{ type: 'text', text: 'Old work' }] },
+        }),
+      ].join('\n') + '\n',
+      'utf8'
+    );
+
+    // Bob has a recent session within workIntervals (should be included).
+    await fs.writeFile(
+      path.join(projectRoot, leadSessionId, 'subagents', 'agent-bob-new.jsonl'),
+      [
+        JSON.stringify({
+          timestamp: '2026-01-01T12:00:00.000Z',
+          type: 'user',
+          message: { role: 'user', content: 'You are bob, a developer on team "t5" (t5).' },
+        }),
+        JSON.stringify({
+          timestamp: '2026-01-01T12:00:01.000Z',
+          type: 'assistant',
+          message: { role: 'assistant', content: [{ type: 'text', text: 'New work' }] },
+        }),
+      ].join('\n') + '\n',
+      'utf8'
+    );
+
+    const finder = new TeamMemberLogsFinder();
+    const logs = await finder.findLogsForTask(teamName, '10', {
+      owner: 'bob',
+      status: 'in_progress',
+      intervals: [
+        { startedAt: '2026-01-01T10:00:00.000Z', completedAt: '2026-01-01T13:00:00.000Z' },
+      ],
+    });
+
+    const bobDescriptions = logs
+      .filter((l) => l.kind === 'subagent' && l.memberName?.toLowerCase() === 'bob')
+      .map((l) => l.description);
+
+    expect(bobDescriptions.some((d) => d.includes('Old'))).toBe(false);
+    // At least one bob log should be present (the recent one).
+    expect(logs.some((l) => l.kind === 'subagent' && l.memberName?.toLowerCase() === 'bob')).toBe(
+      true
+    );
+  });
 });
diff --git a/test/main/services/team/teamctl.test.ts b/test/main/services/team/teamctl.test.ts
index 0177da94..4e31e447 100644
--- a/test/main/services/team/teamctl.test.ts
+++ b/test/main/services/team/teamctl.test.ts
@@ -717,7 +717,7 @@ describe('teamctl.js', () => {
       });
     });
 
-    it('adds a comment with valid ID and timestamp', () => {
+    it('adds a comment with valid ID, timestamp, and type=regular', () => {
       const { stdout, exitCode } = run(claudeDir, [
         'task',
         'comment',
@@ -735,6 +735,7 @@ describe('teamctl.js', () => {
       expect(comments).toHaveLength(1);
       expect(comments[0].text).toBe('Hello world');
       expect(comments[0].author).toBe('alice');
+      expect(comments[0].type).toBe('regular');
       expect(String(comments[0].id)).toMatch(UUID_RE);
       expect(String(comments[0].createdAt)).toMatch(ISO_RE);
     });
@@ -753,7 +754,7 @@ describe('teamctl.js', () => {
       expect(readInbox(claudeDir, 'bob').length).toBe(1); // still 1
     });
 
-    it('multiple comments accumulate with unique IDs', () => {
+    it('multiple comments accumulate with unique IDs and type=regular', () => {
       run(claudeDir, ['task', 'comment', '1', '--text', 'First', '--from', 'alice']);
       run(claudeDir, ['task', 'comment', '1', '--text', 'Second', '--from', 'bob']);
       run(claudeDir, ['task', 'comment', '1', '--text', 'Third', '--from', 'alice']);
@@ -763,6 +764,7 @@ describe('teamctl.js', () => {
       expect(comments.map((c) => c.text)).toEqual(['First', 'Second', 'Third']);
       expect(comments.map((c) => c.author)).toEqual(['alice', 'bob', 'alice']);
       expect(new Set(comments.map((c) => c.id)).size).toBe(3);
+      expect(comments.every((c) => c.type === 'regular')).toBe(true);
     });
 
     it('comment on task without comments array initializes it', () => {
@@ -1283,6 +1285,83 @@ describe('teamctl.js', () => {
       expect(exitCode).not.toBe(0);
       expect(stderr).toContain('Usage');
     });
+
+    it('approve records review_approved comment in task.comments', () => {
+      run(claudeDir, ['review', 'approve', '1', '--from', 'alice']);
+      const task = readTask(claudeDir, '1');
+      const comments = task.comments as Record<string, unknown>[];
+      expect(comments).toHaveLength(1);
+      expect(comments[0].type).toBe('review_approved');
+      expect(comments[0].author).toBe('alice');
+      expect(comments[0].text).toBe('Approved');
+      expect(String(comments[0].id)).toMatch(UUID_RE);
+      expect(String(comments[0].createdAt)).toMatch(ISO_RE);
+    });
+
+    it('approve records review_approved comment with --note text', () => {
+      run(claudeDir, [
+        'review',
+        'approve',
+        '1',
+        '--notify-owner',
+        '--from',
+        'alice',
+        '--note',
+        'Looks great!',
+      ]);
+      const comments = readTask(claudeDir, '1').comments as Record<string, unknown>[];
+      expect(comments).toHaveLength(1);
+      expect(comments[0].type).toBe('review_approved');
+      expect(comments[0].text).toBe('Looks great!');
+    });
+
+    it('request-changes records review_request comment in task.comments', () => {
+      run(claudeDir, [
+        'review',
+        'request-changes',
+        '1',
+        '--comment',
+        'Fix the edge case',
+        '--from',
+        'alice',
+      ]);
+      const comments = readTask(claudeDir, '1').comments as Record<string, unknown>[];
+      expect(comments).toHaveLength(1);
+      expect(comments[0].type).toBe('review_request');
+      expect(comments[0].author).toBe('alice');
+      expect(comments[0].text).toBe('Fix the edge case');
+      expect(String(comments[0].id)).toMatch(UUID_RE);
+      expect(String(comments[0].createdAt)).toMatch(ISO_RE);
+    });
+
+    it('request-changes without --comment records default text as review_request', () => {
+      run(claudeDir, ['review', 'request-changes', '1', '--from', 'alice']);
+      const comments = readTask(claudeDir, '1').comments as Record<string, unknown>[];
+      expect(comments).toHaveLength(1);
+      expect(comments[0].type).toBe('review_request');
+      expect(comments[0].text).toBe('Reviewer requested changes.');
+    });
+
+    it('review comments preserve existing task comments', () => {
+      // Add a regular comment first
+      run(claudeDir, ['task', 'comment', '1', '--text', 'Working on it', '--from', 'bob']);
+      // Then request changes
+      run(claudeDir, [
+        'review',
+        'request-changes',
+        '1',
+        '--comment',
+        'Needs tests',
+        '--from',
+        'alice',
+      ]);
+      const comments = readTask(claudeDir, '1').comments as Record<string, unknown>[];
+      expect(comments).toHaveLength(2);
+      expect(comments[0].type).toBe('regular');
+      expect(comments[0].text).toBe('Working on it');
+      expect(comments[1].type).toBe('review_request');
+      expect(comments[1].text).toBe('Needs tests');
+    });
   });
 
   // =========================================================================
@@ -1824,8 +1903,8 @@ describe('teamctl.js', () => {
       expect(comments[0].text).toBe('Hello');
     });
 
-    // --- reviewApprove without --notify-owner creates NO inbox ---
-    it('review approve without --notify-owner does NOT create inbox', () => {
+    // --- reviewApprove without --notify-owner creates NO inbox but DOES record comment ---
+    it('review approve without --notify-owner does NOT create inbox but records comment', () => {
       writeTask(claudeDir, '1', {
         id: '1',
         subject: 'Feature',
@@ -1835,10 +1914,14 @@ describe('teamctl.js', () => {
       run(claudeDir, ['kanban', 'set-column', '1', 'review']);
       run(claudeDir, ['review', 'approve', '1']); // no --notify-owner
       expect(readInbox(claudeDir, 'bob')).toEqual([]);
+      // Comment is still recorded
+      const comments = readTask(claudeDir, '1').comments as Record<string, unknown>[];
+      expect(comments).toHaveLength(1);
+      expect(comments[0].type).toBe('review_approved');
     });
 
-    // --- request-changes: verify ALL three side effects ---
-    it('review request-changes: kanban cleared + status in_progress + inbox sent', () => {
+    // --- request-changes: verify ALL four side effects ---
+    it('review request-changes: kanban cleared + status in_progress + comment recorded + inbox sent', () => {
       writeTask(claudeDir, '1', {
         id: '1',
         subject: 'PR',
@@ -1859,7 +1942,13 @@ describe('teamctl.js', () => {
       expect((readKanban(claudeDir).tasks as Record<string, unknown>)['1']).toBeUndefined();
       // 2) Status changed to in_progress
       expect(readTask(claudeDir, '1').status).toBe('in_progress');
-      // 3) Inbox message sent
+      // 3) Review comment recorded
+      const comments = readTask(claudeDir, '1').comments as Record<string, unknown>[];
+      expect(comments).toHaveLength(1);
+      expect(comments[0].type).toBe('review_request');
+      expect(comments[0].author).toBe('alice');
+      expect(comments[0].text).toBe('Missing tests');
+      // 4) Inbox message sent
       const inbox = readInbox(claudeDir, 'bob') as Record<string, unknown>[];
       expect(inbox).toHaveLength(1);
       expect(inbox[0].from).toBe('alice');
@@ -2249,8 +2338,8 @@ describe('teamctl.js', () => {
       expect(after[0].label).toBe('server-1');
     });
 
-    // --- review approve also writes to kanban (column=approved) ---
-    it('review approve sets kanban column to approved with movedAt', () => {
+    // --- review approve also writes to kanban (column=approved) + comment ---
+    it('review approve sets kanban column to approved with movedAt and records comment', () => {
       writeTask(claudeDir, '1', {
         id: '1',
         subject: 'PR task',
@@ -2262,6 +2351,10 @@ describe('teamctl.js', () => {
       const entry = (readKanban(claudeDir).tasks as Record<string, Record<string, unknown>>)['1'];
       expect(entry.column).toBe('approved');
       expect(String(entry.movedAt)).toMatch(ISO_RE);
+      // Review comment recorded
+      const comments = readTask(claudeDir, '1').comments as Record<string, unknown>[];
+      expect(comments).toHaveLength(1);
+      expect(comments[0].type).toBe('review_approved');
     });
 
     // --- Task create without --description defaults to subject ---
diff --git a/test/main/services/team/teamctlRelationships.test.ts b/test/main/services/team/teamctlRelationships.test.ts
new file mode 100644
index 00000000..4538b49c
--- /dev/null
+++ b/test/main/services/team/teamctlRelationships.test.ts
@@ -0,0 +1,296 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const hoisted = vi.hoisted(() => {
+  const files = new Map<string, string>();
+
+  const norm = (p: string): string => p.replace(/\\/g, '/');
+
+  const readFile = vi.fn(async (filePath: string) => {
+    const data = files.get(norm(filePath));
+    if (data === undefined) {
+      const error = new Error('ENOENT') as NodeJS.ErrnoException;
+      error.code = 'ENOENT';
+      throw error;
+    }
+    return data;
+  });
+
+  const atomicWrite = vi.fn(async (filePath: string, data: string) => {
+    files.set(norm(filePath), data);
+  });
+
+  return { files, readFile, atomicWrite, norm };
+});
+
+vi.mock('fs', () => ({
+  promises: {
+    readFile: hoisted.readFile,
+    mkdir: vi.fn(async () => undefined),
+    access: vi.fn(async () => {
+      const error = new Error('ENOENT') as NodeJS.ErrnoException;
+      error.code = 'ENOENT';
+      throw error;
+    }),
+  },
+  constants: { F_OK: 0 },
+}));
+
+vi.mock('../../../../src/main/utils/pathDecoder', () => ({
+  getTasksBasePath: () => '/mock/tasks',
+}));
+
+vi.mock('../../../../src/main/services/team/atomicWrite', () => ({
+  atomicWriteAsync: hoisted.atomicWrite,
+}));
+
+import { TeamTaskWriter } from '../../../../src/main/services/team/TeamTaskWriter';
+
+function setTask(teamName: string, id: string, data: Record<string, unknown>): void {
+  const taskPath = `/mock/tasks/${teamName}/${id}.json`;
+  hoisted.files.set(
+    taskPath,
+    JSON.stringify({ id, status: 'pending', blocks: [], blockedBy: [], ...data })
+  );
+}
+
+function getTask(teamName: string, id: string): Record<string, unknown> {
+  const taskPath = `/mock/tasks/${teamName}/${id}.json`;
+  const raw = hoisted.files.get(taskPath);
+  if (!raw) throw new Error(`Task ${id} not found in mock files`);
+  return JSON.parse(raw) as Record<string, unknown>;
+}
+
+describe('TeamTaskWriter — addRelationship', () => {
+  const writer = new TeamTaskWriter();
+  const team = 'test-team';
+
+  beforeEach(() => {
+    hoisted.files.clear();
+    hoisted.readFile.mockClear();
+    hoisted.atomicWrite.mockClear();
+  });
+
+  describe('blockedBy', () => {
+    it('adds blockedBy to task and blocks to target', async () => {
+      setTask(team, '1', { subject: 'Setup' });
+      setTask(team, '2', { subject: 'Build' });
+
+      await writer.addRelationship(team, '2', '1', 'blockedBy');
+
+      const task2 = getTask(team, '2');
+      const task1 = getTask(team, '1');
+      expect(task2.blockedBy).toEqual(['1']);
+      expect(task1.blocks).toEqual(['2']);
+    });
+
+    it('is idempotent — does not duplicate entries', async () => {
+      setTask(team, '1', { subject: 'Setup' });
+      setTask(team, '2', { subject: 'Build', blockedBy: ['1'] });
+      setTask(team, '1', { subject: 'Setup', blocks: ['2'] });
+
+      await writer.addRelationship(team, '2', '1', 'blockedBy');
+
+      const task2 = getTask(team, '2');
+      const task1 = getTask(team, '1');
+      expect(task2.blockedBy).toEqual(['1']);
+      expect(task1.blocks).toEqual(['2']);
+    });
+  });
+
+  describe('blocks', () => {
+    it('delegates to reverse blockedBy', async () => {
+      setTask(team, '1', { subject: 'Setup' });
+      setTask(team, '2', { subject: 'Build' });
+
+      await writer.addRelationship(team, '1', '2', 'blocks');
+
+      const task1 = getTask(team, '1');
+      const task2 = getTask(team, '2');
+      expect(task1.blocks).toEqual(['2']);
+      expect(task2.blockedBy).toEqual(['1']);
+    });
+  });
+
+  describe('related', () => {
+    it('adds bidirectional related links', async () => {
+      setTask(team, '3', { subject: 'Frontend' });
+      setTask(team, '4', { subject: 'Backend' });
+
+      await writer.addRelationship(team, '3', '4', 'related');
+
+      const task3 = getTask(team, '3');
+      const task4 = getTask(team, '4');
+      expect(task3.related).toEqual(['4']);
+      expect(task4.related).toEqual(['3']);
+    });
+  });
+
+  describe('validation', () => {
+    it('rejects self-reference', async () => {
+      setTask(team, '1', { subject: 'Task' });
+
+      await expect(writer.addRelationship(team, '1', '1', 'blockedBy')).rejects.toThrow(
+        'Cannot link a task to itself'
+      );
+    });
+
+    it('rejects non-existent task', async () => {
+      setTask(team, '1', { subject: 'Task' });
+
+      await expect(writer.addRelationship(team, '1', '999', 'blockedBy')).rejects.toThrow(
+        'Task not found: 999'
+      );
+    });
+
+    it('rejects non-existent source task', async () => {
+      setTask(team, '1', { subject: 'Task' });
+
+      await expect(writer.addRelationship(team, '999', '1', 'blockedBy')).rejects.toThrow(
+        'Task not found: 999'
+      );
+    });
+
+    it('rejects self-reference via blocks type (delegation preserves check)', async () => {
+      setTask(team, '1', { subject: 'Task' });
+
+      await expect(writer.addRelationship(team, '1', '1', 'blocks')).rejects.toThrow(
+        'Cannot link a task to itself'
+      );
+    });
+
+    it('rejects self-reference via related type', async () => {
+      setTask(team, '1', { subject: 'Task' });
+
+      await expect(writer.addRelationship(team, '1', '1', 'related')).rejects.toThrow(
+        'Cannot link a task to itself'
+      );
+    });
+  });
+
+  describe('circular dependency detection', () => {
+    it('detects direct cycle: A blocked-by B, then B blocked-by A', async () => {
+      setTask(team, '1', { subject: 'A', blockedBy: ['2'] });
+      setTask(team, '2', { subject: 'B', blocks: ['1'] });
+
+      await expect(writer.addRelationship(team, '2', '1', 'blockedBy')).rejects.toThrow(
+        'Circular dependency'
+      );
+    });
+
+    it('allows redundant blockedBy (A→B→C, then C blocked-by A is redundant, not circular)', async () => {
+      // #3 already depends on #1 transitively (3→2→1)
+      // Adding direct #3 blockedBy #1 is redundant but NOT a cycle
+      setTask(team, '1', { subject: 'A' });
+      setTask(team, '2', { subject: 'B', blockedBy: ['1'] });
+      setTask(team, '3', { subject: 'C', blockedBy: ['2'] });
+
+      // Should succeed — no cycle
+      await writer.addRelationship(team, '3', '1', 'blockedBy');
+      const task3 = getTask(team, '3');
+      expect(task3.blockedBy).toContain('1');
+    });
+
+    it('detects transitive cycle when closing the loop', async () => {
+      // Chain: #3 blockedBy #2, #2 blockedBy #1
+      // Trying: #1 blockedBy #3 — would create cycle 1→3→2→1
+      setTask(team, '1', { subject: 'A' });
+      setTask(team, '2', { subject: 'B', blockedBy: ['1'] });
+      setTask(team, '3', { subject: 'C', blockedBy: ['2'] });
+
+      await expect(writer.addRelationship(team, '1', '3', 'blockedBy')).rejects.toThrow(
+        'Circular dependency'
+      );
+    });
+  });
+});
+
+describe('TeamTaskWriter — removeRelationship', () => {
+  const writer = new TeamTaskWriter();
+  const team = 'test-team';
+
+  beforeEach(() => {
+    hoisted.files.clear();
+    hoisted.readFile.mockClear();
+    hoisted.atomicWrite.mockClear();
+  });
+
+  describe('blockedBy', () => {
+    it('removes blockedBy from task and blocks from target', async () => {
+      setTask(team, '1', { subject: 'Setup', blocks: ['2'] });
+      setTask(team, '2', { subject: 'Build', blockedBy: ['1'] });
+
+      await writer.removeRelationship(team, '2', '1', 'blockedBy');
+
+      const task2 = getTask(team, '2');
+      const task1 = getTask(team, '1');
+      expect(task2.blockedBy).toEqual([]);
+      expect(task1.blocks).toEqual([]);
+    });
+
+    it('handles missing target gracefully', async () => {
+      setTask(team, '2', { subject: 'Build', blockedBy: ['1'] });
+
+      await writer.removeRelationship(team, '2', '1', 'blockedBy');
+
+      const task2 = getTask(team, '2');
+      expect(task2.blockedBy).toEqual([]);
+    });
+  });
+
+  describe('blocks', () => {
+    it('delegates to reverse blockedBy removal', async () => {
+      setTask(team, '1', { subject: 'Setup', blocks: ['2'] });
+      setTask(team, '2', { subject: 'Build', blockedBy: ['1'] });
+
+      await writer.removeRelationship(team, '1', '2', 'blocks');
+
+      const task1 = getTask(team, '1');
+      const task2 = getTask(team, '2');
+      expect(task1.blocks).toEqual([]);
+      expect(task2.blockedBy).toEqual([]);
+    });
+  });
+
+  describe('related', () => {
+    it('removes bidirectional related links', async () => {
+      setTask(team, '3', { subject: 'Frontend', related: ['4'] });
+      setTask(team, '4', { subject: 'Backend', related: ['3'] });
+
+      await writer.removeRelationship(team, '3', '4', 'related');
+
+      const task3 = getTask(team, '3');
+      const task4 = getTask(team, '4');
+      expect(task3.related).toEqual([]);
+      expect(task4.related).toEqual([]);
+    });
+
+    it('handles missing target gracefully', async () => {
+      setTask(team, '3', { subject: 'Frontend', related: ['4'] });
+
+      await writer.removeRelationship(team, '3', '4', 'related');
+
+      const task3 = getTask(team, '3');
+      expect(task3.related).toEqual([]);
+    });
+  });
+
+  describe('validation', () => {
+    it('rejects non-existent source task', async () => {
+      await expect(writer.removeRelationship(team, '999', '1', 'blockedBy')).rejects.toThrow(
+        'Task not found: 999'
+      );
+    });
+
+    it('is a no-op when removing a relationship that does not exist', async () => {
+      setTask(team, '1', { subject: 'A', blocks: ['3'] });
+      setTask(team, '2', { subject: 'B' });
+
+      // Task 1 has no blockedBy referencing task 2 — should not throw
+      await writer.removeRelationship(team, '1', '2', 'blockedBy');
+
+      const task1 = getTask(team, '1');
+      expect(task1.blockedBy).toEqual([]);
+      expect(task1.blocks).toEqual(['3']); // other relationships preserved
+    });
+  });
+});
diff --git a/test/main/utils/atomicWrite.test.ts b/test/main/utils/atomicWrite.test.ts
index f4a6ffef..14137c1a 100644
--- a/test/main/utils/atomicWrite.test.ts
+++ b/test/main/utils/atomicWrite.test.ts
@@ -30,7 +30,7 @@ const mockRename = vi.mocked(fs.promises.rename);
 const mockCopyFile = vi.mocked(fs.promises.copyFile);
 const mockUnlink = vi.mocked(fs.promises.unlink);
 
-const TARGET_PATH = '/Users/test/project/src/index.ts';
+const TARGET_PATH = path.resolve('/Users/test/project/src/index.ts');
 const TARGET_DIR = path.dirname(TARGET_PATH);
 const CONTENT = 'export const hello = "world";';
 
@@ -65,7 +65,8 @@ describe('atomicWriteAsync', () => {
     // writeFile should be called with a tmp path in the same directory
     expect(mockWriteFile).toHaveBeenCalledTimes(1);
     const tmpPath = getTmpPath();
-    expect(tmpPath).toMatch(new RegExp(`^${TARGET_DIR}/\\.tmp\\.[a-f0-9-]+$`));
+    const escapedDir = TARGET_DIR.replace(/[\\]/g, '\\\\');
+    expect(tmpPath).toMatch(new RegExp(`^${escapedDir}[/\\\\]\\.tmp\\.[a-f0-9-]+$`));
 
     // rename from tmp to target
     expect(mockRename).toHaveBeenCalledWith(tmpPath, TARGET_PATH);
diff --git a/test/main/utils/pathValidation.test.ts b/test/main/utils/pathValidation.test.ts
index 1423b086..dcaf8e47 100644
--- a/test/main/utils/pathValidation.test.ts
+++ b/test/main/utils/pathValidation.test.ts
@@ -223,14 +223,18 @@ describe('pathValidation', () => {
       it('should expand ~ to home directory for paths within ~/.claude', () => {
         const result = validateFilePath('~/.claude/projects/test.jsonl', null);
         expect(result.valid).toBe(true);
-        expect(result.normalizedPath).toBe(path.join(homeDir, '.claude', 'projects', 'test.jsonl'));
+        expect(result.normalizedPath).toBe(
+          path.resolve(path.join(homeDir, '.claude', 'projects', 'test.jsonl'))
+        );
       });
 
       it('should expand ~ to home directory for project paths', () => {
         const projectInHome = path.join(homeDir, 'my-project');
         const result = validateFilePath('~/my-project/src/index.ts', projectInHome);
         expect(result.valid).toBe(true);
-        expect(result.normalizedPath).toBe(path.join(projectInHome, 'src', 'index.ts'));
+        expect(result.normalizedPath).toBe(
+          path.resolve(path.join(projectInHome, 'src', 'index.ts'))
+        );
       });
 
       it('should reject tilde paths to sensitive files', () => {
@@ -250,7 +254,7 @@ describe('pathValidation', () => {
     it('should expand tilde in paths', () => {
       const result = validateOpenPath('~/.claude', null);
       expect(result.valid).toBe(true);
-      expect(result.normalizedPath).toBe(path.normalize(claudeDir));
+      expect(result.normalizedPath).toBe(path.resolve(claudeDir));
     });
 
     it('should reject sensitive files', () => {
diff --git a/test/renderer/components/team/editor/fileIcons.test.ts b/test/renderer/components/team/editor/fileIcons.test.ts
index 66debd16..3cab4a55 100644
--- a/test/renderer/components/team/editor/fileIcons.test.ts
+++ b/test/renderer/components/team/editor/fileIcons.test.ts
@@ -1,88 +1,154 @@
 /**
- * Tests for fileIcons utility — extension-to-icon mapping.
+ * Tests for fileIcons utility — extension-to-icon mapping with Devicon support.
  */
 
 import { describe, expect, it } from 'vitest';
 
-import { getFileIcon } from '@renderer/components/team/editor/fileIcons';
+import { getDeviconUrl, getFileIcon } from '@renderer/components/team/editor/fileIcons';
 
 describe('getFileIcon', () => {
   it('returns TypeScript icon for .ts files', () => {
     const info = getFileIcon('index.ts');
     expect(info.color).toBe('#3178c6');
+    expect(info.deviconSlug).toBe('typescript');
   });
 
   it('returns TypeScript icon for .tsx files', () => {
     const info = getFileIcon('App.tsx');
     expect(info.color).toBe('#3178c6');
+    expect(info.deviconSlug).toBe('react');
   });
 
   it('returns JavaScript icon for .js files', () => {
     const info = getFileIcon('app.js');
     expect(info.color).toBe('#f7df1e');
+    expect(info.deviconSlug).toBe('javascript');
   });
 
   it('returns JSON icon for .json files', () => {
     const info = getFileIcon('package.json');
     // package.json has special mapping
     expect(info.color).toBe('#cb3837');
+    expect(info.deviconSlug).toBe('nodejs');
   });
 
   it('returns markdown icon for .md files', () => {
     const info = getFileIcon('README.md');
     expect(info.color).toBe('#519aba');
+    expect(info.deviconSlug).toBe('markdown');
   });
 
   it('returns Python icon for .py files', () => {
     const info = getFileIcon('main.py');
     expect(info.color).toBe('#3572a5');
+    expect(info.deviconSlug).toBe('python');
   });
 
   it('returns Rust icon for .rs files', () => {
     const info = getFileIcon('lib.rs');
     expect(info.color).toBe('#dea584');
+    expect(info.deviconSlug).toBe('rust');
   });
 
   it('returns default icon for unknown extensions', () => {
     const info = getFileIcon('file.xyz123');
     expect(info.color).toBe('#89949f');
+    expect(info.deviconSlug).toBeUndefined();
   });
 
   it('returns default icon for files without extension', () => {
     const info = getFileIcon('Procfile');
     expect(info.color).toBe('#89949f');
+    expect(info.deviconSlug).toBeUndefined();
   });
 
   it('matches special filenames exactly', () => {
     const docker = getFileIcon('Dockerfile');
     expect(docker.color).toBe('#2496ed');
+    expect(docker.deviconSlug).toBe('docker');
 
     const gitignore = getFileIcon('.gitignore');
     expect(gitignore.color).toBe('#f05032');
+    expect(gitignore.deviconSlug).toBe('git');
 
     const claudeMd = getFileIcon('CLAUDE.md');
     expect(claudeMd.color).toBe('#d97706');
+    expect(claudeMd.deviconSlug).toBeUndefined();
   });
 
   it('prefers filename match over extension match', () => {
     // tsconfig.json should match FILENAME_MAP, not generic .json
     const tsconfig = getFileIcon('tsconfig.json');
     expect(tsconfig.color).toBe('#3178c6');
+    expect(tsconfig.deviconSlug).toBe('typescript');
   });
 
   it('returns lock icon for sensitive files', () => {
     const env = getFileIcon('.env');
     expect(env.color).toBe('#e5a00d');
+    expect(env.deviconSlug).toBeUndefined();
 
     const pnpmLock = getFileIcon('pnpm-lock.yaml');
     expect(pnpmLock.color).toBe('#f69220');
+    expect(pnpmLock.deviconSlug).toBeUndefined();
   });
 
   it('handles image files', () => {
     const png = getFileIcon('logo.png');
     expect(png.color).toBe('#a074c4');
+    expect(png.deviconSlug).toBeUndefined();
 
     const svg = getFileIcon('icon.svg');
     expect(svg.color).toBe('#ffb13b');
+    expect(svg.deviconSlug).toBeUndefined();
+  });
+
+  it('provides devicon slugs for major languages', () => {
+    const cases: [string, string][] = [
+      ['app.go', 'go'],
+      ['lib.rb', 'ruby'],
+      ['Main.java', 'java'],
+      ['style.css', 'css3'],
+      ['page.html', 'html5'],
+      ['Component.vue', 'vuejs'],
+      ['App.svelte', 'svelte'],
+      ['main.dart', 'dart'],
+      ['app.swift', 'swift'],
+      ['main.php', 'php'],
+      ['main.kt', 'kotlin'],
+      ['main.scala', 'scala'],
+      ['app.ex', 'elixir'],
+      ['query.graphql', 'graphql'],
+    ];
+
+    for (const [fileName, expectedSlug] of cases) {
+      const info = getFileIcon(fileName);
+      expect(info.deviconSlug, `Expected ${fileName} to have slug "${expectedSlug}"`).toBe(
+        expectedSlug
+      );
+    }
+  });
+
+  it('provides devicon slugs for special config files', () => {
+    expect(getFileIcon('vite.config.ts').deviconSlug).toBe('vitejs');
+    expect(getFileIcon('docker-compose.yml').deviconSlug).toBe('docker');
+    expect(getFileIcon('.eslintrc').deviconSlug).toBe('eslint');
+    expect(getFileIcon('Cargo.toml').deviconSlug).toBe('rust');
+    expect(getFileIcon('go.mod').deviconSlug).toBe('go');
+    expect(getFileIcon('tailwind.config.js').deviconSlug).toBe('tailwindcss');
+  });
+});
+
+describe('getDeviconUrl', () => {
+  it('builds correct CDN URL for a slug', () => {
+    const url = getDeviconUrl('typescript');
+    expect(url).toBe(
+      'https://cdn.jsdelivr.net/gh/devicons/devicon@latest/icons/typescript/typescript-original.svg'
+    );
+  });
+
+  it('works for multi-word slugs', () => {
+    const url = getDeviconUrl('cplusplus');
+    expect(url).toContain('/cplusplus/cplusplus-original.svg');
   });
 });
diff --git a/test/renderer/hooks/useChipDraftPersistence.test.ts b/test/renderer/hooks/useChipDraftPersistence.test.ts
new file mode 100644
index 00000000..83dc778d
--- /dev/null
+++ b/test/renderer/hooks/useChipDraftPersistence.test.ts
@@ -0,0 +1,96 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+// Mock idb-keyval before importing draftStorage
+const store = new Map<string, unknown>();
+
+vi.mock('idb-keyval', () => ({
+  get: vi.fn((key: string) => Promise.resolve(store.get(key) ?? undefined)),
+  set: vi.fn((key: string, value: unknown) => {
+    store.set(key, value);
+    return Promise.resolve();
+  }),
+  del: vi.fn((key: string) => {
+    store.delete(key);
+    return Promise.resolve();
+  }),
+  keys: vi.fn(() => Promise.resolve([...store.keys()])),
+}));
+
+import { draftStorage } from '@renderer/services/draftStorage';
+
+import type { InlineChip } from '@renderer/types/inlineChip';
+
+function makeChip(overrides: Partial<InlineChip> = {}): InlineChip {
+  return {
+    id: 'chip-1',
+    filePath: '/src/auth.ts',
+    fileName: 'auth.ts',
+    fromLine: 10,
+    toLine: 15,
+    codeText: 'const x = 1;',
+    language: 'typescript',
+    ...overrides,
+  };
+}
+
+describe('chip draft persistence via draftStorage', () => {
+  beforeEach(() => {
+    store.clear();
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it('saves and loads chips as JSON', async () => {
+    const chips = [makeChip()];
+    await draftStorage.saveDraft('test:chips', JSON.stringify(chips));
+    const raw = await draftStorage.loadDraft('test:chips');
+    expect(raw).not.toBeNull();
+    const parsed = JSON.parse(raw!);
+    expect(Array.isArray(parsed)).toBe(true);
+    expect(parsed).toHaveLength(1);
+    expect(parsed[0].id).toBe('chip-1');
+    expect(parsed[0].filePath).toBe('/src/auth.ts');
+  });
+
+  it('round-trips multiple chips', async () => {
+    const chips = [
+      makeChip({ id: 'c1', fileName: 'a.ts' }),
+      makeChip({ id: 'c2', fileName: 'b.ts' }),
+    ];
+    await draftStorage.saveDraft('test:chips', JSON.stringify(chips));
+    const raw = await draftStorage.loadDraft('test:chips');
+    const parsed = JSON.parse(raw!);
+    expect(parsed).toHaveLength(2);
+    expect(parsed[0].fileName).toBe('a.ts');
+    expect(parsed[1].fileName).toBe('b.ts');
+  });
+
+  it('deletes chip draft', async () => {
+    await draftStorage.saveDraft('test:chips', JSON.stringify([makeChip()]));
+    await draftStorage.deleteDraft('test:chips');
+    const raw = await draftStorage.loadDraft('test:chips');
+    expect(raw).toBeNull();
+  });
+
+  it('returns null for non-existent key', async () => {
+    const raw = await draftStorage.loadDraft('nonexistent:chips');
+    expect(raw).toBeNull();
+  });
+
+  it('handles invalid JSON gracefully (at consumer level)', async () => {
+    await draftStorage.saveDraft('test:chips', 'not valid json{{{');
+    const raw = await draftStorage.loadDraft('test:chips');
+    // Raw value is returned; consumer (useChipDraftPersistence) handles parse errors
+    expect(raw).toBe('not valid json{{{');
+    expect(() => JSON.parse(raw!)).toThrow();
+  });
+
+  it('handles empty array', async () => {
+    await draftStorage.saveDraft('test:chips', JSON.stringify([]));
+    const raw = await draftStorage.loadDraft('test:chips');
+    const parsed = JSON.parse(raw!);
+    expect(parsed).toEqual([]);
+  });
+});
diff --git a/test/renderer/hooks/useEditorKeyboardShortcuts.test.ts b/test/renderer/hooks/useEditorKeyboardShortcuts.test.ts
index 46b759bf..21dc2c6b 100644
--- a/test/renderer/hooks/useEditorKeyboardShortcuts.test.ts
+++ b/test/renderer/hooks/useEditorKeyboardShortcuts.test.ts
@@ -5,13 +5,12 @@
 
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 
-// Mock @codemirror/search — handler calls openSearchPanel/gotoLine when view exists
+// Mock @codemirror/search — handler calls openSearchPanel when view exists
 vi.mock('@codemirror/search', () => ({
   openSearchPanel: vi.fn(),
-  gotoLine: vi.fn(),
 }));
 
-import { gotoLine, openSearchPanel } from '@codemirror/search';
+import { openSearchPanel } from '@codemirror/search';
 import { createEditorKeyHandler } from '@renderer/hooks/useEditorKeyboardShortcuts';
 
 import type { EditorKeyHandlerDeps } from '@renderer/hooks/useEditorKeyboardShortcuts';
@@ -50,6 +49,7 @@ function createMockDeps(overrides: Partial<EditorKeyHandlerDeps> = {}): EditorKe
     hasUnsavedChanges: vi.fn().mockReturnValue(false),
     onToggleQuickOpen: vi.fn(),
     onToggleSearchPanel: vi.fn(),
+    onToggleGoToLine: vi.fn(),
     onToggleSidebar: vi.fn(),
     onToggleLineWrap: vi.fn(),
     getEditorView: vi.fn().mockReturnValue(null),
@@ -57,9 +57,23 @@ function createMockDeps(overrides: Partial<EditorKeyHandlerDeps> = {}): EditorKe
   };
 }
 
+/** Map a shortcut key to its physical KeyboardEvent.code value. */
+function keyToCode(key: string): string {
+  if (key.length === 1 && /[a-z]/i.test(key)) return `Key${key.toUpperCase()}`;
+  if (key.length === 1 && /[0-9]/.test(key)) return `Digit${key}`;
+  if (key === '[') return 'BracketLeft';
+  if (key === ']') return 'BracketRight';
+  if (key === '\\') return 'Backslash';
+  if (key === ',') return 'Comma';
+  if (key === '.') return 'Period';
+  if (key === '/') return 'Slash';
+  return key; // Tab, Enter, Escape, Arrow*, etc.
+}
+
 function createKeyEvent(key: string, opts: Partial<KeyboardEvent> = {}): KeyboardEvent {
   return new KeyboardEvent('keydown', {
     key,
+    code: keyToCode(key),
     metaKey: opts.metaKey ?? true,
     ctrlKey: opts.ctrlKey ?? false,
     shiftKey: opts.shiftKey ?? false,
@@ -130,12 +144,10 @@ describe('createEditorKeyHandler', () => {
   });
 
   describe('Cmd+G — Go to Line', () => {
-    it('calls gotoLine when editor view exists', () => {
-      const mockView = { dispatch: vi.fn() };
-      deps = createMockDeps({ getEditorView: vi.fn().mockReturnValue(mockView) });
+    it('calls onToggleGoToLine', () => {
       const handler = createEditorKeyHandler(deps);
       handler(createKeyEvent('g'));
-      expect(gotoLine).toHaveBeenCalledWith(mockView);
+      expect(deps.onToggleGoToLine).toHaveBeenCalled();
     });
   });
 
diff --git a/test/renderer/hooks/useFileSuggestions.test.ts b/test/renderer/hooks/useFileSuggestions.test.ts
new file mode 100644
index 00000000..d6966a8e
--- /dev/null
+++ b/test/renderer/hooks/useFileSuggestions.test.ts
@@ -0,0 +1,97 @@
+import { describe, expect, it } from 'vitest';
+
+import { filterFileSuggestions } from '@renderer/hooks/useFileSuggestions';
+
+import type { QuickOpenFile } from '@shared/types/editor';
+
+function file(name: string, relativePath: string, path?: string): QuickOpenFile {
+  return {
+    name,
+    relativePath,
+    path: path ?? `/project/${relativePath}`,
+  };
+}
+
+const FILES: QuickOpenFile[] = [
+  file('index.ts', 'src/index.ts'),
+  file('App.tsx', 'src/App.tsx'),
+  file('test.ts', 'src/test.ts'),
+  file('telemetry.ts', 'src/utils/telemetry.ts'),
+  file('auth.ts', 'src/services/auth.ts'),
+  file('authMiddleware.ts', 'src/middleware/authMiddleware.ts'),
+  file('package.json', 'package.json'),
+  file('README.md', 'README.md'),
+  file('config.ts', 'src/config.ts'),
+  file('database.ts', 'src/services/database.ts'),
+  file('router.ts', 'src/router.ts'),
+  file('types.ts', 'src/types.ts'),
+];
+
+describe('filterFileSuggestions', () => {
+  it('returns empty array for empty query', () => {
+    expect(filterFileSuggestions(FILES, '')).toEqual([]);
+  });
+
+  it('returns empty array for empty file list', () => {
+    expect(filterFileSuggestions([], 'test')).toEqual([]);
+  });
+
+  it('filters by file name', () => {
+    const results = filterFileSuggestions(FILES, 'test');
+    expect(results).toHaveLength(1);
+    expect(results[0].name).toBe('test.ts');
+    expect(results[0].type).toBe('file');
+    expect(results[0].filePath).toBe('/project/src/test.ts');
+    expect(results[0].relativePath).toBe('src/test.ts');
+  });
+
+  it('filters by relative path', () => {
+    const results = filterFileSuggestions(FILES, 'middleware');
+    expect(results).toHaveLength(1);
+    expect(results[0].name).toBe('authMiddleware.ts');
+  });
+
+  it('is case-insensitive', () => {
+    const results = filterFileSuggestions(FILES, 'APP');
+    expect(results).toHaveLength(1);
+    expect(results[0].name).toBe('App.tsx');
+  });
+
+  it('returns multiple matches', () => {
+    const results = filterFileSuggestions(FILES, 'auth');
+    expect(results).toHaveLength(2);
+    expect(results.map((r) => r.name)).toEqual(['auth.ts', 'authMiddleware.ts']);
+  });
+
+  it('matches on name substring', () => {
+    const results = filterFileSuggestions(FILES, 'te');
+    // 'te' matches: test.ts, telemetry.ts, and router.ts (rou-te-r)
+    expect(results.map((r) => r.name)).toEqual(['test.ts', 'telemetry.ts', 'router.ts']);
+  });
+
+  it('limits results to 8', () => {
+    const results = filterFileSuggestions(FILES, 'ts');
+    expect(results.length).toBeLessThanOrEqual(8);
+  });
+
+  it('sets id with file: prefix', () => {
+    const results = filterFileSuggestions(FILES, 'config');
+    expect(results[0].id).toBe('file:/project/src/config.ts');
+  });
+
+  it('sets subtitle to relativePath', () => {
+    const results = filterFileSuggestions(FILES, 'config');
+    expect(results[0].subtitle).toBe('src/config.ts');
+  });
+
+  it('matches partial path segments', () => {
+    const results = filterFileSuggestions(FILES, 'services/');
+    expect(results).toHaveLength(2);
+    expect(results.map((r) => r.name)).toEqual(['auth.ts', 'database.ts']);
+  });
+
+  it('returns results in file list order', () => {
+    const results = filterFileSuggestions(FILES, '.ts');
+    expect(results[0].name).toBe('index.ts');
+  });
+});
diff --git a/test/renderer/types/inlineChip.test.ts b/test/renderer/types/inlineChip.test.ts
new file mode 100644
index 00000000..26df025b
--- /dev/null
+++ b/test/renderer/types/inlineChip.test.ts
@@ -0,0 +1,163 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  CHIP_MARKER,
+  chipDisplayLabel,
+  chipToMarkdown,
+  chipToken,
+  serializeChipsWithText,
+} from '@renderer/types/inlineChip';
+
+import type { InlineChip } from '@renderer/types/inlineChip';
+
+function makeChip(overrides: Partial<InlineChip> = {}): InlineChip {
+  return {
+    id: 'chip-1',
+    filePath: '/src/auth.ts',
+    fileName: 'auth.ts',
+    fromLine: 10,
+    toLine: 15,
+    codeText: 'const x = 1;\nconst y = 2;',
+    language: 'typescript',
+    ...overrides,
+  };
+}
+
+describe('chipDisplayLabel', () => {
+  it('returns fileName:fromLine-toLine for multi-line', () => {
+    const chip = makeChip({ fromLine: 10, toLine: 15 });
+    expect(chipDisplayLabel(chip)).toBe('auth.ts:10-15');
+  });
+
+  it('returns fileName:line for single-line', () => {
+    const chip = makeChip({ fromLine: 42, toLine: 42 });
+    expect(chipDisplayLabel(chip)).toBe('auth.ts:42');
+  });
+
+  it('works with different file names', () => {
+    const chip = makeChip({ fileName: 'index.tsx', fromLine: 1, toLine: 3 });
+    expect(chipDisplayLabel(chip)).toBe('index.tsx:1-3');
+  });
+
+  it('returns just fileName for file-level mention (null lines)', () => {
+    const chip = makeChip({ fromLine: null, toLine: null, codeText: '' });
+    expect(chipDisplayLabel(chip)).toBe('auth.ts');
+  });
+});
+
+describe('chipToken', () => {
+  it('prepends CHIP_MARKER to display label', () => {
+    const chip = makeChip({ fromLine: 10, toLine: 15 });
+    expect(chipToken(chip)).toBe(`${CHIP_MARKER}auth.ts:10-15`);
+  });
+
+  it('uses single-line format when fromLine === toLine', () => {
+    const chip = makeChip({ fromLine: 42, toLine: 42 });
+    expect(chipToken(chip)).toBe(`${CHIP_MARKER}auth.ts:42`);
+  });
+
+  it('omits line range for file-level mention', () => {
+    const chip = makeChip({ fromLine: null, toLine: null, codeText: '' });
+    expect(chipToken(chip)).toBe(`${CHIP_MARKER}auth.ts`);
+  });
+});
+
+describe('chipToMarkdown', () => {
+  it('produces markdown code fence for multi-line', () => {
+    const chip = makeChip({
+      fromLine: 10,
+      toLine: 15,
+      codeText: 'const x = 1;',
+      language: 'typescript',
+    });
+    const md = chipToMarkdown(chip);
+    expect(md).toContain('**auth.ts**');
+    expect(md).toContain('lines 10-15');
+    expect(md).toContain('```typescript');
+    expect(md).toContain('const x = 1;');
+    expect(md).toContain('```');
+  });
+
+  it('produces markdown code fence for single-line', () => {
+    const chip = makeChip({
+      fromLine: 42,
+      toLine: 42,
+      codeText: 'return true;',
+    });
+    const md = chipToMarkdown(chip);
+    expect(md).toContain('line 42');
+    expect(md).not.toContain('lines');
+  });
+
+  it('uses language from chip', () => {
+    const chip = makeChip({ language: 'python', fileName: 'script.py' });
+    expect(chipToMarkdown(chip)).toContain('```python');
+  });
+
+  it('produces file reference for file-level mention', () => {
+    const chip = makeChip({
+      fromLine: null,
+      toLine: null,
+      codeText: '',
+      displayPath: 'src/auth.ts',
+    });
+    const md = chipToMarkdown(chip);
+    expect(md).toBe('**auth.ts** (`src/auth.ts`)');
+    expect(md).not.toContain('```');
+  });
+
+  it('falls back to filePath when displayPath is missing', () => {
+    const chip = makeChip({ fromLine: null, toLine: null, codeText: '' });
+    const md = chipToMarkdown(chip);
+    expect(md).toBe('**auth.ts** (`/src/auth.ts`)');
+  });
+});
+
+describe('serializeChipsWithText', () => {
+  it('returns text unchanged when no chips', () => {
+    expect(serializeChipsWithText('hello world', [])).toBe('hello world');
+  });
+
+  it('replaces chip token with markdown', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `Hello\n${token}\nGoodbye`;
+    const result = serializeChipsWithText(text, [chip]);
+    expect(result).toContain('**auth.ts**');
+    expect(result).toContain('```typescript');
+    expect(result).not.toContain(CHIP_MARKER);
+    expect(result).toContain('Hello');
+    expect(result).toContain('Goodbye');
+  });
+
+  it('handles multiple chips', () => {
+    const chip1 = makeChip({ id: 'c1', fileName: 'a.ts', fromLine: 1, toLine: 3 });
+    const chip2 = makeChip({ id: 'c2', fileName: 'b.ts', fromLine: 10, toLine: 20 });
+    const text = `${chipToken(chip1)}\n${chipToken(chip2)}`;
+    const result = serializeChipsWithText(text, [chip1, chip2]);
+    expect(result).toContain('**a.ts**');
+    expect(result).toContain('**b.ts**');
+    expect(result).not.toContain(CHIP_MARKER);
+  });
+
+  it('preserves text around chips', () => {
+    const chip = makeChip();
+    const text = `Before ${chipToken(chip)} after`;
+    const result = serializeChipsWithText(text, [chip]);
+    expect(result).toContain('Before ');
+    expect(result).toContain(' after');
+  });
+
+  it('serializes file-mention chip as file reference', () => {
+    const chip = makeChip({
+      fromLine: null,
+      toLine: null,
+      codeText: '',
+      displayPath: 'src/auth.ts',
+    });
+    const text = `Check ${chipToken(chip)} please`;
+    const result = serializeChipsWithText(text, [chip]);
+    expect(result).toBe('Check **auth.ts** (`src/auth.ts`) please');
+    expect(result).not.toContain(CHIP_MARKER);
+  });
+});
diff --git a/test/renderer/utils/buildSelectionAction.test.ts b/test/renderer/utils/buildSelectionAction.test.ts
new file mode 100644
index 00000000..70a13811
--- /dev/null
+++ b/test/renderer/utils/buildSelectionAction.test.ts
@@ -0,0 +1,94 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  buildFileAction,
+  buildSelectionAction,
+  getCodeFenceLanguage,
+} from '@renderer/utils/buildSelectionAction';
+
+import type { EditorSelectionInfo } from '@shared/types/editor';
+
+describe('getCodeFenceLanguage', () => {
+  it('maps known extensions', () => {
+    expect(getCodeFenceLanguage('app.ts')).toBe('typescript');
+    expect(getCodeFenceLanguage('index.tsx')).toBe('tsx');
+    expect(getCodeFenceLanguage('main.py')).toBe('python');
+    expect(getCodeFenceLanguage('styles.css')).toBe('css');
+  });
+
+  it('returns empty string for unknown extension', () => {
+    expect(getCodeFenceLanguage('data.xyz')).toBe('');
+    expect(getCodeFenceLanguage('file')).toBe('');
+  });
+});
+
+describe('buildSelectionAction', () => {
+  const info: EditorSelectionInfo = {
+    text: 'const x = 1;',
+    filePath: '/project/src/auth.ts',
+    fromLine: 10,
+    toLine: 15,
+    screenRect: { top: 0, right: 0, bottom: 0 },
+  };
+
+  it('builds action with correct type and file info', () => {
+    const action = buildSelectionAction('createTask', info);
+    expect(action.type).toBe('createTask');
+    expect(action.filePath).toBe('/project/src/auth.ts');
+    expect(action.fromLine).toBe(10);
+    expect(action.toLine).toBe(15);
+    expect(action.selectedText).toBe('const x = 1;');
+  });
+
+  it('formats context with line range', () => {
+    const action = buildSelectionAction('sendMessage', info);
+    expect(action.formattedContext).toContain('**auth.ts**');
+    expect(action.formattedContext).toContain('lines 10-15');
+    expect(action.formattedContext).toContain('```typescript');
+    expect(action.formattedContext).toContain('const x = 1;');
+  });
+
+  it('uses singular "line" for single-line selection', () => {
+    const singleLine: EditorSelectionInfo = { ...info, fromLine: 42, toLine: 42 };
+    const action = buildSelectionAction('createTask', singleLine);
+    expect(action.formattedContext).toContain('line 42');
+    expect(action.formattedContext).not.toContain('lines');
+  });
+});
+
+describe('buildFileAction', () => {
+  it('builds action with null lines, empty selectedText, and displayPath', () => {
+    const action = buildFileAction('createTask', '/project/src/auth.ts', '/project');
+    expect(action.type).toBe('createTask');
+    expect(action.filePath).toBe('/project/src/auth.ts');
+    expect(action.fromLine).toBeNull();
+    expect(action.toLine).toBeNull();
+    expect(action.selectedText).toBe('');
+    expect(action.displayPath).toBe('src/auth.ts');
+  });
+
+  it('uses relative path when inside projectPath', () => {
+    const action = buildFileAction('sendMessage', '/project/src/utils/auth.ts', '/project');
+    expect(action.formattedContext).toBe('**auth.ts** (`src/utils/auth.ts`)');
+  });
+
+  it('uses absolute path when projectPath is null', () => {
+    const action = buildFileAction('sendMessage', '/project/src/auth.ts', null);
+    expect(action.formattedContext).toBe('**auth.ts** (`/project/src/auth.ts`)');
+  });
+
+  it('uses absolute path when projectPath is undefined', () => {
+    const action = buildFileAction('createTask', '/project/src/auth.ts');
+    expect(action.formattedContext).toBe('**auth.ts** (`/project/src/auth.ts`)');
+  });
+
+  it('uses absolute path when file is outside project', () => {
+    const action = buildFileAction('sendMessage', '/other/config.json', '/project');
+    expect(action.formattedContext).toBe('**config.json** (`/other/config.json`)');
+  });
+
+  it('handles file at project root', () => {
+    const action = buildFileAction('createTask', '/project/package.json', '/project');
+    expect(action.formattedContext).toBe('**package.json** (`package.json`)');
+  });
+});
diff --git a/test/renderer/utils/chipUtils.test.ts b/test/renderer/utils/chipUtils.test.ts
new file mode 100644
index 00000000..6e55be71
--- /dev/null
+++ b/test/renderer/utils/chipUtils.test.ts
@@ -0,0 +1,253 @@
+import { describe, expect, it } from 'vitest';
+
+import { chipToken } from '@renderer/types/inlineChip';
+import {
+  createChipFromSelection,
+  findChipBoundary,
+  isInsideChip,
+  reconcileChips,
+  removeChipTokenFromText,
+  snapCursorToChipBoundary,
+} from '@renderer/utils/chipUtils';
+
+import type { InlineChip } from '@renderer/types/inlineChip';
+import type { EditorSelectionAction } from '@shared/types/editor';
+
+function makeChip(overrides: Partial<InlineChip> = {}): InlineChip {
+  return {
+    id: 'chip-test-1',
+    filePath: '/src/auth.ts',
+    fileName: 'auth.ts',
+    fromLine: 10,
+    toLine: 15,
+    codeText: 'const x = 1;',
+    language: 'typescript',
+    ...overrides,
+  };
+}
+
+function makeAction(overrides: Partial<EditorSelectionAction> = {}): EditorSelectionAction {
+  return {
+    type: 'sendMessage',
+    filePath: '/src/auth.ts',
+    fromLine: 10,
+    toLine: 15,
+    selectedText: 'const x = 1;',
+    formattedContext: '**auth.ts** (lines 10-15):\n```typescript\nconst x = 1;\n```',
+    ...overrides,
+  };
+}
+
+describe('createChipFromSelection', () => {
+  it('creates a chip from an EditorSelectionAction', () => {
+    const action = makeAction();
+    const chip = createChipFromSelection(action, []);
+    expect(chip).not.toBeNull();
+    expect(chip!.filePath).toBe('/src/auth.ts');
+    expect(chip!.fileName).toBe('auth.ts');
+    expect(chip!.fromLine).toBe(10);
+    expect(chip!.toLine).toBe(15);
+    expect(chip!.codeText).toBe('const x = 1;');
+    expect(chip!.language).toBe('typescript');
+    expect(chip!.id).toMatch(/^chip-/);
+  });
+
+  it('returns null for duplicate (same filePath + lines)', () => {
+    const existing = makeChip();
+    const action = makeAction();
+    expect(createChipFromSelection(action, [existing])).toBeNull();
+  });
+
+  it('allows different line ranges for the same file', () => {
+    const existing = makeChip({ fromLine: 1, toLine: 5 });
+    const action = makeAction({ fromLine: 10, toLine: 15 });
+    expect(createChipFromSelection(action, [existing])).not.toBeNull();
+  });
+
+  it('creates a file-mention chip when selectedText is empty and lines are null', () => {
+    const action = makeAction({
+      selectedText: '',
+      fromLine: null,
+      toLine: null,
+      displayPath: 'src/auth.ts',
+    });
+    const chip = createChipFromSelection(action, []);
+    expect(chip).not.toBeNull();
+    expect(chip!.fromLine).toBeNull();
+    expect(chip!.toLine).toBeNull();
+    expect(chip!.codeText).toBe('');
+    expect(chip!.displayPath).toBe('src/auth.ts');
+    expect(chip!.fileName).toBe('auth.ts');
+  });
+
+  it('deduplicates file-mention chips by filePath', () => {
+    const existing = makeChip({ fromLine: null, toLine: null, codeText: '' });
+    const action = makeAction({ selectedText: '', fromLine: null, toLine: null });
+    expect(createChipFromSelection(action, [existing])).toBeNull();
+  });
+
+  it('creates file-mention chip when fromLine is null', () => {
+    const action = makeAction({ fromLine: null, selectedText: 'code' });
+    const chip = createChipFromSelection(action, []);
+    expect(chip).not.toBeNull();
+    expect(chip!.fromLine).toBeNull();
+  });
+});
+
+describe('findChipBoundary', () => {
+  it('returns boundary when cursor is at chip end', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `Hello ${token} world`;
+    const cursorPos = 6 + token.length; // at end of token
+    const boundary = findChipBoundary(text, [chip], cursorPos);
+    expect(boundary).not.toBeNull();
+    expect(boundary!.start).toBe(6);
+    expect(boundary!.end).toBe(6 + token.length);
+    expect(boundary!.chip).toBe(chip);
+  });
+
+  it('returns boundary when cursor is at chip start', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `Hello ${token} world`;
+    const boundary = findChipBoundary(text, [chip], 6);
+    expect(boundary).not.toBeNull();
+    expect(boundary!.start).toBe(6);
+  });
+
+  it('returns boundary when cursor is inside chip', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `Hello ${token} world`;
+    const boundary = findChipBoundary(text, [chip], 8);
+    expect(boundary).not.toBeNull();
+  });
+
+  it('returns null when cursor is not near any chip', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `Hello ${token} world`;
+    // cursor at beginning
+    expect(findChipBoundary(text, [chip], 0)).toBeNull();
+  });
+
+  it('handles multiple chips', () => {
+    const chip1 = makeChip({ id: 'c1', fileName: 'a.ts', fromLine: 1, toLine: 1 });
+    const chip2 = makeChip({ id: 'c2', fileName: 'b.ts', fromLine: 2, toLine: 2 });
+    const t1 = chipToken(chip1);
+    const t2 = chipToken(chip2);
+    const text = `${t1} ${t2}`;
+    const boundary = findChipBoundary(text, [chip1, chip2], t1.length + 1);
+    expect(boundary).not.toBeNull();
+    expect(boundary!.chip.id).toBe('c2');
+  });
+});
+
+describe('isInsideChip', () => {
+  it('returns true when cursor is strictly inside', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `X${token}Y`;
+    expect(isInsideChip(text, [chip], 3)).toBe(true);
+  });
+
+  it('returns false at chip start boundary', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `X${token}Y`;
+    expect(isInsideChip(text, [chip], 1)).toBe(false);
+  });
+
+  it('returns false at chip end boundary', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `X${token}Y`;
+    expect(isInsideChip(text, [chip], 1 + token.length)).toBe(false);
+  });
+
+  it('returns false outside chip', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `X${token}Y`;
+    expect(isInsideChip(text, [chip], 0)).toBe(false);
+  });
+});
+
+describe('snapCursorToChipBoundary', () => {
+  it('snaps to nearest start when cursor is closer to start', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `X${token}Y`;
+    // position 2 is inside, closer to start (1)
+    const snapped = snapCursorToChipBoundary(text, [chip], 2);
+    expect(snapped).toBe(1);
+  });
+
+  it('snaps to nearest end when cursor is closer to end', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `X${token}Y`;
+    // position close to end
+    const nearEnd = 1 + token.length - 1;
+    const snapped = snapCursorToChipBoundary(text, [chip], nearEnd);
+    expect(snapped).toBe(1 + token.length);
+  });
+
+  it('returns original position if not inside chip', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `X${token}Y`;
+    expect(snapCursorToChipBoundary(text, [chip], 0)).toBe(0);
+  });
+});
+
+describe('reconcileChips', () => {
+  it('keeps chips whose tokens are present', () => {
+    const chip = makeChip();
+    const text = `Hello ${chipToken(chip)} world`;
+    expect(reconcileChips([chip], text)).toEqual([chip]);
+  });
+
+  it('removes chips whose tokens are missing', () => {
+    const chip = makeChip();
+    expect(reconcileChips([chip], 'Hello world')).toEqual([]);
+  });
+
+  it('handles partial removal (only some chips gone)', () => {
+    const chip1 = makeChip({ id: 'c1', fileName: 'a.ts', fromLine: 1, toLine: 1 });
+    const chip2 = makeChip({ id: 'c2', fileName: 'b.ts', fromLine: 2, toLine: 2 });
+    const text = chipToken(chip1); // only chip1 token present
+    const result = reconcileChips([chip1, chip2], text);
+    expect(result).toEqual([chip1]);
+  });
+});
+
+describe('removeChipTokenFromText', () => {
+  it('removes the token from text', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `Hello ${token} world`;
+    expect(removeChipTokenFromText(text, chip)).toBe('Hello  world');
+  });
+
+  it('removes trailing newline', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `${token}\nHello`;
+    expect(removeChipTokenFromText(text, chip)).toBe('Hello');
+  });
+
+  it('does not alter text when token not found', () => {
+    const chip = makeChip();
+    const text = 'Hello world';
+    expect(removeChipTokenFromText(text, chip)).toBe('Hello world');
+  });
+
+  it('removes token from middle of text', () => {
+    const chip = makeChip();
+    const token = chipToken(chip);
+    const text = `A\n${token}\nB`;
+    expect(removeChipTokenFromText(text, chip)).toBe('A\nB');
+  });
+});
diff --git a/test/renderer/utils/keyboardUtils.test.ts b/test/renderer/utils/keyboardUtils.test.ts
index 5303c261..85ed52b0 100644
--- a/test/renderer/utils/keyboardUtils.test.ts
+++ b/test/renderer/utils/keyboardUtils.test.ts
@@ -5,6 +5,7 @@ import {
   getModifierKeyName,
   getModifierKeySymbol,
   isMacOS,
+  physicalKey,
 } from '../../../src/renderer/utils/keyboardUtils';
 
 describe('keyboardUtils', () => {
@@ -158,4 +159,111 @@ describe('keyboardUtils', () => {
       });
     });
   });
+
+  describe('physicalKey', () => {
+    function makeEvent(
+      key: string,
+      code: string,
+      mods: Partial<KeyboardEventInit> = {}
+    ): KeyboardEvent {
+      return new KeyboardEvent('keydown', { key, code, ...mods, bubbles: true, cancelable: true });
+    }
+
+    describe('letter keys — English layout', () => {
+      it('resolves KeyF to f', () => {
+        expect(physicalKey(makeEvent('f', 'KeyF'))).toBe('f');
+      });
+
+      it('resolves KeyW to w', () => {
+        expect(physicalKey(makeEvent('w', 'KeyW'))).toBe('w');
+      });
+
+      it('always returns lowercase even with Shift', () => {
+        expect(physicalKey(makeEvent('F', 'KeyF', { shiftKey: true }))).toBe('f');
+      });
+    });
+
+    describe('letter keys — Russian layout', () => {
+      it('resolves Cyrillic а (physical F) to f', () => {
+        expect(physicalKey(makeEvent('а', 'KeyF'))).toBe('f');
+      });
+
+      it('resolves Cyrillic ц (physical W) to w', () => {
+        expect(physicalKey(makeEvent('ц', 'KeyW'))).toBe('w');
+      });
+
+      it('resolves Cyrillic з (physical P) to p', () => {
+        expect(physicalKey(makeEvent('з', 'KeyP'))).toBe('p');
+      });
+
+      it('resolves Cyrillic и (physical B) to b', () => {
+        expect(physicalKey(makeEvent('и', 'KeyB'))).toBe('b');
+      });
+
+      it('resolves Cyrillic л (physical K) to k', () => {
+        expect(physicalKey(makeEvent('л', 'KeyK'))).toBe('k');
+      });
+
+      it('resolves Cyrillic ы (physical S) to s', () => {
+        expect(physicalKey(makeEvent('ы', 'KeyS'))).toBe('s');
+      });
+    });
+
+    describe('digit keys', () => {
+      it('resolves Digit1 to 1', () => {
+        expect(physicalKey(makeEvent('1', 'Digit1'))).toBe('1');
+      });
+
+      it('resolves Digit9 to 9', () => {
+        expect(physicalKey(makeEvent('9', 'Digit9'))).toBe('9');
+      });
+
+      it('resolves shifted digit (e.g. !) back to digit', () => {
+        expect(physicalKey(makeEvent('!', 'Digit1', { shiftKey: true }))).toBe('1');
+      });
+    });
+
+    describe('punctuation keys', () => {
+      it('resolves BracketLeft to [', () => {
+        expect(physicalKey(makeEvent('[', 'BracketLeft'))).toBe('[');
+      });
+
+      it('resolves Russian х (physical [) to [', () => {
+        expect(physicalKey(makeEvent('х', 'BracketLeft'))).toBe('[');
+      });
+
+      it('resolves BracketRight to ]', () => {
+        expect(physicalKey(makeEvent(']', 'BracketRight'))).toBe(']');
+      });
+
+      it('resolves Backslash to \\', () => {
+        expect(physicalKey(makeEvent('\\', 'Backslash'))).toBe('\\');
+      });
+
+      it('resolves Comma to ,', () => {
+        expect(physicalKey(makeEvent(',', 'Comma'))).toBe(',');
+        // Russian: physical , produces б
+        expect(physicalKey(makeEvent('б', 'Comma'))).toBe(',');
+      });
+    });
+
+    describe('special keys (pass-through)', () => {
+      it('returns event.key for Tab', () => {
+        expect(physicalKey(makeEvent('Tab', 'Tab'))).toBe('Tab');
+      });
+
+      it('returns event.key for Enter', () => {
+        expect(physicalKey(makeEvent('Enter', 'Enter'))).toBe('Enter');
+      });
+
+      it('returns event.key for Escape', () => {
+        expect(physicalKey(makeEvent('Escape', 'Escape'))).toBe('Escape');
+      });
+
+      it('returns event.key for Arrow keys', () => {
+        expect(physicalKey(makeEvent('ArrowUp', 'ArrowUp'))).toBe('ArrowUp');
+        expect(physicalKey(makeEvent('ArrowDown', 'ArrowDown'))).toBe('ArrowDown');
+      });
+    });
+  });
 });