session: fix dotfiles symlink accessibility issue

Diagnosed and fixed bug where stow created symlinks to inaccessible locations.
Added test to verify dotfiles are readable by user. Full test passed in 42m 57s.

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