# 为部署流水线导出完整的锁文件子集我们有一个 Rust 构建服务，直接使用仓库里的 `deno_lockfile`。一个 monorepo 共用`deno.lock`，但每个部署镜像只需要其中几个 workspace 成员。现在手工删 JSON 很容易漏掉 JSR 转 npm 的依赖、npm alias/peer 实例或平台相关依赖；保留整个锁文件又会让无关服务的升级影响部署产物。请给这个库增加一个纯内存的部署投影 API。调用方需要以下公开接口（从 crate 根导出）；类型至少实现 `Debug`、`Clone`，options还要有 `Default`，默认所有集合为空、`include_root` 为 false、`target` 为 None：```rustpub struct LockfileProjectionTarget {  pub os: String,  pub cpu: String,}pub struct LockfileProjectionOptions {  pub include_root: bool,  pub members: Vec<String>,  pub links: Vec<String>,  pub specifiers: Vec<deno_semver::jsr::JsrDepPackageReq>,  pub remote_roots: Vec<String>,  pub target: Option<LockfileProjectionTarget>,}impl Lockfile {  pub fn project(    &self,    options: &LockfileProjectionOptions,  ) -> Result<Lockfile, LockfileProjectionError>;}```使用场景例如选择 `members: vec!["services/api".into()]`，额外加入构建器发现的registry specifier 和 HTTP 模块入口，再指定 `linux` / `x64`。请按下面的约定实现：- `members`、`links` 精确匹配锁文件 workspace 中的键；未知键报错，重复选择无影响。  root 只由 `include_root` 选择。每个被选成员的 Deno 和 package.json dependencies  都是入口。links 是调用方明确提供的额外入口：锁文件没有足够信息推断路径归属，  不要把所有 links 或 root 自动加入。保留被选 workspace 记录，去掉未选记录；root  的 overrides 仅在选择 root 时保留。- 只用已有锁定结果计算闭包，不查询 registry、不重新解版本。保留实际用到的  specifier 映射、JSR 包及其依赖、npm 普通/optional/optional-peer 依赖；同一包的  不同 peer 上下文是不同实例，npm 依赖的别名也必须保留。完整 npm ID 是不透明标识，  实际依赖边来自记录，不能仅靠拆 peer 后缀猜依赖。没有用到的 specifier 映射即使  指向已保留包也应删除。环和共享子图必须正确处理，深链不能导致栈溢出。- 不指定 target 时保留所有平台的可选依赖。指定时，os/cpu 分别匹配后取交集：空  列表不限制，`!value` 否决该值；存在正项时还必须命中一个正项。值按 Node 平台名  精确匹配。只允许删除直接指向不兼容包的 optional/optional-peer 边，并同步删除  这条边的记录；该包若仍从必需边或入口可达则必须报错。一个兼容的可选包内部的  必需依赖仍按必需边处理。被选 link 的 optionalDependencies，以及  peerDependenciesMeta 中 `optional: true` 的 peer，也遵守此规则；去掉后者时  同步移除其 meta 条目。meta 用带 scheme、无版本的键（如 `npm:@scope/peer`），  与该 link 中同 scheme、同包名的 peer 对应。不要访问已被过滤分支里的依赖。- 被选入口或保留边缺失 specifier 映射、包记录时都报错，包括可选边：缺记录不能  被当作平台不兼容。未被访问的无关残留记录不能让投影失败。错误实现  `std::error::Error`，信息能区分原因并指出出错的键/请求/包或 URL。- `remote_roots` 是调用方收集的所有 HTTP 模块入口，用锁文件现有 redirects 一直  跟到 remote checksum；只保留经过的重定向与终点 checksum，支持共享尾部，  遇到环或缺失终点报错。URL 键精确匹配；一个键若同时有 redirect 和 checksum，  优先跟 redirect。不要推测锁文件没有记录的 HTTP import 边。- 保留下来的 integrity、tarball、安装标志、平台约束及未被删除的 workspace/link  元数据保持原样。输出沿用现有标准锁文件格式，可被现有 reader 读回；重复投影  和输入选择顺序变化应产生相同字节。空选择得到空锁文件。成功与失败都不能改变  原对象、写磁盘或访问网络；结果保留 filename/overwrite，`has_content_changed`  等于原有标记或序列化内容发生变化，并继续遵守 `resolve_write_bytes` 的行为。这次范围是库 API，不需要新增 Deno CLI 命令。请在现有库结构中完成可维护的实现、补充使用文档和相关测试，保持已有读取、升级格式、配置变更清理及序列化测试通过。实现结构和错误类型的具体组织由你决定；遇到未约定的兼容性问题可以提出权衡。仓库在 `/app`；环境已准备好 Rust 工具链与该库的离线依赖，可用`cargo test --locked --offline -p deno_lockfile` 验证。请提交你的改动到 git。

