[xrfc]

修订范围（2026-10-29）

基于已合并 #7 的 main 8fa0dc3，保留2026-10-10设计与模块边界为明确标记的历史资料。

• 仅3份历史文档及docs/README历史导航；不修改源码、不回退现行路线图、状态、模型或数据文档。
• 原唯一入口声明已撤销，当前入口仍为roadmap、data-prep-progress、model-foundation，结构以modular-maintenance为准。
• 294个相对链接目标在候选Git树中检查通过；外部链接和其余锚点未逐一验证。
• 保留旧PR历史并合入main作为父提交；未force-push、未切换或覆盖共享工作区。
• 精确提交：4cf23f94c82010cc09647040c7d39fb684a17850。CI以该提交的checks为准。

原始PR说明（历史范围，不代表修订后的差异）

Summary

• Establish the 7.41f lineup-to-item recommendation mainline (M01–M07), without facets; separate it from replay/training and personal learning tracks.
• Document current coupling, target dependency direction, contract boundaries, extension points, incremental refactoring and acceptance criteria. New modules remain explicitly proposed, not implemented.
• Inventory all 159 existing Markdown files plus three new documents; reconcile navigation, status, roadmap, knowledge scope and learning instructions. Preserve generated hero profiles, frozen sources and historical evidence.
• Correct stale implementation descriptions: Gem pin/adapter version, six schemas, persisted exclusions, rejected negative observation times, existing sample contracts and old branch checkout instructions.

Verification

• 122 engineering, 10 learning, 12 knowledge and 6 JavaScript tests passed; Ruff check and formatting passed.
• Learning page regenerated; M stages are intentionally documented as not yet displayed by the legacy learning UI.
• All 162 Markdown files checked for local relative targets; no missing paths. New mainline anchor checked; other anchors/external URLs not exhaustively checked.
• Synthetic demo and doctor passed (6 matches, 4/1/1 split).
• Markdown-only diff; no source/config/schema/frozen JSON changes, no replay collection/reparse, no training or semantic admission.

Delivery boundary

Based on main c6a5e1f. No package release or automatic merge requested. Existing real-data held status remains unchanged.

[xrfc]

审查提交：f4feae798d7d660755c37f1f192dbaf652f4e5a3。结论：当前集成交付暂不通过，需先解决与 #7 的文档版本关系。

[P2] docs/development-mainline.md:3：这份2026-10-10文档将自身声明为开发顺序和产品范围的唯一入口，并称新推荐接口与模块尚未实现；docs/project-status.md、README及roadmap也将当时状态作为当前方向。待集成 #7 的 docs/project-status.md 已明确2026-10-22起改为 roadmap/data-prep-progress/model-foundation 三份主入口，且包含已实现的 recommendation、modeling 和阵容原型。两份不能原样一起发布为当前权威说明。

建议：将旧方案明确标为历史/已替代，或仅迁入仍有效的架构说明和文档纠错，并让导航与实际最终代码一致；不要为消除冲突把近期状态回退为尚未实现。

该 PR 仅改Markdown；已核验 PR CI run 38065310259 对应上述 head 且 success。此处是文档集成与当前事实一致性问题，不是CI失败，也不是断言该文档在2026-10-10时错误。保留PR开放，不自动关闭、修改分支或合并。

[xrfc]

修订后审查通过：精确head 4cf23f9。相对已合并#7的main只新增3份明确标记的历史设计并补充docs/README导航；不再回退当前源码、任务状态和入口。294个相对链接目标检查通过，无源码变更；对应push与PR的6项CI全部SUCCESS（PR run 40747829939）。原先的文档集成阻塞已解决，按用户授权合并。