dsh-workspace-mover 2.4.1 → 2.4.3

package/lib/index.js

@@ -36,6 +36,7 @@ import { join, dirname, basename, relative, resolve, isAbsolute } from 'node:pat
 import { homedir } from 'node:os';
 import { spawn } from 'node:child_process';
 import { Config, POLICY_FIELDS, buildConfig, attachConfig } from './config.js';
+import { installLifecycle, lifecycleFor, withReleasedSession } from './lifecycle.js';
 
 const name = 'workspace-mover';
 // 只声明真正必需的两个服务。cordis 把 inject 里的**每一项**都当必需：任一缺失，
@@ -913,7 +914,9 @@ async function moveSessionEntry(ctx, payload = {}, hooks = {}) {
 		`workspace:${targetWorkspaceId}`
 	);
 	try {
-		return await moveSession(ctx, { ...payload, sessionId, targetWorkspaceId }, hooks);
+		if (!ctx.workspaceRegistry?.get(targetWorkspaceId)) throw new Error(`unknown workspace '${targetWorkspaceId}'`);
+		return await withReleasedSession(ctx, sessionId, payload.stopRunning === true,
+			() => moveSession(ctx, { ...payload, sessionId, targetWorkspaceId }, hooks));
 	} finally {
 		release();
 	}
