@prettier-ai/dsh-workspace 0.1.2-rc.1 → 0.1.3-alpha.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # 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/workspace/workspace/README.md
-README.md: 49ca861742fe9ea5f36edbaeb8d9700c475b1d50
-README.zh.md: 707044970b716577d2f1f95e558c341e217985c4
+README.md: eb3d2a4f89b6023d8a916a41723500186cc10d93
+README.zh.md: 5059a6edd69a82bd8b0a364793ca1b5c941d67e2

package/README.md

@@ -50,7 +50,7 @@ With these rows mounted, creating a project shows up in the list immediately and
 
 ### Creating and ordering projects
 
-Create a project from any directory that exists: give its path and an optional title, and the project appears in the list, newest first. A path that does not exist, or a file instead of a directory, is rejected and nothing changes; creating a project for a directory that already has one returns the existing project unchanged. Rename a project at any time, and move it to any position in the list:
+Create a project from any fully qualified directory that exists: filesystem roots such as `C:\` and ordinary directories are valid. Relative paths, Windows drive-relative paths such as `C:work`, missing paths, and files are rejected without creating a project; creating a project for a directory that already has one returns the existing project unchanged. Rename a project at any time, and move it to any position in the list:
 
 ```text
 // Host consumer code, after the composition above is loaded:

package/README.zh.md

@@ -50,7 +50,7 @@ kind: "package-reference"
 
 ### 创建与排序项目
 
-从任何存在的目录创建项目：给出路径和可选标题，项目即出现在列表中，新到旧排列。不存在的路径或文件而非目录会被拒绝，且不会有任何变化；为已有项目的目录再次创建会原样返回现有项目。你可以随时重命名项目，并把它移动到列表中的任意位置：
+从任何存在且完整限定的目录创建项目：`C:\` 等文件系统根目录和普通目录都有效。相对路径、`C:work` 等 Windows 盘符相对路径、不存在的路径和文件都会被拒绝，且不会创建项目；为已有项目的目录再次创建会原样返回现有项目。你可以随时重命名项目，并把它移动到列表中的任意位置：
 
 ```text
 // Host consumer code, after the composition above is loaded:

package/lib/index.js

@@ -1,7 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { realpath, stat } from "node:fs/promises";
-import { basename } from "node:path";
 import { Service } from "@prettier-ai/cordis";
+import { posix, win32 } from "node:path";
 import { z } from "zod";
 import { brandString } from "@prettier-ai/dsh-brand";
 import { defineDomain, domainTable } from "@prettier-ai/dsh-storage-domain";
@@ -11,18 +11,42 @@ import { defineDomain, domainTable } from "@prettier-ai/dsh-storage-domain";
 * @module @prettier-ai/dsh-workspace/src/paths
 */
 /**
-* Canonicalize a directory path via `fs.realpath`: trailing slashes, `..`
-* segments, and symlinks are all resolved. This is the ONE uniqueness canon of
-* the package — workspace paths are stored canonicalized, uniqueness is
-* string equality of canonicalized paths (a symlink to an existing
-* workspace's directory collides), and attach-time session `cwd` checks go
-* through the same canon. A path that does not exist rejects with the
-* original `ENOENT` — this is `create`'s reject path (a workspace must point
-* at an existing directory).
+* Check whether a path names one fixed Host location without process cwd or
+* current-drive resolution.
+* @param path - Candidate Workspace path.
+* @param platform - Host platform; injectable for deterministic path tests.
+* @returns Whether the path is fully qualified on that platform.
+*/
+function fullyQualifiedWorkspacePath(path, platform = process.platform) {
+	if (platform !== "win32") return posix.isAbsolute(path);
+	const root = win32.parse(path).root;
+	return win32.isAbsolute(path) && root !== "\\" && root !== "/";
+}
+/**
+* Derive a non-empty default title from a canonical Workspace path.
+* @param path - Canonical Workspace path.
+* @param platform - Host platform; injectable for deterministic path tests.
+* @returns The final segment when present, otherwise the complete root spelling.
+*/
+function defaultWorkspaceTitle(path, platform = process.platform) {
+	const pathApi = platform === "win32" ? win32 : posix;
+	return pathApi.basename(path) || pathApi.parse(path).root;
+}
+/**
+* Canonicalize a fully qualified directory path via `fs.realpath`: trailing
+* slashes, `..` segments, and symlinks are all resolved. This is the ONE
+* uniqueness canon of the package — workspace paths are stored canonicalized,
+* uniqueness is string equality of canonicalized paths (a symlink to an
+* existing workspace's directory collides), and attach-time session `cwd`
+* checks go through the same canon. Relative paths reject before `realpath` can
+* resolve them from the Host cwd or current Windows drive. A path that does not
+* exist rejects with the original `ENOENT` — this is `create`'s reject path (a
+* workspace must point at an existing directory).
 * @param path - The path to canonicalize.
 * @returns the canonical absolute path.
 */
 async function realpathNormalize(path) {
+	if (!fullyQualifiedWorkspacePath(path)) throw new TypeError(`Workspace path is not fully qualified: '${path}'`);
 	return await realpath(path);
 }
 //#endregion
