dsh-code 0.6.0 → 0.6.1

package/README.en.md

@@ -37,11 +37,13 @@ The interface follows familiar terminal conventions, while runtime behavior cont
 Requires Node `^22.19 || >=24`, the preview `dsh` CLI, and `DEEPSEEK_API_KEY`.
 
 ```sh
-npm install -g @deepseek-ai/dsh@next dsh-code
+npm install -g @deepseek-ai/dsh dsh-code
 npm install -g pnpm
-dsh plugin --profile cli add dsh-code
+dsh plugin --profile cli add dsh-code@0.6.1
 ```
 
+> Note: pnpm ignores packages published less than 24 hours ago, so pin `dsh-code@0.6.1` on the release day; the version can be omitted afterwards. npm installs are not affected.
+
 Available launch commands:
 
 ```sh

package/README.md

@@ -37,11 +37,13 @@ DSH-Code 保留这套结构，并补充适合编码任务的终端工作流。
 需要 Node `^22.19 || >=24`、预览版 `dsh` CLI，以及 `DEEPSEEK_API_KEY`。
 
 ```sh
-npm install -g @deepseek-ai/dsh@next dsh-code
+npm install -g @deepseek-ai/dsh dsh-code
 npm install -g pnpm
-dsh plugin --profile cli add dsh-code
+dsh plugin --profile cli add dsh-code@0.6.1
 ```
 
+> 提示：pnpm 会忽略发布不足 24 小时的包，因此发布首日请使用精确版本 `dsh-code@0.6.1`；24 小时后可省略版本号。npm 安装不受此限制。
+
 可用的启动指令：
 ```sh
 deepseek

package/bin/deepseek.mjs

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 
 import { spawn } from 'node:child_process'
-import { existsSync, realpathSync } from 'node:fs'
+import { existsSync, readFileSync, realpathSync } from 'node:fs'
 import { createRequire } from 'node:module'
+import { homedir } from 'node:os'
 import { join, resolve } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 
@@ -11,6 +12,30 @@ const packageRequire = createRequire(import.meta.url)
 /** Arguments required to boot DSH-Code's conventional profile. */
 export const profileArgs = (args = []) => ['--profile', 'cli', ...args]
 
