new view, gnome extension

gnome-extension/README.md

@@ -13,8 +13,7 @@ A GNOME Shell extension that displays your current deskmeter task in the top pan
 1. Copy the extension to your GNOME extensions directory:
 
 ```bash
-cp -r /home/mariano/wdir/dm/gnome-extension/deskmeter-indicator@local \
-  ~/.local/share/gnome-shell/extensions/
+cp -r /home/mariano/wdir/dm/gnome-extension/deskmeter-indicator@local ~/.local/share/gnome-shell/extensions/
 ```
 
 2. Restart GNOME Shell:
@@ -31,10 +30,12 @@ Or use GNOME Extensions app (install with `sudo apt install gnome-shell-extensio
 
 ## Configuration
 
-The extension polls the API every 3 seconds. You can adjust this in `extension.js`:
+The extension updates automatically when you switch workspaces. It waits 2.2 seconds after a workspace switch to allow dmcore (which polls every 2 seconds) to detect the change and update MongoDB.
+
+You can adjust the delay in `extension.js`:
 
 ```javascript
-const UPDATE_INTERVAL = 3000; // milliseconds
+const DEBOUNCE_DELAY = 2200; // milliseconds
 ```
 
 The API URL is set to:
@@ -52,6 +53,28 @@ rm -rf ~/.local/share/gnome-shell/extensions/deskmeter-indicator@local
 
 Then restart GNOME Shell.
 
+## Updating the Extension
+
+After making changes to the extension code:
+
+```bash
+# Use the update script
+cd /home/mariano/wdir/dm/gnome-extension
+./update.sh
+
+# Then restart GNOME Shell (X11 only)
+Alt+F2, type: r, press Enter
+
+# On Wayland: log out and back in
+```
+
+Or manually:
+```bash
+cp -r /home/mariano/wdir/dm/gnome-extension/deskmeter-indicator@local \
+  ~/.local/share/gnome-shell/extensions/
+# Then restart GNOME Shell
+```
+
 ## Troubleshooting
 
 ### Extension not showing
@@ -66,6 +89,12 @@ Then restart GNOME Shell.
    journalctl -f -o cat /usr/bin/gnome-shell
    ```
 
+3. Try disabling and re-enabling:
+   ```bash
+   gnome-extensions disable deskmeter-indicator@local
+   gnome-extensions enable deskmeter-indicator@local
+   ```
+
 ### Shows "offline" or "error"
 
 - Ensure dmweb Flask server is running on port 10000
@@ -75,6 +104,16 @@ Then restart GNOME Shell.
   ```
   Should return JSON like: `{"task_id":"12345678","task_path":"work/default"}`
 
+### Changes not appearing
+
+- Make sure you copied files after editing
+- GNOME Shell must be restarted (no way around this)
+- Check logs for JavaScript errors: `journalctl -b -o cat /usr/bin/gnome-shell | grep deskmeter`
+
+### Debug with Looking Glass
+
+Press `Alt+F2`, type `lg`, press Enter. Go to Extensions tab to see if the extension loaded and check for errors.
+
 ### Task path too long
 
 The extension automatically truncates paths longer than 40 characters, showing only the last two segments with a `.../ ` prefix.