@fishwithcat/dsh-tui 0.0.0-stage → 0.2.2-alpha.2

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: 439609bb2db15ecd
+  zh: 146bfa54eb9ee207

package/README.md

@@ -1,3 +1,20 @@
-# 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 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 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.
+
+`dsh-tui watch <session-id>` is translated to `--watch <session-id>`, and
+`dsh-tui --version` does not create a profile.

package/README.zh.md

@@ -0,0 +1,17 @@
+# `@deepseek-ai/dsh-tui-launcher`
+
+[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` 会被拒绝。
+
+实际发布的包名是 `@fishwithcat/dsh-tui`。打包后的 manifest 会把 workspace
+依赖替换成指向 fork 包的 `npm:` 别名，让上游 CLI 按同一批依赖名解析到 fork 的
+构建。启动器和所有被别名的包必须与上游同号；`-fork.N` 不满足上游包声明的精确
+范围。
+
+`dsh-tui watch <session-id>` 会转换成 `--watch <session-id>`，`dsh-tui --version`
+不会创建 profile。

package/lib/bin.js

@@ -0,0 +1,117 @@
+#!/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 CLI version and must not create a
+* profile.
+* @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 invocation = (() => {
+	try {
+		const args = launcherCliArgs(process.argv.slice(2));
+		if (!isVersionRequest(args)) 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,44 @@
+/**
+ * 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 CLI version and must not create a
+ * profile.
+ * @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.2",
+  "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.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"
+  }
+}