v5.9.5

What's Changed

• [AI Generated] [FEAT] 轨道库出默认态并修复示例过时属性与旧库报错（#624 #625 #632） by @cislunarspace in #633
• [AI Generated] [FEAT] design_orbit 的 NRHO/HALO 取值域放宽，HALO 逐平动点分档（#643） by @cislunarspace in #644

Full Changelog: v5.9.4...v5.9.5

v5.9.4

中文

帧读取修复。sidecar 读循环解帧时 shape 只解了首维，ndim≥2 的画布帧数据段读取不足、帧流自此失步，后续帧报 magic 不符；transfer_design 与 orbit_family_generation 经 MCP/sidecar 的带帧调用全部失败，一维帧不受影响。现按全部 ndim 个 u32 解包，多维帧与一维帧同样整帧读回，帧后尾随字节原样留在流里。

English

Frame reading fix. The sidecar read loop unpacked only the first shape dimension when framing worker output, so frames with ndim ≥ 2 under-read their payload and the frame stream lost sync from that point on (subsequent frames failed the magic check); framed calls to transfer_design and orbit_family_generation over MCP/sidecar all failed, while 1-D frames were unaffected. The shape is now unpacked as all ndim u32 words, so multidimensional frames are consumed whole just like 1-D frames, with trailing bytes left in the stream untouched.

v5.9.3

本版本更新了 MCP 接口，精简了测试套件，增强了贡献流程；后续贡献者在使用 AI 提交 issue 和 PR 的过程中，应当遵守相关约定。

This release updates the MCP interface, slims down the test suite, and strengthens the contribution workflow. Contributors filing issues and pull requests with AI assistance should follow the established conventions.

中文

MCP 接口。工具按属主分三类：任务级方法留在 Facade，轨道库与族生成归 Catalog，空间分区解析归 Spatiography；MCP 工具名与 CLI 子命令保持不变，Python 调用方经 facade.catalog / facade.spatiography 访问。新增两个出口工具：catalog_terminology（42 个分类学标签图例与族名、转移类型闭值集）与 valid_ranges（请求侧条件值域，含逐字段单位与开闭语义），工具面共 19 个。族生成改为一轨一记录、族为标签，family_id 为族句柄，catalog_query(family_id=…) 取回整族。

测试套件。删除元测试（契约、同步锁、派生对照类），保留行为级断言；测试目录镜像源码结构的六类划分不变。

贡献流程。五类中文 Issue 模板（Bug/Feature/Idea/Research/Task）、type/kind/area 三组标签与七态推进面板（与 transfer-orbit-design 共用）；AI 生成的 issue 与 PR 须在标题最前面加 [AI Generated] 标记并带类型标签（如 [FEAT]），未正确标记不予受理，细则见 CONTRIBUTING.md。

升级注意：Python 调用方的库方法改经 facade.catalog.…、分区解析改经 facade.spatiography.…；族生成响应字段更名（record_id → family_id、member_count → member_index，帧载荷字段随更名），下游数据模型需同步。

English

MCP interface. Tools are now grouped by owner class: task-level methods stay on Facade, catalog and family generation move to Catalog, and spatiography analysis moves to Spatiography. MCP tool names and CLI subcommands are unchanged; Python callers reach the moved methods via facade.catalog / facade.spatiography. Two new outlet tools: catalog_terminology (42-entry taxonomy label legend plus closed value sets for orbit families and transfer types) and valid_ranges (request-side conditional value domains with per-field units and interval openness), bringing the tool surface to 19. Family generation now stores one record per trajectory with the family as a label; family_id is the family handle and catalog_query(family_id=…) returns the whole family.

Test suite. Meta-tests (contract, synchronization-lock, derived-comparison classes) were removed; behavior-level assertions are retained, and the six-category directory layout mirroring the source tree is unchanged.

Contribution workflow. Five Chinese issue templates (Bug/Feature/Idea/Research/Task), the type/kind/area label taxonomy, and a seven-state project board shared with transfer-orbit-design. AI-generated issues and PRs must carry an [AI Generated] tag before the type tag in the title; unmarked submissions will not be accepted — see CONTRIBUTING.md.

Upgrade notes: Python callers should use facade.catalog.… and facade.spatiography.…; family-generation response fields were renamed (record_id → family_id, member_count → member_index, with frame-payload fields renamed alongside), so downstream data models need to sync.

基线数据集 baseline-cr3bp 5.9.0

CR3BP 基线轨道族数据集（九族 × 地月 DE421，13 个分发包、592 条轨道成员）。

自 ADR 0047 起基线数据集不再随 wheel 分发，改由本 Release 提供。资产版本即记录内的 scalars.baseline_version。

使用

from e2m2e.data.catalog import CatalogStore, import_baseline

