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]: fw upgrade reinstalls the cross-host messaging toolkit (step 7b) on every run, with no way to opt out

Đang mở
  • Có gì không ổn?
#89 5 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ó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
52/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
shell
Lĩnh vực
cli

Hướng nghiên cứu

Start with step 7b in lib/upgrade.sh (around lines 2536 and 2541), then check fw upgrade --help and lib/init.sh to understand the current behavior and the init/upgrade mismatch. The issue proposes several possible approaches, so clarify the opt-in or skip behavior before changing it. Done means projects that decline the toolkit do not have its files reinstalled on later upgrades, and the behavior is documented in the upgrade help or summary.

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

Mô tả

area:upgrade bug severity:medium status:released triaged
Bug Description

Step 7b of fw upgrade, "Doorbell+mail toolkit (T-1867)", copies every file under lib/templates/skills/ and lib/templates/scripts/ into the project (lib/upgrade.sh, lines 2536 and 2541): nine slash commands in .claude/commands/ and twelve scripts in a new project-root scripts/ directory. There is no flag and no config key to skip the step, and fw upgrade --help lists none.

A project that removes these files gets them back on the next upgrade. T-3955 (479edae) made the step keep a file the project has customised; it does not cover a project that does not want the toolkit at all.

Why it matters: in a confidential workspace where nothing is meant to leave the machine and TermLink is not installed, a toolkit whose purpose is cross-host agent messaging is unwanted. It arrives without being announced as such, and has to be removed by hand after every upgrade.

Also: fw init does not install these files (no reference to the two template directories in lib/init.sh), so init and upgrade disagree on what a project contains.

Steps to Reproduce
  1. fw init a project. .claude/commands/ holds resume.md only, and there is no scripts/ directory.
  2. Run fw upgrade. Twenty-one files are created.
  3. Delete them, then run fw upgrade again.

Observed on 1.8.3 (with upstream at the same commit, so the upgrade brought nothing else) and again when upgrading to 1.8.6.

Expected Behavior

The messaging toolkit is installed only when the project asks for it, and a project that declined it is not asked again on each upgrade.

Actual Behavior

[7b/10] Doorbell+mail toolkit (T-1867)
CREATED .claude/commands/agent-handoff.md — from template
CREATED .claude/commands/be-reachable.md — from template
CREATED .claude/commands/broadcast-chat.md — from template
CREATED .claude/commands/check-arc.md — from template
CREATED .claude/commands/conversations.md — from template
CREATED .claude/commands/peers.md — from template
CREATED .claude/commands/pulse.md — from template
CREATED .claude/commands/recent-chat.md — from template
CREATED .claude/commands/recent-dm.md — from template
CREATED scripts/agent-chat-arc-recent.sh — from template
... (twelve scripts in all)

The same 21 files come back on every upgrade after being removed.

fw doctor output
AI Agent

Claude Code

Operating System

Linux

Additional Context

Version: 1.8.6 (1ea10441f), vendored consumer. First seen on 1.8.3.

Small inconsistency: fw upgrade --help announces "scripts/doorbell+mail supporting toolkit (11 .sh)"; twelve are installed.

Suggestions:

  1. Make the toolkit opt-in (config key or --with-messaging), or at least skippable, and remember the choice.
  2. Skip the step when TermLink is absent.
  3. Do not create a project-root scripts/ directory, which collides with a very common project folder name; keep the scripts under .agentic-framework/.
  4. Say in the upgrade summary that these files enable cross-host communication.
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.