dsh-composer-ux 0.18.0 → 0.19.1

package/CHANGELOG.md

@@ -2,6 +2,44 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.19.1] — 2026-10-09（只改文档：README 的变异条数写旧了）
+
+0.19.0 发版时 README 里那句变异条数还写着上一版的 **174**，而这一版实际跑出来是 **180**
+（新增 GZ/HA/HB/HC/HD/HE 六条）。`npm run gates` 的文档门禁当场抓住了它 —— 但 0.19.0 的
+tarball 已经发出去了，所以补一个文档修正版。
+
+**代码零改动**：29 个套件 2540 条 0 失败、变异 180/180 与 0.19.0 完全一致，只是把 README 里
+那两个数字改成事实。
+
+## [0.19.0] — 2026-10-09（「工作区目录选择」加设置开关，默认关）
+
+用户 2026-10-09：在设置里加一个条目让这个功能可以开关、**默认关闭**。
+
+0.18.0 把它做成了"装了就生效"，而它的做法是**接管官方那两个目录流程槽位**（优先级 -1 的 shadow，
+见 0.18.0 那节）—— 属于改默认行为，不打招呼就换掉别人的选择框是越界。所以这一版补上开关：
+
+- 设置 →「输入体验」→ 卡片「**工作区目录选择**」（在「微信通知」下面），**默认关**；
+- **即时生效**，不用重启：客户端半订阅设置快照，开就装、关就卸、再开重装
+  （`createDirectoryFlowController` 保证幂等 —— 同一个槽位同优先级重复注册会当场抛错，
+  所以"幂等"不是优化而是必需）；
+- **关掉即回到官方原样**：官方那条默认优先级 `0` 的条目立刻成为最低者，界面回到官方对话框；
+- 卡片正文把四件事说清：改了哪个框（系统文件夹框 / 任意盘符 / 不用手输路径）、只在桌面应用里生效、
+  手机与浏览器不变、以及官方自己承认的那条「不枚举盘符根 —— 跨盘依赖浏览器 UI 的路径输入入口」。
+
+**代码**：`settings-contract.ts`（字段 `directoryPickEnabled`，默认 `false`，含类型与净化）、
+`directory-flow.ts`（`installDirectoryFlow` 改为返回卸载句柄；新增 `createDirectoryFlowController`）、
+`client.tsx`（改成 `ctx.effect` + `live.subscribe` 的同步器：启动同步一次、每次设置变化同步、卸载退订）、
+`SettingsSection.tsx`（新增卡片 + 标题行开关；卡内不留第二个开关）。
+
+**验证**：`npm test` —— **29 个套件 2540 passed / 0 failed**（`directory-flow` 37→49：新增控制器 12 条，
+覆盖幂等 / 关掉卸载 / 反复拨 / 远端不装；`settings-render` 92→102：新增第 9 节把两种概览、标题行开关
+随设置值、正文四件事与"卡内没有第二个开关"钉住；`client-registration` 248→256：字段 / 默认值 / 净化 /
+订阅 / 退订的接线）。`npm run test:mutations` —— **180 条全部咬住**（新增 GZ/HA/HB/HC/HD/HE：控制器
+不幂等、关掉不卸、默认值改成开、净化不读该字段、客户端写死 `true`、设置页不渲染这张卡）。
+
+**注意**：默认关意味着**升级后这个开关是关的** —— 想用系统文件夹框的人需要自己去设置里拨一下
+（即时生效，不用重启）。
+
 ## [0.18.0] — 2026-10-09（工作区目录选择：桌面弹系统文件夹框，手机/远端仍用官方应用内框）
 
 用户 2026-10-09：先要「换盘不用手输」，选了 A 方案（profile 补丁钉官方 `-native`，实测通过），

package/README.md

