# agent-intent 错误码映射

agent-intent v1 无 HTTP 面，核心包按 Pattern B 接入：错误常量的字符串值即下列规范码，错误类型实现 `ErrorCode()` / `ErrorFields()` 鸭子方法供日志系统展开；其仓内 `catalogcheck` 对齐测试保证两边常量相等，本表是人类可读对照。

| agent-intent 常量 | 规范码 | HTTP | 触发场景 |
|---|---|---|---|
| `intent.InvalidSpec` | intent.invalid_spec | 400 | spec 定义/校验失败：id 冲突、正则不合法、未知字段、matcher 无正向条件、槽位 group 越界、覆盖版本未递增 |
| `intent.SpecProtected` | intent.spec_protected | 400 | overlay 试图覆盖或禁用保护域内的 spec |
| `intent.LoadFailed` | intent.load_failed | 500 | 配置读取/解析失败；此时保留上一生效快照 |
| `intent.InvalidArgument`（复用框架域） | sys.invalid_argument | 400 | 调用方错误：nil 快照、输入超长 |

「无匹配」（fallback 分支）是正常识别结果，不产生错误码；识别路径的失败语义与重试由宿主决定。