#配置与作用域

#症状

CapabilityGraph.open() 返回 CG_CONFIG_INCOMPLETE、CG_DUAL_AUTHORITY、CG_LOAD_FAILED 或 CG_VALIDATION_FAILED。

#检查顺序

1. hostAllowedProviders、integrationEnabledProviders 和 providers 都是数组。
2. 有效启用范围中的每个 Provider 恰有一个 ProviderLoadSpec。
3. 文件根存在且进程可读，provider.json 的 ID 与配置一致。
4. 单个定义文件不超过 262,144 UTF-8 字节，JSON 可解析。
5. 所有必填字段、关系端点和知识 locator 合法。
6. parents、specializes、requires 分别无环；数据库 Authority 的反向关系流还必须与正向记录一致。

首次加载失败没有旧视图可回退。修复来源后重新 open，不要把缺 Authority 改成空目录成功。

#作用域与选择

CG_SCOPE_DENIED 表示请求试图使用宿主或集成未允许的 Provider。打印三层范围并核对交集，不要通过扩大请求范围绕过宿主配置。

CG_IDENTITY_AMBIGUOUS 表示未绑定调用只提供了 { capabilityId }。改用完整 { providerId, capabilityId }，或先 forProvider(providerId)。

知识读取和检索要求非空 selected。Agent 没有选择能力时，应继续目录/详情流程，而不是用空选择探测全部知识。

绑定 facade 禁止 requestProviderScope。如果 JavaScript 对象意外带入该字段，会得到 CG_INPUT_INVALID；请在协议层分别定义绑定和非绑定输入。