@deepseek-ai/dsh-workspace 0.1.7-rc.1 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -1,6 +1,88 @@
-# 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:
+# 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 packages/workspace/workspace/README.md
-README.md: 59b314a7302c5cf83314d08f6e8bdfe2dccba37f
-README.zh.md: 78d563ee59048d5b1b6f976ac26f64907174645d
+/:
+  en: d112c03aefc9a73d
+  zh: e2ea3f0a9c814a23
+/deepseek-ai-dsh-workspace:
+  en: 7a12adba4e7766e3
+  zh: f6d5c8374f4512c8
+/deepseek-ai-dsh-workspace/summary:
+  en: 58d66b238882b849
+  zh: a427930afd293c6b
+/deepseek-ai-dsh-workspace/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 09388d293f9be9cb
+/deepseek-ai-dsh-workspace/use-this-package:
+  en: 37d744451570942e
+  zh: 7f8200725a1cca54
+/deepseek-ai-dsh-workspace/use-this-package/when-to-use-it:
+  en: f24dd905d5bcac3e
+  zh: 16b91b99fdaf5add
+/deepseek-ai-dsh-workspace/use-this-package/setting-up:
+  en: f4611634be527eb0
+  zh: 89d35d640a2c1cc4
+/deepseek-ai-dsh-workspace/use-this-package/creating-and-ordering-projects:
+  en: a092fc7b0db9c299
+  zh: 6d7ed93e34237773
+/deepseek-ai-dsh-workspace/use-this-package/first-use-workspace:
+  en: 2bfeef54ad410e63
+  zh: 98b79574586d000a
+/deepseek-ai-dsh-workspace/use-this-package/grouping-sessions-under-a-project:
+  en: 510be21d012de28c
+  zh: fdcb05447d6ba93c
+/deepseek-ai-dsh-workspace/use-this-package/hiding-and-restoring-sessions-and-removing-projects:
+  en: f6f19cd64d8db3b0
+  zh: 55875a2c4d8e4d1f
+/deepseek-ai-dsh-workspace/understand-the-implementation:
+  en: 447ced401b3b14a8
+  zh: 3ce2105605223945
+/deepseek-ai-dsh-workspace/understand-the-implementation/design-philosophy:
+  en: e8ff536e19566447
+  zh: 53ba4c15f10c1549
+/deepseek-ai-dsh-workspace/understand-the-implementation/api-behavior:
+  en: 69327adb9ea52680
+  zh: fa32eea5019c7abb
+/deepseek-ai-dsh-workspace/understand-the-implementation/source-map:
+  en: c6de390af6b1a187
+  zh: 85699c7c5c3afe3a
+/deepseek-ai-dsh-workspace/understand-the-implementation/durable-shape:
+  en: 056a266f4a15b29d
+  zh: e1589f5750662887
+/deepseek-ai-dsh-workspace/understand-the-implementation/lifecycle:
+  en: e41db10d48acbf9a
+  zh: 457d329fe37ba33c
+/deepseek-ai-dsh-workspace/understand-the-implementation/failure-and-recovery:
+  en: 7a2f7802debbdd75
+  zh: fbf4603f52863a6c
+/deepseek-ai-dsh-workspace/understand-the-implementation/invariant:
+  en: d20f2bba9aab0d1d
+  zh: 2ff06f27e7a8a867
+/deepseek-ai-dsh-workspace/further-exploration:
+  en: ea6e4da02bc6da4e
+  zh: 5168484d76a27436
+/deepseek-ai-dsh-workspace/model-experience:
+  en: 215e7ba838619b7b
+  zh: a311da3843709f90
+/deepseek-ai-dsh-workspace/model-experience/workspace-records-and-session-accounts:
+  en: c5c7dfdfe3cea27f
+  zh: 6e75bd1afacba4c4
+/deepseek-ai-dsh-workspace/model-experience/workspace-records-and-session-accounts/what-the-model-sees:
+  en: ab7deb3130db939e
+  zh: b717a7fc60146cd3
+/deepseek-ai-dsh-workspace/model-experience/workspace-records-and-session-accounts/token-effect:
+  en: 5b83ac7ce1ea1346
+  zh: dc56664cd257ab8e
+/deepseek-ai-dsh-workspace/model-experience/workspace-records-and-session-accounts/kv-cache-effect:
+  en: 524afbded27fb06b
+  zh: 9dcf8539495e9c68
+/deepseek-ai-dsh-workspace/known-limitations-and-deferred-work:
+  en: ca8f1d8617b303eb
+  zh: aeff1adad175ebb5
+/deepseek-ai-dsh-workspace/known-limitations-and-deferred-work/dev-note:
+  en: ac1d08360a93382b
+  zh: 6c58749bae9a6e65
+/deepseek-ai-dsh-workspace/known-limitations-and-deferred-work/dev-note/open-the-create-path-title-title-parameter:
+  en: 65867b2bb7aba416
+  zh: 38547efe92828640

