bump-catalog

name	bump-catalog
description	Promote frequently used mojiemoji variants from the local usage cache into prestamp-catalog.yml and open a deterministic catalog update pull request.
allowed-tools	["Bash(python3 skills/mojiemoji-github/scripts/bump_catalog.py*)","Bash(python3 */skills/mojiemoji-github/scripts/bump_catalog.py*)"]

Bump Catalog

mojiemoji-github インの catalog をローカル usage cache から 的に育てる skill。selector subagent が catalog miss した term に flavor を選定したとき、cache_record.py が JSONL にする。 この skill はその cache を集計して、しきい値を満たした variant を prestamp-catalog.yml に昇格させる を 1 件作る。

全工程はトークン・LLM ・論的。 この本体は単にスクリプトを呼ぶだけ。

起動条件

ユーザーが明示的に「catalog を育てて」「bump-catalog 走らせて」など 要求したとき。あるいは /bump-catalog を叩いたとき。

1. まず引数なしで dry-run して何がされるかする(デフォルトが --dry-run なので破壊的操作は起きない):

   python3 skills/mojiemoji-github/scripts/bump_catalog.py
   

   に「would add N variant(s) ...」が出たら次へ。「no new variants to add」だけならその回はスキップして終わり。

2. になければ --pr を付けて本実行する:

   python3 skills/mojiemoji-github/scripts/bump_catalog.py --pr
   

   --pr がやること:

   • usage.jsonl を読む($MOJIEMOJI_CACHE_FILE または ${XDG_DATA_HOME:-~/.local/share}/mojiemoji-plugin/usage.jsonl)
   • 閾値(デフォルト 2)を満たした variant を diff として抽出
   • variant とまったくの flavor はスキップ
   • prestamp-catalog.yml をマージ
   • plugin.json の patch version を bump
   • clean tree + git fetch origin main && git checkout main && git pull
   • feat/auto-catalog-grow-<yyyymmdd> ブランチを切って commit + push
   • gh pr create --assignee @me で を作成
   • を stdout に出す

3. をユーザーにする。それだけ。

オプション

• catalog だけしたい( は手で出す)なら --apply:

  python3 skills/mojiemoji-github/scripts/bump_catalog.py --apply
  

  これは prestamp-catalog.yml のマージのみ。plugin.json も触らず git 操作もしない。

• 閾値を変えたいなら --threshold N (デフォルト 2)。1 件単位でも 複利が効くというで、しきい値は低めに保つのが。

まとめ

	catalog	plugin.json	git/
--dry-run (default)	—	—	—
--apply	✓	—	—
--pr	✓	✓ (patch bump)	✓

• このは catalog のマージのみを担当する。人間レビューは — auto-merge は。
• スクリプトは Phase 1 (: GitHub Issue #46)。今後の Phase で GitHub Actions による週次 cron、公開 cache 集約方法などをする予定。

枯渇時 (#92 / #93)

usage.jsonl が空 / ほぼ空のときは bump-catalog を回しても "no new variants to add" しか出ない。これは selector subagent が 起動していないサイン (prestamp 過剰化による)。draft markdown が あるなら /mojiemoji-propose <path> を先に回して、未 stamp の 2-8 字 本語連続を selector に投げて cache にしてから bump-catalog を 呼ぶ。