store = CatalogStore("path/to/your/catalog")   # 显式创建库
import_baseline(store, "baseline-cr3bp-5.9.0")  # 解压后的资产目录

导入幂等：同版本重复导入跳过；数据集升级后重导入会按族替换旧成员。库目录与是否入库由调用方显式决定（Config(catalog_dir=..., catalog_enabled=True) 或 $E2M2E_CATALOG_DIR / $E2M2E_CATALOG_ENABLED）。

数据集内容由 make catalog-baseline 生成（源码仓库 e2m2e/data/catalog_baseline/）。

v5.9.2

What's Changed

• perf(dynamics): 下沉 CR3BP/BCR4BP rust 事件路径 EOM 至 Rust 内核，消除 solve_ivp_events 跨语言回调（#594 / #546 处置 2） by @cislunarspace in #600
• feat(api): 传输层收拢为单一执行核心，注入的 Config 穿透 worker 子进程（#601） by @cislunarspace in #604
• feat(cli): 工具子命令与 MCP 工具面对称，从 tool_inventory 派生（#602） by @cislunarspace in #605
• fix(test): native 符号缺失应 skip 而非硬失败，清理 tests 幽灵目录（#603） by @cislunarspace in #606
• feat(sidecar): 线级任务取消与长任务 worker 路由，进度升级为真实分数（#607） by @cislunarspace in #608

Full Changelog: v5.9.1...v5.9.2

v5.9.1

What's Changed

• feat(taxonomy): 轨道分类学 42 标签内核 + 入库打标 + 响应富化（#581 / ADR 0042） by @cislunarspace in #585
• feat(mcp): 长任务工具取消——worker 子进程隔离（#588 / #576 Phase 2，ADR 0014 增补） by @cislunarspace in #590
• docs(station-keeping): 新增站保章节，持久化参数标定依据（#541） by @cislunarspace in #589
• fix(nrho): L2 族生成种子以北族为基准，修正南北双向反号（#586 / ADR 0042） by @cislunarspace in #592
• feat(transfer): 转移弧惯性系表示——state_frame 词汇扩 gcrs_km（#584, ADR 0040 增补） by @cislunarspace in #591
• feat(spatiography): Gallardo 半宽/长期 loci/vZLK + MEGNO 内核与命运分类 + 六域制图管线（ADR 0041 Phase 3，#578 #579 #580） by @cislunarspace in #593
• feat(transfer): 转移搜索暴露 top-N 可行解契约——opt-in 候选列表与选中解标记（#583, ADR 0040 增补） by @cislunarspace in #597
• fix(family): DPO 修正补顺行分支校验，baseline dpo 再生全顺行（#587 / ADR 0042） by @cislunarspace in #596
• feat(normal_form): _second_derivative 升级为 qiao 风格高阶 Vandermonde 微分系数（#544） by @cislunarspace in #599
• docs(architecture): dynamics 层三处 Python 数值路径处置结论登记（#546） by @cislunarspace in #595
• test(infra): ADR 0037 单用例时间预算机器强制门禁（#548） by @cislunarspace in #598

Full Changelog: v5.9.0...v5.9.1

v5.9.0

What's Changed

• feat(spatiography): 地月空间分区解析内核与 MCP 三工具（Primer §5，ADR 0041） by @cislunarspace in #577
• feat(api): 机动事件契约 + transfer record 入库 + MCP 进度通知（#574 #575 #576 Phase 1, ADR 0040 增补） by @cislunarspace in #582

Full Changelog: v5.8.10...v5.9.0

v5.8.10

What's Changed

• feat(transfer): 转移收敛响应新增 state_frame 数据系标注（ADR 0040 增补） by @cislunarspace in #572
• chore(release): 发布 5.8.10 by @cislunarspace in #573

Full Changelog: v5.8.9...v5.8.10

v5.8.9

What's Changed

• fix(transfer): WSB Δv 单位混用——阈值与汇总按特征速度换算 km/s (#566) by @cislunarspace in #567
• feat(transfer): 补齐 transfer_design 收敛轨迹与 trajectory_times——统一会合系契约 (#568, ADR 0040) by @cislunarspace in #570
• chore(release): 发布 5.8.9 by @cislunarspace in #571

Full Changelog: v5.8.8...v5.8.9

v5.8.8

What's Changed

• fix(catalog): 索引连接解除线程绑定并以 RLock 串行化，修 mcp-serve 跨线程复用报错 (#559) by @cislunarspace in #562
• refactor(arch): 共享内核叶修复 #545 三处依赖方向违规并升级检查器执法（ADR 0039） by @cislunarspace in #563
• chore(make): check 对齐 ci.yml 命令集、新增 make docs，并移除 README 精度断言 (#547) by @cislunarspace in #564
• chore(release): 发布 5.8.8 by @cislunarspace in #565

Full Changelog: v5.8.7...v5.8.8