dsh-tui-theme 0.5.1 → 0.6.1

package/lib/types/themeAssets.js

@@ -10,7 +10,7 @@
  * contained per file: a theme garnish must never break the TUI's boot.
  * @module dsh-tui-theme/themeAssets
  */
-import { mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from 'node:fs';
+import { mkdirSync, readFileSync, readdirSync, renameSync, rmdirSync, unlinkSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -27,6 +27,51 @@ export function bundledThemesDir() {
 export function themesTargetDir() {
     return join(homeDir(), '.dsh-tui', 'themes');
 }
+/** Read bundled descriptors for hosts that support runtime theme registration. */
+export function readBundledThemes(sourceDir = bundledThemesDir()) {
+    let files;
+    try {
+        files = readdirSync(sourceDir).filter(entry => entry.toLowerCase().endsWith('.json'));
+    }
+    catch (error) {
+        console.warn(`dsh-tui-theme: could not read bundled themes from ${sourceDir}: ${String(error)}`);
+        return [];
+    }
+    const themes = [];
+    for (const file of files) {
+        try {
+            const value = JSON.parse(readFileSync(join(sourceDir, file), 'utf8'));
+            const name = value.name;
+            const base = value.base;
+            const colors = value.colors;
+            if (typeof name !== 'string' ||
+                !/^[a-z][a-z0-9_-]*(?::[a-z][a-z0-9_-]*)?$/u.test(name) ||
+                (base !== 'light' && base !== 'dark' && base !== 'dark-ansi') ||
+                colors === null ||
+                typeof colors !== 'object' ||
+                Array.isArray(colors)) {
+                throw new Error('invalid theme descriptor');
+            }
+            const normalizedColors = {};
+            for (const [key, color] of Object.entries(colors)) {
+                if (typeof color !== 'string')
+                    throw new Error(`invalid color for ${key}`);
+                normalizedColors[key] = color;
+            }
+            themes.push({
+                file,
+                name,
+                ...(typeof value.displayName === 'string' ? { displayName: value.displayName } : {}),
+                base,
+                colors: normalizedColors,
+            });
+        }
+        catch (error) {
+            console.warn(`dsh-tui-theme: skipping bundled theme ${file}: ${String(error)}`);
+        }
+    }
+    return themes;
+}
 /**
  * Install every bundled theme JSON that the target directory is missing.
  * @param targetDir - Destination directory (defaults to ~/.dsh-tui/themes).
@@ -57,8 +102,11 @@ export function installBundledThemes(targetDir = themesTargetDir(), sourceDir =
             }
             catch (error) {
                 if (error.code === 'EEXIST') {
-                    if (healCorruptTarget(target, text))
+                    const healed = healCorruptTarget(target, text);
+                    if (healed === 'repaired')
                         repaired.push(file);
+                    else if (healed === 'failed')
+                        failed.push(file);
                     else
                         skipped.push(file);
                 }
@@ -73,14 +121,73 @@ export function installBundledThemes(targetDir = themesTargetDir(), sourceDir =
     }
     return { installed, skipped, repaired, failed };
 }
+/**
+ * Remove files that this activation installed when a runtime theme service
+ * becomes available. A byte-for-byte check preserves edits made in the small
+ * window between installation and runtime confirmation.
+ */
+export function removeBundledThemes(files, targetDir = themesTargetDir(), sourceDir = bundledThemesDir()) {
+    const removed = [];
+    for (const file of files) {
+        try {
+            const bundled = readFileSync(join(sourceDir, file), 'utf8');
+            const target = join(targetDir, file);
+            if (readFileSync(target, 'utf8') !== bundled)
+                continue;
+            unlinkSync(target);
+            removed.push(file);
+        }
+        catch {
+            // Runtime registration must remain best-effort if a file disappears or
+            // the target directory becomes unavailable during teardown.
+        }
+    }
+    if (removed.length > 0) {
+        try {
+            if (readdirSync(targetDir).length === 0)
+                rmdirSync(targetDir);
+        }
+        catch {
+            // An empty directory is only a cosmetic artifact; leave it in place if
+            // it was removed concurrently or is no longer empty.
+        }
+    }
+    return removed;
+}
+/**
+ * Bundled theme files present in the target directory byte-for-byte
+ * identical to the bundled copy. On runtime-theme hosts such files shadow
+ * the registry while adding nothing, so the entry point can point them out
+ * once. User-edited or foreign same-named files are never reported — the
+ * never-overwrite rule keeps them, and no toast may nag about them.
+ */
+export function findShadowedBundledThemes(targetDir = themesTargetDir(), sourceDir = bundledThemesDir()) {
+    const shadowed = [];
+    let files;
+    try {
+        files = readdirSync(sourceDir).filter(entry => entry.toLowerCase().endsWith('.json'));
+    }
+    catch {
+        return shadowed;
+    }
+    for (const file of files) {
+        try {
+            if (readFileSync(join(targetDir, file), 'utf8') === readFileSync(join(sourceDir, file), 'utf8')) {
+                shadowed.push(file);
+            }
+        }
+        catch {
+            // Missing or unreadable target: not a shadow.
+        }
+    }
+    return shadowed;
+}
 /**
  * Self-heal an existing target that fails to parse as JSON — the leftover of
  * a torn write from an interrupted installation. The damaged file is kept as
- * <target>.corrupt-<timestamp> and the bundled copy installed fresh. Returns
- * false (leave untouched) when the target is valid JSON (a user file the
- * never-overwrite rule protects), unreadable (unreadable is not proven
- * corrupt), or when the backup/replace itself fails (degrade to the plain
- * silent skip).
+ * <target>.corrupt-<timestamp>-<pid>-<random> and the bundled copy installed
+ * fresh. Returns `skipped` when the target is valid JSON or unreadable, and
+ * `failed` when the corrupt target was moved but replacement could not finish.
  */
 function healCorruptTarget(target, text) {
     let existing;
@@ -88,21 +195,28 @@ function healCorruptTarget(target, text) {
         existing = readFileSync(target, 'utf8');
     }
     catch {
-        return false;
+        return 'skipped';
     }
     try {
         JSON.parse(existing);
-        return false;
+        return 'skipped';
     }
     catch {
         // Proven corrupt: fall through to backup and reinstall.
     }
+    let backup;
+    try {
+        backup = `${target}.corrupt-${Date.now()}-${process.pid}-${Math.random().toString(16).slice(2)}`;
+        renameSync(target, backup);
+    }
+    catch {
+        return 'skipped';
+    }
     try {
-        renameSync(target, `${target}.corrupt-${Date.now()}`);
         writeFileSync(target, text, { flag: 'wx' });
-        return true;
+        return 'repaired';
     }
     catch {
-        return false;
+        return 'failed';
     }
 }

package/lib/types/toast.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Toast relay for the plugin-facing transient-notification seam
+ * (dsh-TUI 0.10: `ctx.tuiToast`).
+ *
+ * The plugin's own logger output is invisible to a TUI user, so the few
+ * events worth surfacing — a follow-system pref write, a repaired theme
+ * file, a shadowing legacy static install — go through the host's toast
+ * surface instead. Sending is fire-and-forget: hosts without the seam
+ * (dsh-TUI < 0.10) never fire the inject and every send is a silent no-op,
+ * exactly like the other soft-probed seams.
+ *
+ * The host registers its toast sink late (the dsh-tui row applies after the
+ * extensions row, and both may trail this plugin), so a toast dropped for
+ * having no sink is retried on a short schedule before giving up. The
+ * tuiToast service itself arrives with the extensions row, so a send fired
+ * before the seam even exists waits on the same schedule. Retries are
+ * bounded, unref'd, and cleared with the activation; a toast lost to a host
+ * rate limit is not worth fighting — the next real event re-reports.
+ * @module dsh-tui-theme/toast
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Host toast color vocabulary (neutral when omitted). */
+export type ToastColor = 'success' | 'warning' | 'error';
+/** Send one transient notification; resolves to whether it was delivered. */
+export type ToastSend = (text: string, color?: ToastColor) => boolean;
+/**
+ * @internal Shrink the retry schedule for hermetic tests (verify.mjs only;
+ * not part of the plugin's behavioral contract).
+ */
+export declare function setToastRetryDelaysForTests(delays: readonly number[]): void;
+/**
+ * Start the toast relay. Returns a sender that is callable immediately and
+ * from any later context (settings watches, timers): `show()` binds through
+ * the service's own activation, so unlike `tuiStatus.set` it takes no
+ * identity argument — but the service object itself must still be read
+ * inside the inject (same rule as every other seam).
+ * @param ctx - The plugin's own activation context.
+ */
+export declare function startToastRelay(ctx: Context): ToastSend;
+//# sourceMappingURL=toast.d.ts.map

package/lib/types/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../src/toast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;AAUxD,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,KAAK,OAAO,CAAA;AAMrE;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAE3E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAoDvD"}

package/lib/types/toast.js

@@ -0,0 +1,91 @@
+/**
+ * Toast relay for the plugin-facing transient-notification seam
+ * (dsh-TUI 0.10: `ctx.tuiToast`).
+ *
+ * The plugin's own logger output is invisible to a TUI user, so the few
+ * events worth surfacing — a follow-system pref write, a repaired theme
+ * file, a shadowing legacy static install — go through the host's toast
+ * surface instead. Sending is fire-and-forget: hosts without the seam
+ * (dsh-TUI < 0.10) never fire the inject and every send is a silent no-op,
+ * exactly like the other soft-probed seams.
+ *
+ * The host registers its toast sink late (the dsh-tui row applies after the
+ * extensions row, and both may trail this plugin), so a toast dropped for
+ * having no sink is retried on a short schedule before giving up. The
+ * tuiToast service itself arrives with the extensions row, so a send fired
+ * before the seam even exists waits on the same schedule. Retries are
+ * bounded, unref'd, and cleared with the activation; a toast lost to a host
+ * rate limit is not worth fighting — the next real event re-reports.
+ * @module dsh-tui-theme/toast
+ */
+import { AsyncResource } from 'node:async_hooks';
+/** Drop-retry schedule (ms). The first delivery attempt is always immediate. */
+const RETRY_DELAYS_MS = [2_000, 4_000];
+let retryDelays = RETRY_DELAYS_MS;
+/**
+ * @internal Shrink the retry schedule for hermetic tests (verify.mjs only;
+ * not part of the plugin's behavioral contract).
+ */
+export function setToastRetryDelaysForTests(delays) {
+    retryDelays = delays;
+}
+/**
+ * Start the toast relay. Returns a sender that is callable immediately and
+ * from any later context (settings watches, timers): `show()` binds through
+ * the service's own activation, so unlike `tuiStatus.set` it takes no
+ * identity argument — but the service object itself must still be read
+ * inside the inject (same rule as every other seam).
+ * @param ctx - The plugin's own activation context.
+ */
+export function startToastRelay(ctx) {
+    const pending = new Set();
+    let show;
+    const clearPending = () => {
+        for (const timer of pending)
+            clearTimeout(timer);
+        pending.clear();
+    };
+    ctx.inject(['tuiToast'], toastCtx => {
+        const toast = toastCtx.tuiToast;
+        // show() resolves its caller through the ambient Cordis activation, so a
+        // call from a foreign async scope (a settings watch, a host timer of
+        // another seam) is refused even though this plugin is alive. Capture the
+        // activation scope here — inside the inject, where it is ambient — and
+        // re-enter it for every send, exactly like the inject-created interval
+        // that keeps the status line rendering.
+        const scope = new AsyncResource('dsh-tui-theme-toast');
+        show = (text, options) => {
+            try {
+                return scope.runInAsyncScope(() => toast.show(text, options));
+            }
+            catch {
+                // A hostile or tearing-down host must never propagate into the caller.
+                return false;
+            }
+        };
+        toastCtx.effect(() => () => {
+            show = undefined;
+            clearPending();
+        });
+    });
+    ctx.effect(() => () => {
+        show = undefined;
+        clearPending();
+    });
+    const attempt = (text, color, depth) => {
+        // A seam that has not arrived yet (the extensions row applies after this
+        // plugin) retries on the same bounded schedule as a dropped send.
+        if (show !== undefined && show(text, color === undefined ? {} : { color }))
+            return true;
+        if (depth >= retryDelays.length)
+            return false;
+        const timer = setTimeout(() => {
+            pending.delete(timer);
+            attempt(text, color, depth + 1);
+        }, retryDelays[depth]);
+        timer.unref?.();
+        pending.add(timer);
+        return false;
+    };
+    return (text, color) => attempt(text, color, 0);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-tui-theme",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "description": "Sakura-pink themes for dsh-TUI with optional cached background follow (pink-day/pink-night), a blossom status line, and a /settings section. No shortcuts, no commands.",
   "type": "module",
   "main": "lib/types/index.js",
@@ -28,7 +28,7 @@
     "preverify": "npm run build",
     "verify": "node scripts/verify.mjs",
     "verify:package": "node scripts/verify-package.mjs",
-    "verify:host": "npm run build && node scripts/headless-order-test.mjs && node --import tsx/esm scripts/validate-themes-against-host.mjs",
+    "verify:host": "npm run build && node scripts/headless-order-test.mjs && node scripts/runtime-themes-headless.mjs && node --import tsx/esm scripts/validate-themes-against-host.mjs",
     "release:check": "npm run build && npm run verify && npm run verify:package",
     "prepack": "npm run release:check"
   },
@@ -64,11 +64,53 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.1.1-rc.1 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6 || ^0.1.1-rc.1 || ^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.2",
     "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-harness-tui/dsh-tui": "0.10.0-beta.4",
     "@types/node": "^22.0.0",
     "tsx": "^4.23.12",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "@deepseek-ai/dsh-llm": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-user-questions": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-user-approval": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-commands": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-atomic-write": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-tool-ask-user": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-skill": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-agent-instructions": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "0.1.2-alpha.2"
+  },
+  "overrides": {
+    "@deepseek-ai/dsh-session": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-user-questions": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-user-approval": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-commands": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-atomic-write": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-tool-ask-user": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-skill": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-agent-instructions": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-scope": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-attachment": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-brand": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-timeout": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-code-runtime": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-fs": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-home-paths": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-sandbox": "0.1.2-alpha.2"
+  },
+  "allowScripts": {
+    "esbuild@0.28.2": true
   }
 }

package/scripts/headless-order-test.mjs

@@ -2,7 +2,8 @@
  * End-to-end order test with the installed dsh-TUI services. Composes this
  * plugin before the extension services to exercise late service injection.
  *
- * DSH_TUI_ADAPTER_DIR must point at dsh-TUI's lib/types/dsh-adapter directory.
+ * DSH_TUI_ADAPTER_DIR may point at dsh-TUI's lib/types/dsh-adapter directory.
+ * When omitted, the installed devDependency is used.
  * Script-side floor: the adapter must be a built dsh-TUI >= 0.9.0 — the
  * settings-sections module and its getHostSettingsSections probe landed there.
  * Set DSH_TUI_EXPECTED_VERSION only when an explicit release baseline needs
@@ -10,7 +11,7 @@
  */
 import { existsSync, mkdtempSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { tmpdir } from 'node:os'
-import { join } from 'node:path'
+import { dirname, join } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 import { createRequire } from 'node:module'
 import assert from 'node:assert/strict'
@@ -23,10 +24,10 @@ import { assertSettingsContract, SETTINGS_NAMESPACE } from './expected-settings-
 const STATUS_CONTRIBUTION_KEY = SETTINGS_NAMESPACE
 
 const pluginRoot = fileURLToPath(new URL('..', import.meta.url))
-const adapter = process.env.DSH_TUI_ADAPTER_DIR
-if (adapter === undefined || adapter === '') {
-  throw new Error('DSH_TUI_ADAPTER_DIR must point at dsh-TUI lib/types/dsh-adapter for this host integration test.')
-}
+const req = createRequire(import.meta.url)
+const packageJson = req.resolve('@deepseek-harness-tui/dsh-tui/package.json')
+const devHostRoot = dirname(packageJson)
+const adapter = process.env.DSH_TUI_ADAPTER_DIR || join(devHostRoot, 'lib', 'types', 'dsh-adapter')
 
 if (!existsSync(join(adapter, 'extensions.js'))) {
   throw new Error(`dsh-TUI adapter not found at ${adapter}`)
@@ -63,17 +64,28 @@ if (!existsSync(settingsSectionsPath)) {
   )
 }
 
-const req = createRequire(join(adapter, 'extensions.js'))
-const { Context } = await import(pathToFileURL(req.resolve('@deepseek-ai/cordis')).href)
+const hostRequire = createRequire(join(adapter, 'extensions.js'))
+const { Context } = await import(pathToFileURL(hostRequire.resolve('@deepseek-ai/cordis')).href)
 const extensions = await import(pathToFileURL(join(adapter, 'extensions.js')).href)
-const ledgerModule = await import(pathToFileURL(join(adapter, 'effect-ledger.js')).href)
 const statusModule = await import(pathToFileURL(join(adapter, 'status.js')).href)
 const settingsSectionsModule = await import(pathToFileURL(settingsSectionsPath).href)
+const pluginHostModule = await import(pathToFileURL(join(adapter, 'plugin-host.js')).href)
 const pink = await import(pathToFileURL(join(pluginRoot, 'lib', 'types', 'index.js')).href)
 
 const app = new Context()
-await app.plugin(ledgerModule.default)
-await app.plugin(pink)
+await app.plugin(pluginHostModule.default ?? pluginHostModule)
+const testUtilsPath = join(adapter, '..', 'test-utils.js')
+if (existsSync(testUtilsPath)) {
+  const testUtils = await import(pathToFileURL(testUtilsPath).href)
+  const manifest = testUtils.testManifest({ id: SETTINGS_NAMESPACE })
+  const admitted = await testUtils.mountAdmitted(app, SETTINGS_NAMESPACE, manifest)
+  await admitted.context.plugin(pink)
+} else {
+  // dsh-TUI < 0.10 has no public admission test helpers; keep the historical
+  // manual mount and report the structural limitation instead of hiding it.
+  console.log('* mountAdmitted unavailable on this host; using manual plugin mount')
+  await app.plugin(pink)
+}
 await app.plugin(extensions.default ?? extensions)
 await app.plugin(settingsSectionsModule.default ?? settingsSectionsModule)
 

package/scripts/runtime-themes-headless.mjs

@@ -0,0 +1,180 @@
+/**
+ * Dev-only integration check for dsh-TUI 0.10 runtime theme registration.
+ * Uses the installed host adapter and the real admission path; no user HOME
+ * or static theme files are touched.
+ */
+import { existsSync, mkdtempSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { tmpdir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import assert from 'node:assert/strict'
+
+const pluginRoot = fileURLToPath(new URL('..', import.meta.url))
+const req = createRequire(import.meta.url)
+const hostPackagePath = req.resolve('@deepseek-harness-tui/dsh-tui/package.json')
+const hostRoot = dirname(hostPackagePath)
+const adapter = process.env.DSH_TUI_ADAPTER_DIR || join(hostRoot, 'lib', 'types', 'dsh-adapter')
+if (!existsSync(join(adapter, 'extensions.js'))) {
+  throw new Error(`dsh-TUI runtime adapter not found at ${adapter}`)
+}
+if (!existsSync(join(adapter, 'themes.js'))) {
+  console.log('* runtime theme seam unavailable on this host; skipping 0.10 headless check')
+  process.exit(0)
+}
+
+const sandbox = mkdtempSync(join(tmpdir(), 'pink-runtime-themes-'))
+process.env.USERPROFILE = sandbox
+process.env.HOME = sandbox
+const dataDir = join(sandbox, '.dsh-tui')
+const staticThemes = join(dataDir, 'themes')
+mkdirSync(dataDir, { recursive: true })
+writeFileSync(join(dataDir, 'theme.json'), JSON.stringify({ theme: 'pink-night' }, null, 2))
+
+const hostRequire = createRequire(join(adapter, 'extensions.js'))
+const { Context } = await import(pathToFileURL(hostRequire.resolve('@deepseek-ai/cordis')).href)
+const pluginHost = await import(pathToFileURL(join(adapter, 'plugin-host.js')).href)
+const extensions = await import(pathToFileURL(join(adapter, 'extensions.js')).href)
+const themesModule = await import(pathToFileURL(join(adapter, 'themes.js')).href)
+const themeModule = await import(pathToFileURL(join(adapter, '..', 'theme.js')).href)
+const testUtils = await import(pathToFileURL(join(adapter, '..', 'test-utils.js')).href)
+const pink = await import(pathToFileURL(join(pluginRoot, 'lib', 'types', 'index.js')).href)
+const { SETTINGS_NAMESPACE } = await import(pathToFileURL(join(pluginRoot, 'scripts', 'expected-settings-contract.mjs')).href)
+
+const app = new Context()
+await app.plugin(pluginHost.default ?? pluginHost)
+const manifest = testUtils.testManifest({ id: SETTINGS_NAMESPACE })
+const admitted = await testUtils.mountAdmitted(app, SETTINGS_NAMESPACE, manifest)
+await admitted.context.plugin(pink)
+await app.plugin(extensions.default ?? extensions)
+
+const host = themesModule.getHostThemes(app.get('tuiThemes'))
+assert.ok(host, 'runtime theme host must be mounted')
+const deadline = Date.now() + 5_000
+while (host.getSnapshot().length !== 3 && Date.now() < deadline) {
+  await testUtils.sleep(25)
+}
+const snapshot = host.getSnapshot()
+assert.deepEqual(snapshot.map(entry => entry.name).sort(), ['pink-ansi', 'pink-day', 'pink-night'])
+
+for (const entry of snapshot) {
+  const expected = JSON.parse(readFileSync(join(pluginRoot, 'themes', `${entry.name}.json`), 'utf8'))
+  assert.equal(entry.displayName, expected.displayName)
+  assert.equal(entry.base, expected.base)
+  assert.deepEqual(entry.colors, expected.colors)
+  assert.deepEqual(host.resolve(entry.name), { ...themeModule.getTheme(entry.base), ...expected.colors })
+  assert.equal(themeModule.getTheme(entry.name).claude, expected.colors.claude)
+}
+assert.equal(existsSync(staticThemes), false, 'runtime registration must not create static theme files')
+await testUtils.sleep(1_700)
+assert.equal(existsSync(staticThemes), false, 'runtime confirmation must leave no static fallback files')
+
+const ledgerPath = join(dataDir, 'effect-ledger.jsonl')
+const readLedger = () => (existsSync(ledgerPath) ? readFileSync(ledgerPath, 'utf8').trim().split('\n').filter(Boolean).map(line => JSON.parse(line)) : [])
+const themeCreates = readLedger().filter(entry => entry.resource?.kind === 'theme' && entry.operation === 'create')
+assert.deepEqual(themeCreates.map(entry => entry.resource.id).sort(), ['pink-ansi', 'pink-day', 'pink-night'])
+
+await admitted.fiber.dispose()
+await testUtils.sleep(50)
+assert.deepEqual(host.getSnapshot(), [], 'disposing the admitted plugin must release runtime themes')
+const themeReleases = readLedger().filter(entry => entry.resource?.kind === 'theme' && entry.operation === 'release')
+assert.deepEqual(themeReleases.map(entry => entry.resource.id).sort(), ['pink-ansi', 'pink-day', 'pink-night'])
+assert.deepEqual(themeModule.getTheme('pink-night'), themeModule.getTheme('dark'), 'disposed runtime theme no longer resolves')
+console.log('OK runtime themes: 3 registered, no static files, ledger create/release, disposal clean')
+
+// ── Phase 2: real-host toast delivery (0.10 tuiToast seam) ──────────────────
+// A pre-0.10 user's byte-identical static files shadow the runtime registry;
+// the plugin must surface that through the real toast service. The sink is
+// attached after the extensions row applies, so a toast fired earlier is
+// dropped and must arrive through the relay's bounded retry instead — this
+// exercises both the show() caller binding outside the inject callback and
+// the drop-retry path against the real host.
+const toastModule = await import(pathToFileURL(join(adapter, 'toast.js')).href)
+const sandbox2 = mkdtempSync(join(tmpdir(), 'pink-toast-'))
+process.env.USERPROFILE = sandbox2
+process.env.HOME = sandbox2
+const dataDir2 = join(sandbox2, '.dsh-tui')
+mkdirSync(join(dataDir2, 'themes'), { recursive: true })
+writeFileSync(join(dataDir2, 'theme.json'), JSON.stringify({ theme: 'pink-night' }, null, 2))
+for (const theme of ['pink-night', 'pink-day', 'pink-ansi']) {
+  writeFileSync(
+    join(dataDir2, 'themes', `${theme}.json`),
+    readFileSync(join(pluginRoot, 'themes', `${theme}.json`), 'utf8'),
+  )
+}
+
+const deliveries = []
+const app2 = new Context()
+await app2.plugin(pluginHost.default ?? pluginHost)
+const admitted2 = await testUtils.mountAdmitted(app2, SETTINGS_NAMESPACE, manifest)
+await admitted2.context.plugin(pink)
+await app2.plugin(extensions.default ?? extensions)
+toastModule.getHostToastStore(app2.get('tuiToast'))?.setSink(delivery => deliveries.push(delivery))
+
+const toastDeadline = Date.now() + 8_000
+while (deliveries.length === 0 && Date.now() < toastDeadline) {
+  await testUtils.sleep(25)
+}
+assert.ok(deliveries.length >= 1, 'the shadow-hint toast must reach the host sink (retry included)')
+assert.equal(deliveries[0].color, undefined, 'the shadow hint is neutral')
+for (const file of ['pink-night.json', 'pink-day.json', 'pink-ansi.json']) {
+  assert.ok(deliveries[0].text.includes(file), `hint must name ${file}`)
+}
+await admitted2.fiber.dispose()
+await testUtils.sleep(50)
+console.log('OK toast: shadow hint delivered through the real tuiToast seam')
+
+// ── Phase 3: apply-time toasts reach the sink through the seam-late retry ───
+// On a real 0.10 host the tuiToast service arrives with the extensions row,
+// after this plugin's apply, so toasts fired during apply (the self-heal
+// warning, the boot-follow result) can only survive through the relay's
+// bounded retry. A settings service present at apply time (the dsh CLI core
+// service) drives the boot-follow path with a disagreeing cache.
+const sandbox3 = mkdtempSync(join(tmpdir(), 'pink-apply-toast-'))
+process.env.USERPROFILE = sandbox3
+process.env.HOME = sandbox3
+const dataDir3 = join(sandbox3, '.dsh-tui')
+mkdirSync(join(dataDir3, 'themes'), { recursive: true })
+// Corrupt self-heal target; boot-follow cache disagrees with the persisted pref.
+writeFileSync(join(dataDir3, 'themes', 'pink-night.json'), '{ this is not json')
+writeFileSync(join(dataDir3, 'theme.json'), JSON.stringify({ theme: 'pink-night' }, null, 2))
+writeFileSync(join(dataDir3, 'theme-follow.json'), JSON.stringify({ light: true, at: 1 }, null, 2))
+
+// Minimal settings service standing in for the dsh CLI core service: present
+// at plugin apply time with followSystem already enabled, mirrors scope.watch.
+const fakeSettings = {
+  register() {
+    return {
+      get: () => ({ followSystem: true }),
+      watch(listener) {
+        listener({ followSystem: true })
+        return () => {}
+      },
+    }
+  },
+}
+
+const deliveries3 = []
+const app3 = new Context()
+await app3.plugin(pluginHost.default ?? pluginHost)
+const admitted3 = await testUtils.mountAdmitted(app3, SETTINGS_NAMESPACE, manifest)
+app3.provide('settings', fakeSettings)
+await admitted3.context.plugin(pink)
+await app3.plugin(extensions.default ?? extensions)
+toastModule.getHostToastStore(app3.get('tuiToast'))?.setSink(delivery => deliveries3.push(delivery))
+
+const applyToastDeadline = Date.now() + 8_000
+while (deliveries3.length < 2 && Date.now() < applyToastDeadline) {
+  await testUtils.sleep(25)
+}
+const healToast = deliveries3.find(delivery => delivery.text.includes('已修复'))
+assert.ok(healToast, 'the self-heal warning fired during apply must reach the host sink')
+assert.equal(healToast.color, 'warning', 'the self-heal toast is a warning')
+assert.ok(healToast.text.includes('pink-night.json'), 'the heal toast names the repaired file')
+const followToast = deliveries3.find(delivery => delivery.text.includes('已按保存的终端背景'))
+assert.ok(followToast, 'the boot-follow result fired at settings time must reach the host sink')
+assert.equal(followToast.color, 'success', 'the boot-follow toast is a success')
+assert.ok(followToast.text.includes('pink-day') && followToast.text.includes('reload'), 'the follow toast names the new theme and the reload hint')
+assert.equal(JSON.parse(readFileSync(join(dataDir3, 'theme.json'), 'utf8')).theme, 'pink-day', 'the follow pref write still happened')
+await admitted3.fiber.dispose()
+console.log('OK toast phase 3: apply-time self-heal and boot-follow toasts delivered on the real host')