package/README.md

@@ -64,7 +64,7 @@ ctx.workspaceRegistry.list() // shows the project, newest first
 
 `initializeDefault(resolveDirectory)` initializes the default Workspace without creating a Session. Initial creation requires an empty Workspace registry and no live, persisted, or archived Session, including Sessions without a working directory. The registry checks persistent history directly; an empty visible sidebar is insufficient.
 
-The directory resolver runs inside the mutation queue only when creation is eligible. It returns an absolute path and initial title; the registry creates missing parent directories, canonicalizes the path, rechecks Session history, and commits the Workspace with its initialization marker. An existing directory is reused; a file conflict or directory failure rejects initialization. The [Host controller](../../api/workspace-controller/README.md#first-use-workspace) supplies the Documents path policy.
+The directory resolver runs inside the mutation queue only when creation is eligible. It returns an absolute path; the registry creates missing parent directories, canonicalizes the path, rechecks Session history, and commits the Workspace with its initialization marker, titled after the requested directory's final segment rather than the canonical one, so a symlink at that path does not retitle the Workspace after its target. An existing directory is reused; a file conflict or directory failure rejects initialization. The [Host controller](../../api/workspace-controller/README.md#first-use-workspace) supplies the Documents path policy.
 
 The first successful registration records its identity durably. Repeated calls return it without resolving a directory again; renaming keeps that identity, and deleting its registration does not permit another automatic creation. Directory or registration failure leaves initialization unset for retry. Directories created before a later failure remain on disk. Once directory resolution succeeds, caller cancellation does not roll back directory creation or registration. The [first-use decision](../../../.agents/notes/implemented/feature/2026-09-20-default-workspace.md) explains this lifetime.
 

package/README.zh.md

@@ -64,7 +64,7 @@ ctx.workspaceRegistry.list() // shows the project, newest first
 
 `initializeDefault(resolveDirectory)` 初始化默认 Workspace，不创建 Session。首次创建要求 Workspace 注册表为空，且不存在运行时、持久化或已归档 Session，包括没有工作目录的 Session。注册表直接检查持久化历史；仅凭可见侧边栏为空不足以判断。
 
-目录解析器仅在允许创建时于变更队列内运行。它返回绝对路径和初始标题；注册表创建缺失的父目录、规范化路径、重新检查 Session 历史，再一起提交 Workspace 和初始化标记。已存在的目录直接复用；文件冲突或目录操作失败时拒绝初始化。[Host 控制器](../../api/workspace-controller/README.zh.md#first-use-workspace)提供 Documents 路径策略。
+目录解析器仅在允许创建时于变更队列内运行。它返回绝对路径；注册表创建缺失的父目录、规范化路径、重新检查 Session 历史，再一起提交 Workspace 和初始化标记，标题取所请求目录（而非规范路径）的最后一段，因此该路径上的符号链接不会让工作区改用链接目标的名称。已存在的目录直接复用；文件冲突或目录操作失败时拒绝初始化。[Host 控制器](../../api/workspace-controller/README.zh.md#first-use-workspace)提供 Documents 路径策略。
 
 首次成功登记会持久保存工作区身份。重复调用直接返回它，不再解析目录；改名保留该身份，删除登记也不会允许再次自动创建。目录或登记失败时，初始化状态保持未设置，可以重试。后续步骤失败前已创建的目录会保留在磁盘上。目录解析成功后，调用方取消操作不会回滚目录创建或登记。[首次使用决策](../../../.agents/notes/implemented/feature/2026-09-20-default-workspace.zh.md)说明这一生命周期。
 

package/lib/index.js

@@ -412,9 +412,11 @@ var WorkspaceRegistry = class extends Service {
 	* Initialize the default Workspace only while both the registry and Session
 	* history are empty. Repeated requests reuse its durable identity; deleting
 	* that registration permanently disables automatic creation.
-	* @param resolveDirectory - resolve the absolute directory and initial title;
-	* called only for eligible creation, inside the registry mutation queue.
-	* Missing directories are created recursively before registration.
+	* @param resolveDirectory - resolve the absolute directory; called only for
+	* eligible creation, inside the registry mutation queue. Missing directories
+	* are created recursively before registration, and the initial title is the
+	* requested directory's own final segment — not the canonical one, so a
+	* symlink at that path does not retitle the Workspace after its target.
 	* After resolution, caller cancellation does not roll back creation or registration.
 	* @returns the initialized Workspace, or undefined when automatic creation is ineligible.
 	*/
@@ -425,12 +427,12 @@ var WorkspaceRegistry = class extends Service {
 			const sessions = this.ctx.get("sessions");
 			if (sessions === void 0) throw new Error("default Workspace initialization requires the Session store");
 			if (state.workspaceIds.length > 0 || state.archivedSessionIds.length > 0 || sessions.list().length > 0 || (await this.listStoredHeaders()).length > 0) return void 0;
-			const { path, title } = await resolveDirectory();
+			const path = await resolveDirectory();
 			if (!fullyQualifiedWorkspacePath(path)) throw new TypeError(`Workspace path is not fully qualified: '${path}'`);
 			await mkdir(path, { recursive: true });
 			const canonical = await realpathNormalize(path);
 			if ((await this.listStoredHeaders()).length > 0 || sessions.list().length > 0) return void 0;
-			return this.createCanonical(canonical, title, true);
+			return this.createCanonical(canonical, defaultWorkspaceTitle(path), true);
 		});
 	}
 	/**

package/lib/types/index.d.ts

@@ -147,16 +147,15 @@ export declare class WorkspaceRegistry extends Service {
      * Initialize the default Workspace only while both the registry and Session
      * history are empty. Repeated requests reuse its durable identity; deleting
      * that registration permanently disables automatic creation.
-     * @param resolveDirectory - resolve the absolute directory and initial title;
-     * called only for eligible creation, inside the registry mutation queue.
-     * Missing directories are created recursively before registration.
+     * @param resolveDirectory - resolve the absolute directory; called only for
+     * eligible creation, inside the registry mutation queue. Missing directories
+     * are created recursively before registration, and the initial title is the
+     * requested directory's own final segment — not the canonical one, so a
+     * symlink at that path does not retitle the Workspace after its target.
      * After resolution, caller cancellation does not roll back creation or registration.
      * @returns the initialized Workspace, or undefined when automatic creation is ineligible.
      */
-    initializeDefault(resolveDirectory: () => Promise<{
-        path: string;
-        title: string;
-    }>): Promise<Workspace | undefined>;
+    initializeDefault(resolveDirectory: () => Promise<string>): Promise<Workspace | undefined>;
     /**
      * Look up a workspace by id.
      * @param id - Workspace id.

package/lib/types/index.js

@@ -161,9 +161,11 @@ export class WorkspaceRegistry extends Service {
      * Initialize the default Workspace only while both the registry and Session
      * history are empty. Repeated requests reuse its durable identity; deleting
      * that registration permanently disables automatic creation.
-     * @param resolveDirectory - resolve the absolute directory and initial title;
-     * called only for eligible creation, inside the registry mutation queue.
-     * Missing directories are created recursively before registration.
+     * @param resolveDirectory - resolve the absolute directory; called only for
+     * eligible creation, inside the registry mutation queue. Missing directories
+     * are created recursively before registration, and the initial title is the
+     * requested directory's own final segment — not the canonical one, so a
+     * symlink at that path does not retitle the Workspace after its target.
      * After resolution, caller cancellation does not roll back creation or registration.
      * @returns the initialized Workspace, or undefined when automatic creation is ineligible.
      */
@@ -178,7 +180,7 @@ export class WorkspaceRegistry extends Service {
             if (state.workspaceIds.length > 0 || state.archivedSessionIds.length > 0
                 || sessions.list().length > 0 || (await this.listStoredHeaders()).length > 0)
                 return undefined;
-            const { path, title } = await resolveDirectory();
+            const path = await resolveDirectory();
             if (!fullyQualifiedWorkspacePath(path))
                 throw new TypeError(`Workspace path is not fully qualified: '${path}'`);
             await mkdir(path, { recursive: true });
@@ -186,7 +188,7 @@ export class WorkspaceRegistry extends Service {
             // A Session can start outside the registry queue while directory preparation awaits I/O.
             if ((await this.listStoredHeaders()).length > 0 || sessions.list().length > 0)
                 return undefined;
-            return this.createCanonical(canonical, title, true);
+            return this.createCanonical(canonical, defaultWorkspaceTitle(path), true);
         });
     }
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-workspace",
   "description": "Workspace entity registry (ctx.workspaceRegistry): durable workspace records with validated session attachment over the domain data form for the DeepSeek Harness",
-  "version": "0.1.7-rc.1",
+  "version": "0.2.0-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -38,24 +38,24 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-session-persistence": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-storage": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-invariants": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-storage-domain": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.1"
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-storage": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-storage-domain": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session-persistence": "0.2.0-rc.1"
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/dsh-brand": "0.1.7-rc.1"
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.1"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-session-persistence": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-storage": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-storage-domain": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-invariants": "0.1.7-rc.1",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.1"
+    "@deepseek-ai/dsh-invariants": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session-persistence": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-storage": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-storage-domain": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.1"
   }
 }