@uehaj/sys1grep 0.5.0-next.0 → 0.5.0-next.1

package/README.ja.md

@@ -13,7 +13,7 @@ Jev は文章を生成せず、typed な質問に確率だけを返すモデル
 ./sys1grep -n -e "顧客が怒っている、または不満を持っている" tickets.txt
 ```
 
-[![sys1grep のデモ: 日本語の意味で 6 言語の返金要求を探す / 「返金について」と「返金を求めている」の違い / -Q で答えを探す](docs/demo.svg)](https://uehaj.github.io/sys1grep/)
+[![sys1grep のデモ: 日本語の意味で 6 言語の返金要求を探す / 「返金について」と「返金を求めている」の違い / -Q で答えを探す](docs/demo.svg)](https://uehaj.github.io/jev-semgrep/)
 
 <sub>▶ デモをクリックするか <a href="https://uehaj.github.io/sys1grep/">uehaj.github.io/sys1grep</a> を開くと、ランディングページで全編のデモが見られます。</sub>
 
@@ -122,8 +122,7 @@ top-k か質問ごとの閾値調整が要ります。また索引を作らず
 その項の意味を尋ねられるので、意味の前に安い正規表現を置くと、費用も待ち時間も下がります。行が送られるのは、
 どれかの項の正規表現がすべて当たったときだけです（正規表現の無い項はどの行にも当たる扱い）。そのため
 `-e '/re/' -a A -e B` では、`re` を含まない行も送られ、`B` だけを尋ねられます。正規表現項だけの式は何も
-送りません。ただし `--sentence`（既定の `=jev`）は折り返しの切れ目を Jev に尋ねるので、送らずに済ませたい
-ときは `--sentence=rules` を使います。`/…/flags` の形をしていないものは今まで通り意味です。`-e '/etc 以下のファイルを変更している'`
+送りません。`--unit=sentence-by-jev` でも、そのときは折り返しのつなぎ方を規則だけで決めます。`/…/flags` の形をしていないものは今まで通り意味です。`-e '/etc 以下のファイルを変更している'`
 （閉じる `/` が無い）は影響を受けません。本当に `/` で始まり `/` で終わる意味は、正規表現と誤認されない
 よう先頭にスペースを置けます。
 
@@ -159,23 +158,50 @@ $ ./sys1grep -o -n -e '/[A-Z]+-\d+/' -a 'チケットがまだ閉じていない
 Jev に送る行が増えるほど、費用も時間もかかります。いちばん安いのは、送らずに済ませた行です。絞り方を、
 大きく削れるものから順に並べます。
 
-- **どのファイルを探すか。** `-r` は `.git`、`node_modules`、バイナリ、秘密情報らしいファイル、git が無視する
+- **どのファイルを探すか。** `-r` は `.git`、`node_modules`、バイナリ、秘密情報らしいファイル、生成されたファイル
+  （ソースマップ、minify 済み JS/CSS、ロックファイル）、git が無視する
   ものを飛ばします。[`git sys1grep`](#git-のサブコマンドとして-git-sys1grep) は追跡しているファイルだけを探します。
   `--include` / `--exclude`（ファイル名のグロブ）と `--changed-within`（`30m`、`7d`、`today`、`this-week`、日付）で
   さらに絞れます。言語や変更時期を指定する意味は、それだけでファイルを絞ります
   ([意味からの絞り込み](#意味からの絞り込み))。
 - **どの行を送るか。** [正規表現項](#正規表現項)はローカルで判定し、当たった行だけが同じ AND 項の意味を
-  尋ねられます。空行は送りません。
+  尋ねられます。空行は送りません。`-M`/`--max-columns`（既定 2000、`-z` なら 8000）を超える行は、
+  先頭からその文字数までだけを送ります。判定はそれでも行われ、超えた先にしか無い一致だけが見つかりません。
 - **何回判定するか。** [`--dedup`](#テンプレートごとに-1-行だけ判定する---dedup) は、ID・数値・時刻・パスだけが
   違う行をまとめて、テンプレートごとに 1 行だけ判定します。
-- **払う前に確かめる。** `--dry-run` は何も送らず、検索するファイル、ファイルごとの送る行数、各リクエストと
-  その質問を表示します。最後の行には入力トークン数と、TypeSafe 本体なら料金の見積もりが出ます
-  （`~3178 input tokens, ~$0.000133`。誤差 1 割程度）。`-i` は同じ集計を端末に出し、`y` と答えたときだけ送ります。
+- **払う前に確かめる。** `--dry-run` は何も送らず、この検索が使う設定、検索するファイル、ファイルごとの
+  送る行数、各リクエストとその質問を表示します。最後の行には入力トークン数と、TypeSafe 本体なら料金の
+  見積もりが出ます（`~3178 input tokens, ~$0.000133`。誤差 1 割程度）。`-i` は同じ集計を端末に出し、
+  `y` と答えたときだけ送ります。
+  リクエストの本体を送る前に、まず対象のサイズ（`--max-filesize`、既定 10M）を計測し、超えるものは
+  rg の `--max-filesize` と同じく無条件に飛ばして stderr に名前を出します（`-y` は効きません）。`.gz` は
+  展開後の大きさで計測します（上限で展開を止めるので、大きすぎるものを全部展開することはありません）。標準入力は
+  読んでから（すでにメモリ上にあるので）計測し、超えていれば同じく飛ばします。`--cached` / `<tree>:` の
+  対象はファイルではなく blob なので、その内容（`git cat-file --batch` で一括して読んだもの。blob ごとに
+  git を起動し直しません）から計測します。`-g` のコミットはここに含まれません。送るときにすでに `-M` で
+  上限があるからです。
+  送る予定のトークンの値段（`--max-cost`、既定 1 USD）は別に見積もり、超えていれば端末で続けるか聞きます。
+  `-y` は聞かずに yes と答え、端末が無く超えていれば終了コード 2 です（`-q` でも同じで、スクリプトからは
+  `-y` を渡します）。
 
 ```sh
 $ sys1grep --dry-run -r --include='*.log' --changed-within=today -e '/ERROR|FATAL/' -a '顧客に影響が出ている' logs/
 ```
 
+`--verbose`（や `--dry-run`）は、コマンドラインで指定しなかった設定が*どこから*来たか
+（`SYS1GREP_OPTS`、環境変数、`~/.config/sys1grep/.env`、プリセットの既定値のいずれか）も表示するので、
+想定と違う結果をその設定まで辿れます。キーの値は表示せず、どのオプションや変数が渡したかだけを表示します。
+
+```sh
+$ SYS1GREP_OPTS='--level strict' sys1grep --verbose -e "APIキーがファイルから読まれている" .
+sys1grep: endpoint api.typesafe.ai/v1/systemone (default), model jev-latest (default)
+sys1grep: key: SYS1GREP_API_KEY (~/.config/sys1grep/.env)
+sys1grep: SYS1GREP_OPTS: --level strict
+sys1grep: options: --level strict (SYS1GREP_OPTS) = -t 0.7 -T 0.3, --chunk 30, -j 8, scope on, -M 2000, --max-filesize 10M, --max-cost 1
+sys1grep: file ./a.py: 120 lines, 120 to send
+…
+```
+
 ## インストール
 
 使い方は 2 通りあります。コマンドラインツールとして使う（この節）か、Claude Code のスキルとして使う
@@ -369,12 +395,17 @@ tests/tickets/sub/b.txt
 `-r` はディレクトリを名前順にたどり、`.git`、`node_modules`、`.ssh`、`.aws`、`.gnupg`、`.kube`、`.docker`、
 バイナリ（先頭 8 KB に NUL がある、または PDF。BOM 付きの UTF-16 はテキストとして読む）、
 秘密情報になりがちなファイル（`.env*`、`.netrc`、`.npmrc`、`.pypirc`、`.pgpass`、`.git-credentials`、`*.pem`、
-`*.key`、`*.p12`、`*.pfx`、`*.jks`、`*.keystore`、`id_rsa*` など。大文字小文字は区別しない）を飛ばします。
+`*.key`、`*.p12`、`*.pfx`、`*.jks`、`*.keystore`、`id_rsa*` など。大文字小文字は区別しない）、
+生成されたファイル（`*.map`、`*.min.js`、`*.min.css`、`package-lock.json`、`yarn.lock`、`pnpm-lock.yaml`、
+`Cargo.lock`、`poetry.lock`、`composer.lock`、`Gemfile.lock`、`go.sum`）を飛ばします。
 **検索対象の行はすべて TypeSafe の API に送られる**ので、スキャンするつもりのディレクトリだけを指定してください。
 git リポジトリの中では、git が無視するもの（`.gitignore`、`.git/info/exclude`、グローバルの除外ファイル）も `-r` で
 飛ばすので、ビルド成果物や手元だけのファイルは送られません。追跡中のファイルは、無視パターンに当たっても検索します。
 コマンドラインで明示したファイルは、除外リストに該当しても、git が無視していても検索します。git が無視している
 ディレクトリも、名前を指定すれば検索します（`sys1grep -r -e ... dist`）。
+`*.gz`（ローテートしたログ `app.log.1.gz`）は `zgrep` のように展開して読み、ディスク上の名前で表示します
+（`app.log.1.gz:12:...`）。`--include='*.gz'` で選べ、バイナリ判定は展開後のバイトで行い、壊れた `.gz` は
+読めないファイルとして扱います。圧縮した秘密情報らしいファイル（`private.key.gz`）は元と同じく飛ばします。gzip だけ、名前だけで判断します。
 `-l` は一致したファイルを見つかった順に 1 回ずつ表示し、`-r` の有無にかかわらず使えます。`-c` は行の代わりにファイルごとの一致行数を出します。
 
 ### 意味からの絞り込み
@@ -438,6 +469,26 @@ FILE を省くとカレントディレクトリ以下の追跡ファイルを全
 「いま変わった」扱いになります。
 ヘルプは `git sys1grep -h` です（`--help` は git が横取りして man ページを探しに行きます）。
 
+`--cached`、`--untracked`、`<tree>...` は作業ツリーの代わりに探す対象を選びます。`git grep` と同じで、
+3 つのうち同時に使えるのは 1 つだけです。
+
+```sh
+$ git sys1grep --cached -e "リトライしている"       # ステージ済み、未コミットの変更も含む
+$ git sys1grep --untracked -e "リトライしている"    # 追跡ファイルに加え未追跡ファイルも (.gitignore は効いたまま)
+$ git sys1grep -n -e "リトライしている" main v0.3.1 -- '*.py'
+main:src/job.py:42:    retry(job, times=3)
+v0.3.1:src/job.py:40:    retry(job)
+```
+
+`<tree>`（ブランチ・タグ・コミット・`@{u}`）は `--` の前に置いた、リビジョンとして解決できる引数です。複数指定でき、
+指定順に探し、各行には解決前の名前をそのまま付けます (`@{u}:path` であって、解決したブランチ名ではありません)。
+`--changed-within` は作業ツリーが要ります。blob（`--cached`、`<tree>`）には自分の mtime がないためです。
+`<tree>` 自身の pathspec も sys1grep の他の場所と同じくグロブが使えます（空の tree との `git diff-tree` を使い、
+`git ls-tree` 自身のリテラル・ディレクトリ前方一致のみのルールには従いません）。`--include` / `--exclude`
+（名前で絞る方）はそのまま使えます。
+**古い `<tree>` には、後で削除された秘密情報が普通のファイルとして残っていることがあります**。スキップ対象は
+名前で判定するだけで、変更履歴では判定しません。
+
 ### 「〜でない」行を全部
 
 ```sh
