dsh-gitbash-shell 0.16.1 → 0.17.0

package/README.md

@@ -157,10 +157,18 @@ PTC/创造及用户自建模式一律覆盖。
 - **提示词源头替换**:组装期(`system-prompt/assemble`)把官方提示词 sections / contexts /
   variables 里的 Windows 绝对路径**原位**改写成 `/c/...`——不增删任何内容、不动工具 schema;
 - **一句话指示**:经 `systemPrompt.context`(order 126)注入全局指示——shell 是 Git for
-  Windows bash,路径用 MSYS 盘根,所有工具都直接接受这种写法;
-- **参数翻译**:`tools/execute` 上把文件工具的路径参数(`file_path` / `path` / `workdir`)由
+  Windows bash,路径用 MSYS 盘根,所有工具都直接接受这种写法——含 `~`、`/tmp`、`/dev/null`、
+  `/usr` 等 bash 原生习惯(v0.17.0 起与 Git Bash 挂载表一致地解析);
+- **参数翻译**:`tools/execute` 上把工具的路径参数(`file_path` / `path` / `workdir`,含 present
+  的嵌套 `files[].path`)由 `/c/...` 翻回 `C:/...` 交给 Node 文件工具;bash 的 `command` 字段
+  不动——那是 Git Bash 母语;**bash 虚拟路径按 Git Bash 挂载表解析(v0.17.0)**:`/tmp` → 用户
+  TEMP、`/dev/null` → Windows NUL 空设备、`~` → 家目录、`/usr` `/bin` `/etc` 等 → Git 安装根,
+  与 bash 写入/读取同一物理位置;glob 的绝对 pattern(`/c/.../*.md`)自动拆成 `path` + 相对
+  `pattern`(原先静默匹配空);
   `/c/...` 翻回 `C:/...` 交给 Node 文件工具;bash 的 `command` 字段不动——那是 Git Bash 母语;
-- **结果回流**:成功结果里的路径元数据(`read`/`write`/`edit` 的 `path`、`glob` 的 `paths[]`、
+- **结果回流**:成功结果里的路径元数据(`read`/`read_image`/`write`/`edit` 的 `path`、`glob` 的
+  `paths[]`、`grep` 的 `matches[].path`、`present` 的 `files[].path`)改写回 MSYS 形式,其中落在
+  用户 TEMP 下的路径回显为 `/tmp/...`(与 bash 的 `$TMP` 一致);文件内容与错误结果不动;
   `grep` 的 `matches[].path`)改写回 MSYS 形式;文件内容与错误结果不动;
 - **运行时事实**:向官方 `dsh-shell-env` 注册表贡献 `DSH_PATH_DIALECT=msys`,模型可在执行时
   核验(随开关实时生效)。

package/README_EN.md

@@ -99,11 +99,20 @@ While it is on (Windows only), `posixPaths` gates all of the following:
   /c/... form — nothing is added or removed, and tool schemas stay untouched;
 - **One-sentence directive**: a global directive via `systemPrompt.context` (order 126) — the
   shell is Git for Windows bash, paths use MSYS drive roots, and every tool accepts that form
+  directly — including the bash-native habits (`~`, `/tmp`, `/dev/null`, `/usr`), which resolve
+  exactly as bash itself resolves them (v0.17.0, mirroring the Git Bash mount table);
   directly;
