# 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/
.nablr_cache/
# STORY-059 FR-7 — critical workflow/remediation/fix_flow state, gitignored like .nablr_cache/
.nablr_state/
.sef_cache/
.sef_state/

# 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
!public-docs/mint.json
!public-docs/docs.json
# Requirement-doc JSON companions (story/epic/feature machine mirrors) are
# canonical backlog data — must also override the blanket *.json ignore.
!docs/requirements/**/*.json

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

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

# Whole-repo derived artifacts (regenerated independently by every isolated
# worktree — STORY-MERGE-ARTIFACT-CONFLICT-001 FR-1; committing these from a
# worktree guarantees a merge_back conflict against dev's own snapshot).
# merge_back(mode="local") regenerates + commits these directly on dev after
# a clean merge instead (FR-2).
codemap/
docs/TECH_DEBT.md

# 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
