依赖发布边界治理
当前根包采用精确版本依赖策略:
schema-dsl@2.0.8与工作区 sibling../schema-dsl当前版本一致;npm 上存在看似更高的2.3.x,但已标记为误发布 / deprecated,不得跟随升级。
当前风险
- 上游版本漂移:
cache-hub/schema-dsl已固定为精确版本,升级必须走显式版本调整。 - 误发布版本风险:
schema-dsl的 npm2.3.x已标记为误发布,不得跟随升级。 - 联动回归盲区:升级任意上游依赖后,必须重新覆盖关键回归面。
当前治理规则
开发态
- 根包 direct
cache-hub固定为2.2.4;schema-dsl@2.0.8的传递cache-hub暂不 override,后续随schema-dsl升级再联动。 schema-dsl固定为2.0.8。- 本地 sibling
../schema-dsl仅用于上游库自身调试,不再作为 monSQLize 根包安装前提。
发布态
- 根包发布态不得依赖工作区
file:/workspace:路径。 - 当前依赖策略已满足“外部安装可解析”的基本前提;后续发布仍需通过标准验证链。
schema-dsl 2.x 升级闭环
依赖治理基线已将 schema-dsl 从历史 ^1.2.5 升级并固定到 2.0.8,闭环标准如下:
- 上游在 npm 发布了非 deprecated 的 2.x latest 版本:
2.0.8。 npm install schema-dsl@2.0.8 --save-exact后通过npm run type-check。- model 相关单测 / 集成测试全通过(随
npm run test:unit与npm run test:integration覆盖)。 npm run test:examples全通过。- 发布前仍需以
npm run release:preflight作为最终门禁。 - 本文件、Profile、CHANGELOG 与 lockfile 必须同步到
2.0.8。
cache-hub 2.2.4 升级闭环
依赖治理基线已将 cache-hub 从 1.0.0 升级并固定到 2.2.4,闭环标准如下:
- 上游 npm
latest为2.2.4,Node.js 引擎要求仍为>=18,与 monSQLize 当前基线一致。 - 根包 direct dependency 解析到
2.2.4;schema-dsltransitive dependency 暂保持schema-dsl@2.0.8自身声明的版本。 npm run type-check、缓存 / function-cache 定向测试、文档站构建与内存探针必须通过。- 本文件、Profile、CHANGELOG、package manifest 与 lockfile 必须同步 root direct dependency 的
2.2.4口径。
联动验证建议
长期方向
schema-dsl后续不自动跟随 npmlatest;升级必须显式确认目标版本,并继续排除 deprecated 误发布版本。- 发布态持续保持对工作区路径零依赖;所有上游依赖都必须可由公开 semver 解析。