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 を叩いたとき。

まず引数なしで dry-run して何がされるかする(デフォルトが --dry-run なので破壊的操作は起きない):
```
python3 skills/mojiemoji-github/scripts/bump_catalog.py
```
に「would add N variant(s) ...」が出たら次へ。「no new variants to add」だけならその回はスキップして終わり。
になければ --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 に出す
をユーザーにする。それだけ。

オプション

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 を呼ぶ。