env-snapshot

name	env-snapshot
description	Captures tool versions, packages, and kernel info as a reproducibility record in notes/. Use when documenting the environment.
allowed-tools	Bash, Read, Write, Glob, Grep
version	1.0.0
workflow_stage	setup
tags	["environment","reproducibility","documentation"]

Document Environment Snapshot

Capture the full environment state and save it as a reproducibility record.

Steps

1. Gather system and tool versions:

   uname -a                    # OS info
   quarto --version            # Quarto
   uv --version                # uv
   python3 --version           # Python
   

2. Capture Python package versions:

   uv pip list                 # all installed packages with versions
   

3. Capture Jupyter kernel list:

   uv run jupyter kernelspec list
   

4. If R is available, capture R session info:

   R -e "sessionInfo()"
   

5. If Stata is available, note the version:

   which stata                 # or check nbstata.conf for edition info
   

   Read ~/.config/nbstata/nbstata.conf for stata_dir and edition.

6. If TeX Live is available:

   pdflatex --version | head -1
   

7. Generate a timestamped Markdown file with all collected information:

   # Environment Snapshot — YYYY-MM-DD
   
   ## System
   - OS: ...
   - Platform: ...
   
   ## Tools
   | Tool | Version |
   | ---- | ------- |
   | Quarto | x.x.x |
   | uv | x.x.x |
   | Python | 3.12.x |
   | R | x.x.x (or N/A) |
   | Stata | SE x.x (or N/A) |
   | TeX Live | xxxx (or N/A) |
   
   ## Jupyter Kernels
   - python3: /path/to/kernel
   - ir: /path/to/kernel (or N/A)
   - nbstata: /path/to/kernel (or N/A)
   
   ## Python Packages
   | Package | Version |
   | ------- | ------- |
   | numpy | x.x.x |
   | pandas | x.x.x |
   | ... | ... |
   
   ## R Session Info
   (full sessionInfo() output, or "R not available")
   
   ## Stata Packages
   (ado dir output, or "Stata not available")
   

8. Save to notes/environment-YYYYMMDD.md (using today's date).

9. Report the file path.