@aiwayds/dsh-tui-pi 2.32.0 → 2.33.0

package/README.md

@@ -42,7 +42,7 @@ npm i -g @aiwayds/dsh-tui-pi
 dsh-tui-pi          # or the short form: dst
 ```
 
-The global install sets the machine up by itself, printing one progress line per step: it installs the `@deepseek-ai/dsh` host when missing (via npm; if npm itself is not on PATH, it prints what to install and stops), installs pnpm, and creates the `tui` profile with this plugin and its bundled companions. Whatever the install cannot finish (e.g. an offline machine) completes automatically on the first launch. After a later `npm i -g` upgrade of this package, the profile's mounted copy is moved to the new version on the next launch — a profile that is newer than the global install (dev-upgraded ahead) is left untouched.
+The global install sets the machine up by itself, printing one progress line per step: it installs the `@deepseek-ai/dsh` host when missing (via npm, resolved as the newest of the `latest`/`next` dist-tags — the `latest` tag alone lags the rc line; if npm itself is not on PATH, it prints what to install and stops), installs pnpm, and creates the `tui` profile with this plugin and its bundled companions. Host compatibility window: **0.2.1-rc.2 through 0.2.1-rc.4** — an rc.2 host is kept as-is (the subagent companion degrades gracefully there); an older one is upgraded automatically. Whatever the install cannot finish (e.g. an offline machine) completes automatically on the first launch. After a later `npm i -g` upgrade of this package, the profile's mounted copy is moved to the new version on the next launch — a profile that is newer than the global install (dev-upgraded ahead) is left untouched.
 
 The manual steps do exactly what the onboarding runs, if you prefer them:
 

package/bin/onboard-core.mjs

@@ -132,6 +132,48 @@ function installGlobal(name) {
   return result.status === 0
 }
 
+// Newest of the `latest` (stable) and `next` (rc) dist-tags — the same
+// resolution rule as ci.yml / e2e/run-e2e.sh; the alpha tag is retired.
+// The host's `latest` dist-tag lags the rc line this plugin targets
+// (2026-10: latest=0.2.1-rc.2 while the plugin needs the rc.3 subagent
+// APIs), so the host must never be installed from the bare package name.
+// Returns a concrete version, or null when npm cannot be reached.
+export function resolveHostVersion() {
+  try {
+    const out = execFileSync('npm', ['view', HOST, 'dist-tags', '--json'], {
+      encoding: 'utf8',
+      timeout: 30_000,
+      stdio: ['ignore', 'pipe', 'pipe'],
+    })
+    const tags = JSON.parse(out)
+    const stable = tags?.latest
+    const rc = tags?.next
+    if (stable && rc) return compareVersions(rc, stable) > 0 ? rc : stable
+    return stable ?? rc ?? null
+  } catch {
+    return null
+  }
+}
+
+// The oldest host this plugin supports. Compatibility window: 0.2.1-rc.2
+// through 0.2.1-rc.4 (rc.2 lacks the subagents.start* APIs, where the
+// subagent-registry companion degrades gracefully via its host-compat
+// guard; rc.3/rc.4 have the full surface). Read from the manifest's own
+// peerDependencies when declared, so declaration and check stay one
+// decision — note the floor must NOT move into peerDependencies itself:
+// npm ≥7 auto-installs peers on global installs and would pull the 834MB
+// host at its stale `latest` tag.
+export function minHostVersion() {
+  try {
+    const peer = readSelfPackage().peerDependencies?.[HOST]
+    const match = typeof peer === 'string' ? peer.match(/>=\s*(\S+)/) : null
+    if (match) return match[1]
+  } catch {
+    /* fall through to the baked-in floor */
+  }
+  return '0.2.1-rc.2'
+}
+
 // True when the mounted profile copy is OLDER than this package. Prerelease
 // tags compare numerically per dot segment (rc.10 > rc.4); a profile that is
 // NEWER (dev-upgraded ahead of the global install) is left alone.
@@ -210,23 +252,30 @@ function approvePrintedBuilds() {
  */
 export function runOnboard({ log = () => {} } = {}) {
   let dsh = dshBinPath()
-  if (dsh) {
-    log(`  [1/3] dsh host              found ${queryVersion(dsh, ['-V']) ?? '(version unknown)'}`)
-  } else if (!which('npm')) {
-    log(`  [1/3] dsh host              not found, and npm is not on PATH either`)
+  const wanted = resolveHostVersion()
+  const hostSpec = wanted ? `${HOST}@${wanted}` : HOST
+  const foundVersion = dsh ? queryVersion(dsh, ['-V']) : null
+  const tooOld = foundVersion ? compareVersions(foundVersion, minHostVersion()) < 0 : false
+  if (dsh && !tooOld) {
+    log(`  [1/3] dsh host              found ${foundVersion ?? '(version unknown)'}`)
+  } else if (!dsh && !which('npm')) {
+    log('  [1/3] dsh host              not found, and npm is not on PATH either')
     return {
       ok: false,
       step: 'npm',
       hint: 'install Node.js (ships with npm) first: https://nodejs.org — then re-run dsh-tui-pi',
     }
   } else {
-    log(`  [1/3] dsh host              not found — installing ${HOST} globally with npm (largest step, a few minutes)…`)
-    if (!installGlobal(HOST)) {
-      return { ok: false, step: 'dsh host install', hint: `install it with: npm install -g ${HOST} — then re-run dsh-tui-pi` }
+    const reason = dsh
+      ? `${foundVersion} is older than this plugin requires (>= ${minHostVersion()})`
+      : 'not found'
+    log(`  [1/3] dsh host              ${reason} — installing ${hostSpec} globally with npm (largest step, a few minutes)…`)
+    if (!installGlobal(hostSpec)) {
+      return { ok: false, step: 'dsh host install', hint: `install it with: npm install -g ${hostSpec} — then re-run dsh-tui-pi` }
     }
     dsh = dshBinPath()
     if (!dsh) {
-      return { ok: false, step: 'dsh host lookup', hint: `installed, but still not found — run: npm install -g ${HOST}` }
+      return { ok: false, step: 'dsh host lookup', hint: `installed, but still not found — run: npm install -g ${hostSpec}` }
     }
     log(`  [1/3] dsh host              installed ${queryVersion(dsh, ['-V']) ?? ''}`)
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwayds/dsh-tui-pi",
-  "version": "2.32.0",
+  "version": "2.33.0",
   "description": "A fully-featured pi-style terminal UI for DeepSeek Harness (dsh) — history look-back & fork-at-turn, guided preset switching, live subagent steering, model profiles & themes",
   "repository": {
     "type": "git",
@@ -75,7 +75,7 @@
     "@aiwayds/dsh-mcp-adapter": "^0.7.0",
     "@aiwayds/dsh-model-sync": "^0.7.0",
     "@aiwayds/dsh-profile-switch": "^0.3.0",
-    "@aiwayds/dsh-subagent-registry": "^0.13.0",
+    "@aiwayds/dsh-subagent-registry": "^0.14.0",
     "@aiwayds/dsh-web-search-anysearch": "^0.6.0",
     "@earendil-works/pi-tui": "0.85.1"
   },