@hwfee/dsh-git-bash 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,65 @@
-# Temporary Holding Version
+# dsh-git-bash · Git Bash 默认 shell
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在 Windows 上把 DeepSeek Harness 的命令解释器从 PowerShell 换成 **Git Bash**。
+
+装好之后：模型跑的 `bash` 命令走 Git Bash，`grep`、`sed`、`find`、`&&`、`$VAR`、shebang 脚本都按 POSIX 语义工作，路径就是你项目所在的那个文件系统。
+
+## 安装
+
+```bash
+dsh plugin --profile desktop add @hwfee/dsh-git-bash
+```
+
+**装完必须彻底退出并重开 DSH。**
+
+卸载：
+
+```bash
+dsh plugin --profile desktop remove @hwfee/dsh-git-bash
+```
+
+## 它怎么找到 Git Bash
+
+按顺序试四个来源，第一个成功的就算数：
+
+1. **`DSH_GIT_BASH` 环境变量** —— 指向 `bash.exe` 的完整路径。非标准安装位置用这个。
+2. **`git --exec-path`** —— 得到 `…/Git/mingw64/libexec/git-core`，往上两级就是 Git 根目录，取它自带的 `bin/bash.exe`。
+3. **常见安装位置** —— `C:\Program Files\Git\bin\bash.exe` 等。
+4. POSIX 上直接用 PATH 里的 `bash`。
+
+**为什么不用 `where bash`。** Windows 上 `bash` 常常解析到 `C:\Windows\System32\bash.exe` —— WSL 的替身。它确实是 bash，但它是**另一个文件系统**（`/mnt/c/...`）、另一个用户、而且没有 Windows 那份 `git`。选错它之后每条命令都以一种看起来像"插件坏了"的方式失败，所以这里宁可找不到也不误选。
+
+找不到时插件**不会消失**：设置里的那一行会显示「没找到 Git Bash」并告诉你怎么指定路径。
+
+## 设置
+
+设置 → 通用设置，多出一行 **默认 shell**：
+
+- 上面显示**实际找到的路径**，一眼能看出用的是哪个 bash
+- 下面一个开关 **保留系统 shell 工具**（默认开）—— 关掉后模型的工具列表里只剩 `run_shell`，不再有平台的 PowerShell 工具
+
+## 它会给你什么
+
+**`run_shell` 工具。** 参数 `command`（必填）和 `workdir`（可选，绝对路径）。返回运行它的 shell 路径、退出码、stdout 和 stderr。
+
+**非零退出不是错误。** `grep` 没匹配到会退出 1，那是一个结果而不是故障，工具照常返回退出码和输出。只有"shell 根本起不来"才算错误。
+
+## 与宿主 shell 的关系
+
+宿主的 shell 是 `ctx.shell` 能力接缝，**每个上下文只能有一个实现**。Windows 上基础 bundle 组装的是 `pwsh-sandbox`（PowerShell），POSIX 上是 `bash-sandbox`。
+
+**`run_shell` 尽量走宿主的执行器，并在结果里说明走没走。** 选中的解释器作为命令交给 `ctx.shell`：PowerShell 模式下是 `& '<pwsh.exe>' -NoProfile -NonInteractive -Command '<command>'`，结果显示 `· host`，沙箱、取消、工作目录和进程生命周期都归宿主。**Git Bash 在 Windows 上是个例外**：沙箱里的 pwsh 无法创建 MSYS 进程（`NtCreateDirectoryObject 0xC0000022`，已实测），所以这一模式仍由插件直接启动，结果显示 `· direct` 并附一句「未经过沙箱」。这不是静默降级——每一条结果都会写清楚。代价是本工具**不能**替用户发起沙箱升级审批（那是原生 `pwsh` 工具的职责），被拒绝时会如实报错。
+
+**模式的切换会真的到宿主。** 设置行在浏览器进程里，`run_shell` 在宿主进程里；两者之间有一条带同源头围栏的 `POST /dsh-git-bash/mode`（`GET` 可读回当前值）。只发 Cordis 事件是不够的——那个事件跨不过进程边界，宿主会永远停在 `auto`。
+
+因此"让 Git Bash 成为默认"是 **profile 层**的决定，不是运行时劫持：本包的 `cordis.patch.yml` 只插入自己的行；要让 Git Bash 接管，需要在 profile 的 `cordis.patch.yml` 里用 `disabled:` 关掉平台默认的那一行。这样做的后果是**宿主的 PowerShell 执行器不再可用**——如果你需要它，别关那一行，改用 `run_shell` 与 `pwsh` 并存（即保留开关，让两个工具都在）。
+
+## 开发者
+
+```bash
+cd plugins/git-bash
+npm test        # 新鲜度 + 清单契约 + 解析 + 工具 + 状态，31 项
+npm run build   # 重新生成 client/client.js（产物提交进 git）
+```
+
+目录职责、改包名的四个位置、发布流程见仓库根 [AGENTS.md](../../AGENTS.md)。