@@ -465,15 +516,15 @@ $ git log -z --format='%h %s %b' | ./sys1grep -z -n -e "ユーザーに見える
 ファイル名 (`-l`) と件数 (`-c`) は grep と同じく改行のままです。`-z` のとき `-n` はレコード番号、
 `-A` / `-B` / `-C` は前後のレコード数、`--chunk` は 1 リクエストのレコード数を数えます。
 
-### 1 文ずつ判定する (`--sentence`)
+### 1 文ずつ判定する (`--unit=sentence-by-*`)
 
-`--sentence` を付けると、行ではなく文ごとに判定します。出力は grep と同じく行のままです。当たった文がかかる
+`--unit=sentence-by-jev`（または後述の `sentence-by-rule`）を付けると、行ではなく文ごとに判定します。出力は grep と同じく行のままです。当たった文がかかる
 行をすべて出し、端末では文の部分を太字の黄で強調します（その中の正規表現の一致は grep と同じ太字の赤）。文に分ける前に折り返した行をつなぐので、
 複数行にまたがる文も 1 文として判定します。[`tests/prose.txt`](tests/prose.txt) には、折り返した英語と日本語の
 段落が入っています。
 
 ```sh
-$ ./sys1grep -n --sentence -e "the author admits they made a mistake" tests/prose.txt
+$ ./sys1grep -n --unit=sentence-by-jev -e "the author admits they made a mistake" tests/prose.txt
 1:I should have checked the input
 2:before shipping, and that was my
 3:mistake. Next time I will add a test
@@ -485,14 +536,14 @@ $ ./sys1grep -n --sentence -e "the author admits they made a mistake" tests/pros
 端末で意味を 2 つ渡し、`-C 3` で前後も出すと、文がどこで始まりどこで終わるかが色で分かります。3 行目と 9 行目は、当たった文の
 終わりまでだけ色が付き、4〜7 行目は文脈行（`-`）です:
 
-![--sentence -C 3 --color: 当たった文が太字の黄になる。3 行目は mistake. まで、9 行目は 返金してほしいです。 まで。4〜7 行目は文脈行](docs/sentence.svg)
+![--unit=sentence-by-jev -C 3 --color: 当たった文が太字の黄になる。3 行目は mistake. まで、9 行目は 返金してほしいです。 まで。4〜7 行目は文脈行](docs/sentence.svg)
 
 `-o` を付けると、当たった文だけを 1 行ずつ出します。`grep -o` が一致した部分だけを出すのと同じです。
 `-n` は文が始まる行の番号になります。日本語は空白を入れずにつなぎます。単語の間に空白を置かない
 中国語・タイ語・ラオ語・クメール語・ミャンマー語・チベット語も同様です。
 
 ```sh
