# Python-generated files
__pycache__/
*.py[oc]
build/
dist/
wheels/
*.egg-info

# Virtual environments
.venv

# Test artifacts
.coverage
coverage.xml
htmlcov/

# Caches & IDEs
.cursor/
.idea/
.pytest_cache/
.mypy_cache/
.ruff_cache/
.DS_Store
.agent/
.ref_cache/

# MCP runtime logs (created in client project roots, not in ref-agents repo)
handoff_log.jsonl

# Session working files (ephemeral, not part of package)
tasks/
CLAUDE.md

# Documentation Iterations
GAP_ANALYSIS.md
docs/misc/
docs/pitch-deck/

# Research / presentation docs (not part of the package)
docs/ARXIV_SUBMISSION_GUIDE.md
docs/CONSOLE_SCREENS.md
docs/CONTEXT_CODEBASE_DIAGRAM.md
docs/RESEARCH_POTENTIAL.md

# Optional Documentation (not required for ref-agents runtime)
docs/architecture/
docs/design/
docs/features/
docs/guides/
docs/process/
docs/product/
docs/requirements/README.md
docs/requirements/FLOW_DIAGRAM.md

# Security Reports
bandit-report.json
pip-audit-report.json
*.json

# Committed supply-chain artifacts (regenerated via scripts/generate_sbom.py).
# NOTE: must override the blanket *.json ignore above — these ship as evidence.
!docs/sbom.json
!docs/runtime_licenses.json

# Generated Reports (auto-generated by agents, not needed in package)
ref-reports/
docs/project_status.md

# Per-story lifecycle artifacts (generated by REF agents, not permanent docs)
docs/analysis/
docs/closure/
docs/specs/
docs/test_repo/

# Playwright MCP cache
.playwright-mcp/

# Binary / exported assets (not source artifacts)
docs/*.html
docs/*.jpeg
docs/*.jpg
docs/*.png

# API Keys (never commit)
api_keys.json
src/ref_agents/api_keys.json
/docs/superpowers_concept_integration.txt
/docs/COMPLIANCE_METRICS.md
/docs/MARKETING_STORYBOARD.md
/docs/METRICS_SUMMARY.md
/docs/MIGRATION_MAP.md
