@fishwithcat/dsh-tui 0.2.2-alpha.2 → 0.2.2-alpha.3.fork.1

package/README.i18n.yaml

@@ -3,5 +3,5 @@
 # After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write apps/tui-launcher/README.md
 /deepseek-ai-dsh-tui-launcher:
-  en: 439609bb2db15ecd
-  zh: 146bfa54eb9ee207
+  en: d2af509f44c7c023
+  zh: 964f6eade419ff50

package/README.md

@@ -2,19 +2,23 @@
 
 English | [中文](README.zh.md)
 
-The npm-installed terminal entry. `dsh-tui` creates the `tui` profile when it
-is missing, resolves the installed `@deepseek-ai/dsh` CLI, and runs it with
-`--profile tui`, forwarding every application argument. The packed manifest
-aliases that CLI dependency to this fork's build, so the resolved command is
-the fork's launcher rather than the upstream package. The launcher owns the
-profile choice: `--profile`, `--from-default-profile`, and `dsh plugin` are
-rejected.
+The terminal entry for npm installs and source checkouts. `dsh-tui` creates
+the `tui` profile when it is missing, resolves the installed
+`@deepseek-ai/dsh` CLI, and runs it with `--profile tui`, forwarding every
+application argument. The packed manifest aliases that CLI dependency to this
+fork's build, so the resolved command is the fork's launcher rather than the
+upstream package. The launcher owns the profile choice: `--profile`,
+`--from-default-profile`, and `dsh plugin` are rejected. A source checkout
+installs the same command with `pnpm run link:dsh-tui` and runs it from source
+with `pnpm dsh-tui`.
 
-The published package is `@fishwithcat/dsh-tui`. Its packed manifest replaces
-the workspace dependencies with `npm:` aliases for the fork-only packages, so
-the upstream CLI resolves those names to the fork's builds. Keep the launcher
-and every aliased package on the upstream version; a `-fork.N` version does
-not satisfy the exact ranges upstream packages declare.
+The published package is `@fishwithcat/dsh-tui`. Its packed manifest aliases
+the TUI layer (`@fishwithcat/dsh` and `@fishwithcat/dsh-tui-app`) at the fork
+version and the eight core-overlay packages at the upstream version, so the
+upstream CLI resolves every name to the fork's builds while upstream exact
+ranges and required peers keep one copy. A fork version has the form
+`<upstream>.fork.<n>`.
 
 `dsh-tui watch <session-id>` is translated to `--watch <session-id>`, and
-`dsh-tui --version` does not create a profile.
+`dsh-tui --version` prints the launcher's fork version without creating a
+profile or resolving the installed CLI.

package/README.zh.md

@@ -2,16 +2,18 @@
 
 [English](README.md) | 中文
 
-npm 安装后的终端入口。`dsh-tui` 在 `tui` profile 不存在时创建它，解析已安装的
-`@deepseek-ai/dsh` CLI，并以 `--profile tui` 启动，原样转发应用参数。打包后的
-manifest 把这个 CLI 依赖别名到本 fork 的构建，因此实际解析到的是 fork 的启动器，
-而不是上游包。profile 由启动器固定：`--profile`、`--from-default-profile` 和
-`dsh plugin` 会被拒绝。
+npm 安装与源码 checkout 共用的终端入口。`dsh-tui` 在 `tui` profile 不存在时创建
+它，解析已安装的 `@deepseek-ai/dsh` CLI，并以 `--profile tui` 启动，原样转发应用
+参数。打包后的 manifest 把这个 CLI 依赖别名到本 fork 的构建，因此实际解析到的是
+fork 的启动器，而不是上游包。profile 由启动器固定：`--profile`、
+`--from-default-profile` 和 `dsh plugin` 会被拒绝。源码 checkout 用
+`pnpm run link:dsh-tui` 安装同一个命令，并用 `pnpm dsh-tui` 从源码运行。
 
-实际发布的包名是 `@fishwithcat/dsh-tui`。打包后的 manifest 会把 workspace
-依赖替换成指向 fork 包的 `npm:` 别名，让上游 CLI 按同一批依赖名解析到 fork 的
-构建。启动器和所有被别名的包必须与上游同号；`-fork.N` 不满足上游包声明的精确
-范围。
+实际发布的包名是 `@fishwithcat/dsh-tui`。打包后的 manifest 把 TUI 层
+（`@fishwithcat/dsh` 与 `@fishwithcat/dsh-tui-app`）别名到 fork 版本，把 8 个
+核心覆盖包别名到上游版本，让上游 CLI 按同一批依赖名解析到 fork 的构建，同时让
+上游的精确范围与 required peer 只保留一份副本。fork 版本的形式为
+`<upstream>.fork.<n>`。
 
 `dsh-tui watch <session-id>` 会转换成 `--watch <session-id>`，`dsh-tui --version`
