# Reference for human and agent review. CI does not scan repository prose against this file.
version: 2

terms:
  circuit-breaker:
    en: circuit breaker
    zh: 熔断器
    code: breaker
    avoid_zh:
      - breaker
      - 断路器
  approval-outcome:
    en: approval outcome
    zh: 审批结果
    avoid_zh:
      - approval outcome
      - approval outcomes
  rolling-window:
    en: rolling window
    zh: 滚动窗口
  last-valid-configuration:
    en: last known-good configuration
    zh: 上一次有效配置
    avoid_zh:
      - 上一份合法配置
      - 上一次合法配置
      - 上一份已通过校验的配置
    avoid_en:
      - last valid configuration
      - last valid config
  required-behavior-check:
    en: required behavior check
    zh: 行为检查
    avoid_zh:
      - 行为契约
  coverage-threshold:
    en: coverage threshold
    zh: 覆盖率阈值
    avoid_zh:
      - coverage 阈值
  fallback-path:
    en: fallback path
    zh: 回退路径
    avoid_zh:
      - fallback
  local-query:
    en: local query
    zh: 本地查询
    avoid_zh:
      - 事实查询
  read-only-query-tool:
    en: read-only query tool
    zh: 只读查询工具
    avoid_zh:
      - 事实工具
  manual-operation:
    en: manual
    zh: 手动
    avoid_zh:
      - 手工
  lookup-path:
    en: lookup path
    zh: 查找路径
    avoid_zh:
      - 解析链
  fingerprint:
    en: fingerprint
    zh: 指纹
    code: fingerprint
    avoid_zh:
      - 身份哈希
  symbolic-link:
    en: symbolic link
    zh: 符号链接
    avoid_zh:
      - 软链
  process-flow:
    en: flow
    zh: 流程
    avoid_zh:
      - 管线
  audit-record:
    en: audit record
    zh: 审计记录
    avoid_zh:
      - 台账
  operation-prefix:
    en: string prefix
    zh: 字符串前缀
    avoid_zh:
      - 字面操作前缀
      - 字面字符串前缀
  retry:
    en: retry
    zh: 重试
    avoid_zh:
      - 纠正重试
  rejected-outcome:
    en: rejected
    zh: rejected
    code: rejected
  unavailable-outcome:
    en: unavailable
    zh: unavailable
    code: unavailable

# These phrases should be rejected during human or agent review because they
# repeatedly obscure the real behavior or add an unnecessary abstraction.
# They are review cues, not CI search patterns.
forbidden_zh:
  - 记账
  - 内部消化
  - 两道门槛
  - 确定性的源码测试

forbidden_en:
  - behavior contract
  - breaker bookkeeping
  - contained inside the auditor
  - deterministic source tests