Context Rush 工作区结构
@c4a/extract-rush 为 Rush 工作区生成确定性结构索引。它报告项目身份、标签、
subspace、发布意图、入口信号、直接依赖/消费者边、构建 phase/command、发布单元、解耦依赖和
最近的 OWNERS 边界。
这些索引是 Code Indexer Provider 的结构证据，不是产品分类。Provider 决定哪些 事实对目标读者有价值并返回当前 Indexer Result；来源身份、Candidate 新鲜度、 审核、正式知识和知识包产出继续由 Context 负责。
在知识生产链中的位置
已确认的 Rush 仓库边界
↓
rush.json + package.json + Rush 配置 + OWNERS 事实
↓
选中的 Code Indexer Provider
↓
经过审核的架构 / 归属 / package 知识
使用
import {
indexRushWorkspace,
rushWorkspaceIndexToEvidenceAdapterResult,
} from "@c4a/extract-rush";
const facts = await indexRushWorkspace(repositoryRoot, {
tags: ["frontend"],
});
const evidence = rushWorkspaceIndexToEvidenceAdapterResult(facts, invocation);
不提供 tag filter 时选择所有项目；includeAll: true 也会显式选择全部项目。结果
经过排序并保持稳定，适合生成来源指纹和可重复的候选。
索引包含：
- Rush 和 package manager 版本；
- package 名，以及
package.json身份是否与rush.json一致； - project folder、subspace、tag 和 publish flag；
- 已登记的 subspace 目录及项目成员；
main、module、types、exports和bin入口信号；- 本地依赖类型、直接消费者和 specifier，包括 decoupled edge；
- phased build 依赖、command 到 phase 的绑定，以及各项目是否实现 phase；
- lock-step、individual-policy 和 standalone 发布单元；
- 最近的 repo-relative
OWNERS文件和标准化 reviewer。
构建事实只通过内容摘要保留 command/script 身份；结构索引与 Evidence ABI 均不复制原始 shell command 或 package script。
这个可选包不会增加公开 Agent 入口或 Context 生命周期阶段，只作为项目 Adapter
可以复用的结构库。
Evidence ABI 转换为每个 rush.json、已选择的 package.json 和 OWNERS 输入指定唯一
primary owner，把项目文件绑定到授权 module ref，并将 workspace/project/dependency/owner
事实作为 catalog protocol item 发布。存在 subspaces.json、command-line.json 和
version-policies.json 时，它们分别成为具有唯一 owner 的 evidence 文件。
开发
bun run --filter @c4a/extract-rush build
bun run --filter @c4a/extract-rush typecheck
bun run --filter @c4a/extract-rush test
bun run --filter @c4a/extract-rush lint