-不会创建 profile。
+会打印启动器的 fork 版本，不创建 profile，也不解析已安装的 CLI。

package/lib/bin.js

@@ -64,8 +64,9 @@ function resolveCliEntry(resolve) {
 	return resolve("@deepseek-ai/dsh/lib/bin.js");
 }
 /**
-* Whether the invocation only asks for the CLI version and must not create a
-* profile.
+* Whether the invocation only asks for the launcher version. The launcher
+* answers it from its own manifest, without creating a profile or resolving
+* the installed CLI.
 * @param argv - normalized CLI arguments.
 * @returns true when the invocation carries a version flag.
 */
@@ -86,10 +87,15 @@ function fail(message, code) {
 	process.exit(code);
 }
 const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
 const invocation = (() => {
 	try {
 		const args = launcherCliArgs(process.argv.slice(2));
-		if (!isVersionRequest(args)) ensureTuiProfile();
+		if (isVersionRequest(args)) {
+			process.stdout.write(`${version}\n`);
+			process.exit(0);
+		}
+		ensureTuiProfile();
 		return {
 			args,
 			entry: resolveCliEntry(require.resolve)

package/lib/types/launch.d.ts

@@ -35,8 +35,9 @@ export declare function ensureTuiProfile(dir?: string): string;
  */
 export declare function resolveCliEntry(resolve: (specifier: string) => string): string;
 /**
- * Whether the invocation only asks for the CLI version and must not create a
- * profile.
+ * Whether the invocation only asks for the launcher version. The launcher
+ * answers it from its own manifest, without creating a profile or resolving
+ * the installed CLI.
  * @param argv - normalized CLI arguments.
  * @returns true when the invocation carries a version flag.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fishwithcat/dsh-tui",
   "description": "The npm-installable terminal entry: creates the tui profile and launches the installed dsh CLI",
-  "version": "0.2.2-alpha.2",
+  "version": "0.2.2-alpha.3.fork.1",
   "type": "module",
   "bin": {
     "dsh-tui": "lib/bin.js"
@@ -20,17 +20,17 @@
     "node": ">=24.9.0"
   },
   "dependencies": {
-    "@deepseek-ai/dsh": "npm:@fishwithcat/dsh@0.2.2-alpha.2",
-    "@deepseek-ai/dsh-app-boot": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-base": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-agent": "npm:@fishwithcat/dsh-agent@0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session": "npm:@fishwithcat/dsh-session@0.2.2-alpha.2",
-    "@deepseek-ai/dsh-user-approval": "npm:@fishwithcat/dsh-user-approval@0.2.2-alpha.2",
-    "@deepseek-ai/dsh-tool-ask-user": "npm:@fishwithcat/dsh-tool-ask-user@0.2.2-alpha.2",
-    "@deepseek-ai/dsh-compaction": "npm:@fishwithcat/dsh-compaction@0.2.2-alpha.2",
-    "@deepseek-ai/dsh-compaction-basic": "npm:@fishwithcat/dsh-compaction-basic@0.2.2-alpha.2",
-    "@deepseek-ai/dsh-subagent": "npm:@fishwithcat/dsh-subagent@0.2.2-alpha.2",
-    "@deepseek-ai/dsh-tool-todo": "npm:@fishwithcat/dsh-tool-todo@0.2.2-alpha.2",
-    "@deepseek-ai/dsh-tui-app": "npm:@fishwithcat/dsh-tui-app@0.2.2-alpha.2"
+    "@deepseek-ai/dsh": "npm:@fishwithcat/dsh@0.2.2-alpha.3.fork.1",
+    "@deepseek-ai/dsh-app-boot": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-base": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-agent": "npm:@fishwithcat/dsh-agent@0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session": "npm:@fishwithcat/dsh-session@0.2.2-alpha.3",
+    "@deepseek-ai/dsh-user-approval": "npm:@fishwithcat/dsh-user-approval@0.2.2-alpha.3",
+    "@deepseek-ai/dsh-tool-ask-user": "npm:@fishwithcat/dsh-tool-ask-user@0.2.2-alpha.3",
+    "@deepseek-ai/dsh-compaction": "npm:@fishwithcat/dsh-compaction@0.2.2-alpha.3",
+    "@deepseek-ai/dsh-compaction-basic": "npm:@fishwithcat/dsh-compaction-basic@0.2.2-alpha.3",
+    "@deepseek-ai/dsh-subagent": "npm:@fishwithcat/dsh-subagent@0.2.2-alpha.3",
+    "@deepseek-ai/dsh-tool-todo": "npm:@fishwithcat/dsh-tool-todo@0.2.2-alpha.3",
+    "@deepseek-ai/dsh-tui-app": "npm:@fishwithcat/dsh-tui-app@0.2.2-alpha.3.fork.1"
   }
 }