@@ -475,7 +475,7 @@ Windows 上 DSH 给模型的终端工具是 **PowerShell**（工具名 `pwsh`）
 - **六条自开路由全部过了官方那道关卡**：`connection.requestRejection(request)`（Host/Origin 围栏 + 浏览器登录令牌）。`webServer` 是可以绑 `0.0.0.0` 的，漏掉它等于把会话用量、设置写入与**账号余额**摊给同网段任何一台机器 —— 2026-09-29 评审时先补了金额那三条，同日对比社区插件时又发现**「优化提示词」与「快捷指令存储」这两条也漏着**（一个花你的模型额度、一个会覆盖你的提示词库），一并补上，且关卡摆在**读请求体之前**（被拒的请求连 body 都不读）。现在 6/6：用量、价目同步、余额、重启、优化、快捷指令存储（终端状态那条在 `terminal/host.ts` 里自带同一道关卡）。变异 `CN`/`CO` 守着这两条。
 - **与出处有意不同的两处**（都钉在测试里）：① 金额**至少保留两位小数**（出处会把 `0.1` 显示成 `¥0.1`、把 `0` 显示成 `¥0.`）；② **覆盖价的币种语义**——出处是"有覆盖价时先整体重建人民币档、美元再从人民币折算"，写成"在美元列上套覆盖价再折算"会差一个汇率（≈15 倍）而屏幕上只是个数字，所以专门有一条断言守着。
 
-## 工作区目录选择：桌面用系统文件夹框，手机/远端用官方应用内框（0.18.0）
+## 工作区目录选择：设置里开关，桌面用系统文件夹框、手机/远端用官方应用内框（0.18.0 起，0.19.0 起可开关且默认关）
 
 **为什么会有这一节**：DSH 官方的目录选择是两个**互斥**的界面 —— `-native`（本机 OS 选择器，Windows 上就是系统文件夹框）与 `-browse`（应用内 Miller 分栏对话框），由 `-auto` 在**宿主启动时**二选一，判据只有「绑定地址 / SSH / 平台」，**不看客户端是谁**。官方在 `-browse` 的 README「已知限制」里承认了由此产生的缺口：
 
@@ -483,24 +483,33 @@ Windows 上 DSH 给模型的终端工具是 **PowerShell**（工具名 `pwsh`）
 
 于是本机换盘必须手输路径；而社区 bundle `dsh-mobile` 为了手机端能选目录又把 browse 钉死，连桌面也一起用上了应用内框（官方把「按客户端自适应」明确列为 deferred）。
 
+**开关在哪儿**：设置 →「输入体验」→ 卡片「**工作区目录选择**」（在「微信通知」下面）。**默认关**，拨一下就即时生效（不用重启）。
+
+- **关（默认）**：完全不管这件事，桌面用的是官方那个应用内浏览对话框（与没装本插件时一致）。
+- **开**：桌面应用里点「选择工作区目录」→ 直接弹 **Windows 系统文件夹框**：任意盘符点进去、可新建文件夹，**不用手输路径**。
+
+为什么默认关：这一项的做法是**接管官方那两个目录流程槽位**（把官方的框换成系统的框），属于改默认行为 —— 不打招呼就换掉别人的选择框是越界，所以留给你自己点（与「微信通知」总开关默认关同一个理由）。
+
 **本插件怎么做的**（不改官方任何文件、不抄官方那一千多行界面）：用槽位自身的 shadow 能力 —— 官方 `ui-slots` 的规则是「entries sharing one cell coexist at distinct priorities … the cell's lowest live entry renders」，只有**同优先级**的第二次注册才报错：
 
-| 客户端 | 有没有 preload 桥 | 本插件 | 你看到什么 |
+| 客户端 | 有没有 preload 桥 | 开关打开时本插件 | 你看到什么 |
 |---|---|---|---|
 | 桌面应用（`DeepSeek Harness.exe`） | 有（`window.__DSH_DIRECTORY_PICKER__`） | 在优先级 `-1` 上接管这两个目录流程槽位 | 直接弹 **Windows 文件夹框**：任意盘符点进去、可新建文件夹，**不用手输** |
 | 手机 / 远端浏览器 | 没有 | **一个槽位都不注册** | 官方那个应用内浏览对话框（路径输入、层级列表、隐藏文件开关、新建文件夹） |
 
-所以两件事同时成立：桌面不再手输盘符，手机端体验**零退化**；也**不需要任何 profile 补丁**（插件不装 = 恢复官方原样）。
+所以两件事同时成立：桌面不再手输盘符，手机端体验**零退化**；也**不需要任何 profile 补丁**（插件不装或开关关着 = 官方原样）。
 
 几条边界（都是刻意的）：
 
 - **判据是 preload 桥，不是"你是不是本机"**：在电脑上用普通浏览器打开 `127.0.0.1:19387`（不是桌面应用窗口）也会走应用内框 —— 客户端拿不到"我离宿主多远"这个事实，官方把「按连接自适应」列为 deferred。
