sync: update from private repo (2336949a)

docs/tools/searchworkspacetasks.md

@@ -27,7 +27,8 @@
 
 | 名前 | 必須 | 説明 |
 |------|------|------|
-| `query` | ○（`around_ref` と排他） | 検索キーワード |
+| `query` | ○（`around_ref` と排他） | 検索キーワード。1 語または少数の語を推奨 |
+| `match_mode` | | 複数語の一致方法。`any`（既定）はいずれかの語、`all` はすべての語を含む結果に限定 |
 | `around_ref` | ○（`query` と排他） | `"comment:<id>"` 形式。指定した comment の前後を読む |
 | `context` | | 各ヒットに付す前後コメント件数（grep -C 相当）。既定 0、最大 5 |
 | `limit` | | 最大ヒット件数。既定 10、最大 30（`query` モードのみ） |
@@ -41,7 +42,9 @@
 
 日本語も含めた部分一致検索を trigram tokenize の FTS5 インデックスで行う。**3 文字未満の語は trigram で MATCH できないため、そのような語が含まれるクエリは自動的に LIKE（部分一致）にフォールバックする**（挙動は同じだが遅い）。
 
-**複数語はスペース区切りの暗黙 AND（Google 的）**。`ログイン 認証` と入力すると「ログイン」と「認証」を**両方含む**コメントにヒットする（語順・位置は問わない）。フレーズ一致ではないので、離れて出現していても両語があればヒットする。各語は内部で個別に引用してから AND で結合するため、`AND`/`OR`/`NEAR`/`*`/`"` などの記号が語に混ざっても FTS5 演算子としては解釈されない（＝ユーザー側から任意の演算子検索や `OR` 検索を差し込むことはできない）。広く探したいときは 1 語で、絞りたいときは語を足す。
+1 語または少数のキーワードで検索する。複数語の既定は `match_mode: "any"` で、いずれかの語を含むコメントを対象に、FTS5 の関連度順で返す。`ログイン 認証` なら「ログイン」だけ、または「認証」だけを含むコメントも候補になり、両方を強く含むコメントほど上位になりやすい。すべての語を含むコメントだけに絞る場合は `match_mode: "all"` を指定する（語順・位置は問わない）。各語は内部で個別に引用してから OR または AND で結合するため、`AND`/`OR`/`NEAR`/`*`/`"` などが語に混ざっても FTS5 演算子としては解釈されない。
+
+短い語を含むため LIKE にフォールバックした場合も、`any` は OR、`all` は AND として一致する。LIKE 経路では関連度を計算できないため、結果は新しいコメント順になる。
 
 SQLite のビルドが FTS5 に対応していない環境では、検索機能自体が使えない旨のメッセージを返す（エラーにはしない）。
 
@@ -85,3 +88,16 @@ SQLite のビルドが FTS5 に対応していない環境では、検索機能
 ## 関連ツール
 
 - `SearchTaskConversation` / `ReadTaskConversation` — 現在タスク自身の会話（コメント＋transcript）を検索・閲覧する。他タスクへは到達できない。こちらは同じスペースの他タスクを横断検索する対
+
+## ListWorkspaceTasks（一覧の相棒ツール）
+
+内容の検索ではなく「同じワークスペースにどんなタスクがあるか」を俯瞰したいときは `ListWorkspaceTasks` を使う。
+
+- `ListWorkspaceTasks({})` — 他タスクを新しい順に一覧（ID・状態・タイトル・piece・最終更新）。既定 20 件、`limit` で最大 50 件
+- `ListWorkspaceTasks({ state: "open" })` — 進行中のみ / `"closed"` — 完了のみ
+- スコープは SearchWorkspaceTasks と同一（同じスペースのみ・現在のタスクは除外）
+- 一覧で目星をつけたら `SearchWorkspaceTasks({ query: "...", task_id: <id> })` で中身を検索する使い方が典型
+
+## 0 件時の複合句自動分割（2026-07-24）
+
+スペースを含まない日本語の複合句（例: `満月の周期の計算`）は 1 語＝フレーズ完全一致として扱われ、構成語が索引にあっても 0 件になることがある。`match_mode: "any"`（既定）で 0 件だった場合、助詞・句読点で分割した語群（例: `満月 周期 計算`）による再検索が自動で 1 回走り、結果の先頭に分割再検索した旨の注記が付く。最初からスペース区切りの単語で query を書けばこのフォールバックは不要。