easy-coding-harness 0.8.1 → 0.8.2-beta.0

package/CHANGELOG.md

@@ -6,6 +6,12 @@
 - `y`：常规功能升级
 - `z`：日常 bug 修复
 
+## 0.8.2-beta.0
+
+- 原生选择工具明确保证永久等待时，确认门禁用或省略 timeout / auto-resolution；有限超时不再视为“永久等待”。
+- 无法确认永久等待时，Agent 会在调用原生选择前预先输出完整文本编号兜底，确保超时即使终止当前轮，用户仍可稍后直接回复编号；无效结果不再重试原生框。
+- 恢复流程优先按现有 `pending_transition` 消费普通门 `1/2/3` 或特殊 IMPLEMENT 门 `1/2/3/4`，只有未匹配输入才重新展示门禁；workflow、analysis、主约束、文档和三平台安装测试同步固化该契约。
+
 ## 0.8.1
 
 - 正式发布原生确认门完整展示：存在待确认迁移时，Claude Code、Codex、Qoder 必须提供确认目标阶段、交接和 free-form Other，并安全处理取消、超时或无效选择。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-coding-harness",
-  "version": "0.8.1",
+  "version": "0.8.2-beta.0",
   "description": "CLI scaffold for installing Easy Coding harness files into agent-native directories.",
   "repository": {
     "type": "git",

package/templates/common/skills/ec-analysis/SKILL.md

@@ -275,13 +275,18 @@ tool when one is available. The visible branches are:
 2. Hand off to another agent
 3. Other — use the native free-form Other input for revisions or another instruction.
 
-If no native choice tool exists, render all three branches as a numbered text fallback. An empty,
-dismissed, timed-out, or unparseable result keeps the task in ANALYSIS with its pending edge and
-may retry the native choice at most once per assistant turn. If that retry also fails, stop the
-current turn and re-present the complete gate on the next user interaction. Never replace the gate
-with only "reply confirm", "confirm execution", or a statement that no valid choice was received,
-and never invoke native choice repeatedly in the same turn. Choosing handoff delegates to
-ec-workflow's existing target-less `handoff-task` flow; do not ask the user to name the next agent.
+Before invoking the native tool, determine whether it explicitly guarantees an indefinite wait.
+When it does, disable or omit any timeout or auto-resolution setting; a long finite timeout is not
+equivalent. When that guarantee is absent or uncertain, render all three numbered branches as
+normal assistant text before invoking the native tool once, labelled as the persistent timeout
+fallback. This ensures the text survives even when timeout ends or suspends the turn. If no native
+choice tool exists, render the same numbered fallback directly. An empty, dismissed, timed-out, or
+unparseable result keeps the task in ANALYSIS with its pending edge. If the fallback is not already
+visible, render it immediately when control returns; otherwise do not duplicate it. Tell the user
+they may reply with its number later, do not invoke or retry native choice in that turn, and stop.
+Never replace the gate with only "reply confirm", "confirm execution", or a statement that no
+valid choice was received. Choosing handoff delegates to ec-workflow's existing target-less
+`handoff-task` flow; do not ask the user to name the next agent.
 
 ## End state
 

package/templates/common/skills/ec-workflow/SKILL.md

@@ -158,20 +158,27 @@ it, routing matches, and switching happens again.
   input for revisions. Record REVIEW as the recommended pending edge first. If the user chooses
   VERIFICATION, cancel that edge, request IMPLEMENT -> VERIFICATION, and immediately confirm it
   because that selection is explicit confirmation of the alternate target.
-  Plain-text numbered choices are fallback only: use them only when no native user-choice tool
-  exists. An ordinary gate must list all three branches rather than collapsing to "reply confirm":
+  Before invoking a native choice tool, determine whether it explicitly guarantees an indefinite
+  wait. When it does, disable or omit any timeout or auto-resolution setting so the request waits
+  for explicit user input; a long finite timeout is not equivalent. When that guarantee is absent
+  or uncertain, render the matching complete numbered fallback as normal assistant text before
+  invoking the native tool once. Label it as the persistent fallback to use if the native choice
+  closes, so it remains available even when a timeout ends or suspends the current turn.
+  Plain-text numbered choices are fallback only: use them when no native user-choice tool exists,
+  pre-render them when an indefinite native wait is not guaranteed, or render them after an
+  unexpected invalid native result. An ordinary gate must list all three branches rather than
+  collapsing to "reply confirm":
   `1. Confirm entering/returning to <target-stage> (recommended)`,
   `2. Hand off to another agent`, `3. Other (describe revisions or another instruction)`.
   The code-task IMPLEMENT completion fallback must preserve its special branch set:
   `1. Enter REVIEW (recommended)`, `2. Skip REVIEW and enter VERIFICATION`,
   `3. Hand off to another agent`, `4. Other (describe revisions or another instruction)`.
   An empty, dismissed, timed-out, or unparseable choice result is not confirmation. Preserve the
-  pending edge and re-present the complete native choice UI at most once per assistant turn. If
-  that retry is also empty, dismissed, timed out, or unparseable, stop the current turn with the
-  pending edge intact and re-present the gate on the next user interaction; never call the native
-  choice tool repeatedly in the same turn. If native choice is no longer available, render the
-  appropriate complete numbered fallback. Never report "no valid choice" and then show only a
-  confirmation instruction. The runtime hook never mutates workflow state from user-prompt text.
+  pending edge. If no numbered fallback is already visible, render the matching complete fallback
+  immediately when control returns; otherwise do not duplicate it. State that the user may reply
+  with its number at any later time. Do not invoke or retry the native choice again in that turn.
+  Never report "no valid choice" and then show only a confirmation instruction. The runtime hook
+  never mutates workflow state from user-prompt text.
   Native choice results, numbered fallback replies, and every natural-language reply must be
   interpreted by you against the current task and stored target before calling
   `confirm-transition` explicitly.
@@ -262,8 +269,13 @@ Resuming an active task (whether from session restart, claim, handoff, or task s
    `[easy-coding:lite-review-bypass-required:IMPLEMENT->REVIEW]` before the generic pending-edge
    rule: call `cancel-transition`, then `auto-transition --stage VERIFICATION`. Otherwise compare
    the stored edge with `effective_confirm_mode`. If the edge is now automatic, call
-   `auto-transition` for its stored target; otherwise re-present the confirmation/handoff/Other
-   choices. For a read-only task in IMPLEMENT, cancel any stale REVIEW/VERIFICATION edge before
+   `auto-transition` for its stored target. Before re-presenting any manual gate, consume a
+   matching numbered fallback reply from the current user prompt against the stored target:
+   ordinary `1` confirms, `2` hands off, and `3` selects Other; the approve-mode code IMPLEMENT
+   gate maps `1` to REVIEW, `2` to VERIFICATION, `3` to handoff, and `4` to Other. A bare Other
+   number asks for the missing revision text with the pending edge intact; Other plus details
+   cancels the edge before revision. Only an unmatched prompt re-presents the complete gate.
+   For a read-only task in IMPLEMENT, cancel any stale REVIEW/VERIFICATION edge before
    the terminal check below. At an approve-mode IMPLEMENT boundary for a code task, re-present
    the special REVIEW / skip to VERIFICATION / handoff choices.
 5. If a read-only task resumes in IMPLEMENT with a valid successful result, output its complete

package/templates/main-constraint/AGENTS.md.tpl

@@ -52,11 +52,14 @@ First run `ec-init`; daily work goes through `ec-workflow`.
   the complete gate. An ordinary gate offers "confirm entering/returning to the target stage"
   (recommended) and "hand off to another agent", with free-form Other for revisions. The special
   approve-mode code IMPLEMENT gate must instead preserve enter REVIEW, skip to VERIFICATION, and
-  handoff, with free-form Other. Only when no native choice tool exists may you show the matching
-  complete numbered fallback. Empty, dismissed, timed-out, or unparseable results preserve the
-  pending edge and may retry native choice at most once per assistant turn; after a failed retry,
-  stop the turn and re-present the gate on the next user interaction. Never degrade to only
-  "reply confirm" or repeatedly invoke native choice in the same turn.
+  handoff, with free-form Other. Use a native choice without a text pre-fallback only when the tool
+  explicitly guarantees an indefinite wait; disable or omit automatic timeout/resolution in that
+  case. Otherwise pre-render the matching numbered fallback before invoking native choice once,
+  so timeout cannot remove the user's path forward. Empty, dismissed, timed-out, or unparseable
+  native results preserve the pending edge; show the fallback when control returns only if it is
+  not already visible, and never retry native choice in that turn. On resume, consume a matching
+  numbered reply against the stored edge before re-presenting the gate. Never degrade to only
+  "reply confirm".
 - When `[easy-coding:no-harness]` is injected, do not emit an Easy Coding status line and ignore
   only Easy Coding workflow/stage orchestration for this session. Continue honoring every
   non-Easy-Coding skill, hook, and instruction. Do not clear or mutate the suspended task.

package/templates/main-constraint/CLAUDE.md.tpl

@@ -50,11 +50,14 @@ First run `/ec-init`; daily work goes through `/ec-workflow`.
   the complete gate. An ordinary gate offers "confirm entering/returning to the target stage"
   (recommended) and "hand off to another agent", with free-form Other for revisions. The special
   approve-mode code IMPLEMENT gate must instead preserve enter REVIEW, skip to VERIFICATION, and
-  handoff, with free-form Other. Only when no native choice tool exists may you show the matching
-  complete numbered fallback. Empty, dismissed, timed-out, or unparseable results preserve the
-  pending edge and may retry native choice at most once per assistant turn; after a failed retry,
-  stop the turn and re-present the gate on the next user interaction. Never degrade to only
-  "reply confirm" or repeatedly invoke native choice in the same turn.
+  handoff, with free-form Other. Use a native choice without a text pre-fallback only when the tool
+  explicitly guarantees an indefinite wait; disable or omit automatic timeout/resolution in that
+  case. Otherwise pre-render the matching numbered fallback before invoking native choice once,
+  so timeout cannot remove the user's path forward. Empty, dismissed, timed-out, or unparseable
+  native results preserve the pending edge; show the fallback when control returns only if it is
+  not already visible, and never retry native choice in that turn. On resume, consume a matching
+  numbered reply against the stored edge before re-presenting the gate. Never degrade to only
+  "reply confirm".
 - When `[easy-coding:no-harness]` is injected, do not emit an Easy Coding status line and ignore
   only Easy Coding workflow/stage orchestration for this session. Continue honoring every
   non-Easy-Coding skill, hook, and instruction. Do not clear or mutate the suspended task.