name	herdr-gaps
description	herdr の機能ギャップ一覧(private gist)を棚卸しする。上流 ogulcancelik/herdr の実装状況を照会し、解決済み項目を Resolved へ移動して gist を更新する。引数 `add <text>` で新しいギャップを追記。herdr の足りない機能・不満点の管理はすべてこの skill 経由で行う。

herdr-gaps

herdr に足りてない機能の一覧を管理する。データは private gist(write-many メモ)、この skill は棚卸しロジックのみ。

Gist ID: cd60ae40193d7340ca534812a3565162(https://gist.github.com/ShotaKitazawa/cd60ae40193d7340ca534812a3565162 、ファイル名 herdr-gaps.md)
gist の構成はデータのみ: ## 検査状況(検査済みバージョン)/ ## Gaps / ## Resolved / ## 検査履歴。運用ルールの説明は gist に書かず、この skill に集約する
一覧には「純粋な機能ギャップ」だけを書く。バンプ・コミット・報告などの作業 TODO は書かない(作業はその都度の会話で扱う)。ユーザーは任意の端末から Web / gh gist edit で直接追記することがある
gh コマンドは必ず GH_HOST=github.com を明示する(GHES がデフォルトの端末でも gist / 上流照会が github.com に向くように)

gist には ## 検査状況(どのバージョンのリリース内容まで一覧に反映済みか)と ## 検査履歴 があり、この skill が維持する。検査済みバージョンより新しいリリースが上流にないときは項目ごとの照会をスキップする(余計な検索をしないため)。

手順(引数なし = 棚卸し)

一覧を取得する:

GH_HOST=github.com gh api gists/cd60ae40193d7340ca534812a3565162 --jq '.files["herdr-gaps.md"].content'

## 検査状況 の検査済みバージョンと上流の最新リリースを比較する:
```
GH_HOST=github.com gh release list --repo ogulcancelik/herdr --limit 1
```
- 最新リリース ≤ 検査済みバージョンなら手順 3〜4 をスキップし、herdr status とだけ突き合わせて報告して終了(ローカルが検査済みバージョンより古ければ更新で直る項目に言及)。force 引数付きで呼ばれた場合のみスキップせず全照会する
## Gaps の各項目について上流の状態を照会する:
- discussion リンク付きの項目は GraphQL で closed / stateReason を確認:
```
GH_HOST=github.com gh api graphql -f query='query { repository(owner: "ogulcancelik", name: "herdr") { discussion(number: N) { closed stateReason comments(first: 10) { nodes { body } } } } }'
```
- closed かつ "moved to issue ..." コメントがあれば昇格先 issue を確認:
```
GH_HOST=github.com gh issue view N --repo ogulcancelik/herdr --comments
```
- kangal-bot のコメントマーカーで判定する:  = そのバージョンでリリース済み、 = master 実装済み・未リリース
ローカルのバージョンと突き合わせ、分類する: herdr status(client と server 両方。server が古いままなら live-handoff 未実施の可能性に言及)
- 未実装: 上流 open のまま → 一覧に残す
- 実装済み・要更新: released バージョン > ローカル → 更新すれば解決することを報告(更新作業自体はこの skill の範囲外)
- 解決済み: released バージョン ≤ ローカル → - [x] にして ## Resolved セクションへ移動
gist を更新する(gh gist edit はエディタが開くので使わない。API で非対話更新):
- 手順 3〜4 を実施した場合は必ず ## 検査状況 の検査済みバージョンを照会した最新リリースに書き換え、## 検査履歴 に 1 行追記する(日付、検査したバージョン、移動・変化した項目の要約)。項目に変化がなくてもこの 2 箇所は更新する(次回のスキップ判定のため)
```
jq -n --rawfile c <更新後ファイル> '{files: {"herdr-gaps.md": {content: $c}}}' \
  | GH_HOST=github.com gh api -X PATCH gists/cd60ae40193d7340ca534812a3565162 --input - > /dev/null
```
結果を要約して報告する(未実装 n 件 / 要更新 n 件 / 解決済みとして移動 n 件 / 検査済みバージョン)。

手順(`add <text>`)

## Gaps の末尾に - [ ] <text> を追記して手順 5 と同じ方法で PATCH する(検査状況・検査履歴は変更しない)。上流に対応する discussion/issue が既にないか軽く検索し(GH_HOST=github.com gh search issues --repo ogulcancelik/herdr ... と GraphQL の DISCUSSION search)、見つかればリンクを添える。

参考: herdr 本体の更新手順(pane を殺さずに)

トリガー: 棚卸し(引数なし手順)を実施した直後の会話で、ユーザーが「では更新して」「アップデートして」のように更新を指示したら、確認を挟まず本節の手順 1〜4 を通しで実行する(「実装済み・要更新」の報告がなくても、単に手元の herdr を最新化したいだけの場合も含めてこの手順で良い)。バイナリは aqua 管理。herdr update / herdr update --handoff は herdr 自前の配布チャネルからバイナリを入れて aqua と二重管理になるため使わない:

dotfiles リポジトリ(chezmoi source-path で場所を確認する。パスは端末ごとに異なりうるので決め打ちしない)の aqua.yaml にある ogulcancelik/herdr@vX.Y.Z をバンプする。この時点ではまだ chezmoi のソースを変えただけで $HOME 側には反映されない
chezmoi apply を実行する。dotfiles の aqua.yaml は chezmoi 管理下にあり、実体は chezmoi target-path aqua.yaml で確認できる場所($HOME 配下)。dotfiles 側を直接編集しただけでは反映されないため、この一手を飛ばさない
- chezmoi apply は aqua 関連の後続フック(cd $HOME && aqua i && aqua vacuum 相当)を実行し、その中で新バージョンのバイナリが aqua のパッケージキャッシュに取得される(PATH 上の client も新バージョンになるが、稼働中 server は旧のまま)。go-delve/delve など herdr と無関係なパッケージがアセット欠落で失敗してフック全体がエラー終了することがあるが、herdr 自体のダウンロードが成功していれば無視してよい(ログで package_name=ogulcancelik/herdr の行にエラーが出ていないか確認する)
live handoff でサーバを切り替える。--import-exe の指定が必須:
```
# 実体パスは `aqua root-dir` を起点に解決する(環境によって root-dir・OS/arch・ファイル名が変わるため決め打ちしない)
IMPORT_EXE=$(find "$(aqua root-dir)/pkgs/github_release/github.com/ogulcancelik/herdr/vX.Y.Z" -type f | head -1)
herdr server live-handoff \
  --import-exe "$IMPORT_EXE" \
  --expected-version X.Y.Z
```
- 罠: --import-exe を省略すると、旧サーバが自分自身の実体パス(aqua の pkgs 配下はバージョン固定パス)を再 exec するため、handoff は成功表示でも旧バージョンのまま立ち上がり直る(0.7.3→0.7.4 更新時に実際に踏んだ)
- pane 内のプロセス(ssh・エージェント等)は生きたまま引き継がれる
herdr status で client / server の両方が新バージョンになり restart_needed: no であることを確認する

上流リポジトリの規約(照会時の前提)

ogulcancelik/herdr の Issues はバグ専用。feature request は bot に closed され、Discussions(Ideas)が要望チャネル
新しく要望を出すときは他の discussion をクロスリファレンスせず単独で書く(ユーザーの方針)
リリース判定は上記 kangal-bot マーカーが一次情報。リリースノート(GH_HOST=github.com gh release view vX.Y.Z --repo ogulcancelik/herdr)は補助

herdr-gaps

herdr に足りてない機能の一覧を管理する。データは private gist(write-many メモ)、この skill は棚卸しロジックのみ。

Gist ID: cd60ae40193d7340ca534812a3565162(https://gist.github.com/ShotaKitazawa/cd60ae40193d7340ca534812a3565162 、ファイル名 herdr-gaps.md)

gist の構成はデータのみ: ## 検査状況(検査済みバージョン)/ ## Gaps / ## Resolved / ## 検査履歴。運用ルールの説明は gist に書かず、この skill に集約する

一覧には「純粋な機能ギャップ」だけを書く。バンプ・コミット・報告などの作業 TODO は書かない(作業はその都度の会話で扱う)。ユーザーは任意の端末から Web / gh gist edit で直接追記することがある

gh コマンドは必ず GH_HOST=github.com を明示する(GHES がデフォルトの端末でも gist / 上流照会が github.com に向くように)

手順(引数なし = 棚卸し)

一覧を取得する:

GH_HOST=github.com gh api gists/cd60ae40193d7340ca534812a3565162 --jq '.files["herdr-gaps.md"].content'

## 検査状況 の検査済みバージョンと上流の最新リリースを比較する:

GH_HOST=github.com gh release list --repo ogulcancelik/herdr --limit 1

最新リリース ≤ 検査済みバージョンなら手順 3〜4 をスキップし、herdr status とだけ突き合わせて報告して終了(ローカルが検査済みバージョンより古ければ更新で直る項目に言及)。force 引数付きで呼ばれた場合のみスキップせず全照会する

## Gaps の各項目について上流の状態を照会する:

discussion リンク付きの項目は GraphQL で closed / stateReason を確認:

GH_HOST=github.com gh api graphql -f query='query { repository(owner: "ogulcancelik", name: "herdr") { discussion(number: N) { closed stateReason comments(first: 10) { nodes { body } } } } }'

closed かつ "moved to issue ..." コメントがあれば昇格先 issue を確認:
```
GH_HOST=github.com gh issue view N --repo ogulcancelik/herdr --comments
```
kangal-bot のコメントマーカーで判定する:  = そのバージョンでリリース済み、 = master 実装済み・未リリース

ローカルのバージョンと突き合わせ、分類する: herdr status(client と server 両方。server が古いままなら live-handoff 未実施の可能性に言及)

未実装: 上流 open のまま → 一覧に残す
実装済み・要更新: released バージョン > ローカル → 更新すれば解決することを報告(更新作業自体はこの skill の範囲外)
解決済み: released バージョン ≤ ローカル → - [x] にして ## Resolved セクションへ移動

gist を更新する(gh gist edit はエディタが開くので使わない。API で非対話更新):

手順 3〜4 を実施した場合は必ず ## 検査状況 の検査済みバージョンを照会した最新リリースに書き換え、## 検査履歴 に 1 行追記する(日付、検査したバージョン、移動・変化した項目の要約)。項目に変化がなくてもこの 2 箇所は更新する(次回のスキップ判定のため)

jq -n --rawfile c <更新後ファイル> '{files: {"herdr-gaps.md": {content: $c}}}' \
  | GH_HOST=github.com gh api -X PATCH gists/cd60ae40193d7340ca534812a3565162 --input - > /dev/null

結果を要約して報告する(未実装 n 件 / 要更新 n 件 / 解決済みとして移動 n 件 / 検査済みバージョン)。

手順(add <text>)

参考: herdr 本体の更新手順(pane を殺さずに)

dotfiles リポジトリ(chezmoi source-path で場所を確認する。パスは端末ごとに異なりうるので決め打ちしない)の aqua.yaml にある ogulcancelik/herdr@vX.Y.Z をバンプする。この時点ではまだ chezmoi のソースを変えただけで $HOME 側には反映されない

chezmoi apply を実行する。dotfiles の aqua.yaml は chezmoi 管理下にあり、実体は chezmoi target-path aqua.yaml で確認できる場所($HOME 配下)。dotfiles 側を直接編集しただけでは反映されないため、この一手を飛ばさない

chezmoi apply は aqua 関連の後続フック(cd $HOME && aqua i && aqua vacuum 相当)を実行し、その中で新バージョンのバイナリが aqua のパッケージキャッシュに取得される(PATH 上の client も新バージョンになるが、稼働中 server は旧のまま)。go-delve/delve など herdr と無関係なパッケージがアセット欠落で失敗してフック全体がエラー終了することがあるが、herdr 自体のダウンロードが成功していれば無視してよい(ログで package_name=ogulcancelik/herdr の行にエラーが出ていないか確認する)

live handoff でサーバを切り替える。--import-exe の指定が必須:

# 実体パスは `aqua root-dir` を起点に解決する(環境によって root-dir・OS/arch・ファイル名が変わるため決め打ちしない)
IMPORT_EXE=$(find "$(aqua root-dir)/pkgs/github_release/github.com/ogulcancelik/herdr/vX.Y.Z" -type f | head -1)
herdr server live-handoff \
  --import-exe "$IMPORT_EXE" \
  --expected-version X.Y.Z

罠: --import-exe を省略すると、旧サーバが自分自身の実体パス(aqua の pkgs 配下はバージョン固定パス)を再 exec するため、handoff は成功表示でも旧バージョンのまま立ち上がり直る(0.7.3→0.7.4 更新時に実際に踏んだ)
pane 内のプロセス(ssh・エージェント等)は生きたまま引き継がれる

herdr status で client / server の両方が新バージョンになり restart_needed: no であることを確認する

上流リポジトリの規約(照会時の前提)

ogulcancelik/herdr の Issues はバグ専用。feature request は bot に closed され、Discussions(Ideas)が要望チャネル

新しく要望を出すときは他の discussion をクロスリファレンスせず単独で書く(ユーザーの方針)

リリース判定は上記 kangal-bot マーカーが一次情報。リリースノート(GH_HOST=github.com gh release view vX.Y.Z --repo ogulcancelik/herdr)は補助

herdr-gaps

herdr-gaps

手順(引数なし = 棚卸し)

手順(add <text>)

参考: herdr 本体の更新手順(pane を殺さずに)

上流リポジトリの規約(照会時の前提)

More from this repository

More from this repository

herdr-gaps

手順(引数なし = 棚卸し)

手順(add <text>)

参考: herdr 本体の更新手順(pane を殺さずに)

上流リポジトリの規約(照会時の前提)

手順(`add <text>`)

手順(`add <text>`)