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

package/README.i18n.yaml

@@ -0,0 +1,7 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# 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: d2af509f44c7c023
+  zh: 964f6eade419ff50

package/README.md

@@ -1,3 +1,24 @@
-# Temporary Holding Version
+# `@deepseek-ai/dsh-tui-launcher`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+English | [中文](README.zh.md)
+
+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 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` prints the launcher's fork version without creating a
+profile or resolving the installed CLI.

package/README.zh.md

@@ -0,0 +1,19 @@
+# `@deepseek-ai/dsh-tui-launcher`
+
+[English](README.md) | 中文
+
+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 把 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`
+会打印启动器的 fork 版本，不创建 profile，也不解析已安装的 CLI。

package/lib/bin.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { spawn } from "node:child_process";
+import { constants } from "node:os";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { initProfile, resolveProfileDir } from "@deepseek-ai/dsh-app-boot";
+/** Bundle layers a launcher-created `tui` profile starts from. */
+const TUI_PROFILE_BUNDLES = ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-tui-app"];
+/** Launcher flags that would select a different profile. */
+const PROFILE_FLAGS = new Set(["--profile", "--from-default-profile"]);
+/**
+* Turn the launcher arguments into the dsh CLI arguments.
+*
+* The launcher owns the profile, so profile-selection flags and plugin
+* management are rejected. `watch <id>` becomes the equivalent `--watch <id>`
+* application flag, which the CLI routes to the tui profile on its own.
+* @param argv - arguments after the `dsh-tui` command.
+* @returns the arguments for the dsh CLI.
+* @throws when a caller selects a profile or asks for plugin management.
+*/
+function launcherCliArgs(argv) {
+	for (const argument of argv) {
+		const flag = argument.split("=", 1)[0];
+		if (flag !== void 0 && PROFILE_FLAGS.has(flag)) throw new Error(`dsh-tui: ${flag} is fixed to "tui"; run dsh directly to select another profile`);
+	}
+	if (argv[0] === "plugin") throw new Error("dsh-tui: plugin management runs through dsh plugin --profile tui <pnpm arguments>");
+	if (argv[0] === "watch") {
+		const sessionId = argv[1];
+		if (sessionId === void 0) throw new Error("dsh-tui: watch needs a session id");
+		return [
+			"--profile",
+			"tui",
+			"--watch",
+			sessionId,
+			...argv.slice(2)
+		];
+	}
+	return [
+		"--profile",
+		"tui",
+		...argv
+	];
+}
+/**
+* Create the `tui` profile when the directory has no manifest yet.
+*
+* An existing profile is left untouched: it may carry the user's own patch
+* layer and plugin list, and the bundle names resolve from the launcher's
+* installation before the profile anyway.
+* @param dir - profile directory; defaults to `$DSH_HOME/profiles/tui`.
+* @returns the profile directory.
+*/
+function ensureTuiProfile(dir = resolveProfileDir("tui")) {
+	if (!existsSync(join(dir, "package.json"))) initProfile(dir, TUI_PROFILE_BUNDLES);
+	return dir;
+}
+/**
+* Resolve the installed CLI entry from the launcher's own installation.
+* @param resolve - Node resolution function anchored at this launcher.
+* @returns the absolute path of the dsh bin script.
+*/
+function resolveCliEntry(resolve) {
+	return resolve("@deepseek-ai/dsh/lib/bin.js");
+}
+/**
+* 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.
+*/
+function isVersionRequest(argv) {
+	return argv.some((argument) => argument === "--version" || argument === "-V");
+}
+//#endregion
+//#region lib/types/bin.js
+/* v8 ignore file -- self-executing entry; launch.ts owns the tested decisions. */
+/**
+* Stop the launcher with one stderr line.
+* @param message - diagnostic text.
+* @param code - process exit status.
+* @returns never.
+*/
+function fail(message, code) {
+	process.stderr.write(`${message}\n`);
+	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)) {
+			process.stdout.write(`${version}\n`);
+			process.exit(0);
+		}
+		ensureTuiProfile();
+		return {
+			args,
+			entry: resolveCliEntry(require.resolve)
+		};
+	} catch (error) {
+		fail(error instanceof Error ? error.message : String(error), 1);
+	}
+})();
+const child = spawn(process.execPath, [invocation.entry, ...invocation.args], {
+	stdio: "inherit",
+	env: process.env
+});
+process.on("SIGINT", () => {});
+process.on("SIGTERM", () => {
+	child.kill("SIGTERM");
+});
+child.on("error", (error) => {
+	fail(`dsh-tui: ${error.message}`, 1);
+});
+child.on("exit", (code, signal) => {
+	if (signal !== null) process.exit(128 + constants.signals[signal]);
+	process.exit(code ?? 1);
+});
+//#endregion
+export {};

package/lib/types/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/lib/types/launch.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Launcher decisions for the npm-installed terminal entry: argument
+ * normalization, the fresh `tui` profile, and the CLI entry lookup.
+ * @module @deepseek-ai/dsh-tui-launcher/launch
+ */
+/** Profile this launcher always boots. */
+export declare const TUI_PROFILE = "tui";
+/** Bundle layers a launcher-created `tui` profile starts from. */
+export declare const TUI_PROFILE_BUNDLES: readonly string[];
+/**
+ * Turn the launcher arguments into the dsh CLI arguments.
+ *
+ * The launcher owns the profile, so profile-selection flags and plugin
+ * management are rejected. `watch <id>` becomes the equivalent `--watch <id>`
+ * application flag, which the CLI routes to the tui profile on its own.
+ * @param argv - arguments after the `dsh-tui` command.
+ * @returns the arguments for the dsh CLI.
+ * @throws when a caller selects a profile or asks for plugin management.
+ */
+export declare function launcherCliArgs(argv: readonly string[]): string[];
+/**
+ * Create the `tui` profile when the directory has no manifest yet.
+ *
+ * An existing profile is left untouched: it may carry the user's own patch
+ * layer and plugin list, and the bundle names resolve from the launcher's
+ * installation before the profile anyway.
+ * @param dir - profile directory; defaults to `$DSH_HOME/profiles/tui`.
+ * @returns the profile directory.
+ */
+export declare function ensureTuiProfile(dir?: string): string;
+/**
+ * Resolve the installed CLI entry from the launcher's own installation.
+ * @param resolve - Node resolution function anchored at this launcher.
+ * @returns the absolute path of the dsh bin script.
+ */
+export declare function resolveCliEntry(resolve: (specifier: string) => string): string;
+/**
+ * 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.
+ */
+export declare function isVersionRequest(argv: readonly string[]): boolean;
+//# sourceMappingURL=launch.d.ts.map

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@fishwithcat/dsh-tui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "description": "The npm-installable terminal entry: creates the tui profile and launches the installed dsh CLI",
+  "version": "0.2.2-alpha.3.fork.1",
+  "type": "module",
+  "bin": {
+    "dsh-tui": "lib/bin.js"
+  },
+  "files": [
+    "lib/*.js",
+    "lib/types/*.d.ts"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/FishwithCat/deepseek-harness-tui",
+    "directory": "apps/tui-launcher"
+  },
+  "engines": {
+    "node": ">=24.9.0"
+  },
+  "dependencies": {
+    "@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"
+  }
+}