@xmoon76/dsh-pi-tui 0.3.0 → 0.3.2

package/dist/startup.d.mts

@@ -5,6 +5,46 @@ import { Context } from "@deepseek-ai/cordis";
 declare const name = "tui-startup";
 /** Services required before the flags can be resolved. */
 declare const inject: string[];
+/** One incompatible dsh harness range and the guidance it deserves. Add a
+ * new entry here whenever a future bundle release stops supporting an
+ * older (or newer) harness line; entries are checked in ORDER and the
+ * first whose range covers the installed dsh version wins.
+ *
+ * Range semantics: `min` is inclusive, `max` is EXCLUSIVE. An entry with
+ * only `max` covers everything below it (the common "too old" case); an
+ * entry with only `min` covers everything at or above it ("too new" —
+ * e.g. a harness that removed a seam we still use).
+ *
+ * `since` names the bundle release line that FIRST imposed the constraint:
+ * it is shown as the fallback version label (`>= <since>`) when the
+ * bundle's own version cannot be read, so the message stays truthful.
+ */
+interface HarnessCompatEntry {
+  /** Inclusive lower bound of the incompatible range; absent = unbounded below. */
+  min?: string;
+  /** Exclusive upper bound of the incompatible range; absent = unbounded above. */
+  max?: string;
+  /** The bundle release line that first required this constraint. */
+  since: string;
+  /** Human-readable requirement, e.g. `DeepSeek Harness 0.1.1-rc.1 or later`. */
+  requires: string;
+  /** What the user must do; placeholders are NOT needed — the message
+   *  builder fills in the requirement and the installed version. */
+  guidance: string;
+}
+/** The compatibility table. */
+declare const HARNESS_COMPAT: readonly HarnessCompatEntry[];
+/** The compat entry covering the installed dsh version, or undefined when
+ * the harness is supported. */
+declare function harnessCompatEntryFor(installed: string): HarnessCompatEntry | undefined;
+/** The bundle's own version label for the gate message, read from
+ * package.json at runtime (never hardcoded). Falls back to the release
+ * line that first imposed the requirement when unreadable. */
+declare function bundleVersionLabel(since: string): string;
+/** The actionable message printed before the loader's raw failure when the
+ * installed harness falls in an incompatible range. `entry` MUST be the
+ * entry {@link harnessCompatEntryFor} matched for `installed`. */
+declare function incompatibleHarnessMessage(installed: string, entry: HarnessCompatEntry): string;
 /** Service provided by this plugin and injected by the TUI runner row. */
 declare const TUI_STARTUP_SERVICE = "tuiStartup";
 /** What the runner row reads from {@link TUI_STARTUP_SERVICE}. */
