.gitignore

# Dependencies
node_modules/
node_modules
.pnp
.pnp.js

# AGENTS.md.bak produced by migrateAgentToYaml (wish
# dir-sync-frontmatter-refresh Group 2). Preserves pre-migration
# frontmatter byte-for-byte as a safety net; useful locally, noise
# in history.
agents/*/AGENTS.md.bak
**/agents/*/AGENTS.md.bak

# Build output
dist/
build/
target/
gen/
*.js.map
*.tsbuildinfo

# Plugin package.json (generated)
plugin/package.json

# Testing
coverage/

# Environment
.env
.env.local
.env.*.local

# Editor
.vscode/
.idea/
*.swp
*.swo
*~

# OS
.DS_Store
Thumbs.db

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

# Misc
.cache/
.temp/
.dev/

# Repository-local Hermes profile: keep the portable contract in git and
# exclude plans, sessions, memories, credentials, logs, and other runtime state.
.hermes/*
!.hermes/config.yaml
!.hermes/profile.yaml
!.hermes/SOUL.md

# Legacy worktrees (now default to ~/.genie/worktrees/)
.worktrees/

# Claude Code worktrees
.claude/worktrees/
.worktrees/

# In v5, .genie/ follows documents-in-git / state-in-sqlite: planning documents
# (INDEX.md, wishes/, brainstorms/*/DESIGN.md) are genie's own taxonomy — tracked and
# reviewed in PRs. Runtime state is never git-versioned: the SQLite engine
# (genie.db + sidecars) plus the legacy v4 state paths listed below.

# Worker registry (contains session IDs)
.genie/workers.json

# Genie v5 operational state — SQLite state engine, never git-versioned
.genie/genie.db
.genie/genie.db-wal
.genie/genie.db-shm
# Cross-process mutex for the MCP write path's WAL-index recovery. Normally
# created and removed inside one open; survives only a holder that crashed
# mid-recovery, and the next open reaps it.
.genie/genie.db-recovery-lock

# Machine-local roadmap sync baseline (pairs genie.db with roadmap.json)
.genie/roadmap-sync

# Brainstorm working notes (DRAFT.md, COUNCIL.md, REVIEW.md, …) are machine-local.
# Only the reviewed DESIGN.md a wish links stays tracked: wishes:lint resolves that
# link in CI and the wish preflight verifies its digest. Files tracked before this
# rule stay tracked.
.genie/brainstorms/*/*
!.genie/brainstorms/*/DESIGN.md

# Legacy residue protection: kickoff prompts emitted by `genie launch` before
# its removal stay ignored (nothing writes here anymore)
.genie/launch/

# Local genie state (not part of the package)
.genie/agents.json
.genie/teams/

# Team runtime state
.genie/mailbox/
.genie/tasks.json
.genie/state.json
.genie/state/
.genie/chat/
.claude/scheduled_tasks.lock

# Local notes / scratch
.genie/incidents/

# DB dumps and secret-shaped files must never land in source control
.genie/snapshot.sql*
*.sql.gz
*.dump
*.pgdump

# QA specs in .genie/qa/ are tracked (they are code)
# QA results live in ~/.genie/qa/ (global, not per-repo)

# Claude Code framework markers — written by Claude's plugin loader to its own
# cache (~/.claude/plugins/cache/...) when a plugin version is marked
# orphaned. They MUST NOT land in our source tree: `update.ts copyDirSync`
# would carry them into the active cache dir, and Claude Code then treats
# the active plugin as orphaned, breaking skill loading on every fresh
# install. (Multi-server regression diagnosed 2026-05-06; see
# fix/skills-orphaned-marker.)
.orphaned_at

core

# Machine-local agent/tool config — never shared. `.codex/config.toml` in
# particular can hold live session tokens (e.g. BW_SESSION).
.codex/
.dash/
.empryo
.mcp.json
# mikro microagents and config are genie assets (tracked); only run ledgers are machine-local
.mikro/runs/
.warp/

# Local type declarations for the DSH plugin typecheck (fetched, not tracked)

# Added by px setup — local Phoenix credentials
.env.phoenix
.mcp.json.genie-backup-*