package/client/client.js

@@ -0,0 +1,504 @@
+/**
+ * The browser half of `@hwfee/dsh-git-bash`.
+ *
+ * It contributes ONE settings row: which shell is in use, and whether the
+ * platform's own shell tool stays exposed. No card, no tool view — the shell
+ * itself runs on the Host.
+ *
+ * React comes from the host's frozen module table; it is absent in a Node
+ * import (the unit tests load this file for its `name`), so the entry degrades
+ * to a no-op apply instead of throwing.
+ */
+
+window.__ModuleLoader__.load({
+  id: "@hwfee/dsh-git-bash",
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+    var __defProp = Object.defineProperty;
+    var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+    var __getOwnPropNames = Object.getOwnPropertyNames;
+    var __hasOwnProp = Object.prototype.hasOwnProperty;
+    var __export = (target, all) => {
+      for (var name2 in all)
+        __defProp(target, name2, { get: all[name2], enumerable: true });
+    };
+    var __copyProps = (to, from, except, desc) => {
+      if (from && typeof from === "object" || typeof from === "function") {
+        for (let key of __getOwnPropNames(from))
+          if (!__hasOwnProp.call(to, key) && key !== except)
+            __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+      }
+      return to;
+    };
+    var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+    // client/src/index.js
+    var index_exports = {};
+    __export(index_exports, {
+      apply: () => apply,
+      inject: () => inject,
+      name: () => name
+    });
+    module.exports = __toCommonJS(index_exports);
+
+    // client/src/constants.js
+    var PLUGIN_ID = "@hwfee/dsh-git-bash";
+    var LOCALE_NS = "dsh-git-bash";
+    var SETTINGS_ROW_ID = PLUGIN_ID + "-shell";
+
+    // client/src/locales.js
+    var en = {
+      "shell.title": "Default shell",
+      "shell.hint": "Which interpreter runs shell commands.",
+      "shell.mode": "Shell mode",
+      "shell.mode.auto": "Automatic",
+      // The user's own wording for the option. Which BUILD ran (7 vs 5.1) is a
+      // detail the row does not show; the tool result names it per call.
+      "shell.mode.pwsh": "Windows PowerShell",
+      "shell.mode.gitbash": "Git Bash",
+      "shell.current": "{kind} \xB7 {path}",
+      "shell.notFound": "No shell resolved",
+      "shell.kind.gitbash": "Git Bash",
+      "shell.kind.posix-bash": "bash",
+      "shell.kind.pwsh": "PowerShell 7",
+      "shell.kind.windows-powershell": "Windows PowerShell 5.1",
+      "shell.reason.gitbash-not-found": "Git Bash not found. Install Git for Windows, or set DSH_GIT_BASH.",
+      "shell.reason.pwsh-not-found": "PowerShell not found. Install PowerShell 7 or Windows PowerShell.",
+      "shell.reason.no-shell-for-platform": "Windows PowerShell is only available on Windows.",
+      "shell.reason.no-shell-found": "No usable shell was found. Install Git for Windows, or set DSH_GIT_BASH."
+    };
+    var zh = {
+      "shell.title": "\u9ED8\u8BA4 shell",
+      "shell.hint": "\u7528\u54EA\u4E2A\u89E3\u91CA\u5668\u6267\u884C shell \u547D\u4EE4\u3002",
+      "shell.mode": "Shell \u6A21\u5F0F",
+      "shell.mode.auto": "\u81EA\u52A8",
+      "shell.mode.pwsh": "Windows PowerShell",
+      "shell.mode.gitbash": "Git Bash",
+      "shell.current": "{kind} \xB7 {path}",
+      "shell.notFound": "\u6CA1\u6709\u89E3\u6790\u5230 shell",
+      "shell.kind.gitbash": "Git Bash",
+      "shell.kind.posix-bash": "bash",
+      "shell.kind.pwsh": "PowerShell 7",
+      "shell.kind.windows-powershell": "Windows PowerShell 5.1",
+      "shell.reason.gitbash-not-found": "\u6CA1\u627E\u5230 Git Bash\u3002\u8BF7\u5B89\u88C5 Git for Windows\uFF0C\u6216\u8BBE\u7F6E DSH_GIT_BASH\u3002",
+      "shell.reason.pwsh-not-found": "\u6CA1\u627E\u5230 PowerShell\u3002\u8BF7\u5B89\u88C5 PowerShell 7 \u6216 Windows PowerShell\u3002",
+      "shell.reason.no-shell-for-platform": "Windows PowerShell \u53EA\u5728 Windows \u4E0A\u53EF\u7528\u3002",
+      "shell.reason.no-shell-found": "\u6CA1\u6709\u53EF\u7528\u7684 shell\u3002\u8BF7\u5B89\u88C5 Git for Windows\uFF0C\u6216\u8BBE\u7F6E DSH_GIT_BASH\u3002"
+    };
+
+    // lib/mode.js
+    var MODES = ["auto", "pwsh", "gitbash"];
+    var DEFAULT_MODE = "auto";
+    var MODE_LABELS = {
+      auto: "shell.mode.auto",
+      pwsh: "shell.mode.pwsh",
+      gitbash: "shell.mode.gitbash"
+    };
+    var KIND_LABELS = {
+      gitbash: "shell.kind.gitbash",
+      "posix-bash": "shell.kind.posix-bash",
+      pwsh: "shell.kind.pwsh",
+      "windows-powershell": "shell.kind.windows-powershell"
+    };
+    var REASON_LABELS = {
+      "gitbash-not-found": "shell.reason.gitbash-not-found",
+      "pwsh-not-found": "shell.reason.pwsh-not-found",
+      "no-shell-for-platform": "shell.reason.no-shell-for-platform",
+      "no-shell-found": "shell.reason.no-shell-found"
+    };
+    var LEGACY_BOOLEAN_KEY = "@hwfee/dsh-git-bash:exposeNativeShell";
+    function isMode(value) {
+      return typeof value === "string" && MODES.includes(value);
+    }
+    function normalizeMode(value) {
+      return isMode(value) ? value : DEFAULT_MODE;
+    }
+    function readMode(storage, key) {
+      if (storage === null || storage === void 0) return DEFAULT_MODE;
+      let raw;
+      try {
+        raw = storage.getItem(key);
+      } catch {
+        return DEFAULT_MODE;
+      }
+      return normalizeMode(raw);
+    }
+    function writeMode(storage, key, mode) {
+      if (storage === null || storage === void 0) return false;
+      if (!isMode(mode)) return false;
+      try {
+        storage.setItem(key, mode);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    function migrateLegacyMode(storage, key) {
+      if (storage === null || storage === void 0) return null;
+      let current;
+      try {
+        current = storage.getItem(key);
+      } catch {
+        return null;
+      }
+      if (isMode(current)) return null;
+      let legacy;
+      try {
+        legacy = storage.getItem(LEGACY_BOOLEAN_KEY);
+      } catch {
+        return null;
+      }
+      const migrated = legacy === "false" ? "gitbash" : legacy === "true" ? DEFAULT_MODE : null;
+      if (migrated === null) return null;
+      try {
+        storage.setItem(key, migrated);
+      } catch {
+      }
+      return migrated;
+    }
+
+    // client/src/store.js
+    var MODE_KEY = PLUGIN_ID + ":mode";
+    var SHELL_GLOBAL = "__dshGitBash";
+    function createShellInfoStore(carrier) {
+      const raw = carrier === void 0 ? void 0 : carrier[SHELL_GLOBAL];
+      const valid = raw !== null && typeof raw === "object";
+      const normalize = (record) => {
+        const entry = record !== null && typeof record === "object" ? record : {};
+        return {
+          path: typeof entry.path === "string" ? entry.path : null,
+          kind: typeof entry.kind === "string" ? entry.kind : null,
+          source: typeof entry.source === "string" ? entry.source : null,
+          reason: typeof entry.reason === "string" ? entry.reason : null
+        };
+      };
+      const byMode = valid && raw.byMode !== null && typeof raw.byMode === "object" ? raw.byMode : null;
+      const active = valid && raw.active !== null && typeof raw.active === "object" ? raw.active : raw;
+      const single = normalize(active);
+      const snapshots = byMode === null ? null : Object.fromEntries(Object.entries(byMode).map(([key, value]) => [key, normalize(value)]));
+      return {
+        /**
+         * The resolution for one mode.
+         *
+         * Falls back to the active record when the mode is unknown, so a stale or
+         * future value still shows SOMETHING rather than an empty row.
+         *
+         * @param {string} mode one of the three modes
+         * @returns {object} the resolution
+         */
+        forMode(mode) {
+          if (snapshots === null) return single;
+          return snapshots[mode] ?? single;
+        },
+        getSnapshot: () => single,
+        subscribe: () => () => {
+        },
+        dispose: () => {
+        }
+      };
+    }
+    function createModeStore(storage) {
+      migrateLegacyMode(storage, MODE_KEY);
+      let current = readMode(storage, MODE_KEY);
+      const listeners = /* @__PURE__ */ new Set();
+      return {
+        getSnapshot: () => current,
+        subscribe(listener) {
+          listeners.add(listener);
+          return () => {
+            listeners.delete(listener);
+          };
+        },
+        set(value) {
+          if (!MODES.includes(value) || value === current) return;
+          current = value;
+          writeMode(storage, MODE_KEY, value);
+          for (const listener of listeners) listener();
+        },
+        dispose() {
+          listeners.clear();
+        }
+      };
+    }
+    function describeShell(info, t) {
+      if (info.path === null) {
+        return t(info.reason === null ? "shell.notFound" : REASON_LABELS[info.reason] ?? "shell.notFound");
+      }
+      const kind = info.kind === null ? "" : t(KIND_LABELS[info.kind] ?? info.kind);
+      return t("shell.current", { path: info.path, kind });
+    }
+
+    // client/src/settings-row.js
+    function createSettingsRow({ React: React2, primitives: primitives2 }) {
+      const h = React2.createElement;
+      const Menu = primitives2 === null ? null : primitives2.Menu;
+      const MenuItemButton = primitives2 === null ? null : primitives2.MenuItemButton;
+      const IconChevron = primitives2 === null ? null : primitives2.IconChevronDownOutlineRegular;
+      const IconCheck = primitives2 === null ? null : primitives2.IconCheckOutlineRegular;
+      function ShellRow(props) {
+        const t = props.t;
+        const mode = React2.useSyncExternalStore(props.modeStore.subscribe, props.modeStore.getSnapshot);
+        const info = props.shellInfoStore.forMode(mode);
+        const [open, setOpen] = React2.useState(false);
+        const title = h("div", { className: "dsh-git-bash-title" }, t("shell.title"));
+        const hint = h("div", { className: "dsh-git-bash-hint" }, t("shell.hint"));
+        const failure = info.path === null ? h("div", { className: "dsh-git-bash-status dsh-git-bash-missing" }, describeShell(info, t)) : null;
+        const label = t("shell.mode");
+        const choose = (value) => {
+          props.setMode(value);
+          setOpen(false);
+        };
+        if (Menu === null || MenuItemButton === null) {
+          return h(
+            "div",
+            { className: "dsh-git-bash-row", id: SETTINGS_ROW_ID },
+            h("div", { className: "dsh-git-bash-main" }, title, hint, failure),
+            h("select", {
+              className: "dsh-git-bash-select",
+              "aria-label": label,
+              value: mode,
+              onChange: (event) => props.setMode(event.target.value)
+            }, MODES.map((value) => h("option", { key: value, value }, t(MODE_LABELS[value]))))
+          );
+        }
+        const trigger = (isOpen) => h(
+          "button",
+          {
+            type: "button",
+            className: "dsh-git-bash-trigger",
+            "aria-label": label,
+            "aria-haspopup": "menu",
+            "aria-expanded": isOpen,
+            onClick: () => setOpen(!isOpen)
+          },
+          h("span", { className: "dsh-git-bash-value" }, t(MODE_LABELS[mode])),
+          IconChevron === null ? "\u25BE" : h(IconChevron, { size: 12 })
+        );
+        const items = MODES.map((value) => h(MenuItemButton, {
+          key: value,
+          onSelect: () => choose(value)
+        }, h(
+          "span",
+          { className: "dsh-git-bash-item" },
+          h("span", null, t(MODE_LABELS[value])),
+          value === mode && IconCheck !== null ? h("span", { className: "dsh-git-bash-check" }, h(IconCheck, { size: 14 })) : null
+        )));
+        return h(
+          "div",
+          { className: "dsh-git-bash-row", id: SETTINGS_ROW_ID },
+          h("div", { className: "dsh-git-bash-main" }, title, hint, failure),
+          h(Menu, {
+            open,
+            anchor: trigger(open),
+            items: [],
+            onSelect: () => setOpen(false),
+            onClose: () => setOpen(false),
+            align: "end",
+            portal: true,
+            autoFocus: false
+          }, ...items)
+        );
+      }
+      return ShellRow;
+    }
+
+    // client/src/styles.js
+    var STYLE_MARKER = "data-dsh-git-bash-style";
+    var CSS = `
+    .dsh-git-bash-row {
+      display: flex;
+      align-items: flex-start;
+      justify-content: space-between;
+      gap: 24px;
+      padding: 16px 0;
+      /* NO border of our own. cds-theme owns the rule that draws the hairline under
+         every settings row (the slot-child selector), and its selector is more
+         specific than a single class \u2014 so a border here LOSES and the row ends up
+         with the theme's line anyway. Declaring it was worse than useless: it made
+         this row's line look different from its neighbours whenever the specificity
+         race went the other way. The theme draws it; the row leaves space for it. */
+    }
+
+    .dsh-git-bash-main {
+      min-width: 0;
+      flex: 1;
+    }
+
+    .dsh-git-bash-title {
+      font-size: var(--dsh-content-font-size, 14px);
+      line-height: 22px;
+      color: var(--dsw-alias-label-primary);
+    }
+
+    .dsh-git-bash-hint {
+      margin-top: 2px;
+      font-size: var(--dsh-content-font-size-caption, 12px);
+      line-height: 18px;
+      color: var(--dsw-alias-label-tertiary);
+    }
+
+    .dsh-git-bash-status {
+      margin-top: 6px;
+      font-size: var(--dsh-content-font-size-caption, 12px);
+      line-height: 18px;
+      color: var(--dsw-alias-label-secondary);
+      /* A Windows path is long and has no spaces to break at, so wrap anywhere
+         rather than let it push the menu off the row. */
+      overflow-wrap: anywhere;
+    }
+
+    .dsh-git-bash-missing {
+      color: var(--dsw-alias-state-error-primary, var(--dsw-alias-code-diff-deleted));
+    }
+
+    /* The trigger states the current mode, so the row is readable without opening
+       the menu \u2014 the same shape the host's own multi-value rows use. */
+    .dsh-git-bash-trigger {
+      display: inline-flex;
+      align-items: center;
+      gap: 6px;
+      flex: none;
+      align-self: flex-start;
+      height: 32px;
+      padding: 0 12px;
+      border: 0;
+      border-radius: var(--dsw-radius-md);
+      background: var(--dsw-alias-bg-layer-2);
+      color: var(--dsw-alias-label-primary);
+      font: inherit;
+      font-size: var(--dsh-content-font-size-secondary, 13px);
+      cursor: pointer;
+    }
+
+    .dsh-git-bash-trigger:hover {
+      background: var(--dsw-alias-interactive-bg-hover);
+    }
+
+    .dsh-git-bash-trigger:focus-visible {
+      outline: 2px solid var(--dsw-alias-brand-primary);
+      outline-offset: 1px;
+    }
+
+    .dsh-git-bash-select {
+      flex: none;
+      align-self: flex-start;
+      height: 32px;
+      padding: 0 8px;
+      border: 0.5px solid var(--dsw-alias-border-l1);
+      border-radius: var(--dsw-radius-md);
+      background: var(--dsw-alias-bg-layer-2);
+      color: var(--dsw-alias-label-primary);
+      font: inherit;
+      font-size: var(--dsh-content-font-size-secondary, 13px);
+    }
+
+    /* One row per mode inside the popup, with a check on the active one. */
+    .dsh-git-bash-item {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 16px;
+      min-width: 190px;
+    }
+
+    .dsh-git-bash-check {
+      display: inline-flex;
+      color: var(--dsw-alias-brand-primary);
+    }
+    `;
+    function installCss(doc) {
+      if (doc === void 0 || doc === null || typeof doc.createElement !== "function") {
+        return function disposeWithoutDocument() {
+        };
+      }
+      const previous = doc.querySelector(`style[${STYLE_MARKER}]`);
+      if (previous !== null) previous.remove();
+      const tag = doc.createElement("style");
+      tag.setAttribute(STYLE_MARKER, "");
+      tag.textContent = CSS;
+      doc.head.append(tag);
+      return function dispose() {
+        tag.remove();
+      };
+    }
+
+    // client/src/lifecycle.js
+    var MODE_EVENT = "git-bash/mode";
+    var MODE_PATH = "/dsh-git-bash/mode";
+    var MODE_MARKER_HEADER = "x-dsh-git-bash";
+    function createLifecycle({ React: React2, primitives: primitives2 }) {
+      const ShellRow = createSettingsRow({ React: React2, primitives: primitives2 });
+      return function apply2(ctx) {
+        ctx.effect(() => {
+          return ctx.locale.register(LOCALE_NS, { en, zh });
+        }, "dsh-git-bash: strings");
+        ctx.effect(
+          () => installCss(typeof document === "undefined" ? void 0 : document),
+          "dsh-git-bash: row stylesheet"
+        );
+        const storage = typeof localStorage === "undefined" ? void 0 : localStorage;
+        const shellInfo = createShellInfoStore(
+          typeof globalThis === "undefined" ? void 0 : globalThis
+        );
+        ctx.effect(() => () => shellInfo.dispose(), "dsh-git-bash: shell info store");
+        const modeStore = createModeStore(storage);
+        ctx.effect(() => () => modeStore.dispose(), "dsh-git-bash: mode store");
+        const publish = () => {
+          const mode = modeStore.getSnapshot();
+          ctx.emit(MODE_EVENT, { mode });
+          if (typeof fetch !== "function") return;
+          try {
+            void fetch(MODE_PATH, {
+              method: "POST",
+              credentials: "same-origin",
+              keepalive: true,
+              headers: {
+                "content-type": "application/json",
+                [MODE_MARKER_HEADER]: "1"
+              },
+              body: JSON.stringify({ mode })
+            }).catch(() => {
+            });
+          } catch (error) {
+          }
+        };
+        publish();
+        ctx.effect(() => modeStore.subscribe(publish), "dsh-git-bash: publish mode");
+        ctx.slots.inject("settings.general.item", () => ctx.slots.register({
+          name: "settings.general.item",
+          id: SETTINGS_ROW_ID,
+          order: 43,
+          locale: LOCALE_NS,
+          // The stores as ORDINARY props, not a `hooks` entry: a function component
+          // receives props, while `hooks:` builds a `useName(selector)` prop that
+          // only a framework-aware occupant reads. See `store.js`.
+          inject: () => ({
+            modeStore,
+            shellInfoStore: shellInfo,
+            setMode: (value) => modeStore.set(value)
+          })
+        }, ShellRow));
+      };
+    }
+
+    // client/src/index.js
+    var name = PLUGIN_ID;
+    var inject = ["slots", "locale"];
+    var React = null;
+    try {
+      React = require("react");
+    } catch (error) {
+      React = null;
+    }
+    var primitives = null;
+    try {
+      primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+    } catch (error) {
+      primitives = null;
+    }
+    var apply = React === null ? function applyWithoutReact() {
+    } : createLifecycle({ React, primitives });
+    return module.exports
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh bundle patch: inserts this plugin into a profile's layer stack.
+#
+# `name` MUST equal the package's own `name` field. When the two disagree the
+# Loader cannot resolve this row to a package, the row never activates, and the
+# plugin silently disappears — no error surfaces anywhere. See AGENTS.md.
+- insert:
+    - id: dsh-git-bash
+      name: '@hwfee/dsh-git-bash'

package/icon.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" width="48" height="48" role="img" aria-label="Generative UI">
+  <!--
+    Original artwork, MIT, drawn for this plugin.
+
+    The mark reads as a card whose contents are being composed: a rounded frame
+    (the card), a filled accent bar (a chart/answer emerging), and two ghost
+    bars (content still forming). Neutral enough to sit beside any theme; the
+    two outer colours are the plugin's own, the accent matches the clay used by
+    cds-theme without depending on it.
+  -->
+  <rect x="4.5" y="8.5" width="39" height="31" rx="6" fill="none" stroke="#c6613f" stroke-width="2.4"/>
+  <rect x="11" y="16" width="9" height="16" rx="2.4" fill="#c6613f"/>
+  <rect x="24" y="16" width="13" height="4.6" rx="2.3" fill="#c6613f" opacity="0.75"/>
+  <rect x="24" y="24" width="13" height="4.6" rx="2.3" fill="#c6613f" opacity="0.4"/>
+  <rect x="24" y="32" width="7" height="2.2" rx="1.1" fill="#c6613f" opacity="0.22"/>
+</svg>