> For AI agents: the complete documentation index is available at https://devcodex-labs.github.io/capability-graph/llms.txt, the full documentation bundle is available at https://devcodex-labs.github.io/capability-graph/llms-full.txt.

# 配置与作用域

## 症状

`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`；请在协议层分别定义绑定和非绑定输入。