实现完成并已提交。## 变更内容**新增 `libs/lockfile/projection.rs`**- 公开 API：`LockfileProjectionTarget`、`LockfileProjectionOptions`（`Default` 全空、`include_root=false`、`target=None`）以及 `Lockfile::project`。- 入口解析：members/links 按锁文件键精确匹配并去重，未知键报错；root 仅由 `include_root` 选择；额外 `specifiers` 与 `remote_roots` 作为显式入口。- 闭包计算：完全基于已有 `specifiers`/`jsr`/`npm` 记录，用迭代式 BFS（无递归）处理环、共享子图与深链；只保留实际使用的 specifier 映射，npm 完整 ID 作为不透明键，保留 alias 与不同 peer 上下文实例。- 平台过滤：实现 npm 的 os/cpu 语义（空列表不限制、`!` 否决、正项白名单、两者取交集）；仅删除直接指向不兼容包的 optional/optional-peer 边并同步删除边记录；必需边/入口可达不兼容包时报错；被过滤分支的依赖不再访问。- link 处理：可选依赖与 `peerDependenciesMeta.optional: true` 的 peer 同样过滤，删除 peer 时同步删除 meta 条目。- remote 投影：沿 redirects 跟进到 checksum，保留路径上的 redirect 与终点 checksum，支持共享尾部，检测环与缺失终点；redirect 优先于同键 checksum。- 结果保留 `filename`/`overwrite`，`has_content_changed` 为原标记或序列化内容变化；空选择输出空锁文件；原对象、磁盘与网络均不受影响。**错误与导出**- 新增 `LockfileProjectionError`（实现 `std::error::Error`，`Debug`/`Clone`），各变体区分未知键、缺失 specifier/包记录、非法版本、必需包不兼容、重定向环/缺失终点，并携带出错的键、请求、包或 URL。**文档与测试**- README 增加投影 API 的使用说明与语义说明。- 新增 27 个集成测试，覆盖闭包/环/万级深链、specifier 裁剪、平台矩阵与否定语义、alias 与 peer 实例、link 可选 peer/meta、重定向共享尾部与错误、root/overrides、序列化回读、确定性、重复投影、不可变性及写回行为。## 验证- `cargo test --locked --offline -p deno_lockfile`：全部通过（24 单元 + 3 集成 + 27 新测试 + 37 spec tests + doctest）。- `cargo clippy --locked --offline -p deno_lockfile --all-targets`：无错误。- `cargo fmt -p deno_lockfile -- --check`：通过。提交：`723f8f08 feat(lockfile): add pure in-memory deployment projection API`

