fix: address CodeRabbit review findings for code quality and document…

LinuxInstallNotes.md

@@ -4,7 +4,7 @@
 
 **🎉 MAJOR UPDATES: Production-ready Linux support achieved!**
 
-The Linux support has reached production-ready status with two critical systems fully implemented:
+The Linux support has reached production-ready status with three critical systems fully implemented:
 
 ### ✅ Speaker Audio Capture (Fully Implemented)
 - **Full PulseAudio integration** via monitor sources for system audio capture
@@ -33,7 +33,7 @@ The Linux support has reached production-ready status with two critical systems
 
 ## Install
 
-My (work in progress) notes about installation on linux.
+Work-in-progress notes for Linux installation.
 
 For some information see *CONTRIBUTING.md*.
 
@@ -63,7 +63,16 @@ git clone https://github.com/fastrepl/hyprnote.git
 cd hyprnote
 
 
+# Install pnpm if not already available (requires npm/node)
+# npm install -g pnpm
+# Or follow installation instructions at: https://pnpm.io/installation
+
 # access the X Window System display without authentication
+# WARNING: This relaxes X server access control for the current local user
+# Only use when running GUI apps that require X11 access (e.g., from containers/sudo)
+# Security: Grants local user processes GUI access; avoid on multi-user systems
+# Revoke after use with: xhost -SI:localuser:$USER
+# Alternative: Use Xauthority forwarding or run without privilege escalation
 xhost +SI:localuser:$USER
 
 # add virtual echo-cancel source to allow shared access

crates/audio/src/bin/test_friendly_names.rs

@@ -1,7 +1,7 @@
 use audio::AudioInput;
 
 fn main() {
-    // Initialize tracing if available, otherwise just print
+    // Print device enumeration diagnostics to stdout
     println!("Testing friendly device name enumeration...\n");
 
     // Test microphone devices

crates/db-user/src/contacts_migration.sql

@@ -8,6 +8,7 @@ CREATE TABLE IF NOT EXISTS contacts (
   organization TEXT,
   emails TEXT NOT NULL,
   phone_numbers TEXT NOT NULL,
-  note TEXT
+  note TEXT,
+  CONSTRAINT fk_contacts_user_id FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
 );
 CREATE INDEX IF NOT EXISTS idx_contacts_user_id ON contacts(user_id);

crates/whisper-local/examples/test_model.rs

@@ -24,8 +24,12 @@ fn main() {
     }
 
     // Test with CPU only
-    let whisper = Whisper::builder()
-        .model_path(model_path.to_str().unwrap())
+    let model_path_str = model_path
+        .to_str()
+        .expect("model path contains non-UTF-8 characters");
+
+    let _whisper = Whisper::builder()
+        .model_path(model_path_str)
         .build();
 
     println!("Model initialized successfully!");