diff --git a/.agent/workflows/dev-environment.md b/.agent/workflows/dev-environment.md deleted file mode 100644 index 737ef79..0000000 --- a/.agent/workflows/dev-environment.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -description: How the development environment works and how to manage it ---- - -# Pulse Development Environment - -This is a **development-only machine**. Production is never run here. - -## Primary Service: `pulse-hot-dev` - -The dev environment uses a **single systemd service** that runs both backend and frontend with hot-reloading: - -```bash -# Status check -systemctl status pulse-hot-dev - -# Restart (if needed) -// turbo -sudo systemctl restart pulse-hot-dev - -# View logs -journalctl -u pulse-hot-dev -f -``` - -### What `pulse-hot-dev` does: -1. **Go Backend** (`./pulse`): Monitored by `inotifywait` - auto-rebuilds and restarts when `.go` files change -2. **Vite Frontend**: HMR enabled - browser updates instantly when frontend files change - -### Access URLs: -- **Frontend**: http://192.168.0.123:5173/ (Vite dev server with HMR) -- **Backend API**: http://192.168.0.123:7655/ (Go server, proxied through Vite) - -## DO NOT USE these services in development: -- `pulse.service` - This is for production (runs pre-built binary without hot-reload) -- Do NOT create separate `pulse-frontend.service` - the hot-dev script handles everything - -## When things don't work: - -1. **Frontend not loading at :5173** → Check if `pulse-hot-dev` is running -2. **Backend changes not reflected** → Check logs: `journalctl -u pulse-hot-dev -f` -3. **Need full restart** → `sudo systemctl restart pulse-hot-dev` - -## Key Files: -- **Hot-dev script**: `/opt/pulse/scripts/hot-dev.sh` -- **Systemd service**: `/etc/systemd/system/pulse-hot-dev.service` -- **Makefile targets**: `make dev` or `make dev-hot` - -## Encryption Key Monitoring - -A watcher service monitors the encryption key file for any changes or deletions: - -```bash -# Check if the watcher is running -systemctl status encryption-key-watcher - -# View recent encryption key events -sudo journalctl -u encryption-key-watcher -n 50 - -# View events around a specific time -sudo journalctl -u encryption-key-watcher --since "2025-12-09 14:00" --until "2025-12-09 15:00" -``` - -If the key ever goes missing, the logs will show what event happened and which processes had files open in `/etc/pulse` at that time. diff --git a/.gitignore b/.gitignore index 431a06a..81f66e9 100644 --- a/.gitignore +++ b/.gitignore @@ -157,3 +157,4 @@ tmp_*.sh # Local agent directories scripts/agent/ docs/internal/ +.agent/