Newer
Older
TelosDB / docs / plans / folder_monitor / folder_monitor.md

計画: 指定フォルダ内のファイル追加・削除・更新を監視する仕組み

1. 目的

ユーザーが指定したフォルダを監視し、以下のイベントを検知する仕組みを用意する。

  • ファイル追加: フォルダ内に新規ファイルが作成されたとき
  • ファイル削除: フォルダ内のファイルが削除されたとき
  • ファイル更新: 既存ファイルの内容が変更されたとき

検知した結果を TelosDB の文書取り込み(ドキュメント・チャンクの登録・更新・削除)に連携し、指定フォルダと DB の内容を同期させることを想定する。

リリース目標: Windows 版の実装を v0.3.3 に含める。Phase 1〜3(単一フォルダ監視・DB 連携・設定 UI・永続化)を Windows で実装し、0.3.3 で出荷する。macOS / Linux およびネットワークフォルダの検証・ポーリングフォールバックは Phase 5 として以降のバージョンに回す。


2. 検討事項別ドキュメント

各検討事項は別ファイルに分割している。

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 等の公式ドキュメント・リンク。