dsh-code 1.0.7 → 1.2.0

package/lib/types/theme.d.ts

@@ -4,26 +4,40 @@
  * (`packages/client/ui-theme/src/styles/design-platform.css`). Truecolor RGB
  * rides chalk, which degrades automatically on terminals without truecolor.
  *
- * Two palettes — `dark` (the default) and `light` — share the same token keys
- * with different values. Painters and the palette accessor read the ACTIVE
+ * Three palettes — `dark` (the default), `light`, and `prismatic` (the
+ * neon synthwave skin) — share the same token keys with different values.
+ * Painters and the palette accessor read the ACTIVE
  * palette selected through {@link setTheme}, so a theme switch recolors every
- * painted surface on the next render without touching call sites. Raw token
- * consumers keep reading {@link TUI_RGB} (the dark values) until the
- * theme-aware integration replaces those call sites with
- * `inkColor(getPalette().token)`.
+ * painted surface on the next render without touching call sites; consumers
+ * read colors through {@link getPalette} or the painters below only.
  *
  * @module @deepseek-ai/dsh-tui/theme
  */
 /** One RGB triple for a palette token. */
 export type RgbTriple = readonly [number, number, number];
 /** Palette token keys shared by every theme. */
-export type ThemeToken = 'brand' | 'brandBright' | 'brandMid' | 'brandDeep' | 'dim' | 'success' | 'error' | 'warn' | 'text' | 'code' | 'composerBand';
+export type ThemeToken = 'brand' | 'brandBright' | 'brandMid' | 'brandDeep' | 'dim' | 'success' | 'error' | 'warn' | 'text' | 'code' | 'composerBand' | 'diffAdd' | 'diffDel' | 'diffAddFg' | 'diffDelFg' | 'surface' | 'prompt' | 'queued' | 'steered';
 /** One full color palette: every token key mapped to an RGB triple. */
 export type ThemePalette = Readonly<Record<ThemeToken, RgbTriple>>;
-/** Selectable theme names: dark, light, or auto (terminal-sensed). */
-export type ThemeName = 'dark' | 'light' | 'auto';
+/** Selectable theme names: dark, light, prismatic, rainbow, or auto (terminal-sensed). */
+export type ThemeName = 'dark' | 'light' | 'prismatic' | 'rainbow' | 'auto';
 /** Valid theme names in canonical picker order. */
 export declare const THEME_NAMES: readonly ThemeName[];
