dsh-vscode-mode 0.21.2 → 0.21.3

package/README.md

@@ -477,19 +477,20 @@ DSH 每次启动监听随机端口，`http://127.0.0.1:<port>` 就是浏览器 o
 
 官方 `dsh plugin` 方式，三选一。下面以 `web` profile 为例；Desktop 或其他命名
 profile 请替换为实际目标，不要把示例目录当成当前运行 profile。升级前可阅读
+**v0.21.3** 的 MCP 初始化失败结果与安全收尾解耦：已进入 startup 的调用者在失败或截止时间到达时及时收到拒绝，不再等待旧资源收尾；旧 work/close 未确认完成前仍占冷启动名额、阻止同 key 重建，确认收尾后才开始冷却。首次偶发超时根因仍未知，排队和其他屏障仍可能无界；本版当前 Host/GUI 未部署未验证，用户仅本批接受官方实装隔离模块与 JS 套件替代验收，见 [0.21.3 发布说明](docs/release-0.21.3.md)。官方 bridge 隔离 fixture 同步迁移到当前公开 native 执行器及批调用契约，不代表生产执行器故障修复。以下为历史版本事实，不代表本版现场验收：
 **v0.21.2** 的新版 DSH 会话 Controller 与 MCP 公开工具目录适配：任务发送按目标会话持有生命周期，受理不明时不跨通道重发；文件范围引用的剪贴板与降级文本保留行区间；MCP 初始化失败增加脱敏持久化诊断。当前 Web Host 已完成真实 CodeGraph 调用，但首次连接偶发超时根因尚未证实，不宣称已修复，见 [0.21.2 发布说明](docs/release-0.21.2.md)。保留以下历史版本能力与验收边界：
 **v0.21.1** 修复缺失历史文件：按完整快照显示整文件删除，Keep 保留删除、Undo 安全恢复快照，预览只读且拒绝覆盖重新出现的文件；真实 GUI 验收缺口已明确保留，见 [0.21.1 发布说明](docs/release-0.21.1.md)。保留 **v0.21.0** 新增 XLSX 基础编辑与浏览器导出副本，原件不自动写回，高级应用通过官方 Host 打开；官方差异定位统一 BOM 与 LF/CRLF/混合行尾口径，并区分内容缺失和多处命中。定位修复不扩展 CRLF patch Undo 能力，目标官方记录 ↑/↓ 的真实点击验收仍保留缺口。保留 **v0.20.5** 跨 DSH 实例只读互通——桌面端与 Web 端各自运行独立宿主时，官方审查列表/详情与工作区只读接口改按持久化会话头的 cwd 解析，另一实例创建的会话也能只读打开官方差异栏，写入类接口仍要求本端活跃会话。保留 **v0.20.4** 统一两套差异栏外观——非官方记录栏角标由内部术语「侧车记录」改为「历史改动」，悬停说明 Keep 只标记已看过、不改写磁盘，Undo 逐项校验后写回，两者都不影响官方审查；官方元数据不可用时给出可读原因与重试按钮，不再静默降级；「会话没在当前端激活」由红色告警改为中性说明。保留 v0.20.3 修复官方差异全部无法定位时差异栏无提示、上下箭头静默禁用（显示「无可跳转」与失效原因，Keep 说明只标记已采纳、不改写磁盘，会话缺失等宿主错误改为可读提示）、v0.20.2 的 MCP 状态告警收敛与原生确认弹窗，以及 v0.20.1 的文件内差异展示、块级/文件级安全审查和跨分页批量操作。升级后重启 DSH 并刷新页面；持久化与回退边界见 [0.20.0 发布说明](docs/release-0.20.0.md)；从 0.14.2 或更旧版本升级还须阅读
 [0.14.3 数据迁移与回退说明](docs/release-0.14.3.md)。
 
 ```bash
 # ① Git 安装（clone + prepare 构建；推荐打固定 tag）
-dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.21.2
+dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.21.3
 
 # ② npm 注册表（发布到 npm 后）
-dsh plugin --profile web add dsh-vscode-mode@0.21.2
+dsh plugin --profile web add dsh-vscode-mode@0.21.3
 
 # ③ GitHub Release tgz 直装（Release asset 可用后）
-dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.21.2/dsh-vscode-mode-0.21.2.tgz
+dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.21.3/dsh-vscode-mode-0.21.3.tgz
 ```
 
 > **DSH 版本政策（0.17.0 起）**：六项 DSH peer 仍统一声明为 `*`，另以
