Document VT overview and workflow rules

scripts/git_converter/ai-speak.md

@@ -12,6 +12,15 @@
 
 ---
 
+## 🧭 **Project Overview (VideoTools & lt-convert)**
+- VideoTools is a professional GUI suite focused on DVD-compliant output (MPEG-2 NTSC/PAL), AC-3 audio, and DVDStyler/PS2 compatibility.
+- Core app: Go-based modular architecture (convert/queue/ui/player), batch queue with pause/resume/history, smart framerate/audio conversion, aspect handling, and validation.
+- Scripts: `lt-convert.sh` provides cross-platform hardware-accelerated AV1/HEVC conversions with modular bash components (hardware/codec/quality/filters/encode).
+- Key docs: `README.md` (overview), `INSTALLATION.md`, `DVD_USER_GUIDE.md`, `DVD_IMPLEMENTATION_SUMMARY.md`, `QUEUE_SYSTEM_GUIDE.md`, `INTEGRATION_GUIDE.md`, `BUILD_AND_RUN.md`.
+- Current Linux display focus is Wayland-first while retaining X11 support; VT_Player is moving to GTK and not yet functional.
+
+---
+
 ## 📖 **HOW TO USE THIS FILE (For Stu's AI)**
 
 ### **🔍 READING THIS FILE:**
@@ -62,14 +71,14 @@
 ## 🎯 **Priority Tasks**
 
 ### 🚨 **High Priority**
-- [ ] Test on actual Wayland Linux system
+- [ ] Test on actual Wayland Linux system (primary target) while keeping X11 support
 - [ ] Verify drag-and-drop works across different desktop environments
 - [ ] Performance testing with various video formats
-
-### 📈 **Medium Priority**
 - [ ] Add progress bars for long conversions
 - [ ] Implement batch queue processing
-- [ ] Add subtitle support (burn-in/soft-subs)
+
+### 📈 **Medium Priority**
+- [ ] Add subtitle support (burn-in/soft-subs) once core modules stabilize
 - [ ] Create comprehensive test suite
 
 ### 🔮 **Future Enhancements**
@@ -95,6 +104,9 @@
 
 ## 💬 **Conversation Log**
 
+### 2025-12-14 - Line endings + sync
+**Stu's AI:** Added `.gitattributes` to enforce LF endings for all shell scripts, preventing Windows CRLF issues. Pulled/merged Jake's latest `lt-convert.sh` changes and set the script executable bit. Repo is clean and up to date on `master`.
+
 ### 2025-12-14 - Initial Cross-Platform Fixes
 **Stu's AI:** "My friend Stu uses Wayland Linux and he said that drag and drop function onto 'lt-convert.sh' did not work for him. He said that it also did not detect video files within his current folder."
 
@@ -129,7 +141,7 @@
 **Status:** ⏳ **AWAITING TEST RESULTS**
 **Testers:** 
 - User: Windows ✅ (confirmed working)
-- Stu: Linux Wayland 🔄 **PENDING**
+- Stu: Linux Wayland 🔄 **PENDING** (after pulling latest `.gitattributes` + executable bit)
 
 **Expected Results:**
 - Drag files onto script → Should process them
@@ -145,6 +157,8 @@
 - Windows timeout fallback uses manual process killing
 - Some Wayland desktop environments may have different drag-and-drop behavior
 - Hardware detection varies by Linux distribution
+- Wayland is the primary Linux target; X11 support must be preserved
+- VT_Player is moving to GTK; current GTK player support is not yet functional
 
 ### **Technical Debt**
 - Consider replacing bash arrays for better portability
@@ -156,8 +170,8 @@
 ## 🔄 **Next Steps**
 
 1. **Immediate:** Get feedback from Stu on Wayland testing
-2. **Short-term:** Address any compatibility issues found
-3. **Medium-term:** Implement progress indicators
+2. **Short-term:** Address any compatibility issues found; add progress bars and batch queue processing
+3. **Medium-term:** Build comprehensive test suite; plan subtitle support once core is stable
 4. **Long-term:** Consider GUI frontend development
 
 ---
@@ -166,6 +180,11 @@
 
 **For Stu's AI:** When working on this project, please:
 
+### **Workflow Rules**
+- Commit after every meaningful change; keep commits small and descriptive.
+- Update `TODO.md` and `DONE.md` to reflect new work, completed tasks, and testing results.
+- Keep this `ai-speak.md` in sync with priorities, logs, and testing status.
+
 ### **🔄 When Changes Are Made:**
 1. **IMMEDIATELY UPDATE** this file with any suggestions or changes
 2. Mark completed tasks with [x]
@@ -213,5 +232,3 @@
 - Linux: `lspci`/`lshw` hardware detection, `timeout` command
 
 ---
-
-*"Great software is not born, it's built through collaboration and testing across diverse environments."*