+/** One /theme picker row: the theme id plus its display copy. */
+export interface ThemeDescriptor {
+    /** The selectable theme name. */
+    readonly id: ThemeName;
+    /** Short row label shown in the picker. */
+    readonly label: string;
+    /** One-line description shown after the label. */
+    readonly description: string;
+}
+/**
+ * Every theme's picker metadata in canonical order — the single source the
+ * /theme panel rows derive from; {@link THEME_NAMES} stays the validation
+ * list. Adding a theme means adding its palette plus one row here.
+ */
+export declare const THEMES: readonly ThemeDescriptor[];
 /**
  * DeepSeek dark palette: the original TUI colors, one entry per
  * design-platform token in use. Keep names and values in sync with the CSS
@@ -52,15 +66,34 @@ export declare const DARK_PALETTE: {
     readonly code: readonly [125, 211, 252];
     /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
     readonly composerBand: readonly [46, 48, 52];
+    /** Diff added-line background — Codex's muted dark green tint (#213A2B). */
+    readonly diffAdd: readonly [33, 58, 43];
+    /** Diff removed-line background — Codex's muted dark red tint (#4A221D). */
+    readonly diffDel: readonly [74, 34, 29];
+    /** Diff added-line foreground — green-500, 5.4:1 on the diffAdd tint. */
+    readonly diffAddFg: readonly [34, 197, 94];
+    /** Diff removed-line foreground — red-400, 4.9:1 on the diffDel tint (error's red-500 sinks to 3.6:1 on it). */
+    readonly diffDelFg: readonly [248, 113, 113];
+    /** Terminal background this palette is designed against; row tints blend toward it. */
+    readonly surface: readonly [0, 0, 0];
+    /**
+     * The three prompt-row colors, one per delivery kind. They are the palette's
+     * own accents (bright brand, warning amber, violet) rather than fixed RGBs,
+     * and every row's bar is these colors laid over {@link surface}.
+     */
+    readonly prompt: readonly [103, 158, 254];
+    readonly queued: readonly [245, 158, 11];
+    readonly steered: readonly [167, 139, 250];
 };
 /**
  * Light palette tuned for white terminals: the same token keys as dark with
  * contrast-driven values (AA on a white background). Brand keeps its dark
- * value (≈4.9:1); the bright/mid/deep blues, muted grays, and status colors
- * deepen so they stay legible on bright backgrounds.
+ * value (≈4.2:1 on white — reserved for bold/accent spans; body-size brand
+ * text uses brandBright at ≈5.4:1); the bright/mid/deep blues, muted grays,
+ * and status colors deepen so they stay legible on bright backgrounds.
  */
 export declare const LIGHT_PALETTE: {
-    /** Primary brand blue — unchanged, ≈4.9:1 AA on white. */
+    /** Primary brand blue — unchanged design-platform value; ≈4.2:1 on white, so bold/accent spans only (body-size brand text uses brandBright). */
     readonly brand: readonly [65, 118, 230];
     /** Brighter brand blue deepened for white backgrounds (was 2.7:1). */
     readonly brandBright: readonly [72, 104, 178];
@@ -82,8 +115,77 @@ export declare const LIGHT_PALETTE: {
     readonly code: readonly [14, 116, 144];
     /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
     readonly composerBand: readonly [229, 231, 235];
+    /** Diff added-line background — GitHub's pastel green (#dafbe1), Codex's light pick. */
+    readonly diffAdd: readonly [218, 251, 225];
+    /** Diff removed-line background — GitHub's pastel red (#ffebe9), Codex's light pick. */
+    readonly diffDel: readonly [255, 235, 233];
+    /** Diff added-line foreground — green-800, 6.4:1 on the pastel tint (green-700 clears 4.5:1 by a hair). */
+    readonly diffAddFg: readonly [22, 101, 52];
+    /** Diff removed-line foreground — red-700, 5.6:1 on the pastel tint (error's red-600 is 3.9:1). */
+    readonly diffDelFg: readonly [185, 28, 28];
+    /** Terminal background this palette is designed against; row tints blend toward it. */
+    readonly surface: readonly [255, 255, 255];
+    /**
+     * Prompt-row colors deepened for white: the amber and violet the dark theme
+     * uses sit at the AA edge on their own pastel bars, so each kind carries a
+     * value that clears 4.5:1 both on the bar and on plain white.
+     */
+    readonly prompt: readonly [47, 76, 143];
+    readonly queued: readonly [124, 53, 10];
+    readonly steered: readonly [109, 40, 217];
+};
+/**
+ * Prismatic palette — the neon synthwave skin (docs/prismatic-theme-design.md):
+ * electric violet replaces the brand blues, neon fuchsia carries live
+ * emphasis, neon cyan paints code, and a lavender gray dims captions. Paints
+ * on a black terminal; every value meets the same WCAG thresholds as the
+ * other palettes (body tokens ≥4.5:1, accents ≥3:1 on pure black). Semantic
+ * colors — success/error/warn and the four diff tokens — reuse the dark
+ * values verbatim so green still means added and red still means removed.
+ */
+export declare const PRISMATIC_PALETTE: {
+    /** Primary electric purple — violet-500 (#8B5CF6), 5.0:1 on black. */
+    readonly brand: readonly [139, 92, 246];
+    /** Live/streaming emphasis — neon fuchsia-300 (#F0ABFC), 11.9:1 on black. */
+    readonly brandBright: readonly [240, 171, 252];
+    /** Intermediate violet — violet-400 (#A78BFA), 7.7:1 on black. */
+    readonly brandMid: readonly [167, 139, 250];
+    /** Deep secondary chrome — violet-600 (#7C3AED), 3.7:1 on black (violet-700 misses 3:1). */
+    readonly brandDeep: readonly [124, 58, 237];
+    /** Muted captions — lavender gray (#A6A3B8), 8.6:1 on black. */
+    readonly dim: readonly [166, 163, 184];
+    /** Success green — unchanged from dark. */
+    readonly success: readonly [34, 197, 94];
+    /** Error red — unchanged from dark. */
+    readonly error: readonly [239, 68, 68];
+    /** Warning amber — unchanged from dark. */
+    readonly warn: readonly [245, 158, 11];
+    /** Default foreground text — white with a lavender cast (#F0EEF9). */
+    readonly text: readonly [240, 238, 249];
+    /** Inline/fenced code — neon cyan-300 (#67E8F9), 14.5:1 on black. */
+    readonly code: readonly [103, 232, 249];
+    /** Composer three-row band base — neutral dark gray, hue-free so wave tints read on it. */
+    readonly composerBand: readonly [46, 46, 52];
+    /** Diff added-line background — unchanged from dark. */
+    readonly diffAdd: readonly [33, 58, 43];
+    /** Diff removed-line background — unchanged from dark. */
+    readonly diffDel: readonly [74, 34, 29];
+    /** Diff added-line foreground — unchanged from dark. */
+    readonly diffAddFg: readonly [34, 197, 94];
+    /** Diff removed-line foreground — unchanged from dark. */
+    readonly diffDelFg: readonly [248, 113, 113];
+    /** Terminal background this palette is designed against; row tints blend toward it. */
+    readonly surface: readonly [0, 0, 0];
+    /** Prompt rows in the skin's own neon: fuchsia, amber, cyan. */
+    readonly prompt: readonly [240, 171, 252];
+    readonly queued: readonly [245, 158, 11];
+    readonly steered: readonly [103, 232, 249];
 };
-/** Every palette by theme name; auto resolves through {@link resolveTheme}. */
+/**
+ * Every STATIC palette by theme name; auto resolves through {@link resolveTheme}
+ * and rainbow is rolled per launch ({@link rainbowRoll}), so neither lives
+ * here — {@link setTheme} resolves both through the same key space.
+ */
 export declare const PALETTES: {
     readonly dark: {
         /** Primary brand blue — `--dsw-static-deepseek-500`. */
@@ -108,9 +210,27 @@ export declare const PALETTES: {
         readonly code: readonly [125, 211, 252];
         /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
         readonly composerBand: readonly [46, 48, 52];
+        /** Diff added-line background — Codex's muted dark green tint (#213A2B). */
+        readonly diffAdd: readonly [33, 58, 43];
+        /** Diff removed-line background — Codex's muted dark red tint (#4A221D). */
+        readonly diffDel: readonly [74, 34, 29];
+        /** Diff added-line foreground — green-500, 5.4:1 on the diffAdd tint. */
+        readonly diffAddFg: readonly [34, 197, 94];
+        /** Diff removed-line foreground — red-400, 4.9:1 on the diffDel tint (error's red-500 sinks to 3.6:1 on it). */
+        readonly diffDelFg: readonly [248, 113, 113];
+        /** Terminal background this palette is designed against; row tints blend toward it. */
+        readonly surface: readonly [0, 0, 0];
+        /**
+         * The three prompt-row colors, one per delivery kind. They are the palette's
+         * own accents (bright brand, warning amber, violet) rather than fixed RGBs,
+         * and every row's bar is these colors laid over {@link surface}.
+         */
+        readonly prompt: readonly [103, 158, 254];
+        readonly queued: readonly [245, 158, 11];
+        readonly steered: readonly [167, 139, 250];
     };
     readonly light: {
-        /** Primary brand blue — unchanged, ≈4.9:1 AA on white. */
+        /** Primary brand blue — unchanged design-platform value; ≈4.2:1 on white, so bold/accent spans only (body-size brand text uses brandBright). */
         readonly brand: readonly [65, 118, 230];
         /** Brighter brand blue deepened for white backgrounds (was 2.7:1). */
         readonly brandBright: readonly [72, 104, 178];
@@ -132,49 +252,73 @@ export declare const PALETTES: {
         readonly code: readonly [14, 116, 144];
         /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
         readonly composerBand: readonly [229, 231, 235];
+        /** Diff added-line background — GitHub's pastel green (#dafbe1), Codex's light pick. */
+        readonly diffAdd: readonly [218, 251, 225];
+        /** Diff removed-line background — GitHub's pastel red (#ffebe9), Codex's light pick. */
+        readonly diffDel: readonly [255, 235, 233];
+        /** Diff added-line foreground — green-800, 6.4:1 on the pastel tint (green-700 clears 4.5:1 by a hair). */
+        readonly diffAddFg: readonly [22, 101, 52];
+        /** Diff removed-line foreground — red-700, 5.6:1 on the pastel tint (error's red-600 is 3.9:1). */
+        readonly diffDelFg: readonly [185, 28, 28];
+        /** Terminal background this palette is designed against; row tints blend toward it. */
+        readonly surface: readonly [255, 255, 255];
+        /**
+         * Prompt-row colors deepened for white: the amber and violet the dark theme
+         * uses sit at the AA edge on their own pastel bars, so each kind carries a
+         * value that clears 4.5:1 both on the bar and on plain white.
+         */
+        readonly prompt: readonly [47, 76, 143];
+        readonly queued: readonly [124, 53, 10];
+        readonly steered: readonly [109, 40, 217];
+    };
+    readonly prismatic: {
+        /** Primary electric purple — violet-500 (#8B5CF6), 5.0:1 on black. */
+        readonly brand: readonly [139, 92, 246];
+        /** Live/streaming emphasis — neon fuchsia-300 (#F0ABFC), 11.9:1 on black. */
+        readonly brandBright: readonly [240, 171, 252];
+        /** Intermediate violet — violet-400 (#A78BFA), 7.7:1 on black. */
+        readonly brandMid: readonly [167, 139, 250];
+        /** Deep secondary chrome — violet-600 (#7C3AED), 3.7:1 on black (violet-700 misses 3:1). */
+        readonly brandDeep: readonly [124, 58, 237];
+        /** Muted captions — lavender gray (#A6A3B8), 8.6:1 on black. */
+        readonly dim: readonly [166, 163, 184];
+        /** Success green — unchanged from dark. */
+        readonly success: readonly [34, 197, 94];
+        /** Error red — unchanged from dark. */
+        readonly error: readonly [239, 68, 68];
+        /** Warning amber — unchanged from dark. */
+        readonly warn: readonly [245, 158, 11];
+        /** Default foreground text — white with a lavender cast (#F0EEF9). */
+        readonly text: readonly [240, 238, 249];
+        /** Inline/fenced code — neon cyan-300 (#67E8F9), 14.5:1 on black. */
+        readonly code: readonly [103, 232, 249];
+        /** Composer three-row band base — neutral dark gray, hue-free so wave tints read on it. */
+        readonly composerBand: readonly [46, 46, 52];
+        /** Diff added-line background — unchanged from dark. */
+        readonly diffAdd: readonly [33, 58, 43];
+        /** Diff removed-line background — unchanged from dark. */
+        readonly diffDel: readonly [74, 34, 29];
+        /** Diff added-line foreground — unchanged from dark. */
+        readonly diffAddFg: readonly [34, 197, 94];
+        /** Diff removed-line foreground — unchanged from dark. */
+        readonly diffDelFg: readonly [248, 113, 113];
+        /** Terminal background this palette is designed against; row tints blend toward it. */
+        readonly surface: readonly [0, 0, 0];
+        /** Prompt rows in the skin's own neon: fuchsia, amber, cyan. */
+        readonly prompt: readonly [240, 171, 252];
+        readonly queued: readonly [245, 158, 11];
+        readonly steered: readonly [103, 232, 249];
     };
-};
-/**
- * The dark palette under its original name: call sites that predate the
- * two-palette switch keep compiling and painting identically (the default
- * theme IS dark). New code should read the active palette through
- * {@link getPalette} so a theme switch reaches it.
- *
- * @deprecated Read the active palette through {@link getPalette}; this
- * compatibility alias is removed in the next minor release.
- */
-export declare const TUI_RGB: {
-    /** Primary brand blue — `--dsw-static-deepseek-500`. */
-    readonly brand: readonly [65, 118, 230];
-    /** Brighter brand blue for live/streaming emphasis — `--dsw-static-deepseek-400`. */
-    readonly brandBright: readonly [103, 158, 254];
-    /** Intermediate brand blue between brand and brandBright — `--dsw-static-deepseek-450`. */
-    readonly brandMid: readonly [86, 134, 254];
-    /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-600`. */
-    readonly brandDeep: readonly [72, 104, 178];
-    /** Muted caption gray — `--dsw-static-neutral-bluish-600`. */
-    readonly dim: readonly [129, 133, 140];
-    /** Success green — `--dsw-static-green-500`. */
-    readonly success: readonly [34, 197, 94];
-    /** Error red — `--dsw-static-red-500`. */
-    readonly error: readonly [239, 68, 68];
-    /** Warning amber — `--dsw-static-amber-500`. */
-    readonly warn: readonly [245, 158, 11];
-    /** Default foreground text — `--dsw-static-neutral-50`. */
-    readonly text: readonly [236, 240, 246];
-    /** Inline/fenced code — soft sky blue, distinct from brand accents. */
-    readonly code: readonly [125, 211, 252];
-    /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
-    readonly composerBand: readonly [46, 48, 52];
 };
 /**
  * Resolve a theme name to the palette actually in use. `auto` detection
  * (OSC 11 terminal background query) is a later enhancement; until it lands,
- * auto falls back to the dark palette.
+ * auto falls back to the dark palette (prismatic and rainbow are always
+ * explicit choices, never auto-resolved).
  * @param name - the requested theme name.
- * @returns 'dark' or 'light' — the palette key to paint with.
+ * @returns 'dark', 'light', 'prismatic', or 'rainbow' — the palette key.
  */
-export declare function resolveTheme(name: ThemeName): 'dark' | 'light';
+export declare function resolveTheme(name: ThemeName): 'dark' | 'light' | 'prismatic' | 'rainbow';
 /**
  * Switch the active theme: painters and {@link getPalette} reflect the new
  * palette from the next render onward. The default is dark, so a process
@@ -191,14 +335,89 @@ export declare function getTheme(): ThemeName;
 /** The palette in force; theme-aware call sites read colors through it. */
 export declare function getPalette(): ThemePalette;
 /**
- * Parse a persisted theme name: only 'light' and 'auto' survive; anything
- * else (missing, corrupt, or unknown) falls back to the dark default.
+ * Parse a persisted theme name: only names in {@link THEME_NAMES} survive;
+ * anything else (missing, corrupt, or unknown) falls back to the dark default.
  * @param value - the raw parsed JSON value (expected string).
  * @returns a valid theme name.
  */
 export declare function parseThemeName(value: unknown): ThemeName;
 /** Ink `color` string for one RGB triple. */
 export declare function inkColor(triple: RgbTriple): string;
+/**
+ * Diff-line background as an Ink `backgroundColor` string, theme-aware and
+ * depth-gated (the Codex diff renderer's rule): 16-color terminals paint
+ * backgrounds from the saturated system palette, which drowns the text, so
+ * they keep the foreground-only look; 256-color and truecolor terminals get
+ * the palette's tint (chalk quantizes the RGB form down automatically).
+ * @param token - which diff background, added or removed lines.
+ * @returns the Ink background color, or undefined to paint foreground-only.
+ */
+export declare function diffBackground(token: 'diffAdd' | 'diffDel'): string | undefined;
+/** One prompt-row color: the palette token whose color paints the row. */
+export interface PromptRowTokens {
+    readonly fg: 'prompt' | 'queued' | 'steered';
+}
+/**
+ * The color family one prompt row wears, chosen by how it was delivered: the
+ * ordinary brand accent, the warning amber for a queued prompt, and the
+ * palette's own third accent for a steered one. The bar behind it is derived
+ * from that same color, so every theme — including a freshly rolled rainbow —
+ * carries its own look instead of a fixed triple.
+ * @param delivery - how the prompt was delivered; undefined is an ordinary one.
+ * @returns the palette token whose color paints the row.
+ */
+export declare function promptRowTokens(delivery: 'queued' | 'steered' | undefined): PromptRowTokens;
+/**
+ * Blended prompt-row background for one row color: the palette color laid
+ * over the surface the palette is designed for (dark themes over black, light
+ * over white), depth-gated exactly like {@link diffBackground} — a 16-color
+ * terminal keeps the foreground-only look rather than painting a saturated
+ * system background behind the text.
+ * @param color - the row's palette token.
+ * @returns the Ink background color, or undefined to paint foreground-only.
+ */
+export declare function rowBackground(color: PromptRowTokens['fg']): string | undefined;
+/**
+ * The prismatic surface ring: four neon accents panels cycle through by
+ * mount order (cyan → fuchsia → violet → lime), all ≥3:1 on black. Dark and
+ * light ignore the ring — {@link surfaceAccent} falls back to the passed-in
+ * base color so those themes stay pixel-identical.
+ */
+export declare const ACCENT_RING: readonly RgbTriple[];
+/**
+ * The prismatic flow anchors: brand violet → neon fuchsia → neon cyan. All
+ * three clear 4.5:1 on black, so a flowing foreground stays AA throughout
+ * the oscillation (render/animations.ts walks the triangle).
+ */
+export declare const FLOW_ANCHORS: readonly RgbTriple[];
+/**
+ * Whether the active theme is prismatic (the neon skin with surface rings
+ * and flowing accents).
+ */
+export declare function isPrismatic(): boolean;
+/** Whether the active theme is rainbow (the per-launch carnival roll). */
+export declare function isRainbow(): boolean;
+/** The active theme's flow walk, if it has one (anchors plus phase offset). */
+export interface ThemeFlow {
+    /** Anchor colors walked in order over one 2.4s lap. */
+    readonly anchors: readonly RgbTriple[];
+    /** Phase offset into the lap, milliseconds (0 for prismatic). */
+    readonly phaseMs: number;
+}
+/**
+ * The flowing theme's anchor walk: prismatic rides the fixed violet→fuchsia→
+ * cyan triangle; rainbow rides its rolled full-spectrum anchors with a random
+ * phase; dark and light have no flow (undefined) and keep static accents.
+ */
+export declare function themeFlow(): ThemeFlow | undefined;
+/**
+ * The accent for one surface slot: prismatic rotates the {@link ACCENT_RING}
+ * by slot index; every other theme gets the caller's base color back.
+ * @param index - the slot's position in the mount-order sequence.
+ * @param base - the color to use outside prismatic (the surface's usual one).
+ * @returns the accent to paint the surface's border/title with.
+ */
+export declare function surfaceAccent(index: number, base: RgbTriple): RgbTriple;
 /** Paint with the primary brand blue: whale, wordmark, tool names, accents. */
 export declare function brand(text: string): string;
 /** Paint with the bright brand blue: streaming output and active spinners. */

package/lib/types/update-panel.d.ts

@@ -30,7 +30,7 @@ export declare function updatePlanView(status: LauncherUpdateStatus): UpdatePlan
 /** Panel lifecycle phases; the footer names the keys each phase accepts. */
 export type UpdatePhase = 'probe' | 'error' | 'plan' | 'apply' | 'done';
 /** Footer hint line per phase; the plan phase names the confirm key only when runnable. */
-export declare function updateFooter(phase: UpdatePhase, runnable: boolean, upToDate: boolean): string;
+export declare function updateFooter(phase: UpdatePhase, runnable: boolean, upToDate: boolean, aheadOfRegistry?: boolean): string;
 /**
  * The /update surface: probe on open (and on r), confirm with enter/y,
  * stream the aligned apply, and land on a bounded result view. Escape is
@@ -39,11 +39,11 @@ export declare function updateFooter(phase: UpdatePhase, runnable: boolean, upTo
  */
 export declare function UpdatePanel({ probe, apply, close, notify }: {
     /** Read-only probe of the launcher update status (never installs). */
-    probe(): Promise<LauncherUpdateStatus>;
+    probe: () => Promise<LauncherUpdateStatus>;
     /** Run the aligned update; streams sanitized progress lines. */
-    apply(onLine: (line: string) => void): Promise<number>;
+    apply: (onLine: (line: string) => void, plan: LauncherUpdateStatus['plan']) => Promise<number>;
     /** Close the panel (App keeps ownership of the flag). */
-    close(): void;
+    close: () => void;
     /** One bounded cross-surface notice (phase completions). */
-    notify(text: string, tone?: 'info' | 'warning' | 'error'): void;
+    notify: (text: string, tone?: 'info' | 'warning' | 'error') => void;
 }): ReactElement;

package/lib/types/update.d.ts

@@ -37,6 +37,14 @@ export interface LauncherUpdateStatus {
         readonly localCheckout: readonly string[] | null;
     };
     readonly upToDate: boolean;
+    /** True when this install is newer than npm latest (apply would downgrade). */
+    readonly aheadOfRegistry?: boolean;
+}
+/** Exact specs the TUI confirmed; apply must install these, not re-query latest. */
+export interface LauncherUpdatePlan {
+    readonly dshSpec: string;
+    readonly codeSpec: string;
+    readonly pluginSpecs: readonly string[];
 }
 /** The launcher entrypoint that ships beside this bundle (lib/../bin). */
 export declare function launcherUpdateCommand(args: readonly string[], moduleUrl?: string): {
@@ -63,4 +71,5 @@ export declare function probeLauncherUpdate(spawnProcess?: SpawnLike): Promise<L
  * exit code (0 success); rejects only when the process could not start.
  * No timeout: an npm install may legitimately take minutes.
  */
-export declare function applyLauncherUpdate(onLine: (line: string) => void, spawnProcess?: SpawnLike): Promise<number>;
+export declare function applyPlanArgs(plan: LauncherUpdatePlan): string[];
+export declare function applyLauncherUpdate(onLine: (line: string) => void, spawnProcess?: SpawnLike, plan?: LauncherUpdatePlan): Promise<number>;

package/lib/types/version.d.ts

@@ -3,9 +3,10 @@
 export declare const DSH_CODE_VERSION: string;
 /**
  * Resolve the running dsh CLI host's version from its entry file
- * (`process.argv[1]`, e.g. `.../@deepseek-ai/dsh/lib/bin.js`). Only a manifest
- * literally named `@deepseek-ai/dsh` counts, so an unrelated entry (vitest, a
- * plain node script) resolves to undefined instead of faking a kernel version.
+ * (`process.argv[1]`, e.g. `.../@deepseek-ai/dsh/lib/bin.js` or a PATH
+ * symlink `.../bin/dsh` → that file). Only a manifest literally named
+ * `@deepseek-ai/dsh` counts, so an unrelated entry (vitest, a plain node
+ * script) resolves to undefined instead of faking a kernel version.
  */
 export declare function resolveDshHostVersion(entry?: string | undefined): string | undefined;
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-code",
   "description": "DeepSeek Harness CLI core bundle: interactive coding terminal, durable sessions, and model management for dsh --profile cli",
-  "version": "1.0.7",
+  "version": "1.2.0",
   "type": "module",
   "bin": {
     "deepseek": "./bin/deepseek.mjs",
@@ -58,18 +58,24 @@
   "scripts": {
     "build": "tsdown && tsc -p tsconfig.json",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:tests": "tsc -p tsconfig.test.json --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "verify": "pnpm lint && pnpm typecheck && pnpm typecheck:tests && pnpm test",
     "gen:whale": "tsx scripts/gen-whale-glyph.ts",
     "prepare": "pnpm build",
-    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build"
+    "prepublishOnly": "pnpm typecheck && pnpm typecheck:tests && pnpm test && pnpm build"
   },
   "engines": {
     "node": "^22.19 || >=24"
   },
   "dependencies": {
     "@deepseek-ai/dsh-authorization": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-web-fetch-http": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-tool-session-query": "0.1.5-rc.2",
     "@deepseek-ai/dsh-util-values": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-web-fetch-http": "0.1.5-rc.2",
     "@deepseek-ai/schemastery": "^3.18.2",
     "chalk": "^5.6.2",
     "commander": "^15.0.0",
@@ -107,6 +113,7 @@
     "@deepseek-ai/dsh-session": "0.1.5-rc.2",
     "@deepseek-ai/dsh-session-persistence": "0.1.5-rc.2",
     "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.1.5-rc.2",
     "@deepseek-ai/dsh-session-query": "0.1.5-rc.2",
     "@deepseek-ai/dsh-session-query-sqlite": "0.1.5-rc.2",
     "@deepseek-ai/dsh-session-reference": "0.1.5-rc.2",
@@ -117,8 +124,8 @@
     "@deepseek-ai/dsh-terminal-bash": "0.1.5-rc.2",
     "@deepseek-ai/dsh-time-context": "0.1.5-rc.2",
     "@deepseek-ai/dsh-tmux-context": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-token-meter": "0.1.5-rc.2",
     "@deepseek-ai/dsh-tool-lsp": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-tool-session-query": "0.1.5-rc.2",
     "@deepseek-ai/dsh-tool-terminal": "0.1.5-rc.2",
     "@deepseek-ai/dsh-user-approval": "0.1.5-rc.2",
     "@deepseek-ai/dsh-user-questions": "0.1.5-rc.2"
@@ -214,6 +221,9 @@
     "@deepseek-ai/dsh-session-persistence-jsonl": {
       "optional": true
     },
+    "@deepseek-ai/dsh-session-projection": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-session-query": {
       "optional": true
     },
@@ -244,10 +254,10 @@
     "@deepseek-ai/dsh-tmux-context": {
       "optional": true
     },
-    "@deepseek-ai/dsh-tool-lsp": {
+    "@deepseek-ai/dsh-token-meter": {
       "optional": true
     },
-    "@deepseek-ai/dsh-tool-session-query": {
+    "@deepseek-ai/dsh-tool-lsp": {
       "optional": true
     },
     "@deepseek-ai/dsh-tool-terminal": {
@@ -280,6 +290,7 @@
     "@deepseek-ai/dsh-schedule": "0.1.5-rc.2",
     "@deepseek-ai/dsh-session-persistence": "0.1.5-rc.2",
     "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.1.5-rc.2",
     "@deepseek-ai/dsh-session-query": "0.1.5-rc.2",
     "@deepseek-ai/dsh-session-query-sqlite": "0.1.5-rc.2",
     "@deepseek-ai/dsh-session-reference": "0.1.5-rc.2",
@@ -291,17 +302,23 @@
     "@deepseek-ai/dsh-terminal-bash": "0.1.5-rc.2",
     "@deepseek-ai/dsh-time-context": "0.1.5-rc.2",
     "@deepseek-ai/dsh-tmux-context": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-token-meter": "0.1.5-rc.2",
     "@deepseek-ai/dsh-tool-lsp": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-tool-session-query": "0.1.5-rc.2",
     "@deepseek-ai/dsh-tool-terminal": "0.1.5-rc.2",
     "@deepseek-ai/dsh-tool-todo": "0.1.5-rc.2",
     "@deepseek-ai/dsh-user-approval": "0.1.5-rc.2",
     "@deepseek-ai/dsh-user-questions": "0.1.5-rc.2",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.0.0",
     "@types/react": "~18.3.1",
+    "@vitest/coverage-v8": "^3.2.7",
+    "eslint": "^10.10.0",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "js-yaml": "^4.3.1",
     "tsdown": "^0.22.2",
     "tsx": "^4.22.4",
     "typescript": "^5.9.0",
+    "typescript-eslint": "^8.70.0",
     "vitest": "^3.0.0"
   }
 }