@@ -830,6 +831,7 @@ Keep All / Undo All 却是亮的。修复：单文件 Keep / Undo 覆盖冲突
 完整变更见 [GitHub Releases](https://github.com/Lenonss/DSH_VsCodeMode/releases)。
 近期关键版本：
 
+- **v0.21.3**：MCP 初始化失败时分离调用者结果与安全收尾，已进入 startup 的调用者及时收到失败；旧 work/close 未完成仍占槽并阻止同 key 重建，清理失败不开放替代连接，收尾完成才开始冷却。不宣称解决首次偶发超时、gamma 排队或整体流程有界。当前 Host/GUI 未部署未验证，用户仅本批接受替代验收；不自动部署或重启。见 [发布说明](docs/release-0.21.3.md)。
 - **v0.21.2**：适配新版 DSH Session Controller 与 MCP 公开工具目录；固定目标任务发送持有会话直到完成或卸载，受理不明时不跨通道重发。范围文件引用的模型文本、剪贴板与纯文本降级保持一致。MCP 初始化失败记录阶段、耗时和脱敏错误链；迁移官方 native/PTC 执行器集成测试并增加可选真实 CodeGraph stdio 验证。当前 Web Host 真实工具调用已通过，首次连接偶发超时根因仍未证实；不自动部署或重启。见 [发布说明](docs/release-0.21.2.md)。
 - **v0.21.1**：缺失历史文件读取完整快照并整文件显示删除行；Keep 保留删除，Undo 安全恢复当前展示快照，不覆盖重新出现的文件。删除预览只读，单文件和批量操作统一处理，记录变化或证据不足时停止。真实 GUI 验收缺口已获用户接受；发布不自动部署，升级后重启 DSH 并刷新页面。见 [发布说明](docs/release-0.21.1.md)。
 - **v0.21.0**：新增 XLSX 基础编辑、多工作表与浏览器导出副本，原件不自动写回；不支持结构只读预览，高级应用经官方 Host 打开原件。编辑状态仅在当前页面内保留，不承诺刷新或崩溃恢复。官方差异定位统一 BOM 与 LF/CRLF/混合行尾口径，区分内容缺失与多处命中，保持原始字节及写回校验边界；不扩展 CRLF patch Undo 能力，目标官方记录 ↑/↓ 的真实点击仍未验收。升级后重启 DSH 并刷新页面；发布不自动部署当前实例。

package/lib/client.js.map

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/lib/client.js.map
-size: 35441122 bytes
-sha256: 7a0cd42b2d95ee169d929a0582c16b5732f1e05419aebc39c8d665bf7785e490
+size: 35443071 bytes
+sha256: 628a3079abf2c9880fe64f234fcffcf2fe857313b9759f0900125c4b0ba0b78d

package/lib/index.js

@@ -1213,6 +1213,7 @@ var McpPool = class {
 				queuedAt: Date.now(),
 				phaseAt: Date.now(),
 				ready: Promise.resolve(),
+				quiescence: Promise.resolve(),
 				live: true,
 				calls: Promise.resolve()
 			};
@@ -1233,21 +1234,36 @@ var McpPool = class {
 			}
 		};
 	}
