.gitignore

# Dependencies
node_modules/
pnpm-lock.yaml
bun.lock
deno.lock

# Logs
logs/
*.log
npm-debug.log*
*.tmp
*.bak
.cache/

# Installation logs and backups (Story 1.9 - Error Handling & Rollback)
.aiox-install.log
.aiox-install.log.*
.aiox-backup/
.aiox-core.backup*/                # Backup directories (any timestamp)

# Build output
build/*.txt
web-bundles/

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

# System files
.DS_Store
Thumbs.db
nul                           # Windows temporary file

# Private keys and certificates
*.key
*.pem
*.p12
*.pfx
*.crt
*.cer
*.p7b
*.p7c

# Secrets and credentials directories
secrets/
credentials/

# Private local commands (not for repository)
.claude/commands/mmosMapper/
.claude/commands/hybridOps/

# Private local squads (not for repository)
squads/*
!squads/.gitkeep
!squads/_example/
# Published squads (whitelisted for repository)
!squads/claude-code-mastery/
keys/
*.secret
*.credentials

# Binary installers and development artifacts
*.msi                         # Windows installer packages
*.exe                         # Executable binaries
*.bat                         # Development batch scripts (sync-agents.bat, etc.)
*.sh                          # Development shell scripts
sync-*.bat                    # Agent sync scripts
sync-*.sh                     # Agent sync scripts

# Development tools and configs
# Note: .husky/, .prettierrc, .prettierignore are TRACKED for pre-commit hooks (Story 3.1)

# IDE and editor configs
.windsurf/
!.windsurf/rules/
!.windsurf/rules/agents/
.cursor/rules/                # Cursor IDE personal rules and configurations
!.cursor/rules/agents/

# AI assistant files
CLAUDE.md
.claude/*
!.claude/commands/
!.claude/commands/AIOX/
!.claude/commands/AIOX/agents/
!.claude/CLAUDE.md
!.claude/rules/
!.claude/settings.json
.gemini
!.gemini/
!.gemini/rules/
!.gemini/rules/AIOX/
!.gemini/rules/AIOX/agents/
!.gemini/rules/AIOX/agents/*.md

# AI Session Artifacts (Story 6.1.2.6 - Decision Logging)
# Auto-generated decision logs from yolo mode executions
.ai/
*.decision-log.md

# Project-specific
# Note: .aiox-core is SOURCE CODE for framework-development mode
# It should NOT be ignored in the main repository
.aiox-core.backup*/                # Only ignore backup directories
test-project-install/*
sample-project/*

# Expansion Projects (separate from core AIOX-FULLSTACK)
# These folders are from other projects and should NOT be in this repository
.aiox/                        # AIOX expansion project files
.aiox/project-status.yaml     # Project status cache (Story 6.1.2.4 - auto-generated)
.cursor/                      # Cursor IDE project files
aiox-memory-layer-mvp/        # Separate memory layer project
memory/                       # Memory squad
performance/                  # Performance squad
scripts/                      # Project-specific scripts (not part of core)
security/                     # Security squad
telemetry/                    # Telemetry squad
tests/                        # Test files for expansion projects

# AIOX Development Artifacts (generated during workflow execution)
# These files are created by agents during development and should NOT be in version control
# NOTE: docs/prd/ is TRACKED - it contains important product documentation
qa/                           # Test artifacts and quality assurance files
epic-retrospective.md         # Epic retrospective documents
*.stats.md                    # Statistics and analysis files
flattened-codebase.xml        # Flattened codebase exports
test-results.txt              # Test result outputs
**/test-results.txt           # Test results in any subdirectory

# Test coverage reports (generated by test runs)
coverage/
*.lcov
lcov-report/

# AIOX temporary build/analysis files
.aiox/reports/
.aiox/temp-*.js

# Build outputs (generated from source)
aiox-core/index.d.ts
aiox-core/index.esm.js
aiox-core/*.map

# Applications (separate deployments, NOT part of npm package)
apps/

# External projects (separate repositories)
aiox-guide-app/
examples/
!docs/examples/
supabase/

# Output directories (generated artifacts)
outputs/

# Test fixtures (generated during tests)
tests/*/__fixtures__/

# UI/UX design artifacts
docs/ui-prompts.pdf

# NOTE: docs/ internal directories are gitignored in the
# "INTERNAL DOCS" section below. Only public docs ship.

# Windows reserved device names
NUL
CON
AUX
PRN

# ============================================
# GENERATED ARTIFACTS (Story 6.12)
# ============================================

