<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
    <channel>
        <title>Nudo Blog</title>
        <link>https://nudojs.github.io/nudo/blog</link>
        <description>Nudo Blog</description>
        <lastBuildDate>Mon, 28 Sep 2026 00:00:00 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>https://github.com/jpmonette/feed</generator>
        <language>en</language>
        <item>
            <title><![CDATA[We retired tsc on our JavaScript packages — and the gate got sharper]]></title>
            <link>https://nudojs.github.io/nudo/blog/retiring-typescript-in-practice</link>
            <guid>https://nudojs.github.io/nudo/blog/retiring-typescript-in-practice</guid>
            <pubDate>Mon, 28 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[The tsc --noEmit line on your JavaScript packages can retire. Start with zero annotations, add contracts only where you accept them, read violations as value ⊭ predicate + a next step — and exit through migrate retire, not by dual-running two compilers forever.]]></description>
            <content:encoded><![CDATA[<blockquote>
<p>The <code>tsc --noEmit</code> line on your JavaScript packages can retire. Start with zero annotations, add contracts only where you accept them, read violations as <strong>value ⊭ predicate + a next step</strong> — and exit through <code>migrate retire</code>, not by dual-running two compilers forever.</p>
</blockquote>
<p>Most teams keep <code>tsc --noEmit</code> around not because they enjoy writing annotations, but because there was no other CI gate to reach for. Nudo's answer is not "write a second type language". It is three commitments:</p>
<ol>
<li class=""><strong>JS stays JS</strong> — no runtime changes, no invented second IR.</li>
<li class=""><strong>Contracts on demand</strong> — <code>*.nudo.js</code> / <code>@nudo:contract</code>; obligations only come from declarations you accept.</li>
<li class=""><strong>A one-way door</strong> — <code>nudo migrate status → strip → verify → retire</code>. The exit is <strong>retire tsc</strong>, not dual-run.</li>
</ol>
<p>We pinned this story with three runnable samples, not slides: a public checkout-demo, and two real npm consumers.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="why-we-dared-to-drop-the-old-gate">Why we dared to drop the old gate<a href="https://nudojs.github.io/nudo/blog/retiring-typescript-in-practice#why-we-dared-to-drop-the-old-gate" class="hash-link" aria-label="Direct link to Why we dared to drop the old gate" title="Direct link to Why we dared to drop the old gate" translate="no">​</a></h2>
<p><code>nudo check</code> is a Pred-implication gate over Abs (shape × term × pred × conf) — types are computable values, so <code>x&gt;0</code> implies <code>x+1&gt;1</code> instead of degrading to <code>number</code>. The gate is held to gold standards, not vibes: recall = precision = 1.0 on the check suites, plus real-package zero-false-positive tests. That is what lets <code>nudo check</code> be <em>the</em> gate rather than an advisory layer.</p>
<p>The evidence trail is committed and re-runnable (<code>pnpm run verify:examples</code>):</p>
<table><thead><tr><th>Case</th><th>Dependency</th><th>End state</th></tr></thead><tbody><tr><td>checkout-demo</td><td>synthetic small lib</td><td><code>nudo check</code> as the only gate</td></tr><tr><td><strong>ms</strong> (vercel/ms)</td><td>real npm</td><td>dependency untouched; consumer is plain JS + Nudo</td></tr><tr><td><strong>debug</strong> (visionmedia/debug)</td><td>real npm</td><td>same; native returns honestly stay <code>unknown</code></td></tr></tbody></table>
<p><code>ms</code> and <code>debug</code> are real packages, not synthetic fixtures — the consumers moved, the dependencies did not.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="the-four-step-door">The four-step door<a href="https://nudojs.github.io/nudo/blog/retiring-typescript-in-practice#the-four-step-door" class="hash-link" aria-label="Direct link to The four-step door" title="Direct link to The four-step door" translate="no">​</a></h2>
<div class="language-text codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-text codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">audit (migrate status) → strip → verify (nudo check) → retire (drop tsc)</span><br></div></code></pre></div></div>
<p>Copy-ready, with paths swapped for your package:</p>
<div class="language-bash codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-bash codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic"># 0. audit — what still carries tsc</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs migrate status ./my-pkg</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic"># 1. strip — .ts → .js (annotations out, runtime stays). --write to emit.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs migrate strip ./my-pkg/src </span><span class="token parameter variable" style="color:#36acaa">--write</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic"># 2. optional — reverse old annotations into a reviewable contract draft</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs contract --from-dts ./my-pkg/src/index.ts</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">#    → @nudo:draft (NOT enforced until you copy it into *.nudo.js)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic"># 3. verify — nudo check must pass on the stripped JS</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs migrate verify ./my-pkg/src</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic"># 4. retire — drop typescript, rewrite tsc scripts / GHA lines, write marker</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs migrate retire ./my-pkg --dry-run   </span><span class="token comment" style="color:#999988;font-style:italic"># then drop --dry-run</span><br></div></code></pre></div></div>
<table><thead><tr><th>Step</th><th>Effect</th><th>Exit when</th></tr></thead><tbody><tr><td><code>status</code></td><td>Counts <code>.ts</code>, finds <code>tsc</code> scripts + <code>typescript</code> dep, lists <strong>blockers</strong></td><td>You know the surface area</td></tr><tr><td><code>strip</code></td><td><code>.ts</code> → <code>.js</code>; optional best-effort sidecar draft</td><td>Sources are plain JS</td></tr><tr><td><code>verify</code></td><td>Runs <code>nudo check</code> on the stripped JS (optional <code>--with-tsc</code> dual-run <strong>during</strong> the move only)</td><td>Gate is green</td></tr><tr><td><code>retire</code></td><td>Drops <code>typescript</code>, rewrites <code>tsc</code> scripts → <code>nudo check</code>, rewrites <code>.github/workflows</code>, writes <code>.nudo/migrate-retired.json</code></td><td><strong>tsc is gone</strong></td></tr></tbody></table>
<p>Two details do the heavy lifting for trust. The <code>--from-dts</code> draft is <strong>never silent</strong>: old annotations become obligations only after you review and copy them into a <code>*.nudo.js</code>. And dual-run exists solely as <code>migrate verify --with-tsc</code> mid-move — coexistence is a migration tactic, never the endgame.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="what-a-violation-reads-like">What a violation reads like<a href="https://nudojs.github.io/nudo/blog/retiring-typescript-in-practice#what-a-violation-reads-like" class="hash-link" aria-label="Direct link to What a violation reads like" title="Direct link to What a violation reads like" translate="no">​</a></h2>
<p>After the move, violations are values and predicates, not type names:</p>
<div class="language-text codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-text codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">actual:   0  #exact</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">expected: ms &gt; 0</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">→ use a value satisfying ms &gt; 0</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">fix:  nudo contract --draft</span><br></div></code></pre></div></div>
<p>Not "report more" — <strong>report truer, with evidence and a next step</strong>. The faces are documented in <a class="" href="https://nudojs.github.io/nudo/docs/guides/error-faces">Error faces</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="the-honest-limits">The honest limits<a href="https://nudojs.github.io/nudo/blog/retiring-typescript-in-practice#the-honest-limits" class="hash-link" aria-label="Direct link to The honest limits" title="Direct link to The honest limits" translate="no">​</a></h2>
<p>Every sample above is <strong>example-scale</strong> (2–3 modules each) from <code>docs/examples/</code> — timings and friction counts are example-scale, not a production migration audit. We do not publish production-size hour/day numbers, and a "7-day retire path" is a product target, not a measured median: budget a real package by the <code>.ts</code> file count that <code>migrate status</code> reports, not by a blog post.</p>
<p>Native or unharvested dependencies stay visible as engine debt: <code>ms()</code> and <code>debug()</code> returns show <code>unknown</code> / <code>conf=opaque</code> with a <code>nudo:unknown-inference</code> or <code>nudo:opaque-result</code> warning and a fix path (<code>@types/*</code> harvest, <code>@nudo:mock</code>, or <code>refine return</code>). Honest debt stays a warning until you pin it — it is never faked as success.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="the-workflow-after">The workflow after<a href="https://nudojs.github.io/nudo/blog/retiring-typescript-in-practice#the-workflow-after" class="hash-link" aria-label="Direct link to The workflow after" title="Direct link to The workflow after" translate="no">​</a></h2>
<p><code>nudo check</code> is the only gate, and signatures print <strong>even on success</strong> — unconstrained entry params display as <code>any</code>, true <code>unknown</code> means inference failed. Intentional <code>throw</code>s surface as L2 (<code>nudo:entry-may-throw</code>) with the exact next step (<code>@nudo:throws</code>, guard, or a softer <code>package.json</code> setting for week one). Tighten later and the faces become value + predicate.</p>
<p>The full command walkthrough, before/after code and diagnostics, and the friction table: <a class="" href="https://nudojs.github.io/nudo/docs/guides/case-study-retire">Case study: retire tsc</a>. The door itself is documented in <a class="" href="https://nudojs.github.io/nudo/docs/guides/migrating-from-typescript">Migrate from TypeScript</a>; if you are new to Nudo, start with the <a class="" href="https://nudojs.github.io/nudo/docs/getting-started/quick-start">Quick Start</a>.</p>]]></content:encoded>
            <category>engineering</category>
            <category>typescript</category>
            <category>migrate</category>
            <category>case-study</category>
        </item>
        <item>
            <title><![CDATA[Nudo for coding agents — agents.md, agent integration, stable diagnostics]]></title>
            <link>https://nudojs.github.io/nudo/blog/agents-docs</link>
            <guid>https://nudojs.github.io/nudo/blog/agents-docs</guid>
            <pubDate>Mon, 21 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Launch series (4/5) — published together on 2026-09-21. Read in order:]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><strong>Launch series</strong> (4/5) — published together on 2026-09-21. Read in order:
<a class="" href="https://nudojs.github.io/nudo/blog/day0-observe">Day 0 — observe JavaScript without rewriting it</a> · <a class="" href="https://nudojs.github.io/nudo/blog/day1-contracts">Contracts are JS — Day 1 with sidecar *.nudo.js</a> · <a class="" href="https://nudojs.github.io/nudo/blog/vs-typescript">Nudo vs TypeScript — when a JS-first gate is the right tool</a> · <strong>Nudo for coding agents — agents.md, agent integration, stable diagnostics</strong> · <a class="" href="https://nudojs.github.io/nudo/blog/attribution-gate">The 22-file smear: how call-site attribution almost shipped fake precision</a></p>
</blockquote>
<p>Nudo’s observation output is already structured. Agents need a stable product contract too.</p>
<p>Read <strong><a class="" href="https://nudojs.github.io/nudo/docs/reference/agents">Agents</a></strong> (human docs) and the machine entrypoint <strong><a href="https://nudojs.github.io/nudo/agents.md" target="_blank" rel="noopener noreferrer" class="">agents.md</a></strong>. Curated index: <strong><a href="https://nudojs.github.io/nudo/llms.txt" target="_blank" rel="noopener noreferrer" class="">llms.txt</a></strong>.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="agent-rules-in-one-screen">Agent rules in one screen<a href="https://nudojs.github.io/nudo/blog/agents-docs#agent-rules-in-one-screen" class="hash-link" aria-label="Direct link to Agent rules in one screen" title="Direct link to Agent rules in one screen" translate="no">​</a></h2>
<div class="language-text codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-text codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">Primary gate: npx nudojs check &lt;path&gt;</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Contracts: *.nudo.js / @nudo:contract</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">@nudo:case is debug-only — not the contract product</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Entry params print as any; unknown = inference failed</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">check validates; export projects (lossy)</span><br></div></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="tooling-surface">Tooling surface<a href="https://nudojs.github.io/nudo/blog/agents-docs#tooling-surface" class="hash-link" aria-label="Direct link to Tooling surface" title="Direct link to Tooling surface" translate="no">​</a></h2>
<ul>
<li class="">LSP: <code>@nudojs/lsp</code></li>
<li class="">Agent executeCommand / tools: <a class="" href="https://nudojs.github.io/nudo/docs/api/agent">API · agent</a></li>
<li class="">Agent integration: <a class="" href="https://nudojs.github.io/nudo/docs/guides/agent-integration">Agent integration guide</a></li>
<li class="">JSON face: <code>npx nudojs check file.js --json</code></li>
<li class="">Diagnostic IDs: <a class="" href="https://nudojs.github.io/nudo/docs/reference/diagnostics">glossary</a></li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="why-this-matters">Why this matters<a href="https://nudojs.github.io/nudo/blog/agents-docs#why-this-matters" class="hash-link" aria-label="Direct link to Why this matters" title="Direct link to Why this matters" translate="no">​</a></h2>
<p>2026 tooling docs are judged by whether a coding agent can <strong>set up and gate</strong> a project without guessing product nouns. Nudo publishes <code>agents.md</code> + <code>llms.txt</code> so “welcome back to JavaScript” is also machine-actionable.</p>]]></content:encoded>
            <category>ai</category>
            <category>mcp</category>
            <category>nudo</category>
            <category>agents</category>
            <category>launch-series</category>
        </item>
        <item>
            <title><![CDATA[The 22-file smear: how call-site attribution almost shipped fake precision]]></title>
            <link>https://nudojs.github.io/nudo/blog/attribution-gate</link>
            <guid>https://nudojs.github.io/nudo/blog/attribution-gate</guid>
            <pubDate>Mon, 21 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Launch series (5/5) — published together on 2026-09-21. Read in order:]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><strong>Launch series</strong> (5/5) — published together on 2026-09-21. Read in order:
<a class="" href="https://nudojs.github.io/nudo/blog/day0-observe">Day 0 — observe JavaScript without rewriting it</a> · <a class="" href="https://nudojs.github.io/nudo/blog/day1-contracts">Contracts are JS — Day 1 with sidecar *.nudo.js</a> · <a class="" href="https://nudojs.github.io/nudo/blog/vs-typescript">Nudo vs TypeScript — when a JS-first gate is the right tool</a> · <a class="" href="https://nudojs.github.io/nudo/blog/agents-docs">Nudo for coding agents — agents.md, agent integration, stable diagnostics</a> · <strong>The 22-file smear: how call-site attribution almost shipped fake precision</strong></p>
</blockquote>
<p>Call-site discovery (<code>nudo test lib/ --from test/</code>) harvests real argument shapes from usage sites and synthesizes <code>call@L…</code> cases from them. The promise is precision for free: no directives, no annotations, just the arguments your code is <em>actually</em> called with.</p>
<p>Precision for free has a dark side: precision that is <strong>attributed to the wrong function</strong> 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.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="the-symptom">The symptom<a href="https://nudojs.github.io/nudo/blog/attribution-gate#the-symptom" class="hash-link" aria-label="Direct link to The symptom" title="Direct link to The symptom" translate="no">​</a></h2>
<p>During the first trial run against real packages, coverage numbers jumped — <code>@hapi/hoek</code> went from 54.8% to 98.6% of functions with precise cases. Suspiciously good. Digging into the synthesized cases showed why: a helper defined inside a test file happened to share a name with functions in 22 library files. Its call record — one record — was matched against every file that declared a function with the same name. 22 files, 51 records, all fake: every one of those "precise" results was the helper's record wearing another function's name.</p>
<p>The trial numbers were real measurements of a lie.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="the-invariant-attribution-not-name-matching">The invariant: attribution, not name matching<a href="https://nudojs.github.io/nudo/blog/attribution-gate#the-invariant-attribution-not-name-matching" class="hash-link" aria-label="Direct link to The invariant: attribution, not name matching" title="Direct link to The invariant: attribution, not name matching" translate="no">​</a></h2>
<p>The fix is an <strong>attribution gate</strong>: a call record only participates in matching for a file if the module the record was resolved from actually points at that file — via the call's function module, or the bound export's target module. Name matching alone is an accident waiting for a same-named helper; the gate makes the <em>module identity</em> the source of truth.</p>
<p>Two more invariants close the remaining holes:</p>
<ul>
<li class=""><strong>Usage-site leak marking.</strong> Records captured while executing usage-site code are marked as such. They are trusted as <em>argument evidence</em> — the shapes callers pass are real — but the evaluator never mistakes a test-local evaluation environment for the library's own.</li>
<li class=""><strong><code>never</code> / <code>never</code> filtering.</strong> A record whose result type is <code>never</code> <em>and</em> whose throw type is <code>never</code> did not really return — evaluation was interrupted mid-call (an <code>await</code> inside a <code>new Promise(async ...)</code> executor). Those records are filtered out before injection instead of being treated as "returns never".</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="the-result-that-counts">The result that counts<a href="https://nudojs.github.io/nudo/blog/attribution-gate#the-result-that-counts" class="hash-link" aria-label="Direct link to The result that counts" title="Direct link to The result that counts" translate="no">​</a></h2>
<p>After the gate, the honest trial numbers were 98.6% coverage <strong>with 0 false attributions</strong> (down from 291 fake records) for <code>@hapi/hoek</code>, and 91.8% with 0 false records for <code>@discoveryjs/json-ext</code>. The headline number barely moved — but only the zero column makes it mean anything.</p>
<p>Precision claims without an attribution story are marketing. Every number Nudo publishes about call-site discovery is gated by these three invariants; the full design (safety boundaries, merge policy, <code>--from</code> ceilings) lives in the <a class="" href="https://nudojs.github.io/nudo/docs/guides/callsite-discovery">call-site discovery guide</a> and the honest boundaries in <a class="" href="https://nudojs.github.io/nudo/docs/concepts/limits">Limits</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="why-this-matters-for-the-product">Why this matters for the product<a href="https://nudojs.github.io/nudo/blog/attribution-gate#why-this-matters-for-the-product" class="hash-link" aria-label="Direct link to Why this matters for the product" title="Direct link to Why this matters for the product" translate="no">​</a></h2>
<p>Nudo's contract is "observe faithfully". A false precise result is worse than <code>unknown</code>: <code>unknown</code> tells you the engine has no information; fake precision tells you the wrong information with confidence. The attribution gate is not a performance optimization — it is the difference between inference and fabrication.</p>
<p>If you run <code>nudo test --from</code>, you inherit this safety design. The merge policy and <code>--from</code> boundaries that keep your CI honest are documented in the <a class="" href="https://nudojs.github.io/nudo/docs/guides/callsite-discovery">guide</a>; the <code>entry@</code> fallback for uncovered functions is the honest floor.</p>]]></content:encoded>
            <category>engineering</category>
            <category>callsite-discovery</category>
            <category>launch-series</category>
        </item>
        <item>
            <title><![CDATA[Day 0 — observe JavaScript without rewriting it]]></title>
            <link>https://nudojs.github.io/nudo/blog/day0-observe</link>
            <guid>https://nudojs.github.io/nudo/blog/day0-observe</guid>
            <pubDate>Mon, 21 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Launch series (1/5) — published together on 2026-09-21. Read in order:]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><strong>Launch series</strong> (1/5) — published together on 2026-09-21. Read in order:
<strong>Day 0 — observe JavaScript without rewriting it</strong> · <a class="" href="https://nudojs.github.io/nudo/blog/day1-contracts">Contracts are JS — Day 1 with sidecar *.nudo.js</a> · <a class="" href="https://nudojs.github.io/nudo/blog/vs-typescript">Nudo vs TypeScript — when a JS-first gate is the right tool</a> · <a class="" href="https://nudojs.github.io/nudo/blog/agents-docs">Nudo for coding agents — agents.md, agent integration, stable diagnostics</a> · <a class="" href="https://nudojs.github.io/nudo/blog/attribution-gate">The 22-file smear: how call-site attribution almost shipped fake precision</a></p>
</blockquote>
<p>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.</p>
<p><strong>Day 0 product face:</strong> <code>nudo check</code> prints signatures on success and failure. Call sites are evidence. Unconstrained entry params display as <strong><code>any</code></strong> — not <code>unknown</code>. Optional <code>nudo test</code> reports cases for debugging; it is not the CI gate.</p>
<div class="language-bash codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-bash codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs check src/</span><br></div></code></pre></div></div>
<div class="language-text codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-text codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">signatures</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  subtract(a: any, b: any) =&gt; number</span><br></div></code></pre></div></div>
<p>Even without sidecar contracts, export functions carry the L2 runtime boundary: undigested may-throw on entry functions is an error (<code>nudo:entry-may-throw</code>), filterable while you migrate.</p>
<p>Try it in the <a class="" href="https://nudojs.github.io/nudo/playground">Playground</a>, or read the <a class="" href="https://nudojs.github.io/nudo/docs/getting-started/quick-start">Quick Start</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="why-day-0-matters">Why Day 0 matters<a href="https://nudojs.github.io/nudo/blog/day0-observe#why-day-0-matters" class="hash-link" aria-label="Direct link to Why Day 0 matters" title="Direct link to Why Day 0 matters" translate="no">​</a></h2>
<p>TypeScript’s default story is “annotate first.” Nudo’s default story is <strong>observe first</strong>: run the abstract interpreter on Abs, print what execution computed, and only then decide which obligations you want to write down.</p>
<p>That matches codebases that are JavaScript-first — tooling CLIs, script layers, plugin hosts — where rewriting into <code>.ts</code> is not the product path.</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="next">Next<a href="https://nudojs.github.io/nudo/blog/day0-observe#next" class="hash-link" aria-label="Direct link to Next" title="Direct link to Next" translate="no">​</a></h2>
<p>Day 1 is contracts: <code>*.nudo.js</code> / <code>@nudo:contract</code>, then <code>nudo check</code> L1 gates (<code>actual ⊭ expected</code>). See <a class="" href="https://nudojs.github.io/nudo/docs/guides/contract">nudo contract</a>.</p>]]></content:encoded>
            <category>nudo</category>
            <category>type-inference</category>
            <category>check</category>
            <category>launch-series</category>
        </item>
        <item>
            <title><![CDATA[Contracts are JS — Day 1 with sidecar *.nudo.js]]></title>
            <link>https://nudojs.github.io/nudo/blog/day1-contracts</link>
            <guid>https://nudojs.github.io/nudo/blog/day1-contracts</guid>
            <pubDate>Mon, 21 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Launch series (2/5) — published together on 2026-09-21. Read in order:]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><strong>Launch series</strong> (2/5) — published together on 2026-09-21. Read in order:
<a class="" href="https://nudojs.github.io/nudo/blog/day0-observe">Day 0 — observe JavaScript without rewriting it</a> · *<em>Contracts are JS — Day 1 with sidecar <em>.nudo.js</em></em> · <a class="" href="https://nudojs.github.io/nudo/blog/vs-typescript">Nudo vs TypeScript — when a JS-first gate is the right tool</a> · <a class="" href="https://nudojs.github.io/nudo/blog/agents-docs">Nudo for coding agents — agents.md, agent integration, stable diagnostics</a> · <a class="" href="https://nudojs.github.io/nudo/blog/attribution-gate">The 22-file smear: how call-site attribution almost shipped fake precision</a></p>
</blockquote>
<p>Nudo’s contract product is <strong>not</strong> a second type language. Contracts are ordinary JavaScript modules: sidecar <code>*.nudo.js</code> files that auto-bind to same-name exports, or in-source <code>@nudo:contract</code>.</p>
<div class="nudo-code-playground"><div class="nudo-code-playground-bar"><a class="nudo-code-playground-link" href="https://nudojs.github.io/nudo/playground#code=JTJGJTJGJTIwcHJpY2luZy5udWRvLmpzJTBBaW1wb3J0JTIwJTdCJTIwbnVtYmVyJTJDJTIwZm4lMjAlN0QlMjBmcm9tJTIwJTIyJTQwbnVkb2pzJTJGY29yZSUyMiUzQiUwQSUwQWV4cG9ydCUyMGNvbnN0JTIwbGluZVRvdGFsJTIwJTNEJTIwZm4oJTBBJTIwJTIwJTdCJTIwcHJpY2UlM0ElMjBudW1iZXIoKS5ndCgwKSUyQyUyMHF0eSUzQSUyMG51bWJlcigpLmdlKDEpJTIwJTdEJTJDJTBBJTIwJTIwbnVtYmVyKCkuZ3QoMCklMEEpJTNCJTBB" target="_blank" rel="noopener noreferrer" title="Open this snippet in the browser playground">Run in Playground<span aria-hidden="true"> ↗</span></a></div><div class="language-javascript codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-javascript codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// pricing.nudo.js</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword module" style="color:#00009f">import</span><span class="token plain"> </span><span class="token imports punctuation" style="color:#393A34">{</span><span class="token imports"> number</span><span class="token imports punctuation" style="color:#393A34">,</span><span class="token imports"> fn </span><span class="token imports punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword module" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@nudojs/core"</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword module" style="color:#00009f">export</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> lineTotal </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">fn</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token literal-property property" style="color:#36acaa">price</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">number</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">gt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token literal-property property" style="color:#36acaa">qty</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">number</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">ge</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token function" style="color:#d73a49">number</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">gt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><br></div></code></pre></div></div></div>
<div class="language-bash codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-bash codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs check pricing.js</span><br></div></code></pre></div></div>
<div class="language-text codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-text codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">issues</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  [error] lineTotal: actual ⊭ expected  (nudo:constraint-violated)</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    actual:   0  #exact</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    expected: price &gt; 0</span><br></div></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="product-rules">Product rules<a href="https://nudojs.github.io/nudo/blog/day1-contracts#product-rules" class="hash-link" aria-label="Direct link to Product rules" title="Direct link to Product rules" translate="no">​</a></h2>
<table><thead><tr><th>Rule</th><th>Meaning</th></tr></thead><tbody><tr><td>Contract surface</td><td><code>*.nudo.js</code> / <code>@nudo:contract</code> (<code>@nudo:contract</code> is an alias)</td></tr><tr><td><code>@nudo:case</code></td><td>Debug witnesses only — never the contract product</td></tr><tr><td>Drafts</td><td><code>nudo contract --draft</code> is reviewable; never auto-bound</td></tr><tr><td>check vs export</td><td><code>check</code> validates Abs; <code>export</code> projects lossy dts/zod/guards</td></tr><tr><td>any vs unknown</td><td>Entry <code>any</code> = unconstrained; <code>unknown</code> = inference failed</td></tr></tbody></table>
<p>Logic-first teams draft from call sites; contracts-first teams write the sidecar up front. Both meet on the same Abs face.</p>
<p>Next: <a class="" href="https://nudojs.github.io/nudo/docs/guides/contract">contract guide</a> · <a class="" href="https://nudojs.github.io/nudo/docs/reference/diagnostics">diagnostics</a> · <a class="" href="https://nudojs.github.io/nudo/docs/guides/recipes">recipes</a>.</p>]]></content:encoded>
            <category>nudo</category>
            <category>contracts</category>
            <category>check</category>
            <category>launch-series</category>
        </item>
        <item>
            <title><![CDATA[Nudo vs TypeScript — when a JS-first gate is the right tool]]></title>
            <link>https://nudojs.github.io/nudo/blog/vs-typescript</link>
            <guid>https://nudojs.github.io/nudo/blog/vs-typescript</guid>
            <pubDate>Mon, 21 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Launch series (3/5) — published together on 2026-09-21. Read in order:]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><strong>Launch series</strong> (3/5) — published together on 2026-09-21. Read in order:
<a class="" href="https://nudojs.github.io/nudo/blog/day0-observe">Day 0 — observe JavaScript without rewriting it</a> · <a class="" href="https://nudojs.github.io/nudo/blog/day1-contracts">Contracts are JS — Day 1 with sidecar *.nudo.js</a> · <strong>Nudo vs TypeScript — when a JS-first gate is the right tool</strong> · <a class="" href="https://nudojs.github.io/nudo/blog/agents-docs">Nudo for coding agents — agents.md, agent integration, stable diagnostics</a> · <a class="" href="https://nudojs.github.io/nudo/blog/attribution-gate">The 22-file smear: how call-site attribution almost shipped fake precision</a></p>
</blockquote>
<p>Honest positioning: Nudo is built to <strong>replace TypeScript as the day-to-day type gate for JavaScript-first codebases</strong> — not to reimplement the TypeScript compiler.</p>
<table><thead><tr><th></th><th>TypeScript</th><th>Nudo</th></tr></thead><tbody><tr><td>Primary surface</td><td><code>.ts</code> + annotations</td><td>Plain <code>.js</code></td></tr><tr><td>Contracts</td><td>Type language</td><td><code>*.nudo.js</code> builders + <code>@nudo:contract</code></td></tr><tr><td>Inference</td><td>From annotations</td><td>From <strong>executing</strong> code on Abs</td></tr><tr><td>CI gate</td><td><code>tsc --noEmit</code></td><td><code>nudo check</code></td></tr><tr><td><code>.d.ts</code></td><td>The model</td><td>A <strong>lossy projection</strong> of Abs</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="prefer-nudo-when">Prefer Nudo when<a href="https://nudojs.github.io/nudo/blog/vs-typescript#prefer-nudo-when" class="hash-link" aria-label="Direct link to Prefer Nudo when" title="Direct link to Prefer Nudo when" translate="no">​</a></h2>
<ul>
<li class="">The package is JavaScript-first and you refuse a second IR just to get types</li>
<li class="">Behavior (branches, string algebra, loops, bounds) matters more than declared interfaces</li>
<li class="">You want runtime-shaped obligations in CI without body-AST slot invention</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="keep-typescript-primary-when">Keep TypeScript primary when<a href="https://nudojs.github.io/nudo/blog/vs-typescript#keep-typescript-primary-when" class="hash-link" aria-label="Direct link to Keep TypeScript primary when" title="Direct link to Keep TypeScript primary when" translate="no">​</a></h2>
<ul>
<li class="">The codebase is <code>.ts</code>-first</li>
<li class="">You need the full TS type language as programming</li>
<li class="">Your ecosystem is DefinitelyTyped / project references</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="coexistence">Coexistence<a href="https://nudojs.github.io/nudo/blog/vs-typescript#coexistence" class="hash-link" aria-label="Direct link to Coexistence" title="Direct link to Coexistence" translate="no">​</a></h2>
<p>Split <strong>by package</strong>: JS packages on Nudo LSP + <code>nudo check</code>; TS packages on <code>tsc</code>. See <a class="" href="https://nudojs.github.io/nudo/docs/guides/coexistence">coexistence</a> and <a class="" href="https://nudojs.github.io/nudo/docs/concepts/limits">limits</a>.</p>
<p>Full map: <a class="" href="https://nudojs.github.io/nudo/docs/guides/vs-typescript">Nudo vs TypeScript</a> · <a class="" href="https://nudojs.github.io/nudo/docs/guides/migrating-from-typescript">Migrate from TS</a>.</p>]]></content:encoded>
            <category>nudo</category>
            <category>typescript</category>
            <category>type-inference</category>
            <category>launch-series</category>
        </item>
    </channel>
</rss>