跳到主要内容

边界与非目标

正在判断 Nudo 是否是你的正确工具时,先读本页。 本页汇总 Nudo 不宣称什么、推导在何处有意退化为 unknown 或 any,以及哪些场景该用另一道门禁。

边界是产品纪律,不是 bug。本页是面向用户的边界摘编——完整工程笔记在 monorepo(docs/design/limitations.md)。替代维度对照:Nudo vs TypeScript。

非目标​

  1. 不是 TypeScript 编译器。 Nudo 不重实现 tsc 的工程引用、声明合并或完整可赋值性。
  2. 不从 body-AST 发明槽位。 义务来自显式契约(*.nudo.js / @nudo:contract)或调用点事实 —— 绝不通过扫描函数体「必填字段」产生 check 错误。
    • nudo:missing-slot 是观察,不是义务。 打开 analysis.evalMissingSlot: "warning"(默认 "off")时,求值实际命中已知 shape 缺字段只发 warning —— 绝不凭空产生 check 错误;契约仍经 nudo:constraint-violated 门禁。
  3. @nudo:case 仅调试。 它喂 nudo test / LSP 场景,不是契约产品。
  4. check 只校验。 产物(.d.ts、Zod、guards)来自 nudo export —— Abs 的单向有损投影。
  5. HOF promote ≠ check 错误。 HOF 关系的 body 用法提升是 warning(建议)。只有显式 refine / relation 契约才是 L1 错误。
  6. 没有观察动词。 签名与用例从 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
  • 草稿绝不自动绑定为契约
  • 投影绝不回读进分析

下一步​