语义化版本

npm 生态用 SemVer（MAJOR.MINOR.PATCH）沟通 兼容性预期。发 CLI 或库之前，必须理解 何时升 major——否则下游 nestjs-essentials 项目、npm install 可能无声破坏。

学习目标

1.4.2
│ │ └── PATCH：向后兼容 bug 修复
│ └──── MINOR：向后兼容新功能
└────── MAJOR：不兼容的 API 变更

0.y.z 阶段常视为「不稳定」：minor 也可能 breaking——团队内部包要文档写明。

与 node-modules 的 package-lock.json 配合：lock 保证 CI 可复现，semver 范围表达 升级策略。

升 MAJOR 当：

升 MINOR：新增可选 API、新命令 flag（旧用法仍有效）。

升 PATCH：文档、内部 refactor、bug 修复。

{
  "engines": { "node": ">=20" },
  "peerDependencies": { "typescript": ">=5" }
}

Nest 插件常声明 peerDependencies 对齐 @nestjs/common 版本——见 nest-setup 生成的 package.json。