@deepseek-harness-tui/dsh-tui 0.8.7 → 0.9.0

package/lib/types/dsh-adapter/contract.d.ts

@@ -1,14 +1,18 @@
 /** Primary validated upstream line (newest). */
-export declare const UPSTREAM_VALIDATED_VERSION = "0.1.0-rc.8";
-/** Every upstream rc line the adapter has been validated against.
+export declare const UPSTREAM_VALIDATED_VERSION = "0.1.1-rc.2";
+/**
+ * Every upstream prerelease line the adapter has been validated against,
+ * oldest first.
  *
- * rc.8 = primary; rc.7 = previous line (full CI coverage); rc.6 = legacy
- * line (install- and type-level compatibility, feature surface may lack
- * rc.7/rc.8 additions — new features must degrade gracefully there).
+ * 0.1.1-rc.2 = primary; 0.1.1-rc.1 = transitional line of the same family
+ * (install- and type-level compatibility); 0.1.0-rc.8 = previous family
+ * (full CI coverage); 0.1.0-rc.7 = full CI coverage as well; 0.1.0-rc.6 =
+ * legacy line (install- and type-level compatibility, feature surface may
+ * lack later additions — new features must degrade gracefully there).
  * The peer range in package.json is deliberately wider than this list: an
- * install on an older line is allowed but reports drift at boot.
+ * install on an older or newer line is allowed but reports drift at boot.
  */
-export declare const UPSTREAM_VALIDATED_RC_LINES: readonly [6, 7, 8];
+export declare const UPSTREAM_VALIDATED_VERSIONS: readonly ["0.1.0-rc.6", "0.1.0-rc.7", "0.1.0-rc.8", "0.1.1-rc.1", "0.1.1-rc.2"];
 /**
  * Framework packages version on their own lines; the contract validates
  * their MAJOR (breaking surface), not the harness rc number.
@@ -21,23 +25,59 @@ export interface UpstreamDriftEntry {
     installed: string | undefined;
     validated: string;
 }
-/** Human-readable summary of the validated lines, e.g. `0.1.0-rc.8 (rc.6/rc.7/rc.8)`. */
+/** A parsed upstream prerelease version, e.g. `0.1.1-rc.2` → `[0, 1, 1, 2]`. */
+export type UpstreamVersionTuple = readonly [number, number, number, number];
+/** Parse an upstream prerelease version; undefined when unparseable. */
+export declare function parseUpstreamVersion(version: string | undefined): UpstreamVersionTuple | undefined;
+/** Human-readable summary of the validated lines, e.g. `0.1.1-rc.2 (0.1.0-rc.6/7/8, 0.1.1-rc.1/2)`. */
 export declare const UPSTREAM_VALIDATED_LABEL: string;
 export declare function installedUpstreamVersions(): Record<string, string | undefined>;
-/** The installed upstream rc line of one blessed package (undefined when
- *  missing or not on the 0.1.0-rc line). Feature gates compare this against
- *  the line a behavior was introduced on, so the adapter degrades on older
- *  installs instead of calling APIs they do not have. */
-export declare function installedLineOf(packageName: string): number | undefined;
-/** The distinct upstream rc lines installed across the blessed harness
- *  packages (framework packages excluded). One line = coherent install;
- *  several = a mixed tree, which the per-package drift check cannot see.
- *  Empty when nothing (or no harness package) is installed. */
-export declare function installedUpstreamLines(): number[];
+/**
+ * The installed upstream version of one blessed package, parsed; undefined
+ * when missing or not on an `x.y.z-rc.n` prerelease line. Feature gates
+ * compare this against the line a behavior was introduced on, so the
+ * adapter degrades on older installs instead of calling APIs they do not
+ * have.
+ */
+export declare function installedUpstreamVersion(packageName: string): UpstreamVersionTuple | undefined;
+/**
+ * Whether the installed version of `packageName` is at or beyond `minimum`
+ * (a literal like `'0.1.0-rc.8'`). Unparseable or older installs return
+ * false so features introduced on the minimum line degrade gracefully.
+ */
+export declare function installedMeetsVersion(packageName: string, minimum: string): boolean;
+/**
+ * The distinct installed prerelease versions across the blessed harness
+ * packages (framework packages excluded). One entry = coherent install;
+ * several = a mixed tree, which the per-package drift check cannot see.
+ * Empty when nothing (or no harness package) is installed.
+ */
+export declare function installedUpstreamLines(): string[];
 /**
  * Report every blessed package whose installed version is NOT one of the
  * validated release lines. Empty array = the running install matches the
  * contract.
  */
 export declare function upstreamDrift(): UpstreamDriftEntry[];