+- **关掉要能真的卸掉**：开关是运行时值，用户会在不重启的情况下反复拨。`createDirectoryFlowController` 负责幂等装卸（开就装、关就卸、再开重装），`test/directory-flow.mjs` 第七节 12 条盯着它，变异 `GZ`/`HA` 盯着"幂等"与"关掉要卸"。
 - **优先级必须是负数**：官方界面注册在默认优先级 `0`；同优先级会撞上「第二次注册」⇒ 安装期直接抛 `single slot "…" already has a registration`，整块客户端插件挂不上。`test/directory-flow.mjs` 钉住这条。
 - **一条上升沿只弹一次**：持有方正在采纳（`open` 仍为 true、`busy`）时的重渲染不会再弹一次；`open` 落回才重新上膛。
 - **卸载后迟到的结果丢弃**：原生对话框没有按请求中止的能力；HMR 换掉占用者后旧实例的请求仍会落地，让它去 `onPicked` 会凭空多出一个工作区。
 - **取消与失败各是一条路**：取消（`pick` resolve 成 null）→ 持有方只关掉流程；失败（抛异常）→ 界面显示 `Error.message`（不是 `Error: xxx`）。
 - **只依赖槽位服务**：本插件客户端半的 `inject` 仍然只有 `slots`，没有引入 `uiWorkspace` —— 少一个依赖就少一种"等不到依赖而整块不挂载"的死法。
 
+
 ## 维护：重启 DSH
 
 装了新插件、改了宿主半代码（比如本插件的「默认终端」、键位 schema）之后，DSH 需要重启才会加载新代码。设置页「输入体验」卡片**抬头右端**（GitHub 链接左边）有一枚「重启 DSH」。
@@ -544,8 +553,8 @@ Windows 上 DSH 给模型的终端工具是 **PowerShell**（工具名 `pwsh`）
 | 工具循环的消息形状 / 轮次封顶 / 异常必须降级 | 同上第 6 节（假 llm 驱动整条循环，逐条检查 `role:'tool'` 与 `toolCallId`） |
 | 工具路径：默认关、开了才派、**查完吐散文必须回落**、拿不到工作目录就不派 | `test/quick-commands.mjs` 5g 节（13 条，真路由 + 假 llm） |
 | 工具读到的内容不进台账 | 同 5g 节：断言台账里只有工具名与次数、没有读到的文件内容 |
-| 变异守卫真的会咬人，且**必须是指定的那条测试变红** | `npm run test:mutations`：**174 条全部咬住**（判据是 `red.some(line => line.includes(item.expect))`，不是"有红就行"） |
-| **桌面应用里弹系统文件夹框**（0.18.0 工作区目录选择） | ✅ **有真机证据**：2026-10-09 用户在桌面应用点「选择工作区目录」，实测「成功替换为系统文件管理器」（先用 profile 补丁验过一次，之后的插件内 shadow 版走的是同一条 preload 桥）；`node test/directory-flow.mjs` 37 条 + 变异 FS–FY 罩着判定与状态机 |
+| 变异守卫真的会咬人，且**必须是指定的那条测试变红** | `npm run test:mutations`：**180 条全部咬住**（判据是 `red.some(line => line.includes(item.expect))`，不是"有红就行"） |
+| **桌面应用里弹系统文件夹框**（0.18.0 起；0.19.0 起默认关、设置页可开） | ✅ **有真机证据**：2026-10-09 用户在桌面应用点「选择工作区目录」，实测「成功替换为系统文件管理器」（先用 profile 补丁验过一次，之后的插件内 shadow 版走的是同一条 preload 桥）；`node test/directory-flow.mjs` 49 条 + 变异 FS–FY（判定/状态机）与 GZ/HA（开关幂等装卸）罩着 |
 | 发布门禁三条判据 | `npm run gates` 全过；`check:tag` 实测 `v0.12.0` 的 tag 名与所指提交里的版本一致 |
 | 三平台 CI | GitHub Actions：ubuntu / windows / macos × Node 20（`npm ci → typecheck → build → test → check:pack → check:docs`） |
 
