dsh-gitbash-shell 0.23.0 → 0.24.1

package/cordis.patch.yml

@@ -34,7 +34,10 @@
         timeoutMs: 60000
         bashPath: "C:/Program Files/Git/bin/bash.exe"
 
-    - id: gitbash-presets
+    # Row id 'gitbash-shell' (was 'gitbash-presets' through v0.23.0): dsh >= 0.1.7
+    # keys a plugin's live Config form and the one-shot legacy settings.yaml
+    # import by the row id, so it now matches the settings namespace string.
+    - id: gitbash-shell
       name: dsh-gitbash-shell
 
 # Edit the dsh-better-sidebar row when it is mounted (their own bundle

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-external/dsh-gitbash-shell",
-  "version": "0.23.0",
+  "version": "0.24.1",
   "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/icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 36 36" fill="none">
+  <rect x="4" y="6" width="28" height="24" rx="3.5" stroke="#4493f8" stroke-width="1.8"/>
+  <path d="M4 12h28" stroke="#4493f8" stroke-width="1.4"/>
+  <circle cx="7.6" cy="9" r="1" fill="#4493f8"/>
+  <circle cx="11" cy="9" r="1" fill="#4493f8"/>
+  <path d="M10 18.5l4 3.5-4 3.5M17 25.5h8" stroke="#f0883e" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git Bash Shell",
+    "description": "Swaps Windows' PowerShell shell for Git for Windows bash: a bash-sandbox-compatible executor, a unified MSYS path dialect across every tool (posixPaths and friends, live-editable), and the four * Git Bash agent presets declared straight onto the roster on dsh 0.1.7+."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git Bash Shell",
+    "description": "把 Windows 的 PowerShell shell 换成 Git for Windows bash:兼容 bash-sandbox 的执行器、全工具统一的 MSYS 路径方言(posixPaths 等开关可实时编辑),以及 dsh 0.1.7+ 上直接声明进取的四个 * · Git Bash 预设。"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-gitbash-shell",
-  "version": "0.23.0",
+  "version": "0.24.1",
   "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": {
@@ -11,7 +11,8 @@
   "exports": {
     ".": "./src/index.js",
     "./shell": "./src/shell.js",
-    "./client": "./src/client.js"
+    "./client": "./src/client.js",
+    "./locale/*.json": "./locale/*.json"
   },
   "engines": {
     "node": ">=18",
@@ -38,7 +39,9 @@
     "dsh.plugin.json",
     "README.md",
     "README_EN.md",
-    "LICENSE"
+    "LICENSE",
+    "locale",
+    "icon.svg"
   ],
   "scripts": {
     "test": "node --test tests/smoke.mjs",
@@ -63,5 +66,9 @@
   "homepage": "https://github.com/KannaKuron/dsh-gitbash-shell",
   "bugs": {
     "url": "https://github.com/KannaKuron/dsh-gitbash-shell/issues"
+  },
+  "icon": "./icon.svg",
+  "devDependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1"
   }
 }

package/src/client.js