-$ ./sys1grep -n -o --sentence -e "the author admits they made a mistake" -e "customer is asking for a refund" tests/prose.txt
+$ ./sys1grep -n -o --unit=sentence-by-jev -e "the author admits they made a mistake" -e "customer is asking for a refund" tests/prose.txt
 1:I should have checked the input before shipping, and that was my mistake.
 8:先週買った掃除機が初日から動かないので返金してほしいです。
 ```
@@ -500,19 +551,19 @@ $ ./sys1grep -n -o --sentence -e "the author admits they made a mistake" -e "cus
 `-o` なしでは、`-c` と `-A` / `-B` / `-C` はいつもどおり行で数えます。`-o` 付きでは文で数えます。
 `-z` と併用すると、レコードごとに文に分け、当たったレコードをまるごと出します。
 
-Jev は長い行の中からでも当たる文を自分で見つけるので、判定の精度のために `--sentence` を使う必要はありません。
+Jev は長い行の中からでも当たる文を自分で見つけるので、判定の精度のために `--unit=sentence-by-jev` を使う必要はありません。
 どの文が当たったかを見たいとき、`-o` で文そのものが欲しいとき、AND を 1 つの文の中で成り立たせたいときに
 使います。式は文ごとに評価されます。そのため、`-v X` だけの式では「X でない文を 1 つでも含む行」がすべて出ます。
-行全体として X でないものを探すなら、`--sentence` を付けずに使います。
+行全体として X でないものを探すなら、`--unit` を `line` のままにします。
 
 日本語や中国語では、チャットの発言、問い合わせ、メモの 1 行など、`。` で終わらない 1 行 1 件のデータがよくあります。
-これをつなぐと、別々の項目が 1 つの「文」になってしまいます。そこで既定（`--sentence`、`--sentence=jev` と同じ）では、
+これをつなぐと、別々の項目が 1 つの「文」になってしまいます。そこで `--unit=sentence-by-jev` では、
 単語の間に空白を置かない文字に接する、句点の無い改行について、Jev に「この改行は文や項目の終わりか、文の途中の
 折り返しか」を聞きます。30 行を 1 リクエストにまとめて改行ごとに yes/no を聞き、0.7 以上なら行をつなぎません。
-[`tests/corpus.txt`](tests/corpus.txt) では、これで日本語の問い合わせ 4 件が 1 件ずつに分かれ、`--sentence` でも
+[`tests/corpus.txt`](tests/corpus.txt) では、これで日本語の問い合わせ 4 件が 1 件ずつに分かれ、`--unit=sentence-by-jev` でも
 行単位の検索と同じ返金の要求（14 行目と 18 行目）が見つかります。規則だけでは問い合わせがつながり、18 行目を
 取りこぼしていました。追加のリクエストの費用は、意味を 1 つ増やすのと同じくらいです。避けたいときは
-`--sentence=rules` を使います。英語どうしの改行は聞きません。つないでも空白が残り、ピリオドで文が切れるためです。
+`--unit=sentence-by-rule` を使います。英語どうしの改行は聞きません。つないでも空白が残り、ピリオドで文が切れるためです。
 
 改行が文の途中になりえないところでは、行をつなぎません。空行、括弧や `;` に接する改行（JSON やコード）、
 `-` `*` `+` `#` `>` `"` や数字で始まる行（箇条書き、見出し、引用、番号、日時）の前です。そのため JSONL は
