ユーザーが指定したフォルダを監視し、以下のイベントを検知する仕組みを用意する。
検知した結果を TelosDB の文書取り込み(ドキュメント・チャンクの登録・更新・削除)に連携し、指定フォルダと DB の内容を同期させることを想定する。
リリース目標: Windows 版の実装を v0.3.3 に含める。Phase 1〜3(単一フォルダ監視・DB 連携・設定 UI・永続化)を Windows で実装し、0.3.3 で出荷する。macOS / Linux およびネットワークフォルダの検証・ポーリングフォールバックは Phase 5 として以降のバージョンに回す。
各検討事項は別ファイルに分割している。
| No. | 項目 | ファイル | 内容 |
|---|---|---|---|
| 01 | スコープ | folder_monitor_01_scope.md | 対応プラットフォーム、監視対象の種類・パス・深さ、対象ファイル、動作タイミング。 |
| 02 | 技術方針 | folder_monitor_02_tech.md | notify、デバウンス、ネットワーク・フォールバック、プラットフォーム別注意点、Config、既存機能連携、設定保存。 |
| 03 | 実装方針(OS・プロトコル別) | folder_monitor_03_os_protocol.md | OS × ファイルプロトコル別の Watcher 選択、判定、共通処理。 |
| 04 | 実装ステップ | folder_monitor_04_phases.md | Phase 1〜5 の実装順序。テスト・検証(単体・結合・手動・UI/E2E・Phase 別)を含む。 |
| 05 | 注意事項・未決定 | folder_monitor_05_considerations.md | 権限、パス正規化、ネットワーク制約、大容量フォルダ、UI。 |
| 06 | 参照・調査元 | folder_monitor_06_references.md | notify / debouncer / inotify / macOS 等の公式ドキュメント・リンク。 |