add onboard/offboard member scripts with LLM bio generation

Author: jeremymanning

AGENTS.md

@@ -0,0 +1,136 @@
+# CONTEXTUAL DYNAMICS LAB WEBSITE
+
+**Generated:** 2026-01-08
+**Commit:** 4f62f4b
+**Branch:** main
+
+## OVERVIEW
+
+Static website for Contextual Dynamics Lab (Dartmouth). Content pages auto-generated from Excel spreadsheets via Python build system. GitHub Pages hosting.
+
+## STRUCTURE
+
+```
+contextlab.github.io/
+├── *.html              # 7 pages (index, research, people, publications, software, news, contact)
+├── css/style.css       # Single stylesheet, 1897 lines, CSS variables
+├── js/main.js          # All interactive components (359 lines)
+├── data/*.xlsx         # Content source: publications, people, software, news
+├── templates/*.html    # HTML templates with <!-- MARKER --> injection points
+├── scripts/            # Python build system (see scripts/AGENTS.md)
+├── images/             # Assets: people/, publications/, software/, research/, news/
+├── documents/          # CV files (JRM_CV.tex → .pdf, .html)
+└── tests/              # pytest suite for build system
+```
+
+## WHERE TO LOOK
+
+| Task | Location | Notes |
+|------|----------|-------|
+| Add publication | `data/publications.xlsx` | Auto-builds via GitHub Actions |
+| Add team member | `scripts/onboard_member.py` | Processes photo, generates bio, updates CV |
+| Offboard member | `scripts/offboard_member.py` | Moves to alumni, updates CV |
+| Add software | `data/software.xlsx` | |
+| Add news | `data/news.xlsx` | Thumbnail in `images/news/` |
+| Update CV | `documents/JRM_CV.tex` | Auto-compiles to PDF+HTML |
+| Fix styling | `css/style.css` | See CSS variables at top |
+| Fix JS behavior | `js/main.js` | 9 init functions |
+| Modify page structure | `templates/*.html` | NOT root *.html (auto-generated) |
+| Build system | `scripts/` | See scripts/AGENTS.md |
+
+## CONVENTIONS
+
+### Color Theme (CSS Variables)
+```css
+--primary-green: rgb(0, 112, 60);
+--bg-green: rgba(0, 112, 60, 0.2);
+--dark-text: rgba(0, 0, 0, 0.7);
+```
+
+### Typography
+- All headings: lowercase (`text-transform: lowercase`)
+- Font: Nunito Sans (300 weight body, 300-700 headings)
+- Base: 14px, 1.7 line-height
+
+### Images
+- Publication thumbnails: 500x500px with hand-drawn green border
+- People photos: Use `scripts/add_borders.py --face` for consistent styling
+- Border templates in `images/templates/WebsiteDoodles_Posters_v1.svg`
+
+### Template System
+- Templates use `<!-- MARKER_NAME -->` for content injection
+- Markers replaced by build scripts with generated HTML
+- DO NOT edit root `publications.html`, `people.html`, `software.html`, `news.html` directly
+
+## ANTI-PATTERNS
+
+- **NEVER edit auto-generated HTML** (publications, people, software, news) - changes will be overwritten
+- **NEVER use `!important`** in CSS without explicit justification
+- **NEVER add inline styles** to templates - use CSS classes
+- **NEVER commit without running tests** - `python -m pytest tests/ -v`
+
+## COMMANDS
+
+```bash
+# Local development server
+python3 -m http.server 8000
+
+# Validate spreadsheet data
+cd scripts && python validate_data.py
+
+# Build all content pages
+cd scripts && python build.py
+
+# Build CV only
+cd scripts && python build_cv.py
+
+# Run full test suite
+python -m pytest tests/ -v
+
+# Pre-push validation
+cd scripts && python pre_push_check.py
+
+# Add borders to images
+python scripts/add_borders.py image.png images/publications/
+python scripts/add_borders.py photo.jpg images/people/ --face
+
+# Onboard a new lab member
+cd scripts && python onboard_member.py "First Last"
+cd scripts && python onboard_member.py "First Last" --rank "grad student"
+cd scripts && python onboard_member.py "First Last" --photo headshot --bio "Bio text..."
+cd scripts && python onboard_member.py "First Last" --skip-llm
+
+# Offboard a lab member (move to alumni)
+cd scripts && python offboard_member.py "member name"
+cd scripts && python offboard_member.py "name" --end-year 2025
+cd scripts && python offboard_member.py --list-no-photo
+```
+
+## GITHUB ACTIONS
+
+| Workflow | Trigger | Action |
+|----------|---------|--------|
+| `build-content.yml` | Push to data/, templates/, scripts/ | Validate + build + commit HTML |
+| `build-cv.yml` | Push to documents/JRM_CV.tex | Compile LaTeX to PDF+HTML |
+
+## JS COMPONENTS
+
+| Function | Purpose |
+|----------|---------|
+| `initDropdowns()` | Footer nav dropdown menus |
+| `initStickyNav()` | Show/hide footer nav on scroll |
+| `initSlideshow()` | Image carousel with autoplay |
+| `initModal()` | Modal open/close (join-us form) |
+| `initSmoothScroll()` | Anchor link scrolling |
+| `initInfoPanel()` | Homepage "i" button toggle |
+| `initContactForms()` | Formspree AJAX submission |
+| `initMobileMenu()` | Hamburger menu toggle |
+| `initCustomValidation()` | Green-themed validation tooltips |
+
+## NOTES
+
+- Forms use Formspree backend - endpoint in form `action` attribute
+- Homepage brain animation: static PNG, CSS transforms on toggle
+- Footer nav always visible (no scroll threshold on homepage)
+- Bluesky feed integration on news page (see `news.html`)
+- CV uses Dartmouth Ruzicka fonts (`data/DartmouthRuzicka-*.ttf`)