@@ -521,6 +572,36 @@ Jev は長い行の中からでも当たる文を自分で見つけるので、
 `Mr.` のような略語の後ろでも切ります。ログは文章ではないので、`ERROR ...` の次の `WARN ...` のように
 英字で始まるログ行が続くと、つながります。
 
+### 関数ごとに判定する (`--unit=function`)
+
+コードについての問いは、たいてい関数についての問い（「ネットワーク障害で再試行している」）で、関数の 1 行だけでは
+そうと分かりません。`--unit=function` は関数ごとに判定し、当たった関数の行を出します。`-n` はファイルの行番号です。
+
+```sh
+$ ./sys1grep -n --unit=function -e "ネットワーク障害で再試行している" src/net.js
+src/net.js:3:async function fetchWithRetry(url) {
+src/net.js:4:  for (let i = 0; i < 5; i++) {
+src/net.js:5:    try { return await fetch(url); }
+src/net.js:6:    catch { await sleep(2 ** i * 100); }
+src/net.js:7:  }
+src/net.js:8:}
+```
+
+関数は、関数名の行から次の関数名の行の前までです（`git grep -W` と同じ）。最初の関数名の行より前の行は 1 つの単位に
+なり、関数の末尾の空行は出力しません。関数名の行は git と同じく、`.gitattributes` の `diff=<driver>` 属性と、git config の
+`diff.<driver>.xfuncname` で決めます。無ければ、JavaScript/TypeScript（トップレベルの `function`・`class`、関数を
+代入する `const` / `let` / `var`）と Python（入れ子も含む `def` / `class`）は sys1grep の規則を使い（デコレータの行 `@retry` から関数が始まる）、それ以外は git の既定
+（英字・`_`・`$` で始まる行）を使います。git 組み込みのドライバ（`diff=python` など）は読まないので、`xfuncname` の無い
+ドライバも同じように扱います。
+
+```sh
+$ printf '*.go diff=golang\n' >> .gitattributes
+$ git config diff.golang.xfuncname '^(func|type)[[:space:]]'
+```
+
+`-M` の既定は `-z` と同じ 8000 文字で、それより長い関数は先頭 8000 文字で判定します。`--chunk` は関数の数、
+`-A`/`-B`/`-C` と `-c` は文の単位と同じく行の数を数えます。`-z`・`-g`・`-o` とは併用できません。
+
 ### テンプレートごとに 1 行だけ判定する (`--dedup`)
 
 費用は送るテキストの量に比例します。機械が吐くログの大半は、ID や数値だけが違う同じ骨格の繰り返しです。
