.gitignore

# ===========================================
# ACFS - Agentic Coding Flywheel Setup
# ===========================================

# ----- Dependencies -----
node_modules/
.pnp
.pnp.js

# ----- Build outputs -----
dist/
build/
out/
.next/
.next*/
.vercel/

# ----- Package manager -----
# Using bun exclusively
bun.lockb
*.lock
!bun.lock

# ----- Environment & secrets -----
.env
.env.*
!.env.example
.env.local
.env.development.local
.env.test.local
.env.production.local

# ----- IDE & Editor -----
.idea/
.vscode/
# Repo-scoped Codex rules are source files; many agents ignore ~/.codex globally.
!.codex/
!.codex/rules/
!.codex/rules/ubs.md
*.swp
*.swo
*~
.DS_Store
Thumbs.db

# ----- Testing -----
coverage/
.nyc_output/
*.lcov

# ----- TypeScript -----
*.tsbuildinfo
next-env.d.ts

# ----- Logs -----
logs/
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.pnpm-debug.log*

# ----- Temporary files -----
tmp/
temp/
*.tmp
*.temp
/.keep
/-w
test_sed_flags.sh
.tsconfig.next-*.json

# ----- Runtime state databases -----
.slb/
*.db
*.db-shm
*.db-wal
*.sqlite
*.sqlite-shm
*.sqlite-wal
*.sqlite3
*.sqlite3-shm
*.sqlite3-wal

# ----- OS generated -----
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db

# ----- Cache -----
.cache/
.eslintcache*
.turbo/

# ----- Beads -----
# Keep .beads directory but ignore sensitive data
.beads/cache/
.beads/.br_history/
.beads/*.db
.beads/*.db-*
.beads/interactions.jsonl
.beads/*.log
.beads/*.sock
.beads/*.sock.*
.beads/*.lock
# This repo has one canonical tracker at the root. Nested app-level trackers are stale local state.
apps/**/.beads/
packages/**/.beads/
tests/**/.beads/

# ----- Local testing artifacts -----
tests/vm/.vagrant/
tests/vm/*.box
tests/vm/ubuntu-*
apps/web/mobile-screenshots/
apps/web/test-mobile.ts
apps/web/check-site.mjs
apps/web/debug-site.mjs
apps/web/playwright-report/
apps/web/test-results/
research_screenshots/
/apps/web/scripts/research/legacy-*.mjs

# Obsolete placeholders in directories that now contain real files
/apps/web/app/.gitkeep
/apps/web/components/.gitkeep
/apps/web/lib/.gitkeep
/packages/installer/.gitkeep
/packages/manifest/.gitkeep
/packages/onboard/.gitkeep
/scripts/providers/.gitkeep
/scripts/providers/screenshots/.gitkeep
/scripts/sync/.gitkeep
/tests/vm/.gitkeep

# Unused default Next.js starter assets
/apps/web/public/file.svg
/apps/web/public/globe.svg
/apps/web/public/next.svg
/apps/web/public/vercel.svg
/apps/web/public/window.svg

# Unreferenced archived/generated artifacts from prior agent sessions
/docs/archive/original-complete-guide-page.tsx
/docs/newproj_tui.cast
/docs/assets/gh_og_share_image.png
/apps/web/public/og-home.jpg
/apps/web/public/og-flywheel.jpg
/acfs/onboard/assets/diagrams/.gitkeep

# ----- Installer test outputs -----
*.log
install_*.log

# ----- Python (for any scripts) -----
__pycache__/
*.py[cod]
*$py.class
.Python
*.so
.venv/
venv/
ENV/

# ----- Rust (if building tools) -----
target/
Cargo.lock
*.rs.bk

# ----- Debug -----
*.pdb
a.out

# ----- Source conversations -----
2025-12-20-chatgpt-website_tech_stack_update.md

# bv (beads viewer) local config and caches
.bv/
.ntm/
.vercel
.env*.local
tests/artifacts/

# Stray bv/CLI artifacts (malformed flag creates files like --graph-format.svg)
--graph-format*

# Ephemeral files (core dumps, profiling, agent config backups, etc.)
core.*
core
perf.data
perf.data.old
*.bak
*.backup
clippy.txt
clippy.json
clippy_results.json
clippy_unwrap.json
clippy_unwrap_clean.txt
check_output.txt
error.log
.next_backup*/
cline.mcp.json
opencode.json
windsurf.mcp.json
*.mcp.json.*.bak
storage.sqlite3
storage.sqlite3-shm
storage.sqlite3-wal
storage.sqlite3.bak
storage.sqlite3.corrupt-*
storage.sqlite3-shm.corrupt-*
storage.sqlite3-wal.corrupt-*

# ACFS ephemeral patterns (auto-generated agent artifacts)
codex.mcp.json
cursor.mcp.json
gemini.mcp.json
.opencode.json.*.bak
.windsurf.mcp.json.*.bak
.agent-mail-project-id
.agent-mail.yaml
*.sqlite3.bak
*.sqlite3.corrupt*
.beads/*.corrupt*
.beads/*.pre_repair_*
.beads/*.repair_candidate_*
.beads/*.bak-corrupt

# Beads ephemeral artifacts (recovery, backup, bad/rebuild snapshots)
.beads/*.bad_*
.beads/*.backup_*
.beads/*.rebuild_*
.beads/*.reindex_test_*
.beads/*.vacuum_test_*
.beads/recovery*/
.beads_recovery*/
.beads_archive_*/

# Ephemeral stderr capture files
/err
/@AGENTS.md
.claude/settings.local.json

# Beads backup snapshots (created by br doctor / concurrent agents)
.beads_backup_*/

# Agent-generated throwaway root-level JS scripts
/research_*.mjs
/apps/web/research_*.mjs
/apply_phase_cards.js
/fix_phases.js
/lint-check.js
/script.js
/test-highlight.js
/update-page.js
/update_phases.js

# Next.js trash directories (leftover from hot-reload crashes)
.next_trash_*/
node_modules_trash*/

# Agent-generated throwaway root-level test/scratch scripts
/test.sh
/test.ts
/test[0-9]*.sh
/test[0-9]*.ts
/test_*.sh
/test_*.ts

# Agent-generated root-level planning/audit drafts belong under docs/
/PLAN_TO_*.md
/STEP_BY_STEP_*AUDIT*.md
/modes-of-reasoning*.md
/modes_of_reasoning*.md
/reasoning_*.md

# Manifest build artifacts (generated by bun run generate)
packages/manifest/apps/
packages/manifest/scripts/
packages/manifest/test-*.ts

# ACFS install-time generated files (created inside ~/.acfs git clone)
# These are runtime artifacts, not source — ignoring them prevents
# the self-update check from seeing a dirty worktree.
/bin/
/state.json
/onboard_progress.json
/onboard/docs/
/onboard/lessons/
/onboard/onboard.sh
/tmux/
/zsh/