@zhushanwen/zcode-subagent-cli 0.4.4 → 0.6.0

package/dist/index.d.cts

@@ -154,26 +154,18 @@ declare class ZcodeEngine implements EnginePort {
      * 单轮常驻执行：runTurn 组合面 + D3 abort 链 + 事件前移（text_delta 实时流出；
      * 终态数据经 read 兜底收口后才 resolve——不变量 1/2）。
      *
-     * @param opts turnTimeoutMs：显式总上界传参面（D2 内部传参点）——U4/D6 预算继承
-     *   向重试轮传剩余值；缺省不传（channel 走 env→默认，首轮行为）。
-     *   retried：瞬时重试轮标记——失败文案补「已自动重试一次」句（F-1/F-4）。
+     * @param opts retried：瞬时重试轮标记——失败文案补「已自动重试一次」句（F-1/F-4）。
      */
     private attemptAppServerTurn;
     /**
      * [attemptAppServerTurn 拆分] 失败分流（catch 半边）：
      * - signal 已 aborted → 中止终态收口；
-     * - [P0-1 U2] 超时入口（D3 v1.1）：turn 已被 channel 判死 reject——升级判据不能
-     *   再挂在 turn 落定上（race 恒真，killChain 结构性不可达的 v1 击穿点），改以
-     *   stop 应答三态裁决。await 链终局（非 fire-and-forget）：outcome 止损文案与
-     *   重试时序（D6，u-z4）都依赖链终局信号——止损完成前不合成终态。timeout 类
-     *   （idle/ceiling 都算）是 D6 明文的可重试形态——结构化标记
-     *   （TurnTimeoutError 类型化判据，不经字符串匹配，D4 同精神）；
-     * - [P0-1 U4] 连接崩溃收割形态（failAllTurns 的错误，D6 第二可重试形态）判据：
+     * - [P0-1 U4] 连接崩溃收割形态（failAllTurns 的错误，D6 可重试形态）判据：
      *   非 RPC error（服务端无明确应答——有应答即精确错误归类，非瞬时崩溃面）且
      *   conn 不存活。时序可靠性：catch 时刻紧随 onClose 收割，连接重建仅由
      *   conn.request 惰性触发——本链路中 runTurn finally 的 closeSession 对死连接
-     *   短路（channel 侧 !alive 守卫）、stop 只属 abort/超时入口（前者已被
-     *   signal.aborted 短路、后者走上一分支）——此刻无 request 可重建，判据可靠；
+     *   短路（channel 侧 !alive 守卫）、stop 只属 abort 链（已被 signal.aborted
+     *   短路）——此刻无 request 可重建，判据可靠；
      * - 其余 → 精确错误终态。
      */
     private classifyAppServerTurnFailure;
@@ -182,28 +174,17 @@ declare class ZcodeEngine implements EnginePort {
      * shutdown resolve 于 `exit` 事件，而 finalize 挂 `close`（stdio 排空）——两者之间的
      * 事件窗口内 conn.child 仍非 null，紧接的下一任务 request 会复用垂死进程（写入成功
      * 但必败，走崩溃路径）而非触发重建。与 shutdownRuntimeAndDisposeChannel 的
-     * HARVEST_GRACE 同款 race 形态（close 永不到达不挂死）。超时入口的 await 链终局
-     * 语义（D6 重试时序依据）因此是「进程收割确认完成」而非「SIGTERM 已发出」。
+     * HARVEST_GRACE 同款 race 形态（close 永不到达不挂死）。abort 链的 await 终局
+     * 语义因此是「进程收割确认完成」而非「SIGTERM 已发出」。
      */
     private awaitConnFinalized;
     /**
-     * D3 abort 链执行体（双入口分岔，P0-1 U2 参数化，D3 v1.1）：
-     * - **用户取消入口**（`escalateOn: "turn-settled"`，现状语义零改动；fire-and-forget——
-     *   与 turn promise 并行推进）：stop 帧（超时 ZCODE_APPSERVER_STOP_TIMEOUT_MS）→
-     *   grace 窗口内 turn 落定即止（不杀共享进程）→ 超窗 killChain（conn.shutdown 全序：
-     *   SIGTERM→grace→SIGKILL）。turn 的最终落定由 attempt 主路径 await 收口，本链不
-     *   直接产出终态。abort 与 create 竞态（signal 先到、session 未建立）：等会话建立
-     *   （带上限）再发 stop——否则 stop 永远发不出，直接连坐杀共享进程。
-     * - **超时入口**（`escalateOn: "stop-outcome"`，channel 判死后由 catch await 链终局）：
-     *   turn 已 reject，对它 race 恒真不可用（v1 击穿点）——升级判据改挂在 **stop 应答
-     *   三态**：①成功应答 → 服务端接受停 turn，止损确认，链终止；②协议性 error 应答
-     *   （有 error 帧即控制面活的证据，多因 runTurn finally 的 closeSession 先行关会话，
-     *   健康形态竞态）→ 链终止**不升级**（止损由 close 回收 + 服务端自治承担；把
-     *   「stop 报错」一律升级会误杀健康共享进程并连坐并发任务）；③超时/写入失败/进程
-     *   死等连接级失败（控制面死）→ killChain 升级。判据实现依据：error 应答帧 reject
-     *   携带 number code（isAppServerRpcError）；连接级失败是无 code 的新 Error
-     *   （connection.request 三态 reject 形态）。返回值即止损路径（超时入口的 outcome
-     *   文案素材——D3 强制可观测面）。
+     * D3 abort 链执行体（用户取消入口，fire-and-forget——与 turn promise 并行推进）：
+     * stop 帧（超时 ZCODE_APPSERVER_STOP_TIMEOUT_MS）→ grace 窗口内 turn 落定即止
+     * （不杀共享进程）→ 超窗 killChain（conn.shutdown 全序：SIGTERM→grace→SIGKILL）。
+     * turn 的最终落定由 attempt 主路径 await 收口，本链不直接产出终态。abort 与 create
+     * 竞态（signal 先到、session 未建立）：等会话建立（带上限）再发 stop——否则 stop
+     * 永远发不出，直接连坐杀共享进程。
      */
     private appServerAbortChain;
     /**
@@ -221,15 +202,15 @@ declare class ZcodeEngine implements EnginePort {
      * [R5 修复 R4 既有竞态] shutdown → 等崩溃收割实际发生 → channel 退订。killChain 在
      * `exit` 事件 resolve，而连接 finalize（onClose → channel 的 failAllTurns）挂
      * `close` 事件——两者之间有一个事件循环窗口：shutdown resolve 后立即退订，在途
-     * turn 会错过收割、挂到 turnTimeoutMs（300s）。退订前等 onClose 触发（本方法先于
+     * turn 会错过收割而失去终局来源。退订前等 onClose 触发（本方法先于
      * shutdown 订阅；channel 的订阅在构造期更早——其 failAllTurns 先于本 promise
      * resolve 执行）；ZCODE_APPSERVER_HARVEST_GRACE_MS 兜底防 `close` 永不到达时挂死。
      * [P0-1 U5/D7] grace race 输掉（close 迟到/永不到达——stdio 被孙进程持有排空不
      * 尽等病态形态）时，channel.dispose() 内置的 dispose 收割（failAllTurns 先于退订，
-     * SessionChannel.dispose）兜底在途 turn——退化终点从「挂满 turn 自身 idle/总上界
-     * 预算」收敛为「grace 窗口内明确失败」（设计 §3.4 退化路径闭合）；race 窗口与
-     * awaitConnFinalized 同源同量级（ZCODE_APPSERVER_HARVEST_GRACE_MS）。正常 close
-     * 先到时 onClose 收割先行，dispose 收割幂等 no-op（零回归）。
+     * SessionChannel.dispose）兜底在途 turn——在途 turn 收敛为「grace 窗口内明确失败」
+     * （设计 §3.4 退化路径闭合）；race 窗口与 awaitConnFinalized 同源同量级
+     * （ZCODE_APPSERVER_HARVEST_GRACE_MS）。正常 close 先到时 onClose 收割先行，
+     * dispose 收割幂等 no-op（零回归）。
      */
     private shutdownRuntimeAndDisposeChannel;
     /**

package/dist/index.d.ts

@@ -154,26 +154,18 @@ declare class ZcodeEngine implements EnginePort {
      * 单轮常驻执行：runTurn 组合面 + D3 abort 链 + 事件前移（text_delta 实时流出；
      * 终态数据经 read 兜底收口后才 resolve——不变量 1/2）。
      *
-     * @param opts turnTimeoutMs：显式总上界传参面（D2 内部传参点）——U4/D6 预算继承
-     *   向重试轮传剩余值；缺省不传（channel 走 env→默认，首轮行为）。
-     *   retried：瞬时重试轮标记——失败文案补「已自动重试一次」句（F-1/F-4）。
+     * @param opts retried：瞬时重试轮标记——失败文案补「已自动重试一次」句（F-1/F-4）。
      */
     private attemptAppServerTurn;
     /**
      * [attemptAppServerTurn 拆分] 失败分流（catch 半边）：
      * - signal 已 aborted → 中止终态收口；
-     * - [P0-1 U2] 超时入口（D3 v1.1）：turn 已被 channel 判死 reject——升级判据不能
-     *   再挂在 turn 落定上（race 恒真，killChain 结构性不可达的 v1 击穿点），改以
-     *   stop 应答三态裁决。await 链终局（非 fire-and-forget）：outcome 止损文案与
-     *   重试时序（D6，u-z4）都依赖链终局信号——止损完成前不合成终态。timeout 类
-     *   （idle/ceiling 都算）是 D6 明文的可重试形态——结构化标记
-     *   （TurnTimeoutError 类型化判据，不经字符串匹配，D4 同精神）；
-     * - [P0-1 U4] 连接崩溃收割形态（failAllTurns 的错误，D6 第二可重试形态）判据：
+     * - [P0-1 U4] 连接崩溃收割形态（failAllTurns 的错误，D6 可重试形态）判据：
      *   非 RPC error（服务端无明确应答——有应答即精确错误归类，非瞬时崩溃面）且
      *   conn 不存活。时序可靠性：catch 时刻紧随 onClose 收割，连接重建仅由
      *   conn.request 惰性触发——本链路中 runTurn finally 的 closeSession 对死连接
-     *   短路（channel 侧 !alive 守卫）、stop 只属 abort/超时入口（前者已被
-     *   signal.aborted 短路、后者走上一分支）——此刻无 request 可重建，判据可靠；
+     *   短路（channel 侧 !alive 守卫）、stop 只属 abort 链（已被 signal.aborted
+     *   短路）——此刻无 request 可重建，判据可靠；
      * - 其余 → 精确错误终态。
      */
     private classifyAppServerTurnFailure;
@@ -182,28 +174,17 @@ declare class ZcodeEngine implements EnginePort {
      * shutdown resolve 于 `exit` 事件，而 finalize 挂 `close`（stdio 排空）——两者之间的
      * 事件窗口内 conn.child 仍非 null，紧接的下一任务 request 会复用垂死进程（写入成功
      * 但必败，走崩溃路径）而非触发重建。与 shutdownRuntimeAndDisposeChannel 的
-     * HARVEST_GRACE 同款 race 形态（close 永不到达不挂死）。超时入口的 await 链终局
-     * 语义（D6 重试时序依据）因此是「进程收割确认完成」而非「SIGTERM 已发出」。
+     * HARVEST_GRACE 同款 race 形态（close 永不到达不挂死）。abort 链的 await 终局
+     * 语义因此是「进程收割确认完成」而非「SIGTERM 已发出」。
      */
     private awaitConnFinalized;
     /**
-     * D3 abort 链执行体（双入口分岔，P0-1 U2 参数化，D3 v1.1）：
-     * - **用户取消入口**（`escalateOn: "turn-settled"`，现状语义零改动；fire-and-forget——
-     *   与 turn promise 并行推进）：stop 帧（超时 ZCODE_APPSERVER_STOP_TIMEOUT_MS）→
-     *   grace 窗口内 turn 落定即止（不杀共享进程）→ 超窗 killChain（conn.shutdown 全序：
-     *   SIGTERM→grace→SIGKILL）。turn 的最终落定由 attempt 主路径 await 收口，本链不
-     *   直接产出终态。abort 与 create 竞态（signal 先到、session 未建立）：等会话建立
-     *   （带上限）再发 stop——否则 stop 永远发不出，直接连坐杀共享进程。
-     * - **超时入口**（`escalateOn: "stop-outcome"`，channel 判死后由 catch await 链终局）：
-     *   turn 已 reject，对它 race 恒真不可用（v1 击穿点）——升级判据改挂在 **stop 应答
-     *   三态**：①成功应答 → 服务端接受停 turn，止损确认，链终止；②协议性 error 应答
-     *   （有 error 帧即控制面活的证据，多因 runTurn finally 的 closeSession 先行关会话，
-     *   健康形态竞态）→ 链终止**不升级**（止损由 close 回收 + 服务端自治承担；把
-     *   「stop 报错」一律升级会误杀健康共享进程并连坐并发任务）；③超时/写入失败/进程
-     *   死等连接级失败（控制面死）→ killChain 升级。判据实现依据：error 应答帧 reject
-     *   携带 number code（isAppServerRpcError）；连接级失败是无 code 的新 Error
-     *   （connection.request 三态 reject 形态）。返回值即止损路径（超时入口的 outcome
-     *   文案素材——D3 强制可观测面）。
+     * D3 abort 链执行体（用户取消入口，fire-and-forget——与 turn promise 并行推进）：
+     * stop 帧（超时 ZCODE_APPSERVER_STOP_TIMEOUT_MS）→ grace 窗口内 turn 落定即止
+     * （不杀共享进程）→ 超窗 killChain（conn.shutdown 全序：SIGTERM→grace→SIGKILL）。
+     * turn 的最终落定由 attempt 主路径 await 收口，本链不直接产出终态。abort 与 create
+     * 竞态（signal 先到、session 未建立）：等会话建立（带上限）再发 stop——否则 stop
+     * 永远发不出，直接连坐杀共享进程。
      */
     private appServerAbortChain;
     /**
@@ -221,15 +202,15 @@ declare class ZcodeEngine implements EnginePort {
      * [R5 修复 R4 既有竞态] shutdown → 等崩溃收割实际发生 → channel 退订。killChain 在
      * `exit` 事件 resolve，而连接 finalize（onClose → channel 的 failAllTurns）挂
      * `close` 事件——两者之间有一个事件循环窗口：shutdown resolve 后立即退订，在途
-     * turn 会错过收割、挂到 turnTimeoutMs（300s）。退订前等 onClose 触发（本方法先于
+     * turn 会错过收割而失去终局来源。退订前等 onClose 触发（本方法先于
      * shutdown 订阅；channel 的订阅在构造期更早——其 failAllTurns 先于本 promise
      * resolve 执行）；ZCODE_APPSERVER_HARVEST_GRACE_MS 兜底防 `close` 永不到达时挂死。
      * [P0-1 U5/D7] grace race 输掉（close 迟到/永不到达——stdio 被孙进程持有排空不
      * 尽等病态形态）时，channel.dispose() 内置的 dispose 收割（failAllTurns 先于退订，
-     * SessionChannel.dispose）兜底在途 turn——退化终点从「挂满 turn 自身 idle/总上界
-     * 预算」收敛为「grace 窗口内明确失败」（设计 §3.4 退化路径闭合）；race 窗口与
-     * awaitConnFinalized 同源同量级（ZCODE_APPSERVER_HARVEST_GRACE_MS）。正常 close
-     * 先到时 onClose 收割先行，dispose 收割幂等 no-op（零回归）。
+     * SessionChannel.dispose）兜底在途 turn——在途 turn 收敛为「grace 窗口内明确失败」
+     * （设计 §3.4 退化路径闭合）；race 窗口与 awaitConnFinalized 同源同量级
+     * （ZCODE_APPSERVER_HARVEST_GRACE_MS）。正常 close 先到时 onClose 收割先行，
+     * dispose 收割幂等 no-op（零回归）。
      */
     private shutdownRuntimeAndDisposeChannel;
     /**

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   readZcodeSessionView,
   zcodeDbPathAllowlist,
   zcodeSessionDbPath
-} from "./chunk-DLLNMF45.js";
+} from "./chunk-PWNJ5JYZ.js";
 
 // src/golden-sample.ts
 var ZCODE_APPSERVER_GOLDEN = {