.gitignore

# IDE and Editor files
.vscode/
.idea/
*.swp
*.swo
*~
.DS_Store
Thumbs.db

# Python
__pycache__/
*.py[cod]
*$py.class
.Python
env/
venv/
.env

# Build outputs
build/
dist/
*.egg-info/

# Documentation build
_build/
.doctrees/

# Temporary files
*.tmp
*.bak
*.backup
*.backup.*
.~*

# Backup directories
**/backups/
backups/

# Roving central-skills staging area (carried between repos; not project-versioned)
central-skills-staging/

# Parallel ingestion-wave staging (transient; map agents stage here, ingest-wrap-reduce promotes + tears down)
engineering/ingestion/_staging/

# Parallel boundary-determination staging (transient; mine-and-delineate map agents stage here, the reduce promotes + tears down)
engineering/document-production/_mine-staging/

# Reference tools staged into the container but never versioned (e.g. flexspin binary)
REF-TOOLS-NO-COMMIT/

# Log files
*.log

# Tool outputs
validation-report.txt
broken-links.txt

# Node (if using any JS tools)
node_modules/
package-lock.json
GITHUB-REPO-SETUP.md

# Temporary import directory (not versioned)
import/

# External source code projects (not versioned)
/engineering/ingestion/external-inputs/source-code/external-projects/
/engineering/ingestion/external-inputs/source-code/obex-projects/

# Claude's private reference materials (not versioned)
.claude/*
!.claude/skills
!.claude/skill-conventions.md
!.claude/skills-reconciled.md
CLAUDE.md
.ai-manifest.json
engineering/document-production/repo-voice-profile.md

# Source documents (PDFs and originals)
sources/originals/*.pdf
sources/originals/*.csv
*.pdf

# Exception: Allow PDFs in deliverables (final documents for community).
# The PDFs live in the DOCs/ subdirectory, so the exception must reach it —
# otherwise *.pdf above silently ignores them (they only track via git add -f).
!deliverables/documents/*.pdf
!deliverables/documents/DOCs/*.pdf

# Archived V1 extractions (superseded by V2)
sources/extractions-v1-archived/

# Sprint communications (private/not versioned)
.sprints/*/communications/
**/communications/

# Personnel observations and private guidance
.personnel-observations/

# Temporary archives and exports
ARCHIVE-*/
CLAUDE-EXPORT.zip
DOT-TODO-MCP/

# Development workspace (not versioned)
Scratchpad/

# PDF generation workspace - NOW VERSIONED (critical working files)
# But exclude backups and temporary versions
*.backup.*
*.bak
*.bak[0-9]

# Exclude suffixed test/temporary versions
*-TEST.md
*-test.md
*-v[0-9].md
*-v[0-9][0-9].md
*-FINAL.md
*-FINAL-*.md
*-fixed.md
*-FIXED.md
*-ESCAPED.md
*-FORMATTED.md
*-NOBOLD.md
*-CLEAN.md
*-COMBINED.md
*-PRODUCTION.md
*-READY.md
*-SOURCE.md

# Script temporary work areas
tools/*.tmp
tools/*.backup
tools/temp/
tools/work/
*.backup.*
*.tmp.*

# Generated/formatted versions (keep only source)
*-FORMATTED.md
*-ESCAPED.md
*-PASS[0-9].md
*-FINAL.md
*-unescaped.md

# Test outputs
*-TEST.pdf
*-TEST.md
test-request.json
TEST-*.sty
TEST-*.latex
TEST-*.lua

# Exception: the P2 Layout Torture Test is a permanent engineering harness for the
# manual layout-standards effort, NOT a transient test output — keep it versioned
# despite the *-TEST.md rule above. (Backups stay ignored via the *.backup.* rule.)
!engineering/document-production/manuals/p2-layout-torture-test/opus-master/P2-Layout-Torture-Test.md
!engineering/document-production/workspace/p2-layout-torture-test/P2-Layout-Torture-Test.md

# Archive directories
archive/
archive-*/
archive-old/
/exports/pdf-generation/outbound
/exports/pdf-generation/outbound
/exports/pdf-generation/inbound
/exports/pdf-generation/outbound
/engineering/pdf-forge/interactive-testing