+/** The conventional cli profile directory under the DSH home. */
+export function cliProfileDir(home = homedir()) {
+  return join(home, '.dsh', 'profiles', 'cli')
+}
+
+/**
+ * Whether the cli profile already mounts dsh-code. A bare profile composes
+ * dsh-base alone and keeps the process alive with no TUI runner — the alias
+ * must fail loudly with the missing step instead of hanging.
+ */
+export function profileHasDshCode(profileDir = cliProfileDir(), fileExists = existsSync, readFile = readFileSync) {
+  const manifest = join(profileDir, 'package.json')
+  if (!fileExists(manifest)) return false
+  try {
+    const raw = JSON.parse(readFile(manifest, 'utf8'))
+    const bundles = raw?.dsh?.profile?.bundles
+    const dependencies = raw?.dependencies
+    return (Array.isArray(bundles) && bundles.includes('dsh-code'))
+      || (typeof dependencies === 'object' && dependencies !== null && 'dsh-code' in dependencies)
+  } catch {
+    return false
+  }
+}
+
 /** Npm global-prefix roots that may contain DSH when this launcher is globally linked to a checkout. */
 export function globalDshRoots() {
   return [...new Set([
@@ -43,10 +68,20 @@ export function dshCommand(args, {
 }
 
 /** Launch the installed DSH CLI while preserving its exit status and stdio. */
-export function launchDsh(args = process.argv.slice(2), spawnProcess = spawn, resolveCommand = dshCommand) {
+export function launchDsh(
+  args = process.argv.slice(2),
+  spawnProcess = spawn,
+  resolveCommand = dshCommand,
+  isProfileReady = profileHasDshCode,
+) {
+  if (!isProfileReady()) {
+    console.error('dsh-code: the cli profile does not mount dsh-code yet. Run: dsh plugin --profile cli add dsh-code')
+    process.exitCode = 1
+    return undefined
+  }
   const command = resolveCommand(args)
   if (command === undefined) {
-    console.error('dsh-code: @deepseek-ai/dsh must be installed globally beside dsh-code; run: npm install -g @deepseek-ai/dsh@next dsh-code')
+    console.error('dsh-code: @deepseek-ai/dsh must be installed globally beside dsh-code; run: npm install -g @deepseek-ai/dsh dsh-code')
     process.exitCode = 1
     return undefined
   }

package/lib/index.mjs

@@ -25430,19 +25430,23 @@ function projectEvents(events) {
 	return events.reduce(projectEvent, createTranscriptView());
 }
 /**
-* How many leading transcript entries can never change again: only a
-* `running` tool or retry can still mutate in place — everything before the
-* first one (including a completed tail: later events only APPEND new rows)
-* is final. The renderer currently draws the whole transcript dynamically
-* (a `<Static>` flush proved unstable with CJK wrapping on real terminals);
-* this boundary stays as the append-only contract for when flushing is
-* reintroduced.
+* The append-only flush boundary for a transcript view: the count of entries
+* no later event can remove. Entries at or beyond this index are mutable and
+* must stay in the live tree.
+*
+* `pending` rows are excluded even though they are not a running tool/retry:
+* the inbox claims or cancels them durably (`agent/inbox/spliced` removals,
+* `user/message` retirement), and an append-only `<Static>` flush cannot
+* erase a row that vanishes from the view — the retired row would ghost on
+* screen until the next source-backed replay. Everything else (including a
+* completed tail) is final: later events only APPEND new rows.
 * @param entries - the view's transcript entries in order.
 * @returns the count of entries safe to flush (0 for an empty transcript).
 */
 function settledEntryCount(entries) {
 	for (let index = 0; index < entries.length; index++) {
 		const entry = entries[index];
+		if (entry.kind === "pending") return index;
 		if (entry.kind === "tool" && entry.state === "running") return index;
 		if (entry.kind === "retry" && entry.state === "running") return index;
 	}
@@ -30276,6 +30280,7 @@ async function run(ctx, startup, io) {
 			mentions = next.mentions;
 			commands.setAgent(agent);
 			skills.setAgent(agent);
+			process.stdout.write("\x1B[r\x1B[0m\x1B[H\x1B[2J\x1B[3J\x1B[H");
 			renderCurrent();
 			const queued = pendingInputs.splice(0);
 			for (const item of queued) deliverLine(item.text, item.mode);

package/lib/types/render/projection.d.ts

@@ -235,13 +235,16 @@ export declare function projectEvent(view: TranscriptView, event: SessionEvent):
  */
 export declare function projectEvents(events: readonly SessionEvent[]): TranscriptView;
 /**
- * How many leading transcript entries can never change again: only a
- * `running` tool or retry can still mutate in place — everything before the
- * first one (including a completed tail: later events only APPEND new rows)
- * is final. The renderer currently draws the whole transcript dynamically
- * (a `<Static>` flush proved unstable with CJK wrapping on real terminals);
- * this boundary stays as the append-only contract for when flushing is
- * reintroduced.
+ * The append-only flush boundary for a transcript view: the count of entries
+ * no later event can remove. Entries at or beyond this index are mutable and
+ * must stay in the live tree.
+ *
+ * `pending` rows are excluded even though they are not a running tool/retry:
+ * the inbox claims or cancels them durably (`agent/inbox/spliced` removals,
+ * `user/message` retirement), and an append-only `<Static>` flush cannot
+ * erase a row that vanishes from the view — the retired row would ghost on
+ * screen until the next source-backed replay. Everything else (including a
+ * completed tail) is final: later events only APPEND new rows.
  * @param entries - the view's transcript entries in order.
  * @returns the count of entries safe to flush (0 for an empty transcript).
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-code",
   "description": "Claude-Code-style interactive TUI bundle for DeepSeek Harness (dsh): DeepSeek-blue whale banner, live session transcript, and a blended status line",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "type": "module",
   "bin": {
     "deepseek": "./bin/deepseek.mjs",

package/src/index.ts

@@ -523,6 +523,11 @@ async function run(ctx: Context, startup: TuiStartup, io: TuiIo): Promise<void>
       mentions = next.mentions
       commands.setAgent(agent)
       skills.setAgent(agent)
+      // The App mounts with a placeholder key until the first input; the
+      // key-change remount below must start from a clean screen or the ghost
+      // static header stays visible above the new one (same source-backed
+      // clear the session-switch path performs).
+      process.stdout.write('\x1b[r\x1b[0m\x1b[H\x1b[2J\x1b[3J\x1b[H')
       renderCurrent()
       const queued = pendingInputs.splice(0)
       for (const item of queued) deliverLine(item.text, item.mode)

package/src/render/projection.ts

@@ -635,19 +635,23 @@ export function projectEvents(events: readonly SessionEvent[]): TranscriptView {
 }
 
 /**
- * How many leading transcript entries can never change again: only a
- * `running` tool or retry can still mutate in place — everything before the
- * first one (including a completed tail: later events only APPEND new rows)
- * is final. The renderer currently draws the whole transcript dynamically
- * (a `<Static>` flush proved unstable with CJK wrapping on real terminals);
- * this boundary stays as the append-only contract for when flushing is
- * reintroduced.
+ * The append-only flush boundary for a transcript view: the count of entries
+ * no later event can remove. Entries at or beyond this index are mutable and
+ * must stay in the live tree.
+ *
+ * `pending` rows are excluded even though they are not a running tool/retry:
+ * the inbox claims or cancels them durably (`agent/inbox/spliced` removals,
+ * `user/message` retirement), and an append-only `<Static>` flush cannot
+ * erase a row that vanishes from the view — the retired row would ghost on
+ * screen until the next source-backed replay. Everything else (including a
+ * completed tail) is final: later events only APPEND new rows.
  * @param entries - the view's transcript entries in order.
  * @returns the count of entries safe to flush (0 for an empty transcript).
  */
 export function settledEntryCount(entries: readonly TranscriptEntry[]): number {
   for (let index = 0; index < entries.length; index++) {
     const entry = entries[index]
+    if (entry.kind === 'pending') return index
     if (entry.kind === 'tool' && entry.state === 'running') return index
     if (entry.kind === 'retry' && entry.state === 'running') return index
   }