@@ -1058,11 +1058,46 @@ window.__ModuleLoader__.load({
 
 		exports.name = "dsh-gitbash-shell/client";
 
-		/** Required client services: locale runtime, settings scopes, slots. */
-		exports.inject = ["locale", "settingsScope", "slots"];
+		/**
+		 * Required client services: only era-guaranteed ones are hard-injected;
+		 * the settings face is acquired OPTIONALLY (dsh 0.1.7 removed the
+		 * settingsScope service and a hard inject would leave this fiber PENDING
+		 * forever, taking the card down with it).
+		 */
+		exports.inject = ["locale", "slots"];
 
 		exports.apply = function (ctx) {
-			var scope = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+			// Era-split settings face (same contract both eras: getSnapshot/set/unset).
+			var scope = null;
+
+			// OLD era (dsh <= 0.1.6): bound settings scope.
+			try {
+				ctx.inject(["settingsScope"], function (sctx) {
+					try {
+						var svc = sctx && sctx.settingsScope;
+						if (svc && typeof svc.bind === "function") scope = svc.bind({ namespace: SETTINGS_NAMESPACE });
+					} catch (error) {
+						console.warn(TAG + " settingsScope acquisition failed:", error && error.message ? error.message : error);
+					}
+				});
+			} catch (error) {
+				console.warn(TAG + " settingsScope wiring failed:", error && error.message ? error.message : error);
+			}
+
+			// NEW era (dsh >= 0.1.7): one ConfigForm per live profile entry; the form
+			// key is the row id "gitbash-shell" (same string as the old namespace).
+			try {
+				ctx.inject(["configForms"], function (fctx) {
+					try {
+						var forms = fctx && fctx.configForms;
+						if (forms && typeof forms.get === "function") scope = forms.get(SETTINGS_NAMESPACE);
+					} catch (error) {
+						console.warn(TAG + " configForms acquisition failed:", error && error.message ? error.message : error);
+					}
+				});
+			} catch (error) {
+				console.warn(TAG + " configForms wiring failed:", error && error.message ? error.message : error);
+			}
 			/* The card's only copy entry point: a live lookup, never a captured
 			   dictionary — the language preference switches without a reload. */
 			var t = translatorOf(ctx);

package/src/compositions.js

@@ -0,0 +1,298 @@
+/**
+ * dsh-gitbash-shell — declarative composition rows (dsh >= 0.1.7).
+ *
+ * dsh 0.1.7 removed directory presets; a preset is a definition registered
+ * through agentPresets.register(). This module is the committed, reviewable
+ * composition DATA for the four Git Bash variants — the new-era counterpart
+ * of the committed assets/<variant>/agent.cordis*.yml texts the materializer
+ * writes on older hosts.
+ *
+ * Every variant mirrors the official 0.1.7 preset it replaces (packages/
+ * bundle/web-app/presets/{standard,minimal,ptc,cordis}.patch.yml) with the
+ * one Git Bash delta: the bash rows are always on and the pwsh rows are
+ * always off (the host executor is this plugin's shell.js — on non-Windows
+ * hosts that is the native stack anyway, which is exactly what the old
+ * materialized variants encoded).
+ */
+
+/** Default Git Bash binary — must match src/shell.js and the patch config. */
+const DEFAULT_GIT_BASH = 'C:/Program Files/Git/bin/bash.exe'
+
+function off(value) {
+  return value === true ? { disabled: true } : {}
+}
+
+const PLAN_SECTION = `You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+
+Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
+
+The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
+
+Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
+
+Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
+
+When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
+`
+
+/**
+ * The shared full-tool rows for standard / ptc / cordis variants (pure).
+ * @param {object} input
+ * @param {'standard'|'ptc'|'cordis'} input.kind - which official preset this
+ *   variant mirrors (workflow rows follow it: enabled on standard/cordis,
+ *   disabled on ptc).
+ * @param {boolean} input.gitBash - bash rows always on, pwsh rows always off.
+ * @param {string|undefined} input.skillsDir - Creation authoring skills
+ *   directory (cordis variant only; resolved beside the agent-preset package).
+ * @returns {object[]} the declarative plugins list.
+ */
+export function pluginsFor({ kind, gitBash, skillsDir }) {
+  const win = typeof process !== 'undefined' && process.platform === 'win32'
+  const bashDisabled = gitBash ? false : win
+  const pwshDisabled = gitBash ? true : !win
+  const workflowOn = kind !== 'ptc'
+  const rows = [
+    {
+      id: 'persona',
+      name: '@deepseek-ai/dsh-persona',
+      config: {
+        prefix: 'You are a coding agent powered by the {{model}} model.',
+        suffix: 'Your working directory is {{cwd}}.',
+      },
+    },
+    {
+      id: 'agent-instructions',
+      name: '@deepseek-ai/dsh-agent-instructions',
+      config: { maxBytes: 65536 },
+    },
+    { id: 'tool-bash', name: '@deepseek-ai/dsh-tool-bash', ...off(bashDisabled) },
+    { id: 'tool-pwsh', name: '@deepseek-ai/dsh-tool-pwsh', ...off(pwshDisabled) },
+    { id: 'tool-fs', name: '@deepseek-ai/dsh-tool-fs' },
+    {
+      id: 'tool-fs-search',
+      name: '@deepseek-ai/dsh-tool-fs-search',
+      config: { sampleOverCapGlobResults: false },
+    },
+    { id: 'tool-jobs', name: '@deepseek-ai/dsh-tool-jobs' },
+    ...((kind === 'standard' || kind === 'ptc') ? [
+      { id: 'skill-filesystem', name: '@deepseek-ai/dsh-skill-filesystem' },
+      { id: 'tool-skill', name: '@deepseek-ai/dsh-tool-skill' },
+    ] : []),
+    { id: 'command-goal', name: '@deepseek-ai/dsh-command-goal' },
+    { id: 'tool-goal', name: '@deepseek-ai/dsh-tool-goal' },
+    {
+      id: 'planning',
+      name: 'cordis:group',
+      group: true,
+      isolate: { planMode: true },
+      config: [
+        {
+          id: 'plan-mode',
+          name: '@deepseek-ai/dsh-plan-mode',
+          config: { section: PLAN_SECTION },
+        },
+      ],
+    },
+    {
+      id: 'compaction',
+      name: 'cordis:group',
+      group: true,
+      isolate: { compaction: true, toolResultPruner: true },
+      config: [
+        { id: 'compaction-basic', name: '@deepseek-ai/dsh-compaction-basic' },
+        { id: 'command-compact', name: '@deepseek-ai/dsh-command-compact' },
+        {
+          id: 'tool-result-pruner',
+          name: '@deepseek-ai/dsh-compaction-tool-result-pruner',
+          config: { thresholdChars: 8192, headChars: 4096, tailChars: 1024 },
+        },
+      ],
+    },
+    {
+      id: 'delegation',
+      name: 'cordis:group',
+      group: true,
+      isolate: { workflowEngine: true },
+      config: [
+        { id: 'tool-subagent-control', name: '@deepseek-ai/dsh-tool-subagent-control' },
+        { id: 'tool-subagent-list-agents', name: '@deepseek-ai/dsh-tool-subagent-control/list-agents' },
+        {
+          id: 'tool-subagent',
+          name: '@deepseek-ai/dsh-tool-subagent',
+          config: { provider: 'spawn', toolName: 'subagent', modelSelectionSettings: true, backgroundMode: 'continuable' },
+        },
+        {
+          id: 'tool-subagent-fork',
+          name: '@deepseek-ai/dsh-tool-subagent',
+          config: { provider: 'fork', toolName: 'subagent_fork', backgroundMode: 'continuable' },
+        },
+        {
+          id: 'tool-subagent-codex',
+          name: '@deepseek-ai/dsh-tool-subagent',
+          disabled: true,
+          config: { provider: 'codex', toolName: 'subagent_codex', backgroundMode: 'one-shot', maxDepth: 'provider-managed' },
+        },
+        {
+          id: 'tool-subagent-claude-code',
+          name: '@deepseek-ai/dsh-tool-subagent',
+          disabled: true,
+          config: { provider: 'claude-code', toolName: 'subagent_claude_code', backgroundMode: 'one-shot', maxDepth: 'provider-managed' },
+        },
+        {
+          id: 'workflow-ptc',
+          name: '@deepseek-ai/dsh-workflow-ptc',
+          ...off(!workflowOn),
+          config: { provider: 'spawn' },
+        },
+        { id: 'tool-workflow', name: '@deepseek-ai/dsh-tool-workflow', ...off(!workflowOn) },
+        {
+          id: 'tool-ralph',
+          name: '@deepseek-ai/dsh-tool-ralph',
+          disabled: true,
+          config: { subagentProvider: 'spawn', maxRounds: 64 },
+        },
+      ],
+    },
+    { id: 'tool-ask-user', name: '@deepseek-ai/dsh-tool-ask-user' },
+    {
+      id: 'tool-todo',
+      name: '@deepseek-ai/dsh-tool-todo',
+      config: { allowParallelInProgress: true },
+    },
+    {
+      id: 'tool-web',
+      name: '@deepseek-ai/dsh-tool-web',
+      config: { fetch: true, searchTimeoutMs: 60000 },
+    },
+  ]
+  if (kind === 'ptc') {
+    rows.push({
+      id: 'tool-presentation',
+      name: '@deepseek-ai/dsh-agent-tool-presentation',
+      config: { mode: 'ptc' },
+    })
+  }
+  if (kind === 'cordis') {
+    rows.push({ id: 'tool-cordis', name: '@deepseek-ai/dsh-tool-cordis' })
+  }
+  if (kind === 'cordis') {
+    rows.push({ id: 'skill-filesystem', name: '@deepseek-ai/dsh-skill-filesystem', ...(skillsDir ? { config: { customSkillDirs: [skillsDir] } } : {}) })
+    rows.push({ id: 'tool-skill', name: '@deepseek-ai/dsh-tool-skill' })
+  }
+  rows.push({ id: 'present', name: '@deepseek-ai/dsh-tool-present' })
+  rows.push({
+    id: 'tool-plugin-manager',
+    name: '@deepseek-ai/dsh-plugin-manager/tools',
+    // The official 0.1.7 rows: ptc/standard ship it disabled, cordis keeps it
+    // on wherever a profile context exists (every web deployment does).
+    ...off(kind !== 'cordis'),
+  })
+  return rows
+}
+
+/**
+ * The minimal variant: the official single-tool preset with the Git Bash
+ * delta — bash rows always on (the terminal row pins the Git Bash binary on
+ * Windows), pwsh rows always off (pure).
+ * @returns {object[]} the declarative plugins list.
+ */
+export function minimalPluginsFor() {
+  const win = typeof process !== 'undefined' && process.platform === 'win32'
+  return [
+    {
+      id: 'persona',
+      name: '@deepseek-ai/dsh-persona',
+      config: {
+        prefix: 'You are a helpful software engineer assistant.',
+        complete: true,
+        includeRuntimeContext: false,
+      },
+    },
+    {
+      id: 'persistent-shell',
+      name: 'cordis:group',
+      group: true,
+      isolate: { terminals: true },
+      config: [
+        { id: 'pty', name: '@deepseek-ai/dsh-terminal' },
+        {
+          id: 'terminal-bash',
+          name: '@deepseek-ai/dsh-terminal-bash',
+          disabled: false,
+          config: {
+            timeoutMs: 300000,
+            shellPath: win ? DEFAULT_GIT_BASH : '/bin/bash',
+          },
+        },
+        {
+          id: 'persistent-bash',
+          name: '@deepseek-ai/dsh-tool-bash-persistent',
+          disabled: false,
+          config: {
+            timeoutMs: 300000,
+            description: [
+              'Run commands in a bash shell (Git for Windows bash on Windows: native paths like C:/... work, and PATH plus the rest of the environment are inherited from the host)',
+              '* When invoking this tool, the contents of the "command" parameter does NOT need to be XML-escaped.',
+              '* Network access depends on the task environment. Prefer configured mirrors/proxies when they are available.',
+              '* State is persistent across command calls and discussions with the user.',
+              '* To inspect a particular line range of a file, e.g. lines 10-25, try \'sed -n 10,25p /path/to/the/file\'.',
+              '* Please avoid commands that may produce a very large amount of output.',
+              '* Please run long lived commands in the background, e.g. \'sleep 10 &\' or start a server in the background.',
+            ].join('\n'),
+          },
+        },
+        {
+          id: 'terminal-pwsh',
+          name: '@deepseek-ai/dsh-terminal-bash',
+          disabled: true,
+          config: { shellDialect: 'pwsh', timeoutMs: 300000 },
+        },
+        {
+          id: 'persistent-pwsh',
+          name: '@deepseek-ai/dsh-tool-pwsh-persistent',
+          disabled: true,
+          config: {
+            timeoutMs: 300000,
+            description: [
+              "Run commands in a PowerShell shell",
+              "* When invoking this tool, the contents of the \"command\" parameter does NOT need to be XML-escaped.",
+              "* You don't have access to the internet via this tool.",
+              "* State is persistent across command calls and discussions with the user.",
+              "* Use native Windows paths (C:\\...) and $env:NAME variables; this is PowerShell, not bash.",
+              "* Please avoid commands that may produce a very large amount of output.",
+              "* Please run long lived commands in the background, e.g. 'Start-Job' or start a server with Start-Process.",
+            ].join('\n') + '\n',
+          },
+        },
+      ],
+    },
+  ]
+}
+
+/** Display metadata for the four registrations (mirrors the committed preset.yml files). */
+export const PRESET_META = {
+  'standard-gitbash': {
+    kind: 'standard',
+    name: '标准模式 · Git Bash',
+    description: '功能完整的编码 Agent,支持文件编辑、Shell、文件与网页检索、Skills、计划、目标、子代理和工作流。(Shell 使用 Git Bash)',
+    order: 1,
+  },
+  'code-gitbash': {
+    kind: 'ptc',
+    name: 'PTC 模式 · Git Bash',
+    description: '功能完整的编码 Agent,但默认不提供 workflow 工具;其他工具通过 PTC 模式 SDK 呈现,让模型用一个 TypeScript 程序组合多步操作。(Shell 使用 Git Bash)',
+    order: 2,
+  },
+  'minimal-gitbash': {
+    kind: 'minimal',
+    name: '极简模式 · Git Bash',
+    description: '仅提供持久 shell 的单工具编码 Agent。(Shell 使用 Git Bash)',
+    order: 3,
+  },
+  'cordis-gitbash': {
+    kind: 'cordis',
+    name: '创造模式 · Git Bash',
+    description: '用于创建自定义 Agent preset:具备标准模式的全部能力,并提供运行时检查、插件实验和 preset 创作指导。(Shell 使用 Git Bash)',
+    order: 4,
+  },
+}

package/src/index.js

@@ -52,8 +52,11 @@ import {
 } from 'node:fs'
 import { homedir, tmpdir } from 'node:os'
 import { dirname, join } from 'node:path'
+import Schema from '@deepseek-ai/schemastery'
 import { fileURLToPath } from 'node:url'
 
+import { PRESET_META, minimalPluginsFor, pluginsFor } from './compositions.js'
+
 /** Plugin identity for cordis.yml rows. */
 export const name = 'dsh-gitbash-shell'
 
@@ -662,6 +665,79 @@ export function installRegisterShim(reg) {
 
 const SETTINGS_NAMESPACE = 'gitbash-shell'
 
+/**
+ * dsh >= 0.1.7 marks a Config field live-editable without remount; a
+ * 0.1.6-era schemastery predates the method and the guard keeps this module
+ * loadable there (values then behave as ordinary config, read through the
+ * registered settings namespace instead).
+ */
+function live(schema) {
+  return typeof schema.volatile === 'function' ? schema.volatile() : schema
+}
+
+/**
+ * Row Config = the settings surface on dsh >= 0.1.7 (values persist under the
+ * row id; the patch row id is 'gitbash-shell', the same string as the old
+ * settings namespace, so the one-shot legacy settings.yaml import maps old
+ * user values onto the new home). Inert metadata on older hosts.
+ */
+export const Config = Schema.object({
+  // Row-level knob predating the Config surface (invariant 6): which preset
+  // variants to serve. Ordinary config — an edit remounts the plugin, which
+  // is the right weight for a list that changes the roster.
+  presets: Schema.array(Schema.string()).default(PRESET_IDS),
+  posixPaths: live(Schema.boolean().default(true)),
+  virtualMounts: live(Schema.boolean().default(true)),
+  globSplit: live(Schema.boolean().default(true)),
+  errorDialect: live(Schema.boolean().default(true)),
+  codePaths: live(Schema.boolean().default(true)),
+  gitAutocrlf: live(Schema.boolean().default(true)),
+  bashPath: live(Schema.string().default('')),
+  adoptSidebar: live(Schema.boolean().default(true)),
+})
+
+/** Read one Config value across eras: Volatile ref (>= 0.1.7) or plain value. */
+export function valueOf(value) {
+  return value && typeof value.get === 'function' ? value.get() : value
+}
+
+/**
+ * Era-aware live settings reader for everything wired inside apply(): the
+ * NEW era reads this plugin's own Config refs (no listener needed — every
+ * consumer here already re-reads per dispatch/assembly), the OLD era keeps
+ * reading the registered namespace through the settings service.
+ * @param {object} ctx - the plugin's mounting context.
+ * @param {object|undefined} config - apply()'s resolved Config.
+ * @returns {{ dialect: () => object, posix: () => boolean, adoptSidebar: () => boolean }}
+ */
+function makeLiveReader(ctx, config) {
+  let legacy = false
+  try {
+    const settings = ctx.get('settings')
+    legacy = !!(settings && typeof settings.register === 'function')
+  } catch { legacy = false }
+  const hasConfig = !!(config && typeof config === 'object')
+  const dialect = () => {
+    if (legacy || !hasConfig) return readDialectSettings(ctx)
+    const bash = valueOf(config.bashPath)
+    return {
+      posixPaths: valueOf(config.posixPaths) === true,
+      virtualMounts: valueOf(config.virtualMounts) === true,
+      globSplit: valueOf(config.globSplit) === true,
+      errorDialect: valueOf(config.errorDialect) === true,
+      codePaths: valueOf(config.codePaths) === true,
+      gitAutocrlf: valueOf(config.gitAutocrlf) === true,
+      bashPath: typeof bash === 'string' ? bash : '',
+      adoptSidebar: valueOf(config.adoptSidebar) !== false,
+    }
+  }
+  return {
+    dialect,
+    posix: () => dialect().posixPaths === true,
+    adoptSidebar: () => dialect().adoptSidebar !== false,
+  }
+}
+
 /** 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 — including the bash-native habits (~ home shorthand, /tmp, /dev/null, /usr/bin/...), which resolve in every tool exactly as bash itself resolves them.'
 
@@ -1630,7 +1706,7 @@ function adoptSidebarShell(ctx, bashPath) {
 
   const run = () => {
     tried += 1
-    const ok = reconcileSidebar(readAdoptSidebar(ctx))
+    const ok = reconcileSidebar(liveSettings.adoptSidebar())
     if (ok) {
       // The namespace scope may register after the settings service; hook
       // the live watch once it exists (idempotent via the effect disposer).
@@ -1722,6 +1798,105 @@ function purgeOrphans(userRoot, keep) {
   }
 }
 
+// ── declarative registration (dsh >= 0.1.7) ──────────────────────────────────
+//
+// dsh 0.1.7 removed directory presets: nothing reads ~/.dsh/.agent-presets
+// any more, and a preset is a definition registered through
+// agentPresets.register(). The era probe is the register method itself; the
+// composition data lives in src/compositions.js (the new-era counterpart of
+// the committed assets/<variant>/ texts).
+
+/** Resolve the Creation-skills dir beside @deepseek-ai/dsh-agent-preset. */
+async function resolveSkillsDir() {
+  try {
+    const { createRequire } = await import('node:module')
+    const here = createRequire(import.meta.url)
+    const pkg = here.resolve('@deepseek-ai/dsh-agent-preset/package.json')
+    return join(dirname(pkg), 'skills')
+  } catch {
+    return undefined
+  }
+}
+
+/** The legacy preset root, best effort (roster roots are gone on 0.1.7). */
+function legacyPresetRoot() {
+  try {
+    const env = process.env.DSH_HOME
+    if (env && env.trim() !== '') return join(env, '.agent-presets')
+    return join(homedir(), '.dsh', '.agent-presets')
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * Remove the stale materialized trees a previous (pre-0.1.7-host) version
+ * left behind, when they are still byte-identical to what we wrote (the
+ * marker judges). User-modified and foreign trees stay untouched — the same
+ * ownership rules the materializer itself follows.
+ */
+function cleanupLegacyTrees(presetIds) {
+  const root = legacyPresetRoot()
+  if (!root) return
+  for (const presetId of presetIds) {
+    const target = join(root, presetId)
+    const state = classify(target)
+    if (state === 'unmodified') {
+      try {
+        rmSync(target, { recursive: true, force: true })
+        console.log(TAG + ' removed the stale materialized preset at ' + target + ' (directory presets are no longer read on this host; the declarative registration replaces it)')
+      } catch (error) {
+        console.log(TAG + ' stale preset cleanup failed: ' + (error && error.message ? error.message : error))
+      }
+    } else if (state === 'user-modified') {
+      console.log(TAG + ' a user-modified preset tree remains at ' + target + ' — left untouched (this host ignores it; delete it manually if unwanted)')
+    }
+  }
+}
+
+/**
+ * Register one variant definition; returns the unregister function. Mount
+ * failures stay visible through the roster's broken diagnostic instead of
+ * failing the boot.
+ */
+async function registerVariant(ctx, presetId, { gitBashActive, skillsDir }) {
+  const meta = PRESET_META[presetId]
+  if (!meta) return undefined
+  const plugins = meta.kind === 'minimal'
+    ? minimalPluginsFor()
+    : pluginsFor({ kind: meta.kind, gitBash: gitBashActive, skillsDir })
+  return ctx.agentPresets.register({
+    id: presetId,
+    name: meta.name,
+    description: meta.description,
+    order: meta.order,
+    plugins,
+  })
+}
+
+/**
+ * Declarative-era wiring: register every configured variant once at startup
+ * and keep exactly one registration per variant for the plugin's lifetime.
+ * The roster picks the entries up immediately; sessions already pinned to a
+ * variant keep their revision until recomposed.
+ */
+async function runDeclarativeEra(ctx, presetIds) {
+  cleanupLegacyTrees(presetIds)
+  const gitBashActive = process.platform === 'win32'
+  const skillsDir = await resolveSkillsDir()
+  const unregisters = []
+  for (const presetId of presetIds) {
+    try {
+      const unregister = await registerVariant(ctx, presetId, { gitBashActive, skillsDir })
+      if (unregister) unregisters.push(unregister)
+    } catch (error) {
+      console.log(TAG + " preset '" + presetId + "' registration failed: " + (error && error.message ? error.message : error))
+    }
+  }
+  console.log(TAG + ' registered ' + unregisters.length + ' preset(s) declaratively (' + presetIds.join(', ') + ')')
+  ctx.effect(() => () => { for (const off of unregisters) void off() }, 'dsh-gitbash-shell: declarative preset registrations')
+}
+
 export async function apply(ctx, config = {}) {
   const presetIds = Array.isArray(config.presets) && config.presets.length > 0 ? config.presets : PRESET_IDS
 
@@ -1757,12 +1932,28 @@ export async function apply(ctx, config = {}) {
   const disposeGitBash = ctx.provide('gitBash', gitBashCapability)
   ctx.effect(() => disposeGitBash, 'dsh-gitbash-shell: gitBash capability')
 
-  // ── settings namespace: the posixPaths switch (default ON, v0.10.0) ──────
+  // Era-aware live settings: NEW hosts read this plugin's own Config refs
+  // (volatile, re-read per dispatch/assembly), OLD hosts keep the registered
+  // namespace. Every consumer below already re-reads on every use, so a
+  // flipped knob lands on the next dispatch with zero wiring.
+  const liveSettings = makeLiveReader(ctx, config)
+
+  // ── settings namespace: the posixPaths switch (default ON, v0.1.0) — OLD
+  // hosts only; on dsh >= 0.1.7 the row Config above IS the surface.
+
   // Served on the host so the Plugins tab pairs it with the browser card
   // (the tab dispatches Host-served namespaces ∩ registered cards). Dynamic
   // imports keep the zero-dependency smoke path importable; the schema MUST
   // be a callable schemastery object (dsh-settings calls schema(merged)).
-  try {
+  const legacySettings = (() => {
+    try {
+      const settings = ctx.get('settings')
+      return !!(settings && typeof settings.register === 'function')
+    } catch {
+      return false
+    }
+  })()
+  if (legacySettings) try {
     ctx.inject(['settings'], (sctx) => {
       Promise.all([import('@deepseek-ai/dsh-settings'), import('@deepseek-ai/schemastery')])
         .then(([ds, sm]) => {
@@ -1832,7 +2023,7 @@ export async function apply(ctx, config = {}) {
             // own env layer (src/shell.js), not this registry.
             variables: { [PATH_DIALECT_KEY]: { description: PATH_DIALECT_DESCRIPTION } },
             resolve() {
-              return readPosixPaths(envCtx) ? { [PATH_DIALECT_KEY]: PATH_DIALECT_VALUE } : {}
+              return liveSettings.posix() ? { [PATH_DIALECT_KEY]: PATH_DIALECT_VALUE } : {}
             },
           })
           envCtx.effect(() => unregister, 'dsh-gitbash-shell: shellEnv path-dialect fact')
@@ -1860,7 +2051,7 @@ export async function apply(ctx, config = {}) {
     try {
       ctx.on('system-prompt/assemble', (assembly, _assembleContext, next) => {
         try {
-          if (readPosixPaths(ctx) && assembly && typeof assembly === 'object') {
+          if (liveSettings.posix() && assembly && typeof assembly === 'object') {
             for (const section of Array.isArray(assembly.sections) ? assembly.sections : []) {
               if (section && typeof section.text === 'string') section.text = windowsToMsys(section.text)
             }
@@ -1987,7 +2178,7 @@ export async function apply(ctx, config = {}) {
       ctx.on('tools/post-execute', (exec, result, next) => {
         let contentPatch
         try {
-          const dialect = readDialectSettings(ctx)
+          const dialect = liveSettings.dialect()
           if (dialect.posixPaths && dialect.errorDialect && exec && result && typeof result === 'object'
             && result.isError === true && Array.isArray(result.content)) {
             const env = dialect.virtualMounts ? buildTranslateEnv(dialect.bashPath) : null
@@ -2036,10 +2227,9 @@ export async function apply(ctx, config = {}) {
             order: 126,
             text: () => {
               try {
-                const settings = pctx.get('settings')
-                const value = settings && typeof settings.get === 'function' ? settings.get(SETTINGS_NAMESPACE) : undefined
-                if (!value || value.posixPaths !== true) return ''
-                return value.virtualMounts === false ? POSIX_DIRECTIVE_TEXT_STRICT : POSIX_DIRECTIVE_TEXT
+                const dialect = liveSettings.dialect()
+                if (dialect.posixPaths !== true) return ''
+                return dialect.virtualMounts === false ? POSIX_DIRECTIVE_TEXT_STRICT : POSIX_DIRECTIVE_TEXT
               } catch {
                 return ''
               }
@@ -2063,6 +2253,19 @@ export async function apply(ctx, config = {}) {
     adoptSidebarShell(ctx, gitBashCapability.bashPath)
   }
 
+  // ── era split: declarative registration on dsh >= 0.1.7 ──────────────────
+  // The register method IS the era signal. On the new host the whole
+  // materialization path below is dead code (nothing reads the directory any
+  // more), so this branch serves the variants and returns.
+  if (ctx.agentPresets && typeof ctx.agentPresets.register === 'function') {
+    try {
+      await runDeclarativeEra(ctx, presetIds)
+    } catch (error) {
+      console.log(TAG + ' declarative registration failed: ' + (error && error.message ? error.message : error))
+    }
+    return
+  }
+
   const roots = ctx.agentPresets?.roots ?? []
   const userRoot = firstUserRoot(roots)
   if (!userRoot) {