.gitignore

# Key material — prevent accidental commits (cycle-028 FR-1)
tests/fixtures/*.pem
tests/fixtures/*.key

# Dependencies
node_modules/
.pnp
.pnp.js

# Testing
coverage/
*.log

# Production builds
build/
dist/
out/

# Environment variables
.env
.env.local
.env.development.local
.env.test.local
.env.production.local

# IDE and Editor
.vscode/
.idea/

# Claude Code config (local workspace settings, prompts, scratchpad)
.claude/config/

# GPT review context (dynamically generated based on config)
.claude/context/gpt-review-active.md

# Local settings overrides (user-specific feedback trace configuration)
# Contains opt-in trace collection settings - never commit to repository
.claude/settings.local.json
*.swp
*.swo
*~
.DS_Store

# OS
Thumbs.db

# Package manager
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.pnpm-debug.log*

# Temporary files
tmp/
temp/
*.tmp

# Skill backup files (local-only rollback safety net)
# Use git tags for rollback reference instead of committed .bak files
.claude/skills/**/*.bak*

# Loa Framework State (Legacy - v0.14.0 and earlier)
# The .loa-setup-complete file is no longer created as of v0.15.0.
# THJ membership is now detected via LOA_CONSTRUCTS_API_KEY environment variable.
# This entry remains for backward compatibility with projects using older versions.
.loa-setup-complete

# Run Mode state (v0.18.0)
# Contains execution state, circuit breaker, and tracking files
# Must be preserved locally for resume capability but not committed
.run/

# Framework migration/eject backups (created by mount-loa.sh, update.sh, loa-eject.sh)
# Timestamped directories that should never be committed
.claude.backup.*

# Loa Memory Stack persistent state (renamed from .loa-cache/ in cycle-035)
# Contains vector database, embeddings, QMD indexes - machine-specific
# Semantics: NOT a cache (not ephemeral) — this is persistent local state
# Note: .loa/ is the submodule path (tracked). .loa-state/ is local state (ignored).
# Migration from old .loa/ data dir is handled by mount-submodule.sh:relocate_memory_stack()
.loa-state/

# User context files (discovery inputs, uploaded docs, extracted content)
# These are user-specific inputs that should never be committed
# The README.md is tracked to explain the directory's purpose
grimoires/loa/context/*
!grimoires/loa/context/README.md

# ck semantic search state (embeddings cache, indexes)
# Large machine-specific files that rebuild automatically
.ck/

# Agent trajectory logs (reasoning audit trails)
# JSONL format logs for development/debugging, not needed in version control
grimoires/loa/a2a/trajectory/*.jsonl

# Pending feedback (temporary file for failed GitHub submissions)
# Kept in case /feedback fails to submit - automatically retried on next invocation
grimoires/loa/analytics/pending-feedback.json

# Permission audit log (user-specific HITL approval history)
# Used by /permission-audit to suggest settings.json additions
grimoires/loa/analytics/permission-requests.jsonl

# Server audit reports (contain sensitive deployment info)
grimoires/loa/deployment/SERVER-REALITY-AUDIT.md

# Memory schema files (cross-session knowledge, project-specific)
# Contains facts, decisions, learnings, errors, preferences
# The README.md is tracked to explain the directory's purpose
grimoires/loa/memory/*
!grimoires/loa/memory/README.md

# =============================================================================
# LOA TEMPLATE EXCLUSIONS
# =============================================================================
# These files are ALWAYS excluded from the template repository.
# They are generated per-project and must never be committed to the main loa repo.

# Generated documentation artifacts (all PRD, SDD, sprint files)
# Uses glob patterns to catch both base files (prd.md) and feature variants (prd-*.md)
grimoires/loa/prd*.md
grimoires/loa/sdd*.md
grimoires/loa/sprint*.md
grimoires/loa/NOTES.md
grimoires/loa/BEAUVOIR.md
grimoires/loa/SOUL.md
grimoires/loa/decisions.yaml

# User config (copy from .loa.config.yaml.example)
.loa.config.yaml
# But DO track config files inside eval fixtures (needed for CI)
!evals/fixtures/**/.loa.config.yaml