-	/** @private @author ddj 2026年10月20号 @param entry New entry. @returns Queued initialization, bounded to two concurrent starts. */
+	/** @private @author ddj 2026年10月29号 @param entry New entry. @returns Caller result, independent from the two-slot cleanup lifetime. */
 	schedule(entry) {
-		return new Promise((resolve, reject) => {
-			/** @author ddj 2026年10月20号 Initializes a still-owned queue item. */
-			const run = async () => {
-				try {
-					await this.start(entry);
-					resolve();
-				} catch (error) {
-					reject(error);
-				}
+		let result;
+		const ready = new Promise((resolve, reject) => {
+			result = {
+				resolve,
+				reject
 			};
-			this.queue.push(run);
-			this.pump();
 		});
+		let lifetime;
+		entry.quiescence = new Promise((resolve, reject) => {
+			lifetime = {
+				resolve,
+				reject
+			};
+		});
+		entry.quiescence.catch(() => void 0);
+		/** @private @author ddj 2026年10月29号 Runs and observes the complete owned mount even after caller rejection. */
+		const run = async () => {
+			try {
+				await this.start(entry, result);
+				lifetime.resolve();
+			} catch (error) {
+				result.reject(error);
+				lifetime.reject(error);
+			}
+		};
+		this.queue.push(run);
+		this.pump();
+		return ready;
 	}
 	/** @private @author ddj 2026年10月20号 Advances FIFO work; each task holds its slot until startup or cleanup quiesces. */
 	pump() {
@@ -1262,9 +1278,12 @@ var McpPool = class {
 			this.jobs.add(job);
 		}
 	}
-	/** @private @author ddj 2026年10月20号 @param entry Connection to initialize. @returns Initialization completion, or failure after owned cleanup. */
-	async start(entry) {
-		if (!entry.live || this.stopped) throw new Error("MCP 启动已取消");
+	/** @private @author ddj 2026年10月29号 @param entry Connection to initialize. @param result Caller settlement. @returns Full startup and cleanup lifetime. */
+	async start(entry, result) {
+		if (!entry.live || this.stopped) {
+			result.reject(/* @__PURE__ */ new Error("MCP 启动已取消"));
+			return;
+		}
 		entry.phase = "loading";
 		entry.phaseAt = Date.now();
 		entry.startAt = entry.phaseAt;
@@ -1280,42 +1299,52 @@ var McpPool = class {
 			entry.phase = "ready";
 			entry.finishedAt = Date.now();
 			entry.connectedAt = entry.finishedAt;
+			result.resolve();
 		} catch (error) {
-			entry.error = "MCP 初始化失败或超时，请查看 Host 日志";
+			if (!entry.cleanupFailed) entry.error = "MCP 初始化失败或超时；旧连接清理尚未确认，暂不能重建，请查看 Host 日志";
 			const diagnostic = "MCP initialization failed; phase=" + entry.phase + "; transport=" + entry.spec.config.transport + "; elapsedMs=" + (Date.now() - entry.startAt) + "; " + mcpErrorText(error, entry.spec.config);
 			debugRecord(this.ctx, entry.spec.workspace, diagnostic, "warn");
 			entry.live = false;
 			entry.phase = "stopping";
-			const closing = this.closeBridge(entry);
-			await Promise.allSettled([closing, work]);
-			entry.phase = "error";
-			entry.finishedAt = Date.now();
-			entry.retryAt = Date.now() + 5e3;
-			throw new Error(entry.error);
+			result.reject(new Error(entry.error));
+			await this.finishFailure(entry, work);
 		} finally {
 			if (timer) clearTimeout(timer);
 		}
 	}
+	/** @private @author ddj 2026年10月29号 @param entry Failed generation. @param work Entire mount, including late factory cleanup. @returns Confirmed quiescence; throws when closure is unconfirmed. */
+	async finishFailure(entry, work) {
+		await Promise.allSettled([this.closeBridge(entry), work]);
+		if (entry.cleanupFailed) throw new Error(entry.error);
+		entry.phase = "error";
+		entry.finishedAt = Date.now();
+		entry.retryAt = entry.finishedAt + 5e3;
+		entry.error = "MCP 初始化失败或超时，请查看 Host 日志";
+	}
 	/** @private @author ddj 2026年10月20号 @param entry Owned generation. @returns Official initial sync; never publishes after invalidation. */
 	async mount(entry) {
 		const official = await this.load();
 		if (!entry.live || this.stopped) return;
 		const bridge = await this.make();
+		entry.bridge = bridge;
 		if (!entry.live || this.stopped) {
-			await bridge.dispose();
+			await this.closeBridge(entry);
 			return;
 		}
-		entry.bridge = bridge;
 		entry.phase = "starting";
 		entry.phaseAt = Date.now();
 		entry.fiber = bridge.scope.ctx.plugin(official, entry.spec.config);
 		await entry.fiber;
 		if (entry.fiber?.state !== void 0 && entry.fiber.state !== 2) throw new Error("MCP 插件未完成激活");
 	}
-	/** @private @author ddj 2026年10月20号 @param entry Connection to close. @returns Shared closure barrier; rejection retains a fenced entry. */
+	/** @private @author ddj 2026年10月29号 @param entry Connection to close. @returns Shared closure barrier; synchronous throws and rejections retain a fenced entry. */
 	async closeBridge(entry) {
 		if (entry.close) return entry.close;
-		const close = entry.bridge?.dispose() ?? Promise.resolve();
+		const bridge = entry.bridge;
+		if (!bridge) return;
+		/** @private @author ddj 2026年10月29号 @returns Deferred disposal so synchronous throws are owned by the shared barrier. */
+		const dispose = () => bridge.dispose();
+		const close = Promise.resolve().then(dispose);
 		entry.close = close;
 		try {
 			await close;
@@ -1323,6 +1352,7 @@ var McpPool = class {
 			entry.fiber = void 0;
 			entry.close = void 0;
 		} catch (error) {
+			entry.cleanupFailed = true;
 			entry.error = "MCP 释放未确认，禁止重建，请查看 Host 日志";
 			this.ctx.logger?.warn?.("MCP cleanup failed: " + String(error));
 			throw error;
@@ -1346,9 +1376,12 @@ var McpPool = class {
 		entry.live = false;
 		entry.phase = "stopping";
 		if (entry.idle) clearTimeout(entry.idle);
-		await this.closeBridge(entry);
-		await entry.ready.catch(() => void 0);
-		await entry.calls.catch(() => void 0);
+		const failure = (await Promise.allSettled([
+			this.closeBridge(entry),
+			entry.quiescence,
+			entry.calls
+		])).find((closure) => closure.status === "rejected");
+		if (failure?.status === "rejected") throw failure.reason;
 		if (this.entries.get(entry.key) === entry) this.entries.delete(entry.key);
 	}
 	/** @public @author ddj 2026年10月20号 @param entry Authorized connection. @param action Per-call work retaining original execution identity. @param signal Caller cancellation. @returns Serialized shared result; no direct registry bypass is introduced here. */
@@ -1366,8 +1399,10 @@ var McpPool = class {
 	/** @public @author ddj 2026年10月20号 @returns Full disposal of entries, queue, timers and owned work. */
 	async dispose() {
 		this.stopped = true;
-		await Promise.all([...this.entries.values()].map((entry) => this.retire(entry)));
+		const closures = await Promise.allSettled([...this.entries.values()].map((entry) => this.retire(entry)));
 		await Promise.all([...this.jobs]);
+		const failure = closures.find((closure) => closure.status === "rejected");
+		if (failure?.status === "rejected") throw failure.reason;
 	}
 };
 //#endregion