Skip to content

docs(plan): module-system migration plan (Stage A–I)#2

Closed
Tanya7z wants to merge 1 commit into
mainfrom
cursor/scripts-migration-planning-f806
Closed

docs(plan): module-system migration plan (Stage A–I)#2
Tanya7z wants to merge 1 commit into
mainfrom
cursor/scripts-migration-planning-f806

Conversation

@Tanya7z

@Tanya7z Tanya7z commented Jul 21, 2026

Copy link
Copy Markdown
Member

背景

任务要求阅读仓库根目录的 HANDOFF.md 作为上下文,但该文件在当前分支、其他分支(mainorigin/refactor/module-system)以及 git 历史中均不存在。本 PR 通过现有真相源(docs/plan/module-architecture.md、代码内 Stage 标记、catalog.json/module-lock.json/@sfmc-sdk/db-server/src 的实际结构)重建了迁移上下文,并产出一份规划文档,无任何代码改动

内容

新增 docs/plan/module-system-migration.md

  • 现状盘点:单包 @sfmc/sdk(而非旧文的 4 个 shared/* 包)、集中式 db-server/src 分层。
  • 阶段进度矩阵:据代码标记重建 Stage A+B(完成)/ C(进行中)/ D–G / F / I(未开始)。
  • 技术债与漂移清单module-lock.json 孤儿条目(service-panelfeature-money)、package.jsoncheck-catalog/tools 绝对路径 bug、*-gui 子包未进 catalog、manifest 三字段未被消费、CLAUDE.md 文档漂移等。
  • 剩余阶段迁移计划:Stage C 收尾 → D(gui 归位)→ E(libs/工具包)→ F(宿主 14 字段 SapiHostApis 适配层 + 去 stub)→ G(Node 侧模块化 + 单一 ModuleManager)→ I(清单驱动路由/迁移),每阶段附范围、触点、验收。
  • 一致性修复、统一验收标准、新验证命令、实施顺序与风险

说明

如后续补上 HANDOFF.md 且范围不一致,应以其为准并据此修订本文。

Open in Web Open in Cursor 

…e grounded)

Co-authored-by: Shiroha <Tanya7z@users.noreply.github.com>
@Tanya7z

Tanya7z commented Jul 21, 2026

Copy link
Copy Markdown
Member Author

Superseded: this plan was generated against a stale main (pre HANDOFF.md, pre-afk-migration). The actual current refactor is the v2 protocol lift described in HANDOFF.md §6. Closing; not merging.

@Tanya7z Tanya7z closed this Jul 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants