诊断术语表
nudo check / 分析打印的稳定诊断码。产品原生消息使用 actual ⊭ expected(Nudo Abs 蕴含),不是 TypeScript 诊断的伪装。
机器可读面:nudo check --json。Agent:见 Agents 与已发布的 agents.md。
契约门禁(L1)
nudo:constraint-violated
| 含义 | 调用/返回不满足显式契约 Pred |
| 层 | L1 error |
| 来源 | *.nudo.js / @nudo:contract |
// needsPositive with @nudo:contract x positive
needsPositive(-1);
// actual: -1 #exact
// expected: x > 0
修复: 收紧调用点,或在义务本身写错时修正契约。故意越界输入不是产品默认 —— 改契约,不要静默「忽略」L1。
Context: L1 —— 显式契约 · 用 check 门禁
nudo:assign-mismatch
赋值 / 绑定 shape 不满足先前契约 shape(leqAbs 结构失败)。修值或修声明槽。
Context: L1 —— 显式契约 · 契约
nudo:arg-structure
HOF 实参不是可调用 fn,或元数与显式 relation 契约不匹配。(body 提升建议是 warning,不是此错误。)
Context: nudo check · 契约
调用点验证精度
以下码来自调用点 / 契约验证(checkCall / checkArg):调用被对照泛化参数面检查时,检查器不只报违例,也会报验证降级——诚实的「无法证明」,而不是静默放行。
nudo:constraint-unproven
cannot prove the argument satisfies x > 0
实参 pred 无法可证蕴含契约 pred,且不是引擎可判定的字面量。Warning —— 验证悬而未决,不是失败。修复:补调用点 / @nudo:case,或用 --assume 声明前置条件。
Context: nudo check · Pred 蕴含(有界)
nudo:arg-opaque
argument type is unknown; cannot verify constraint x > 0
实参 Abs 是 unknown(无 term)——约束根本无法检查。Warning —— 补调用点或 @nudo:case,或用 --assume 提供前置条件。若 unknown 是引擎债,先建模该值的来源(env / mock)。
Context: any 与 unknown · nudo check
nudo:arg-count
scale expects 2 argument(s), got 1
调用元数与泛化参数面不匹配。Error。
Context: nudo check · 使用处(--from)
nudo:fn-not-found
function nope not found
调用引用了分析器在作用域内无法解析的函数。Error —— 检查函数名 / 导出,或用 env / @nudo:mock-module 补上缺失模块。
Context: @nudo:mock-module · 依赖类型
nudo:partial-result
f(...) result confidence partial
结果 Abs 携带 #partial 置信。Info —— 仅观察。建议:补调用点或约束以提升精度。
Context: nudo check · 使用处(--from)
nudo:case-inconsistency
已声明的 @nudo:case 见证与显式 refine 冲突。调试见证与契约不一致 —— 修见证或修契约。
Context: @nudo:case · 声明断言
nudo:contract-param-mismatch
手写契约参数名不在形式参数面上。合法名:普通参数名、解构绑定名(rename 时用源属性键)、嵌套解构的点路径键(({ card: { grade } }) 用 'card.grade')——见侧车自动绑定。
nudo:contract-conflict
手写契约合取不可满足。简化侧车 / refine。
nudo:contract-load
侧车文件加载失败(解析 / import / 解析路径错误)。Error。 修侧车;若契约已废弃则删除绑定。
nudo:contract-name-clash
侧车导出名与源码导出冲突,或 emit 会覆盖手写绑定。手写始终优先。
nudo:contract-cycle
侧车 @nudo:import 链成环。Error。 修复:打破侧车 import 环。
Context: @nudo:import · 契约诊断
nudo:contract-domain-exceeds
经 nudo check --from 注入的跨文件调用点证据不在手写契约域内(⊄)。Error。 修复:放宽契约,或修正使用处。
Context: 契约诊断 · 使用处(--from)
nudo:contract-drift
固化的 @generated 侧车段 ≠ 今日重算的调用点域或返回。Warning —— 不挡 exit。
nudo:contract-entry-only
导出函数无契约根(无手写/生成侧车或 @nudo:contract)且无调用点域(仅合成 entry@、参数为 any)。Info —— 覆盖/契约缺口,不是门禁失败。修复:补契约(*.nudo.js / @nudo:contract),或从使用现场触达该导出(nudo check --from)。
nudo:dual-entry
dual-entry package "lib": browser (./browser.js) and node (./node.js) call-site
records do not cross files — analysis observes only the browser entry variant
该包发布 browser/node 双入口(package.json exports 条件或 browser 字段指向与 main/node 不同的文件),且本次分析跑在其中一个变体上。调用点记录按文件归因:另一入口上的证据不会注入到这里。Info —— 观察信号,不是门禁失败。单入口包、以及不是入口目标的共享 helper 上绝不触发。
修复: 分析你实际发布的入口,另一变体 mock 或跳过;不要期望 --from 记录跨两个面合并。这仍是天花板 —— 见边界与非目标。
Context: 调用点发现上限
nudo:contract-emit-denied
emit target 'path/lib.js' is outside package.json#nudo.contract.emit allowlist (patterns match the source file path, not the sidecar path 'path/lib.nudo.js')
contract --emit 拒绝写配置允许列表之外的侧车。Warning —— 该次写入被跳过。允许列表的匹配口径是源文件路径,不是侧车路径(消息里两条路径都会给出)。修复:移动目标路径,或扩展 package.json#nudo.contract.emit。
Context: 固化生成段
nudo:contract-multi-declarator
generated section 'a, b' is a hand-merged multi-declarator form; kept verbatim
@generated 段被手工合并成一个多声明导出。Warning —— 原样保留(手写优先);拆成每节一个导出即可重新 emit。
Context: 固化生成段
nudo:contract-not-projectable
assembled sidecar failed round-trip (path); refusing to write
组装的侧车源码无法重新解析回推导出的契约。Error —— 不写任何文件。作为引擎债上报(round-trip 必须成功),调整源码直到 contract --emit --dry-run 干净。
Context: 固化生成段
运行时边界(L2)
nudo:entry-may-throw
| 含义 | 入口/导出函数有未消化 may-throw |
| 层 | L2 error(默认) |
| 展示 | 签名行上的 throws TypeError |
export function getName(user) {
return user.name; // any receiver → may throw
}
修复选项: 把参数 refine 成 shape;对路径 try/catch;或(迁移期)--ignore-throws TypeError / package.json#nudo.check.ignoreThrows / --entry-throws warning。L2 不门禁内部 helper。
Context: L2 —— 入口 throws · @nudo:throws
nudo:module-throw
| 含义 | 模块顶层代码必然抛 ⇒ 模块永远无法被导入 |
| 层 | L2 error(默认) |
| 展示 | module initializer always throws TypeError — the module cannot be imported … |
throw new TypeError("boom");
export function f() { return 1; } // 模块永远不可导入:装载即抛
求值面把该模块判为未分析:导出全丢 ⇒ 签名退化成 unknown、L2 入口证据
不存在。此码出现之前,这个状态与「分析过了、什么都没发现」完全不可区分
(OK、exit 0)——引擎根本没分析的模块拿到绿灯。
判据只认句法证据:顶层语句序列无条件执行的 throw(只穿过裸块)。
条件抛(if (typeof window === "undefined") throw …)、被 try/catch 吸收的
抛、以及引擎从自身宿主 API 近似推出的抛(例如缺失依赖被建模成闭合对象)
都不报——真实包(typescript、react-dom、vitest)原生加载正常而引擎
失败,引擎的「必抛」不是关于程序的证据。
修复 / 抑制: 若模块本应可导入,就把 throw 改成有条件的;若装载即抛是
有意行为,用 --ignore-throws <Kind>(文案里的类型名)或 --entry-throws off
/ package.json#nudo.check.entryThrows。每个模块一条诊断,不按入口重复。
Context: L2 —— 入口 throws
引擎债 / 观察
nudo:unknown-inference
签名上的真 unknown —— 推导失败。不是无约束入口 any。修复:建模 env、补 mock,或 refine。
Context: any 与 unknown · 依赖类型
nudo:unproven-return
Return postcondition could not be proved (any / unknown / opaque face, or a widened/bound-less arm facing a bounded obligation, or an out-of-bounds marker arm — an abstract index read like d[m][n] on a loop-built table joins a synthetic undefined; the loop-bound/length relation is lost, so neither proof nor disproof is possible). A bare widened prim arm still proves a bound-less prim contract (number() / string()) — the value domain is known even without term/pred evidence; only bounds (gt(0), int, …) remain unprovable. Warning — inference failed to discharge the obligation; do not treat as success. Distinct from nudo:constraint-violated (definite violation).
Context: nudo check
nudo:assume-relied
sim: return contract proved via @nudo:assume d <= max
→ @nudo:assume is a user-supplied axiom — falsify it with concrete @nudo:case runs (nudo test)
返回契约的证明依赖了用户引理(@nudo:assume)。Info —— 审计标注而非门禁:引擎验证的是义务(返回契约),从不验证引理本身。报告会建议用具体 @nudo:case(nudo test)证伪引理——错误引理会让受影响的证明 unsound,依赖面必须上屏可见。与 nudo:unproven-return(证不出、诚实保留为 warning)互为对偶。
Context: @nudo:assume · nudo check
nudo:invariant-relied
levenshtein: return contract proved via @nudo:invariant dp[*][*] >= 0
→ @nudo:invariant is a user-supplied axiom — falsify it with concrete @nudo:case runs (nudo test)
返回契约的证明依赖了用户声明的循环不变式(@nudo:invariant)。Info —— 审计标注而非门禁:引擎验证的是义务(返回契约),从不验证不变式本身。报告会建议用具体 @nudo:case(nudo test)证伪不变式——错误不变式会让受影响的证明 unsound,依赖面必须上屏可见。与 nudo:unproven-return 互为对偶。
Context: @nudo:invariant · nudo check
nudo:invariant-inferred
loop-carried 's' was widened after 9 observed iteration(s) (observed bound: s >= 0; widening dropped it)
→ an observed extreme is NOT a proved invariant — declare @nudo:invariant only if the bound truly holds
循环携带标量在宽化后给出观测界。Info——观测提示,永不作为证明前提:报告的极值来自由有限次迭代的单侧证据,不是不变量,也不参与任何证明。只有显式声明 @nudo:invariant 才会让引擎依赖该界(由 nudo:invariant-relied 归因)。
Context: @nudo:invariant · nudo check
nudo:unknown-recv
unknown 接收者上的成员访问。不能替代 L2 throws 建模。
Context: any 与 unknown · L2 —— 入口 throws
nudo:builtin-unknown
API 未被 env/推理覆盖(如未建模全局)。优先 @nudo:env / mock。
nudo:capability-denied
被分类为有副作用的宿主全局或 node: 模块在不可信分析下被禁用(strict 能力档,默认)。值退化为 unknown,绝不执行宿主实现;需要其形状时用 @nudo:mock / @nudo:mock-module,分析可信代码可设 NUDO_CAPABILITIES=trusted。这是防御纵深,不宣称 sandbox。
Context: 执行模型与信任边界
nudo:opaque-result
求值返回 opaque / 无信息 Abs。
Context: 求值器缺口
nudo:recursion-truncated
递归求值被截断;结果拓宽为 unknown#opaque。文案——以及 check --json 的 reason 字段——指明归因:
cycle——同抽象实参的调用已在求值栈上(数据依赖的自/互递归,如walk(dir, out)以(dir, out)递归自身)。这不是预算:抬@nudo:budget解不开。让递归实参逐层变化、收窄基例,或声明@nudo:contract。depth/calls——调用预算(深度 64 / 总进入 20,000)用尽。suggestion 与@nudo:budgetquickfix(nudo check --fix/ LSP code action)带具体建议值——从观测深度/调用数推导(默认上限 ×2 兜底,即@nudo:budget depth=128/calls=40000——如raise the function budget with @nudo:budget depth=128 (or narrow the recursion base case / declare @nudo:contract return));否则重构递归。
预算旋钮与修复:性能:预算与分析缓存。
Context: 分析预算
nudo:fork-truncated
分支展开预算($fork 总次数)用尽;受影响结果拓宽。info。suggestion 带计算出的具体修值——从观测 fork 次数推导 max(20000, 观测 × 1.5 向上取整到千)——如 fix: package.json#nudo.analysis.maxForks=20000 (observed 6 forks this run), or @nudo:budget forks=20000 on the function — non-blocking。可用 NUDO_MAX_FORKS、package.json#nudo.analysis.maxForks 或函数级 @nudo:budget forks=N 调高(默认 5000)。预算与修复:性能:预算与分析缓存。
Context: 分析预算
nudo:loop-truncated
循环的退出条件越过迭代预算仍保持具体真(抽象展开上限 8、具体延展上限 1024——如 while (i < n) 的 i/n 都是具体值且不终止);循环状态被拓宽(有界、非 exact)。info。这是循环迭代预算,不是调用预算——@nudo:budget calls=…/depth=… 抬不动。让上界依赖数据(抽象化)或用 @nudo:case / @nudo:contract 钉住结果——非阻塞。
Context: 分析预算
nudo:promise-micro-truncated
Promise 微任务队列触及硬上限(MAX_PROMISE_MICROS = 1024),剩余排队回调被丢弃。info。受影响的 promise 结果保持拓宽,而不是静默出错。
Context: 分析预算
nudo:promise-micro-error
求值出口排空微任务时,某个 then/catch 回调抛错。info。该回调效果不完整;请检查报告的错误以及排队该回调的表达式。
Context: 分析预算
nudo:math-fold-error
分析期某个 Math 原生折叠抛错(宿主篡改或分叉的 Math.*);结果拓宽为 number。info。保持分析代码中的 Math.* 内建不被改写,或用 @nudo:mock 打桩——非阻断。
Context: 模拟外部依赖
nudo:host-effect-blocked
宿主副作用函数(fetch / XMLHttpRequest / WebSocket / EventSource / setTimeout / setInterval / setImmediate / queueMicrotask / requestAnimationFrame / requestIdleCallback)在分析期不真实执行——真实执行会以 Abs 实参发起网络 I/O 或排真实定时器。结果拓宽为 unknown#opaque。info。suggestion 带按宿主名分族的可粘贴单行 @nudo:mock 骨架(原样粘进调用方函数的 JSDoc 即可),或从调用点喂入值:
fetch→mock it: @nudo:mock fetch = (url) => ({ ok: true, json: () => ({ id: 1 }) }) (single line, in the calling function's JSDoc), or pass the value in from a call site — non-blocking- 定时器族(
setTimeout/setInterval/setImmediate/queueMicrotask/requestAnimationFrame/requestIdleCallback)→@nudo:mock setTimeout = stub().returns(0) - 构造器族(
new WebSocket(url)/XMLHttpRequest/EventSource)→@nudo:mock WebSocket = stub().returns({ send: () => 1, close: () => 1 })——必须用stub()形态:箭头函数 mock 不可构造,new它会把本条 info 换成throws TypeError假红。
全部骨架均经端到端验证:原样粘贴进被分析函数的 JSDoc 后诊断消失、结果恢复精度(promise<{ id: 1 }> / timer id / 精确对象形状)。语法规则:模拟外部依赖。
nudo:no-signature
函数无法泛化(CJS/匿名形态仍经入口 fallback 得到 L2)。
Context: 求值器缺口 · nudo check
nudo:no-method
无法解析的成员访问:Method 'x' does not exist on type 'T' / Property 'x' does not exist on type 'T'。原始类型接收者(number / boolean / bigint / symbol)为 error,其余为 warning。与 nudo:unknown-recv(unknown 接收者)不同。
Context: 求值器缺口
nudo:mock-invalid
@nudo:mock 表达式无法解析为已知形态(stub/spy/mock 形式、箭头函数或类型表达式)。Warning —— 检查受支持形态。
Context: Mock 语法 · @nudo:mock
nudo:directive-syntax
@nudo:case / @nudo:mock / @nudo:as / @nudo:skip 指令文法非法(名称非法、尾注释残留、类型表达式不可识别)。Warning —— 该指令被忽略;修正写法。
nudo:contract-syntax
@nudo:contract 段或 @nudo:import 形态非法(如 x > 0 而非 x positive、default import)。Warning —— 该段被忽略;使用 <param> <约束名> 或 return <约束名>。
nudo:assume-invalid
sim: malformed @nudo:assume 'd <= 10' (expected <param> <= <param> or <param> >= <param>; constant bounds belong to sidecar contracts)
sim: @nudo:assume name(s) not bound as parameters or top-level locals (x, y)
@nudo:assume 段不在 var <= var 文法之内,或引用了锚定函数形参或函数体顶层 const/let/var 局部绑定之外的名字(解构、嵌套块、for 头声明不算)。Error —— 该段被忽略,不折入任何引理。文法只接受 <name> <= <name>(>= 归一为 le);< / > / == 与常数界(d <= 10)均非法——常数界归侧车契约(number().le(10)),该指令只声明引擎推导不出的跨变量引理。
Fix: 引用锚定函数形参或函数体顶层局部绑定内的名字;常数界写进侧车 / @nudo:contract(局部量的常数界放在生产它的 callee 的返回契约上)。
Context: @nudo:assume · 契约门禁(L1)
nudo:invariant-invalid
levenshtein: malformed @nudo:invariant 'dp[*][*] == 0' (expected <name><path> <rel> <number>; path = [*] or .member steps)
f: @nudo:invariant name not bound as a parameter or top-level local (table)
@nudo:invariant 段不在 <name><path> <rel> <number> 文法之内(== / != / 非数值界均非法),或引用了锚定函数形参或函数体顶层 const/let/var 局部绑定之外的名字。Warning —— 该段被忽略,循环 join 不做任何强化,依赖它的证明保持诚实 unproven。
Fix: 用 >= / <= / > / < 配数值常数(dp[*][*] >= 0,对象槽用 .ident),并引用锚定函数形参或函数体顶层局部绑定内的名字。
Context: @nudo:invariant · 契约门禁(L1)
nudo:env-unresolved
path env failed to load: ./nudo-env.mjs — Cannot find package '@nudojs/env'
path env failed to load: ./nope.mjs — path env not found: <resolved-path>
unknown env name "bogus" (built-in envs: es, web, node; a path env needs a ./ or ../ prefix)
env file must export a defineEnv() function (got undefined)
路径型 env 项(package.json#nudo.env 的路径项或 /// @nudo:env <path>)加载失败——直连 import() 与重写回退均失败,或指向的文件不存在。Warning——该 env 项退化为「env 关」语义,分析会静默丢失这些绑定(env 正常加载的运行能推断得更多);不要把该告警当 benign 处理。
同一码还覆盖两类 env 契约失败:env 名既不是内置(es、web、node)也不是路径(路径型 env 需要 ./ 或 ../ 前缀);以及路径型 env 文件未导出 defineEnv() 函数、导出了非函数、求值时抛错,或返回了 { globals } 以外的值。此前两者都是静默的:env 干脆没生效,受影响的代码随后被判成「必定抛 ReferenceError」。package.json#nudo.env 里的非字符串项也按同样方式报告,而不是崩掉。
发射面: nudo check(issues 段)、nudo test(env warnings 段,告警行格式完全一致;--json 面告警走 stderr,stdout 保持单一 JSON 文档)与 LSP(warning 诊断,code 同名,消息格式同源)。它从不影响退出码。
修复: 检查 package.json#nudo.env 路径(或 /// @nudo:env <path>)是否指向存在且预期的文件、其 import 是否可解析——修复 env 文件内的 import specifier,确保 @nudojs/env(与 @nudojs/core)可从项目解析,或移除该项。
Context: Env & harvest
nudo:env-harvest-conflict
handwritten @nudo:env wins over harvest on module "fs"; harvest only fills missing slots
手写 @nudo:env 模块与 @types harvest 同时提供了同一模块键或导出。Warning —— 手写 env 优先(mergeHarvestUnderEnv);harvest 只补缺失槽。消除方式:从手写 env 删除重叠导出,或接受该优先级。
Context: 常见陷阱
nudo:contract-underivable
派生契约行(root 驱动推导 / nudo contract --draft)无法从源码证据推导(opaque / 截断 / 无证据)。Info —— 该行被跳过;手写契约从不触发此码。
Context: 观察层 → 草稿
nudo-unreachable
return/throw 之后的代码 —— info 级。注意连字符:这是唯一不带冒号的诊断 id。
Context: nudo check
nudo:may-throw
Case 路径可能抛(test / 线索)。L2 升格的是入口 throws。
Context: L2 —— 入口 throws · @nudo:throws
nudo:internal
Check error: <message>
内部分析/校验失败以诊断形式浮出(check 门禁未能完整跑完)。Error —— check 通道不得静默消失;请修复底层失败或上报 bug。
Context: nudo check
模块图
Abs 模块求值(evalAbsModuleGraph)遇到装载问题时上报。cycle / depth 为 warning;missing / missing-export 为 error。
nudo:module-cycle
Circular module load: a.js -> b.js -> a.js
(bindings inside the cycle resolve to their partially evaluated types)
修复: 打破环(抽取共享逻辑),或接受部分类型。
Context: nudo check
nudo:module-depth
Module load chain too deep (depth N > M max): a.js -> b.js -> …
(loading truncated, deeper modules typed as unknown)
修复: 链超过装载深度预算——扁平化 re-export 跳数或调高预算。
Context: nudo check
nudo:module-unreadable
cannot read module '/abs/path/dep.js' (EACCES): EACCES: permission denied, open '/abs/path/dep.js'
Error。 依赖存在但读不了(EACCES / EIO / EMFILE / ESTALE…)。与 nudo:module-missing(没有这个文件)不同:文件就在那儿,只是读不了 ⇒ 它的类型保持 unknown,门禁 fail-closed。修复: 修文件权限(或模块路径)——依赖在,只是读不到,类型因此是 unknown。
Context: @nudo:mock-module · nudo check
nudo:json-invalid
JSON module './data.json' (from main.js) is not valid JSON: <parser message>
Error。 .json 依赖的 JSON 语法非法。与 nudo:module-missing(文件不存在)、nudo:module-unreadable(读不了)都不同:文件在、也读得到,只是内容不是合法 JSON ⇒ 取不到任何值。修复: 修正 JSON 语法——尾逗号、注释与单引号都不是合法 JSON。
Context: nudo check
nudo:module-missing
Module file not found for 'spec' (from file); tried: path
Error。 被分析文件 import 了装载器无法解析的模块。修复: 修正 spec,或 mock 该模块(@nudo:mock-module / @nudo:mock)。
Context: @nudo:mock-module · nudo check
nudo:exports-unresolved
package.json 声明了 exports 目标,但子路径/条件未解析到文件。warning —— 分析回落 harvest stub / 文件直猜,可能与真实入口不符。与 nudo:module-missing(完全没有模块)不同。
Context: 求值器缺口
nudo:missing-export
Module './m.js' has no export 'b' (from index.js)
Error。 具名 import(或 export { x } from)引用了源模块并未导出的名字——通常是拼写错误。仅当源模块导出表来自成功求值时才报(fail-closed 空表与未解析模块保持静默,不与 nudo:module-missing 叠报)。修复: 修正导入名、在源模块补上导出,或 mock 该模块(@nudo:mock-module)。
Context: @nudo:mock-module · nudo check
nudo:missing-slot
Field 'name' is missing on the evaluated object shape
Warning,默认 off。 C0.5:求值实际命中了闭对象 shape 的缺字段(用 package.json#nudo.analysis.evalMissingSlot: "warning" 打开)。它是观察,不是义务——不会凭空产生 check 错误;手写契约仍经 nudo:constraint-violated 门禁。
Context: 非目标
测试断言(nudo test)
nudo:case-expected
debug "bad": expected 5, got 4. The inferred return type does not match the
expected type declared in the @nudo:case witness
声明的 @nudo:case "name" (…) => expected 见证的期望类型与推断结果不符。在 test 运行中为 error —— 声明断言失败会让 nudo test 以 1 退出;合成 call@ / entry@ case 永不导致运行失败。
报告中的失败面:
=== double ===
debug "bad" (2) => 4
assertions
✗ 0 passed · 1 failed · 0 unchecked
[FAIL] double case "bad"
expected: 5
actual: 4
修复: 改正见证期望或函数体。
Context: 声明断言 · @nudo:case
CLI 路径解析
CLI 目标 / --from 路径解析错误 —— 收集在 --json 信封的 pathErrors[]({ path, code, message, suggestion? })中;人类可读面打印一行原因 + fix: 提示。pathErrors 非空 ⇒ ok: false ⇒ exit 1。分析开始前的用法错误 —— 不是 Abs 诊断。
nudo:path-not-found
Not found: /abs/path
请求的路径不存在。Error(usage)—— 检查路径;它必须是已存在的 .js/.mjs/.ts 文件,或包含这类文件的目录。
Context: nudo check · 检查内容
nudo:path-empty-dir
No nudo files found in directory: /abs/dir
目录存在但没有分析目标。Error(usage)—— 补上 .js/.mjs/.ts 源码(或指向有这类文件的目录);sidecar/decl/JSX 会被跳过。
Context: nudo check · 检查内容
nudo:path-not-target
Not an analysis target (need .js/.mjs/.ts, not sidecar/decl/JSX): /abs/file.nudo.js
文件存在但不是分析目标(.nudo.js 侧车、.d.ts 声明、.jsx/.tsx 被排除)。Error(usage)—— 传入 .js/.mjs/.ts 分析文件。
Context: nudo check · 检查内容
nudo:path-missing-callsite
Callsite file not found: /abs/tests
--from 使用处路径不存在。Error(usage)—— 传入已存在的 --from <file-or-dir>;它为生成提供 call@ 记录。
Context: 使用处(--from) · nudo check
nudo:path-io
export --out mkdir failed: out/dir
--out 输出目录 IO 操作失败(mkdir / write)。Error(usage)——原始 errno 不进产品面;检查 --out <dir> 可写且为目录路径后重跑。(BUG-023:使 nudo export 与 check / test 同具 PathError 面。)
Context: nudo export
nudo:migrate-strip-failed
migrate strip: src/cls.ts: the emitted .js would still contain TypeScript syntax (class member modifier 'private') — Node cannot parse it
nudo migrate strip --write 拒绝写出 Node 解析不了的产物。Error(usage)——strip 只剥类型语法;它自己降不了的构造必须手工降级(或交给 tsc)。类成员修饰符(private / public / protected / readonly / abstract / override)与构造器参数属性已由 strip 降级(修饰符被丢弃;参数属性变成字段 + 构造器体里的 this.x = x 赋值)⇒ 它们不再触发本闸门——仍会触发的是 strip 降不了的构造(例如解构形态的构造器参数属性)。migrate 是一程闸门:半写的 .js 没有回退路径 ⇒ 文件一个字节都不落盘,并点名。
Context: nudo migrate
读懂 actual ⊭ expected
actual: 0 #exact // 调用点观测到的 Abs
expected: price > 0 // 来自契约的 Pred
Abs 上的 conf 标记:#exact / #path / #widened / #mock / #partial / #opaque —— 见 Abs。
影响诊断的配置
{
"nudo": {
"analysis": { "mode": "exports", "evalMissingSlot": "off" },
"check": {
"ignoreThrows": ["TypeError"],
"entryThrows": "error"
},
"contract": { "autoBind": true }
}
}
ignoreThrows / entryThrows 只影响 L2 —— 它们绝不吞掉 L1 契约违例。