Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[Bug]: fw upgrade reinstalls the cross-host messaging toolkit (step 7b) on every run, with no way to opt out

オープン
#89 コメント 5 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
52/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
活発
技術スタック
shell
領域
cli

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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.
主要言語
Shell
スター
16
フォーク
6
平均マージ
6時間 24分
マージ済み PR(30日)
5

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

DimitriGeelen/agentic-engineering-framework のほかの issue

DimitriGeelen/agentic-engineering-framework の issue をすべて見る

似ている issue

Shell/Bash の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。