@xmoon76/dsh-pi-tui 0.3.0 → 0.3.1

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.1",
   "description": "The dsh-pi-tui bundle: a TUI surface for DeepSeek Harness profiles (dsh --profile pi-tui)",
   "license": "MIT",
   "author": "XMoon <xmoonox@gmail.com>",