{ "parser_results": { "empty_selection_and_default_flags":"passed",#默认配置与空投影 "workspace_selection_closes_mixed_cycle_and_preserves_metadata":"passed",#工作区选择、混合依赖环与元数据 "multi_root_preserves_distinct_peer_instances_and_alias_edges":"passed",#多入口、peer 实例与别名依赖 "root_links_and_extra_specifiers_are_independent":"passed",#根、link 与附加入口独立选择 "unknown_selectors_are_exact_and_diagnostic":"passed",#未知选择器匹配与错误诊断 "only_used_specifiers_survive_even_when_same_resolved_package_is_kept":"passed",#仅保留实际使用的映射 "required_platform_conflict_is_not_optional":"passed",#必需与可选路径重叠的平台冲突 "ordinary_edge_to_incompatible_package_errors":"passed",#普通必需依赖的平台冲突 "compatible_optional_package_keeps_its_required_edges_required":"passed",#兼容可选包内部必需依赖的平台校验 "excluded_optional_branch_does_not_validate_broken_descendants":"passed",#被过滤分支不继续访问 "missing_optional_records_cannot_be_silently_skipped":"passed",#缺失可选记录时报错 "platform_lists_use_veto_and_positive_intersection_without_order_dependence":"passed",#OS/CPU 正负匹配与顺序无关性 "link_optional_and_peer_metadata_are_projected_together":"passed",#link 可选 peer 与元数据同步 "missing_link_optional_mapping_is_an_error":"passed",#link 可选映射缺失时报错 "link_required_peer_incompatibility_errors":"passed",#link 必需 peer 的平台冲突 "missing_selected_registry_records_are_errors_but_unreachable_damage_is_not":"passed",#可达记录缺失与无关残留隔离 "malformed_visited_jsr_resolution_is_diagnostic":"passed",#非法 JSR 解析结果诊断 "remote_shared_tail_and_direct_root_preserve_only_reachable_checksums":"passed",#远程入口与重定向共享尾部 "redirect_precedes_checksum_and_errors_are_atomic":"passed",#重定向优先级与失败原子性 "missing_direct_remote_root_and_self_loop_fail":"passed",#远程入口缺失与自环报错 "dirty_and_overwrite_flags_follow_existing_write_protocol":"passed",#变更、覆写标记与写回协议 "long_package_and_redirect_chains_are_iterative":"passed",#深依赖链与重定向链迭代 "generated_graph_closure_matches_independent_reachability_model":"passed",#生成图闭包与独立模型一致 "peer_suffix_is_identity_not_an_additional_dependency_source":"passed",#peer 后缀仅作身份标识 "all_root_categories_combine_as_a_union":"passed"#各类入口正确取并集 }, "summary": {  "new_feature_tests": "25/25",  "upstream_regression_tests": "64/64",  "final_reward": 1 } }

完成。已提交 `3a875bc4` 到分支 `feat/lockfile-deployment-projection`（基线 `c8401c52`），`cargo test --locked --offline -p deno_lockfile` 全绿：46 个单元测试、6 个集成测试、37 个既有 spec 测试、1 个 doctest，`cargo fmt`/`cargo clippy` 干净。## 实现内容**新增 `libs/lockfile/projection.rs`**（`lib.rs` 仅加 4 行：`mod projection;` + 3 个 re-export），公开接口与要求完全一致：`LockfileProjectionTarget`、`LockfileProjectionOptions`（`Debug + Clone + Default`）、`LockfileProjectionError`（thiserror，实现 `std::error::Error`）、`Lockfile::project(&self, &options) -> Result<Lockfile, LockfileProjectionError>`。核心是一个**迭代式**（显式 worklist，10 万层深链测试不爆栈）的闭包遍历：- **入口**：被选 root/成员的两类 dependencies、被选 link 的 deps/peers（meta 标 `optional: true` 的 peer 与 `optionalDependencies` 作为可选入口）、`options.specifiers`。所有 req 经 specifiers 映射解析（精确键匹配），JSR→npm 依赖、npm peer 实例（id 视为不透明，边只来自记录）、别名全部保留；只保留实际用到的 specifier 映射。- **平台过滤**：os/cpu 按 Node 语义分别匹配取交集（空表不限、`!v` 否决、有正项须命中）。只删直接指向不兼容包的 optional/optional-peer 边（含 link 层，删 peer 时同步删 meta 条目），被删分支不再深入；缺记录一律报错而非当作不兼容；兼容可选包内部的必需依赖按必需边处理。- **remote_roots**：redirect 优先于 checksum，只保留经过的 redirect 与终点 checksum，支持共享尾部，环/缺终点报错，URL 精确匹配。- **输出保证**：标准 v5 格式可被 `Lockfile::new` 读回；字节级确定性（重复投影、选择乱序结果相同）；空选择得空锁文件；纯内存不改原对象；结果保留 `filename`/`overwrite`，`has_content_changed` = 原标记 ∨ 序列化变化，`resolve_write_bytes` 行为不变。workspace 记录、integrity/tarball/scripts/bin/os/cpu 等元数据原样克隆。**测试**：22 个模块内单元测试（覆盖上面每条规则、错误信息、确定性、纯度）+ `tests/projection_test.rs` 3 个走公开 API 的集成测试（含任务描述的 services/api + linux/x64 场景、读回 round-trip）+ rustdoc 可运行示例；README 增加了完整使用文档。## 一个需要说明的解释性取舍「该包若仍从必需边或入口可达则必须报错」我按字面语义实现：**报错条件是"某条指向不兼容包的可选边被删除"且"该包仍从必需边/入口可达"**（两个方向都会检测，与遍历顺序无关）。因此一个不兼容包若*仅*经必需边可达、且没有任何可选边指向它，会被原样保留而不报错——因为规范明确"只允许删除可选边"，必需结构不做二次猜测（真实 npm 锁文件中必需依赖几乎不会带平台约束，平台相关的都在 optionalDependencies）。如果你希望更严格的语义（不兼容 ∧ 必需可达 ⇒ 一律报错，无论是否存在被删的可选边），改动很小：在 `visit_npm_required` 里去掉 `pruned_targets` 条件即可，我可以补一个提交。

{ "parser_results": { "empty_selection_and_default_flags":"passed",#默认配置与空投影 "workspace_selection_closes_mixed_cycle_and_preserves_metadata":"passed",#工作区选择、混合依赖环与元数据 "multi_root_preserves_distinct_peer_instances_and_alias_edges":"passed",#多入口、peer 实例与别名依赖 "root_links_and_extra_specifiers_are_independent":"passed",#根、link 与附加入口独立选择 "unknown_selectors_are_exact_and_diagnostic":"passed",#未知选择器匹配与错误诊断 "only_used_specifiers_survive_even_when_same_resolved_package_is_kept":"passed",#仅保留实际使用的映射 "required_platform_conflict_is_not_optional":"passed",#必需与可选路径重叠的平台冲突 "ordinary_edge_to_incompatible_package_errors":"failed",#普通必需依赖的平台冲突 "compatible_optional_package_keeps_its_required_edges_required":"failed",#兼容可选包内部必需依赖的平台校验 "excluded_optional_branch_does_not_validate_broken_descendants":"passed",#被过滤分支不继续访问 "missing_optional_records_cannot_be_silently_skipped":"passed",#缺失可选记录时报错 "platform_lists_use_veto_and_positive_intersection_without_order_dependence":"passed",#OS/CPU 正负匹配与顺序无关性 "link_optional_and_peer_metadata_are_projected_together":"passed",#link 可选 peer 与元数据同步 "missing_link_optional_mapping_is_an_error":"passed",#link 可选映射缺失时报错 "link_required_peer_incompatibility_errors":"failed",#link 必需 peer 的平台冲突 "missing_selected_registry_records_are_errors_but_unreachable_damage_is_not":"passed",#可达记录缺失与无关残留隔离 "malformed_visited_jsr_resolution_is_diagnostic":"passed",#非法 JSR 解析结果诊断 "remote_shared_tail_and_direct_root_preserve_only_reachable_checksums":"passed",#远程入口与重定向共享尾部 "redirect_precedes_checksum_and_errors_are_atomic":"passed",#重定向优先级与失败原子性 "missing_direct_remote_root_and_self_loop_fail":"passed",#远程入口缺失与自环报错 "dirty_and_overwrite_flags_follow_existing_write_protocol":"passed",#变更、覆写标记与写回协议 "long_package_and_redirect_chains_are_iterative":"passed",#深依赖链与重定向链迭代 "generated_graph_closure_matches_independent_reachability_model":"passed",#生成图闭包与独立模型一致 "peer_suffix_is_identity_not_an_additional_dependency_source":"passed",#peer 后缀仅作身份标识 "all_root_categories_combine_as_a_union":"passed"#各类入口正确取并集 }, "summary": {  "new_feature_tests": "22/25",  "upstream_regression_tests": "64/64",  "final_reward": 0 } }