@prettier-ai/dsh-util-workspace-path 0.1.2-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/util/workspace-path/README.md
+README.md: 9f925ba09e7dd5e015cb5000490edb0234463abc
+README.zh.md: 09a2449d084c2110f47037e4368c5e6c66d6a81c

package/README.md

@@ -0,0 +1,37 @@
+---
+description: "Browser-safe Workspace path helpers for joining relative paths, abbreviating POSIX homes, and deriving display titles."
+kind: "package-library"
+---
+
+# dsh-util-workspace-path
+
+English | [中文](README.zh.md)
+
+## Summary
+
+Browser-safe path helpers shared by Workspace-facing client and controller packages. The package joins Workspace-relative paths, abbreviates POSIX home directories for display, and derives Workspace titles from POSIX or Windows paths. It has no Cordis service or runtime state.
+
+## Table of Contents
+
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- **Resolution is lexical** — it recognizes POSIX absolute paths, Windows drive paths, and UNC paths but does not access a filesystem or canonicalize `.` and `..` segments.
+- **Home abbreviation is POSIX-only** — Windows paths remain unchanged because a portable browser cannot infer Windows home-path equivalence safely.
+
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,37 @@
+---
+description: "浏览器安全的 Workspace 路径辅助函数：拼接相对路径、缩写 POSIX 主目录并生成显示标题。"
+kind: "package-library"
+---
+
+# dsh-util-workspace-path
+
+[English](README.md) | 中文
+
+## 概述
+
+供 Workspace 相关客户端和控制器包共享、可在浏览器使用的路径辅助函数。该包负责拼接 Workspace 相对路径、缩写用于展示的 POSIX 主目录，以及从 POSIX 或 Windows 路径提取 Workspace 标题；它不提供 Cordis service，也不持有运行时状态。
+
+## 目录
+
+- [已知限制与暂缓事项](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+## 已知限制与暂缓事项
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- **路径解析仅处理字面值**——它识别 POSIX 绝对路径、Windows 盘符路径和 UNC 路径，但不访问文件系统，也不规范化 `.` 与 `..` 路径段。
+- **主目录缩写仅支持 POSIX**——Windows 路径保持不变，因为可移植浏览器无法安全推断 Windows 主目录路径等价关系。
+
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者工作上下文——点击展开</summary>
+
+无。
+
+</details>

package/lib/index.js

@@ -0,0 +1,48 @@
+//#region lib/types/index.js
+/**
+* Browser-safe Workspace path and display helpers.
+* @module @prettier-ai/dsh-util-workspace-path
+*/
+/** Whether a path uses a Windows drive or UNC prefix. */
+function isWindowsStylePath(value) {
+	return /^[A-Za-z]:[/\\]/.test(value) || value.startsWith("\\\\");
+}
+/**
+* Resolve a Workspace-relative path into the Host-facing spelling used by path operations.
+* @param cwd - Session Workspace root, when known.
+* @param path - Absolute or Workspace-relative path.
+* @returns an absolute path when a Workspace root is available, otherwise the original path.
+*/
+function resolveWorkspacePath(cwd, path) {
+	if (path.startsWith("/") || isWindowsStylePath(path)) return path;
+	if (cwd === void 0 || cwd === "") return path;
+	return `${cwd.replace(/[/\\]+$/, "")}/${path.replace(/^[/\\]+/, "")}`;
+}
+/**
+* Abbreviate a POSIX home directory for display.
+* @param path - Absolute or already-short display path.
+* @param home - Host account home; absent skips abbreviation.
+* @returns `~` or `~/…` for the POSIX home and its descendants, otherwise `path`.
+*/
+function abbreviateHomePath(path, home) {
+	if (home === void 0 || home === "") return path;
+	if (isWindowsStylePath(path) || isWindowsStylePath(home)) return path;
+	const root = home.replace(/\/+$/, "");
+	if (root === "" || root === "/") return path;
+	if (path.replace(/\/+$/, "") === root) return "~";
+	if (path.startsWith(`${root}/`)) return `~${path.slice(root.length)}`;
+	return path;
+}
+/**
+* Read the final non-empty segment of a Workspace path for display.
+* Workspace-label surfaces use this helper instead of deriving another basename.
+* @param path - Workspace directory path using POSIX or Windows separators.
+* @returns the final segment, or an empty string for a separator-only path.
+*/
+function workspaceTitleOf(path) {
+	const trimmed = path.replace(/[/\\]+$/, "");
+	const separator = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"));
+	return trimmed.slice(separator + 1);
+}
+//#endregion
+export { abbreviateHomePath, resolveWorkspacePath, workspaceTitleOf };

package/lib/invariant.js

@@ -0,0 +1,20 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@prettier-ai/dsh-util-workspace-path`.
+* @module @prettier-ai/dsh-util-workspace-path/invariant
+*/
+const PACKAGE_NAME = "@prettier-ai/dsh-util-workspace-path";
+/** Cordis companion plugin name. */
+const name = "workspace-path-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/** No runtime invariant: this utility owns no mutable runtime relationship. */
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Browser-safe Workspace path and display helpers.
+ * @module @prettier-ai/dsh-util-workspace-path
+ */
+/**
+ * Resolve a Workspace-relative path into the Host-facing spelling used by path operations.
+ * @param cwd - Session Workspace root, when known.
+ * @param path - Absolute or Workspace-relative path.
+ * @returns an absolute path when a Workspace root is available, otherwise the original path.
+ */
+export declare function resolveWorkspacePath(cwd: string | undefined, path: string): string;
+/**
+ * Abbreviate a POSIX home directory for display.
+ * @param path - Absolute or already-short display path.
+ * @param home - Host account home; absent skips abbreviation.
+ * @returns `~` or `~/…` for the POSIX home and its descendants, otherwise `path`.
+ */
+export declare function abbreviateHomePath(path: string, home?: string): string;
+/**
+ * Read the final non-empty segment of a Workspace path for display.
+ * Workspace-label surfaces use this helper instead of deriving another basename.
+ * @param path - Workspace directory path using POSIX or Windows separators.
+ * @returns the final segment, or an empty string for a separator-only path.
+ */
+export declare function workspaceTitleOf(path: string): string;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@prettier-ai/dsh-util-workspace-path`.
+ * @module @prettier-ai/dsh-util-workspace-path/invariant
+ */
+import type { Context } from '@prettier-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "workspace-path-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@prettier-ai/dsh-util-workspace-path",
+  "description": "Browser-safe Workspace path and display helpers",
+  "version": "0.1.2-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/util/workspace-path"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1"
+  }
+}