依赖发布边界治理

当前根包采用精确版本依赖策略

依赖策略原因
cache-hub精确版本 2.2.4上游 npm latest 已发布稳定版本并通过兼容验证;根包 direct dependency 固定到 2.2.4,schema-dsl 的传递依赖暂由 schema-dsl 自身版本声明管理
schema-dsl精确版本 2.0.8npm latest 指向 2.0.8,且该版本是当前 TypeScript 正式线;monSQLize 仅依赖 dsl / validate 能力,并以 2.0.8 执行 type-check、model 测试、integration 与 examples 验证

schema-dsl@2.0.8 与工作区 sibling ../schema-dsl 当前版本一致;npm 上存在看似更高的 2.3.x,但已标记为误发布 / deprecated,不得跟随升级。

当前风险

  1. 上游版本漂移cache-hub / schema-dsl 已固定为精确版本,升级必须走显式版本调整。
  2. 误发布版本风险schema-dsl 的 npm 2.3.x 已标记为误发布,不得跟随升级。
  3. 联动回归盲区:升级任意上游依赖后,必须重新覆盖关键回归面。

当前治理规则

开发态

  • 根包 direct cache-hub 固定为 2.2.4schema-dsl@2.0.8 的传递 cache-hub 暂不 override,后续随 schema-dsl 升级再联动。
  • schema-dsl 固定为 2.0.8
  • 本地 sibling ../schema-dsl 仅用于上游库自身调试,不再作为 monSQLize 根包安装前提。

发布态

  • 根包发布态不得依赖工作区 file: / workspace: 路径。
  • 当前依赖策略已满足“外部安装可解析”的基本前提;后续发布仍需通过标准验证链。
npm run release:preflight

schema-dsl 2.x 升级闭环

依赖治理基线已将 schema-dsl 从历史 ^1.2.5 升级并固定到 2.0.8,闭环标准如下:

  1. 上游在 npm 发布了非 deprecated 的 2.x latest 版本:2.0.8
  2. npm install schema-dsl@2.0.8 --save-exact 后通过 npm run type-check
  3. model 相关单测 / 集成测试全通过(随 npm run test:unitnpm run test:integration 覆盖)。
  4. npm run test:examples 全通过。
  5. 发布前仍需以 npm run release:preflight 作为最终门禁。
  6. 本文件、Profile、CHANGELOG 与 lockfile 必须同步到 2.0.8

cache-hub 2.2.4 升级闭环

依赖治理基线已将 cache-hub1.0.0 升级并固定到 2.2.4,闭环标准如下:

  1. 上游 npm latest2.2.4,Node.js 引擎要求仍为 >=18,与 monSQLize 当前基线一致。
  2. 根包 direct dependency 解析到 2.2.4schema-dsl transitive dependency 暂保持 schema-dsl@2.0.8 自身声明的版本。
  3. npm run type-check、缓存 / function-cache 定向测试、文档站构建与内存探针必须通过。
  4. 本文件、Profile、CHANGELOG、package manifest 与 lockfile 必须同步 root direct dependency 的 2.2.4 口径。

联动验证建议

场景必做验证
调整 cache-hub 相关能力npm run type-check + test/unit/cache/cache.test.ts + exports / smoke
调整 schema-dsl 相关能力npm run type-check + model 相关单测 / 集成测试 + npm run test:examples
准备发版npm run release:preflight

长期方向

  1. schema-dsl 后续不自动跟随 npm latest;升级必须显式确认目标版本,并继续排除 deprecated 误发布版本。
  2. 发布态持续保持对工作区路径零依赖;所有上游依赖都必须可由公开 semver 解析。