.gitignore

# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# C extensions
*.so

# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
!book/quarto/contents/*/parts/
sdist/
var/
wheels/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST

# PyInstaller
*.manifest
*.spec

# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/
cover/

# Jupyter Notebook
.ipynb_checkpoints

# IPython
profile_default/
ipython_config.py

# pyenv
.python-version

# Virtual environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/
bin/
include/
lib/
lib64/
pyvenv.cfg
share/
# Prevent duplicate venvs in subdirectories
site/.venv/
**/.venv/
**/venv/
**/env/

# IDEs
.vscode/
!.vscode/settings.json
.idea/
*.swp
*.swo
*~

# Jupyter Book / Quarto build artifacts
book/_build/
book/quarto/_build/
book/quarto/_output/
book/quarto/**/*.html
book/quarto/**/._*_xref.json
book/quarto/**/*_files/
book/quarto/**/*.backup.*
book/quarto/*_figures.txt
docs/_build/

# NBGrader - only ignore generated outputs, not source/release
assignments/autograded/
assignments/feedback/
assignments/submitted/

# Logs
*.log
book/tools/scripts/testing/logs/

# LaTeX build artifacts
*.aux
*.bbl
*.blg
*.out
*.fls
*.fdb_latexmk
*.synctex.gz
*.toc
*.lof
*.lot
*.pdf
# Callout icon PDFs needed for PDF builds (and parallel worktree builds)
!book/quarto/assets/images/icons/callouts/*.pdf

# Database
*.db
*.sqlite

# OS
.DS_Store
Thumbs.db
.envrc

# Temporary files
*.tmp
*.temp

# Backup files
*.bak
*.backup

# Misc. configurations
.claude
.claude/
.cursor
.cursor/
.cursor~HEAD
.gemini
.gemini/
.ai/

# MLSysBook extension working directories (worktrees, reports, logs)
.mlsysbook/

# Project specific
tito-cli.log
COMMIT_LOG.txt

# Tito CLI user state and cache (local to each user)
.tito/

# Downloaded datasets (not source-controlled, too large)
data/
datasets/
milestones/datasets/

# BUT: Include TinyTorch's curated educational datasets (tiny, ship-with-repo)
!datasets/tinydigits/
!datasets/tinytalks/
!datasets/tinymnist/
!datasets/README.md
!datasets/DATASET_ANALYSIS.md

# Temporary generated files
progress.json
**/VERIFY_*.py
**/NEW_CITATIONS.bib
**/proposed_figures.tex

# Generated notebooks (built from src/*.py source files)
# The modules/ directory contains generated notebooks for learners
modules/*
!modules/README.md

# Generated website module docs (copied from src/*/ABOUT.md during build)
# Single source of truth: src/*/ABOUT.md
docs/modules/*
docs/chapters/modules/*

# Site build artifacts
site/_build/

# Generated tinytorch package (auto-generated from src/ via nbdev_export)
# Single source of truth: src/*/*.py files
tinytorch/tinytorch/*
!tinytorch/tinytorch/README.md

# Generated benchmark outputs
.tito/benchmarks/

# Misc. generated files
/.luarc.json
book/quarto/index.idx
book/quarto/index.ilg
book/quarto/index.ind
CLAUDE.md

# Newsletter drafts (work-in-progress, not public until sent)
newsletter/drafts/*.md
!newsletter/drafts/_template.md

/.quarto/
**/*.quarto_ipynb

# Quarto / mlsysim rendered site output
_build/
mlsysim/docs/assets/
mlsysim/docs/site_libs/
mlsysim/docs/**/*.html

# mlsysim scratch / test plans
mlsysim/test_*.yaml
mlsysim/check_*.py

# Marimo session state (local to each user)
**/__marimo__/session/

# Slides Quarto build cache
slides/.quarto/

# Internal planning docs, review notes, and AI prompts (not public)
labs/plans/
newsletter/CONTENT_PLAN.md
mlsysim/core/optimization/PLAN.md
book/quarto/contents/vol1/REVIEW_NOTES.md
book/quarto/contents/vol2/context_notes.md
book/tools/review_prompts.md
book/tools/scripts/figure_narrative_audit.md
book/tools/scripts/tbl_lst_narrative_audit.md

# One-off fix/apply scripts in repo root
/fix_*.py
/apply_*.py
/test_*.py