@zq-silk/yui 0.15.0 → 0.15.2

package/dist/tmux/tmuxManager.js

@@ -79,10 +79,23 @@ export class TmuxManager {
     }
     ensureRoleWindow(taskId, role, launch) {
         if (this.windowNames(taskId).includes(role.name)) {
+            const pane = this.inspectPane(taskId, role.name);
+            if (pane.dead && launch === undefined) {
+                throw runtimeError(`Role ${role.name} has an exited-retained pane; a launch plan is required to restart it.`);
+            }
             this.recordRoleTarget(taskId, role.name);
             this.configureServerHistory();
+            if (pane.dead) {
+                // Without -k tmux refuses to replace a live process, even if the pane
+                // changed after inspection. Reads alone never discard the exit scene.
+                this.run([
+                    "respawn-window", "-t", this.exactTarget(taskId, role.name),
+                    "-c", safeValue(role.cwd ?? role.workspace, "Role cwd"),
+                    "--", ...launchCommand(launch)
+                ]);
+            }
             this.configureRoleWindowSizing(taskId, role.name);
-            return false;
+            return pane.dead;
         }
         if (launch === undefined) {
             throw runtimeError(`Agent launch plan is required to create Role window: ${role.name}.`);
@@ -127,10 +140,21 @@ export class TmuxManager {
     async ensureRoleWindowAsync(taskId, role, launch) {
         const snapshot = await this.sessionWindowNamesAsync(taskId);
         if (snapshot.names.includes(role.name)) {
+            const pane = await this.inspectPaneAsync(taskId, role.name);
+            if (pane.dead && launch === undefined) {
+                throw runtimeError(`Role ${role.name} has an exited-retained pane; a launch plan is required to restart it.`);
+            }
             this.recordRoleTarget(taskId, role.name);
             await this.configureServerHistoryAsync();
+            if (pane.dead) {
+                await this.runAsync([
+                    "respawn-window", "-t", this.exactTarget(taskId, role.name),
+                    "-c", safeValue(role.cwd ?? role.workspace, "Role cwd"),
+                    "--", ...launchCommand(launch)
+                ]);
+            }
             await this.configureRoleWindowSizingAsync(taskId, role.name);
-            return false;
+            return pane.dead;
         }
         if (launch === undefined) {
             throw runtimeError(`Agent launch plan is required to create Role window: ${role.name}.`);
@@ -364,7 +388,7 @@ export class TmuxManager {
     inspectPane(taskId, roleName) {
         const target = this.target(taskId, roleName);
         const output = this.run([
-            "display-message", "-p", "-t", target,
+            "display-message", "-p", "-t", this.exactTarget(taskId, roleName),
             [
                 "#{pane_dead}",
                 "#{pane_pid}",
@@ -379,6 +403,9 @@ export class TmuxManager {
             throw runtimeError(`Tmux returned an invalid pane state for ${roleName}.`);
         }
         const dead = output.slice(0, separator);
+        if (dead !== "0" && dead !== "1") {
+            throw runtimeError(`Tmux returned an invalid pane state for ${roleName}.`);
+        }
         const pidText = output.slice(separator + 1, secondSeparator);
         const currentCommand = output.slice(secondSeparator + 1, lastSeparator);
         const exitStatusText = output.slice(lastSeparator + 1);
@@ -405,7 +432,7 @@ export class TmuxManager {
             : deliveryReceiptOption(receiptId);
         const receiptFormat = receiptOption === undefined ? "" : `#{${receiptOption}}`;
         const output = await this.runAsync([
-            "display-message", "-p", "-t", target,
+            "display-message", "-p", "-t", this.exactTarget(taskId, roleName),
             [
                 PANE_STATE_MARKER,
                 "#{pane_dead}",
@@ -798,22 +825,16 @@ export class TmuxManager {
         }
         this.enterRole(taskId, role, launch);
     }
-    detectRoleStatus(taskId, roleName, fallback = "exited") {
-        try {
-            return this.probeRoleStatus(taskId, roleName);
-        }
-        catch {
-            return fallback;
-        }
-    }
     probeRoleStatus(taskId, roleName) {
-        if (!this.hasSession(taskId))
+        if (!this.windowNames(taskId).includes(roleName))
             return "exited";
-        return this.windowNames(taskId).includes(roleName) ? "running" : "exited";
+        return this.inspectPane(taskId, roleName).dead ? "exited" : "running";
     }
     async probeRoleStatusAsync(taskId, roleName) {
         const snapshot = await this.sessionWindowNamesAsync(taskId);
-        return snapshot.names.includes(roleName) ? "running" : "exited";
+        if (!snapshot.names.includes(roleName))
+            return "exited";
+        return (await this.inspectPaneAsync(taskId, roleName)).dead ? "exited" : "running";
     }
     /** Exact pane process state for one Role, used by owner-identity recording. */
     inspectRolePane(taskId, roleName) {
@@ -901,10 +922,6 @@ export class TmuxManager {
         catch (error) {
             if (isExplicitlyAbsentTmuxSession(error))
                 return false;
-            // Older/fake executors do not expose stderr. A failed has-session is the
-            // tmux absence contract; other operations remain strict.
-            if (!(error instanceof CommandExecutionError))
-                return false;
             throw error;
         }
     }
@@ -916,8 +933,6 @@ export class TmuxManager {
         catch (error) {
             if (isExplicitlyAbsentTmuxSession(error))
                 return false;
-            if (!(error instanceof CommandExecutionError))
-                return false;
             throw error;
         }
     }
@@ -930,7 +945,7 @@ export class TmuxManager {
             ]).split("\n").map((name) => name.trim()).filter(Boolean);
         }
         catch (error) {
-            if (isUnavailableTmuxStatus(error))
+            if (isExplicitlyAbsentTmuxSession(error))
                 return [];
             throw error;
         }
@@ -943,7 +958,7 @@ export class TmuxManager {
             return { exists: true, names };
         }
         catch (error) {
-            if (isUnavailableTmuxStatus(error))
+            if (isExplicitlyAbsentTmuxSession(error))
                 return { exists: false, names: [] };
             throw error;
         }
@@ -990,6 +1005,11 @@ export class TmuxManager {
     target(taskId, roleName) {
         return yuiTmuxTarget(this.#yuiHome, taskId, roleName);
     }
+    exactTarget(taskId, roleName) {
+        // tmux otherwise accepts prefix/glob matches after the selected Role
+        // disappears. Keep identity inspection and dead-pane replacement exact.
+        return `=${this.sessionName(taskId)}:=${safeValue(roleName, "Role name")}`;
+    }
     recordRoleTarget(taskId, roleName) {
         this.#onRoleTargetRecorded?.(this.target(taskId, roleName));
     }
@@ -1225,11 +1245,6 @@ function isExplicitlyAbsentTmuxSession(error) {
     return /can't find (?:session|window|pane)|no server running|no current target|session not found|error connecting to .+ \(No such file or directory\)/i
         .test(error.stderr);
 }
-function isUnavailableTmuxStatus(error) {
-    return isExplicitlyAbsentTmuxSession(error)
-        || (error instanceof CommandExecutionError
-            && /server exited unexpectedly/i.test(error.stderr));
-}
 function tmuxWord(value) {
     return JSON.stringify(value);
 }

package/i18n/README.zh-CN.md

@@ -14,6 +14,9 @@ Yui 不把 Agent 的判断固化成确定性的工作流引擎。核心只负责
 
 当前实现保留实用的 Role/Agent/session 与 CLI 框架，不恢复后期膨胀的数据维护、租约、定时调度和恢复账本体系。
 
+[目标架构手册](../docs/architecture/README.md) 保存了供后续重构使用的
+2026-09-06 版设计基线，不代表当前已实现行为。
+
 ## 核心模型
 
 - `WorkItem`：唯一的有界工作单元，保存目标、验收条件、依赖、状态和精简结果。
@@ -619,6 +622,8 @@ Task 生命周期的交互选择只展示有效来源状态：activate 只展示
 
 Session、Activation 与 Turn 是独立身份。Session 可以跨多个 Turn 和客户端连接；Activation 只代表 Yui 当前的连接，而不是对 Provider thread 的独占所有权。每次 Provider 执行对应一个持久 Turn；写入超时或结果不明确会进入 `delivery-unknown`，不会自动重发。Codex 已存在的 active Turn 只会让 Yui 暂时等待，不会导致待投递 Turn 失败；Claude 等独立进程 Provider 继续通过 Yui 的 view/takeover 边界进行人工控制。
 
+恢复只在真的续不下去时被拦住：provider 侧没有可恢复的 Session、换了 Agent 或适配器、换了物理工作区。模型、推理强度、权限策略、Role 说明与 Skill、声明的写范围只决定下一次 activation 用什么，审查轮次、候选 commit、工作区基线这类每轮事实不影响复用。因此当 Role 存在活跃 Session 时，`task role update`、`config role update`、`config agent update` 会先报告该 Session 并要求 `--yes` 确认；需要立刻生效则先停止该 Session。
+
 Turn 是 Role 是否有工作正在执行的唯一持久调度状态，记录可见输入、来源/渠道与最终回复，不复制思考过程或工具调用。所有经 Yui 中转或生成的输入统一使用 `source: yui`；Provider UI 中直接输入的消息使用 `source: user`；显式 Goal continuation 使用 `source: provider`。Provider Turn 终态后 Yui 完成该 Turn，再把下一个 Turn 投递到同一 Session。TaskRole 本身只保存身份和期望启动配置，不再保存可写的运行状态；CLI/Web 展示的 Role 状态由活动 Turn 派生，并叠加 Session/Driver 生命周期事实用于诊断。
 
 Goal 是 Session 级显式 Provider 事实，可以跨越多个 Turn。Codex 通过 Goal API/事件提供，Claude 通过 `active_goal` 提供；Yui 不用静默等待来猜测 Goal 是否完成。Turn 结束不等于 Goal、WorkItem 或 Task 完成，只有 Leader 更新 WorkItem 与 Task 的持久语义。
@@ -635,6 +640,8 @@ yui task role release <task-id> <role>
 
 Codex Role thread 可在 Desktop 中直接查看和操作；Desktop 已有 active Turn 时，Yui 只保留待投递工作并等待，不会失败或重复投递。`view`、`takeover`、`release` 继续作为 Claude 等独立进程 Provider 的人工控制入口。Yui 不写入全局 Hook/config，也不启动、重启或停止共享 daemon；Codex CLI/daemon 故障由 Task 生命周期之外修复。Global Operator 与 global Role 继续使用原生交互式 CLI，不属于受管理 Task Provider 协议；Yui 在内部将 Codex 的 Global TUI 连接到同一个默认 App Server，用户不能通过 Agent 或 Role 参数覆盖该连接，Session Manifest 自带不依赖启动进程环境的 Global Context 命令，因此同一 thread 可直接切换到 Desktop 继续对话。
 
+Global Codex 的薄 Host 与原生 TUI 位于同一个 pane，透明转发 App Server 连接，并从该 TUI 自己的 `thread/start` 或 `thread/resume` 成功响应取得 Thread ID。Yui 在首条用户消息之前通过既有启动回执登记身份，不依赖 `notify`、历史目录扫描或 bootstrap 消息；旧的 global `notify` 不能登记或修改 Session 生命周期。连接随 TUI 退出，不依赖 Controller 的持续运行。tmux 窗口存在不等于 Agent 存活：`pane_dead=0` 才是运行中，`pane_dead=1` 是保留的退出现场，读取失败则报错。状态查询不删除现场；显式启动可重建精确的死亡窗口，但不能覆盖身份未知的活 Operator。
+
 `yui update` 会用目标版本先做只读预检，在停住精确的旧 Controller 后自动执行
 所需的离线迁移，再校验并启动新 Controller。若升级前希望结束所有 Agent
 活动，可先执行 `yui session stop --all`；这不是存储版本链的一部分。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zq-silk/yui",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "description": "Local control plane for long-running native agent CLI sessions backed by tmux.",
   "license": "MIT",
   "private": false,