-- **Argument translation**: on `tools/execute` the file tools' path arguments (`file_path` /
+- **Argument translation**: on `tools/execute` the tools' path arguments (`file_path` / `path` /
+  `workdir`, plus present's nested `files[].path`) are translated from /c/... back to C:/... for
+  the Node-backed file tools; a bash command's `command` field is left alone — that is Git Bash's
+  native form; **bash virtual paths resolve through the Git Bash mount table (v0.17.0)**: /tmp is
+  the user TEMP dir, /dev/null the Windows NUL device, ~ the home directory, and /usr /bin /etc
+  live under the Git install root — the same physical locations bash itself reads and writes; an
+  absolute glob pattern (/c/.../*.md) is split into `path` + a relative `pattern` (it used to
+  silently match nothing);
   `path` / `workdir`) are translated from /c/... back to C:/... for the Node-backed file tools;
   a bash command's `command` field is left alone — that is Git Bash's native form;
-- **Result round-trip**: path metadata in successful results (`path` of read/write/edit,
+- **Result round-trip**: path metadata in successful results (`path` of read/read_image/write/edit,
   `paths[]` of glob, `matches[].path` of grep) flows back in the MSYS form; file contents and
   error results are untouched;
 - **Runtime fact**: `DSH_PATH_DIALECT=msys` is contributed to the official `dsh-shell-env`

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-external/dsh-gitbash-shell",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "main": "./src/index.js",
   "description": "Windows 全模式 Git Bash:用 Git for Windows bash 替换 PowerShell 执行器,并物化 standard/minimal/code/cordis 的 Git Bash 变体 preset。双 era 适配 dsh <= 0.1.1(内置 id 'code')与 >= 0.1.2(改名 'ptc'),启动探测自动选择,preset id 永不变。联动:dsh-ptc-cordis-preset(两者同装时 PTC 创造模式自动物化为 Git Bash 版)+ dsh-better-sidebar(终端 UI 标签与模型 terminal_* 工具自动切到 Git Bash)。",
   "engines": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-gitbash-shell",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Windows 上让 agent 的每条 shell 命令改经 Git for Windows bash 执行;物化四个内置预设的 Git Bash 变体,统一 MSYS 盘根路径方言,侧栏终端接管可开关。· Run every agent shell command through Git for Windows bash on Windows; materialize Git Bash variants of the built-in presets, unify the MSYS drive-root path dialect, and adopt the sidebar terminal behind a switch.",
   "type": "module",
   "repository": {

package/src/client.js

@@ -62,7 +62,7 @@ window.__ModuleLoader__.load({
 			"switch.on": "启用",
 			"switch.off": "停用",
 			"error": "写入失败",
-			"hint": "启用后:所有工具(bash 命令与 workdir、read/write/edit/read_image/glob/grep 的路径参数)统一使用 MSYS 盘根 POSIX 路径(/c/Users/...);文件工具的路径参数由宿主自动翻译,模型无感。停用后恢复 dsh 原生行为(文件工具用 Windows 路径)。bash 始终是 Git Bash,不受此开关影响。",
+			"hint": "启用后:所有工具(bash 命令与 workdir、read/write/edit/read_image/glob/grep 与 present 的路径参数)统一使用 MSYS 盘根 POSIX 路径(/c/Users/...);bash 的原生习惯——~ 家目录、/tmp 临时目录、/dev/null、/usr 等——在所有工具中同样有效(与 Git Bash 挂载表一致),路径参数由宿主自动翻译,模型无感。停用后恢复 dsh 原生行为(文件工具用 Windows 路径)。bash 始终是 Git Bash,不受此开关影响。",
 			"adopt.label": "接管侧栏终端",
 			"adopt.hint": "开启时把 dsh-better-sidebar 的终端 shell 写成 Git Bash(默认开启);关闭后恢复接管前的值,已手动改过的终端设置不会被碰。模型侧的 bash 工具不受此开关影响——那由插件本体提供。",
 		};
@@ -76,7 +76,7 @@ window.__ModuleLoader__.load({
 			"switch.on": "Enable",
 			"switch.off": "Disable",
 			"error": "write failed",
-			"hint": "Enabled: every tool (bash commands and workdir, read/write/edit/read_image/glob/grep path arguments) uses MSYS drive-root POSIX paths (/c/Users/...); the host translates path fields for the file tools automatically. Disabled restores dsh-native behavior (Windows paths for file tools). Bash is always Git Bash while the plugin is installed; this switch only governs the cross-tool path dialect.",
+			"hint": "Enabled: every tool (bash commands and workdir, read/write/edit/read_image/glob/grep and present path arguments) uses MSYS drive-root POSIX paths (/c/Users/...); bash-native habits — the ~ home shorthand, /tmp, /dev/null, /usr — resolve in every tool exactly as bash itself resolves them, and the host translates the path fields automatically. Disabled restores dsh-native behavior (Windows paths for file tools). Bash is always Git Bash while the plugin is installed; this switch only governs the cross-tool path dialect.",
 			"adopt.label": "Adopt sidebar terminal",
 			"adopt.hint": "On (default) writes Git Bash into dsh-better-sidebar's terminal shell; turning it off restores the pre-adoption value and never touches a manually chosen one. The model-side bash tool is unaffected — the plugin itself provides that.",
 		};
@@ -100,7 +100,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "تفعيل",
 				"switch.off": "تعطيل",
 				"error": "فشل الكتابة",
-				"hint": "عند التفعيل: تستخدم كل الأدوات (أوامر bash و workdir، ومعاملات المسار في read/write/edit/read_image/glob/grep) مسارات POSIX من جذر قرص MSYS (/c/Users/...)؛ ويتولّى المضيف ترجمة حقول المسار لأدوات الملفات تلقائيًا. عند التعطيل يعود السلوك الأصلي لـ dsh (مسارات Windows لأدوات الملفات). يبقى bash دائمًا Git Bash ما دامت الإضافة مثبَّتة؛ هذا المفتاح لا يحكم سوى لهجة المسارات بين الأدوات.",
+				"hint": "عند التفعيل: تستخدم كل الأدوات (أوامر bash و workdir، ومعاملات المسار في read/write/edit/read_image/glob/grep و present) مسارات POSIX من جذر قرص MSYS (/c/Users/...)؛ وعادات bash الأصلية — ~ للمجلد الرئيسي و /tmp و /dev/null و /usr — تعمل في كل أداة تمامًا كما تحلّها bash نفسها، ويتولّى المضيف ترجمة حقول المسار تلقائيًا. عند التعطيل يعود السلوك الأصلي لـ dsh (مسارات Windows لأدوات الملفات). يبقى bash دائمًا Git Bash ما دامت الإضافة مثبَّتة؛ هذا المفتاح لا يحكم سوى لهجة المسارات بين الأدوات.",
 				"adopt.label": "تبنّي طرفية الشريط الجانبي",
 				"adopt.hint": "عند التفعيل (افتراضي) تُكتب Git Bash كـ shell لطرفية dsh-better-sidebar؛ وعند التعطيل تُستعاد القيمة السابقة ولا تُلمس القيمة المختارة يدويًا أبدًا. أداة bash الخاصة بالنموذج لا تتأثر — الإضافة نفسها توفرها.",
 			},
@@ -114,7 +114,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Aktivieren",
 				"switch.off": "Deaktivieren",
 				"error": "Schreiben fehlgeschlagen",
-				"hint": "Aktiviert: Alle Tools (bash-Befehle und workdir sowie Pfadargumente von read/write/edit/read_image/glob/grep) verwenden POSIX-Pfade ab der MSYS-Laufwerkswurzel (/c/Users/...); der Host übersetzt die Pfadfelder der Dateitools automatisch. Deaktiviert stellt das dsh-native Verhalten wieder her (Windows-Pfade für Dateitools). Bash ist bei installiertem Plugin immer Git Bash; dieser Schalter steuert nur den Pfaddialekt zwischen den Tools.",
+				"hint": "Aktiviert: Alle Tools (bash-Befehle und workdir sowie Pfadargumente von read/write/edit/read_image/glob/grep und present) verwenden POSIX-Pfade ab der MSYS-Laufwerkswurzel (/c/Users/...); bash-eigene Gewohnheiten — ~ für das Home-Verzeichnis, /tmp, /dev/null, /usr — funktionieren in jedem Tool genau so, wie bash sie selbst auflöst, und der Host übersetzt die Pfadfelder automatisch. Deaktiviert stellt das dsh-native Verhalten wieder her (Windows-Pfade für Dateitools). Bash ist bei installiertem Plugin immer Git Bash; dieser Schalter steuert nur den Pfaddialekt zwischen den Tools.",
 				"adopt.label": "Sidebar-Terminal übernehmen",
 				"adopt.hint": "Ein (Standard) schreibt Git Bash als Shell des dsh-better-sidebar-Terminals; Aus stellt den vorherigen Wert wieder her und fasst nie eine manuell gewählte Einstellung an. Das bash-Werkzeug des Modells bleibt unberührt — das liefert das Plugin selbst.",
 			},
@@ -128,7 +128,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Activer",
 				"switch.off": "Désactiver",
 				"error": "échec de l'écriture",
-				"hint": "Activé : tous les outils (commandes bash et workdir, arguments de chemin de read/write/edit/read_image/glob/grep) utilisent des chemins POSIX à racine de lecteur MSYS (/c/Users/...) ; l'hôte traduit automatiquement les champs de chemin des outils de fichiers. Désactivé rétablit le comportement natif de dsh (chemins Windows pour les outils de fichiers). Bash reste toujours Git Bash tant que le plugin est installé ; ce commutateur ne régit que le dialecte de chemins entre outils.",
+				"hint": "Activé : tous les outils (commandes bash et workdir, arguments de chemin de read/write/edit/read_image/glob/grep et de present) utilisent des chemins POSIX à racine de lecteur MSYS (/c/Users/...) ; les habitudes natives de bash — ~ pour le dossier personnel, /tmp, /dev/null, /usr — fonctionnent dans chaque outil exactement comme bash les résout lui-même, et l'hôte traduit les champs de chemin automatiquement. Désactivé rétablit le comportement natif de dsh (chemins Windows pour les outils de fichiers). Bash reste toujours Git Bash tant que le plugin est installé ; ce commutateur ne régit que le dialecte de chemins entre outils.",
 				"adopt.label": "Adopter le terminal latéral",
 				"adopt.hint": "Activé (par défaut) : écrit Git Bash comme shell du terminal dsh-better-sidebar ; désactivé : restaure la valeur davant et ne touche jamais un choix manuel. Loutil bash du modèle nest pas concerné — le plugin le fournit lui-même.",
 			},
@@ -142,7 +142,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "सक्षम करें",
 				"switch.off": "अक्षम करें",
 				"error": "लिखना विफल रहा",
-				"hint": "सक्षम होने पर: सभी टूल (bash कमांड और workdir, तथा read/write/edit/read_image/glob/grep के पथ तर्क) MSYS ड्राइव-रूट POSIX पथ (/c/Users/...) का उपयोग करते हैं; फ़ाइल टूल के पथ फ़ील्ड होस्ट स्वतः अनुवादित करता है। अक्षम करने पर dsh का मूल व्यवहार बहाल होता है (फ़ाइल टूल के लिए Windows पथ)। जब तक प्लगइन इंस्टॉल है bash हमेशा Git Bash रहता है; यह स्विच केवल टूल के बीच पथ शैली नियंत्रित करता है।",
+				"hint": "सक्षम होने पर: सभी टूल (bash कमांड और workdir, तथा read/write/edit/read_image/glob/grep और present के पथ तर्क) MSYS ड्राइव-रूट POSIX पथ (/c/Users/...) का उपयोग करते हैं; bash की मूल आदतें — होम के लिए ~, /tmp, /dev/null, /usr — हर टूल में ठीक वैसे काम करती हैं जैसे bash स्वयं उन्हें हल करता है, और होस्ट पथ फ़ील्ड स्वतः अनुवादित करता है। अक्षम करने पर dsh का मूल व्यवहार बहाल होता है (फ़ाइल टूल के लिए Windows पथ)। जब तक प्लगइन इंस्टॉल है bash हमेशा Git Bash रहता है; यह स्विच केवल टूल के बीच पथ शैली नियंत्रित करता है।",
 				"adopt.label": "साइडबार टर्मिनल अपनाएँ",
 				"adopt.hint": "चालू (डिफ़ॉल्ट) होने पर dsh-better-sidebar के टर्मिनल में Git Bash लिखा जाता है; बंद करने पर पहले वाली मान बहाल होती है और मैन्युअल चुनी गई सेटिंग कभी नहीं छुई जाती। मॉडल का bash टूल अप्रभावित रहता है — वह प्लगइन स्वयं देता है।",
 			},
@@ -156,7 +156,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Aktifkan",
 				"switch.off": "Nonaktifkan",
 				"error": "gagal menulis",
-				"hint": "Saat aktif: semua alat (perintah bash dan workdir, serta argumen path read/write/edit/read_image/glob/grep) memakai path POSIX berakar drive MSYS (/c/Users/...); host menerjemahkan bidang path untuk alat berkas secara otomatis. Saat nonaktif, perilaku asli dsh dipulihkan (path Windows untuk alat berkas). Bash selalu Git Bash selama plugin terpasang; sakelar ini hanya mengatur dialek path antaralat.",
+				"hint": "Saat aktif: semua alat (perintah bash dan workdir, serta argumen path read/write/edit/read_image/glob/grep dan present) memakai path POSIX berakar drive MSYS (/c/Users/...); kebiasaan asli bash — ~ untuk direktori home, /tmp, /dev/null, /usr — bekerja di setiap alat persis seperti bash sendiri menyelesaikannya, dan host menerjemahkan bidang path secara otomatis. Saat nonaktif, perilaku asli dsh dipulihkan (path Windows untuk alat berkas). Bash selalu Git Bash selama plugin terpasang; sakelar ini hanya mengatur dialek path antaralat.",
 				"adopt.label": "Adopsi terminal sidebar",
 				"adopt.hint": "Nyala (bawaan) menulis Git Bash sebagai shell terminal dsh-better-sidebar; dimatikan memulihkan nilai sebelumnya dan tidak pernah menyentuh pilihan manual. Alat bash sisi model tak terpengaruh — plugin sendiri yang menyediakannya.",
 			},
@@ -170,7 +170,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Attiva",
 				"switch.off": "Disattiva",
 				"error": "scrittura non riuscita",
-				"hint": "Attivato: tutti gli strumenti (comandi bash e workdir, argomenti di percorso di read/write/edit/read_image/glob/grep) usano percorsi POSIX con radice di unità MSYS (/c/Users/...); l'host traduce automaticamente i campi di percorso degli strumenti per i file. Disattivato ripristina il comportamento nativo di dsh (percorsi Windows per gli strumenti per i file). Bash resta sempre Git Bash finché il plugin è installato; questo interruttore governa solo il dialetto dei percorsi tra gli strumenti.",
+				"hint": "Attivato: tutti gli strumenti (comandi bash e workdir, argomenti di percorso di read/write/edit/read_image/glob/grep e di present) usano percorsi POSIX con radice di unità MSYS (/c/Users/...); le abitudini native di bash — ~ per la home, /tmp, /dev/null, /usr — funzionano in ogni strumento esattamente come le risolve bash stesso, e l'host traduce automaticamente i campi di percorso. Disattivato ripristina il comportamento nativo di dsh (percorsi Windows per gli strumenti per i file). Bash resta sempre Git Bash finché il plugin è installato; questo interruttore governa solo il dialetto dei percorsi tra gli strumenti.",
 				"adopt.label": "Adotta il terminale laterale",
 				"adopt.hint": "Attivo (predefinito) imposta Git Bash come shell del terminale di dsh-better-sidebar; disattivo ripristina il valore precedente e non tocca mai una scelta manuale. Lo strumento bash del modello non è interessato — lo fornisce il plugin stesso.",
 			},
@@ -184,7 +184,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "有効にする",
 				"switch.off": "無効にする",
 				"error": "書き込みに失敗しました",
-				"hint": "有効にすると、すべてのツール(bash コマンドと workdir、read/write/edit/read_image/glob/grep のパス引数)が MSYS ドライブルートの POSIX パス(/c/Users/...)を使います。ファイルツールのパスフィールドはホストが自動的に変換します。無効にすると dsh 本来の動作(ファイルツールは Windows パス)に戻ります。bash はプラグインがインストールされている限り常に Git Bash で、このスイッチの影響を受けません。",
+				"hint": "有効にすると、すべてのツール(bash コマンドと workdir、read/write/edit/read_image/glob/grep と present のパス引数)が MSYS ドライブルートの POSIX パス(/c/Users/...)を使います。bash のネイティブな習慣——ホームの ~、/tmp、/dev/null、/usr——も、bash 自身が解決するのとまったく同じようにすべてのツールで動作し、パスフィールドはホストが自動的に変換します。無効にすると dsh 本来の動作(ファイルツールは Windows パス)に戻ります。bash はプラグインがインストールされている限り常に Git Bash で、このスイッチの影響を受けません。",
 				"adopt.label": "サイドバーターミナルを引き継ぐ",
 				"adopt.hint": "オン(既定)では dsh-better-sidebar のターミナルシェルに Git Bash を書き込みます。オフにすると以前の値へ戻し、手動で選択した設定には決して触れません。モデル側の bash ツールには影響しません——それはプラグイン本体が提供します。",
 			},
@@ -198,7 +198,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "사용",
 				"switch.off": "사용 안 함",
 				"error": "쓰기 실패",
-				"hint": "켜면 모든 도구(bash 명령과 workdir, read/write/edit/read_image/glob/grep의 경로 인수)가 MSYS 드라이브 루트 POSIX 경로(/c/Users/...)를 사용합니다. 파일 도구의 경로 필드는 호스트가 자동으로 변환합니다. 끄면 dsh 기본 동작(파일 도구에 Windows 경로 사용)으로 돌아갑니다. 플러그인이 설치되어 있는 동안 bash는 항상 Git Bash이며 이 스위치의 영향을 받지 않습니다.",
+				"hint": "켜면 모든 도구(bash 명령과 workdir, read/write/edit/read_image/glob/grep 및 present의 경로 인수)가 MSYS 드라이브 루트 POSIX 경로(/c/Users/...)를 사용합니다. bash 고유 습관——홈의 ~, /tmp, /dev/null, /usr——도 bash 자신이 해석하는 그대로 모든 도구에서 작동하며 호스트가 경로 필드를 자동 변환합니다. 끄면 dsh 기본 동작(파일 도구에 Windows 경로 사용)으로 돌아갑니다. 플러그인이 설치되어 있는 동안 bash는 항상 Git Bash이며 이 스위치의 영향을 받지 않습니다.",
 				"adopt.label": "사이드바 터미널 인수",
 				"adopt.hint": "켜짐(기본)이면 dsh-better-sidebar 터미널 셸에 Git Bash를 기록하고, 끄면 이전 값을 복원하며 수동으로 고른 설정은 절대 건드리지 않습니다. 모델 측 bash 도구에는 영향이 없습니다 — 플러그인이 직접 제공합니다.",
 			},
@@ -212,7 +212,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Inschakelen",
 				"switch.off": "Uitschakelen",
 				"error": "schrijven mislukt",
-				"hint": "Ingeschakeld: alle tools (bash-opdrachten en workdir, padargumenten van read/write/edit/read_image/glob/grep) gebruiken POSIX-paden vanaf de MSYS-schijfwortel (/c/Users/...); de host vertaalt de padvelden voor de bestandstools automatisch. Uitgeschakeld herstelt het oorspronkelijke dsh-gedrag (Windows-paden voor bestandstools). Bash is altijd Git Bash zolang de plugin is geïnstalleerd; deze schakelaar bepaalt alleen het paddialect tussen de tools.",
+				"hint": "Ingeschakeld: alle tools (bash-opdrachten en workdir, padargumenten van read/write/edit/read_image/glob/grep en present) gebruiken POSIX-paden vanaf de MSYS-schijfwortel (/c/Users/...); bash-eigen gewoonten — ~ voor de home-map, /tmp, /dev/null, /usr — werken in elke tool precies zoals bash ze zelf oplost, en de host vertaalt de padvelden automatisch. Uitgeschakeld herstelt het oorspronkelijke dsh-gedrag (Windows-paden voor bestandstools). Bash is altijd Git Bash zolang de plugin is geïnstalleerd; deze schakelaar bepaalt alleen het paddialect tussen de tools.",
 				"adopt.label": "Zijbalkterminal overnemen",
 				"adopt.hint": "Aan (standaard) schrijft Git Bash als shell van de dsh-better-sidebar-terminal; uit herstelt de vorige waarde en raakt nooit een handmatige keuze aan. De bash-tool van het model blijft buiten beschouwing — die levert de plugin zelf.",
 			},
@@ -226,7 +226,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Włącz",
 				"switch.off": "Wyłącz",
 				"error": "zapis nie powiódł się",
-				"hint": "Po włączeniu: wszystkie narzędzia (polecenia bash i workdir oraz argumenty ścieżek w read/write/edit/read_image/glob/grep) używają ścieżek POSIX od korzenia dysku MSYS (/c/Users/...); host automatycznie tłumaczy pola ścieżek narzędzi plikowych. Wyłączenie przywraca natywne zachowanie dsh (ścieżki Windows dla narzędzi plikowych). Bash jest zawsze Git Bash, dopóki wtyczka jest zainstalowana; ten przełącznik reguluje wyłącznie dialekt ścieżek między narzędziami.",
+				"hint": "Po włączeniu: wszystkie narzędzia (polecenia bash i workdir, argumenty ścieżek w read/write/edit/read_image/glob/grep i w present) używają ścieżek POSIX od korzenia dysku MSYS (/c/Users/...); natywne nawyki basha — ~ dla katalogu domowego, /tmp, /dev/null, /usr — działają w każdym narzędziu dokładnie tak, jak rozwiązuje je sam bash, a host automatycznie tłumaczy pola ścieżek. Wyłączenie przywraca natywne zachowanie dsh (ścieżki Windows dla narzędzi plikowych). Bash jest zawsze Git Bash, dopóki wtyczka jest zainstalowana; ten przełącznik reguluje wyłącznie dialekt ścieżek między narzędziami.",
 				"adopt.label": "Przejmij terminal boczny",
 				"adopt.hint": "Włączony (domyślnie) zapisuje Git Bash jako shell terminala dsh-better-sidebar; wyłączony przywraca poprzednią wartość i nigdy nie narusza ręcznie wybranego ustawienia. Narzędzie bash po stronie modelu jest nietknięte — zapewnia je sama wtyczka.",
 			},
@@ -240,7 +240,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Ativar",
 				"switch.off": "Desativar",
 				"error": "falha ao gravar",
-				"hint": "Ativada: todas as ferramentas (comandos bash e workdir, argumentos de caminho de read/write/edit/read_image/glob/grep) usam caminhos POSIX a partir da raiz da unidade MSYS (/c/Users/...); o host traduz automaticamente os campos de caminho das ferramentas de arquivo. Desativada restaura o comportamento nativo do dsh (caminhos Windows para as ferramentas de arquivo). O bash é sempre Git Bash enquanto o plugin estiver instalado; este interruptor rege apenas o dialeto de caminhos entre ferramentas.",
+				"hint": "Ativada: todas as ferramentas (comandos bash e workdir, argumentos de caminho de read/write/edit/read_image/glob/grep e de present) usam caminhos POSIX a partir da raiz da unidade MSYS (/c/Users/...); os hábitos nativos do bash — ~ para a pasta pessoal, /tmp, /dev/null, /usr — funcionam em cada ferramenta exatamente como o próprio bash os resolve, e o host traduz os campos de caminho automaticamente. Desativada restaura o comportamento nativo do dsh (caminhos Windows para as ferramentas de arquivo). O bash é sempre Git Bash enquanto o plugin estiver instalado; este interruptor rege apenas o dialeto de caminhos entre ferramentas.",
 				"adopt.label": "Adotar o terminal lateral",
 				"adopt.hint": "Ligado (padrão) grava o Git Bash como shell do terminal do dsh-better-sidebar; desligado restaura o valor anterior e nunca altera uma escolha manual. A ferramenta bash do modelo não é afetada — o próprio plug-in a fornece.",
 			},
@@ -254,7 +254,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Включить",
 				"switch.off": "Выключить",
 				"error": "не удалось записать",
-				"hint": "Включено: все инструменты (команды bash и workdir, аргументы путей read/write/edit/read_image/glob/grep) используют POSIX-пути от корня диска MSYS (/c/Users/...); хост автоматически преобразует поля путей для файловых инструментов. Выключение возвращает исходное поведение dsh (пути Windows для файловых инструментов). Пока плагин установлен, bash всегда остаётся Git Bash; этот переключатель управляет только диалектом путей между инструментами.",
+				"hint": "Включено: все инструменты (команды bash и workdir, аргументы путей read/write/edit/read_image/glob/grep и present) используют POSIX-пути от корня диска MSYS (/c/Users/...); собственные привычки bash — ~ для домашнего каталога, /tmp, /dev/null, /usr — работают в каждом инструменте ровно так, как их разрешает сам bash, а хост автоматически преобразует поля путей. Выключение возвращает исходное поведение dsh (пути Windows для файловых инструментов). Пока плагин установлен, bash всегда остаётся Git Bash; этот переключатель управляет только диалектом путей между инструментами.",
 				"adopt.label": "Перехватывать терминал боковой панели",
 				"adopt.hint": "Включено (по умолчанию): Git Bash записывается как shell терминала dsh-better-sidebar; выключено — восстанавливается прежнее значение, вручную выбранные настройки не трогаются. Инструмент bash у модели не затронут — его предоставляет сам плагин.",
 			},
@@ -268,7 +268,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Aktivera",
 				"switch.off": "Inaktivera",
 				"error": "skrivning misslyckades",
-				"hint": "Aktiverad: alla verktyg (bash-kommandon och workdir, sökvägsargument för read/write/edit/read_image/glob/grep) använder POSIX-sökvägar från MSYS-enhetsroten (/c/Users/...); värden översätter sökvägsfälten för filverktygen automatiskt. Inaktiverad återställer dsh:s ursprungliga beteende (Windows-sökvägar för filverktyg). Bash är alltid Git Bash så länge insticksprogrammet är installerat; den här växeln styr bara sökvägsdialekten mellan verktygen.",
+				"hint": "Aktiverad: alla verktyg (bash-kommandon och workdir, sökvägsargument för read/write/edit/read_image/glob/grep och present) använder POSIX-sökvägar från MSYS-enhetsroten (/c/Users/...); bash egna vanor — ~ för hemkatalogen, /tmp, /dev/null, /usr — fungerar i varje verktyg exakt som bash själv löser dem, och värden översätter sökvägsfälten automatiskt. Inaktiverad återställer dsh:s ursprungliga beteende (Windows-sökvägar för filverktygen). Bash är alltid Git Bash så länge insticksprogrammet är installerat; den här växeln styr bara sökvägsdialekten mellan verktygen.",
 				"adopt.label": "Överta sidolistterminal",
 				"adopt.hint": "På (standard) skriver Git Bash som terminal-shell i dsh-better-sidebar; av återställer det tidigare värdet och rör aldrig ett manuellt val. Modellens bash-verktyg påverkas inte — det tillhandahålls av pluginet självt.",
 			},
@@ -282,7 +282,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "เปิดใช้งาน",
 				"switch.off": "ปิดใช้งาน",
 				"error": "เขียนไม่สำเร็จ",
-				"hint": "เมื่อเปิดใช้งาน: เครื่องมือทั้งหมด (คำสั่ง bash และ workdir รวมถึงอาร์กิวเมนต์พาธของ read/write/edit/read_image/glob/grep) ใช้พาธ POSIX จากรากไดรฟ์ของ MSYS (/c/Users/...) โฮสต์จะแปลฟิลด์พาธของเครื่องมือจัดการไฟล์ให้อัตโนมัติ เมื่อปิดใช้งานจะกลับสู่พฤติกรรมดั้งเดิมของ dsh (เครื่องมือจัดการไฟล์ใช้พาธ Windows) bash เป็น Git Bash เสมอเมื่อติดตั้งปลั๊กอินนี้ สวิตช์นี้ควบคุมเฉพาะรูปแบบพาธระหว่างเครื่องมือเท่านั้น",
+				"hint": "เมื่อเปิดใช้งาน: เครื่องมือทั้งหมด (คำสั่ง bash และ workdir รวมถึงอาร์กิวเมนต์พาธของ read/write/edit/read_image/glob/grep และ present) ใช้พาธ POSIX จากรากไดรฟ์ของ MSYS (/c/Users/...); พฤติกรรมดั้งเดิมของ bash — ~ สำหรับโฮม, /tmp, /dev/null, /usr — ทำงานในทุกเครื่องมือเหมือนที่ bash แก้เองพอดี และโฮสต์แปลฟิลด์พาธให้อัตโนมัติ เมื่อปิดใช้งานจะกลับสู่พฤติกรรมดั้งเดิมของ dsh (เครื่องมือจัดการไฟล์ใช้พาธ Windows) bash เป็น Git Bash เสมอเมื่อติดตั้งปลั๊กอินนี้ สวิตช์นี้ควบคุมเฉพาะรูปแบบพาธระหว่างเครื่องมือเท่านั้น",
 				"adopt.label": "รับช่วงเทอร์มินัลแถบข้าง",
 				"adopt.hint": "เปิด (ค่าเริ่มต้น) จะเขียน Git Bash เป็น shell ของเทอร์มินัล dsh-better-sidebar; ปิดแล้วคืนค่าเดิมและไม่แตะการตั้งค่าที่เลือกเอง เครื่องมือ bash ของโมเดลไม่กระทบ — ปลั๊กอินจัดหาเอง",
 			},
@@ -296,7 +296,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Etkinleştir",
 				"switch.off": "Devre dışı bırak",
 				"error": "yazma başarısız",
-				"hint": "Etkinleştirildiğinde: tüm araçlar (bash komutları ve workdir ile read/write/edit/read_image/glob/grep yol bağımsız değişkenleri) MSYS sürücü kökünden POSIX yolları (/c/Users/...) kullanır; ana süreç dosya araçlarının yol alanlarını otomatik olarak çevirir. Devre dışı bırakıldığında dsh yerel davranışına döner (dosya araçları için Windows yolları). Eklenti kurulu olduğu sürece bash her zaman Git Bash olarak kalır; bu anahtar yalnızca araçlar arası yol lehçesini yönetir.",
+				"hint": "Etkinleştirildiğinde: tüm araçlar (bash komutları ve workdir ile read/write/edit/read_image/glob/grep ve present yol bağımsız değişkenleri) MSYS sürücü kökünden POSIX yolları (/c/Users/...) kullanır; bash'e özgü alışkanlıklar — ev için ~, /tmp, /dev/null, /usr — her araçta tam bash'in kendisinin çözdüğü gibi çalışır ve ana süreç yol alanlarını otomatik olarak çevirir. Devre dışı bırakıldığında dsh yerel davranışına döner (dosya araçları için Windows yolları). Eklenti kurulu olduğu sürece bash her zaman Git Bash olarak kalır; bu anahtar yalnızca araçlar arası yol lehçesini yönetir.",
 				"adopt.label": "Kenar çubuğu terminalini devral",
 				"adopt.hint": "Açık (varsayılan) Git Bashi dsh-better-sidebar terminalinin shelli olarak yazar; kapalı önceki değeri geri getirir ve elle seçilmiş bir ayara asla dokunmaz. Model tarafındaki bash aracı etkilenmez — onu eklentinin kendisi sağlar.",
 			},
@@ -310,7 +310,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "Bật",
 				"switch.off": "Tắt",
 				"error": "ghi thất bại",
-				"hint": "Khi bật: mọi công cụ (lệnh bash và workdir, tham số đường dẫn của read/write/edit/read_image/glob/grep) dùng đường dẫn POSIX từ gốc ổ đĩa MSYS (/c/Users/...); máy chủ tự động chuyển đổi trường đường dẫn cho các công cụ tệp. Khi tắt, hành vi gốc của dsh được khôi phục (công cụ tệp dùng đường dẫn Windows). bash luôn là Git Bash khi plugin được cài đặt; công tắc này chỉ điều khiển phương ngữ đường dẫn giữa các công cụ.",
+				"hint": "Khi bật: mọi công cụ (lệnh bash và workdir, tham số đường dẫn của read/write/edit/read_image/glob/grep và present) dùng đường dẫn POSIX từ gốc ổ đĩa MSYS (/c/Users/...); thói quen gốc của bash — ~ cho thư mục home, /tmp, /dev/null, /usr — hoạt động trong mọi công cụ đúng như chính bash giải quyết chúng, và máy chủ tự động chuyển đổi trường đường dẫn. Khi tắt, hành vi gốc của dsh được khôi phục (công cụ tệp dùng đường dẫn Windows). bash luôn là Git Bash khi plugin được cài đặt; công tắc này chỉ điều khiển phương ngữ đường dẫn giữa các công cụ.",
 				"adopt.label": "Tiếp nhận terminal thanh bên",
 				"adopt.hint": "Bật (mặc định) ghi Git Bash làm shell terminal của dsh-better-sidebar; tắt khôi phục giá trị trước đó và không bao giờ đụng tới lựa chọn thủ công. Công cụ bash phía mô hình không bị ảnh hưởng — chính plugin cung cấp nó.",
 			},
@@ -324,7 +324,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "啟用",
 				"switch.off": "停用",
 				"error": "寫入失敗",
-				"hint": "啟用後:所有工具(bash 指令同 workdir、read/write/edit/read_image/glob/grep 嘅路徑參數)統一使用 MSYS 磁碟根 POSIX 路徑(/c/Users/...);檔案工具嘅路徑參數由宿主自動翻譯,模型無感。停用後回復 dsh 原生行為(檔案工具用 Windows 路徑)。bash 永遠係 Git Bash,唔受呢個開關影響。",
+				"hint": "啟用後:所有工具(bash 指令同 workdir、read/write/edit/read_image/glob/grep 同 present 嘅路徑參數)統一使用 MSYS 磁碟根 POSIX 路徑(/c/Users/...);bash 原生習慣——~ 家目錄、/tmp、/dev/null、/usr——喺所有工具一樣有效(同 Git Bash 掛載表一致),路徑參數由宿主自動翻譯,模型無感。停用後回復 dsh 原生行為(檔案工具用 Windows 路徑)。bash 永遠係 Git Bash,唔受呢個開關影響。",
 				"adopt.label": "接管側欄終端",
 				"adopt.hint": "開啟(預設)會把 dsh-better-sidebar 的終端 shell 寫成 Git Bash;關閉後還原接管前的值,手動改過的設定永不被碰。模型側的 bash 工具不受影響——由插件本身提供。",
 			},
@@ -338,7 +338,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "啟用",
 				"switch.off": "停用",
 				"error": "寫入失敗",
-				"hint": "啟用後:所有工具(bash 指令同 workdir、read/write/edit/read_image/glob/grep 嘅路徑參數)統一使用 MSYS 磁碟根 POSIX 路徑(/c/Users/...);檔案工具嘅路徑參數由宿主自動翻譯,模型無感。停用後回復 dsh 原生行為(檔案工具用 Windows 路徑)。bash 永遠係 Git Bash,唔受呢個開關影響。",
+				"hint": "啟用後:所有工具(bash 指令同 workdir、read/write/edit/read_image/glob/grep 同 present 嘅路徑參數)統一使用 MSYS 磁碟根 POSIX 路徑(/c/Users/...);bash 原生習慣——~ 家目錄、/tmp、/dev/null、/usr——喺所有工具一樣有效(同 Git Bash 掛載表一致),路徑參數由宿主自動翻譯,模型無感。停用後回復 dsh 原生行為(檔案工具用 Windows 路徑)。bash 永遠係 Git Bash,唔受呢個開關影響。",
 				"adopt.label": "接管側欄終端",
 				"adopt.hint": "開啟(預設)會把 dsh-better-sidebar 的終端 shell 寫成 Git Bash;關閉後還原接管前的值,手動改過的設定永不被碰。模型側的 bash 工具不受影響——由插件本身提供。",
 			},
@@ -352,7 +352,7 @@ window.__ModuleLoader__.load({
 				"switch.on": "啟用",
 				"switch.off": "停用",
 				"error": "寫入失敗",
-				"hint": "啟用後:所有工具(bash 指令與 workdir,以及 read/write/edit/read_image/glob/grep 的路徑參數)統一使用 MSYS 磁碟根 POSIX 路徑(/c/Users/...);檔案工具的路徑參數由宿主自動轉譯,模型無感。停用後恢復 dsh 原生行為(檔案工具使用 Windows 路徑)。bash 一律是 Git Bash,不受此開關影響。",
+				"hint": "啟用後:所有工具(bash 指令與 workdir,以及 read/write/edit/read_image/glob/grep 與 present 的路徑參數)統一使用 MSYS 磁碟根 POSIX 路徑(/c/Users/...);bash 原生習慣——~ 家目錄、/tmp、/dev/null、/usr——在所有工具同樣有效(與 Git Bash 掛載表一致),路徑參數由宿主自動轉譯,模型無感。停用後恢復 dsh 原生行為(檔案工具使用 Windows 路徑)。bash 一律是 Git Bash,不受此開關影響。",
 				"adopt.label": "接管側欄終端機",
 				"adopt.hint": "開啟(預設)會把 dsh-better-sidebar 的終端機 shell 寫成 Git Bash;關閉後還原接管前的值,手動改過的設定永不被碰。模型側的 bash 工具不受影響——由插件本身提供。",
 			},

package/src/index.js

@@ -50,6 +50,7 @@ import {
   rmSync,
   writeFileSync,
 } from 'node:fs'
+import { homedir, tmpdir } from 'node:os'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
@@ -662,7 +663,7 @@ export function installRegisterShim(reg) {
 const SETTINGS_NAMESPACE = 'gitbash-shell'
 
 /** The full directive text, injected only while posixPaths is on. */
-const POSIX_DIRECTIVE_TEXT = 'The working shell is Git for Windows bash: paths use MSYS drive roots (/c/Users/...), and every tool accepts that form directly.'
+const POSIX_DIRECTIVE_TEXT = 'The working shell is Git for Windows bash: paths use MSYS drive roots (/c/Users/...), and every tool accepts that form directly — including the bash-native habits (~ home shorthand, /tmp, /dev/null, /usr/bin/...), which resolve in every tool exactly as bash itself resolves them.'
 
 // Official runtime counterpart to the directive (v0.11.0): dsh-shell-env is
 // the host-plane registry behind the model-visible $DSH_* facts, and the
@@ -670,7 +671,7 @@ const POSIX_DIRECTIVE_TEXT = 'The working shell is Git for Windows bash: paths u
 // lives there, verifiable at runtime instead of only stated in the prompt.
 const PATH_DIALECT_KEY = 'DSH_PATH_DIALECT'
 const PATH_DIALECT_VALUE = 'msys'
-const PATH_DIALECT_DESCRIPTION = 'Path dialect for tool calls and tool results: MSYS drive roots (/c/Users/...); every tool accepts this form directly.'
+const PATH_DIALECT_DESCRIPTION = 'Path dialect for tool calls and tool results: MSYS drive roots (/c/Users/...) plus the bash-native mounts (~, /tmp, /dev/null, /usr); every tool accepts these forms directly.'
 
 /** Read the posixPaths switch from the live settings service; never throws. */
 export function readPosixPaths(ctxLike) {
@@ -723,30 +724,44 @@ function posixSeparators(value) {
     : value
 }
 
-/**
- * Rewrite result METADATA path fields to the MSYS dialect (pure, 0.10.4).
- * Only the well-known metadata fields per tool are touched — read/write/edit
- * `path` (absolute, via windowsToMsys), glob `paths[]` and grep
- * `matches[].path` (workspace-relative, separator-normalized). File CONTENT
- * (read lines, grep match text) and error results are never modified: the
- * tool result is data, only its path metadata changes dialect so the model
- * never meets a Windows-form path flowing back from a successful call.
- * @returns {object} a new value when any field changed, the input otherwise.
- */
-export function rewriteResultPaths(name, value) {
+export function rewriteResultPaths(name, value, env) {
   if (!value || typeof value !== 'object') return value
+  // v0.17.0: paths under the user TEMP directory echo back in the bash
+  // /tmp dialect (that IS what /tmp means in Git Bash), so the model sees
+  // the same short root bash itself prints for $TMP.
+  const tempRoot = env && env.tmpDir ? windowsToMsys(env.tmpDir) : ''
+  const toMsys = (p) => {
+    const out = windowsToMsys(p)
+    if (!tempRoot) return out
+    const lower = out.toLowerCase()
+    const rootLower = tempRoot.toLowerCase()
+    if (lower === rootLower) return '/tmp'
+    if (lower.startsWith(rootLower + '/')) return '/tmp' + out.slice(tempRoot.length)
+    return out
+  }
   if (name === 'read' || name === 'read_image' || name === 'write' || name === 'edit') {
     if (typeof value.path === 'string' && value.path !== '') {
-      const out = windowsToMsys(value.path)
+      const out = toMsys(value.path)
       if (out !== value.path) return { ...value, path: out }
     }
     return value
   }
+  if (name === 'present' && Array.isArray(value.files)) {
+    let changed = false
+    const files = value.files.map((file) => {
+      if (!file || typeof file !== 'object' || typeof file.path !== 'string' || file.path === '') return file
+      const out = posixSeparators(toMsys(file.path))
+      if (out === file.path) return file
+      changed = true
+      return { ...file, path: out }
+    })
+    return changed ? { ...value, files } : value
+  }
   if (name === 'glob' && Array.isArray(value.paths)) {
     let changed = false
     const paths = value.paths.map((p) => {
       if (typeof p !== 'string') return p
-      const out = posixSeparators(windowsToMsys(p))
+      const out = posixSeparators(toMsys(p))
       if (out === p) return p
       changed = true
       return out
@@ -757,7 +772,7 @@ export function rewriteResultPaths(name, value) {
     let changed = false
     const matches = value.matches.map((m) => {
       if (!m || typeof m !== 'object' || typeof m.path !== 'string') return m
-      const out = posixSeparators(windowsToMsys(m.path))
+      const out = posixSeparators(toMsys(m.path))
       if (out === m.path) return m
       changed = true
       return { ...m, path: out }
@@ -782,28 +797,128 @@ export function rewriteResultPaths(name, value) {
 // directive still stands).
 
 const MSYS_DRIVE_ROOT = /^\/([a-z])\/(.*)$/i
+const MSYS_BARE_DRIVE = /^\/([a-z])$/i
 const TRANSLATABLE_PATH_FIELDS = new Set(['file_path', 'path', 'workdir'])
 
-/** '/c/Users/x' -> 'C:/Users/x'; any other shape returns the input unchanged. */
-export function translateMsysPath(value) {
+// ── virtual mounts + env (v0.17.0) ─────────────────────────────────────
+//
+// Git Bash resolves a few POSIX roots through its OWN mount table before
+// any drive root applies (`mount` inside Git Bash): /tmp is the user TEMP
+// dir (usertemp), /dev/null is the Windows NUL device, and /usr /bin /etc
+// /var /home /root /mnt live under the Git install root. The model carries
+// those bash habits into EVERY tool, so the translation layer mirrors the
+// same table or the file tools silently misplace them (/tmp becomes a
+// fresh C:/tmp on the current drive; /dev/null becomes a real file under
+// C:/dev). All matches are segment-bounded and case-sensitive, exactly
+// like the msys mount table itself (/Tmp does NOT match).
+//
+// /home is deliberately the GIT mount (git-root/home, usually empty), NOT
+// the user profile: bash itself resolves /home/x there, while the home
+// SHORTHAND ~ expands to $HOME (= C:/Users/<u>) — mirroring both keeps
+// file tools and bash in perfect agreement. A bare '/' is never
+// translated: it would scope tools to the whole Git install tree.
+
+/** The Windows null device — the exact target of Git Bash's /dev/null. */
+const NUL_DEVICE = '\\\\.\\NUL'
+
+/** Git-root mounts: MSYS path -> subdirectory under the Git install root. */
+const GIT_MOUNTS = new Map([
+  ['/usr', 'usr'],
+  ['/bin', 'usr/bin'],
+  ['/etc', 'etc'],
+  ['/var', 'var'],
+  ['/home', 'home'],
+  ['/root', 'root'],
+  ['/mnt', 'mnt'],
+])
+
+/**
+ * The runtime facts the virtual mounts resolve against (all optional — a
+ * missing fact simply leaves its paths untranslated). Probed once per
+ * process: tmpdir/homedir are cheap; the Git root walks the candidate
+ * bash.exe list (the default install plus every PATH entry — which also
+ * covers a Git-usr-bin PATH entry) and accepts a root only when
+ * <root>/usr/bin exists, which excludes the WSL bash shim in WindowsApps.
+ */
+let translateEnvCache
+export function buildTranslateEnv() {
+  if (translateEnvCache) return translateEnvCache
+  const env = { tmpDir: undefined, home: undefined, gitRoot: undefined }
+  try {
+    const t = tmpdir()
+    if (t && existsSync(t)) env.tmpDir = t.replace(/\\/g, '/')
+  } catch { /* keep undefined */ }
+  try {
+    const h = homedir()
+    if (h && existsSync(h)) env.home = h.replace(/\\/g, '/')
+  } catch { /* keep undefined */ }
+  try {
+    const candidates = [DEFAULT_GIT_BASH]
+    for (const dir of String(process.env.PATH ?? '').split(';')) {
+      const clean = dir && dir.trim()
+      if (clean) candidates.push(clean.replace(/\\/g, '/') + '/bash.exe')
+    }
+    for (const candidate of candidates) {
+      try {
+        if (!existsSync(candidate)) continue
+        const root = dirname(dirname(candidate))
+        if (existsSync(join(root, 'usr', 'bin'))) {
+          env.gitRoot = root.replace(/\\/g, '/')
+          break
+        }
+      } catch { /* try the next candidate */ }
+    }
+  } catch { /* keep undefined */ }
+  translateEnvCache = env
+  return env
+}
+
+/**
+ * '/c/Users/x' -> 'C:/Users/x'. With an env, the bash-native habits resolve
+ * first (~ -> home) and the virtual mounts (/tmp, /dev/null, /usr & friends)
+ * resolve after the drive roots; any other shape returns the input
+ * unchanged. Pure: the env is a plain fact bag, nothing is probed here.
+ */
+export function translateMsysPath(value, env) {
   if (typeof value !== 'string') return value
+  if (env && env.home && (value === '~' || value.startsWith('~/'))) {
+    return value === '~' ? env.home : env.home + '/' + value.slice(2)
+  }
   const match = MSYS_DRIVE_ROOT.exec(value)
-  if (!match) return value
-  return match[1].toUpperCase() + ':/' + match[2]
+  if (match) return match[1].toUpperCase() + ':/' + match[2]
+  const bare = MSYS_BARE_DRIVE.exec(value)
+  if (bare) return bare[1].toUpperCase() + ':/'
+  if (value === '/dev/null') return NUL_DEVICE
+  if (env && env.tmpDir && (value === '/tmp' || value.startsWith('/tmp/'))) {
+    return value === '/tmp' ? env.tmpDir : env.tmpDir + value.slice(4)
+  }
+  if (env && env.gitRoot) {
+    for (const [mount, target] of GIT_MOUNTS) {
+      if (value === mount || value.startsWith(mount + '/')) {
+        const rest = value === mount ? '' : value.slice(mount.length)
+        return env.gitRoot + '/' + target + rest
+      }
+    }
+  }
+  return value
 }
 
 /**
  * Return an arguments object whose path fields carry drive-letter roots.
  * Pure: builds a NEW object when any field changes and returns the ORIGINAL
  * reference otherwise — the registry deep-freezes exec.arguments at exec
- * construction (0.10.2 lesson: in-place writes throw in strict mode and were
- * silently swallowed), so the caller REPLACES the exec.arguments property
- * (the exec object itself is not frozen until tools/result; signal
- * replacement is the registry's own precedent).
+ * construction (0.10.2 lesson: in-place writes throw in strict mode and
+ * were silently swallowed), so the caller REPLACES the exec.arguments
+ * property (the exec object itself is not frozen until tools/result;
+ * signal replacement is the registry's own precedent).
+ *
+ * v0.17.0: present's NESTED files[].path rides along (the field-name
+ * whitelist only sees top-level keys, and present is the one tool whose
+ * path arguments live one level down).
  * @returns {object} the translated arguments object, or the input when
  *   nothing changed (also the input itself when args is not an object).
  */
-export function translatePathArguments(args) {
+export function translatePathArguments(args, env) {
   if (!args || typeof args !== 'object') return args
   let changed = false
   const next = { ...args }
@@ -811,14 +926,80 @@ export function translatePathArguments(args) {
     if (!TRANSLATABLE_PATH_FIELDS.has(key)) continue
     const value = next[key]
     if (typeof value !== 'string') continue
-    const translated = translateMsysPath(value)
+    const translated = translateMsysPath(value, env)
     if (translated === value) continue
     next[key] = translated
     changed = true
   }
+  if (Array.isArray(next.files)) {
+    const files = next.files.map((file) => {
+      if (!file || typeof file !== 'object' || typeof file.path !== 'string') return file
+      const translated = translateMsysPath(file.path, env)
+      return translated === file.path ? file : { ...file, path: translated }
+    })
+    if (files.some((file, index) => file !== next.files[index])) {
+      next.files = files
+      changed = true
+    }
+  }
   return changed ? next : args
 }
 
+// ── absolute glob patterns (v0.17.0) ────────────────────────────────────
+//
+// The glob tool takes its search root in the `path` argument and expects a
+// RELATIVE pattern; an absolute pattern ('/c/Users/x/*.md', or the Windows
+// form) is treated as relative text and silently matches nothing. A model
+// raised on bash writes absolute patterns anyway, so for the glob tool the
+// wrapper splits an absolute pattern at the last directory separator
+// before the first wildcard and moves the translated directory into
+// `path` ('/c/a/*/b/*.md' -> path 'C:/a', pattern '*/b/*.md'). An absolute
+// path WITHOUT wildcards splits into directory + basename. Runs only for
+// the glob tool and only for patterns that start absolute.
+
+const GLOB_META = /[*?\[\]]/
+
+/** Split an absolute glob pattern into { prefix, rest }; null when relative. */
+function splitGlobPrefix(pattern) {
+  if (typeof pattern !== 'string') return null
+  let p = pattern
+  // A Windows drive head ('C:' + separator) is normalized to the MSYS form
+  // first so both absolute dialects split through the same code path.
+  const winHead = /^([A-Za-z]):[\\/]+(.*)$/.exec(p)
+  if (winHead) p = '/' + winHead[1].toLowerCase() + '/' + winHead[2].replace(/[\\/]+/g, '/')
+  if (p[0] !== '/') return null
+  const meta = GLOB_META.exec(p)
+  const cut = meta ? p.lastIndexOf('/', meta.index) : p.lastIndexOf('/')
+  if (cut <= 0) return null
+  const rest = p.slice(cut + 1)
+  if (rest === '') return null
+  return { prefix: p.slice(0, cut), rest }
+}
+
+
+/** Translate the (always MSYS-form) directory prefix; null when it is not one. */
+function normalizeAbsolutePrefix(prefix, env) {
+  const translated = translateMsysPath(prefix, env)
+  return translated !== prefix ? translated : null
+}
+
+
+/**
+ * Rewrite a glob call's absolute pattern into the { path, pattern } pair
+ * the tool actually supports; any existing `path` is superseded (an
+ * absolute pattern already names its root). Pure; returns the input on any
+ * miss.
+ */
+export function translateGlobArguments(args, env) {
+  if (!args || typeof args !== 'object' || typeof args.pattern !== 'string') return args
+  const split = splitGlobPrefix(args.pattern)
+  if (!split) return args
+  const prefix = normalizeAbsolutePrefix(split.prefix, env)
+  if (!prefix) return args
+  return { ...args, pattern: split.rest, path: prefix }
+}
+
+
 // ── dsh-better-sidebar shell cooperation ───────────────────────────────────
 //
 // dsh-better-sidebar (v0.15.2+) resolves its terminal shell PER OPEN: a
@@ -1160,7 +1341,12 @@ export async function apply(ctx, config = {}) {
       ctx.on('tools/execute', (exec, next) => {
         try {
           if (exec && exec.arguments && typeof exec.arguments === 'object' && readPosixPaths(ctx)) {
-            const translated = translatePathArguments(exec.arguments)
+            const env = buildTranslateEnv()
+            let translated = translatePathArguments(exec.arguments, env)
+            if (exec.name === 'glob') {
+              const globTranslated = translateGlobArguments(translated, env)
+              if (globTranslated !== translated) translated = globTranslated
+            }
             if (translated !== exec.arguments) exec.arguments = translated
           }
         } catch { /* never block a call on translation */ }
@@ -1185,7 +1371,7 @@ export async function apply(ctx, config = {}) {
         let patch
         try {
           if (readPosixPaths(ctx) && result && result.isError === false && result.value && typeof result.value === 'object') {
-            const value = rewriteResultPaths(exec && exec.name, result.value)
+            const value = rewriteResultPaths(exec && exec.name, result.value, buildTranslateEnv())
             if (value !== result.value) patch = value
           }
         } catch { /* never block a result */ }
@@ -1324,4 +1510,4 @@ export async function apply(ctx, config = {}) {
 }
 
 // Test surface: pure helpers, no Cordis context required.
-export const _internal = { PRESET_IDS, translateMsysPath, translatePathArguments, readPosixPaths, readAdoptSidebar, windowsToMsys, rewriteResultPaths, MARKER_FILE, classify, materialize, cleanupOnDispose, firstUserRoot, hashTree, skillsHashes, syncDecision, installRegisterShim, baseForRoster, detectBase, pickComposition, personaEraForText, detectPersonaEra, injectPresentRow, hostHasToolPresent, detectPresentSupport, injectPluginManagerRow, hostHasPluginManagerTools, rowFormOf, rowFormsOf, alignEngineRow, alignRalphRow, ROW_SOURCE }
+export const _internal = { PRESET_IDS, translateMsysPath, translatePathArguments, translateGlobArguments, buildTranslateEnv, readPosixPaths, readAdoptSidebar, windowsToMsys, rewriteResultPaths, MARKER_FILE, classify, materialize, cleanupOnDispose, firstUserRoot, hashTree, skillsHashes, syncDecision, installRegisterShim, baseForRoster, detectBase, pickComposition, personaEraForText, detectPersonaEra, injectPresentRow, hostHasToolPresent, detectPresentSupport, injectPluginManagerRow, hostHasPluginManagerTools, rowFormOf, rowFormsOf, alignEngineRow, alignRalphRow, ROW_SOURCE }