@askdkc/dsh-cli 0.13.5 → 0.14.0

package/lib/types/update.d.ts

@@ -1,7 +1,8 @@
+export { installedCliVersion } from './package-version.js';
 import { shellQuote } from './utils/shellQuote.js';
 export { shellQuote };
 /**
- * Append a /restart handoff event to ~/.dsh-tui/restart.log.
+ * Append a /restart handoff event to ~/.dsh-cli/restart.log.
  * @param event - Short stable event name.
  * @param data - Small JSON-safe detail (never credentials or session text).
  */
@@ -14,7 +15,7 @@ export declare function beginRestartAttempt(sessionId: string): void;
  * indistinguishable from a silent failure.
  */
 export declare function writeHandoffNotice(text: string): void;
-export interface TuiUpdateInfo {
+export interface CliUpdateInfo {
     current: string;
     latest: string;
     isStandalone?: boolean;
@@ -23,7 +24,7 @@ export interface TuiUpdateInfo {
     checksumUrl?: string;
 }
 /** What a fresh registry lookup says about this install. */
-export type TuiUpdateTarget = {
+export type CliUpdateTarget = {
     kind: 'update';
     current: string;
     latest: string;
@@ -39,7 +40,7 @@ export type TuiUpdateTarget = {
     kind: 'unknown';
     isStandalone?: boolean;
 };
-export interface TuiUpdateResult {
+export interface CliUpdateResult {
     /** Exit code of the `dsh plugin update` run (0 = the package was updated). */
     updateCode: number;
     /**
@@ -48,8 +49,6 @@ export interface TuiUpdateResult {
      */
     restartCode: number;
 }
-/** Read the version from either the compiled package or the source checkout. */
-export declare function installedTuiVersion(): string | undefined;
 /**
  * The profile this TUI was booted with (`dsh --profile <name>`), read from
  * the launcher argv the process inherited. dsh sets no profile env var, and
@@ -70,7 +69,7 @@ export declare function isVersionNewer(current: string, previous: string): boole
 /**
  * Versions whose compiled plugin hard-injects `tuiWorkspaces`
  * ('0.7.0'–'0.7.1'; removed in 0.7.2). Installing one while the globally
- * installed launcher copy predates the `dsh-tui-workspaces` patch row
+ * installed launcher copy predates the `dsh-cli-workspaces` patch row
  * deadlocks boot forever at "pending (waiting for service: tuiWorkspaces)"
  * (issues #183/#307) — and /update reaching such a target is exactly how
  * stale-mirror installs stranded users. /update must refuse them.
@@ -156,7 +155,7 @@ export declare function verifyAssetChecksum(buffer: Buffer, manifestText: string
  * Escape a value for embedding in a PowerShell single-quoted literal: only
  * `''` needs escaping there (same convention as `buildPsScript` in
  * src/utils/clipboard.ts). Extract/archive paths derive from environment
- * variables (`DSH_TUI_STANDALONE_CACHE`), so an unescaped `'` closes the
+ * variables (`DSH_CLI_STANDALONE_CACHE`), so an unescaped `'` closes the
  * literal and turns the rest of the path into executable command text.
  * @param value - Raw string to embed between single quotes.
  * @returns The value with every `'` doubled.
@@ -262,15 +261,15 @@ export declare function downloadAndReplaceStandaloneBinary(downloadUrl: string,
  * say "installing X now, official latest is Y" instead of silently
  * upgrading to yesterday's version.
  */
-export declare function resolveTuiUpdateTarget(): Promise<TuiUpdateTarget>;
+export declare function resolveCliUpdateTarget(): Promise<CliUpdateTarget>;
 /**
  * Check npm for a newer published TUI version. Network and registry errors
  * are intentionally treated as "no result" so an offline launch never delays
  * or blocks the interactive TUI.
  */
-export declare function checkForTuiUpdate(): Promise<TuiUpdateInfo | undefined>;
+export declare function checkForCliUpdate(): Promise<CliUpdateInfo | undefined>;
 /** Build the profile-manager command, preferring a preflight-pinned version. */
-export declare function tuiUpdatePluginArgs(profile: string, targetVersion?: string): string[];
+export declare function cliUpdatePluginArgs(profile: string, targetVersion?: string): string[];
 /** The profile's pnpm-workspace.yaml (`$DSH_HOME ?? ~/.dsh` layout). */
 export declare function profileWorkspaceYamlPath(profile: string): string;
 /** What ensureProfileAllowBuilds did to the profile workspace file. */
@@ -282,7 +281,7 @@ export interface AllowBuildsOutcome {
 }
 /**
  * Make sure the profile's pnpm-workspace.yaml carries explicit `false`
- * allowBuilds entries for the dsh-tui chain's postinstall-only deps, so a
+ * allowBuilds entries for the dsh-cli chain's postinstall-only deps, so a
  * pnpm ≥11 update is not killed by ERR_PNPM_IGNORED_BUILDS. Best effort and
  * idempotent: existing entries are never overwritten (an explicit user
  * decision wins), a missing `allowBuilds:` block is appended, and a missing
@@ -431,15 +430,15 @@ export interface StaleInstallRemoval {
 export declare function removeStalePackageInstall(profile: string): StaleInstallRemoval;
 /**
  * Best-effort migrate the GLOBAL launcher to the delegating shim (0.8.7):
- * after a successful profile update, copy this package's `bin/dsh-tui.js`
+ * after a successful profile update, copy this package's `bin/dsh-cli.js`
  * and `package.json` over the global install so the launcher can never lag
  * the profile again — the shim delegates all logic to the profile copy it
  * just updated. Single-file-safe by contract: the new bin imports nothing
  * from lib/ (see its header), so overwriting it inside an older global
  * install cannot dangle a missing helper.
  *
- * Locating the global dir relies on argv[1] being the global `dsh-tui.js`
- * (true when booted through the `dsh-tui` command). Source checkouts and
+ * Locating the global dir relies on argv[1] being the global `dsh-cli.js`
+ * (true when booted through the `dsh-cli` command). Source checkouts and
  * direct `dsh --profile` boots resolve nothing — the migration is a silent
  * no-op there. Write failures (permissions, locked files) are equally
  * silent: the launcher-alignment warning remains the fallback diagnosis.
@@ -448,7 +447,7 @@ export declare function removeStalePackageInstall(profile: string): StaleInstall
  */
 export declare function migrateGlobalLauncher(): boolean;
 /** Outcome of the install-only half of an update (no restart). */
-export interface TuiUpdateOutcome {
+export interface CliUpdateOutcome {
     /** 0 = the profile now runs the intended version; non-zero = failed. */
     code: number;
     /** Version installed before the update ran (the #307 stamp). */
@@ -459,7 +458,7 @@ export interface TuiUpdateOutcome {
 /**
  * Install-only half of `/update`: run `dsh plugin add`, refuse boot-deadlock
  * targets, verify the profile actually advanced, and migrate the global
- * launcher. No restart — `updateTuiAndRestart` layers the session-preserving
+ * launcher. No restart — `updateCliAndRestart` layers the session-preserving
  * restart on top, and the `dsh-cli update` CLI stops here.
  *
  * @param profile - The dsh profile to update.
@@ -467,9 +466,9 @@ export interface TuiUpdateOutcome {
  *   undefined when that check failed and pnpm should resolve latest.
  * @returns The update exit code plus the before/after versions.
  */
-export declare function updateTui(profile: string, targetVersion?: string): Promise<TuiUpdateOutcome>;
+export declare function updateCli(profile: string, targetVersion?: string): Promise<CliUpdateOutcome>;
 /**
- * Update the installed dsh-tui package and restart the same launcher while
+ * Update the installed dsh-cli package and restart the same launcher while
  * preserving the active session. The TUI must already be unmounted before
  * this is called so pnpm output cannot corrupt the rendered terminal frame.
  *
@@ -486,7 +485,7 @@ export declare function updateTui(profile: string, targetVersion?: string): Prom
  *   check, or undefined when that check failed and pnpm should resolve latest.
  * @returns Exit codes for the update run and the replacement process.
  */
-export declare function updateTuiAndRestart(sessionId: string, profile: string, targetVersion?: string): Promise<TuiUpdateResult>;
+export declare function updateCliAndRestart(sessionId: string, profile: string, targetVersion?: string): Promise<CliUpdateResult>;
 /**
  * Headless `dsh-cli update`: the `/update` decision flow (preflight, deadlock
  * refusal, mirror-lag note, `--latest` fallback) followed by the install-only
@@ -509,12 +508,12 @@ export declare function cliUpdate(profile: string): Promise<number>;
  * update restarts into a TUI that takes no input).
  *
  * The TUI must already be unmounted before this is called (same terminal
- * handoff contract as `updateTuiAndRestart`): the caller runs this from the
+ * handoff contract as `updateCliAndRestart`): the caller runs this from the
  * exit funnel's done callback, after finishExit detached the terminal and
  * the readable stdin pump.
  *
  * This waits for the replacement's natural exit: the outer command
- * interpreter that ran `dsh-tui` reclaims the console the moment the
+ * interpreter that ran `dsh-cli` reclaims the console the moment the
  * launch chain (cmd → wrapper → this process) unwinds, and an orphaned
  * replacement still attached to the console then fights the interpreter's
  * own prompt and line reader for every keypress (field evidence
@@ -532,19 +531,19 @@ export declare function cliUpdate(profile: string): Promise<number>;
  * @param sessionId - Session to resume in the replacement process.
  * @param options - `kind: 'update'` drops the /restart boot-diagnosis
  *   marker and tags restart.log events for the update flow; `env` adds
- *   marker variables for the replacement (e.g. DSH_TUI_UPDATED_FROM).
+ *   marker variables for the replacement (e.g. DSH_CLI_UPDATED_FROM).
  * @returns 0 when the replacement ran and exited cleanly, 127 when it
  *   failed to start, otherwise the child's own exit code.
  */
-export interface TuiRestartOptions {
+export interface CliRestartOptions {
     /** Extra env markers for the replacement process (/update's stamp). */
     env?: Record<string, string>;
     /**
      * 'update' reuses this handoff after an install: no
-     * DSH_TUI_RESTART_CHILD marker (that flag is /restart-only boot
+     * DSH_CLI_RESTART_CHILD marker (that flag is /restart-only boot
      * diagnostics) and restart.log events carry the update-restart tag.
      */
     kind?: 'restart' | 'update';
 }
-export declare function restartTui(sessionId: string, options?: TuiRestartOptions): Promise<number>;
+export declare function restartCli(sessionId: string, options?: CliRestartOptions): Promise<number>;
 //# sourceMappingURL=update.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"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"}

package/lib/types/update.js

@@ -1,3 +1,5 @@
+import { installedCliVersion } from './package-version.js';
+export { installedCliVersion } from './package-version.js';
 import { execFileSync, spawn } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import { appendFileSync, chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
@@ -28,12 +30,12 @@ const MAX_ASSET_BYTES = 512 * 1024 * 1024;
 /** The SHA256SUMS manifest itself is plain text; anything past this is broken. */
 const MAX_CHECKSUM_MANIFEST_BYTES = 1024 * 1024;
 /** env marker set on the /update restart; the new process verifies it at boot. */
-const UPDATED_FROM_ENV = 'DSH_TUI_UPDATED_FROM';
+const UPDATED_FROM_ENV = 'DSH_CLI_UPDATED_FROM';
 /**
  * env marker set on the /restart replacement: its boot logs to restart.log
  * (ordinary launches stay silent, so the file is restart-only evidence).
  */
-const RESTART_CHILD_ENV = 'DSH_TUI_RESTART_CHILD';
+const RESTART_CHILD_ENV = 'DSH_CLI_RESTART_CHILD';
 /**
  * Field-diagnosis log for the /restart terminal handoff, appended by BOTH
  * processes: the exiting TUI logs the funnel path, the spawned replacement
@@ -56,7 +58,7 @@ function writeRestartLine(line) {
     }
 }
 /**
- * Append a /restart handoff event to ~/.dsh-tui/restart.log.
+ * Append a /restart handoff event to ~/.dsh-cli/restart.log.
  * @param event - Short stable event name.
  * @param data - Small JSON-safe detail (never credentials or session text).
  */
@@ -95,26 +97,6 @@ export function writeHandoffNotice(text) {
         process.stderr.write(text);
     }
 }
-/** Read the version from either the compiled package or the source checkout. */
-export function installedTuiVersion() {
-    const here = dirname(fileURLToPath(import.meta.url));
-    for (const relativePath of ['../../package.json', '../package.json']) {
-        try {
-            const parsed = JSON.parse(readFileSync(join(here, relativePath), 'utf8'));
-            if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
-                const packageJson = parsed;
-                const version = packageJson.version;
-                if (packageJson.name === PACKAGE_NAME && typeof version === 'string' && valid(version) !== null) {
-                    return version;
-                }
-            }
-        }
-        catch {
-            // Try the source-layout fallback after the compiled-layout path.
-        }
-    }
-    return undefined;
-}
 /**
  * The profile this TUI was booted with (`dsh --profile <name>`), read from
  * the launcher argv the process inherited. dsh sets no profile env var, and
@@ -166,7 +148,7 @@ export function isVersionNewer(current, previous) {
 /**
  * Versions whose compiled plugin hard-injects `tuiWorkspaces`
  * ('0.7.0'–'0.7.1'; removed in 0.7.2). Installing one while the globally
- * installed launcher copy predates the `dsh-tui-workspaces` patch row
+ * installed launcher copy predates the `dsh-cli-workspaces` patch row
  * deadlocks boot forever at "pending (waiting for service: tuiWorkspaces)"
  * (issues #183/#307) — and /update reaching such a target is exactly how
  * stale-mirror installs stranded users. /update must refuse them.
@@ -210,9 +192,9 @@ async function fetchLatestVersion(registryBase) {
  * @returns `true` when running inside a standalone binary distribution, `false` otherwise.
  */
 export function isStandaloneRuntime() {
-    return (process.env.DSH_TUI_STANDALONE === '1' ||
-        process.env.DSH_TUI_STANDALONE_BINARY !== undefined ||
-        (typeof process.env.DSH_HOME === 'string' && process.env.DSH_HOME.includes('dsh-tui-standalone')));
+    return (process.env.DSH_CLI_STANDALONE === '1' ||
+        process.env.DSH_CLI_STANDALONE_BINARY !== undefined ||
+        (typeof process.env.DSH_HOME === 'string' && process.env.DSH_HOME.includes('dsh-cli-standalone')));
 }
 /**
  * Get the path to the current standalone executable binary.
@@ -220,7 +202,7 @@ export function isStandaloneRuntime() {
  * @returns The resolved executable path from environment or `process.execPath`.
  */
 export function getStandaloneBinaryPath() {
-    return process.env.DSH_TUI_STANDALONE_BINARY ?? process.execPath;
+    return process.env.DSH_CLI_STANDALONE_BINARY ?? process.execPath;
 }
 /**
  * Get the expected release asset file name for the current platform and architecture.
@@ -231,16 +213,16 @@ export function getStandaloneBinaryPath() {
  */
 export function getStandaloneAssetName(platform = process.platform, arch = process.arch) {
     if (platform === 'win32') {
-        return 'dsh-tui-standalone-win-x64.zip';
+        return 'dsh-cli-standalone-win-x64.zip';
     }
     if (platform === 'darwin') {
         return arch === 'arm64'
-            ? 'dsh-tui-standalone-darwin-arm64.tar.gz'
-            : 'dsh-tui-standalone-darwin-x64.tar.gz';
+            ? 'dsh-cli-standalone-darwin-arm64.tar.gz'
+            : 'dsh-cli-standalone-darwin-x64.tar.gz';
     }
     return arch === 'arm64'
-        ? 'dsh-tui-standalone-linux-arm64.tar.gz'
-        : 'dsh-tui-standalone-linux-x64.tar.gz';
+        ? 'dsh-cli-standalone-linux-arm64.tar.gz'
+        : 'dsh-cli-standalone-linux-x64.tar.gz';
 }
 /**
  * Locate the release's checksum manifest among its assets: the aggregator
@@ -287,7 +269,7 @@ async function probeChecksumManifestUrl(url) {
     const timeout = setTimeout(() => controller.abort(), UPDATE_CHECK_TIMEOUT_MS);
     try {
         const response = await fetch(url, {
-            headers: { 'user-agent': 'dsh-tui-updater' },
+            headers: { 'user-agent': 'dsh-cli-updater' },
             redirect: 'follow',
             signal: controller.signal,
         });
@@ -314,7 +296,7 @@ export async function fetchGithubLatestRelease(options = {}) {
     const timeout = setTimeout(() => controller.abort(), UPDATE_CHECK_TIMEOUT_MS);
     try {
         const response = await doFetch(`${options.apiBaseUrl ?? 'https://api.github.com'}/repos/${GITHUB_REPO}/releases/latest`, {
-            headers: { accept: 'application/vnd.github.v3+json', 'user-agent': 'dsh-tui-updater' },
+            headers: { accept: 'application/vnd.github.v3+json', 'user-agent': 'dsh-cli-updater' },
             signal: controller.signal,
         });
         if (!response.ok)
@@ -402,7 +384,7 @@ export function verifyAssetChecksum(buffer, manifestText, assetName) {
  * Escape a value for embedding in a PowerShell single-quoted literal: only
  * `''` needs escaping there (same convention as `buildPsScript` in
  * src/utils/clipboard.ts). Extract/archive paths derive from environment
- * variables (`DSH_TUI_STANDALONE_CACHE`), so an unescaped `'` closes the
+ * variables (`DSH_CLI_STANDALONE_CACHE`), so an unescaped `'` closes the
  * literal and turns the rest of the path into executable command text.
  * @param value - Raw string to embed between single quotes.
  * @returns The value with every `'` doubled.
@@ -518,7 +500,7 @@ async function fetchChecksumManifest(checksumUrl, maxManifestBytes = MAX_CHECKSU
     const timeout = setTimeout(() => controller.abort(), STANDALONE_DOWNLOAD_TIMEOUT_MS);
     try {
         const response = await fetch(checksumUrl, {
-            headers: { 'user-agent': 'dsh-tui-updater' },
+            headers: { 'user-agent': 'dsh-cli-updater' },
             redirect: 'follow',
             signal: controller.signal,
         });
@@ -576,7 +558,7 @@ async function fetchChecksumManifest(checksumUrl, maxManifestBytes = MAX_CHECKSU
  */
 export async function downloadAndReplaceStandaloneBinary(downloadUrl, onProgress, checksumUrl, options = {}) {
     const maxAssetBytes = options.maxAssetBytes ?? MAX_ASSET_BYTES;
-    const tempDir = join(process.env.DSH_TUI_STANDALONE_CACHE ?? join(homedir(), '.cache', 'dsh-tui-standalone'), `.update-${Date.now()}-${process.pid}`);
+    const tempDir = join(process.env.DSH_CLI_STANDALONE_CACHE ?? join(homedir(), '.cache', 'dsh-cli-standalone'), `.update-${Date.now()}-${process.pid}`);
     try {
         const currentBinary = getStandaloneBinaryPath();
         const targetDir = dirname(currentBinary);
@@ -590,7 +572,7 @@ export async function downloadAndReplaceStandaloneBinary(downloadUrl, onProgress
         let response;
         try {
             response = await fetch(downloadUrl, {
-                headers: { 'user-agent': 'dsh-tui-updater' },
+                headers: { 'user-agent': 'dsh-cli-updater' },
                 redirect: 'follow',
                 signal: controller.signal,
             });
@@ -682,7 +664,7 @@ export async function downloadAndReplaceStandaloneBinary(downloadUrl, onProgress
         if (!treeCheck.ok) {
             throw new Error(`unsafe release archive rejected: ${treeCheck.reason ?? 'unknown extraction anomaly'}`);
         }
-        const binaryName = process.platform === 'win32' ? 'dsh-tui.exe' : 'dsh-tui';
+        const binaryName = process.platform === 'win32' ? 'dsh-cli.exe' : 'dsh-cli';
         const newBinaryPath = join(extractDir, binaryName);
         if (!existsSync(newBinaryPath)) {
             throw new Error('No executable binary found in release archive');
@@ -727,7 +709,7 @@ export async function downloadAndReplaceStandaloneBinary(downloadUrl, onProgress
             }
         }
         else {
-            const stagedTarget = join(targetDir, `.dsh-tui-new-${process.pid}`);
+            const stagedTarget = join(targetDir, `.dsh-cli-new-${process.pid}`);
             copyFileSync(newBinaryPath, stagedTarget);
             chmodSync(stagedTarget, 0o755);
             renameSync(stagedTarget, currentBinary);
@@ -759,8 +741,8 @@ export async function downloadAndReplaceStandaloneBinary(downloadUrl, onProgress
  * say "installing X now, official latest is Y" instead of silently
  * upgrading to yesterday's version.
  */
-export async function resolveTuiUpdateTarget() {
-    const current = installedTuiVersion();
+export async function resolveCliUpdateTarget() {
+    const current = installedCliVersion();
     const currentVersion = current === undefined ? null : valid(current);
     if (currentVersion === null)
         return { kind: 'unknown' };
@@ -803,8 +785,8 @@ export async function resolveTuiUpdateTarget() {
  * are intentionally treated as "no result" so an offline launch never delays
  * or blocks the interactive TUI.
  */
-export async function checkForTuiUpdate() {
-    const target = await resolveTuiUpdateTarget();
+export async function checkForCliUpdate() {
+    const target = await resolveCliUpdateTarget();
     return target.kind === 'update'
         ? {
             current: target.current,
@@ -861,7 +843,7 @@ function runProcess(command, args, options = {}) {
     });
 }
 /** Build the profile-manager command, preferring a preflight-pinned version. */
-export function tuiUpdatePluginArgs(profile, targetVersion) {
+export function cliUpdatePluginArgs(profile, targetVersion) {
     return targetVersion === undefined
         ? ['plugin', '--profile', profile, 'update', '--latest', PACKAGE_NAME]
         : ['plugin', '--profile', profile, 'update', `${PACKAGE_NAME}@${targetVersion}`];
@@ -894,7 +876,7 @@ function allowBuildsKeyLine(key) {
 }
 /**
  * Make sure the profile's pnpm-workspace.yaml carries explicit `false`
- * allowBuilds entries for the dsh-tui chain's postinstall-only deps, so a
+ * allowBuilds entries for the dsh-cli chain's postinstall-only deps, so a
  * pnpm ≥11 update is not killed by ERR_PNPM_IGNORED_BUILDS. Best effort and
  * idempotent: existing entries are never overwritten (an explicit user
  * decision wins), a missing `allowBuilds:` block is appended, and a missing
@@ -1324,15 +1306,15 @@ export function removeStalePackageInstall(profile) {
 }
 /**
  * Best-effort migrate the GLOBAL launcher to the delegating shim (0.8.7):
- * after a successful profile update, copy this package's `bin/dsh-tui.js`
+ * after a successful profile update, copy this package's `bin/dsh-cli.js`
  * and `package.json` over the global install so the launcher can never lag
  * the profile again — the shim delegates all logic to the profile copy it
  * just updated. Single-file-safe by contract: the new bin imports nothing
  * from lib/ (see its header), so overwriting it inside an older global
  * install cannot dangle a missing helper.
  *
- * Locating the global dir relies on argv[1] being the global `dsh-tui.js`
- * (true when booted through the `dsh-tui` command). Source checkouts and
+ * Locating the global dir relies on argv[1] being the global `dsh-cli.js`
+ * (true when booted through the `dsh-cli` command). Source checkouts and
  * direct `dsh --profile` boots resolve nothing — the migration is a silent
  * no-op there. Write failures (permissions, locked files) are equally
  * silent: the launcher-alignment warning remains the fallback diagnosis.
@@ -1341,7 +1323,7 @@ export function removeStalePackageInstall(profile) {
  */
 export function migrateGlobalLauncher() {
     const launcherBin = process.argv[1];
-    if (launcherBin === undefined || !launcherBin.endsWith('dsh-tui.js'))
+    if (launcherBin === undefined || !launcherBin.endsWith('dsh-cli.js'))
         return false;
     // Walk up from the bin to the containing package; accept it only when it
     // is OUR package and not the profile copy we are running from (junction
@@ -1367,11 +1349,11 @@ export function migrateGlobalLauncher() {
                 // tmp + rename keeps each file atomic; a crash mid-migration leaves
                 // either the old or the new file, never a truncated one.
                 const replace = (target, source) => {
-                    const staged = `${target}.dsh-tui-migrate`;
+                    const staged = `${target}.dsh-cli-migrate`;
                     writeFileSync(staged, readFileSync(source));
                     renameSync(staged, target);
                 };
-                replace(join(dir, 'bin', 'dsh-tui.js'), join(ownDir, 'bin', 'dsh-tui.js'));
+                replace(join(dir, 'bin', 'dsh-cli.js'), join(ownDir, 'bin', 'dsh-cli.js'));
                 replace(manifest, join(ownDir, 'package.json'));
                 return true;
             }
@@ -1389,7 +1371,7 @@ export function migrateGlobalLauncher() {
 /**
  * Install-only half of `/update`: run `dsh plugin add`, refuse boot-deadlock
  * targets, verify the profile actually advanced, and migrate the global
- * launcher. No restart — `updateTuiAndRestart` layers the session-preserving
+ * launcher. No restart — `updateCliAndRestart` layers the session-preserving
  * restart on top, and the `dsh-cli update` CLI stops here.
  *
  * @param profile - The dsh profile to update.
@@ -1397,15 +1379,15 @@ export function migrateGlobalLauncher() {
  *   undefined when that check failed and pnpm should resolve latest.
  * @returns The update exit code plus the before/after versions.
  */
-export async function updateTui(profile, targetVersion) {
+export async function updateCli(profile, targetVersion) {
     // Stamp the pre-update version BEFORE pnpm runs: it reads this package's
     // manifest from disk, which the update replaces on the fly — a
     // post-update read already sees the NEW version, and the restarted
     // process then compares new-vs-new and false-alarms "version did not
     // advance" on every successful update (issue #307's screenshots).
-    const updatedFrom = installedTuiVersion() ?? '';
+    const updatedFrom = installedCliVersion() ?? '';
     if (isStandaloneRuntime()) {
-        const target = await resolveTuiUpdateTarget();
+        const target = await resolveCliUpdateTarget();
         const latestVersion = targetVersion ?? (target.kind === 'update' ? target.latest : undefined);
         const downloadUrl = (target.kind === 'update' && target.downloadUrl)
             ? target.downloadUrl
@@ -1426,7 +1408,7 @@ export async function updateTui(profile, targetVersion) {
         return { code: 0, updatedFrom, installed: latestVersion };
     }
     const dsh = process.platform === 'win32' ? 'dsh.cmd' : 'dsh';
-    const updateArgs = tuiUpdatePluginArgs(profile, targetVersion);
+    const updateArgs = cliUpdatePluginArgs(profile, targetVersion);
     // pnpm ≥11 hard-fails installs whose dependency tree carries un-allowlisted
     // build scripts (ERR_PNPM_IGNORED_BUILDS). The dsh-auth chain pulls in
     // postinstall-only deps (@google/genai/protobufjs via pi-ai), so pre-seed
@@ -1490,7 +1472,7 @@ export async function updateTui(profile, targetVersion) {
     // #183/#307. Refuse the restart when the version JUST moved there; a user
     // who was already on it keeps their restart (their combo demonstrably
     // boots) and gets the repair hint on the next /update instead.
-    const installedNow = installedTuiVersion();
+    const installedNow = installedCliVersion();
     if (installedNow !== undefined && installedNow !== updatedFrom && isBootDeadlockTarget(installedNow)) {
         process.stderr.write(`dsh-cli: update landed on ${installedNow}, which can permanently deadlock boot under older launcher patches ` +
             `(#183/#307) — NOT restarting into it. Repair with:\n` +
@@ -1504,10 +1486,10 @@ export async function updateTui(profile, targetVersion) {
     // node_modules, and if the mismatch survives, stop before restarting into
     // a mixed state and hand the user the exact repair command instead.
     if (targetVersion !== undefined) {
-        let installed = installedTuiVersion();
+        let installed = installedCliVersion();
         if (installed !== targetVersion) {
             await runProcess(dsh, ['plugin', '--profile', profile, 'install'], { shell: true });
-            installed = installedTuiVersion();
+            installed = installedCliVersion();
         }
         if (installed !== targetVersion) {
             process.stderr.write(`dsh-cli: update completed but the profile still runs ${installed ?? 'an unreadable version'} ` +
@@ -1523,10 +1505,10 @@ export async function updateTui(profile, targetVersion) {
     if (migrateGlobalLauncher()) {
         process.stderr.write('dsh-cli: global launcher aligned to the delegating shim (no manual npm i -g needed anymore).\n');
     }
-    return { code: 0, updatedFrom, installed: installedTuiVersion() };
+    return { code: 0, updatedFrom, installed: installedCliVersion() };
 }
 /**
- * Update the installed dsh-tui package and restart the same launcher while
+ * Update the installed dsh-cli package and restart the same launcher while
  * preserving the active session. The TUI must already be unmounted before
  * this is called so pnpm output cannot corrupt the rendered terminal frame.
  *
@@ -1543,8 +1525,8 @@ export async function updateTui(profile, targetVersion) {
  *   check, or undefined when that check failed and pnpm should resolve latest.
  * @returns Exit codes for the update run and the replacement process.
  */
-export async function updateTuiAndRestart(sessionId, profile, targetVersion) {
-    const outcome = await updateTui(profile, targetVersion);
+export async function updateCliAndRestart(sessionId, profile, targetVersion) {
+    const outcome = await updateCli(profile, targetVersion);
     const { updatedFrom } = outcome;
     if (outcome.code !== 0)
         return { updateCode: outcome.code, restartCode: outcome.code };
@@ -1555,7 +1537,7 @@ export async function updateTuiAndRestart(sessionId, profile, targetVersion) {
     // child's keypresses, and capture a fast-death stderr report. The old
     // plain inherit spawn raced the interpreter for input on Windows
     // Terminal (issue #483: "cannot type anything after /update").
-    const restartCode = await restartTui(sessionId, {
+    const restartCode = await restartCli(sessionId, {
         env: { [UPDATED_FROM_ENV]: updatedFrom },
         kind: 'update',
     });
@@ -1571,7 +1553,7 @@ export async function updateTuiAndRestart(sessionId, profile, targetVersion) {
  * @returns Process exit code: 0 on success or already-latest, 1 otherwise.
  */
 export async function cliUpdate(profile) {
-    const target = await resolveTuiUpdateTarget();
+    const target = await resolveCliUpdateTarget();
     if (target.kind === 'latest') {
         process.stdout.write(`dsh-cli: already the latest version (${target.current}).\n`);
         return 0;
@@ -1579,7 +1561,7 @@ export async function cliUpdate(profile) {
     if (isStandaloneRuntime()) {
         if (target.kind === 'update') {
             process.stdout.write(`dsh-cli: updating standalone binary ${target.current} → ${target.latest}…\n`);
-            const outcome = await updateTui(profile, target.latest);
+            const outcome = await updateCli(profile, target.latest);
             if (outcome.code === 0) {
                 process.stdout.write(`dsh-cli: standalone binary updated successfully (${outcome.updatedFrom || target.current} → ${outcome.installed}).\n`);
             }
@@ -1608,12 +1590,12 @@ export async function cliUpdate(profile) {
     else {
         process.stdout.write('dsh-cli: version check failed (offline or unreadable install) — falling back to `--latest`.\n');
     }
-    const outcome = await updateTui(profile, targetVersion);
+    const outcome = await updateCli(profile, targetVersion);
     if (outcome.code === 0) {
         // A preflight-less run (`--latest` fallback) can "succeed" as a pnpm
         // no-op: same manifest before and after. Say so instead of printing a
         // vacuous `updated X → X` — the /update path surfaces the same state via
-        // the DSH_TUI_UPDATED_FROM stamp on restart.
+        // the DSH_CLI_UPDATED_FROM stamp on restart.
         if (targetVersion === undefined && outcome.installed !== undefined && outcome.installed === outcome.updatedFrom) {
             process.stdout.write(`dsh-cli: version did not advance (still ${outcome.installed}) — already the latest, or the registry has no newer release yet.\n`);
         }
@@ -1623,7 +1605,7 @@ export async function cliUpdate(profile) {
     }
     return outcome.code;
 }
-export async function restartTui(sessionId, options = {}) {
+export async function restartCli(sessionId, options = {}) {
     const kind = options.kind ?? 'restart';
     const tag = kind === 'update' ? 'update-restart' : 'restart';
     const argv = [...process.execArgv, ...process.argv.slice(1)];
@@ -1643,8 +1625,8 @@ export async function restartTui(sessionId, options = {}) {
             env: {
                 ...process.env,
                 // The replacement resumes the current session through the launcher
-                // contract (DSH_TUI_RESUME_SESSION; see src/sessionHistory.ts).
-                DSH_TUI_RESUME_SESSION: sessionId,
+                // contract (DSH_CLI_RESUME_SESSION; see src/sessionHistory.ts).
+                DSH_CLI_RESUME_SESSION: sessionId,
                 // Marks the replacement so its own boot logs to restart.log without
                 // noisy logging on every ordinary launch (/restart only).
                 ...(kind === 'restart' ? { [RESTART_CHILD_ENV]: '1' } : {}),

package/lib/types/utils/clipboard.js

@@ -165,7 +165,7 @@ async function ensureImageDir() {
         return imageDir;
     let dir;
     try {
-        dir = await mkdtemp(join(tmpdir(), 'dsh-tui-paste-'));
+        dir = await mkdtemp(join(tmpdir(), 'dsh-cli-paste-'));
     }
     catch {
         return null;

package/lib/types/utils/credentials.js

@@ -6,9 +6,9 @@
  * to stored secrets. dsh resolves those refs into a session at launch, so an
  * environment-only check reports "missing" for a key that works. This module
  * only ever answers "is a ref declared": the value is never read, formatted, or
- * logged. The launcher keeps a mirror of this check in `bin/dsh-tui.js` (it is
+ * logged. The launcher keeps a mirror of this check in `bin/dsh-cli.js` (it is
  * dependency-free and cannot import `lib/`); the two must not diverge.
- * @module dsh-tui/utils/credentials
+ * @module dsh-cli/utils/credentials
  */
 import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';