+/**
+ * Classification of a drifted install for the one-line boot notice:
+ * `newer` / `older` — every drifted harness package sits on a single
+ * parseable version off one end of the validated window; `mixed` — several
+ * distinct versions coexist (unstable tree); `broken` — something is
+ * missing or unparseable and wording cannot get more specific.
+ */
+export type UpstreamDriftKind = 'newer' | 'older' | 'mixed' | 'broken';
+/** Merged drift verdict consumed by the logo header notice (LogoV2). */
+export interface UpstreamDriftSummary {
+    kind: UpstreamDriftKind;
+    /** Distinct installed versions among drifted packages ('missing' for absent ones). */
+    versions: string[];
+}
+/**
+ * Collapse {@link upstreamDrift} into a single summary for the boot notice:
+ * undefined when the install matches the contract. Only harness rc packages
+ * decide newer/older/mixed; a framework-only drift (e.g. a cordis major
+ * bump) reports `broken`, since its version line is not comparable.
+ */
+export declare function upstreamDriftSummary(): UpstreamDriftSummary | undefined;
 //# sourceMappingURL=contract.d.ts.map

package/lib/types/dsh-adapter/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/contract.ts"],"names":[],"mappings":"AAgBA,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,eAAe,CAAA;AAEtD;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,oBAAqB,CAAA;AAE7D;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG5D,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,2zBA2B5B,CAAA;AAEV,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,yFAAyF;AACzF,eAAO,MAAM,wBAAwB,QAAmG,CAAA;AAYxI,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAqB9E;AAED;;;yDAGyD;AACzD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAOD;;;+DAG+D;AAC/D,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAQjD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,EAAE,CAuBpD"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/contract.ts"],"names":[],"mappings":"AAiBA,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,eAAe,CAAA;AAEtD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,iFAM9B,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG5D,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,2zBA2B5B,CAAA;AAEV,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE5E,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,oBAAoB,GAAG,SAAS,CAGlG;AA4BD,uGAAuG;AACvG,eAAO,MAAM,wBAAwB,QAA6D,CAAA;AAYlG,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAqB9E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAE9F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKnF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAQjD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,EAAE,CAuBpD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEtE,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,iBAAiB,CAAA;IACvB,sFAAsF;IACtF,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,oBAAoB,GAAG,SAAS,CAuBvE"}

package/lib/types/dsh-adapter/contract.js

@@ -1,29 +1,40 @@
 /**
  * Upstream compatibility contract.
  *
- * The TUI is validated against a set of upstream release lines — the
- * current primary (0.1.0-rc.8) plus older lines kept in backward
- * compatibility (0.1.0-rc.7, 0.1.0-rc.6). Every official package this
- * adapter touches is blessed here; anything else must go through upstream
- * channels or the adapter, never the UI.
+ * The TUI is validated against a set of upstream prerelease lines — the
+ * current primary (0.1.1-rc.2) plus older lines kept in backward
+ * compatibility across the 0.1.1 and 0.1.0 release families. Every official
+ * package this adapter touches is blessed here; anything else must go
+ * through upstream channels or the adapter, never the UI.
  *
- * `upstreamDrift()` powers both the boot-time warning (dev visibility) and
- * the CI gate (scripts/verify-upstream-contract.ts) so a mismatched
- * install fails in CI before it fails on a user's machine.
+ * `upstreamDrift()` powers the CI gate (scripts/verify-upstream-contract.ts)
+ * so a mismatched install fails in CI before it fails on a user's machine.
+ * `upstreamDriftSummary()` collapses the per-package entries into the
+ * single natural-language boot notice the logo header shows (see LogoV2).
  */
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 /** Primary validated upstream line (newest). */
-export const UPSTREAM_VALIDATED_VERSION = '0.1.0-rc.8';
-/** Every upstream rc line the adapter has been validated against.
+export const UPSTREAM_VALIDATED_VERSION = '0.1.1-rc.2';
+/**
+ * Every upstream prerelease line the adapter has been validated against,
+ * oldest first.
  *
- * rc.8 = primary; rc.7 = previous line (full CI coverage); rc.6 = legacy
- * line (install- and type-level compatibility, feature surface may lack
- * rc.7/rc.8 additions — new features must degrade gracefully there).
+ * 0.1.1-rc.2 = primary; 0.1.1-rc.1 = transitional line of the same family
+ * (install- and type-level compatibility); 0.1.0-rc.8 = previous family
+ * (full CI coverage); 0.1.0-rc.7 = full CI coverage as well; 0.1.0-rc.6 =
+ * legacy line (install- and type-level compatibility, feature surface may
+ * lack later additions — new features must degrade gracefully there).
  * The peer range in package.json is deliberately wider than this list: an
- * install on an older line is allowed but reports drift at boot.
+ * install on an older or newer line is allowed but reports drift at boot.
  */
