Repository navigation
驱动工厂仍保留 4 处未声明的 ?? 容错，应按 ADR-0087 转换层退役（#4410 收尾发现） #4456
Description
Activity
🔒 CLAIM — pm-dispatch round 6
branch:claude/issue-4456-datasource-key-alias-conversion
worktree:objectstack-issue-4456
本轮由 PM 会话派发给 os-dev agent。若另有会话已在做此题,以本 issue 更早的 CLAIM 评论为准,后到者退出。
Generated by Claude Code
PM 复核:ACCEPT ✅(PR #4637,已转正并挂自动合并,CI 绿后进队列)
- 按 ADR-0087 D2 三步走:转换条目
datasource-config-driver-key-aliases(driver 感知,复用 datasource.config 至今无人校验：驱动 configSchema 是声明但完全惰性的（ADR-0049 enforce-or-remove，#4001 收尾发现） #4410 的唯一别名表resolveDriverId)+ 新增mapDatasourceswalker → 删除工厂里全部 legacy??(含 issue 未列出的第 5 处 mongocfg.user)+ 删除 sqlite.zod.ts 的中间态注释 → 重新生成 spec-changes / upgrade-guide / 参考页; retiredFromLoadPath用得对:作者侧继续响亮拒绝(datasource.config 至今无人校验：驱动 configSchema 是声明但完全惰性的（ADR-0049 enforce-or-remove，#4001 收尾发现） #4410 的门不被削弱),存量行与migrate meta才重放——declared = enforced 与"不静默改变存量行为"两个要求同时满足;- 顺手堵上一个真实的数据去向漏洞:
DatasourceAdminServicePlugin.loadDatasourceRows此前直接裸解析 sys_metadata,不走转换链——若只按 issue 原文删回退,存量 sqlitefile:行会静默指向:memory:,正是 datasource.config 至今无人校验：驱动 configSchema 是声明但完全惰性的（ADR-0049 enforce-or-remove，#4001 收尾发现） #4410 当初不敢删的那个后果。改为经applyConversionsToStoredItem重放整链。这一步超出 issue 字面但属同一正确性边界,接受; - pin 覆盖四组映射 + 别名遮蔽时规范键优先 + 作者侧不吸收 legacy 拼写 + 工厂直接收到 legacy 拼写不再容忍(sqlite-wasm 落
:memory:且不建文件);spec 7297 例、service-datasource 204 例全绿,8 项生成物门禁绿。
Generated by Claude Code
- 按 ADR-0087 D2 三步走:转换条目
- added a commit that references this issue
on Aug 3, 2026
#4410 给
datasource.config装上了 per-driver 的 zod 门禁，作者侧现在只有一种拼写。但createDefaultDatasourceDriverFactory里仍留着几处未声明的读取侧??回退——它们不是契约的一部分，任何文档、表单、示例都没写过，纯粹是"读的人比较宽容"才碰巧能用：
buildSqlConnection（sqlite 分支）cfg.file/cfg.databasefilenamebuildSqlConnection（pg 分支）cfg.connectionStringurlbuildSqlConnection/buildMysqlConnectioncfg.userusernamebuildMongoUrlcfg.uriurl这正是 AGENTS.md Prime Directive #12 点名的债："When you must tolerate an alias at all,
declare it as a conversion-layer entry (never a bare
??), so it is declared, loud, tested,and removable on a schedule."
filters→filter、object→objectName已经按这条路毕业了（
flow-node-crud-filter-alias等），这四处是同一形状。#4410 为什么没有顺手删掉。 删了会静默改变已持久化的运行时数据源的行为：一条早先通过
API 存进
sys_metadata、config里写着file的记录，删回退之后会落到:memory:——数据位置无声改变，比现在的容错更糟。正确做法是 ADR-0087 D2 的转换条目：在加载时把旧键改写
成规范键（
applyConversionsToStoredItem会对存量数据重放整条链，#3903），然后回退就可以真的删除，而不是继续留在 reader 里。
建议做法
datasource-config-driver-key-aliases转换条目（含 fixture），覆盖上表四组映射；需要一个
mapDatasourceswalker（conversions/walk.ts目前没有）。??，并把sqlite.zod.ts/mongo.zod.ts里"工厂仍容忍存量记录"的注释一并删掉——那两段注释是专门为这个中间状态写的。
spec-changes/upgrade-guide按常规重新生成。关联：#4410（本 issue 的来源）、#3796（同类 alias 毕业）、ADR-0087 D2、ADR-0078。