# Workspace test documents (not versioned)
/engineering/document-production/workspace/*/test-documents/

# Audit working files (internal QA, not versioned - changelog captures results)
engineering/document-production/manuals/*/audit/
# App notes follow the same rule (P2AN007 2026-07-13 is the first with an audit/
# workspace): the verification-test rigs and their hardware logs are transient
# history. Accepted results replicate to engineering/ingestion/external-sources/
# hardware-verification/ (the EF ledger), which IS the source of truth.
engineering/document-production/app-notes/*/audit/
# EXCEPTION: an instrument's analysis IS its product (not transient release scratch),
# so the layout torture-test's audit/ is versioned alongside its cases.
!engineering/document-production/manuals/p2-layout-torture-test/audit/

# Todo MCP working directory
tasks/

# Human-managed directories (not versioned)
for-human/
human-todos/
.strategic-commentary/

# AI operational guides (not versioned)
.todo-mcp/
*.zip

# Forum posts (draft communications, not versioned)
engineering/obex-integration/FORUM-POST-*.md

# User reports (private feedback, not versioned)
docs/user-reports/

# Test extraction directories (not versioned)
extracted_images_enhanced_test/
/engineering/ingestion/yaml-backups
/engineering/knowledge-base/P2/language/pasm2/backup_before_update
/engineering/document-production/manuals/pasm2-reference/extracted-from-manual
/engineering/document-production/manuals/pasm2-reference/instruction-templates
/engineering/ingestion/extracted-documentation/yaml_updates
/engineering/ingestion/extracted-documentation/yaml_updates_pages_31_147
/engineering/ingestion/enriched-instructions/pasm2-narratives
/manifests/.history
/engineering/ingestion/smart-pins-catalog
/engineering/ingestion/sources/pasm2-manual/updated-yamls
/engineering/ingestion/sources/pasm2-manual/image-examples
.mcp.json
# Devcontainer - local-only files (host-provided binaries and config)
.devcontainer/docker-compose.override.yml
.devcontainer/.DS_Store
engineering/document-production/WORKSPACE-REORGANIZATION-COMPLETE.md
/engineering/document-production/outbound
engineering/document-production/workspace/p2-pasm-desilva-style/P2-PASM-deSilva-Style.md.v1-before-yourturn-fixes
/engineering/document-production/manuals/p2-assembly-language-manual/REF

# DOD validation local state
engineering/tools/.dod-validation-history.json
*.backup-encoding-conversion

# Timestamped edit backups (Sacred Rule #1 workspace artifacts) - never versioned;
# generalizes the ad-hoc *.backup-YYYYMMDD entries scattered below
*.backup-*

# Compiled example binaries (Stephen 2026-07-13): example .bin are NEVER committed
# nor shipped in example ZIPs - always recreatable from the versioned .spin2 via
# pnut_ts. (Ingestion assets/ .bin are source-document artifacts - NOT covered.)
engineering/document-production/**/*.bin

# Color bar test directory (temporary testing)
engineering/document-production/workspace/p2-assembly-language-manual/color-bar-test/
engineering/document-production/manuals/p2-pasm-desilva-style/opus-master/COMPLETE-OPUS-MASTER.md.pre-merge-backup.20251209_052816
engineering/document-production/workspace/p2-assembly-language-manual/request-align-test.json
/engineering/narrative/my-posts
/engineering/narrative
engineering/document-production/manuals/p2-smart-pins-tutorial/TITUS-MIGRATION-ANALYSIS.md
/engineering/document-production/workspace/p2-smart-pins-tutorial/pasm2-validation
/engineering/document-production/workspace/p2-smart-pins-tutorial/spin2-validation
/engineering/document-production/workspace/p2-assembly-language-manual/outbound
engineering/document-production/manuals/p2-smart-pins-tutorial/opus-master-green-book/P2-Smart-Pins-Green-Book-Tutorial.md.backup-20251213-pre-audit-fixes
*.backup-pasm-conversion
engineering/ingestion/sources/hyperRam-n-hyperFlash/64004-ES-REVA-HyperRAM_FLASH-0721-PCB-OS.dip
engineering/ingestion/sources/hyperRam-n-hyperFlash/64004-ES-REVA-HyperRAM_FLASH-0721-SCHEMATIC-OS.dch
deliverables/ai/P2/hardware/edge-32mb-module.yaml.backup-20250108
*.backup-20250108
engineering/history/CONVERSATION-ARCHIVES-INDEX.md
engineering/document-production/manuals/p2-assembly-language-manual/v2.0-changelog-draft.md
engineering/document-production/manuals/p2-assembly-language-manual/v2.0-commit-summary.md
engineering/document-production/manuals/p2-assembly-language-manual/opus-master/audit/user-reviews/2026-01-30/05-user-response-macca.md
/engineering/document-production/manuals/p2-assembly-language-manual/opus-master/audit/user-reviews

# Local-only reference material (licensed OBEX sources, etc.) — never committed
NO-COMMIT/
DRAFTS/
/engineering/ingestion/external-inputs/p2kb-update-requests
REF-NO-COMMIT/

# regenerable analysis/extraction reports (script outputs, not KB content)
engineering/ingestion/extracted-documentation/extraction_update_report.yaml
engineering/planning/yaml-audit-report.yaml
/engineering/ingestion/external-inputs/appNote-fodder-NO-COMMIT
/engineering/operations/correction-sweeps
/engineering/document-production/manuals/p2-debug-window-manual/figure-generators/screenshots-OLD-PNut-windows
/engineering/document-production/manuals/p2-debug-window-manual/figure-generators/screenshots-OLD
/engineering/document-production/manuals/p2-debug-window-manual/REF/robot-dog
/OBEX
/engineering/planning/REF audit v55 vs. theops