@@ -543,7 +624,7 @@ Jev に聞き、その種類はまとめません（上の 2 リクエストの
 値を何も残さずにまとめた場合の実測では、43,071 行のシステムログが 550 テンプレート（バイト数で 1.2%）に、
 `install.log` が 21.1% に縮みました。Claude Code のトランスクリプト（jsonl）は 56.8% までしか縮みません。
 機械が吐くログ向けの機能で、散文には共通の骨格がなく、時刻を読む意味ではほとんど縮みません。
-`-z` や `--sentence` では、行ではなくレコードや文をまとめます。
+`-z` や `--unit=sentence-by-*` では、行ではなくレコードや文をまとめます。
 
 検索後の集計行には、まとめたことで浮いた分が `(2 folded by --dedup, ~235 input tokens / ~$0.000010 saved, 21%)`
 のように出ます（上の例）。まとめた行を別のリクエストとして送った場合の推定値から、値の種類を聞いたリクエストの費用を引いた
@@ -571,15 +652,44 @@ $ sys1grep -r -n --summarize -e "API キーをファイルから読んでいる"
 を尋ねた例では、Claude の入力が 22,059 トークンから 1,356 に、Jev を含む総額が $0.094 から $0.013 に下がり、答えは同じでした（#69）。
 答えが少数の行にあるときに効きます。
 