# Sprint Ledger (project-specific cycle/sprint history)
# Created by /plan-and-analyze, tracks development cycles per-project
grimoires/loa/ledger.json
grimoires/loa/ledger.json.bak

# Archived development cycles (project-specific history)
grimoires/loa/archive/

# Agent-to-Agent communication (sprint-specific, generated)
# README.md files are kept to explain the directory purpose
grimoires/loa/a2a/*
!grimoires/loa/a2a/README.md
!grimoires/loa/a2a/trajectory/
grimoires/loa/a2a/trajectory/*
!grimoires/loa/a2a/trajectory/README.md
# Compound learning state (project-specific, generated per-project)
!grimoires/loa/a2a/compound/
grimoires/loa/a2a/compound/*.json
grimoires/loa/a2a/compound/review-markers/*
!grimoires/loa/a2a/compound/.gitkeep
!grimoires/loa/a2a/compound/review-markers/.gitkeep

# Deployment artifacts (project-specific)
grimoires/loa/deployment/*
!grimoires/loa/deployment/README.md

# Reality extraction (codebase-specific)
grimoires/loa/reality/*
!grimoires/loa/reality/README.md

# Analytics (usage tracking, developer-specific)
grimoires/loa/analytics/*
!grimoires/loa/analytics/README.md

# Research files (project-specific discoveries)
grimoires/loa/research/*
!grimoires/loa/research/README.md

# Ground truth (generated codebase analysis, project-specific)
grimoires/loa/ground-truth/*
!grimoires/loa/ground-truth/README.md

# Vision registry (speculative insights captured per-project)
grimoires/loa/visions/entries/*
!grimoires/loa/visions/entries/.gitkeep
grimoires/loa/visions/index.md

# Feedback files (developer feedback, project-specific)
grimoires/loa/feedback/*
!grimoires/loa/feedback/README.md

# Invariants (generated per-project)
grimoires/loa/invariants.yaml

# Public grimoires (project-specific outputs, not template content)
# Only README.md files and research documents are tracked
# Research documents contain reusable framework insights
grimoires/pub/**/*
!grimoires/pub/**/README.md
# Re-include research markdown files (framework improvement research)
!grimoires/pub/research/
grimoires/pub/research/*
!grimoires/pub/research/README.md
!grimoires/pub/research/*.md

# =============================================================================
# LOA CONSTRUCTS (licensed skills, user-specific)
# =============================================================================
# Constructs packs and skills are downloaded per-user with individual licenses.
# These should NOT be committed to version control:
# - Licenses are user-specific (contain watermarks, user_id)
# - Content is copyrighted and licensed per-user
# - Users should install via /skill-pack-install command
.claude/constructs/

# Development-specific docs (not part of template)
docs/planning/
docs/proposals/
docs/research/
docs/mockups/
docs/screenshots/

# =============================================================================
# PROJECT-SPECIFIC EXCLUSIONS (for repos that use loa as a base)
# =============================================================================
# Beads graph memory (sprint task tracking)
# For the template repo, .beads/ is fully excluded.
# Project repos that want team-visible sprint state can remove this line
# and selectively ignore runtime files below instead.
.beads/

# Beads runtime files (never commit, even if .beads/ is tracked)
# .beads/daemon.lock
# .beads/.local_version
# .beads/beads.db
# .beads/*.meta.json

# Eval results (run-specific, gitignored except baselines and .gitkeep)
evals/results/*
!evals/results/.gitkeep

# Docker build artifacts
.hounfour-build/

# Application build artifacts
app/dist/
app/node_modules/

# Web frontend build artifacts
web/dist/
web/node_modules/

# Terraform provider cache (rebuild on terraform init)
deploy/terraform/.terraform/

# Deploy secrets (never commit)
deploy/.env
deploy/.env.*