AGENTS.md@.github/contracts/fate/bazi-formalization git:20261025.3c17b73A

Immutable. This exact content never changes and is served at /api/v1/blob/5b19bbebec02bc47.

# AGENTS.md - 八字形式化机器契约

## 目录用途

本目录是八字形式化的 machine-readable contract 真相源；只定义 schema、Profile、版本、状态、错误和证据映射，不放算法实现、运行结果或人类长文。

## 目录结构

```text
bazi-formalization/
├── AGENTS.md
├── README.md
├── schemas/          # RawInput、CanonicalInput、finite algebra、RuleProfile、evidence/shadow schema
├── profiles/         # CalendarProfile、RuleProfile、support interval
├── registries/       # milestone、field owner、proof/provider/oracle/source registry
├── policies/         # outcome、candidate、version、performance、release policy
└── timeline/         # 时辰 frame/transition/track/typed value 与 Point/Window 契约
```

## 依赖与边界

- 上游：`.github/contracts/fate/` 既有 capability、profile、source、location 和 evaluation 契约。
- 下游：`.github/domains/fate-analysis/services/fate-core/` canonical kernel、tests、proof harness、delivery consumer。
- 不依赖 Web/Bot/CLI/数据库，不保存生产凭据或一次性运行 evidence。
- 领域算法不在此目录实现；实现只能消费稳定契约并回填验证证据。

## 开发规则

- 所有字段必须有 version、owner、source、support/unsupported 行为和序列化语义。
- 0/1/n candidates、unknown、conflict、counter-evidence 不得被 schema 简化为单值布尔。
- 变更必须同步对应 human reference、module context、ADR/Gate、tests 和 migration/rollback 证据。
- 新增 schema 前先做 existence/复用检查；不得复制既有 capability 或通用规则框架。
- `shadow-evidence.schema.json` 只约束生产字段/调用面影子报告；报告正文位于 `.github/governance/evidence/conformance/`，不得把运行态 evidence 写回本目录。
- `timeline/` 只定义时辰时间轴的机器语义；算法归 fate-core，HTTP/静态资产归 delivery，体验状态归 `.github/apps/timeline-web`。