-- 一致した行はもう一度マシンの外へ、Anthropic に送られます。
+- 一致した行はもう一度マシンの外へ、Anthropic（や TOOL の接続先）に送られます。
 - `-n`・`-A/-B/-C`・`-p`・ファイル名は表示どおりに渡し、色は付けません。一致がなければ何も渡しません（終了コード 1）。
-- `SYS1GREP_SUMMARIZER` は値を付けない `--summarize` の TOOL を（今は `claude` だけ）、`SYS1GREP_SUMMARIZER_MODEL` はそのモデルを決めます。
+- `SYS1GREP_SUMMARIZER` は値を付けない `--summarize` の TOOL を、`SYS1GREP_SUMMARIZER_MODEL` はそのモデルを決めます。
 - `-q`・`-l`・`-c` は行を出さないので、一緒には使えません。
+- 答えはプレーンテキストです。何も言わなければ LLM は Markdown で書き、端末では雑音になるので、plain を頼みます。
+  `--summarize-format=markdown` か `=html` でそれらを頼めます（`… --summarize-format=html … > summary.html`）。
+  答えは確かめずにそのまま表示します。`SYS1GREP_OPTS` に書けば常用の設定になり、`--summarize` が無いときは無視します。
 - `--dedup` では、Jev に送ったものと同じく、テンプレートごとの代表を 1 回だけ `(×N like it)` を付けて渡します。
   答えを使い回したすべての行は渡しません。
 - 200 KB（約 5 万トークン）を超えるときは何も渡さず、大きさを示して終了コード 2 で止まります。TOOL の費用がかかる前です。
   先頭だけの要約は全体の要約に見えてしまうので、切り詰めはしません。
 
