Skip to main content

5 posts tagged with "launch-series"

View All Tags

Nudo for coding agents — agents.md, agent integration, stable diagnostics

· 2 min read
Nudo Contributors
Nudo maintainers

Launch series (4/5) — published together on 2026-09-21. Read in order: Day 0 — observe JavaScript without rewriting it · Contracts are JS — Day 1 with sidecar *.nudo.js · Nudo vs TypeScript — when a JS-first gate is the right tool · Nudo for coding agents — agents.md, agent integration, stable diagnostics · The 22-file smear: how call-site attribution almost shipped fake precision

Nudo’s observation output is already structured. Agents need a stable product contract too.

Read Agents (human docs) and the machine entrypoint agents.md. Curated index: llms.txt.

Agent rules in one screen​

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)

The 22-file smear: how call-site attribution almost shipped fake precision

· 4 min read
Nudo Contributors
Nudo maintainers

Launch series (5/5) — published together on 2026-09-21. Read in order: Day 0 — observe JavaScript without rewriting it · Contracts are JS — Day 1 with sidecar *.nudo.js · Nudo vs TypeScript — when a JS-first gate is the right tool · Nudo for coding agents — agents.md, agent integration, stable diagnostics · The 22-file smear: how call-site attribution almost shipped fake precision

Call-site discovery (nudo test lib/ --from test/) harvests real argument shapes from usage sites and synthesizes call@L… cases from them. The promise is precision for free: no directives, no annotations, just the arguments your code is actually called with.

Precision for free has a dark side: precision that is attributed to the wrong function looks exactly like success. This is the story of the attribution gate — the bug that turned one test helper into 51 fake "precise" results across 22 files, and the three invariants that closed it.

Day 0 — observe JavaScript without rewriting it

· 2 min read
Nudo Contributors
Nudo maintainers

Launch series (1/5) — published together on 2026-09-21. Read in order: Day 0 — observe JavaScript without rewriting it · Contracts are JS — Day 1 with sidecar *.nudo.js · Nudo vs TypeScript — when a JS-first gate is the right tool · Nudo for coding agents — agents.md, agent integration, stable diagnostics · The 22-file smear: how call-site attribution almost shipped fake precision

Welcome back to JavaScript. Nudo does not ask you to rewrite a JS package in another language surface before you can see types or gate obligations.

Day 0 product face: nudo check prints signatures on success and failure. Call sites are evidence. Unconstrained entry params display as any — not unknown. Optional nudo test reports cases for debugging; it is not the CI gate.

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

Even without sidecar contracts, export functions carry the L2 runtime boundary: undigested may-throw on entry functions is an error (nudo:entry-may-throw), filterable while you migrate.

Try it in the Playground, or read the Quick Start.

Contracts are JS — Day 1 with sidecar *.nudo.js

· 2 min read
Nudo Contributors
Nudo maintainers

Launch series (2/5) — published together on 2026-09-21. Read in order: Day 0 — observe JavaScript without rewriting it · *Contracts are JS — Day 1 with sidecar .nudo.js · Nudo vs TypeScript — when a JS-first gate is the right tool · Nudo for coding agents — agents.md, agent integration, stable diagnostics · The 22-file smear: how call-site attribution almost shipped fake precision

Nudo’s contract product is not a second type language. Contracts are ordinary JavaScript modules: sidecar *.nudo.js files that auto-bind to same-name exports, or in-source @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] lineTotal: actual ⊭ expected (nudo:constraint-violated)
actual: 0 #exact
expected: price > 0

Nudo vs TypeScript — when a JS-first gate is the right tool

· 2 min read
Nudo Contributors
Nudo maintainers

Launch series (3/5) — published together on 2026-09-21. Read in order: Day 0 — observe JavaScript without rewriting it · Contracts are JS — Day 1 with sidecar *.nudo.js · Nudo vs TypeScript — when a JS-first gate is the right tool · Nudo for coding agents — agents.md, agent integration, stable diagnostics · The 22-file smear: how call-site attribution almost shipped fake precision

Honest positioning: Nudo is built to replace TypeScript as the day-to-day type gate for JavaScript-first codebases — not to reimplement the TypeScript compiler.

TypeScriptNudo
Primary surface.ts + annotationsPlain .js
ContractsType language*.nudo.js builders + @nudo:contract
InferenceFrom annotationsFrom executing code on Abs
CI gatetsc --noEmitnudo check
.d.tsThe modelA lossy projection of Abs