README.md

@@ -185,7 +185,39 @@ scripts/                       # Build scripts
    - `image` - Thumbnail filename (optional, place image in `images/publications/`)
 4. Save and push to GitHub (or run build locally)
 
-#### Adding a New Team Member
+#### Adding a New Team Member (Automated)
+
+Use the onboarding script for the easiest experience:
+
+```bash
+cd scripts
+
+# Basic onboarding (will auto-generate bio)
+python onboard_member.py "First Last"
+
+# With role and bio
+python onboard_member.py "First Last" --rank "grad student" --bio "Bio text here..."
+
+# With photo (searches Downloads, Desktop, images/people/)
+python onboard_member.py "First Last" --photo headshot_filename
+
+# With website
+python onboard_member.py "First Last" --website "https://example.com"
+
+# Skip LLM bio processing (use simple default)
+python onboard_member.py "First Last" --skip-llm
+```
+
+The script will:
+- Process the photo with a hand-drawn border (using face detection)
+- Generate or edit the bio using a local LLM (gpt-oss-20b)
+- Add the member to `people.xlsx`
+- Add the member to `JRM_CV.tex`
+- Rebuild `people.html`
+
+**Idempotent**: Running twice with the same name updates the existing entry.
+
+#### Adding a New Team Member (Manual)
 
 1. Open `data/people.xlsx` in Excel/Google Sheets
 2. Go to the `members` sheet
@@ -197,7 +229,34 @@ scripts/                       # Build scripts
    - `image` - Photo filename (place photo in `images/people/`)
 4. Save and push to GitHub
 
-#### Adding Alumni
+#### Offboarding a Team Member (Moving to Alumni)
+
+Use the offboarding script to move members from active to alumni:
+
+```bash
+cd scripts
+
+# Offboard a member (will prompt for confirmation)
+python offboard_member.py "member name"
+
+# Specify end year
+python offboard_member.py "member name" --end-year 2025
+
+# Skip confirmation prompt
+python offboard_member.py "member name" -y
+
+# List undergrads without photos
+python offboard_member.py --list-no-photo
+```
+
+The script will:
+- Move the member from `members` sheet to `alumni_undergrads` in `people.xlsx`
+- Update `JRM_CV.tex` to add the end date
+- Prompt to rebuild `people.html`
+
+**Idempotent**: Running twice with the same name detects the member is already offboarded.
+
+#### Adding Alumni (Manual)
 
 1. Open `data/people.xlsx`
 2. Go to the appropriate sheet:

data/people.xlsx