@@ -565,7 +574,7 @@ Windows 上 DSH 给模型的终端工具是 **PowerShell**（工具名 `pwsh`）
 | 会话上下文「只用于消歧义」 | 0.12.0 起就声明过：这是**结构约束**（上下文内容不能当引文），不是对模型行为的保证。 |
 | `sync-types` 的边界 | 它是**形状核对**，不是类型代码生成：宿主 API 真变了但形状没变的那种情况查不出来。 |
 | 界面语言 | 只有中文界面（上游做了 zh/en 跟随 DSH）。英文用户能读 `README.en.md`，但界面本身不跟语言。 |
-| **远端（手机/浏览器）回落到官方应用内框**（0.18.0） | 判据是「客户端有没有 preload 桥」，`test/directory-flow.mjs` 第六节钉住「没有桥 ⇒ 一个槽位都不 inject、`installDirectoryFlow` 返回 false」；但**没有在真手机上点过这一次**。另外「电脑上的普通浏览器」也走这一支（客户端拿不到"我离宿主多远"，官方把这个能力列为 deferred）。 |
+| **远端（手机/浏览器）回落到官方应用内框**（0.18.0 起） | 判据是「客户端有没有 preload 桥」，`test/directory-flow.mjs` 第六/七节钉住「没有桥 ⇒ 一个槽位都不 inject、`installDirectoryFlow` 返回 undefined；开关即使开着也不装」；但**没有在真手机上点过这一次**。另外「电脑上的普通浏览器」也走这一支（客户端拿不到"我离宿主多远"，官方把这个能力列为 deferred）。 |
 
 ## 结构
 
@@ -680,9 +689,9 @@ node build.mjs                    # 产出 lib/index.js + lib/client.js
                                   #   ⚠️ 宿主半会**内联** schemastery / cosmokit：
                                   #   优先用 DSH 检出里的 vendor 副本，检出不在时退到 node_modules
                                   #   里同版本的 npm 包（两者逐字节相同）——CI 上走的就是退路
-npm test                          # 29 个套件；当前 2510 passed, 0 failed（2026-10-09 实测；CI 三平台同样全绿）
+npm test                          # 29 个套件；当前 2540 passed, 0 failed（2026-10-09 实测；CI 三平台同样全绿）
                                   #   走 scripts/run-tests.mjs：顺带把"多少套件/多少条"记进 test/.last-run.json
-npm run test:mutations            # 手动跑：变异测试，证明那套护栏真的在咬人（174 条，须单独跑）
+npm run test:mutations            # 手动跑：变异测试，证明那套护栏真的在咬人（180 条，须单独跑）
                                   #   同样记录结果，供下面的文档门禁核对
 npm run gates                     # 发版门禁三条一起跑：tag 指向 / 包内容 / 文档数字
 npm run check:tag                 #   ① tag 名里的版本 == 该 tag 所指提交里的 package.json 版本

package/lib/client.js

@@ -1017,6 +1017,7 @@ var NOTIFY_PUSHPLUS_FIELD = "notifyPushplusToken";
 var NOTIFY_WECOM_FIELD = "notifyWecomWebhook";
 var NOTIFY_KINDS_FIELD = "notifyKinds";
 var NOTIFY_TEST_API_PATH = "/composer-ux/notify/test";
+var DIRECTORY_PICK_ENABLED_FIELD = "directoryPickEnabled";
 var KEYS_ENABLED_FIELD = "keysEnabled";
 var MENU_ENABLED_FIELD = "menuEnabled";
 var QUICK_ENABLED_FIELD = "quickEnabled";
