# --- Best Practices .gitignore for Node.js/TypeScript Projects ---

# Dependency directories
# Keep these out of version control to avoid bloating the repository.
# They should be installed by package managers on each machine.
node_modules/
jspm_packages/
bower_components/
.pnpm-store/

# Lock files for other package managers
# This project uses bun, so other lockfiles can be ignored.
package-lock.json
yarn.lock
bun.lockb

# Build and Compilation Output
# These files are generated from source code and don't need to be in version control.
dist/
release/
# The release scripts are source, not build output: without this line a new file there is silently ignored.
!/scripts/release/
build/
app_data/
*.tsbuildinfo
.lock-wscript

# Logs and Runtime Data
# Log files and temporary runtime data should not be committed.
logs/
share/
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pids/
*.pid
*.seed
*.pid.lock

# Test and Coverage Reports
lib-cov/
coverage/
.nyc_output/

# Environment Variables
# NEVER commit environment variables or secrets.
# Use a .env.example file to show what variables are needed.
.env
.env.*
!**/.env.example

# Cryptographic Keys
*.pem
*.key
keys/

# IDEs and Editors
# Add settings and temporary files from common editors to prevent user-specific
# configurations from being committed.
.idea/
.vscode/
*.suo
*.ntvs*
*.njsproj
*.sln
.eslintcache

# OS-specific Files
# Ignore files generated by the operating system.
.DS_Store
Thumbs.db
._*
Desktop.ini

# Prompts
# Reusable AI prompts for development workflow
.local/
.claude/
**/*/.claude
.prompts/
.superpowers/
.playwright-mcp/
openspec

CLAUDE.md
CLAUDE.*.md
GEMINI.md
**/*/CLAUDE.md
.serena

# Miscellaneous
# Other temporary files, archives, and caches.
.npm/
.grunt/
.node_repl_history
*.tgz
artifact.zip
node_modules.zip
.yarn-integrity
*-audit.json
.mastra/
**/*/__mf__/temp/

# VitePress cache of the wiki site
.vitepress/cache/

# OKF knowledge bundle - generated graph explorer (rebuild: make okf-viz)
.agents/knowledge/viz.html

# AI Agent - tool-specific configs (local only, never committed)
.agents/plans
.agents/specs

*.bun-build
.*.bun-build
.agents/vulcan.local.json

# Everything an agent creates while it works: scratch, worktrees, clones, cache, prototypes
.agents/local/
