.gitignore

# 构建产物（任意层级，各版本通用）
build/
build-msvc/
out/
run/
.gradle/
*.log

# C++
*.o
*.obj
*.dll
*.exe
*.lib
*.a

# 生成数据 + 本地工具链（不入库）
# 注意：目录级规则 `data/` 会 prune 目录，子文件无法用 ! 重包含——白名单链仅对 versions/1.20.1/data 子树放宽
data/
**/data/*
!versions/1.20.1/data
versions/1.20.1/data/*
!versions/1.20.1/data/worldgen
versions/1.20.1/data/worldgen/*
# 例外（260905-06，用户拍板 S3）：手工维护的 worldgen 配置白名单入库，防修复静默丢失
!versions/1.20.1/data/worldgen/light_data.json
tools/

# IDE
.vscode/
.idea/
*.iml


promo/

# 会话交接文档（仅本地，不入库）
HANDOFF.md
NEXT_SESSION.md
AGENTS.md

# 崩溃日志（crash handler 产出，不入库）
versions/1.20.1/crash-*.txt
crash-*.txt

# 私有知识资产（用户 2026-08-15 明确：Vulkan/GPU 通用知识库为本项目核心资产，不公开入库）
knowledge/discovered/vulkan-gpu-programming.md

# 内部工作流（仅本地，不入库）：验证协议 + 锚点扫描工具（引用本机 Anchorlaw 路径）
protocol/
# 脚本目录：原为 `scripts/`（任意深度匹配，会连 worldgen-core/scripts 等嵌套目录一起忽略）。
# 260918-01 (B6-1) 改为「根锚定 + 白名单」——git 不支持在被排除目录内 re-include，
# 故必须用 `/scripts/*` 而非 `scripts/`（后者无法用 ! 放行），且加前导 / 以免误伤嵌套同名目录。
/scripts/*
# 例外：被 AGENTS.md 明文引用的「门禁资产」必须入库（无本机依赖的纯 stdlib 脚本）。
# 理由：门禁脚本不入库 ⇒ AGENTS 引用的门禁在新环境/CI 中不存在（与知识库 #164 同族）。
!/scripts/check_switch_mapping.py
!/scripts/merge_index.py
!/scripts/scan_cpp_anchors.py
# 嵌套 scripts 目录维持原忽略语义（如 worldgen-core/scripts）：
scripts/

# CoreSwap 迁移补充：Java 探针工程 2026-08-24 迁回 CoreSwap（曾错误地留在 MC 只读不入工作区，致找不回来；现迁移+源码入库）
# versions/1.20.1/java/
versions/1.20.1/bench/
# 未开发占位（ai 层未来按需加回）
versions/1.20.1/cpp/ai/
# Reasonix 工具元数据（已迁移 DSH，保留历史规则）
.reasonix/
# DSH 项目级技能根（本地工具链，从 RE-Framework dsh/skills 同步生成，不入库）
.dsh/

# perf-rework GPU 课题：构建产物 + 中间输出（源码/文档/cmd-output 验证记录/gpu-assets 产物入库）
__pycache__/
*.pyc
.investigations/perf-rework/**/*.spv
.investigations/perf-rework/vulkan-proto/*.txt
.investigations/perf-rework/vulkan-proto/*.bin
.investigations/perf-rework/*.spvasm
.investigations/perf-rework/*.asm
.investigations/perf-rework/vulkan-proto/*.spvasm
.investigations/perf-rework/vulkan-proto/*.asm
.investigations/perf-rework/final_density.spv
.investigations/perf-rework/*.spv.noinline.spv

# external reference clones (read-only).investigations/reference/

# external reference clones (read-only)
.investigations/reference/

# [legacy] 旧 Java 工程位置（runtime/1.20.1/java/{build,.gradle,run,data}）——260910-07 起工程已迁 versions/<ver>/java；
# 这些路径下的旧缓存/环境目录仍原地保留，由下方 `/runtime/` 整树规则覆盖，此处不再重复列。
# gradle user home (dependency cache, copied into workspace for sandbox-free gradle)
.gradle/
# 临时区（260902-09 补：一次性脚本/dump 数据/依赖缓存不入库）
.tmp/
.gradle-home/
.tmp-coreswap-data/


# Java MOD 运行时工程（本地私有，不入库）
/runtime/

# 260910-07 迁移：Java mod 工程本体移到 versions/<ver>/java（**源码/构建定义/worldgen-data 入库**）；
# 派生与缓存一律忽略——run/ 是运行环境（含 runDir 指回的 runtime/ 路径）、build//.gradle/ 是构建缓存、
# src/main/resources/native/ 是 processResources 从 target/release 复制的 dll。
versions/*/java/build/
versions/*/java/.gradle/
versions/*/java/run/
versions/*/java/*/run/
versions/*/java/src/main/resources/native/

# 260910-07 补充：全局 `data/` + `**/data/*`（:19-20）是**目录级 prune**，会把
# `src/main/resources/worldgen-data/data/**`（2758 个 JSON）整片吃掉 ⇒ 按本项目 #24 教训加**逐级白名单链**
# （父目录未被忽略才能用 `!` 重包含；`!` 规则必须写在 `data/` 之后）。只对本子树放宽。
!/versions/*/java/src/main/resources/worldgen-data/data/
!/versions/*/java/src/main/resources/worldgen-data/data/**
/spec/
.investigations/multiworld-port/MCP-Reborn/

# Rust workspace target（260905-01 拆分后落仓库根）/target/
/target/
!versions/1.20.1/data/worldgen/biome_registry_order.json

# 结构整改可逆归档（260908-08，本地保存不入库）
archive/

# 260910-07（judge C13）：`.investigations/**/cmd-output/logs/` 下的 `.log` 是**证据主体**（stdout：
# CHUNKTIME / WG-CONTENT / 拦截行计数），全局限定 `*.log`（:7）会让 `git add` **静默跳过**它们 ⇒ 白名单放行。
!.investigations/**/cmd-output/logs/*.log

# 260911-05：`.investigations/**/evidence/` 下的 `raw-*.log` 是 Tier 1/2/4 的**原始运行日志**
# （`[WG-CONTENT-WB]` 逐 chunk 指纹 + `[WG-BULKWB]` 计时 + 四支自检），同受 :7 全局 `*.log` 影响
# ⇒ 白名单放行（与上条同因，260910-07 judge C13 已立先例）。
!.investigations/**/evidence/*.log