refactor(ffi): 降级 FFI 为可选兼容层并整理文档

将 bat-ffi 明确收敛为无状态 C ABI 兼容层，默认集成路径改为 bat --json 进程边界或未来稳定 SDK。

同步 README、当前状态、项目计划、架构文档、开发指南和缺口清单，移除 FFI 作为主集成边界的表述。

新增 AGENTS.md 和 CONTRIBUTING.md，压缩 CLAUDE.md 为兼容入口，并归档阶段性报告、同步 .gitignore 规则。

docs/reports/CURRENT_GAPS.md

@@ -172,7 +172,7 @@
 现象：
 
 - `cmd/bat` 目录存在，但无 `main.go`。
-- `internal/ffi/ffi.go` 已存在，但还不是用户可运行 CLI。
+- `internal/ffi/ffi.go` 已存在，但只是可选 CGO 兼容包装，不是用户可运行 CLI，也不是默认 Go/Rust 集成边界。
 - `go test ./...` 当前没有产品级 Go package 覆盖。
 
 影响：
@@ -185,6 +185,7 @@
 - `bat doctor` 可运行。
 - `bat --help` 命令结构稳定。
 - 命令支持默认人类可读输出和 `--json` 机器输出。
+- Go CLI 默认通过 Rust `bat --json` 进程边界获取同步 report；除非明确兼容需求，不依赖 FFI。
 
 ### G-009：API Server 和 OpenAPI 尚未实现
 
@@ -378,6 +379,7 @@
 
 - 架构 README 已明确当前 Rust 官方同步入口、Go 计划边界和目标架构差异。
 - 官方资源后端说明由 `docs/architecture/official-resource-backend.md` 承载。
+- `bat-ffi` 已降级为可选无状态兼容层，主集成边界明确为 `bat --json` 进程边界或未来稳定 SDK。
 
 ### G-017：CI 未落地
 

docs/reports/historical/README.md

@@ -0,0 +1,14 @@
+# 历史报告归档说明
+
+本目录只保存追溯资料，不代表当前项目状态。当前状态以根目录 `CURRENT_STATUS.md`、`PROJECT_PLAN.md`、`DOCS_INDEX.md` 和 `docs/reports/CURRENT_GAPS.md` 为准。
+
+归档分类：
+
+- `current-stage/`：曾用于阶段交接或推送前核查的临时 current report，已由当前状态文档和指南取代。
+- `root/`：早期位于仓库根目录的阶段报告。
+- `week2/`、`week3/`：早期周报、阶段报告和质量报告。
+- `quality/`：早期质量状态报告。
+- `build-logs/`：历史构建、测试和 Clippy 输出。
+- `nested-docs/`：从误嵌套 `docs/docs` 移出的历史报告。
+
+新增运行产物、smoke 输出、质量扫描输出和本地分析报告不要放入本目录；这些文件应写入 `/tmp`、显式的隔离输出目录，或被 `.gitignore` 覆盖的本地生成报告目录。