# Framework runtime artifacts
.aiox-core/.session/
.aiox-core/manifests/*.csv
.aiox-core/core/registry/service-registry.json

# Quality metrics (generated during testing)
.aiox/data/quality-metrics.json
.aiox-core/quality/metrics-*.json
.aiox-core/data/quality-metrics.json

# Session data
.aiox-core/.session/current-session.json

# ============================================
# ARCHIVED DOCUMENTATION (Story 6.12)
# ============================================
# Historical documentation moved to .github/deprecated-docs/
# These are internal development artifacts, not user documentation
# NOTE: Keep archived in repo for historical reference,
#       but prevent new files from being added accidentally
# .github/deprecated-docs/  # TRACKED - contains archived docs

# ============================================
# DEVELOPMENT ARTIFACTS
# ============================================
# Office documents should not be in repo
*.docx
*.xlsx
*.pptx

# Test/sample files (prefixed patterns)
test-sample-*.md
*-sample-*.md

# Backup/archive patterns
*.backup
*.old
*~

# TypeScript incremental build cache
.tsbuildinfo
*.tsbuildinfo

# Runtime AIOX artifacts (explicit rules without inline comments)
.aiox/
.aiox/project-status.yaml
.aiox/notifications/
.aiox/sessions/

# ESLint cache
.eslintcache

# ============================================
# INTERNAL DOCS (not for GitHub or npm install)
# ============================================
# Development artifacts, internal strategy, and proprietary content.
# These stay local only — not published to GitHub or npm.

docs/stories/
docs/research/
docs/qa/
docs/epics/
docs/prd/
docs/decisions/
docs/one-pagers/
docs/strategy/
docs/handoffs/
docs/requirements/
docs/releases/
docs/standards/
docs/architecture/*
!docs/architecture/
!docs/architecture/orchestration-hierarchy.md
docs/agents/
docs/private/

# Squad Design Files (test artifacts)
squads/.designs/

# ============================================
# MCP Configuration (contains API keys)
.mcp.json

# Nogic (code intelligence - local config)
.nogic/

# MCP/PLAYWRIGHT ARTIFACTS
# ============================================
# Screenshots and sensitive data from MCP tools
.playwright-mcp/
*.recovery-codes.txt
npm-recovery-codes.txt

# ============================================
# PRO SUBMODULE (ADR-PRO-001 — git submodule, NOT ignored)
# ============================================
# pro/ is a git submodule pointing to SynkraAI/aiox-pro (private)
# It is tracked by git via .gitmodules — do NOT add pro/ to gitignore
# Pro submodule contents excluded from npm publish (not in package.json files array)

# ============================================
# LOCAL CONFIG (ADR-PRO-002 — machine-specific secrets, never committed)
# ============================================
.aiox-core/local-config.yaml

# ============================================
# IDS REGISTRY (Story IDS-3 — Self-Updating Registry)
# ============================================
.aiox-core/data/registry-backups/
.aiox-core/data/.entity-registry.lock
.aiox-core/data/registry-update-log.jsonl

# ============================================
# .AIOX-CORE INTERNAL/GENERATED FILES
# ============================================

# Deprecated documentation (superseded by V2.1-COMPLETE)
.aiox-core/docs/standards/AIOX-LIVRO-DE-OURO.md
.aiox-core/docs/standards/AIOX-LIVRO-DE-OURO-V2.1.md
.aiox-core/docs/standards/AIOX-LIVRO-DE-OURO-V2.1-SUMMARY.md
.aiox-core/docs/standards/AIOX-FRAMEWORK-MASTER.md
.aiox-core/docs/standards/V3-ARCHITECTURAL-DECISIONS.md

# Duplicate docs (originals in .aiox-core/core/docs/)
.aiox-core/docs/SHARD-TRANSLATION-GUIDE.md
.aiox-core/docs/component-creation-guide.md
.aiox-core/docs/template-syntax.md
.aiox-core/docs/troubleshooting-guide.md
.aiox-core/docs/session-update-pattern.md

# Generated runtime files
.aiox-core/.session/
.aiox-core/.session/current-session.json

# Generated manifests (created by framework)
.aiox-core/manifests/*.csv

# Internal audit results
.aiox-core/infrastructure/tests/utilities-audit-results.json

# ============================================
# TEMPORARY FILES
# ============================================
# Windows path-encoded temporary files (malformed path files)
C:Users*
*temp-catalog.txt
.eslintcache

# ============================================
# SYNAPSE RUNTIME (auto-managed)
# ============================================
.synapse/sessions/
.synapse/cache/
.synapse/metrics/

# ============================================
# SYNAPSE PACKAGE (generated by scripts/package-synapse.js)
# ============================================
synapse-package.zip
.synapse-package/

# ============================================
# MMOS IMPORT (TEMPORARY - Story MMOS-Sync)
# Remove entries after validation
# ============================================
scripts/glue/
.claude/skills/
!.claude/skills/
!.claude/skills/AIOX/
!.claude/skills/AIOX/agents/
!.claude/skills/AIOX/agents/*/
!.claude/skills/AIOX/agents/*/SKILL.md
!.claude/hooks/
.claude/templates/
.claude/agents/
.claude/agent-memory/
.claude/setup/
.agents/
docs/guides/aiox-workflows/

# Local Gemini project rules generated/managed per workspace
.gemini/rules.md

# Dependencies (AIOX)
node_modules

# Build & Logs (AIOX)
dist/
build/

# IDE & OS (AIOX)
.idea/
*.swp

# AIOX Local (AIOX)
.aiox-core/local/
.claude/settings.local.json
.aiox/install-log.txt