dsh-any-background 0.3.0 → 0.3.1

package/lib/index.js

@@ -1,8 +1,226 @@
 import { access, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
 import { createReadStream, createWriteStream } from "node:fs";
-import { basename, dirname, join } from "node:path";
 import { Readable } from "node:stream";
 import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
+import { basename, dirname, join } from "node:path";
+//#region src/host-compat/channel.ts
+/** What this plugin supports, in upgrade order. One row = one build whose facts
+*  were checked; several rows may share a `channel` when a newer build was
+*  verified as needing no change to that folder's adapter (as `0.1.7-rc.1` was) —
+*  a row then reports `exact` instead of `line`, and no new folder appears.
+*  Adding an ADAPTER means adding a channel plus a folder in
+*  `client/host-compat/versions/`. */
+const SUPPORTED_RELEASES = [
+	{
+		channel: "0.1.5-rc",
+		release: "0.1.5-rc.2"
+	},
+	{
+		channel: "0.1.6-alpha",
+		release: "0.1.6-alpha.2"
+	},
+	{
+		channel: "0.1.7-alpha",
+		release: "0.1.7-alpha.2"
+	},
+	{
+		channel: "0.1.7-alpha",
+		release: "0.1.7-rc.1"
+	}
+];
+const UNKNOWN_HOST_INFO = {
+	version: null,
+	channel: "unknown"
+};
+/** True when a string looks like a release version. A bare `~/.dsh` directory
+*  basename does not, which is why the disk probe sanity-checks before trusting
+*  a path segment. */
+const VERSION_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
+function looksLikeVersion(value) {
+	return VERSION_RE.test(value);
+}
+const PARSE_RE = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/;
+function parse(version) {
+	const m = PARSE_RE.exec(version);
+	if (m === null) return null;
+	const parts = m[4] === void 0 ? [] : m[4].split(".");
+	const build = parts.length > 1 ? Number(parts[1]) : NaN;
+	return {
+		core: [
+			Number(m[1]),
+			Number(m[2]),
+			Number(m[3])
+		],
+		channel: parts.length > 0 ? parts[0] : null,
+		build: Number.isFinite(build) ? build : null
+	};
+}
+/** The table, parsed once: every row is a literal this file controls. */
+const TABLE = SUPPORTED_RELEASES.map((row) => ({
+	...row,
+	parsed: parse(row.release)
+}));
+function cmpCore(a, b) {
+	for (let i = 0; i < 3; i++) if (a[i] !== b[i]) return a[i] < b[i] ? -1 : 1;
+	return 0;
+}
+/** Total order over releases, following the semver rule that a prerelease sorts
+*  BELOW the release it precedes (`0.1.6-alpha.2 < 0.1.6`). */
+function cmp(a, b) {
+	const core = cmpCore(a.core, b.core);
+	if (core !== 0) return core;
+	if (a.channel === null || b.channel === null) {
+		if (a.channel === b.channel) return 0;
+		return a.channel === null ? 1 : -1;
+	}
+	if (a.channel !== b.channel) return a.channel < b.channel ? -1 : 1;
+	const ab = a.build ?? 0;
+	const bb = b.build ?? 0;
+	return ab === bb ? 0 : ab < bb ? -1 : 1;
+}
+/** Pick the adapter for a release, clamping to the nearest verified line when the
+*  release is outside everything this plugin has seen.
+*
+*  A release is matched by PATCH LINE before anything else: `0.1.6-alpha.4` and a
+*  future `0.1.6` stable both belong to the line verified at `0.1.6-alpha.2`, and
+*  handing them that adapter beats giving up — the DOM probes only cover panel
+*  mechanics, not the surface decisions the line is known for.
+*
+*  Outside every verified line the answer is a guess, so it is the closest one and
+*  it says so (`nearest`): newer than the newest line → that newest adapter, older
+*  than the oldest → the oldest, strictly between two → the LOWER one, because an
+*  adapter may only claim what it was verified for. A release that will not parse
+*  at all is `unknown`, and the DOM arbitrates there. */
+function classifyRelease(version) {
+	const host = version === null ? null : parse(version);
+	if (host === null) return {
+		channel: "unknown",
+		match: "unresolved"
+	};
+	const sameLine = TABLE.filter((row) => cmpCore(row.parsed.core, host.core) === 0);
+	if (sameLine.length > 0) {
+		const exact = sameLine.find((row) => row.release === version);
+		if (exact !== void 0) return {
+			channel: exact.channel,
+			match: "exact"
+		};
+		const atOrBelow = sameLine.filter((row) => cmp(row.parsed, host) <= 0);
+		return {
+			channel: (atOrBelow.length > 0 ? atOrBelow[atOrBelow.length - 1] : sameLine[0]).channel,
+			match: "line"
+		};
+	}
+	const older = TABLE.filter((row) => cmp(row.parsed, host) < 0);
+	if (older.length === 0) return {
+		channel: TABLE[0].channel,
+		match: "nearest"
+	};
+	if (TABLE.filter((row) => cmp(row.parsed, host) > 0).length === 0) return {
+		channel: TABLE[TABLE.length - 1].channel,
+		match: "nearest"
+	};
+	return {
+		channel: older[older.length - 1].channel,
+		match: "nearest"
+	};
+}
+//#endregion
+//#region src/host-compat/detect.ts
+/**
+* The front door: resolve which DSH release this plugin is running under.
+*
+* WHY IT RUNS HERE (node) AND NOT IN THE BROWSER
+* The client context exposes no host version — verified against the harness: no
+* `hostVersion`/`dshVersion` field on `ctx`, and `window.__DSH_BOOT__.version` is
+* the module-table format tag `'client'`, not a release. Capability probing alone
+* is also not enough, because the obvious probes do not separate the release
+* lines:
+* `ctx.sidebarRightTabs` and the `[data-sidebar-right-panel]` marker both exist on
+* 0.1.5-rc.2 already, so either one used as a "0.1.6+" test mis-classifies 0.1.5
+* as newer. The install the process was composed FROM states the release directly,
+* and only the node half can read it.
+*
+* Three hops, most authoritative first:
+*   1. `ctx.profileContext.installAnchor` — the absolute path of the running
+*      app's own manifest (`<…>/node_modules/@deepseek-ai/dsh/package.json`; the
+*      host passes exactly that file, `new URL('../package.json', import.meta.url)`
+*      of its `dsh` package). Whatever process is serving this plugin is what that
+*      manifest versioned, so it needs no path guessing. Provided by
+*      `dsh-app-boot` only in a dsh-launched profile, hence optional.
+*   2. The installed manifest next to the launcher home:
+*      `<root>/versions/<ver>/node_modules/@deepseek-ai/dsh/package.json`, reached
+*      from `$DSH_HOME`'s `homes/<ver>` layout. For a host that gives no
+*      `profileContext`.
+*   3. `$DSH_HOME`'s basename, because launcher homes live in a folder named after
+*      the release (`.../homes/0.1.6-alpha.2`). A user may point DSH_HOME at a
+*      plain `~/.dsh` (no launcher layout at all), whose basename is not a
+*      version — hence `looksLikeVersion` gates it.
+*
+* A release that resolves but matches no verified patch line is clamped to the
+* nearest adapter by `classifyRelease()`; only a release that will not parse at
+* all degrades to `version: null` / `channel: 'unknown'`, where the client half
+* falls back to DOM-shape probing. That fallback is not hypothetical: a plain
+* `~/.dsh` install lands here, and a wrong guess would silently restyle the
+* user's window.
+*
+* @module
+*/
+/** What "the verified lines" are, spelled out for the clamp log below. */
+const SUPPORTED_HINT = SUPPORTED_RELEASES.map((row) => row.release).join(" ~ ");
+/** Read the `version` field of a package manifest, or null when the file is
+*  missing, unreadable, not JSON or does not declare a release-looking version —
+*  every one of which just means "this hop has no answer". */
+async function manifestVersion(file) {
+	try {
+		const raw = JSON.parse(await readFile(file, "utf8"));
+		if (typeof raw.version === "string" && looksLikeVersion(raw.version.trim())) return raw.version.trim();
+	} catch {}
+	return null;
+}
+/** Hop 1: the anchor the host itself hands us. A custom composition may point it
+*  at its own manifest, whose `version` is whatever that project calls itself —
+*  `looksLikeVersion` inside `manifestVersion` is what keeps a non-release out. */
+async function versionFromAnchor(anchor) {
+	if (typeof anchor !== "string" || anchor === "") return null;
+	if (!/[/\\]package\.json$/.test(anchor)) return null;
+	return manifestVersion(anchor);
+}
+/** Hop 2: the installed manifest two levels up from a launcher home
+*  (`<root>/homes/<ver>` → `<root>/versions/<ver>`), or null when the layout does
+*  not apply (plain `~/.dsh`, non-launcher hosts). */
+async function versionFromLauncher(homeDir) {
+	const root = dirname(dirname(homeDir));
+	const versionSeg = basename(homeDir);
+	if (!looksLikeVersion(versionSeg)) return null;
+	return manifestVersion(join(root, "versions", versionSeg, "node_modules", "@deepseek-ai", "dsh", "package.json"));
+}
+/** Cached verdict: the probe touches the filesystem, and the host release never
+*  changes within a process lifetime. */
+let cache;
+/** Resolve (and cache) the host release + channel. `installAnchor` is
+*  `ctx.profileContext?.installAnchor`, read at plugin mount time.
+*
+*  A clamped verdict (`nearest`) is logged once: it means the plugin is styling a
+*  release it was never verified against, and that is the first thing to know when
+*  a new host build reports a broken surface. */
+async function resolveHostInfo(installAnchor) {
+	if (cache !== void 0) return cache;
+	const homeDir = dshHomePath();
+	let version = await versionFromAnchor(installAnchor);
+	if (version === null) version = await versionFromLauncher(homeDir);
+	if (version === null) {
+		const seg = basename(homeDir);
+		if (looksLikeVersion(seg)) version = seg;
+	}
+	const verdict = classifyRelease(version);
+	if (verdict.match === "nearest") console.log(`dsh-any-background: host release ${version} is outside the verified lines, styling it as ${verdict.channel} (supports ${SUPPORTED_HINT})`);
+	cache = {
+		version,
+		channel: verdict.channel
+	};
+	return cache;
+}
+//#endregion
 //#region src/index.ts
 /**
 * Node half of dsh-any-background: file-backed theme persistence.
@@ -87,13 +305,13 @@ function sniffFontMime(buf) {
 const DEFAULT_CONFIG = {
 	color: null,
 	opacities: {
-		bg: .5,
+		bg: 0,
 		sidebar: .5,
 		card: .5,
 		input: .5
 	},
 	blurs: {
-		bg: 30,
+		bg: 0,
 		sidebar: 30,
 		card: 30,
 		settings: 30,
@@ -158,7 +376,7 @@ const DEFAULT_CONFIG = {
 	},
 	settingsOpacity: .5,
 	wallpaperOpacity: 1,
-	blur: 30,
+	blur: 0,
 	bgState: {
 		zoom: 1,
 		x: 0,
@@ -205,55 +423,6 @@ const DEFAULT_CONFIG = {
 	schemeOverride: "auto",
 	activeProfile: null
 };
-const VERSION_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
-/** True when a string looks like a release version (a bare `~/.dsh` basename does not). */
-function looksLikeVersion(value) {
-	return VERSION_RE.test(value);
-}
-/** Read the installed `@deepseek-ai/dsh` manifest version for a launcher dir,
-*  or null when the layout does not apply (plain `~/.dsh`, non-launcher hosts). */
-async function readInstalledVersion(homeDir) {
-	const root = dirname(dirname(homeDir));
-	const versionSeg = basename(homeDir);
-	const manifest = join(root, "versions", versionSeg, "node_modules", "@deepseek-ai", "dsh", "package.json");
-	try {
-		const raw = JSON.parse(await readFile(manifest, "utf8"));
-		if (typeof raw.version === "string" && raw.version.trim() !== "") return raw.version.trim();
-	} catch {}
-	return null;
-}
-/** Cached verdict: the probe touches the filesystem, and the host version never
-*  changes within a process lifetime. */
-let hostInfoCache;
-/** Map a release string onto the generation bucket the plugin gates features by.
-*  The published lines are `0.1.5`, `0.1.6` and `0.1.7`, so the bucket is the
-*  `major.minor.patch` prefix — every rc/alpha within a line shares it. */
-function generationOf(version) {
-	if (version === null) return "unknown";
-	const m = /^(\d+\.\d+\.\d+)/.exec(version);
-	if (m === null) return "unknown";
-	const key = m[1];
-	return key === "0.1.5" || key === "0.1.6" || key === "0.1.7" ? key : "unknown";
-}
-/** Resolve (and cache) the host release + generation. */
-async function resolveHostInfo() {
-	if (hostInfoCache !== void 0) return hostInfoCache;
-	const homeDir = dshHomePath();
-	let version = null;
-	try {
-		version = await readInstalledVersion(homeDir);
-	} catch {}
-	if (version === null) {
-		const seg = basename(homeDir);
-		if (looksLikeVersion(seg)) version = seg;
-	}
-	if (version !== null && !looksLikeVersion(version)) version = null;
-	hostInfoCache = {
-		version,
-		generation: generationOf(version)
-	};
-	return hostInfoCache;
-}
 const dataDir = () => dshHomePath(DATA_DIR);
 const configPath = () => dshHomePath(DATA_DIR, CONFIG_FILE);
 const wallpaperPath = () => dshHomePath(DATA_DIR, WALLPAPER_FILE);
@@ -1628,7 +1797,7 @@ async function advanceRotationIfDue() {
 }
 /** Dispatch one decoded RPC method to the matching persistence routine and
 *  return the wire `result` half of the server-response envelope. */
-async function handleRpcMethod(endpoint, payload) {
+async function handleRpcMethod(endpoint, payload, hostInfo) {
 	const method = endpoint.slice(`${NS}/`.length);
 	try {
 		switch (method) {
@@ -1646,7 +1815,7 @@ async function handleRpcMethod(endpoint, payload) {
 						fontUrl: await fontUrl(),
 						rotated,
 						firstRun,
-						host: await resolveHostInfo()
+						host: await hostInfo
 					}
 				};
 			}
@@ -1707,6 +1876,10 @@ async function handleRpcMethod(endpoint, payload) {
 	}
 }
 function apply(ctx) {
+	const hostInfo = resolveHostInfo(ctx.profileContext?.installAnchor).catch((e) => {
+		console.warn("dsh-any-background: host release detection failed, falling back to DOM probing", e);
+		return UNKNOWN_HOST_INFO;
+	});
 	ctx.inject(["connection", "webServer"], (webCtx) => {
 		webCtx.effect(() => webCtx.webServer.register({
 			kind: "prefix",
@@ -1809,7 +1982,7 @@ function apply(ctx) {
 					}));
 					return;
 				}
-				const result = await handleRpcMethod(endpoint, env.payload);
+				const result = await handleRpcMethod(endpoint, env.payload, hostInfo);
 				res.writeHead(200, { "Content-Type": "application/json" });
 				res.end(JSON.stringify({
 					type: "server-response",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-any-background",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Appearance plugin for DeepSeek Harness: custom theme color (PS-style color wheel), background wallpaper with opacity/blur controls, and separate main/settings interface opacity.",
   "keywords": [
     "deepseek-harness",
@@ -23,7 +23,7 @@
   "author": "Tkingxiao",
   "type": "module",
   "engines": {
-    "dsh": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1"
+    "dsh": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1"
   },
   "exports": {
     ".": {
@@ -67,13 +67,13 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1",
-    "@deepseek-ai/dsh-client-store": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1",
-    "@deepseek-ai/dsh-client-connection": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1",
-    "@deepseek-ai/dsh-client-ui-theme": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1",
-    "@deepseek-ai/dsh-invariants": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-theme": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1",
     "react": "^18.2.0",
     "dsh-better-sidebar": ">=0.4.0"
   },
@@ -111,13 +111,15 @@
   },
   "dsh": {
     "compatibility": {
-      "dsh": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1",
+      "dsh": "0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1",
       "dshReleases": {
         "0.1.5-rc.2": "compatible",
         "0.1.5-rc.3": "compatible",
         "0.1.6-alpha.1": "compatible",
         "0.1.6-alpha.2": "compatible",
-        "0.1.7-alpha.1": "compatible"
+        "0.1.7-alpha.1": "compatible",
+        "0.1.7-alpha.2": "compatible",
+        "0.1.7-rc.1": "compatible"
       }
     },
     "bundle": {