何を作るか

いまの recent は件数 (-n)でしか絞れない。「いつ以降」「何を含む発言」「誰が言ったか」は、返ってきた一覧を目で追うしかない。

足すのは 4 種の絞り込みで、すべて併用できる(AND 条件)。

決めたこと

チャットで確認した 4 点。

追加: --before (範囲検索)

チャットで出た案。--since と組にすれば「8/1 から 8/5 まで」のような範囲を表せる。書式・未来への丸めとも --since とまったく同じ規則を使う(下記)。

オプション

options.mjs の OPTIONS に足す 6 つ。すべて cmd: 'recent'(このコマンドだけで使える)。既存の形をそのまま増やすだけなので、export-options.mjs の JSON の形 (schema)は変わらない。

--since / --before の書式 (3 段)

どちらも同じパーサを共有する。上から順に試し、最初に形が合ったものを使う。

月・日・時・分・秒は 1〜2 桁のどちらでも受ける (8/1 でも 08/01 でもよい)。時刻を省くと 00:00:00、秒を省くと :00。年は 4 桁固定。

日付と時刻の区切りは、半角スペース・ハイフン・下線の 3 つを受け付ける(2026/8/1 14:30 ／ 2026/8/1-14:30 ／ 2026/8/1_14:30 はどれも同じ)。ハイフンか下線を使えば、コマンドラインでダブルクォートを省ける。スペースを使う形だけ、共通ルールの「CLI の引数はダブルクォートで囲む」に従って囲みが要る。

形を確かめたあと、月 1-12・日 1-31・時 0-23・分秒 0-59 の範囲だけ見る (うるう年等の厳密なカレンダー検査はしない)。合わなければ 3 段の書式を示してエラー (exit 2)。

--from の照合

コロンで囲んでいれば剥がし、囲んでいなければそのまま使う。どちらの形でも ID_PATTERN の文字集合を確かめてから、完全一致で絞り込む。--to／waiters の囲み必須は「前方一致で探す式に埋め込むため」の制約だが、--from は SQL の = ? による完全一致だけなので、その制約が要らない。

内部の絞り込み

索引を 1 本足す (版 6)

いまの messages は (room_id, msg_seq) の複合索引しか持たない。日時で絞る条件 (sent_at >= ?)には効かないので、(room_id, sent_at) の複合索引を足す。sent_at は yyyy/mm/dd HH:MM:SS.mmm 固定 23 文字 (版 5 で / 区切りに統一済み)なので、文字列比較がそのまま時系列比較になる。

-- src/scripts/20_migrate/ver_000006/001-messages-sent-at-index.sql
CREATE INDEX IF NOT EXISTS messages_ix_room_id_sent_at ON messages(room_id, sent_at);

絞り込みの SQL

store.mjs に getFiltered(roomId, { sinceTs, beforeTs, find, from, limit }) を足す。getLatest と同じ並び (ORDER BY msg_seq DESC LIMIT ? のあと .reverse())で、条件は渡された分だけ足す。

SELECT * FROM messages
WHERE archived_seq IS NULL AND room_id = ?
  [AND sent_at >= ?]        -- --since / --since-day / --since-hour
  [AND sent_at <  ?]        -- --before
  [AND (msg_body LIKE ? ESCAPE '\' [OR msg_body LIKE ? ESCAPE '\' …])]
  [AND from_connector_id = ?]
ORDER BY msg_seq DESC
LIMIT ?

since 側は「以降」なので >=(境界を含む)、before 側は「より前」なので <(境界を含まない)にする。境界の時刻ちょうどの発言が二重に扱われることがない。

--find の値は % _ \ をエスケープしてから LIKE に渡す。素の値だと %・_ がワイルドカードとして働き、たとえば --find "50%" が「50 のあと何でも」に化ける。エスケープすれば常にそのままの文字列を含むかだけを見る。

--find の値は | で区切ると OR 検索になる(--find "rule|ルール")。getFiltered 内で | 分割 → 前後の空白を trim → 空項を除外し、残った項ごとに (エスケープしたうえで)LIKE を OR で結ぶ。1 語だけのときは今までどおり。CLI 側の変更は無い(--find の値をそのまま find パラメータへ渡すだけなので、分割はサーバー側だけで完結する)。

大文字小文字は SQLite の既定 (ASCII だけ区別しない)。日本語には大小の区別が無いのでこの点は影響しない。実測で確認済み(--find "RULE" で本文中の rule がヒットする)。

API

GET /api/history に since_ts・before_ts・find・from_connector_id を追加する (すべて省略可)。既存の before(msg_seq によるページ送り)とは別名にし、触らない。渡さなければ今までどおりなので、画面 (chat.js の遡り読み込み)は無改修で動く。

出力の形

見出し行に何を絞ったかを出す。件数だけでは、絞り込んだ結果なのか全件なのか区別できないため。

(絞り込みなし、今までどおり)
public の直近 20 件:

(期間だけ、--since 2026/8/1)
public の 2026/08/01 00:00 以降 3 件:

(範囲、--since 8/1 --before 8/6)
public の 2026/08/01 00:00 以降 2026/08/06 00:00 より前 5 件:

(検索だけ)
public の「ルール」を含む 2 件:

(組み合わせ)
public の 2026/08/01 00:00 以降・「ルール」を含む・lightspeedc.github.io からの 1 件:

該当 0 件のときは 該当する発言がありません のように、絞り込みが効いたことが分かる文言にする (既存の「まだ何もありません」とは区別する)。

作るものと確かめること

手で確かめること

テスト用サーバー (tools/40_test/start-test-server.cmd)で行う。本番へは繋がない。

1. --since-day 1 で、1 日以内の発言だけが返ること
2. --since "2026/8/1" と --since-day/--since-hour を同時に渡すとエラー (exit 2)になること。--before とは同時に渡せること
3. 未来へ丸める分: 今日より先の月日・今日まだ来ていない時刻が、--since・--before のどちらでも同じ規則で 1 年前・1 日前に丸まること。--since 11/1 --before 11/30 が去年の 11 月 1 日〜30 日になる(今年の 11/1 と 11/30 がどちらも未来なら、両方が去年に丸まる)こと
4. --since 8/1 --before 8/6 で、その範囲だけが返ること (境界の扱い: since は含む、before は含まない)
5. --since 9/10-22:0 と --since 9/10_22:0 と --since "9/10 22:0" が、すべて同じ結果になること (区切りがスペース・ハイフン・下線のどれでも)
6. --find "ルール" で本文にその文字列を含むものだけ返ること。%・_ を含む文字列でも文字どおりに扱われること
7. --find "rule|ルール" で OR 検索になること。前後の空白・空項 ("rule| ")を無視すること。%・_ は OR の中でもワイルドカードとして働かないこと
8. --find "RULE" で本文中の rule がヒットすること (大文字小文字を区別しない)
9. --from :id: と --from id(コロン無し)の両方で、その ID からの発言だけ返ること
10. 複数を組み合わせても正しく絞れること
11. node 版と C# 版の出力が一字一句同じであること

本番サーバーの再起動