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

narrow the removal guard's documented ceiling once a psmux release carries the psmux#622 fix

Đã đóng
  • Có gì không ổn?
#754 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

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

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
55/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ệ
python
Lĩnh vực
documentation

Hướng nghiên cứu

Sau khi một bản phát hành psmux mang theo psmux#622 và LAST_UNSUPPORTED được cập nhật, hãy bắt đầu trong src/bmad_loop/runs.py và docs/FEATURES.md, xác định phần diễn đạt về giới hạn trên và ngưỡng phát hành. Đo lại vị trí psmux liên quan theo từng symbol, sau đó thu hẹp cả hai mô tả vào trường hợp PATH và loại bỏ lưu ý về reap nếu các bản build được hỗ trợ không còn có thể xuất hiện điều đó.

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

Mô tả

area:psmux blocked:upstream P4

#732 accepted a measured ceiling on live_session_may_be_ours: a listing that omits a live session reads as "no session", so delete, archive and clean proceed and remove a run directory the session still depends on. The ceiling is now written into the guard's docstring and into docs/FEATURES.md, with two ways to meet it.

One of those two is upstream's, and it is fixable:

has-session deletes a live server's .port file when its 500 ms connect does not land, so ls exits 0 without that session until the server's registry maintenance re-writes it. Filed as psmux/psmux#622, with a measurement on installed psmux 3.3.8 (66cf613) under an isolated PSMUX_DATA_DIR, a tmux 3.4 comparison showing tmux blocks rather than reaping and never mutates registry state from a read-only predicate, and a source read confirming the site is unchanged between v3.3.8 and master 80362fa. The four sibling reap sites in that binary already gate on ConnectionRefused — the defect is that this one does not.

The other way is ours and does not go away: a process whose PATH lacks the multiplexer binary reads every session as absent, because the binary is per-process while the server is not.

What to do when it is fixed upstream

This retirement is documentation, not code — which is exactly why it needs an issue. There is no workaround to delete and no version gate to flip: #732 established that no gate is possible, because the reap produces a successful query with an incomplete answer (exit 0, empty, nothing on stderr) and there is no detectable condition to branch on. Nothing in the codebase will fail or warn when this stops being true.

So when a psmux release carries the psmux#622 fix and _LAST_UNSUPPORTED moves to that release or later:

  • Narrow the ceiling in live_session_may_be_ours (src/bmad_loop/runs.py) and in docs/FEATURES.md to the PATH case alone. Both currently describe the reap as a live limit.
  • Keep the reap described as history only if a supported build can still exhibit it; once the floor excludes those builds, delete that half rather than leaving it as a caveat nobody can reproduce.
  • Re-measure before narrowing, the way #732 did: relocate the site by symbol on the release in question rather than trusting the changelog.

Until then the wording is correct and should stay.

Why this is filed rather than left to a future reader: a documented limit that has quietly stopped being true is worse than an undocumented one — it is confidently wrong, and an operator meeting it will design around a window that no longer exists. The 3.3.8 adoption family exists because the same thing happened to a set of workarounds whose upstream premises had all been fixed; this is the same trap one layer down, in prose instead of in code.

Sibling of #733, which retires the #537 control-session suffix once psmux/psmux#599 lands. Refs #732, #660

Ngôn ngữ chính
Python
Star
160
Fork
68
Merge trung bình
1 ngày 6 giờ
Pull request đã merge (30 ngày)
90

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 bmad-code-org/bmad-loop

Tất cả issue của bmad-code-org/bmad-loop

Issue tương tự

Thêm issue về Python

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.