@@ -739,23 +739,23 @@ \subsection*{Mentorship  (selected)}
   \item Ellie Mattox (2025 -- )
   \item Emmy Thornton (2025 -- )
   \item Evan McDermid (2025 -- )
-  \item Jackson C. Sandrich (2025 -- )
+  \item Jackson C. Sandrich (2025 -- 2026)
   \item Will Lehman (2025 -- )
-  \item Luca Gandrud (2025 -- )
+  \item Luca Gandrud (2025 -- 2026)
   \item Sam Haskel* (2025 -- )
   \item Kevin Chang (2025 -- )
   \item Andrew Richardson (2025 -- )
   \item Ben Hanson (2025 -- )
-  \item Annabelle Morrow (2025 -- )
-  \item Owen Phillips (2025 -- )
+  \item Annabelle Morrow (2025 -- 2026)
+  \item Owen Phillips (2025 -- 2026)
   \item Rodrigo Vega Ayllon (2025)
   \item Joy Maina (2025 -- )
   \item Alexandra Wingo (2025 -- )
   \item Angelyn Liu (2025 -- )
   \item Miel Wewerka (2024)
   \item Manraaj Singh (2024)
   \item Can Kam (2024)
-  \item Chelsea Joe (2024 -- )
+  \item Chelsea Joe (2024 -- 2026)
   \item Jacob Bacus (2024 -- )
   \item Rohan Goyal (2024)
   \item Harrison Stropkay* (2024 -- 2025)

documents/JRM_CV.tex

@@ -115,11 +115,6 @@ <h3>sarah parigela | undergrad</h3>
             </div>
 
             <div class="people-grid">
-                <div class="person-card">
-                    <img src="images/people/placeholder.png" alt="chelsea joe">
-                    <h3>chelsea joe | undergrad</h3>
-                    <p>Chelsea is a Computer Science and Neuroscience double major. She is interested in artificial intelligence, machine learning, and building computational models.</p>
-                </div>
                 <div class="person-card">
                     <img src="images/people/jacob_bacus.png" alt="jacob bacus">
                     <h3>jacob bacus | undergrad</h3>
@@ -130,14 +125,14 @@ <h3>jacob bacus | undergrad</h3>
                     <h3>aidan miller | undergrad</h3>
                     <p>Aidan is a pre-med student at Dartmouth College, majoring in Biology, minor in Spanish, and graduating in 2028. He joined the Contextual Dynamics Lab in fall 2025, where his interests center on advanced learning and memory techniques, including the method of loci and PAO systems.</p>
                 </div>
-            </div>
-
-            <div class="people-grid">
                 <div class="person-card">
                     <img src="images/people/alexandra_wingo.png" alt="alexandra wingo">
                     <h3>alexandra wingo | undergrad</h3>
                     <p>Alexandra is interested in education technology and brings to the lab her extensive computer science experience. She is especially interested in helping students with learning differences, and in developing brain-based learning tools.</p>
                 </div>
+            </div>
+
+            <div class="people-grid">
                 <div class="person-card">
                     <img src="images/people/alishba_tahir.png" alt="alishba tahir">
                     <h3>alishba tahir | undergrad</h3>
@@ -148,27 +143,19 @@ <h3>alishba tahir | undergrad</h3>
                     <h3>andrew richardson | undergrad</h3>
                     <p>Andrew Richardson is a Mathematics and Economics double major from Minneapolis, MN. Outside of academics, he enjoys playing tennis and soccer.</p>
                 </div>
-            </div>
-
-            <div class="people-grid">
                 <div class="person-card">
                     <img src="images/people/placeholder.png" alt="angelyn liu">
                     <h3>angelyn liu | undergrad</h3>
                     <p>Angelyn is a member of the class of 2028 from the Bay Area, CA, planning on majoring in cognitive science. In her free time, she enjoys singing, reading, puzzle games, and creative writing.</p>
                 </div>
-                <div class="person-card">
-                    <img src="images/people/placeholder.png" alt="annabelle morrow">
-                    <h3>annabelle morrow | undergrad</h3>
-                    <p>Annabelle Morrow is a member of the class of 2028 from Hong Kong. She is planning to major in economics and minor in human-centered design. Outside of class, she enjoys running and spending time outdoors.</p>
-                </div>
+            </div>
+
+            <div class="people-grid">
                 <div class="person-card">
                     <img src="images/people/placeholder.png" alt="azaire andre">
                     <h3>azaire andre | undergrad</h3>
                     <p>Azaire is a Mathematics and Anthropology double major. She is particularly interested in understanding complex systems like brain networks and financial markets.</p>
                 </div>
