# 项目契约路径映射
# 由炼境根据技术栈扫描生成，技术栈变更后重新运行接入包生成
# 供 AGENTS.md 元规则 T1 查询：「哪个文件是这个项目的外部契约？」

contracts:
  - label: API 接口（Axum）
    paths:
      - "src-tauri/src/mcp_server.rs"
    doc: "路由变更需同步 API 文档"

  - label: MCP 工具接口
    paths:
      - "src-tauri/src/mcp_tools.rs"
      - "src-tauri/src/commands/delivery_status.rs"
      - "src-tauri/src/commands/toolchain.rs"
      - "src-tauri/src/commands/gitea.rs"
    doc: "工具 schema、dispatch 与调用说明必须同步；外部来源不可用时返回显式降级状态，不得伪造成功"

  - label: 被管理项目身份上下文
    paths:
      - "src-tauri/src/mcp_inject.rs"
      - "src-tauri/src/commands/onboarding.rs"
      - ".lian-jing/context.json"
      - ".lian-jing/capability-packs.json"
      - ".claude/liangjing.json"
    doc: "`.lian-jing/context.json` 是 project_id 的工具无关单一事实来源；`.claude/liangjing.json` 仅为兼容投影；`.lian-jing/capability-packs.json` 是炼境分发基线的版本描述。迁移必须保留未知字段；验证必须返回显式状态与 upgrade_hint；升级仅覆盖炼境托管文件，绝不覆盖项目定制或手工 MCP 配置，且不得以客户端全局配置或项目 UI 身份替代项目根目录上下文。"

  - label: Tauri command 接口（前后端契约）
    paths:
      - "src-tauri/src/commands/**/*.rs"
      - "src/lib/commands.ts"
    doc: "新增 command 时前后端必须同步"

architecture_docs:
  - "AGENTS.md"

agent_docs:
  - "AGENTS.md"
  - "docs/ai-context/project-brief.md"