1 files changed, 28 insertions, 15 deletions
diff --git a/docs/NOTES.org b/docs/NOTES.org
index 3562f30..5319a90 100644
--- a/docs/NOTES.org
+++ b/docs/NOTES.org
@@ -1,6 +1,34 @@
 #+TITLE: ArchSetup Development Notes
 #+DATE: 2025-11-10
 
+* 2026-01-10: Dotfiles Symlink Accessibility Fix
+
+** Work Completed
+
+*** Bug Fix: Dotfiles Inaccessible After First Login
+- Diagnosed issue where zsh prompted for new user setup on first login
+- Root cause: stow created symlinks pointing to wherever archsetup was run from (e.g., /tmp/archsetup-test/ or /root/archsetup/)
+- User couldn't read dotfiles because symlinks pointed to inaccessible locations
+- Fix: archsetup now copies itself to ~/code/archsetup before running stow (archsetup:467-478)
+- Symlinks now point to user-accessible location: ~/.zshrc -> code/archsetup/dotfiles/system/.zshrc
+
+*** Test Framework Enhancement
+- Added dotfiles accessibility test to run-test.sh (lines 299-312)
+- Test uses `sudo -u cjennings cat` to verify files are readable as user (not just root)
+- Initial version using `su - cjennings` caused hangs due to full login shell; fixed to use sudo
+
+** Test Results
+- Test 20260110-014402: *PASSED* (42m 57s)
+- All validations passed including new dotfiles accessibility check
+- 1449 packages installed
+
+** Git Commit
+- 4101459: fix(archsetup): copy archsetup to user directory before stow
+
+** Context for Next Session
+- Dotfiles issue is now fixed and tested
+- Test framework has new accessibility validation to prevent regression
+
 * 2026-01-09: AI Assistants Tmux Launcher Script
 
 ** Work Completed
@@ -125,18 +153,3 @@ cat /proc/1728/environ | tr '\0' '\n' | grep -E 'GPG|TTY|DISPLAY'  # Empty - no
 - Uncommitted change: FONT=lat4a-19 (HiDPI, too small for laptop)
 - Current configuration: FONT=ter-132n (large, 32px, excellent readability)
 
-* 2025-11-16: Session Workflows Setup
-
-** Work Completed
-- Adopted session-start workflow from claude-templates
-- Executed session start routine: synced templates, checked inbox (empty), reviewed project context
-- Updated session-wrap-up workflow in both archsetup and claude-templates projects
-  - Changed archiving from time-based (7 days/2 weeks) to session-count-based (keep last 5 sessions)
-  - Updated both docs/templates/docs/workflows/session-wrap-up.org and ~/projects/claude-templates/docs/workflows/session-wrap-up.org
-- Verified all ~/.profile.d/ files are properly symlinked to ~/code/archsetup/dotfiles/system/.profile.d/
-
-** Context for Next Session
-- Outstanding TODOs from 2025-11-13 session still pending:
-  - Run verification test to confirm yay-debug is no longer installed
-  - Investigate 56 AUR package retry errors
-  - Consider if errors need to be addressed or are acceptable failures