@askdkc/dsh-cli 0.13.4 → 0.14.0

package/lib/types/adapter/kernel/host-facade.js

@@ -4,7 +4,7 @@
  * P2 callers normally obtain this from `KernelRuntime.facade()`, which backs
  * the descriptor port with the unified kernel lifecycle evidence.
  * `facadeFromLegacy` remains only as a long-term compatibility fallback for
- * bare/test compositions (outside P6 removal scope; owner: dsh-tui adapter).
+ * bare/test compositions (outside P6 removal scope; owner: dsh-cli adapter).
  * Hard rules:
  * - It performs no business logic, no protocol translation, no capability
  *   detection, no registry, and stores no mutable host state.
@@ -91,20 +91,20 @@ const PORT_METHOD_CAPABILITIES = Object.freeze({
 function assertPortMethod(mode, capability) {
     const effectClass = effectClassFor(capability);
     if (effectClass === undefined) {
-        throw new Error(`dsh-tui: Host Port method has no registered effect class: ${capability}`);
+        throw new Error(`dsh-cli: Host Port method has no registered effect class: ${capability}`);
     }
     assertShadowPolicy(effectClass, mode);
 }
 function wrapPort(port, portName, mode) {
     const capabilities = PORT_METHOD_CAPABILITIES[portName];
     if (capabilities === undefined) {
-        throw new Error(`dsh-tui: no shadow-policy map for Host Port "${portName}"`);
+        throw new Error(`dsh-cli: no shadow-policy map for Host Port "${portName}"`);
     }
     const wrapped = {};
     for (const key of Object.keys(port)) {
         const capability = capabilities[key];
         if (capability === undefined) {
-            throw new Error(`dsh-tui: Host Port "${portName}" method "${key}" is missing from the shadow-policy map`);
+            throw new Error(`dsh-cli: Host Port "${portName}" method "${key}" is missing from the shadow-policy map`);
         }
         const descriptor = Object.getOwnPropertyDescriptor(port, key);
         if (descriptor?.get !== undefined) {
@@ -139,13 +139,13 @@ function wrapChannelPort(port, mode) {
             continue;
         const capabilities = CHANNEL_PORT_CAPABILITIES[subName];
         if (capabilities === undefined) {
-            throw new Error(`dsh-tui: Host Channel sub-port "${subName}" is missing from the shadow-policy map`);
+            throw new Error(`dsh-cli: Host Channel sub-port "${subName}" is missing from the shadow-policy map`);
         }
         const subWrapped = {};
         for (const key of Object.keys(subPort)) {
             const capability = capabilities[key];
             if (capability === undefined) {
-                throw new Error(`dsh-tui: Host Channel "${subName}" method "${key}" is missing from the shadow-policy map`);
+                throw new Error(`dsh-cli: Host Channel "${subName}" method "${key}" is missing from the shadow-policy map`);
             }
             const original = subPort[key];
             if (typeof original === 'function') {

package/lib/types/adapter/kernel/host-probe-access.d.ts

@@ -9,7 +9,7 @@
  *
  * IMPORTANT trust boundary:
  *
- * This module is NOT a security boundary. dsh-TUI's plugin model is
+ * This module is NOT a security boundary. dsh-CLI's plugin model is
  * trusted-in-process; any code running in the same process can locate the
  * package root through `package.json` and absolutely import the compiled
  * internal file (for example `lib/adapter/kernel/host-probe-access.js`).

package/lib/types/adapter/kernel/host-probe-access.js

@@ -9,7 +9,7 @@
  *
  * IMPORTANT trust boundary:
  *
- * This module is NOT a security boundary. dsh-TUI's plugin model is
+ * This module is NOT a security boundary. dsh-CLI's plugin model is
  * trusted-in-process; any code running in the same process can locate the
  * package root through `package.json` and absolutely import the compiled
  * internal file (for example `lib/adapter/kernel/host-probe-access.js`).
@@ -30,7 +30,7 @@
  *   public API.
  */
 /** Opaque host-only token. Module-local; deliberately not exported. */
-const HOST_PROBE_TOKEN = Symbol('dsh-tui.host-probe-token');
+const HOST_PROBE_TOKEN = Symbol('dsh-cli.host-probe-token');
 /** The Cordis traceable-proxy unwrap marker used by the host-access module. */
 const CORDIS_ORIGINAL = Symbol.for('cordis.original');
 function unwrapService(service) {
@@ -92,7 +92,7 @@ export function hasMessageLiveProbe(service) {
 }
 function assertOptionalHostToken(token) {
     if (token !== undefined && token !== HOST_PROBE_TOKEN) {
-        throw new Error('dsh-tui: host-only live probe access denied');
+        throw new Error('dsh-cli: host-only live probe access denied');
     }
 }
 export async function runCommandLiveProbe(service, token) {
@@ -100,7 +100,7 @@ export async function runCommandLiveProbe(service, token) {
     const key = unwrapService(service);
     const runner = key === undefined ? undefined : commandRunners.get(key);
     if (runner === undefined)
-        throw new Error('dsh-tui: host command live probe accessor is not registered');
+        throw new Error('dsh-cli: host command live probe accessor is not registered');
     return runner(token);
 }
 export async function runStorageLiveProbe(service, token) {
@@ -108,7 +108,7 @@ export async function runStorageLiveProbe(service, token) {
     const key = unwrapService(service);
     const runner = key === undefined ? undefined : storageRunners.get(key);
     if (runner === undefined)
-        throw new Error('dsh-tui: host storage live probe accessor is not registered');
+        throw new Error('dsh-cli: host storage live probe accessor is not registered');
     return runner(token);
 }
 export async function runMessageLiveProbe(service, token) {
@@ -116,6 +116,6 @@ export async function runMessageLiveProbe(service, token) {
     const key = unwrapService(service);
     const runner = key === undefined ? undefined : messageRunners.get(key);
     if (runner === undefined)
-        throw new Error('dsh-tui: host message live probe accessor is not registered');
+        throw new Error('dsh-cli: host message live probe accessor is not registered');
     return runner(token);
 }

package/lib/types/adapter/kernel/kernel-runtime.js

@@ -450,7 +450,7 @@ export class KernelRuntime {
                 if (this.mountedDriverIds.has(driver.id))
                     continue;
                 if (driver.mountEffectClass === undefined) {
-                    throw new Error(`dsh-tui: driver "${driver.id}" must declare mountEffectClass`);
+                    throw new Error(`dsh-cli: driver "${driver.id}" must declare mountEffectClass`);
                 }
                 // Shadow modes must not abort the whole mount transaction because the
                 // first selected driver is non-read-only. Skip disallowed drivers and

package/lib/types/adapter/kernel/legacy-facade.d.ts

@@ -10,7 +10,7 @@
  *
  * `facadeFromLegacy` is a retained long-term compatibility fallback for
  * bare/test compositions and is explicitly outside the P6 removal scope.
- * OWNER: dsh-tui adapter. UNTIL: no scheduled removal.
+ * OWNER: dsh-cli adapter. UNTIL: no scheduled removal.
  */
 import type { HostDescriptorBuild } from '../standard/descriptor.js';
 import { type HostFacade } from './host-facade.js';

package/lib/types/adapter/kernel/legacy-facade.js

@@ -10,7 +10,7 @@
  *
  * `facadeFromLegacy` is a retained long-term compatibility fallback for
  * bare/test compositions and is explicitly outside the P6 removal scope.
- * OWNER: dsh-tui adapter. UNTIL: no scheduled removal.
+ * OWNER: dsh-cli adapter. UNTIL: no scheduled removal.
  */
 import { createHostFacade } from './host-facade.js';
 export function facadeFromLegacy(services) {

package/lib/types/adapter/kernel/replay-isolation.js

@@ -28,7 +28,7 @@ export function withReplayIsolation(callback) {
 export function enterReplayIsolation() {
     const state = replayIsolationStorage.getStore();
     if (state === undefined) {
-        throw new Error('dsh-tui: replay isolation must be entered through withReplayIsolation() or runReplayShadow(); a process-global replay permit is not allowed');
+        throw new Error('dsh-cli: replay isolation must be entered through withReplayIsolation() or runReplayShadow(); a process-global replay permit is not allowed');
     }
     state.depth += 1;
     let released = false;

package/lib/types/adapter/kernel/runtime.d.ts

@@ -34,7 +34,7 @@ export declare const ADAPTER_SLICE_ALIASES: Readonly<Record<string, string>>;
  * Slice ids are case-insensitive and surrounding whitespace is ignored.
  * Known aliases are mapped to their canonical slice id. Unknown ids are
  * rejected loudly (fail-closed) instead of being silently ignored: a typo in
- * `DSH_TUI_ADAPTER_SLICES` must never accidentally broaden or narrow the
+ * `DSH_CLI_ADAPTER_SLICES` must never accidentally broaden or narrow the
  * governed adapter surface without the operator noticing.
  */
 export declare function normalizeAdapterSliceList(slices: readonly string[]): readonly string[];

package/lib/types/adapter/kernel/runtime.js

@@ -206,7 +206,7 @@ export function parseAdapterMode(value) {
         case 'new':
             return normalized;
         default:
-            throw new Error(`dsh-tui: unknown DSH_TUI_ADAPTER_MODE ${JSON.stringify(value)}; valid modes: legacy, passive-shadow, replay-shadow, new`);
+            throw new Error(`dsh-cli: unknown DSH_CLI_ADAPTER_MODE ${JSON.stringify(value)}; valid modes: legacy, passive-shadow, replay-shadow, new`);
     }
 }
 export const ADAPTER_SLICE_ALIASES = Object.freeze({
@@ -235,7 +235,7 @@ function canonicalAdapterSlice(value) {
  * Slice ids are case-insensitive and surrounding whitespace is ignored.
  * Known aliases are mapped to their canonical slice id. Unknown ids are
  * rejected loudly (fail-closed) instead of being silently ignored: a typo in
- * `DSH_TUI_ADAPTER_SLICES` must never accidentally broaden or narrow the
+ * `DSH_CLI_ADAPTER_SLICES` must never accidentally broaden or narrow the
  * governed adapter surface without the operator noticing.
  */
 export function normalizeAdapterSliceList(slices) {
@@ -245,7 +245,7 @@ export function normalizeAdapterSliceList(slices) {
         if (name === '')
             continue;
         if (!KNOWN_ADAPTER_SLICES.has(name)) {
-            throw new Error(`dsh-tui: unknown adapter slice "${raw}"; valid slices: ${[...KNOWN_ADAPTER_SLICES].sort().join(', ')}`);
+            throw new Error(`dsh-cli: unknown adapter slice "${raw}"; valid slices: ${[...KNOWN_ADAPTER_SLICES].sort().join(', ')}`);
         }
         if (!normalized.includes(name))
             normalized.push(name);
@@ -254,8 +254,8 @@ export function normalizeAdapterSliceList(slices) {
 }
 export function parseAdapterRuntime(env = process.env) {
     return Object.freeze({
-        mode: parseAdapterMode(env.DSH_TUI_ADAPTER_MODE),
-        slices: normalizeAdapterSliceList((env.DSH_TUI_ADAPTER_SLICES ?? '').split(',')),
+        mode: parseAdapterMode(env.DSH_CLI_ADAPTER_MODE),
+        slices: normalizeAdapterSliceList((env.DSH_CLI_ADAPTER_SLICES ?? '').split(',')),
     });
 }
 /**
@@ -294,7 +294,7 @@ export function shadowPolicyAllowed(effectClass, mode) {
 }
 export function assertShadowPolicy(effectClass, mode) {
     if (!shadowPolicyAllowed(effectClass, mode)) {
-        throw new Error(`dsh-tui: shadow policy denies ${effectClass} in ${mode} mode`);
+        throw new Error(`dsh-cli: shadow policy denies ${effectClass} in ${mode} mode`);
     }
 }
 /**
@@ -313,7 +313,7 @@ export function assertCapabilityShadowPolicy(capability, mode, slices) {
         return;
     const effectClass = effectClassFor(capability);
     if (effectClass === undefined) {
-        throw new Error(`dsh-tui: capability has no registered effect class: ${capability}`);
+        throw new Error(`dsh-cli: capability has no registered effect class: ${capability}`);
     }
     assertShadowPolicy(effectClass, mode);
 }

package/lib/types/adapter/ports/channel-display.d.ts

@@ -18,7 +18,7 @@ export type ScrollGutterMode = 'timeline' | 'scrollbar' | 'hidden';
 /** A stored page-margin setting: a preset name or a custom spec. */
 export type PageMarginSetting = PageMarginMode | PageMarginSpec;
 /**
- * Root page inset (settings `dsh-tui.pageMargin`): some terminals carry
+ * Root page inset (settings `dsh-cli.pageMargin`): some terminals carry
  * their own viewport padding (Windows Terminal's 8px default, GUI
  * emulators), others — bare WSL, tmux, SSH — have none, so the UI text
  * touches the screen edges. A setting is either a preset name

package/lib/types/adapter/ports/channel-ui.d.ts

@@ -35,7 +35,7 @@ export interface ChannelUi {
     readonly sessionId: string;
     /** TUI-owned generation that changes on every live Agent rebind. */
     readonly agentBindingGeneration: number;
-    /** `dsh-tui.recapOnOpen` (default on): auto-summarize the session tail
+    /** `dsh-cli.recapOnOpen` (default on): auto-summarize the session tail
      *  into the dim AutoRecapRow when the session opens/resumes. Read live
      *  (settings service), so a `/settings` change applies on the next
      *  session switch; absent settings service → on. */
@@ -116,39 +116,39 @@ export interface ChannelUi {
     /** Live tool-card background treatment. */
     readonly toolBackground: ToolBackground;
     /** What the fullscreen transcript's right gutter shows (settings
-     *  `dsh-tui.scrollGutter`: turn timeline / proportional scrollbar /
+     *  `dsh-cli.scrollGutter`: turn timeline / proportional scrollbar /
      *  nothing). */
     readonly scrollGutter: ScrollGutterMode;
-    /** Root page inset (settings `dsh-tui.pageMargin`): a preset name
+    /** Root page inset (settings `dsh-cli.pageMargin`): a preset name
      *  (`none` / `slim` / `normal` (default) / `roomy`) or a custom `NxM`
      *  spec (columns per side × rows top/bottom) inset the whole UI from the
      *  terminal edges — terminals without their own viewport padding (bare
      *  WSL, tmux, SSH) otherwise hug the screen border. */
     readonly pageMargin: PageMarginSetting;
-    /** Terminal-card header folding (settings `dsh-tui.foldTerminalCommand`):
+    /** Terminal-card header folding (settings `dsh-cli.foldTerminalCommand`):
      *  collapse a multi-line command title to its first line + count hint. */
     readonly foldTerminalCommand: boolean;
     /** Whether the session-name chip shows on the prompt top border's right
-     *  side (settings `dsh-tui.promptSessionLabel`; off by default). */
+     *  side (settings `dsh-cli.promptSessionLabel`; off by default). */
     readonly promptSessionLabel: boolean;
     /** Whether the fullscreen draft editor is enabled (settings
-     *  `dsh-tui.expandEditor`; on by default) — gates the ⛶ affordance and
+     *  `dsh-cli.expandEditor`; on by default) — gates the ⛶ affordance and
      *  the expandEditor shortcut. */
     readonly expandEditor: boolean;
-    /** Smooth streaming reveal (settings `dsh-tui.smoothStreaming`; on by
+    /** Smooth streaming reveal (settings `dsh-cli.smoothStreaming`; on by
      *  default): live-arriving assistant text, expanded thinking, and tool
      *  call bodies paint through a ~30fps reveal instead of jumping per
      *  provider burst. */
     readonly smoothStreaming: boolean;
     /** Live status-footer visibility and compactness preferences. */
     readonly statusBar: Readonly<StatusBarConfig>;
-    /** Whether the header's pixel whale art shows (settings `dsh-tui.whale`). */
+    /** Whether the header's pixel whale art shows (settings `dsh-cli.whale`). */
     readonly whale: boolean;
-    /** Idle whale behaviors switch (settings `dsh-tui.whaleIdle`). */
+    /** Idle whale behaviors switch (settings `dsh-cli.whaleIdle`). */
     readonly whaleIdle: boolean;
     /** Apply an idle-whale-behavior change (see the public Channel type). */
     setWhaleIdle(enabled: boolean): void;
-    /** Minimal mode (settings `dsh-tui.minimal`): no header splash, no emoji
+    /** Minimal mode (settings `dsh-cli.minimal`): no header splash, no emoji
      *  glyphs, no decorative colors; code highlight and tool colors stay. */
     readonly minimal: boolean;
     /** Whether the working-activity line is shown (config.activity); the line
@@ -207,7 +207,7 @@ export interface ChannelUi {
     runExternalCommandOutcome(name: string, rawInput: string, images?: readonly ComposerImageRef[]): Promise<ExternalCommandOutcome | undefined>;
     /**
      * Plugin-registered full-screen scene currently replacing the conversation
-     * (the `dsh-tui-scenes` runtime), if any. The chat screen renders its
+     * (the `dsh-cli-scenes` runtime), if any. The chat screen renders its
      * component INSTEAD of the transcript — the same whole-terminal treatment
      * the trajectory scene gets — and hands it the keyboard; `undefined`
      * renders the conversation normally.
@@ -368,7 +368,7 @@ export interface ChannelUi {
     }>;
     /** Set one effort level by id (validated against the adapter list);
      *  false + a notify when the id is not offered. Persists like the old
-     *  Shift+Tab cycle (~/.dsh-tui/effort.json). */
+     *  Shift+Tab cycle (~/.dsh-cli/effort.json). */
     setEffort(id: string): Promise<boolean>;
     /** Re-seat the future-sessions default reasoning effort (cordis.yml
      *  `effort` → persisted /effort choice → adapter default). The live agent
@@ -417,7 +417,7 @@ export interface ChannelUi {
         timeoutMs?: number;
     }): () => void;
     /** Switch the working-activity indicator preset (`/activity`): validates
-     *  the name, persists it to `~/.dsh-tui/working-activity.json`, and
+     *  the name, persists it to `~/.dsh-cli/working-activity.json`, and
      *  re-renders the indicator immediately; false when the name is unknown
      *  or the preference cannot be written. */
     setActivityFrames(name: string): boolean;
@@ -473,7 +473,7 @@ export interface ChannelUi {
     listSessions(onEnriched?: (summary: SessionSummary) => void): Promise<readonly SessionSummary[]>;
     /** Trailing exchanges of a persisted session, for the browser's preview. */
     previewSession(sessionId: string): Promise<readonly PreviewEntry[]>;
-    /** Mark a session for `dsh-tui --resume` on the next launch. */
+    /** Mark a session for `dsh-cli --resume` on the next launch. */
     setResumeTarget(sessionId: string): void;
     /** Rename the current session (`/rename`): appends a `session/title`
      *  event, which the status line and the /resume picker both read. */
@@ -504,7 +504,7 @@ export interface ChannelUi {
     pushLocal(title: string, lines: readonly string[]): void;
     /** MCP server/tool status for /mcp: one line per server, or setup guidance. */
     mcpStatus(): string[];
-    /** Write the conversation transcript to `dsh-tui-export-<ts>.md` in the
+    /** Write the conversation transcript to `dsh-cli-export-<ts>.md` in the
      *  session cwd; returns the written path, or null on failure. */
     exportSession(): string | null;
     /** Create `AGENTS.md` in the session cwd (DSH workspace-context file);

package/lib/types/adapter/standard/descriptor.d.ts

@@ -1,4 +1,4 @@
-/** Build the current dsh-TUI Host Descriptor from live Kernel lifecycle evidence. */
+/** Build the current dsh-CLI Host Descriptor from live Kernel lifecycle evidence. */
 import type { ContractCoordinate, HostDescriptor } from './types.js';
 import type { CapabilityLifecycle } from '../kernel/lifecycle.js';
 import { HOST_SUPPORTED_CONTRACTS } from '../spec/protocol-constants.js';

package/lib/types/adapter/standard/descriptor.js

@@ -1,4 +1,4 @@
-/** Build the current dsh-TUI Host Descriptor from live Kernel lifecycle evidence. */
+/** Build the current dsh-CLI Host Descriptor from live Kernel lifecycle evidence. */
 import { readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -316,7 +316,7 @@ export function buildHostDescriptor(options) {
     }
     const descriptor = {
         $schema: 'urn:dsh-tui:host-descriptor:0.15',
-        hostId: options.hostId ?? 'dsh-tui',
+        hostId: options.hostId ?? 'dsh-cli',
         hostVersion: options.hostVersion ?? readOwnPackageVersion(),
         facetApiVersions: [...facetApiVersions],
         contracts,

package/lib/types/adapter/standard/registry.d.ts

@@ -1,4 +1,4 @@
-/** Load and verify the pinned dsh-TUI admission profile. */
+/** Load and verify the pinned dsh-CLI admission profile. */
 import type { ContractRegistry, PermissionRegistry, RegistryEntry } from './types.js';
 export declare const DSH_STD_REVISION = "614dfa1ac168db79fcf4577cf0ebb34e2e3b944b";
 export declare const ECOSYSTEM_SPEC_REVISION = "d28c267fe7fd775428ec2dccd65b0b7efd4dacee";

package/lib/types/adapter/standard/registry.js

@@ -1,4 +1,4 @@
-/** Load and verify the pinned dsh-TUI admission profile. */
+/** Load and verify the pinned dsh-CLI admission profile. */
 import { createHash } from 'node:crypto';
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
@@ -172,7 +172,7 @@ export function verifyRegistry(data) {
             failures.push(`${key}: duplicate registry coordinate`);
         coordinates.add(key);
         if ('authority' in entry && !entry.coordinates.apiVersion.startsWith('tui.dsh/')) {
-            failures.push(`${key}: dsh-tui definition must use the private protocol group`);
+            failures.push(`${key}: dsh-cli definition must use the private protocol group`);
         }
         if (!protocols.understands(entry.coordinates))
             failures.push(`${key}: ProtocolCatalog definition unavailable`);

package/lib/types/adapter/standard/tui-extension.d.ts

@@ -1,5 +1,5 @@
 /**
- * dsh-TUI private protocol registration on the shared dsh-std catalog.
+ * dsh-CLI private protocol registration on the shared dsh-std catalog.
  *
  * Private protocol definitions are NOT authored here. The canonical
  * dsh-ecosystem-spec definitions are loaded through `src/adapter/spec/`; this
@@ -19,7 +19,7 @@ export declare function getAdmissionCatalog(): AdmissionCatalog;
 /** Backward-compatible factory retained as a long-term compatibility face
  * for existing callers. It now returns the same process-level canonical
  * catalog rather than allocating a new one, so no second admission core can
- * appear in production. OWNER: dsh-tui adapter. UNTIL: no scheduled removal.
+ * appear in production. OWNER: dsh-cli adapter. UNTIL: no scheduled removal.
  */
 export declare function createAdmissionCatalog(): AdmissionCatalog;
 //# sourceMappingURL=tui-extension.d.ts.map

package/lib/types/adapter/standard/tui-extension.js

@@ -1,5 +1,5 @@
 /**
- * dsh-TUI private protocol registration on the shared dsh-std catalog.
+ * dsh-CLI private protocol registration on the shared dsh-std catalog.
  *
  * Private protocol definitions are NOT authored here. The canonical
  * dsh-ecosystem-spec definitions are loaded through `src/adapter/spec/`; this
@@ -19,7 +19,7 @@ export { TUI_EXTENSION_API_VERSION, DECISION_EVENTS_COORDINATE, DECISION_EVENTS,
  * Keeping the builder private prevents a second canonical catalog from being
  * created by product code. */
 function buildAdmissionCatalog() {
-    const protocols = new ProtocolCatalog({ name: 'dsh-tui-admission', version: '0.15' });
+    const protocols = new ProtocolCatalog({ name: 'dsh-cli-admission', version: '0.15' });
     const manifests = new ManifestDefinitionCatalog();
     registerCommand(protocols, manifests);
     registerStorage(protocols);
@@ -38,7 +38,7 @@ export function getAdmissionCatalog() {
 /** Backward-compatible factory retained as a long-term compatibility face
  * for existing callers. It now returns the same process-level canonical
  * catalog rather than allocating a new one, so no second admission core can
- * appear in production. OWNER: dsh-tui adapter. UNTIL: no scheduled removal.
+ * appear in production. OWNER: dsh-cli adapter. UNTIL: no scheduled removal.
  */
 export function createAdmissionCatalog() {
     return getAdmissionCatalog();

package/lib/types/adapter/upstream/channel-driver.js

@@ -210,7 +210,7 @@ function verifyChannelLiveSync(ctx) {
 function requireChannel(ctx) {
     const channel = channelFor(ctx);
     if (channel === undefined) {
-        throw new Error('dsh-tui: live TUI Channel is not registered for this composition root');
+        throw new Error('dsh-cli: live TUI Channel is not registered for this composition root');
     }
     return channel;
 }
@@ -234,10 +234,10 @@ function createChannelPortLease(ctx, ownDriver, isDriverActive) {
     const cleanups = new Set();
     const assertActive = () => {
         if (!active || !isDriverActive())
-            throw new Error('dsh-tui: Channel driver has been disposed');
+            throw new Error('dsh-cli: Channel driver has been disposed');
         if (captured !== undefined && getTuiChannelRegistration(ctx) !== captured) {
             dispose();
-            throw new Error('dsh-tui: Channel port lifetime has ended');
+            throw new Error('dsh-cli: Channel port lifetime has ended');
         }
     };
     const dispose = () => {
@@ -253,7 +253,7 @@ function createChannelPortLease(ctx, ownDriver, isDriverActive) {
                 failures.push(error);
             }
         }
-        throwCleanupFailures(failures, 'dsh-tui: Channel port cleanup failed');
+        throwCleanupFailures(failures, 'dsh-cli: Channel port cleanup failed');
     };
     const own = (cleanup) => {
         let released = false;
@@ -274,7 +274,7 @@ function createChannelPortLease(ctx, ownDriver, isDriverActive) {
         assertActive();
         const current = getTuiChannelRegistration(ctx);
         if (current === undefined || current.channel === null || typeof current.channel !== 'object') {
-            throw new Error('dsh-tui: live TUI Channel is not registered for this composition root');
+            throw new Error('dsh-cli: live TUI Channel is not registered for this composition root');
         }
         if (captured === undefined) {
             captured = current;
@@ -285,7 +285,7 @@ function createChannelPortLease(ctx, ownDriver, isDriverActive) {
         }
         if (captured !== current) {
             dispose();
-            throw new Error('dsh-tui: Channel port lifetime has ended');
+            throw new Error('dsh-cli: Channel port lifetime has ended');
         }
         // Registering with an already released owner revokes synchronously.
         assertActive();
@@ -309,7 +309,7 @@ function createChannelPortLease(ctx, ownDriver, isDriverActive) {
                 failures.push(error);
             }
         }
-        throwCleanupFailures(failures, 'dsh-tui: Channel driver cleanup failed');
+        throwCleanupFailures(failures, 'dsh-cli: Channel driver cleanup failed');
     });
     return { assertActive, channel, own, dispose };
 }
@@ -394,8 +394,8 @@ function createChannelPort(ctx, own, isActive) {
     });
 }
 export const channelDriver = {
-    id: 'dsh-tui-channel',
-    upstreamFamily: 'dsh-tui',
+    id: 'dsh-cli-channel',
+    upstreamFamily: 'dsh-cli',
     capability: CAPABILITY,
     mountEffectClass: 'read-only',
     detect: detectChannelCapability,
@@ -416,7 +416,7 @@ export const channelDriver = {
                     }
                 }
                 disposers.clear();
-                throwCleanupFailures(failures, 'dsh-tui: Channel driver cleanup failed');
+                throwCleanupFailures(failures, 'dsh-cli: Channel driver cleanup failed');
             },
             ports: { channel: createChannelPort(context, dispose => { disposers.add(dispose); }, () => active) },
         };

package/lib/types/adapter/upstream/decisions-driver.js

@@ -121,13 +121,13 @@ function createDecisionsPort(ctx) {
             }
         },
         subscribe() {
-            throw new Error('dsh-tui: host.decisions.subscribe is staged; plugin subscriptions must use the mediated DecisionEvents API');
+            throw new Error('dsh-cli: host.decisions.subscribe is staged; plugin subscriptions must use the mediated DecisionEvents API');
         },
     });
 }
 export const decisionsDriver = {
-    id: 'dsh-tui-decisions',
-    upstreamFamily: 'dsh-tui',
+    id: 'dsh-cli-decisions',
+    upstreamFamily: 'dsh-cli',
     capability: 'host.decisions',
     mountEffectClass: 'read-only',
     detect: detectDecisionsCapability,

package/lib/types/adapter/upstream/extensions-driver.js

@@ -77,7 +77,7 @@ async function verifyStatusLive(ctx) {
         ];
     }
     const evidence = [serviceEvidence('tuiStatus')];
-    const key = `dsh_tui_probe_${randomUUID().replace(/-/g, '').slice(0, 12)}`;
+    const key = `dsh_cli_probe_${randomUUID().replace(/-/g, '').slice(0, 12)}`;
     const token = Math.floor(Math.random() * 0x7fffffff);
     let setLive = false;
     try {
@@ -177,7 +177,7 @@ async function verifyShortcutsLive(ctx) {
     const evidence = [serviceEvidence('tuiShortcuts')];
     const shortcutKeys = ['9', '0', 'u', 'i', 'o', 'p', 'h', 'j', 'k', 'l', 'b', 'n', 'm'];
     const combo = `ctrl+alt+shift+${shortcutKeys[Math.floor(Math.random() * shortcutKeys.length)]}`;
-    const options = { description: 'dsh-tui reversible shortcut probe', handler: () => undefined };
+    const options = { description: 'dsh-cli reversible shortcut probe', handler: () => undefined };
     let activeCombo = combo;
     let dispose;
     let observed = false;
@@ -280,7 +280,7 @@ async function verifyRenderersLive(ctx) {
         ];
     }
     const evidence = [serviceEvidence('tuiRenderers')];
-    const type = `dsh-tui/probe-${randomUUID().replace(/-/g, '').slice(0, 8)}`;
+    const type = `dsh-cli/probe-${randomUUID().replace(/-/g, '').slice(0, 8)}`;
     let dispose;
     let registerLive = false;
     try {
@@ -368,11 +368,11 @@ async function verifyThemesLive(ctx) {
         ];
     }
     const evidence = [serviceEvidence('tuiThemes')];
-    const name = `dshtuiprobe${randomUUID().replace(/-/g, '').slice(0, 8)}`;
+    const name = `dshcliprobe${randomUUID().replace(/-/g, '').slice(0, 8)}`;
     let dispose;
     let registerLive = false;
     try {
-        dispose = host.register({ name, displayName: 'dsh-tui probe', base: 'dark', colors: {} });
+        dispose = host.register({ name, displayName: 'dsh-cli probe', base: 'dark', colors: {} });
         const snapshot = host.getSnapshot();
         if (!snapshot.some(entry => entry.name === name)) {
             throw new Error('temporary theme was not visible');
@@ -520,7 +520,7 @@ async function verifyCommandTreesLive(ctx) {
         ];
     }
     const evidence = [serviceEvidence('tuiCommandTrees')];
-    const root = `dshtuiprobe${randomUUID().replace(/-/g, '').slice(0, 8)}`;
+    const root = `dshcliprobe${randomUUID().replace(/-/g, '').slice(0, 8)}`;
     let dispose;
     let registerLive = false;
     try {
@@ -570,8 +570,8 @@ function createCommandTreesPort(host) {
 }
 // ── driver objects ────────────────────────────────────────────────────────
 export const statusDriver = {
-    id: 'dsh-tui-status',
-    upstreamFamily: 'dsh-tui',
+    id: 'dsh-cli-status',
+    upstreamFamily: 'dsh-cli',
     capability: 'host.status',
     mountEffectClass: 'mutate',
     detect: detectStatusCapability,
@@ -591,8 +591,8 @@ export const statusDriver = {
     },
 };
 export const shortcutsDriver = {
-    id: 'dsh-tui-shortcuts',
-    upstreamFamily: 'dsh-tui',
+    id: 'dsh-cli-shortcuts',
+    upstreamFamily: 'dsh-cli',
     capability: 'host.shortcuts',
     mountEffectClass: 'register',
     detect: detectShortcutsCapability,
@@ -612,8 +612,8 @@ export const shortcutsDriver = {
     },
 };
 export const renderersDriver = {
-    id: 'dsh-tui-renderers',
-    upstreamFamily: 'dsh-tui',
+    id: 'dsh-cli-renderers',
+    upstreamFamily: 'dsh-cli',
     capability: 'host.renderers',
     mountEffectClass: 'register',
     detect: detectRenderersCapability,
@@ -633,8 +633,8 @@ export const renderersDriver = {
     },
 };
 export const themesDriver = {
-    id: 'dsh-tui-themes',
-    upstreamFamily: 'dsh-tui',
+    id: 'dsh-cli-themes',
+    upstreamFamily: 'dsh-cli',
     capability: 'host.themes',
     mountEffectClass: 'register',
     detect: detectThemesCapability,
@@ -654,8 +654,8 @@ export const themesDriver = {
     },
 };
 export const toastDriver = {
-    id: 'dsh-tui-toast',
-    upstreamFamily: 'dsh-tui',
+    id: 'dsh-cli-toast',
+    upstreamFamily: 'dsh-cli',
     capability: 'host.toast',
     mountEffectClass: 'mutate',
     detect: detectToastCapability,
@@ -675,8 +675,8 @@ export const toastDriver = {
     },
 };
 export const commandTreesDriver = {
-    id: 'dsh-tui-command-trees',
-    upstreamFamily: 'dsh-tui',
+    id: 'dsh-cli-command-trees',
+    upstreamFamily: 'dsh-cli',
     capability: 'host.command-trees',
     mountEffectClass: 'register',
     detect: detectCommandTreesCapability,