跳到主要内容

5 篇博文 含有标签「launch-series」

查看所有标签

面向 coding agent 的 Nudo —— agents.md、agent 集成与稳定诊断码

· 阅读需 2 分钟
Nudo Contributors
Nudo maintainers

发布系列(4/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 的观察输出本来就是结构化的。Agent 还需要一份稳定的产品契约。

读 Agents(人类文档)与机器入口 agents.md。策展索引:llms.txt。

一屏 Agent 规则​

Primary gate: npx nudojs check <path>
Contracts: *.nudo.js / @nudo:contract
@nudo:case is debug-only — not the contract product
Entry params print as any; unknown = inference failed
check validates; export projects (lossy)

22 个文件被涂抹——调用点归因如何险些把假精度当成真发布

· 阅读需 4 分钟
Nudo Contributors
Nudo maintainers

发布系列(5/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 test lib/ --from test/)从使用处采集真实实参形态并合成 call@L… case。承诺是零成本精度:不要指令、不要标注,只要你的代码实际被调用时的实参。

零成本精度有黑暗面:归因到错误函数的精度看起来和成功一模一样。这是归因门的故事——一个 bug 让一个测试 helper 在 22 个文件里制造出 51 条假的「精确」结果,以及关住它的三条不变量。

Day 0 —— 不改写就观察 JavaScript

· 阅读需 2 分钟
Nudo Contributors
Nudo maintainers

发布系列(1/5)—— 2026-09-21 同日成套发布。建议按序阅读: Day 0 —— 不改写就观察 JavaScript · 契约就是 JS —— Day 1 与侧车 *.nudo.js · Nudo vs TypeScript —— 何时该选 JS-first 门禁 · 面向 coding agent 的 Nudo —— agents.md、agent 集成与稳定诊断码 · 22 个文件被涂抹——调用点归因如何险些把假精度当成真发布

欢迎回到 JavaScript。Nudo 不要求你在看到类型、门禁义务之前,先把 JS 包改写成另一种语言表面。

Day 0 产品面: nudo check 成功与失败都会打印 signatures。调用点就是证据。无约束入口参数显示为 any——不是 unknown。可选的 nudo test 报告调试用例;它不是 CI 门禁。

npx nudojs check src/
signatures
subtract(a: any, b: any) => number

即使没有侧车契约,导出函数也携带 L2 运行时边界:入口函数未消化的 may-throw 是 error(nudo:entry-may-throw),迁移期间可过滤。

在 Playground 里试,或读 Quick Start。

契约就是 JS —— Day 1 与侧车 *.nudo.js

· 阅读需 2 分钟
Nudo Contributors
Nudo maintainers

发布系列(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 vs TypeScript —— 何时该选 JS-first 门禁

· 阅读需 2 分钟
Nudo Contributors
Nudo maintainers

发布系列(3/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-first 代码库里取代 TypeScript 作为日常类型门禁——而不是重写 TypeScript 编译器。

TypeScriptNudo
主要表面.ts + 标注纯 .js
契约类型语言*.nudo.js 构造器 + @nudo:contract
推断来自标注来自执行代码于 Abs 之上
CI 门禁tsc --noEmitnudo check
.d.ts模型本身Abs 的有损投影