-export const UPSTREAM_VALIDATED_RC_LINES = [6, 7, 8];
+export const UPSTREAM_VALIDATED_VERSIONS = [
+    '0.1.0-rc.6',
+    '0.1.0-rc.7',
+    '0.1.0-rc.8',
+    '0.1.1-rc.1',
+    '0.1.1-rc.2',
+];
 /**
  * Framework packages version on their own lines; the contract validates
  * their MAJOR (breaking surface), not the harness rc number.
@@ -61,8 +72,39 @@ export const UPSTREAM_BLESSED_PACKAGES = [
     '@deepseek-ai/dsh-user-approval',
     '@deepseek-ai/dsh-user-questions',
 ];
-/** Human-readable summary of the validated lines, e.g. `0.1.0-rc.8 (rc.6/rc.7/rc.8)`. */
-export const UPSTREAM_VALIDATED_LABEL = `${UPSTREAM_VALIDATED_VERSION} (${UPSTREAM_VALIDATED_RC_LINES.map((n) => `rc.${n}`).join('/')})`;
+/** Parse an upstream prerelease version; undefined when unparseable. */
+export function parseUpstreamVersion(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)-rc\.(\d+)$/u.exec(version ?? '');
+    return match === null ? undefined : [Number(match[1]), Number(match[2]), Number(match[3]), Number(match[4])];
+}
+/** Order two parsed versions: negative/positive/zero as a `<`/`>`/`=`. */
+function compareVersions(a, b) {
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] > b[i])
+            return 1;
+        if (a[i] < b[i])
+            return -1;
+    }
+    return 0;
+}
+/** Collapse {@link UPSTREAM_VALIDATED_VERSIONS} into per-release rc groups,
+ *  e.g. `0.1.0-rc.6/7/8, 0.1.1-rc.1/2`. */
+function validatedLinesLabel() {
+    const groups = [];
+    for (const version of UPSTREAM_VALIDATED_VERSIONS) {
+        const [major, minor, patch, rc] = parseUpstreamVersion(version);
+        const release = `${major}.${minor}.${patch}`;
+        let group = groups.find(candidate => candidate.release === release);
+        if (group === undefined) {
+            group = { release, rcs: [] };
+            groups.push(group);
+        }
+        group.rcs.push(rc);
+    }
+    return groups.map(({ release, rcs }) => `${release}-rc.${rcs.join('/')}`).join(', ');
+}
+/** Human-readable summary of the validated lines, e.g. `0.1.1-rc.2 (0.1.0-rc.6/7/8, 0.1.1-rc.1/2)`. */
+export const UPSTREAM_VALIDATED_LABEL = `${UPSTREAM_VALIDATED_VERSION} (${validatedLinesLabel()})`;
 function resolvePackageJson(packageName) {
     try {
         const path = import.meta.resolve(`${packageName}/package.json`);
@@ -97,31 +139,44 @@ export function installedUpstreamVersions() {
     cachedVersions = Object.freeze(result);
     return cachedVersions;
 }
-/** The installed upstream rc line of one blessed package (undefined when
- *  missing or not on the 0.1.0-rc line). Feature gates compare this against
- *  the line a behavior was introduced on, so the adapter degrades on older
- *  installs instead of calling APIs they do not have. */
-export function installedLineOf(packageName) {
-    return rcNumber(installedUpstreamVersions()[packageName]);
+/**
+ * The installed upstream version of one blessed package, parsed; undefined
+ * when missing or not on an `x.y.z-rc.n` prerelease line. Feature gates
+ * compare this against the line a behavior was introduced on, so the
+ * adapter degrades on older installs instead of calling APIs they do not
+ * have.
+ */
+export function installedUpstreamVersion(packageName) {
+    return parseUpstreamVersion(installedUpstreamVersions()[packageName]);
 }
-function rcNumber(version) {
-    const match = /^0\.1\.0-rc\.(\d+)$/u.exec(version ?? '');
-    return match === null ? undefined : Number(match[1]);
+/**
+ * Whether the installed version of `packageName` is at or beyond `minimum`
+ * (a literal like `'0.1.0-rc.8'`). Unparseable or older installs return
+ * false so features introduced on the minimum line degrade gracefully.
+ */
+export function installedMeetsVersion(packageName, minimum) {
+    const installed = installedUpstreamVersion(packageName);
+    const floor = parseUpstreamVersion(minimum);
+    if (installed === undefined || floor === undefined)
+        return false;
+    return compareVersions(installed, floor) >= 0;
 }
-/** The distinct upstream rc lines installed across the blessed harness
- *  packages (framework packages excluded). One line = coherent install;
- *  several = a mixed tree, which the per-package drift check cannot see.
- *  Empty when nothing (or no harness package) is installed. */
+/**
+ * The distinct installed prerelease versions across the blessed harness
+ * packages (framework packages excluded). One entry = coherent install;
+ * several = a mixed tree, which the per-package drift check cannot see.
+ * Empty when nothing (or no harness package) is installed.
+ */
 export function installedUpstreamLines() {
     const lines = new Set();
     for (const packageName of UPSTREAM_BLESSED_PACKAGES) {
         if (UPSTREAM_FRAMEWORK_MAJORS[packageName] !== undefined)
             continue;
-        const line = rcNumber(installedUpstreamVersions()[packageName]);
-        if (line !== undefined)
-            lines.add(line);
+        const version = installedUpstreamVersions()[packageName];
+        if (version !== undefined && parseUpstreamVersion(version) !== undefined)
+            lines.add(version);
     }
-    return [...lines].sort((a, b) => a - b);
+    return [...lines].sort((a, b) => compareVersions(parseUpstreamVersion(a), parseUpstreamVersion(b)));
 }
 /**
  * Report every blessed package whose installed version is NOT one of the
@@ -129,6 +184,7 @@ export function installedUpstreamLines() {
  * contract.
  */
 export function upstreamDrift() {
+    const validated = new Set(UPSTREAM_VALIDATED_VERSIONS);
     const drift = [];
     for (const [packageName, installed] of Object.entries(installedUpstreamVersions())) {
         const expected = UPSTREAM_BLESSED_PACKAGES.includes(packageName);
@@ -141,8 +197,7 @@ export function upstreamDrift() {
             matches = installedMajor === frameworkMajor;
         }
         else {
-            const installedLine = rcNumber(installed);
-            matches = installedLine !== undefined && UPSTREAM_VALIDATED_RC_LINES.includes(installedLine);
+            matches = installed !== undefined && validated.has(installed);
         }
         if (!matches) {
             drift.push({
@@ -154,3 +209,36 @@ export function upstreamDrift() {
     }
     return drift;
 }
+/**
+ * Collapse {@link upstreamDrift} into a single summary for the boot notice:
+ * undefined when the install matches the contract. Only harness rc packages
+ * decide newer/older/mixed; a framework-only drift (e.g. a cordis major
+ * bump) reports `broken`, since its version line is not comparable.
+ */
+export function upstreamDriftSummary() {
+    const drift = upstreamDrift();
+    if (drift.length === 0)
+        return undefined;
+    const harness = drift.filter(entry => UPSTREAM_FRAMEWORK_MAJORS[entry.package] === undefined);
+    const versions = [...new Set(drift.map(entry => entry.installed ?? 'missing'))];
+    if (harness.some(entry => entry.installed === undefined)) {
+        return { kind: 'broken', versions };
+    }
+    const harnessVersions = [...new Set(harness.map(entry => entry.installed))];
+    if (harnessVersions.length > 1) {
+        return { kind: 'mixed', versions };
+    }
+    const installed = parseUpstreamVersion(harnessVersions[0] ?? '');
+    const validated = parseUpstreamVersion(UPSTREAM_VALIDATED_VERSION);
+    if (installed === undefined) {
+        return { kind: 'broken', versions };
+    }
+    const order = compareVersions(installed, validated);
+    if (order > 0)
+        return { kind: 'newer', versions };
+    if (order < 0)
+        return { kind: 'older', versions };
+    // Identical to the primary validated version — cannot happen (it would
+    // not be drift); report broken rather than staying silent.
+    return { kind: 'broken', versions };
+}

package/lib/types/dsh-adapter/index.d.ts

@@ -9,7 +9,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import Schema from '@deepseek-ai/schemastery';
 import type { SessionModeSpec } from '../sessionModes.js';
-import { type StatusBarConfig, type ToolBackground } from '../tuiDisplayPrefs.js';
+import { type ScrollGutterMode, type StatusBarConfig, type ToolBackground } from '../tuiDisplayPrefs.js';
 export declare const name = "dsh-tui";
 export declare const inject: string[];
 /**
@@ -53,7 +53,11 @@ export interface Config {
      *  `ctx used/window` readout) in the status footer; off hides that row
      *  while the status/mode lines stay (issue #29). */
     contextBar?: boolean;
-    /** Run in the terminal's alternate screen (Claude Code fullscreen layout). */
+    /** Run in the terminal's alternate screen (Claude Code fullscreen layout).
+     *  Defaults to true — the fullscreen surface is the more complete one
+     *  (mouse, timeline rail, scrollbar gutter, selection copy), so fresh
+     *  installs start there; cordis.yml `fullscreen: false` or a /settings
+     *  toggle opts back into the inline main-screen layout. */
     fullscreen?: boolean;
     /** UI language: `en` / `zh`. When absent, the `DSH_TUI_LANG` env var wins,
      *  then the `/lang` choice persisted in `~/.dsh-tui/lang.json`, then `zh`. */
@@ -73,6 +77,10 @@ export interface Config {
     thinkingFold?: 'preview' | 'full';
     /** Tool-card background strength; defaults to no added background. */
     toolBackground?: ToolBackground;
+    /** What the fullscreen transcript's right gutter shows (settings
+     *  `dsh-tui.scrollGutter`): `timeline` turn rail (default), `scrollbar`
+     *  proportional thumb, or `hidden`. */
+    scrollGutter?: ScrollGutterMode;
     /** Status-footer field visibility and compact presentation preferences. */
     statusBar?: Partial<StatusBarConfig>;
     /** Shift+Tab session-mode cycle (array order IS the cycle order; index 0

package/lib/types/dsh-adapter/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAErG,eAAO,MAAM,IAAI,YAAY,CAAA;AAU7B,eAAO,MAAM,MAAM,UAAa,CAAA;AAEhC;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;yEAKqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;gDAC4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;gFAE4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;oCACgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;sBAIkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;4BAGwB;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;wDAEoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;kFAC8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;gCAG4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;6DAEyD;IACzD,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC;;8EAE0E;IAC1E,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACjC,sEAAsE;IACtE,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IACpC;;;yDAGqD;IACrD,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CA8ChC,CAAA;AAEF;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAsB,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE5H,eAAO,MAAM,IAAI,YAAY,CAAA;AAU7B,eAAO,MAAM,MAAM,UAAa,CAAA;AAEhC;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;yEAKqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;gDAC4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;gFAE4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;oCACgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;sBAIkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;4BAGwB;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;wDAEoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;+DAI2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;kFAC8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;gCAG4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;6DAEyD;IACzD,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC;;8EAE0E;IAC1E,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACjC,sEAAsE;IACtE,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;2CAEuC;IACvC,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IACpC;;;yDAGqD;IACrD,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CAiDhC,CAAA;AAEF;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASvE"}

package/lib/types/dsh-adapter/index.js

@@ -25,12 +25,13 @@ export const Config = Schema.object({
     activity: Schema.boolean().default(true),
     activityFrames: Schema.string().required(false),
     contextBar: Schema.boolean().default(true),
-    fullscreen: Schema.boolean().default(false),
+    fullscreen: Schema.boolean().default(true),
     lang: Schema.string().required(false),
     preset: Schema.string().required(false),
     diffLayout: Schema.union(['auto', 'split', 'unified']).default('auto'),
     thinkingFold: Schema.union(['preview', 'full']).default('preview'),
     toolBackground: Schema.union(['none', 'subtle', 'strong']).default('none'),
+    scrollGutter: Schema.union(['timeline', 'scrollbar', 'hidden']).default('timeline'),
     statusBar: Schema.object({
         compact: Schema.boolean().default(DEFAULT_STATUS_BAR.compact),
         model: Schema.boolean().default(DEFAULT_STATUS_BAR.model),
@@ -42,6 +43,8 @@ export const Config = Schema.object({
         tps: Schema.boolean().default(DEFAULT_STATUS_BAR.tps),
         gitBranch: Schema.boolean().default(DEFAULT_STATUS_BAR.gitBranch),
         sessionTitle: Schema.boolean().default(DEFAULT_STATUS_BAR.sessionTitle),
+        sessionId: Schema.boolean().default(DEFAULT_STATUS_BAR.sessionId),
+        goal: Schema.boolean().default(DEFAULT_STATUS_BAR.goal),
         mode: Schema.boolean().default(DEFAULT_STATUS_BAR.mode),
         contextBar: Schema.boolean().default(DEFAULT_STATUS_BAR.contextBar),
         activity: Schema.boolean().default(DEFAULT_STATUS_BAR.activity),
@@ -64,18 +67,12 @@ export const Config = Schema.object({
  * @returns a promise settling when the TUI teardown completes.
  */
 export async function apply(ctx, config) {
-    const { upstreamDrift, installedUpstreamLines, UPSTREAM_VALIDATED_LABEL } = await import('./contract.js');
-    for (const entry of upstreamDrift()) {
-        console.warn(`[dsh-tui] upstream drift: ${entry.package} installed=${entry.installed ?? 'missing'} ` +
-            `validated=${entry.validated} — the TUI is validated against ${UPSTREAM_VALIDATED_LABEL}; ` +
-            `upgrade or downgrade the profile when the upstream line changes.`);
-    }
-    const installedLines = installedUpstreamLines();
-    if (installedLines.length > 1) {
-        console.warn(`[dsh-tui] mixed upstream lines detected (${installedLines.map(n => `rc.${n}`).join(', ')}) — ` +
-            `blessed packages are on different rc lines; the TUI is validated against ${UPSTREAM_VALIDATED_LABEL} ` +
-            `and a coherent install is strongly recommended.`);
-    }
+    // Upstream drift is NO LONGER spammed to stderr here: per-package
+    // console.warn lines interleave with the TUI frame redraw and arrive
+    // garbled (typewriter animation repaints over them). The merged,
+    // natural-language notice now renders in the logo header under the
+    // startup tip (LogoV2 ← upstreamDriftSummary); CI keeps the hard gate
+    // via scripts/verify-upstream-contract.ts.
     const { apply: ccTuiApply } = await import('./plugin.js');
     return ccTuiApply(ctx, config);
 }

package/lib/types/dsh-adapter/plugin.d.ts

@@ -1,15 +1,6 @@
 import type { Agent } from '@deepseek-ai/dsh-agent';
 import type { Context } from '@deepseek-ai/cordis';
 import { Config } from './index.js';
-/**
- * Claude Code style interactive TUI front door for DeepSeek Harness agents.
- *
- * The plugin attaches to (or creates) one agent, renders a chat transcript
- * from the agent's session log and live `session/event` records, and submits
- * user turns through `Agent.followup`. It is a client-driver front door like
- * `dsh-jsonrpc`: the surrounding `cordis.yml` supplies the agent spine, the
- * LLM adapter, and the tool plugins.
- */
 export declare function apply(ctx: Context, config: Config): Promise<void>;
 /**
  * Distinguish a user-driven exit from a cordis context teardown (issue #12).

package/lib/types/dsh-adapter/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,wBAAwB,CAAA;AAGhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAqCnC;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA60BvE;AA6GD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,GAAG;IACjF,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB,CAcA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,KAAK,GAAG,SAAS,CAAA;IAC5B,YAAY,EAAE,KAAK,CAAA;CACpB,GAAG,OAAO,CAQV"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,wBAAwB,CAAA;AAGhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AA6DnC,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAm8BvE;AA6GD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,GAAG;IACjF,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB,CAcA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,KAAK,GAAG,SAAS,CAAA;IAC5B,YAAY,EAAE,KAAK,CAAA;CACpB,GAAG,OAAO,CAQV"}