契约就是 JS —— Day 1 与侧车 *.nudo.js
· 阅读需 2 分钟
发布系列(2/5)—— 2026-09-21 同日成套发布。建议按序阅读: Day 0 —— 不改写就观察 JavaScript · *契约就是 JS —— Day 1 与侧车 .nudo.js · Nudo vs TypeScript —— 何时该选 JS-first 门禁 · 面向 coding agent 的 Nudo —— agents.md、agent 集成与稳定诊断码 · 22 个文件被涂抹——调用点归因如何险些把假精度当成真发布
Nudo 的契约产品不是第二套类型语言。契约是普通 JavaScript 模块:自动绑定同名导出的侧车 *.nudo.js,或源码内 @nudo:contract。
// pricing.nudo.js
import { number, fn } from "@nudojs/core";
export const lineTotal = fn(
{ price: number().gt(0), qty: number().ge(1) },
number().gt(0)
);
npx nudojs check pricing.js
issues
[ERROR L5 lineTotal] lineTotal[price]: argument ⊭ precondition (nudo:constraint-violated)
actual: 0 #exact
expected: price > 0
产品规则
| 规则 | 含义 |
|---|---|
| 契约面 | *.nudo.js / @nudo:contract(@nudo:contract 是别名) |
@nudo:case | 仅调试见证——绝不是契约产品 |
| 草稿 | nudo contract --draft 可审查;从不自动绑定 |
| check vs export | check 校验 Abs;export 有损投影 dts/zod/guards |
| any vs unknown | 入口 any = 无约束;unknown = 推导失败 |
逻辑先行的团队从调用点起草;契约先行的团队先写侧车。两者在同一 Abs 面上汇合。