@@ -318,23 +342,23 @@ var WorkspaceRegistry = class extends Service {
 		await this.recoverPendingMutation();
 		this.validateStoredState(this.state);
 		if (!this.state.initialized) {
-			const headers = await this.ctx.sessionPersistence.list();
+			const headers = await this.listStoredHeaders();
 			await this.replaceHeaderIndex(headers);
 			await this.bootstrap(headers);
-		} else if (this.table.size > 0) await this.replaceHeaderIndex(await this.ctx.sessionPersistence.list());
+		} else if (this.table.size > 0) await this.replaceHeaderIndex(await this.listStoredHeaders());
 		await this.indexLiveSessions();
 		this.validateStoredState(this.requireState());
 		this.rebuildEntities();
 		this.reportFilteredCandidates();
 	}
 	/**
-	* Create or reuse a workspace for an existing directory. The path is
-	* canonicalized through `fs.realpath`; a nonexistent path rejects with the
-	* original error and a non-directory rejects. Repeated calls for the same
-	* canonical path return the existing entity without changing its title.
+	* Create or reuse a workspace for an existing directory. The fully qualified
+	* path is canonicalized through `fs.realpath`; a relative, nonexistent, or
+	* non-directory path rejects. Repeated calls for the same canonical path
+	* return the existing entity without changing its title.
 	* A newly created workspace is prepended to the durable registry order.
 	* Different canonical paths may share a display title.
-	* @param path - Existing directory to own, in any path spelling.
+	* @param path - Existing directory to own, in a fully qualified path spelling.
 	* @param title - Display title used only when a new record is created.
 	* @returns the existing or newly durable workspace.
 	*/
