# Class 与 Framework 查询

用于 class 摘要、成员分类、子类实现、回调重写和生命周期协议。公开入口只有
`class_lookup.py`；Framework Profile 是 class 查询的附加层，不单独调用另一个 CLI。

先查看脚本当前契约：

```bash
python <this-skill-dir>/scripts/class_lookup.py --help
```

## 查询

```bash
python <this-skill-dir>/scripts/class_lookup.py --list
python <this-skill-dir>/scripts/class_lookup.py --class TStringList
python <this-skill-dir>/scripts/class_lookup.py --class TSBackTesting
python <this-skill-dir>/scripts/class_lookup.py \
  --class TSBackTesting --config FGroupType=1 --format json
```

- 查询或使用任意 class 时，先取类摘要；需要具体成员正文时，再按返回的
  `qualified_name` 运行 `lookup.py --name`。
- `class_lookup.py` 自动覆盖 `function_index.tsv` 中 `kind=class` 的条目，不要求普通
  对象类维护人工 Profile。
- 只有 `kind=framework` 且有证据化生命周期的类才叠加 Framework Profile。不得因目标
  是 class 就推断它是框架。
- 同名 class 的 `status=ambiguous` 时，使用 `--scope`、`--module` 或完全限定名消歧。

## 状态判读

- `status=resolved`：类查询已解析；`status=not_found`：索引中无该 class；
  `status=ambiguous`：存在多个候选。
- `profile_status=not_profiled`：普通 class，只使用自动成员视图，不是错误，也不表示数据
  不完整；成员查询可以继续。若当前请求依赖生命周期、配置或回调，则表示没有已验证的
  framework 契约，必须停止该部分，不能假设空的 Framework Profile。
- `profile_status=resolved`：返回了 Framework Profile。
- `scaffold_status=resolved` 只表示生命周期和成员引用完整。
- `contract_status` 不是 `resolved` 时，必须按 `diagnostics` 补齐模式与返回 schema 证据，
  并停止生成回调字段。
- `contract_status=resolved` 时，`contracts[].return_schemas` 给出全部已验证模式；传入
  `--config` 命中模式后，`contracts[].selected_return_schema` 给出当前配置对应的字段契约。

Framework Profile 只描述 API 协议，不定义 TSL 语法或代码结构。解析后的 Framework
Contract Packet 仅作为已验证的 API 事实输出。

只有返回的 Profile 本身带有生命周期、配置、回调、执行入口或结果查询证据时，才使用
这些协议；`not_profiled` 时不能从 class 名称或成员列表推断 framework。

使用自定义 `--tsv` 时默认不加载 Framework Profile，普通 class 仍可查询；该索引确有
curated Profile 时必须同时显式传入 `--profiles`。

## 退出码

- rc=0：查询或校验完成；`not_found` 和 `ambiguous` 通过输出状态表达。
- rc=1：索引/Profile 数据缺失、损坏或引用校验失败。
- rc=2：参数不合法。

`--check` 属维护动作，普通编码查询不需要运行。