修至绿灯的 agent tokens(OSS 历史 bug 切片) 出处
超越声明式类型
TypeScript 会加宽掉的值
Nudo 在 Abs 上求值,结果跟随真实计算——字面量字符串、split、循环求和——不是声明的上界。
"0x" + idstring`0x${string}`"hello".slice(1, 3)string"el""a,b,c".split(",")string[]["a", "b", "c"]for (let i = 0; i < 5; i++) sum += inumber10模板字符串 `SAVE-${code.toUpperCase()}` 不是普通 string——当调用点是 coupon("vip") 时,Nudo 观察到 "SAVE-VIP"。
真实代码上的效果
调用点变成签名
观察层的 check 把无约束参数打印为 any。把 Nudo 指向真实用法——测试、调用点——解释器会从证据综合出精确签名。不改库、不补类型标注。
调用点发现会返回什么
coupon来自 cart.js 调用点无调用点证据 → any("vip") => "SAVE-VIP"deepEqual来自 @hapi/hoek 用法无调用点证据 → any({a:1,b:{c:2}}, {a:1,b:{c:2}}) => booleanflatten来自递归 + 循环用法无调用点证据 → any([1,[2,[3,4]]]) => [1,2,3,4]产品路径
观察层 → 契约层 → 离开 tsc
观察层:nudo check 打印签名并诊断入口可能抛错。契约层:侧车契约把调用点事实变成 L1 义务。生态:export 从 Abs 投影产物。出口:migrate retire —— 共存不是终态。
- 观察层观察 + 门禁
npx nudojs check src/ - 契约层加上契约
lib.nudo.js · @nudo:contract · nudo check - 生态投影产物
npx nudojs export src/ --format dts|schema - 出口退役 tsc
npx nudojs migrate status|strip|verify|retire
先写逻辑,再生成契约
调用点是证据。contract --draft 可生成可审阅的契约草稿,确认后写入 *.nudo.js。草稿不会自动成为校验义务。
npx nudojs contract --draft lib.js --from test/先写契约,再辅助/约束逻辑
先写 *.nudo.js 或 @nudo:contract,用同一契约面辅助实现,并在 check 中约束逻辑。
npx nudojs check src/校验与产物
流程以 Abs 契约为核心。check 只做校验;export 从 Abs 投影 .d.ts / Zod / Standard Schema / guards;IDE 与 Agent 直读 Abs。
nudo check
只校验 / CI。不生成产物。
export · dts
投影给 TypeScript 消费方的 .d.ts。有损。
export · Zod / guards
由 Abs 得到的运行时校验。不能替代 check。
export · Standard Schema
Standard Schema 运行时校验器,可接入下游工具链。
IDE / LSP
hover / inlay 直读 Abs。
Agent / MCP
编码 agent 经 LSP / MCP 读同一套 Abs —— 见下方 AI Agents 专区。
按身份进入
选择你的入口路径
文档按读者身份组织。选择与你情况匹配的路径——每张卡都落在可直接运行的第一步上。
在真实 JS 上做类型 / CI 门禁
先建立心智模型,再在自有文件上跑 check——门禁绿灯时也会打印签名。
快速开始TypeScript 用户看清差异,然后离开 tsc
诚实对比、迁移路径,以及单向 retire 门——共存不是终态。
Nudo vs TypeScript既有 JS 包从真实用法生成契约
把 Nudo 指向测试与调用点。从证据草拟契约,只接受你真正想要的义务。
逻辑优先指南CI / 平台稳定门禁与诊断
CI 里的 nudo check 配方、机器可读报告,以及诊断码表。
RecipesAI 编码 Agent经 LSP / MCP 读同一套 Abs
Agent 跑 nudo check、尊重侧车契约、解析稳定诊断码。
Agent 文档AI Agents
帮 agent 门禁契约,而不是发明类型
编码 agent 与编辑器经 LSP / MCP 读同一套 Abs 面。它们跑 `nudo check`、尊重侧车契约、解析稳定诊断码 —— 不是第二套类型语言。
与 IDE 同一套 Abs
Hover / inlay 与 agent 工具直接消费 Abs。`export` 投影有损;Abs 仍是唯一真源。
npx nudojs check src/ --jsonLSP + MCP 表面
`@nudojs/lsp` 提供 agent `executeCommand` 工具。可为 Cursor、Claude Code 等客户端接 MCP,无需另立协议。
@nudojs/lsp · nudo.contract · nudo.whatIf稳定的产品规则
Agent 不得从 body AST 发明义务,也不得把 `@nudo:case` 当契约。入口 `any` ≠ `unknown`。观察层是 `check`;契约层是 `contract` + `check`。
actual ⊭ expected · nudo:constraint-violatedAgent 入口
发布 `agents.md` 与 `llms.txt`,让 coding agent 无需猜产品名词即可接入。把 setup 块粘进 agent 即可。
nudojs.github.io/nudo/agents.mdRead https://nudojs.github.io/nudo/docs/reference/agents
Primary gate: npx nudojs check <path>
Contracts are *.nudo.js / @nudo:contract
Do not invent body-AST obligations. @nudo:case is debug-only.
Entry params print as any; unknown = inference failed.准备重回 JS 了吗?
在浏览器里观察中间量,用 CLI 在自有文件上门禁契约,或把 coding agent 指向同一套 Abs 面。你的 JS 仍是 JS。
npx nudojs check ./pricing.js