边界与非目标
正在判断 Nudo 是否是你的正确工具时,先读本页。 本页汇总 Nudo 不宣称什么、推导在何处有意退化为 unknown 或 any,以及哪些场景该用另一道门禁。
边界是产品纪律,不是 bug。本页是面向用户的边界摘编——完整工程笔记在 monorepo(docs/design/limitations.md)。替代维度对照:Nudo vs TypeScript。
非目标
- 不是 TypeScript 编译器。 Nudo 不重实现
tsc的工程引用、声明合并或完整可赋值性。 - 不从 body-AST 发明槽位。 义务来自显式契约(
*.nudo.js/@nudo:contract)或调用点事实 —— 绝不通过扫描函数体「必填字段」产生 check 错误。nudo:missing-slot是观察,不是义务。 打开analysis.evalMissingSlot: "warning"(默认"off")时,求值实际命中已知 shape 缺字段只发 warning —— 绝不凭空产生 check 错误;契约仍经nudo:constraint-violated门禁。
@nudo:case仅调试。 它喂nudo test/ LSP 场景,不是契约产品。check只校验。 产物(.d.ts、Zod、guards)来自nudo export—— Abs 的单向有损投影。- HOF promote ≠ check 错误。 HOF 关系的 body 用法提升是 warning(建议)。只有显式 refine / relation 契约才是 L1 错误。
- 没有观察动词。 签名与用例从
check/ IDE 打印;产品没有nudo infer动词。
any 与 unknown
无约束入口参数显示为 any;真 unknown 表示推导失败(引擎债)。完整契约(来源、运算、窄化):Abs — any vs unknown。
调用点发现上限
--from 挖掘使用证据。诚实边界:
| 类别 | 行为 |
|---|---|
| 运行时 / 原生回调 | 无调用记录 → entry@ 回退 |
| 测试从未触及的函数 | entry@(any 参数)—— 覆盖缺口,不是推导失败 |
| 嵌套函数 | 不从外层调用记录归因(正确性优先) |
| 双入口包 | browser/node 记录不跨文件。现已上信号 —— 分析/check 其一入口变体时发 nudo:dual-entry(info;单入口包零误报)。仍是天花板,只是不再静默 |
动态 require / 原生 | 字面量 / 常量折叠子集已解析;计算说明符诚实 unknown。Env 可为名称提供类型;副作用需要 mock |
求值器缺口(摘要)
部分构造仍会退化(形态诚实,不伪造精度):JSX → unknown;import.meta → { url: string };import() → 开放模块命名空间的 Promise;无法判定是加法还是拼接的混合 + → number | string。优先使用语言语义中已建模的替代。
Env harvest 覆盖率不是完备性承诺。
/// @nudo:env <name> 命名 env 会同时注入 check 与 test 路径。 命名 env(es / web / node)注入符号面,nudo check 与 nudo test 打印一致的签名。不碰 env API 的函数不受牵连。当 env 无法解析(例如 path 型 @nudo:env ./missing.ts)时,只有实际引用自由标识符(env 提供的全局名)的函数 fail-closed 为 unknown——纯函数保持精确。
Pred 蕴含(有界)
nudo check 的 L1 门禁是 Abs 上的 Pred 蕴含(actual ⊭ expected)。内建判定故意有界 —— 覆盖线性片段与等式类目标,不是全部算术:
| 片段 | 内建 |
|---|---|
线性形(+ / - / *const)、跨项区间合成 | 是 |
等式类(x = y)、ne 收紧为严格界 | 是 |
| 合取目标;and/or 交换律相等 | 是 |
非线性(x * y、幂)/ 量词 | 故意不完整 —— fail-closed |
内建证不出时,目标直接不抬升。嵌入方可选外接:
import { setImplicationOracle, getImplicationOracle } from "@nudojs/core";
// ImplicationOracle = (phi, pred) => boolean | undefined
// true → 抬升目标;false / undefined → 保持 fail-closed
setImplicationOracle((phi, pred) => mySolverImplies(phi, pred));
- 默认关闭。 Nudo 不带 solver 依赖;内建片段才是产品门禁。仅当内建证不出时才调 oracle,且只有返回
true才抬升。 - Power feature,不是对外产品面。 对外 Nudo 是一道 JS 工程门禁 —— 不是定理证明器 / SMT 产品。没有证明证书,没有「已验证」宣称。
- 两边都 fail-closed。 没有 oracle(或返回
false/undefined)时,证不出的目标就保持未证。
这道门禁所在的代数:Abs。为什么这不是 prover:竞争格局。
与 TypeScript 类型语言的分界
Nudo 替代的是 tsc 检查门禁,不重实现 TypeScript 的类型语言:
- 条件 / 映射 / 模板字面量类型作为编程手段,均为非目标
- declaration merging 与 project references 不是产品 IR
- 门禁是 Abs 上的 Pred 蕴含(及部分
leqAbs),不是与tsc逐位同语义 - 不承诺健全性
若产品本身就是类型语言(类型体操库、DefinitelyTyped 式声明表面),该工作使用 TypeScript。对常规包,门禁终点仍是 nudo check + nudo migrate retire——仓库里今天是 .ts 不是保留 tsc 的理由(标注可剥离;migrate 为单向门)。
对照:Nudo vs TypeScript。迁移期共存:指南。
什么是有纪律的产品行为(不要当 bug「修掉」)
- 成功时
check仍打印signatures(不静默) - L2 只门禁入口/导出 may-throw,不管每个内部 helper
- 草稿绝不自动绑定为契约
- 投影绝不回读进分析