+`--summarize-prompt=TEXT` で固定の指示の後に自分の指示（長さ・観点など）を足せます。
+
+```sh
+$ sys1grep -r -n --summarize --summarize-prompt="3 行以内で。どのファイルを直せばよいかだけ" \
+    -e "API キーをファイルから読んでいる" .
+```
+
+`--summarize` が要ります。空の TEXT は指定しないのと同じです。`--summarize-format` の文より後に置くので、TEXT で書式を上書きできます。
+
+他の TOOL:
+
+```sh
+$ sys1grep --summarize=llm -e "..." FILE            # Simon Willison 氏の llm、ツールなし (-T を渡さない)
+$ sys1grep --summarize=pi -e "..." FILE             # pi --print --no-tools --no-session ...
+$ SYS1GREP_SUMMARIZER_MODEL=qwen3.5:9b sys1grep --summarize=ollama -e "..." FILE
+$ SYS1GREP_SUMMARIZER_MODEL=some-id sys1grep --summarize=lmstudio -e "..." FILE   # モデル id は GET /v1/models から
+$ SYS1GREP_SUMMARIZER_MODEL=some-id sys1grep --summarize=http://localhost:8080/v1 -e "..." FILE  # llama.cpp・vLLM・LocalAI・ゲートウェイ
+```
+
+`ollama` と `lmstudio` はローカルの OpenAI 互換サーバ (`POST /v1/chat/completions`) へ `fetch` で直接送ります。
+CLI を挟まないので、一致した行がもう一度マシンの外へ出ることはありません。素の `http(s)://` URL は他の
+OpenAI 互換サーバ全般です。3 つとも `SYS1GREP_SUMMARIZER_MODEL` が要ります（既定モデルが無いため）。
+`SYS1GREP_SUMMARIZER_API_KEY` は URL の TOOL にだけ `Authorization: Bearer` として送られます
+（Jev 用の `SYS1GREP_API_KEY` は送りません）。`OLLAMA_HOST` で ollama 側のホストを変えられます
+（`ollama` CLI 自体と同じ）。
+
 ## Claude Code から使う
 
 sys1grep を代わりに走らせてくれる Claude Code のスキルがあります。探したいものを言葉で書くと、式を組み立てて
@@ -633,7 +743,11 @@ usage: sys1grep [OPTION]... -e MEANING|-Q QUESTION [-a MEANING] [-v MEANING]...
   -T THRESH    否定条件の閾値。確率 < THRESH で「〜でない」と判定 (--level より優先)
                -t 0.6 -T 0.3 なら 0.3〜0.6 の曖昧な行はどちらにも当たらない
   -r           ディレクトリを再帰的に探す (FILE 省略時はカレント)。.git、node_modules、
-               バイナリ、秘密情報らしいファイル、git が無視するものは飛ばす
+               バイナリ、秘密情報らしいファイル、生成されたファイル、git が無視するものは飛ばす
+  --cached     git sys1grep 限定。作業ツリーではなくインデックスを探す (git grep --cached と同じ)
+  --untracked  git sys1grep 限定。追跡ファイルに加え未追跡ファイルも探す (.gitignore は効いたまま。git grep --untracked と同じ)
+  <tree>...    git sys1grep 限定。-- の前のブランチ・タグ・コミット・@{u} はそのリビジョンのツリーを探す
+               (git grep と同じ)。出力には <tree>: を付け、名前は解決前のまま表示する
   --include=GLOB, --exclude=GLOB  -r と git sys1grep で、名前が GLOB に合うファイルだけ (または合わないものだけ) を探す
                (-r ではコマンドラインで指定したファイルは必ず探す。git sys1grep の pathspec は絞り込む)
   --changed-within=WHEN  -r と git sys1grep で、30m / 2h / 7d / 2w 以内、日付か日時以降、today / this-week /
@@ -651,13 +765,26 @@ usage: sys1grep [OPTION]... -e MEANING|-Q QUESTION [-a MEANING] [-v MEANING]...
                判定も変わる
   -j N         同時リクエスト数 (既定 8)
   -n           行番号を付ける
