feat(config): Add configurable window title capture

Introduces config.toml for centralized configuration with focus on
enabling better suggestions through richer context.

Key changes:
- New config.toml with comprehensive settings (privacy, engine, overlay, logging)
- KWin script now always sends window titles to daemon
- Daemon config controls whether titles are used/logged (not yet implemented)
- Documentation updated to emphasize functionality over privacy

Window title capture benefits:
- More targeted, context-aware suggestions
- Better pattern matching (e.g., file types, web pages)
- Improved suggestion quality and relevance

Privacy controls are opt-in restrictions that may reduce suggestion
accuracy. Recommended: enable capture_window_titles for best results.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: Coldaine

README.md

@@ -59,6 +59,28 @@ bash scripts/install-kwin-script.sh
 
 Create your config files in `~/.config/shortcut-sage/`:
 
+**config.toml**: Global settings (optional, uses defaults if not present)
+```toml
+[privacy]
+# Enable window title capture for better context-aware suggestions
+# Recommended: true for best results, false if privacy is a concern
+capture_window_titles = false
+
+# Optionally redact titles from logs (reduces audit trail quality)
+redact_titles_from_logs = true
+
+[engine]
+buffer_size_seconds = 3
+default_cooldown_seconds = 300
+max_suggestions = 3
+
+[overlay]
+position = "top-left"
+opacity = 0.9
+```
+
+See [config.toml](config.toml) for all available options.
+
 **shortcuts.yaml**: Define your shortcuts
 ```yaml
 version: "1.0"
@@ -152,9 +174,12 @@ See [implementation-plan.md](implementation-plan.md) for full roadmap.
 
 - **No keylogging**: Only symbolic events (window focus, desktop switch)
 - **Local processing**: No cloud, no telemetry
-- **Redacted by default**: Window titles not logged
+- **Flexible data capture**: Window titles configurable via config.toml for improved suggestions
+- **Optional redaction**: Separate control for logging vs. suggestion logic (if privacy preferred)
 - **Open source**: Audit the code yourself
 
+> **Note**: For best results, enable `capture_window_titles = true` in config.toml. This allows more targeted, context-aware suggestions. Privacy controls are available but may reduce suggestion quality.
+
 ## Contributing
 
 Contributions welcome! Please read our [Contributing Guide](CONTRIBUTING.md) first.

config.toml

@@ -0,0 +1,63 @@
+# Shortcut Sage Configuration
+# Place this file in your config directory (default: ~/.config/shortcut-sage/)
+
+[general]
+# Enable debug logging (verbose output)
+debug = false
+
+[privacy]
+# Capture and use window titles (captions) in suggestion logic
+# - true: Full window titles sent to daemon (e.g., "Mozilla Firefox - Stack Overflow")
+#         RECOMMENDED for better, more context-aware suggestions
+# - false: Only application resource class sent (e.g., "firefox")
+#          Limits suggestion accuracy for privacy
+#
+# Window titles enable more targeted suggestions based on:
+# - Document names (suggest Kate shortcuts when editing *.py files)
+# - Web page context (suggest browser shortcuts on specific sites)
+# - More nuanced workflow understanding
+capture_window_titles = false
+
+# Redact window titles from persistent logs (even if capture_window_titles = true)
+# Set to false if you want full audit trails for debugging/improvement
+redact_titles_from_logs = true
+
+[engine]
+# Ring buffer size in seconds (how far back to look for patterns)
+buffer_size_seconds = 3
+
+# Default cooldown in seconds (can be overridden per-rule in rules.yaml)
+default_cooldown_seconds = 300
+
+# Maximum number of suggestions to show simultaneously
+max_suggestions = 3
+
+[overlay]
+# Show the suggestion overlay
+enabled = true
+
+# Overlay position (top-left, top-right, bottom-left, bottom-right)
+position = "top-left"
+
+# Overlay offset from screen edge in pixels
+offset_x = 20
+offset_y = 20
+
+# Auto-hide overlay after N seconds (0 = never auto-hide)
+auto_hide_seconds = 0
+
+# Overlay transparency (0.0 = invisible, 1.0 = opaque)
+opacity = 0.9
+
+[logging]
+# Log format: "json" or "ndjson"
+format = "ndjson"
+
+# Log rotation: maximum file size in MB before rotation
+max_log_size_mb = 10
+
+# Number of rotated log files to keep
+max_log_files = 5
+
+# Log level: "debug", "info", "warning", "error"
+level = "info"

kwin/event-monitor.js

@@ -5,13 +5,15 @@
  *
  * Events monitored:
  * - Desktop/workspace switches
- * - Window focus changes
+ * - Window focus changes (including window titles for better context)
  * - Show desktop state changes
  *
  * Dev shortcut: Meta+Shift+S sends a test event
  *
- * Privacy: Window titles are NOT captured by default - only resource classes
- * (application IDs) are sent to maintain user privacy.
+ * Window titles are sent to improve suggestion accuracy. The daemon's
+ * config.toml controls whether titles are used for suggestions and/or
+ * logged. Configure privacy.capture_window_titles to balance accuracy
+ * vs. privacy based on your preferences.
  */
 
 // DBus connection to Shortcut Sage daemon
@@ -138,7 +140,7 @@ workspace.clientActivated.connect(function(client) {
             "window_focus",
             "window_activated",
             {
-                // caption: client.caption,  // Uncomment to include window titles (privacy trade-off)
+                caption: client.caption,
                 resourceClass: client.resourceClass || "unknown"
             }
         );