@@ -29,4 +69,4 @@ interface TuiStartupValues {
  */
 declare function apply(ctx: Context): void;
 //#endregion
-export { TUI_STARTUP_SERVICE, TuiStartupValues, apply, inject, name };
+export { HARNESS_COMPAT, HarnessCompatEntry, TUI_STARTUP_SERVICE, TuiStartupValues, apply, bundleVersionLabel, harnessCompatEntryFor, incompatibleHarnessMessage, inject, name };

package/dist/startup.mjs

@@ -1,4 +1,5 @@
-import { join } from "node:path";
+import { readFileSync, realpathSync } from "node:fs";
+import { dirname, join } from "node:path";
 import { Command } from "commander";
 import { parseCmdline } from "@deepseek-ai/dsh-cmdline";
 //#region src/startup.ts
@@ -9,10 +10,97 @@ import { parseCmdline } from "@deepseek-ai/dsh-cmdline";
 * `cmdlineArgs`, providing a service that flag-configured rows inject.
 * @module @xmoon76/dsh-pi-tui/startup
 */
+/** The installed dsh version, resolved from the launcher's real path. */
+function installedDshVersion() {
+	const bin = process.argv[1];
+	if (bin === void 0) return void 0;
+	try {
+		let dir = dirname(realpathSync(bin));
+		for (let depth = 0; depth < 8; depth += 1) {
+			try {
+				const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+				if (pkg.name === "@deepseek-ai/dsh" && typeof pkg.version === "string") return pkg.version;
+			} catch {}
+			const parent = dirname(dir);
+			if (parent === dir) return void 0;
+			dir = parent;
+		}
+	} catch {}
+}
+/** Prerelease-aware `a >= b` (semver ordering; mirrors src/dsh-version.ts). */
+function versionAtLeast(version, minimum) {
+	const parse = (value) => {
+		const [core, prerelease = ""] = value.split("-");
+		return {
+			nums: core.split(".").map(Number),
+			pre: prerelease === "" ? [] : prerelease.split(".")
+		};
+	};
+	const a = parse(version);
+	const b = parse(minimum);
+	for (let i = 0; i < 3; i += 1) {
+		const pa = a.nums[i] ?? 0;
+		const pb = b.nums[i] ?? 0;
+		if (pa !== pb) return pa > pb;
+	}
+	if (a.pre.length === 0) return true;
+	if (b.pre.length === 0) return false;
+	const length = Math.max(a.pre.length, b.pre.length);
+	for (let i = 0; i < length; i += 1) {
+		const pa = a.pre[i];
+		const pb = b.pre[i];
+		if (pa === void 0) return false;
+		if (pb === void 0) return true;
+		if (pa === pb) continue;
+		const na = Number(pa);
+		const nb = Number(pb);
+		const naNumeric = !Number.isNaN(na);
+		const nbNumeric = !Number.isNaN(nb);
+		if (naNumeric && nbNumeric) return na > nb;
+		if (naNumeric !== nbNumeric) return !naNumeric;
+		return pa > pb;
+	}
+	return true;
+}
 /** Stable Cordis plugin name. */
 const name = "tui-startup";
 /** Services required before the flags can be resolved. */
 const inject = ["cmdlineArgs"];
+/** The compatibility table. */
+const HARNESS_COMPAT = [{
+	max: "0.1.1-rc.1",
+	since: "0.3.0",
+	requires: "DeepSeek Harness 0.1.1-rc.1 or later",
+	guidance: "Upgrade dsh first, e.g.: npm install -g @deepseek-ai/dsh@0.1.1-rc.1"
+}];
+/** The compat entry covering the installed dsh version, or undefined when
+* the harness is supported. */
+function harnessCompatEntryFor(installed) {
+	return HARNESS_COMPAT.find((entry) => (entry.min === void 0 || versionAtLeast(installed, entry.min)) && (entry.max === void 0 || !versionAtLeast(installed, entry.max)));
+}
+/** The bundle's own version label for the gate message, read from
+* package.json at runtime (never hardcoded). Falls back to the release
+* line that first imposed the requirement when unreadable. */
+function bundleVersionLabel(since) {
+	try {
+		const pkg = JSON.parse(readFileSync(join(import.meta.dirname, "..", "package.json"), "utf8"));
+		return pkg.version === void 0 || pkg.version === "" ? `>= ${since}` : `v${pkg.version}`;
+	} catch {
+		return `>= ${since}`;
+	}
+}
+/** The actionable message printed before the loader's raw failure when the
+* installed harness falls in an incompatible range. `entry` MUST be the
+* entry {@link harnessCompatEntryFor} matched for `installed`. */
+function incompatibleHarnessMessage(installed, entry) {
+	return [
+		`dsh-pi-tui ${bundleVersionLabel(entry.since)} requires ${entry.requires},`,
+		`but this installation is running dsh ${installed}.`,
+		"",
+		`${entry.guidance}`,
+		"Then re-run: dsh --profile pi-tui"
+	].join("\n");
+}
 /** Service provided by this plugin and injected by the TUI runner row. */
 const TUI_STARTUP_SERVICE = "tuiStartup";
 /** This app's command: its flags, its description, and its help text. */
@@ -33,6 +121,15 @@ Examples:
 function apply(ctx) {
 	const program = tuiCommand();
 	program.action(() => {
+		const installed = installedDshVersion();
+		if (installed !== void 0) {
+			const entry = harnessCompatEntryFor(installed);
+			if (entry !== void 0) {
+				const message = incompatibleHarnessMessage(installed, entry);
+				process.stderr.write(`\n${message}\n\n`);
+				throw new Error(message);
+			}
+		}
 		const options = program.opts();
 		ctx.provide(TUI_STARTUP_SERVICE, {
 			...options.session !== void 0 ? { sessionId: options.session } : {},
@@ -43,4 +140,4 @@ function apply(ctx) {
 	parseCmdline(ctx, program);
 }
 //#endregion
-export { TUI_STARTUP_SERVICE, apply, inject, name };
+export { HARNESS_COMPAT, TUI_STARTUP_SERVICE, apply, bundleVersionLabel, harnessCompatEntryFor, incompatibleHarnessMessage, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmoon76/dsh-pi-tui",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "The dsh-pi-tui bundle: a TUI surface for DeepSeek Harness profiles (dsh --profile pi-tui)",
   "license": "MIT",
   "author": "XMoon <xmoonox@gmail.com>",

package/scripts/bench.mts

@@ -52,6 +52,12 @@ class BenchTerminal {
 }
 
 // --- synthetic session content ---------------------------------------------
+// NOTE: the CJK strings below are FUNCTIONAL benchmark fixtures, not
+// user-facing copy: the wide-grapheme samples exercise the CJK width
+// paths (get-east-asian-width, wrap + emoji) whose cost this script
+// measures. The English-only rule applies to user-facing strings and
+// comments; these samples are deliberately CJK — an English-only fixture
+// would silently drop the wide-character code path from the benchmark.
 
 const MARKDOWN_BLOCKS = [
   '## Findings\n\nThe **cache** now hits for unchanged messages, so `markdown` is not re-parsed every frame.\n\n```ts\nconst hit = cached.text === message.text\n```\n\n- one\n- two\n- three',

package/scripts/preview-prompt.mts

@@ -0,0 +1,62 @@
+/**
+ * Visual preview of the editor `❯` prompt + the transcript user-role
+ * styling — run inside a real TTY (tmux):
+ *
+ *   env -u NO_COLOR node --import tsx/esm scripts/preview-prompt.mts
+ *
+ * Shows a transcript mixing user / assistant / thinking / system rows and
+ * alternates the editor between an EMPTY draft (the `❯ ` prompt with the
+ * cursor block) and a multi-line draft (the prompt leads the first line,
+ * continuation lines indent under it, exactly like the transcript rows).
+ * `PREVIEW_HOLD_MS` controls how long it stays up (default 30s); Ctrl+C
+ * also exits.
+ * @module @xmoon76/dsh-pi-tui/preview-prompt
+ */
+
+import { ProcessTerminal } from '@xmoon76/pi-tui'
+import { TuiApp } from '../src/tui-app.ts'
+
+const holdMs = Number(process.env.PREVIEW_HOLD_MS ?? 30000)
+
+const terminal = new ProcessTerminal()
+const app = new TuiApp(terminal, {
+  onSubmit: () => {},
+  onExit: () => {
+    app.stop()
+    process.exit(0)
+  },
+})
+app.start()
+
+// Transcript contrast: the user row is a brand-blue bubble (whole-row
+// background + blue ❯), everything else (assistant / thinking / system)
+// keeps its own distinct style.
+app.setTranscript([
+  {
+    kind: 'user',
+    turn: 0,
+    // Long enough to wrap: the continuation must indent under the ❯.
+    text: 'The startup fails with ENOTFOUND near line 42 of src/app.ts — I suspect an environment variable is missing, so please check the config load order and compare it against the .env.example keys and the docs.',
+  },
+  {
+    kind: 'assistant',
+    turn: 0,
+    text: 'Let me check. **Config load order**:\n\n1. `.env` file\n2. Environment overrides\n3. Default fallbacks\n\n`ENOTFOUND` usually means DNS resolution failed — confirm whether you reach an internal registry or the public one.',
+  },
+  { kind: 'thinking', turn: 0, text: 'ENOTFOUND is a DNS issue; verify the config source before concluding.', running: false },
+  { kind: 'system', turn: 0, label: 'AGENTS.md', text: 'Repo config conventions live in docs/config.md; env keys come from the preset.', summary: 'context rules' },
+])
+
+// Alternate the draft so both the empty prompt and the multi-line prompt
+// (continuation indent) are visible without touching the keyboard.
+let draftVisible = false
+const flip = setInterval(() => {
+  draftVisible = !draftVisible
+  app.setDraft(draftVisible ? 'git status\npnpm test -- --filter @xmoon76/pi-tui' : '')
+}, 6000)
+
+setTimeout(() => {
+  clearInterval(flip)
+  app.stop()
+  process.exit(0)
+}, holdMs)

package/scripts/preview-role-styles.mts

@@ -0,0 +1,97 @@
+/**
+ * Side-by-side preview of user-role visual schemes — repo code untouched,
+ * pure display. Run in a real TTY (tmux):
+ *
+ *   env -u NO_COLOR node --import tsx/esm scripts/preview-role-styles.mts
+ *
+ * Shows the chosen scheme — background bubble with a brand-blue ❯ (dsh-web
+ * parity) — in both the dark palette and the light palette, next to the
+ * old kimi-style amber text for contrast, plus the editor-prompt colours.
+ * Ctrl+C exits.
+ * @module @xmoon76/dsh-pi-tui/preview-role-styles
+ */
+
+import { Chalk } from 'chalk'
+import {
+  ProcessTerminal, Text, TuiMainScreen, matchesKey,
+  visibleWidth, wrapTextWithAnsi, type TuiInputListenerResult,
+} from '@xmoon76/pi-tui'
+
+const chalk = new Chalk({ level: 3 })
+const dim = (s: string): string => chalk.hex('#888888')(s)
+const darkBlue = (s: string): string => chalk.bold.hex('#679EFE')(s)
+const darkBubbleBg = (s: string): string => chalk.bgHex('#2C2C2F')(s)
+const lightBlue = (s: string): string => chalk.bold.hex('#4177E6')(s)
+const lightBubbleBg = (s: string): string => chalk.bgHex('#E4EDFD')(s)
+const amber = (s: string): string => chalk.bold.hex('#FFCB6B')(s)
+const border = (s: string): string => chalk.hex('#5A5A5A')(s)
+
+const W = 100
+const MSG_ONE = 'Check the config load order — ENOTFOUND at src/app.ts:42, likely a missing env var.'
+const MSG_TWO = 'Also verify the .env.example keys against the docs, since the preset loader reads them in sequence.'
+
+/**
+ * Wrap `text` to `width - 2` cells. The first row carries the plain `❯ `
+ * marker, continuation rows indent 2 cells under it; every row is padded
+ * to the full inner width so a background paint covers the whole row.
+ */
+function wrapped(width: number, text: string): string[] {
+  const inner = Math.max(1, width - 2)
+  return wrapTextWithAnsi(text, inner).map((line, index) => {
+    const prefix = index === 0 ? '❯ ' : '  '
+    return prefix + line + ' '.repeat(Math.max(0, inner - visibleWidth(line)))
+  })
+}
+
+/** Bubble rows: full-row background, coloured ❯, body in the terminal default. */
+function bubble(width: number, text: string, bg: (s: string) => string, bullet: (s: string) => string): string[] {
+  return wrapped(width, text).map((row, index) => {
+    if (index === 0 && row.startsWith('❯ ')) {
+      return bg(bullet('❯') + ' ' + row.slice(2))
+    }
+    return bg(row)
+  })
+}
+
+/** Old kimi look: the whole row (❯ + body + padding) in one amber paint. */
+function amberRows(width: number, text: string): string[] {
+  return wrapped(width, text).map(amber)
+}
+
+const blocks: string[] = [
+  dim('dsh-pi-tui · user-role style preview (repo untouched) — Ctrl+C to exit'),
+  '',
+  dim('dark · bubble + brand-blue ❯ (chosen scheme)'),
+  ...bubble(W, MSG_ONE, darkBubbleBg, darkBlue),
+  ...bubble(W, MSG_TWO, darkBubbleBg, darkBlue),
+  '',
+  dim('light · bubble + deep brand-blue ❯ (light palette)'),
+  ...bubble(W, MSG_ONE, lightBubbleBg, lightBlue),
+  ...bubble(W, MSG_TWO, lightBubbleBg, lightBlue),
+  '',
+  dim('kimi amber text (rejected — kept for contrast)'),
+  ...amberRows(W, MSG_ONE),
+  ...amberRows(W, MSG_TWO),
+  '',
+  dim('editor prompt candidates:'),
+  border('─'.repeat(W)),
+  ` ${darkBlue('❯')} git status   ${lightBlue('❯')} git status   ${amber('❯')} git status`,
+  border('─'.repeat(W)),
+]
+
+// Pad every line to the exact width so nothing wraps.
+const preview = blocks
+  .map(line => line + ' '.repeat(Math.max(0, W - visibleWidth(line))))
+  .join('\n')
+
+const terminal = new ProcessTerminal()
+const tui = new TuiMainScreen(terminal)
+tui.addChild(new Text(preview, 0, 0))
+tui.addInputListener((data): TuiInputListenerResult => {
+  if (matchesKey(data, 'ctrl+c')) {
+    tui.stop()
+    process.exit(0)
+  }
+  return undefined
+})
+tui.start()

package/scripts/tarball-smoke.mjs

@@ -254,13 +254,17 @@ function main() {
       // legitimately inlines the TuiApp implementation (src/tui-app.d.ts)
       // for the Loader row — it is NOT a third-party SDK entry. Its region
       // is exempted; everything else (chunks, extensions, builtins) must
-      // name only the public modules below.
+      // name only the public modules below. The image modules
+      // (src/image/admission.d.ts, src/image/types.d.ts) are also
+      // legitimately inlined into the root entry: the public
+      // `commandRejectsImages` signature references `DraftImageStoreLike`,
+      // which pulls in the draft vocabulary (and the recalled-ref shape).
       const isRoot = name === 'dist/index.d.mts'
       for (const line of lines) {
         const match = /\/\/#region\s+(\S+)/.exec(line)
         if (match) {
           const regionPath = match[1]
-          const allowed = /^src\/(builtins|commands|diag|extension\/advanced|extension\/advanced-types|extension\/public-types|extension\/service|extension\/slot-map|extension\/unstable|extension\/unstable-types|extensions|index|skill-catalog|startup|surface-catalog)\.d\.ts$/.test(regionPath)
+          const allowed = /^src\/(builtins|commands|diag|extension\/advanced|extension\/advanced-types|extension\/public-types|extension\/service|extension\/slot-map|extension\/unstable|extension\/unstable-types|extensions|image\/admission|image\/types|index|skill-catalog|startup|surface-catalog)\.d\.ts$/.test(regionPath)
           const rootAllowed = isRoot && /^src\/tui-app\.d\.ts$/.test(regionPath)
           if (!allowed && !rootAllowed) dtsLeaks.push(`${name}: region ${regionPath}`)
         }