-  -z, --null-data  行ではなく NUL 終端のレコードごとに判定し、NUL 終端で出力する (前述の「複数行にまたがるレコード」を参照)
-  --sentence[=HOW] 行ではなく文ごとに判定する。HOW は jev (既定) か rules (前述の「1 文ずつ判定する」を参照)
-  -o           --sentence と併用し、当たった文だけを出す
+  --unit=UNIT  判定の単位: line (既定)、zero、sentence-by-jev、sentence-by-rule、function
+  -z, --null-data  --unit=zero。行ではなく NUL 終端のレコードごとに判定し、NUL 終端で出力する (前述の「複数行にまたがるレコード」を参照)。
+               --unit=sentence-by-* と併用すると、レコードごとに文に分ける
+  --unit=sentence-by-jev|sentence-by-rule  行ではなく文ごとに判定する (前述の「1 文ずつ判定する」を参照)
+  --unit=function  関数ごとに判定し、当たった関数の行を出す (前述の「関数ごとに判定する」を参照)
+  -o           --unit=sentence-by-* と併用し、当たった文だけを出す
   -p           各意味の確率を行末に表示 (閾値調整用)
-  --dry-run    何も送らず、送信先・検索するファイル・各リクエストとその質問を表示
+  --dry-run    何も送らず、この検索が使う設定 (コマンドラインでなければその出どころも)・検索するファイル・
+               各リクエストとその質問を表示
   --verbose    同じ表示を検索しながら stderr に出す
   -i, --interactive  --dry-run と同じ内容を見せ、端末で y と答えたときだけ検索する
+  -M NUM, --max-columns=NUM  行 (-z ならレコード) の先頭 NUM 文字までを送る。判定はそれでもされる
+               (NUM より先にしか無い一致だけ見つからない)。既定 2000、-z なら 8000
+  --max-filesize=SIZE  対象を先に計測 (K/M/G、既定 10M)。超えるものは rg の --max-filesize と同じく
+               無条件に飛ばす (-y は効かない)。標準入力は読んでから計測し、超えていれば同じく飛ばす。
+               --cached / <tree>: の対象は blob で、その内容から計測する。-g のコミットはここに
+               含まれない (送るときに -M ですでに上限がある)
+  --max-cost=USD  送る予定の入力を見積もって値段を出す。超えれば (既定 1) 端末で続けるか聞く。
+               -y は聞かずに yes と答える。端末が無く超えていれば終了コード 2、-q でも変わらない
+               (スクリプトからは -y)。-i は無条件かつこれより前に聞くので二重には聞かない
   --dedup      テンプレートごとに 1 行だけ判定し、その答えを残りにも使う (前述の「テンプレートごとに 1 行だけ判定する」を参照)
   --color[=WHEN] 色付け。auto (端末なら付ける、既定) / always / never。=WHEN 省略時は auto
                ファイル名・行番号は grep と同じ配色。-p の確率は閾値以上を緑、
@@ -742,14 +869,14 @@ fmt -w 100000 essay.txt | sys1grep -n -e "the author admits they made a mistake"
 
 出力の 1 行が 1 段落になり、`-n` は元のファイルではなく `fmt` の出力の行番号になります。`fmt` は日本語の行をつなぐとき
 間に空白を入れますが、Jev の判定には響きません。折り返しをまたぐ文を判定したいだけなら、どちらも要りません。
-`--sentence` が行をつないで文に分けます。
+`--unit=sentence-by-jev` が行をつないで文に分けます。
 
 ### 会話記録の JSONL を、発言 1 件ずつ判定したい
 
 `jq` で本文を取り出し、発言ごとに NUL で終えてから、`-z` でレコードとして判定します。
 
 ```sh
-jq -j '.content + "\u0000"' chat.jsonl | sys1grep -z -n --sentence -e "the customer is asking for a refund" | tr '\0' '\n'
+jq -j '.content + "\u0000"' chat.jsonl | sys1grep -z -n --unit=sentence-by-jev -e "the customer is asking for a refund" | tr '\0' '\n'
 ```
 
 `.content` は、本文が入っている場所に合わせて書き換えてください。発言 1 件が 1 レコードになるので、文が次の話者の