-            </div>
-
-            <div class="people-grid">
                 <div class="person-card">
                     <img src="images/people/ben_hanson.png" alt="ben hanson">
                     <h3>ben hanson | undergrad</h3>
@@ -179,42 +166,27 @@ <h3>ben hanson | undergrad</h3>
                     <h3>ellie mattox | undergrad</h3>
                     <p>Ellie is a member of the class of 2027 from Austin, TX and is majoring in neuroscience with a minor in human-centered design. Outside of the lab she enjoys playing volleyball on Dartmouth's Varsity team, spending time outside, and hanging out with friends.</p>
                 </div>
-                <div class="person-card">
-                    <img src="images/people/placeholder.png" alt="evan mcdermid">
-                    <h3>evan mcdermid | undergrad</h3>
-                    <p>Evan is a Mathematics major and Computer Science minor. He is interested in algorithmic trading, algorithmic problem solving, and building models of financial market dynamics.</p>
-                </div>
             </div>
 
             <div class="people-grid">
                 <div class="person-card">
-                    <img src="images/people/placeholder.png" alt="jackson c. sandrich">
-                    <h3>jackson c. sandrich | undergrad</h3>
-                    <p>Jax is a Mathematics and Economics double major. He is interested in using EEG to understand how people learn new concepts and skills.</p>
+                    <img src="images/people/placeholder.png" alt="evan mcdermid">
+                    <h3>evan mcdermid | undergrad</h3>
+                    <p>Evan is a Mathematics major and Computer Science minor. He is interested in algorithmic trading, algorithmic problem solving, and building models of financial market dynamics.</p>
                 </div>
                 <div class="person-card">
                     <img src="images/people/placeholder.png" alt="kevin chang">
                     <h3>kevin chang | undergrad</h3>
                     <p>From Taipei and Boston, Kevin is a ‘29 studying Applied Math and CS. He is passionate about quantitative finance, machine learning, and health analytics. His long term goal is to develop data-driven solutions to optimize inefficiencies in the US healthcare system.</p>
                 </div>
-                <div class="person-card">
-                    <img src="images/people/placeholder.png" alt="luca gandrud">
-                    <h3>luca gandrud | undergrad</h3>
-                    <p>Luca is a Neuroscience major who is passionate about how we can use technology and neuroscience to enhance learning in everyday life. He is also interested in wearable brain recording devices.</p>
-                </div>
-            </div>
-
-            <div class="people-grid">
-                <div class="person-card">
-                    <img src="images/people/placeholder.png" alt="owen phillips">
-                    <h3>owen phillips | undergrad</h3>
-                    <p>Owen is a ‘28 from Costa Mesa, California. He plans to major in Math and minor in Engineering and Computer Science. In his free time, he enjoys philatelics, post-hardcore music, fashion/art history, and logic puzzles.</p>
-                </div>
                 <div class="person-card">
                     <img src="images/people/placeholder.png" alt="sam haskel">
                     <h3>sam haskel | undergrad</h3>
                     <p>Sam is a Quantitative Social Science and Economics double major. He is interested in how social peer influences shape beliefs and affect how people make decisions.</p>
                 </div>
+            </div>
+
+            <div class="people-grid">
                 <div class="person-card">
                     <img src="images/people/will_lehman.png" alt="will lehman">
                     <h3>will lehman | undergrad</h3>
@@ -382,7 +354,12 @@ <h3>Undergraduate Researchers</h3>
                         Sheherzad Mohydin (2016)<br>
                         Peter Tran (2016)<br>
                         Gal Perlman (2016)<br>
-                        Jessica Tin (2016)
+                        Jessica Tin (2016)<br>
+                        Chelsea Joe (2026)<br>
+                        Annabelle Morrow (2026)<br>
+                        Jackson C. Sandrich (2026)<br>
+                        Luca Gandrud (2026)<br>
+                        Owen Phillips (2026)
                     </p>
                 </div>
             </div>