@@ -955,7 +958,7 @@ async function moveSession(ctx, { sessionId, targetWorkspaceId, sessionTitle, re
 	const sourceCwd = meta.cwd;
 	const title = typeof sessionTitle === 'string' && sessionTitle.trim()
 		? sessionTitle.trim()
-		: (typeof meta.title === 'string' && meta.title.trim() ? meta.title.trim() : '未命名会话');
+		: readSessionTitle(ctx, sessionId, readProjectionTitles().get(String(sessionId)) ?? meta.title ?? '未命名会话');
 	if (sourceCwd === undefined) throw new Error('session header carries no cwd');
 	if (samePath(sourceCwd, targetPath)) {
 		// 磁盘头已指向目标：若目标工作区还没记账它（历史遗留的未归组会话），
@@ -1129,7 +1132,11 @@ async function moveSession(ctx, { sessionId, targetWorkspaceId, sessionTitle, re
 	// 才会读取 header 并经 mutate 发出 domain/changed。不能直接预置
 	// target.record.sessionIds，否则 attach 变成 no-op，WorkspaceFeed 不会推送目标
 	// 工作区的更新帧，浏览器就会暂时把会话显示在“未分组”。
+	const originalProjection = captureProjection(ctx, sessionId);
 	try {
+		// Listings can read the title during attach: align BEFORE publishing the
+		// new header, otherwise the host rejects the old cwd-bound checkpoint.
+		await realignProjectionIdentity(ctx, sessionId, targetPath);
 		await target.attachSession(sessionId);
 	} catch (err) {
 		// Roll back original bytes and reattach the source workspace.
@@ -1142,6 +1149,7 @@ async function moveSession(ctx, { sessionId, targetWorkspaceId, sessionTitle, re
 				throw new Error(`physical rollback could not move the target directory: ${relocateErr?.message ?? relocateErr}`);
 			}
 			await storage.replace(sourceLocation, original);
+			await writeProjection(ctx, String(sessionId), originalProjection, sourceCwd, true);
 			for (const e of allOwners) {
 				try { if (!rawRecordSessionIds(e).includes(String(sessionId))) await e.attachSession?.(sessionId); } catch { /* ignore */ }
 			}
@@ -1400,6 +1408,26 @@ function readProjectionTitles() {
 	return map;
 }
 
+/** Current hosts use per-record checkpoints; legacy aggregate files can remain
+ * on disk after an upgrade and must never override a current title. */
+function readSessionTitle(ctx, sessionId, fallback = null) {
+	const titleOf = (record) => {
+		const title = record?.rows?.title?.val;
+		return typeof title === 'string' && title.trim() ? title.trim() : null;
+	};
+	const live = titleOf(captureProjection(ctx, sessionId));
+	if (live) return live;
+	try {
+		const id = validId(String(sessionId), 'sessionId');
+		if (/[\\/:]/.test(id) || id === '.' || id === '..') return fallback;
+		const base = process.env.DSH_HOME ?? join(homedir(), '.dsh');
+		const document = JSON.parse(readFileSync(join(base, 'storages', 'session_projcache', 'sessions', `${id}.json`), 'utf8'));
+		const current = titleOf(document?.record);
+		if (current) return current;
+	} catch { /* Cache absence/corruption must not prevent session rescue. */ }
+	return fallback;
+}
+
 /**
  * 扫描存储根下的全部会话档案并分类：
  * - orphaned    头部 cwd 指向的目录已不存在（项目文件夹被移动/改名/删除，官方讨论 #3012）
@@ -1504,8 +1532,8 @@ async function scanSessions(ctx) {
 			: 'misfiled'; // 记账方存在但不是 cwd 匹配的分组
 		items.push({
 			sessionId,
-			title: projectionTitles.get(sessionId)
-				?? (typeof header?.title === 'string' && header.title.trim() ? header.title.trim() : '未命名会话'),
+			title: readSessionTitle(ctx, sessionId, projectionTitles.get(sessionId)
+				?? (typeof header?.title === 'string' && header.title.trim() ? header.title.trim() : '未命名会话')),
 			cwd,
 			status,
 			targetWorkspaceId: matching?.id ?? null,
@@ -1522,6 +1550,13 @@ async function scanSessions(ctx) {
 	}
 
 	const ghosts = [];
+	// Include all discovered archives, even those outside the parsed scan limit.
+	const archiveLocations = new Map();
+	for (const { idDir, artifact } of metas) {
+		const paths = archiveLocations.get(String(idDir)) ?? [];
+		paths.push(artifact);
+		archiveLocations.set(String(idDir), paths);
+	}
 	for (const entity of entities) {
 		let ids = [];
 		// 幽灵正是「有账无档」的 id，而官方公开的 sessionIds getter 会把它们
@@ -1529,7 +1564,11 @@ async function scanSessions(ctx) {
 		try { ids = rawRecordSessionIds(entity); } catch { continue; }
 		for (const id of ids) {
 			try {
-				if (!existsSync(artifactPath(root, entity.path, id, compression))) ghosts.push({ workspaceId: entity.id, sessionId: String(id) });
+				if (!existsSync(artifactPath(root, entity.path, id, compression))) {
+					const locations = archiveLocations.get(String(id)) ?? [];
+					ghosts.push({ workspaceId: entity.id, sessionId: String(id), locations,
+						status: locations.length ? 'found-elsewhere' : 'location-unknown', archived: archived.has(String(id)) });
+				}
 			} catch { /* skip */ }
 		}
 	}
@@ -1615,12 +1654,8 @@ function invalidateFileReferenceSearches(ctx, stalePath) {
  */
 async function realignProjectionIdentity(ctx, sessionId, nextCwd) {
 	try {
-		const table = peekService(ctx, 'sessionProjectionCache')?.table;
-		if (typeof table?.update !== 'function') return;
-		await table.update(String(sessionId), (rec) =>
-			rec?.identity ? { ...rec, identity: { ...rec.identity, cwd: nextCwd },
-				rows: Object.fromEntries(Object.entries(rec.rows ?? {}).filter(([key]) => key !== 'workingDirectory')) } : rec
-		);
+		const record = captureProjection(ctx, sessionId);
+		await writeProjection(ctx, String(sessionId), record, nextCwd);
 	} catch (err) {
 		ctx.logger?.warn?.(`workspace-mover: projection identity alignment failed for ${sessionId}: ${err?.message ?? err}`);
 	}
@@ -1999,13 +2034,16 @@ async function inspectMovePlan(ctx, { sessionId, targetWorkspaceId, mode = 'curr
 	const repairMembership = sameWorkspace && !rawRecordSessionIds(target).includes(id);
 	let backupPlan = { reused: false, estimatedBytes: 0 };
 	let status = 'safe';
+	const liveMigration = Boolean(lifecycleFor(ctx, id));
 	if (running) {
-		status = 'queued';
-		warnings.push('session is currently running and will wait for idle');
+		status = 'warning';
+		warnings.push('session is running; moving requires explicit stop confirmation');
 	}
 	try { assertNoResidentWriter(ctx, id); } catch (err) {
-		status = 'queued';
-		warnings.push(err.message);
+		if (!liveMigration) {
+			status = 'queued';
+			warnings.push(err.message);
+		}
 	}
 	if (adapter.mode === 'filesystem-fallback') warnings.push('physical move uses the JSONL path fallback; official raw-byte path API is unavailable');
 	if (!adapter.capabilities.physicalPath) {
@@ -2054,10 +2092,11 @@ async function inspectMovePlan(ctx, { sessionId, targetWorkspaceId, mode = 'curr
 		status,
 		canMove: status === 'safe' || status === 'warning' || status === 'queued',
 		sessionId: id,
-		title: readProjectionTitles().get(id) ?? meta.title ?? null,
+		title: readSessionTitle(ctx, id, readProjectionTitles().get(id) ?? meta.title ?? null),
 		source,
 		target: targetInfo,
 		running,
+		liveMigration,
 		branches: { available: true, count: branches.relations.length, mode, sessionIds: branches.ids, relations: branches.relations },
 		estimatedBackupBytes: sameWorkspace ? 0 : backupPlan.estimatedBytes,
 		backup: sameWorkspace ? { reused: false, estimatedBytes: 0 } : backupPlan,
@@ -2067,7 +2106,7 @@ async function inspectMovePlan(ctx, { sessionId, targetWorkspaceId, mode = 'curr
 }
 
 /** 批量迁移入口：逐会话复用 moveSession（各自独立备份/回滚，单条失败不牵连其余）；历史聚合成一条。 */
-async function moveManySessions(ctx, { sessions, targetWorkspaceId, mode = 'current-only' } = {}) {
+async function moveManySessions(ctx, { sessions, targetWorkspaceId, mode = 'current-only', stopRunning = false, allowQueue = true } = {}) {
 	if (!Array.isArray(sessions) || sessions.length === 0) throw new Error('sessions must be a non-empty array');
 	if (sessions.length > batchLimit()) throw new Error(`too many sessions in one batch (max ${batchLimit()}, got ${sessions.length})`);
 	if (typeof targetWorkspaceId !== 'string' || targetWorkspaceId.length === 0) throw new Error('targetWorkspaceId required');
@@ -2113,7 +2152,8 @@ async function moveManySessions(ctx, { sessions, targetWorkspaceId, mode = 'curr
 				sessionId,
 				targetWorkspaceId,
 				sessionTitle: typeof item.sessionTitle === 'string' ? item.sessionTitle : undefined,
-				recordHistory: false
+				recordHistory: false,
+				stopRunning
 			});
 			if (result.attached) attachedCount += 1; else movedCount += 1;
 			let sourceWorkspaceId = null;
@@ -2123,7 +2163,7 @@ async function moveManySessions(ctx, { sessions, targetWorkspaceId, mode = 'curr
 			moved.push({ sessionId, title: result.title, fromCwd: result.from.cwd, sourceWorkspaceId, backup: result.backup ?? null });
 			results.push({ sessionId, ok: true, moved: result.moved, to: result.to.cwd, title: result.title });
 		} catch (err) {
-			if (isBusyError(err)) {
+			if (allowQueue && isBusyError(err)) {
 				const queued = createOrReuseMigration(ctx, {
 					sessionId,
 					targetWorkspaceId,
@@ -3196,14 +3236,14 @@ async function dropProjection(ctx, sessionId) {
 	}
 }
 
-async function writeProjection(ctx, sessionId, record, cwd) {
+async function writeProjection(ctx, sessionId, record, cwd, preserveWorkingDirectory = false) {
 	try {
 		const table = projectionTable(ctx);
 		if (!table || typeof table.put !== 'function' || !record?.identity || !record?.rows) return;
 		// 注意：table 是底层 KvTable，put(key, value) 两参——value 必须是完整 {identity, rows}；
 		// 服务层的 put(id, identity, rows) 三参签名在这里不可用（会整条写坏，域重开时崩）。
 		await table.put(String(sessionId), { identity: { ...record.identity, cwd },
-			rows: Object.fromEntries(Object.entries(record.rows).filter(([key]) => key !== 'workingDirectory')) });
+			rows: preserveWorkingDirectory ? record.rows : Object.fromEntries(Object.entries(record.rows).filter(([key]) => key !== 'workingDirectory')) });
 	} catch (err) {
 		ctx.logger?.warn?.(`workspace-mover: projection restore failed for ${sessionId} (title will rebuild lazily): ${err?.message ?? err}`);
 	}
@@ -3308,7 +3348,26 @@ async function deleteSessionToTrash(ctx, payload = {}, hooks = {}) {
 	const sessionId = validId(payload?.sessionId, 'sessionId');
 	const release = acquireLocks(`session:${sessionId}`);
 	try {
-		return await deleteSessionToTrashLocked(ctx, sessionId, { ...hooks, purgeBackups: payload?.purgeBackups === true });
+		assertNotRunning(ctx, sessionId);
+		if (peekService(ctx, 'sessions')?.get?.(sessionId) !== undefined && !lifecycleFor(ctx, sessionId)) {
+			throw new Error('session is resident in memory without a tracked lifecycle handle; restart the harness before deleting');
+		}
+		// Disposing the Agent may remove its projection; preserve display metadata first.
+		const projection = captureProjection(ctx, sessionId);
+		const title = readSessionTitle(ctx, sessionId, null);
+		return await withReleasedSession(ctx, sessionId, false,
+			() => deleteSessionToTrashLocked(ctx, sessionId, { ...hooks, projection, title, purgeBackups: payload?.purgeBackups === true }), {
+				reloadOnSuccess: false,
+				// A failed rollback must never resume a missing archive as a blank session.
+				canReload: async () => {
+					try {
+						const location = await locateArtifact(ctx, sessionId);
+						const storage = createPersistenceAdapter(ctx);
+						const header = readHeader(await storage.read(location), storage.compression);
+						return String(header?.id) === String(sessionId);
+					} catch { return false; }
+				}
+			});
 	} finally {
 		release();
 	}
@@ -3328,7 +3387,7 @@ async function deleteSessionToTrashLocked(ctx, sessionId, hooks = {}) {
 	const { artifact, cwd: artifactCwd } = location;
 	const header = readHeader(await storage.read(location), storage.compression);
 	const archived = readArchivedIds(registry).includes(sessionId);
-	const projection = captureProjection(ctx, sessionId);
+	const projection = hooks.projection ?? captureProjection(ctx, sessionId);
 	const owners = listOwners(registry, sessionId);
 	const entryDir = join(recycleDir(), `${Date.now()}-${String(sessionId).replace(/[^A-Za-z0-9._-]/g, '_')}`);
 	mkdirSync(entryDir, { recursive: true });
@@ -3343,7 +3402,7 @@ async function deleteSessionToTrashLocked(ctx, sessionId, hooks = {}) {
 	const manifest = {
 		version: 1,
 		sessionId: String(sessionId),
-		title: typeof header?.title === 'string' && header.title.trim() ? header.title.trim() : null,
+		title: hooks.title ?? (typeof header?.title === 'string' && header.title.trim() ? header.title.trim() : null),
 		cwd: artifactCwd ?? header?.cwd ?? null,
 		ownerWorkspaceId: owners[0]?.id ?? null,
 		ownerTitle: owners[0]?.title ?? null,
@@ -3364,6 +3423,7 @@ async function deleteSessionToTrashLocked(ctx, sessionId, hooks = {}) {
 				lastError: `manifest write failed (${err?.message ?? err}) AND move-back failed (${backErr?.message ?? backErr}) — files remain under ${entryDir}`
 			});
 			ctx.logger?.warn?.(`workspace-mover: manifest write failed AND move-back failed for ${sessionId}: ${backErr?.message ?? backErr} — files remain under ${entryDir}`);
+			throw new Error(`manifest write failed AND rollback failed; session files preserved under ${entryDir}: ${backErr?.message ?? backErr}`);
 		}
 		try { rmSync(entryDir, { recursive: true, force: true }); } catch { /* ignore */ }
 		throw new Error(`manifest write failed, session moved back: ${err?.message ?? err}`);
@@ -3477,7 +3537,7 @@ async function restoreFromTrashLocked(ctx, sessionId, targetWorkspaceId) {
 	}
 	// 先移回原位（头 cwd 与原位一致，attach 校验天然通过）
 	await storage.relocate(trashLocation, dirname(originalLocation.artifact));
-	let restored = { restored: true, sessionId: String(sessionId), cwd: originalCwd, workspaceId: targetEntity?.id ?? null, moved: null };
+	let restored = { restored: true, sessionId: String(sessionId), cwd: originalCwd, workspaceId: targetEntity?.id ?? null, archived: Boolean(manifest.archived), moved: null };
 	try {
 		if (targetEntity && !samePath(originalCwd, destPath)) {
 			// 原位只是中转：直接走现有 moveSession 全管线（备份/改写/热修/记账全套）
@@ -3537,7 +3597,7 @@ async function listBackups(ctx) {
 		const { id, ts } = parsed;
 		let sizeBytes = 0;
 		try { sizeBytes = statSync(join(dir, name)).size; } catch { continue; }
-		const g = groups.get(id) ?? { sessionId: id, title: titles.get(id) ?? null, count: 0, totalBytes: 0, oldest: Number(ts), newest: Number(ts), files: [] };
+		const g = groups.get(id) ?? { sessionId: id, title: readSessionTitle(ctx, id, titles.get(id) ?? null), count: 0, totalBytes: 0, oldest: Number(ts), newest: Number(ts), files: [] };
 		g.count++;
 		g.totalBytes += sizeBytes;
 		g.oldest = Math.min(g.oldest, Number(ts));
@@ -4177,6 +4237,7 @@ async function runDoctor(ctx, agentToolsState) {
 
 export function apply(ctx) {
 	const logger = ctx.logger ?? console;
+	ctx.inject?.(['agents'], (owner) => installLifecycle(ctx, owner));
 	const dispatchRef = { fn: null }; // agent 工具在调用期才用到 dispatch，挂载时序无关
 	const agentToolsState = { registered: false };
 	const mount = (owner) => {
@@ -4271,15 +4332,15 @@ export function apply(ctx) {
 							return ok(await moveManySessions(ctx, {
 								sessions: [{ sessionId, sessionTitle: payload?.sessionTitle }],
 								targetWorkspaceId,
-								mode: 'include-descendants'
+								mode: 'include-descendants', stopRunning: payload?.stopRunning === true, allowQueue: payload?.allowQueue !== false
 							}));
 						}
-						const result = await moveSessionEntry(ctx, { sessionId, targetWorkspaceId, sessionTitle: payload?.sessionTitle });
+						const result = await moveSessionEntry(ctx, { sessionId, targetWorkspaceId, sessionTitle: payload?.sessionTitle, stopRunning: payload?.stopRunning === true });
 						logger.info?.(`workspace-mover: moved ${sessionId} -> ${result.to.cwd}`);
 						return ok(result);
 					} catch (err) {
 						logger.warn?.(`workspace-mover: MOVE FAILED sessionId=${payload?.sessionId} target=${payload?.targetWorkspaceId}: ${err?.message ?? err}`);
-						if (isBusyError(err) && typeof payload?.sessionId === 'string' && typeof payload?.targetWorkspaceId === 'string') {
+						if (payload?.allowQueue !== false && isBusyError(err) && typeof payload?.sessionId === 'string' && typeof payload?.targetWorkspaceId === 'string') {
 							const queued = createOrReuseMigration(ctx, {
 								sessionId: payload.sessionId,
 								targetWorkspaceId: payload.targetWorkspaceId,

package/lib/lifecycle.js

@@ -0,0 +1,104 @@
+// Retain the public create/resume disposer. Never close a borrowed persistence
+// writer or rewrite an immutable live Session header.
+import { AsyncLocalStorage } from 'node:async_hooks';
+const migrationContext = new AsyncLocalStorage();
+const original = Symbol.for('cordis.original');
+const runtimes = new WeakMap();
+const raw = (value) => value?.[original] ?? value;
+
+function blocked() {
+	const error = new Error('This session is being migrated; retry after migration completes.');
+	error.code = 'migration-in-progress';
+	return error;
+}
+
+export function installLifecycle(ctx, owner) {
+	const agents = raw(owner.agents);
+	if (!agents || runtimes.has(agents)) return;
+	const runtime = { handles: new Map(), moving: new Set() };
+	runtimes.set(agents, runtime);
+	const restore = [];
+	for (const method of ['create', 'resume']) {
+		const fn = agents[method];
+		if (typeof fn !== 'function') continue;
+		const wrapped = async function (options, ...args) {
+			const id = options?.resumeSessionId ?? options?.sessionId;
+			if (runtime.moving.has(id) && migrationContext.getStore() !== runtime) throw blocked();
+			const handle = await Reflect.apply(fn, this, [options, ...args]);
+			const agent = raw(handle?.agent);
+			if (agent && typeof handle.dispose === 'function') {
+				const guards = [];
+				runtime.handles.set(agent.id, { handle, agent, guards });
+				// Requests that already resolved the old Agent must also be refused
+				// while its lifecycle is draining or after it has been replaced.
+				for (const entry of ['send', 'runMaintenance']) {
+					const action = agent[entry];
+					if (typeof action !== 'function') continue;
+					const guarded = function (...params) {
+						if (runtime.moving.has(agent.id) || raw(agents.get(agent.id)) !== agent) throw blocked();
+						return Reflect.apply(action, this, params);
+					};
+					agent[entry] = guarded;
+					guards.push(() => { if (agent[entry] === guarded) agent[entry] = action; });
+				}
+			}
+			return handle;
+		};
+		agents[method] = wrapped;
+		restore.push(() => { if (agents[method] === wrapped) agents[method] = fn; });
+	}
+	owner.on?.('agent/disposed', ({ agent }) => {
+		if (runtime.handles.get(agent.id)?.agent === raw(agent)) runtime.handles.delete(agent.id);
+	});
+	owner.effect(() => () => {
+		for (const entry of runtime.handles.values()) for (const undo of entry.guards) undo();
+		runtime.handles.clear();
+		for (const undo of restore.reverse()) undo();
+		runtimes.delete(agents);
+	}, 'workspace-mover: restore lifecycle observers');
+}
+
+export function lifecycleFor(ctx, id) {
+	const agents = raw(typeof ctx.get === 'function' ? ctx.get('agents') : ctx.agents);
+	const runtime = agents && runtimes.get(agents);
+	const entry = runtime?.handles.get(id);
+	return entry && raw(agents.get(id)) === entry.agent ? { ...entry, runtime, agents } : null;
+}
+
+export async function withReleasedSession(ctx, id, stopRunning, operation, { reloadOnSuccess = true, canReload = () => true } = {}) {
+	const owned = lifecycleFor(ctx, id);
+	if (!owned) return operation();
+	const { handle, agent, runtime } = owned;
+	if (agent.status === 'running' && !stopRunning) {
+		const error = new Error('Session is running. Confirm stop and move, or cancel migration.');
+		error.code = 'stop-required';
+		throw error;
+	}
+	if (agent.session.header?.parentSession || agent.session.header?.origin === 'subagent') {
+		throw new Error('Live subagent migration is unsupported; stop its owning task first.');
+	}
+	runtime.moving.add(id);
+	let result;
+	let failure;
+	try {
+		await handle.dispose(); // owns cancel → drain → close → unregister
+		result = await operation();
+	} catch (error) {
+		failure = error;
+	} finally {
+		runtime.handles.delete(id);
+		try {
+			const controller = ctx.get?.('sessionController');
+			if ((failure || reloadOnSuccess) && await canReload() && typeof controller?.resolveAgent === 'function') {
+				const restored = await migrationContext.run(runtime, () => controller.resolveAgent(id));
+				if (restored?.error) throw restored.error;
+			}
+		} catch (error) {
+			failure = new Error(`${failure ? failure.message : 'Files migrated successfully'}; session reload failed: ${error.message}`, { cause: error });
+		} finally {
+			runtime.moving.delete(id);
+		}
+	}
+	if (failure) throw failure;
+	return result;
+}

package/package.json

@@ -1,103 +1,104 @@
-{
-  "name": "dsh-workspace-mover",
-  "version": "2.4.1",
-  "description": "在 DSH 侧边栏安全迁移会话：真迁移原始档案，支持失联会话恢复、移动历史、一键撤回和 agent 工具。",
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./client/client.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "client",
-    "test",
-    "cordis.patch.yml",
-    "README.md",
-    "README_EN.md",
-    "CHANGELOG.md",
-    "docs/ARCHITECTURE.md",
-    "docs/compatibility",
-    "docs/media",
-    "LICENSE"
-  ],  "scripts": {
-    "test": "node --test test/core.test.mjs test/e2e-sandbox.test.mjs test/policy.test.mjs test/client-dom.test.mjs test/traffic-badge.test.mjs test/release-downloads.test.mjs test/workspace-tools.test.mjs test/host-services.test.mjs",
-    "test:installed-host": "node --test test/installed-host.test.mjs",
-    "check:syntax": "node --check lib/index.js && node --check client/client.js",
-    "check:pack": "npm pack --dry-run",
-    "check": "npm run check:syntax && npm test && npm run check:pack"
-  },
-  "keywords": [
-    "deepseek-harness",
-    "dsh",
-    "dsh-plugin",
-    "workspace",
-    "session",
-    "session-migration",
-    "drag-and-drop",
-    "agent-tools"
-  ],
-  "engines": {
-    "node": ">=22",
-    "dsh": ">=0.1.5-rc.1"
-  },
-  "//peerDependencies": "Deliberately `*`. These are OPTIONAL peers: the plugin declares them so storefronts can see the host packages it integrates with, but it fail-softs at runtime (mover.status capabilities + mover_doctor). npm's prerelease rule evaluates each `||` alternative as a set and only admits a prerelease when a comparator in that set shares the version's exact major.minor.patch tuple AND carries a prerelease tag -- so an upper bound like `<0.2.0-0` excludes EVERY 0.2.0 prerelease, which made the host report 2.2.0 as incompatible with 0.2.0-rc.2. Enumerating release lines would keep producing false incompatibilities on each new line; the real floor is engines.dsh, and capability flags report any actual runtime mismatch. Do NOT narrow these to version ranges.",
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "*",
-    "@deepseek-ai/dsh-session": "*",
-    "@deepseek-ai/dsh-tools": "*",
-    "@deepseek-ai/dsh-workspace": "*",
-    "@deepseek-ai/schemastery": "*",
-    "@deepseek-ai/dsh-client-connection": "*",
-    "@deepseek-ai/dsh-client-locale": "*",
-    "@deepseek-ai/dsh-client-ui-slots": "*"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-session": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-tools": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-workspace": {
-      "optional": true
-    },
-    "@deepseek-ai/schemastery": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-client-connection": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-client-locale": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-client-ui-slots": {
-      "optional": true
-    }
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/PianoPrince/dsh-workspace-mover.git"
-  },
-  "bugs": {
-    "url": "https://github.com/PianoPrince/dsh-workspace-mover/issues"
-  },
-  "homepage": "https://github.com/PianoPrince/dsh-workspace-mover#readme",
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-ui-slots"
-      ],
-      "platform": "web"
-    }
-  }
-}
+{
+  "name": "dsh-workspace-mover",
+  "version": "2.4.3",
+  "description": "在 DSH 侧边栏安全迁移会话：真迁移原始档案，支持失联会话恢复、移动历史、一键撤回和 agent 工具。",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./client/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "client",
+    "test",
+    "cordis.patch.yml",
+    "README.md",
+    "README_EN.md",
+    "CHANGELOG.md",
+    "docs/ARCHITECTURE.md",
+    "docs/compatibility",
+    "docs/media",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test test/core.test.mjs test/e2e-sandbox.test.mjs test/policy.test.mjs test/client-dom.test.mjs test/traffic-badge.test.mjs test/release-downloads.test.mjs test/workspace-tools.test.mjs test/host-services.test.mjs test/live-migration.test.mjs",
+    "test:installed-host": "node --test test/installed-host.test.mjs test/live-migration.test.mjs",
+    "check:syntax": "node --check lib/index.js && node --check client/client.js && node --check lib/lifecycle.js",
+    "check:pack": "npm pack --dry-run",
+    "check": "npm run check:syntax && npm test && npm run check:pack"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "workspace",
+    "session",
+    "session-migration",
+    "drag-and-drop",
+    "agent-tools"
+  ],
+  "engines": {
+    "node": ">=22",
+    "dsh": ">=0.1.5-rc.1"
+  },
+  "//peerDependencies": "Deliberately `*`. These are OPTIONAL peers: the plugin declares them so storefronts can see the host packages it integrates with, but it fail-softs at runtime (mover.status capabilities + mover_doctor). npm's prerelease rule evaluates each `||` alternative as a set and only admits a prerelease when a comparator in that set shares the version's exact major.minor.patch tuple AND carries a prerelease tag -- so an upper bound like `<0.2.0-0` excludes EVERY 0.2.0 prerelease, which made the host report 2.2.0 as incompatible with 0.2.0-rc.2. Enumerating release lines would keep producing false incompatibilities on each new line; the real floor is engines.dsh, and capability flags report any actual runtime mismatch. Do NOT narrow these to version ranges.",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/dsh-session": "*",
+    "@deepseek-ai/dsh-tools": "*",
+    "@deepseek-ai/dsh-workspace": "*",
+    "@deepseek-ai/schemastery": "*",
+    "@deepseek-ai/dsh-client-connection": "*",
+    "@deepseek-ai/dsh-client-locale": "*",
+    "@deepseek-ai/dsh-client-ui-slots": "*"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-workspace": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PianoPrince/dsh-workspace-mover.git"
+  },
+  "bugs": {
+    "url": "https://github.com/PianoPrince/dsh-workspace-mover/issues"
+  },
+  "homepage": "https://github.com/PianoPrince/dsh-workspace-mover#readme",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ],
+      "platform": "web"
+    }
+  }
+}