Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[Bug]: Auto-restart is documented as `claude -c` (conversation kept) but the default is a fresh session (FW_RESTART_MODE=fresh, T-3166)

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#95 3 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
78/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
shell
Lĩnh vực
cli, documentation

Hướng nghiên cứu

Đọc phần Auto-Restart trong lib/templates/claude-project.md và so sánh các nhận định ở đó với giá trị mặc định tại bin/claude-fw:1432; sau đó kiểm tra các tài liệu tham chiếu được liệt kê trong bin/claude-fw, docs/harnesses.md, docs/context-compaction.md và agents/context/post-compact-resume.sh. Cập nhật phần mô tả để giải thích chế độ mặc định bắt đầu phiên mới và FW_RESTART_MODE=continue. Công việc hoàn tất khi toàn bộ tài liệu được trích dẫn khớp với hành vi của wrapper và giải thích rằng một cuộc trò chuyện trống là điều được mong đợi.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

area:cli bug severity:medium status:accepted triaged
Bug Description

Since T-3166 the budget-critical auto-restart starts a FRESH session by default (bin/claude-fw:1432, ${FW_RESTART_MODE:-fresh}): new transcript, seeded from the handover only, SessionStart source startup. The documents that describe the restart still say claude -c, i.e. the conversation is continued:

  • lib/templates/claude-project.md:875: "the wrapper detects this signal on exit and auto-restarts with claude -c. The SessionStart:resume hook then injects handover context into the fresh session."
  • lib/templates/claude-project.md:877: "Flow: Budget critical → auto-handover → signal file → claude exits → wrapper detects → sleep 3 → claude -c → context injected → /resume ready."
  • bin/claude-fw:6: "If found (and fresh), auto-restarts with claude -c to continue."
  • docs/harnesses.md:59: "claude-fw restarts with claude -c after a handover signal."
  • docs/context-compaction.md:88: "Same as above — claude -c re-injects via the same truncated path."
  • agents/context/post-compact-resume.sh:8: "After claude -c (session continuation, including auto-restart via T-179)"

The template matters most: it becomes the agent's operating instructions (CLAUDE.md) in every consumer project. FW_RESTART_MODE itself appears only in bin/claude-fw and in one runbook (docs/runbooks/arc-012-continuous-mode-live-fire.md:39), so a consumer cannot learn that the choice exists.

Steps to Reproduce
  1. grep -n 'claude -c' lib/templates/claude-project.md bin/claude-fw docs/harnesses.md docs/context-compaction.md agents/context/post-compact-resume.sh
  2. grep -n 'FW_RESTART_MODE' bin/claude-fw
  3. Live: start a session with claude-fw, no FW_RESTART_MODE set, and let it reach the budget cap.

Steps 1 and 2 were run on 1.8.6 and again on 1.8.11 (e42aa41bf). Step 3 was observed once on 1.8.6.

Expected Behavior

The template and the other documents describe what the wrapper does by default: a new session seeded from the handover, the previous conversation not in context (it can be reopened with claude --resume), and FW_RESTART_MODE=continue as the documented way to keep the transcript at the price of not freeing the context.

Actual Behavior

The operator came back to an empty conversation and asked whether it was a bug. The agent's instructions said the restart used claude -c, so the agent had no reason to expect an empty conversation either. The only place the real mode is named is one banner line ("Restart mode: fresh (new session, seeded from the handover)") printed during the three-second cancel window.

fw doctor output
AI Agent

Claude Code

Operating System

Linux

Additional Context

Version: 1.8.11 (e42aa41bf), vendored consumer. First observed on 1.8.6; every quoted line is still present in 1.8.11 (only line numbers moved). Outside bin/claude-fw, FW_RESTART_MODE is only mentioned in that runbook and in an internal report (docs/reports/T-3181-continuous-run-model-refinement.md).

The restart itself worked as designed; nothing was lost. This report is about the description only.

Suggestions:

  1. Rewrite the "Auto-Restart" section of the template for the fresh default, and document FW_RESTART_MODE.
  2. Fix the header of bin/claude-fw, the header of post-compact-resume.sh, docs/harnesses.md:59 and docs/context-compaction.md:88 the same way.
  3. Say in the template what the operator sees: an empty conversation is the expected result, not a loss.
Ngôn ngữ chính
Shell
Star
16
Fork
6
Merge trung bình
6 giờ 24 phút
Pull request đã merge (30 ngày)
5

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của DimitriGeelen/agentic-engineering-framework

Tất cả issue của DimitriGeelen/agentic-engineering-framework

Issue tương tự

Thêm issue về Shell/Bash

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.