Watcher Management Skill

This skill manages the perception layer of the Personal AI Employee - the watcher processes that monitor external sources and feed data into the Obsidian vault.

Watcher Types

Base Watcher Pattern

python
1class BaseWatcher(ABC):
2    def __init__(self, vault_path: str, check_interval: int = 60):
3        self.vault_path = Path(vault_path)
4        self.needs_action = self.vault_path / 'Needs_Action'
5        self.check_interval = check_interval
6
7    @abstractmethod
8    def check_for_updates(self) -> list:
9        pass
10
11    @abstractmethod
12    def create_action_file(self, item) -> Path:
13        pass
14
15    def run(self):
16        while True:
17            items = self.check_for_updates()
18            for item in items:
19                self.create_action_file(item)
20            time.sleep(self.check_interval)

Process Management

Use PM2 or supervisord to keep watchers running:

bash
1# Start with PM2
2pm2 start gmail_watcher.py --interpreter python3
3
4# Save and set to auto-start
5pm2 save
6pm2 startup

Reference

For detailed implementation, see reference.md

For watcher examples, see examples.md