## Plan

1. **Commit the already-applied fix in `devplacepy/database/schema.py`**  
   - The missing migration lines are already present in the working tree (unstaged). Stage and commit them:  
     ```bash
     git add devplacepy/database/schema.py
     git commit -m "Add missing gateway_embed_key migration from env"
     ```

2. **Update documentation (`devplacepy/services/openai_gateway/CLAUDE.md`)**  
   - In the section describing migrations (line 66), add mention that `gateway_embed_key` is also migrated from `OPENROUTER_API_KEY` on first boot.

3. **Ensure a working Python environment for verification commands**  
   - The earlier failures occurred because `pip install` tried to modify the system Python. The fix is to create and use a virtual environment:  
     ```bash
     python3 -m venv /tmp/verify_env
     source /tmp/verify_env/bin/activate
     ```

4. **Run the project’s verification commands inside the venv**  
   - `pip install -e '.[dev]' -q && make test-unit`  
   - `pip install -q ruff && ruff check .`

5. **If any tests or lint fail, diagnose and fix** (unlikely, given the minimal change).

6. **Revert the CLAUDE.md change if any, or keep it – final check.**

## Definition of Done

- The file `devplacepy/database/schema.py` contains the new migration block (lines 1206–1208) **committed in HEAD**.  
- `devplacepy/services/openai_gateway/CLAUDE.md` has been updated (if deemed necessary) to mention the `gateway_embed_key` migration.  
- A clean virtual environment (`/tmp/verify_env`) is used to run the project’s verification commands.  
- `pip install -e '.[dev]' -q && make test-unit` **exits with code 0**.  
- `pip install -q ruff && ruff check .` **exits with code 0**.  
- All git changes are committed (no uncommitted modifications).  
- The commit message references the ticket (e.g., “Fix empty gateway_embed_key causing embeddings API fallback to invalid key”).