@@ -439,14 +463,14 @@ var WorkspaceRegistry = class extends Service {
 	async sessionKnown(id) {
 		if (this.ctx.get("sessions")?.get(id) !== void 0) return true;
 		if (this.headers.has(id)) return true;
-		await this.indexHeaders(await this.ctx.sessionPersistence.list());
+		await this.indexHeaders(await this.listStoredHeaders());
 		return this.headers.has(id);
 	}
 	/**
 	* Resolve by canonical directory path without creating or mutating a
 	* workspace. A missing path rejects during `realpath`; an existing unowned
 	* directory returns `undefined`.
-	* @param path - Existing directory path in any spelling.
+	* @param path - Existing directory path in a fully qualified spelling.
 	* @returns the workspace owning the canonical path, when one exists.
 	*/
 	async resolveByPath(path) {
@@ -455,7 +479,7 @@ var WorkspaceRegistry = class extends Service {
 	}
 	async createCanonical(canonical, title) {
 		for (const entity of this.entities.values()) if (entity.path === canonical) return entity;
-		const workspaceName = title ?? basename(canonical);
+		const workspaceName = title ?? defaultWorkspaceTitle(canonical);
 		const table = this.requireTable();
 		const state = this.requireState();
 		const id = WorkspaceId(randomUUID());
@@ -602,7 +626,7 @@ var WorkspaceRegistry = class extends Service {
 				const createdAt = new Date(group.newestAt).toISOString();
 				const record = {
 					path: group.path,
-					title: basename(group.path),
+					title: defaultWorkspaceTitle(group.path),
 					sessionIds,
 					createdAt,
 					updatedAt: createdAt
@@ -701,6 +725,10 @@ var WorkspaceRegistry = class extends Service {
 			this.invalidSessionPaths.set(header.id, `cwd '${header.cwd}' does not resolve`);
 		}
 	}
+	/** Every stored session's header, projected from the persistence snapshot listing. */
+	async listStoredHeaders() {
+		return (await this.ctx.sessionPersistence.list()).map((snapshot) => snapshot.header);
+	}
 	async indexLiveSessions() {
 		const sessions = this.ctx.get("sessions");
 		if (sessions === void 0) return;
@@ -725,7 +753,7 @@ var WorkspaceRegistry = class extends Service {
 		}
 		const cached = this.headers.get(id);
 		if (cached !== void 0) return cached;
-		const headers = await this.ctx.sessionPersistence.list();
+		const headers = await this.listStoredHeaders();
 		await this.indexHeaders(headers);
 		const header = this.headers.get(id);
 		if (header === void 0) throw new Error(`cannot validate session '${id}': session persistence holds no such session`);

package/lib/invariant.js

@@ -1,7 +1,7 @@
 import "node:crypto";
 import "node:fs/promises";
-import "node:path";
 import { Service } from "@prettier-ai/cordis";
+import "node:path";
 import { z } from "zod";
 import { brandString } from "@prettier-ai/dsh-brand";
 import { defineDomain, domainTable } from "@prettier-ai/dsh-storage-domain";

package/lib/types/index.d.ts

@@ -66,13 +66,13 @@ export declare class WorkspaceRegistry extends Service {
     /** Open the domain, finish bootstrap when required, and rebuild the ordered cache. */
     protected [Service.init](): Promise<void>;
     /**
-     * Create or reuse a workspace for an existing directory. The path is
-     * canonicalized through `fs.realpath`; a nonexistent path rejects with the
-     * original error and a non-directory rejects. Repeated calls for the same
-     * canonical path return the existing entity without changing its title.
+     * Create or reuse a workspace for an existing directory. The fully qualified
+     * path is canonicalized through `fs.realpath`; a relative, nonexistent, or
+     * non-directory path rejects. Repeated calls for the same canonical path
+     * return the existing entity without changing its title.
      * A newly created workspace is prepended to the durable registry order.
      * Different canonical paths may share a display title.
-     * @param path - Existing directory to own, in any path spelling.
+     * @param path - Existing directory to own, in a fully qualified path spelling.
      * @param title - Display title used only when a new record is created.
      * @returns the existing or newly durable workspace.
      */
@@ -133,7 +133,7 @@ export declare class WorkspaceRegistry extends Service {
      * Resolve by canonical directory path without creating or mutating a
      * workspace. A missing path rejects during `realpath`; an existing unowned
      * directory returns `undefined`.
-     * @param path - Existing directory path in any spelling.
+     * @param path - Existing directory path in a fully qualified spelling.
      * @returns the workspace owning the canonical path, when one exists.
      */
     resolveByPath(path: string): Promise<Workspace | undefined>;
@@ -151,6 +151,8 @@ export declare class WorkspaceRegistry extends Service {
     private replaceHeaderIndex;
     private indexHeaders;
     private indexHeader;
+    /** Every stored session's header, projected from the persistence snapshot listing. */
+    private listStoredHeaders;
     private indexLiveSessions;
     private reportFilteredCandidates;
     private readSessionHeader;

package/lib/types/index.js

@@ -6,11 +6,10 @@
  */
 import { randomUUID } from 'node:crypto';
 import { stat } from 'node:fs/promises';
-import { basename } from 'node:path';
 import { Service } from '@prettier-ai/cordis';
 import { WorkspaceEntity } from "./entity.js";
 export { WorkspaceMoveInvalidError } from "./entity.js";
-import { realpathNormalize } from "./paths.js";
+import { defaultWorkspaceTitle, realpathNormalize } from "./paths.js";
 import { workspaceDomainSpec } from "./spec.js";
 export { workspaceDomainState, workspaceRecord, workspaceDomainSpec } from "./spec.js";
 export { realpathNormalize } from "./paths.js";
@@ -90,12 +89,12 @@ export class WorkspaceRegistry extends Service {
         await this.recoverPendingMutation();
         this.validateStoredState(this.state);
         if (!this.state.initialized) {
-            const headers = await this.ctx.sessionPersistence.list();
+            const headers = await this.listStoredHeaders();
             await this.replaceHeaderIndex(headers);
             await this.bootstrap(headers);
         }
         else if (this.table.size > 0) {
-            await this.replaceHeaderIndex(await this.ctx.sessionPersistence.list());
+            await this.replaceHeaderIndex(await this.listStoredHeaders());
         }
         await this.indexLiveSessions();
         this.validateStoredState(this.requireState());
@@ -103,13 +102,13 @@ export class WorkspaceRegistry extends Service {
         this.reportFilteredCandidates();
     }
     /**
-     * Create or reuse a workspace for an existing directory. The path is
-     * canonicalized through `fs.realpath`; a nonexistent path rejects with the
-     * original error and a non-directory rejects. Repeated calls for the same
-     * canonical path return the existing entity without changing its title.
+     * Create or reuse a workspace for an existing directory. The fully qualified
+     * path is canonicalized through `fs.realpath`; a relative, nonexistent, or
+     * non-directory path rejects. Repeated calls for the same canonical path
+     * return the existing entity without changing its title.
      * A newly created workspace is prepended to the durable registry order.
      * Different canonical paths may share a display title.
-     * @param path - Existing directory to own, in any path spelling.
+     * @param path - Existing directory to own, in a fully qualified path spelling.
      * @param title - Display title used only when a new record is created.
      * @returns the existing or newly durable workspace.
      */
@@ -225,14 +224,14 @@ export class WorkspaceRegistry extends Service {
             return true;
         if (this.headers.has(id))
             return true;
-        await this.indexHeaders(await this.ctx.sessionPersistence.list());
+        await this.indexHeaders(await this.listStoredHeaders());
         return this.headers.has(id);
     }
     /**
      * Resolve by canonical directory path without creating or mutating a
      * workspace. A missing path rejects during `realpath`; an existing unowned
      * directory returns `undefined`.
-     * @param path - Existing directory path in any spelling.
+     * @param path - Existing directory path in a fully qualified spelling.
      * @returns the workspace owning the canonical path, when one exists.
      */
     async resolveByPath(path) {
@@ -248,7 +247,7 @@ export class WorkspaceRegistry extends Service {
             if (entity.path === canonical)
                 return entity;
         }
-        const workspaceName = title ?? basename(canonical);
+        const workspaceName = title ?? defaultWorkspaceTitle(canonical);
         const table = this.requireTable();
         const state = this.requireState();
         const id = WorkspaceId(randomUUID());
@@ -413,7 +412,7 @@ export class WorkspaceRegistry extends Service {
                 const createdAt = new Date(group.newestAt).toISOString();
                 const record = {
                     path: group.path,
-                    title: basename(group.path),
+                    title: defaultWorkspaceTitle(group.path),
                     sessionIds,
                     createdAt,
                     updatedAt: createdAt,
@@ -532,6 +531,11 @@ export class WorkspaceRegistry extends Service {
             this.invalidSessionPaths.set(header.id, `cwd '${header.cwd}' does not resolve`);
         }
     }
+    /** Every stored session's header, projected from the persistence snapshot listing. */
+    async listStoredHeaders() {
+        const snapshots = await this.ctx.sessionPersistence.list();
+        return snapshots.map(snapshot => snapshot.header);
+    }
     async indexLiveSessions() {
         const sessions = this.ctx.get('sessions');
         if (sessions === undefined)
@@ -562,7 +566,7 @@ export class WorkspaceRegistry extends Service {
         const cached = this.headers.get(id);
         if (cached !== undefined)
             return cached;
-        const headers = await this.ctx.sessionPersistence.list();
+        const headers = await this.listStoredHeaders();
         await this.indexHeaders(headers);
         const header = this.headers.get(id);
         if (header === undefined) {

package/lib/types/paths.d.ts

@@ -3,14 +3,30 @@
  * @module @prettier-ai/dsh-workspace/src/paths
  */
 /**
- * Canonicalize a directory path via `fs.realpath`: trailing slashes, `..`
- * segments, and symlinks are all resolved. This is the ONE uniqueness canon of
- * the package — workspace paths are stored canonicalized, uniqueness is
- * string equality of canonicalized paths (a symlink to an existing
- * workspace's directory collides), and attach-time session `cwd` checks go
- * through the same canon. A path that does not exist rejects with the
- * original `ENOENT` — this is `create`'s reject path (a workspace must point
- * at an existing directory).
+ * Check whether a path names one fixed Host location without process cwd or
+ * current-drive resolution.
+ * @param path - Candidate Workspace path.
+ * @param platform - Host platform; injectable for deterministic path tests.
+ * @returns Whether the path is fully qualified on that platform.
+ */
+export declare function fullyQualifiedWorkspacePath(path: string, platform?: NodeJS.Platform): boolean;
+/**
+ * Derive a non-empty default title from a canonical Workspace path.
+ * @param path - Canonical Workspace path.
+ * @param platform - Host platform; injectable for deterministic path tests.
+ * @returns The final segment when present, otherwise the complete root spelling.
+ */
+export declare function defaultWorkspaceTitle(path: string, platform?: NodeJS.Platform): string;
+/**
+ * Canonicalize a fully qualified directory path via `fs.realpath`: trailing
+ * slashes, `..` segments, and symlinks are all resolved. This is the ONE
+ * uniqueness canon of the package — workspace paths are stored canonicalized,
+ * uniqueness is string equality of canonicalized paths (a symlink to an
+ * existing workspace's directory collides), and attach-time session `cwd`
+ * checks go through the same canon. Relative paths reject before `realpath` can
+ * resolve them from the Host cwd or current Windows drive. A path that does not
+ * exist rejects with the original `ENOENT` — this is `create`'s reject path (a
+ * workspace must point at an existing directory).
  * @param path - The path to canonicalize.
  * @returns the canonical absolute path.
  */

package/lib/types/paths.js

@@ -3,19 +3,47 @@
  * @module @prettier-ai/dsh-workspace/src/paths
  */
 import { realpath } from 'node:fs/promises';
+import { posix, win32 } from 'node:path';
 /**
- * Canonicalize a directory path via `fs.realpath`: trailing slashes, `..`
- * segments, and symlinks are all resolved. This is the ONE uniqueness canon of
- * the package — workspace paths are stored canonicalized, uniqueness is
- * string equality of canonicalized paths (a symlink to an existing
- * workspace's directory collides), and attach-time session `cwd` checks go
- * through the same canon. A path that does not exist rejects with the
- * original `ENOENT` — this is `create`'s reject path (a workspace must point
- * at an existing directory).
+ * Check whether a path names one fixed Host location without process cwd or
+ * current-drive resolution.
+ * @param path - Candidate Workspace path.
+ * @param platform - Host platform; injectable for deterministic path tests.
+ * @returns Whether the path is fully qualified on that platform.
+ */
+export function fullyQualifiedWorkspacePath(path, platform = process.platform) {
+    if (platform !== 'win32')
+        return posix.isAbsolute(path);
+    const root = win32.parse(path).root;
+    return win32.isAbsolute(path) && root !== '\\' && root !== '/';
+}
+/**
+ * Derive a non-empty default title from a canonical Workspace path.
+ * @param path - Canonical Workspace path.
+ * @param platform - Host platform; injectable for deterministic path tests.
+ * @returns The final segment when present, otherwise the complete root spelling.
+ */
+export function defaultWorkspaceTitle(path, platform = process.platform) {
+    const pathApi = platform === 'win32' ? win32 : posix;
+    return pathApi.basename(path) || pathApi.parse(path).root;
+}
+/**
+ * Canonicalize a fully qualified directory path via `fs.realpath`: trailing
+ * slashes, `..` segments, and symlinks are all resolved. This is the ONE
+ * uniqueness canon of the package — workspace paths are stored canonicalized,
+ * uniqueness is string equality of canonicalized paths (a symlink to an
+ * existing workspace's directory collides), and attach-time session `cwd`
+ * checks go through the same canon. Relative paths reject before `realpath` can
+ * resolve them from the Host cwd or current Windows drive. A path that does not
+ * exist rejects with the original `ENOENT` — this is `create`'s reject path (a
+ * workspace must point at an existing directory).
  * @param path - The path to canonicalize.
  * @returns the canonical absolute path.
  */
 export async function realpathNormalize(path) {
+    if (!fullyQualifiedWorkspacePath(path)) {
+        throw new TypeError(`Workspace path is not fully qualified: '${path}'`);
+    }
     return await realpath(path);
 }
 //# sourceMappingURL=paths.js.map

package/lib/types/types.d.ts

@@ -34,7 +34,7 @@ export interface Workspace {
      * afterwards, even when the directory disappears (see {@link status}).
      */
     readonly path: string;
-    /** Display title. Defaults to `basename(path)` at create; duplicates are allowed. */
+    /** Display title. Defaults to the final path segment, or a filesystem root's own spelling; duplicates are allowed. */
     readonly title: string;
     /** ISO-8601 creation instant, stamped at create and never rewritten. */
     readonly createdAt: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@prettier-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.2-rc.1",
+  "version": "0.1.3-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -37,25 +37,25 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@prettier-ai/dsh-invariants": "^0.1.2-rc.1",
     "@prettier-ai/cordis": "^4.0.2",
-    "@prettier-ai/dsh-session-persistence": "^0.1.2-rc.1",
-    "@prettier-ai/dsh-storage": "^0.1.2-rc.1",
-    "@prettier-ai/dsh-session": "^0.1.2-rc.1",
-    "@prettier-ai/dsh-storage-domain": "^0.1.2-rc.1",
-    "@prettier-ai/dsh-typert-protocol": "^0.1.2-rc.1"
+    "@prettier-ai/dsh-invariants": "^0.1.3-alpha.1",
+    "@prettier-ai/dsh-session-persistence": "^0.1.3-alpha.1",
+    "@prettier-ai/dsh-storage": "^0.1.3-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.3-alpha.1",
+    "@prettier-ai/dsh-storage-domain": "^0.1.3-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.3-alpha.1"
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@prettier-ai/dsh-brand": "^0.1.2-rc.1"
+    "@prettier-ai/dsh-brand": "^0.1.3-alpha.1"
   },
   "devDependencies": {
     "@prettier-ai/cordis": "^4.0.2",
-    "@prettier-ai/dsh-session-persistence": "^0.1.2-rc.1",
-    "@prettier-ai/dsh-invariants": "^0.1.2-rc.1",
-    "@prettier-ai/dsh-storage": "^0.1.2-rc.1",
-    "@prettier-ai/dsh-session": "^0.1.2-rc.1",
-    "@prettier-ai/dsh-storage-domain": "^0.1.2-rc.1",
-    "@prettier-ai/dsh-typert-protocol": "^0.1.2-rc.1"
+    "@prettier-ai/dsh-session": "^0.1.3-alpha.1",
+    "@prettier-ai/dsh-storage": "^0.1.3-alpha.1",
+    "@prettier-ai/dsh-session-persistence": "^0.1.3-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.3-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.3-alpha.1",
+    "@prettier-ai/dsh-storage-domain": "^0.1.3-alpha.1"
   }
 }