@@ -1290,6 +1291,8 @@ var DEFAULT_SETTINGS = {
   notifyPushplusToken: "",
   notifyWecomWebhook: "",
   notifyKinds: { "needs-input": true, done: true, error: true },
+  // 工作区目录选择自适应：默认**关**（0.19.0）。接管官方槽位这件事必须由用户自己点。
+  directoryPickEnabled: false,
   // 总开关默认开：它只是总闸，真正"要不要用这一栏"由下面五个开关决定（默认关）。
   enabled: true,
   // 五栏默认关（老文档由 sectionEnabledOf 迁移成"碰过就开"）。
@@ -1517,6 +1520,8 @@ function sanitizeSettings(value) {
   return {
     // 微信通知（0.17.0，单向）：默认全关/全空。
     notifyEnabled: asBool(NOTIFY_ENABLED_FIELD),
+    // 工作区目录选择自适应（0.19.0）：默认关。
+    directoryPickEnabled: asBool(DIRECTORY_PICK_ENABLED_FIELD),
     notifyChannel: asNotifyChannel(),
     notifyPushplusToken: asString(NOTIFY_PUSHPLUS_FIELD),
     notifyWecomWebhook: asString(NOTIFY_WECOM_FIELD),
@@ -6001,6 +6006,34 @@ function NotifyCard({ settings, setField }) {
     }
   );
 }
+function DirectoryPickCard({ settings, setField }) {
+  const on = settings.directoryPickEnabled;
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+    FoldCard,
+    {
+      name: "\u5DE5\u4F5C\u533A\u76EE\u5F55\u9009\u62E9",
+      summary: on ? "\u5F00\u542F\u4E2D \xB7 \u684C\u9762\u5E94\u7528\u91CC\u5F39\u7CFB\u7EDF\u6587\u4EF6\u5939\u6846\uFF08\u4EFB\u610F\u76D8\u7B26\u70B9\u9009\uFF09" : "\u7528\u5B98\u65B9\u5E94\u7528\u5185\u6D4F\u89C8\u5BF9\u8BDD\u6846",
+      toggle: { checked: on, onChange: (next) => {
+        setField(DIRECTORY_PICK_ENABLED_FIELD, next);
+      } },
+      children: /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { style: { margin: "10px 0", fontSize: 12, lineHeight: 1.6, opacity: 0.85 }, children: [
+        "\u6253\u5F00\u540E\uFF1A\u5728",
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("strong", { children: "\u684C\u9762\u5E94\u7528" }),
+        "\u91CC\u70B9\u300C\u9009\u62E9\u5DE5\u4F5C\u533A\u76EE\u5F55\u300D\u76F4\u63A5\u5F39 Windows \u7CFB\u7EDF\u6587\u4EF6\u5939\u6846 \u2014\u2014 \u4EFB\u610F\u76D8\u7B26\u70B9\u8FDB\u53BB\u9009\uFF0C",
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("strong", { children: "\u4E0D\u7528\u518D\u624B\u52A8\u8F93\u5165\u76D8\u7B26\u8DEF\u5F84" }),
+        "\uFF0C\u4E5F\u80FD\u5728\u91CC\u9762\u65B0\u5EFA\u6587\u4EF6\u5939\u3002",
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("br", {}),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { style: { opacity: 0.75 }, children: "\u5B98\u65B9\u90A3\u4E2A\u5E94\u7528\u5185\u5BF9\u8BDD\u6846\u5728 Windows \u4E0A\u7956\u5148\u94FE\u6B62\u4E8E\u76D8\u7B26\u6839\uFF08\u5B83\u81EA\u5DF1\u7684 README \u5199\u7740\u300C\u4E0D\u679A\u4E3E\u76D8\u7B26\u6839 \u2014\u2014 \u8DE8\u76D8\u4F9D\u8D56\u6D4F\u89C8\u5668 UI \u7684\u8DEF\u5F84\u8F93\u5165\u5165\u53E3\u300D\uFF09\uFF0C\u6240\u4EE5\u6362\u76D8\u624D\u8981\u624B\u8F93\uFF1B\u8FD9\u4E00\u9879\u5C31\u662F\u628A\u5B83\u6362\u6210\u7CFB\u7EDF\u6846\u3002" }),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("br", {}),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("span", { style: { opacity: 0.75 }, children: [
+          "\u53EA\u5728\u684C\u9762\u5E94\u7528\u91CC\u751F\u6548\uFF08\u53EA\u6709\u90A3\u513F\u6709\u7CFB\u7EDF\u5BF9\u8BDD\u6846\u7684\u63A5\u5165\u53E3\uFF09\uFF1B\u624B\u673A / \u6D4F\u89C8\u5668\u91CC\u4ECD\u662F\u5B98\u65B9\u90A3\u4E2A\u5E94\u7528\u5185\u6D4F\u89C8 \u5BF9\u8BDD\u6846\uFF08\u5E26\u8DEF\u5F84\u8F93\u5165\uFF09\uFF0C\u8FDC\u7AEF\u4F53\u9A8C\u4E0D\u53D8\u3002\u5F00\u5173",
+          /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("strong", { children: "\u5373\u65F6\u751F\u6548" }),
+          "\uFF0C\u4E0D\u7528\u91CD\u542F\uFF1B\u5173\u6389\u5373\u56DE\u5230\u5B98\u65B9\u539F\u6837\u3002"
+        ] })
+      ] })
+    }
+  );
+}
 function RestartButton({ restart }) {
   const busy = restart.stage === "restarting" || restart.stage === "asking";
   const blocked = restart.blocked;
@@ -6130,6 +6163,7 @@ function SettingsSection({ useLive, useBook, useBookStatus, useWriteNotice, acti
         ] })
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(NotifyCard, { settings, setField }),
+      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(DirectoryPickCard, { settings, setField }),
       /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(RestartBanner, { restart }),
       writeNotice !== "" && /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "dsh-ux-restartBanner dsh-ux-restartBannerFailed", role: "status", children: [
         /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("span", { className: "dsh-ux-restartBannerText", children: [
@@ -8371,14 +8405,31 @@ function createPickFlow(options) {
 }
 function installDirectoryFlow(slots, scope, component) {
   const bridge = nativePickBridge(scope);
-  if (bridge === void 0) return false;
+  if (bridge === void 0) return void 0;
   const pick = () => bridge.pick();
   const injected = () => ({ pick });
-  slots.inject(DIRECTORY_FLOW_SLOTS[0], () => slots.inject(DIRECTORY_FLOW_SLOTS[1], function* () {
+  const dispose = slots.inject(DIRECTORY_FLOW_SLOTS[0], () => slots.inject(DIRECTORY_FLOW_SLOTS[1], function* () {
     yield slots.register({ name: DIRECTORY_FLOW_SLOTS[0], inject: injected, priority: NATIVE_SHADOW_PRIORITY }, component);
     yield slots.register({ name: DIRECTORY_FLOW_SLOTS[1], inject: injected, priority: NATIVE_SHADOW_PRIORITY }, component);
   }));
-  return true;
+  return typeof dispose === "function" ? dispose : void 0;
+}
+function createDirectoryFlowController(options) {
+  let installed;
+  const dispose = () => {
+    installed?.();
+    installed = void 0;
+  };
+  return {
+    sync(enabled) {
+      if (enabled) {
+        if (installed === void 0) installed = installDirectoryFlow(options.slots, options.scope, options.component);
+        return;
+      }
+      dispose();
+    },
+    dispose
+  };
 }
 
 // src/client/DirectoryFlowEntry.tsx
@@ -8420,7 +8471,6 @@ var NULL_SCOPE = {
 };
 function apply(ctx) {
   const slots = ctx.slots;
-  installDirectoryFlow(slots, globalThis, DirectoryFlowEntry);
   const live = (0, import_dsh_client_store.createSnapshotStore)({ ...DEFAULT_SETTINGS });
   const menu2 = (0, import_dsh_client_store.createSnapshotStore)(null);
   const panel = (0, import_dsh_client_store.createSnapshotStore)(null);
@@ -8967,6 +9017,18 @@ function apply(ctx) {
     inject: () => ({ hooks: { live } })
   }, CostChipEntry));
   ctx.effect(() => installSettingsCardStyle(), "composer-ux: settings card style");
+  ctx.effect(() => {
+    const flow = createDirectoryFlowController({ slots, scope: globalThis, component: DirectoryFlowEntry });
+    const syncDirectoryFlow = () => {
+      flow.sync(live.getSnapshot().directoryPickEnabled === true);
+    };
+    syncDirectoryFlow();
+    const unsubscribe = live.subscribe(syncDirectoryFlow);
+    return () => {
+      unsubscribe();
+      flow.dispose();
+    };
+  }, "composer-ux: directory flow");
   ctx.effect(() => installQuickButtonStyle(), "composer-ux: quick button style");
   ctx.effect(() => installPanelResizeStyle(), "composer-ux: panel resize style");
   ctx.effect(() => {