GVSDS/ViperC
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity
543 Commits 1 Branch 3 Tags
dc4e06d88bb502b808a26f93f57d64cdf1fccc80
Commit Graph
66 Commits
Author SHA1 Message Date
TermiNexus d979cc8c1f fix(TPV/ExprGenName): 结构体值局部变量在使用处要求同型结构体值时 load 出值 
现场：Test/WebTest 编译 includes/socket.vp:121 报
  CastError: 非基本类型的值/指针隐式转换已禁止（构造物化除外）：
  不能把指针类型隐式转为非基本类型值（Foo* → Foo）
  源类型 %"56d0ee99ecf0a0b5.SocketAddr"* → 目标值类型 %"56d0ee99ecf0a0b5.SocketAddr"

现场代码：
  class SocketAddr:  family: u16 / port: u16 / addr: u32 / zero: u64   # 纯结构体，无 __new__、无方法
  def _MakeAddr(host: str, port: INT) -> SocketAddr:
      addr: SocketAddr                     # 结构体值局部变量
      string.memset(c.Addr(addr), 0, 16)
      ...
      return addr                          # ← 第 121 行报错

根因：ExprGenName.translate_name_value 对"结构体值局部变量"的右值**恒返回 alloca 地址**
（原实现，注释解释为"对象即指针"语义，避免 ptrtoint %Struct 非法指令）；而 _MakeAddr
的返回类型经 resolve_annotation_type 解析为**结构体值**。translate_return 会把函数返回
类型作为 target_ty 下传给 translate_value（StmtGenCifMixin.vp:557-558），于是 `addr`
求值出 %SocketAddr* → coerce_to_type 的"指针 → 非基本类型值"分支
（ExprGenBase.vp:954-970）只对"构造物化"豁免 → 报错。
标量局部变量无此问题（同函数内非 Struct 分支会 build_load 出值），属结构体值局部变量
独有的表示差异。

改动：ExprGenName.translate_name_value 的 Struct 分支增加 target_ty 判据——使用处
**明确要求同一非基本类型（非指针）**时（_same_agg_ty 判据：与"构造物化豁免"同一类型
匹配真源 AssignGen._stg_ty_equal），像标量一样 build_load 出值；否则维持既有"返回地址"。
- target_ty 为指针时不命中（裸类形参 lowering 为 Ptr(struct)，见 FuncGenDef）⇒
  Test/StructTest 的 point_sum(p) 这类实参传址行为不变。
- 字段访问基座（ExprGenAttr.vp:743-744，直接 lookup_var 取地址）、c.Addr 取址
  （CallGenCBuiltin.vp:293）、方法接收者均不经本函数取地址，不受影响。
- 同时修正该处已失真的注释（原文举例 `x: Cls | t.CPtr` 实际解析为 Ptr(struct)，
  并非 Struct 值局部变量）。

待验证：重编译 TransPyV（自举两遍）→ WebTest / StructTest / ClassArrayTest / JsonTest。
 2026-10-01 14:26:18 +08:00
TermiNexus b289e93650 fix(泛型实参 T* 形): 补齐 T* 消费侧（VpiReader 段解析 / AnnotClassName 提取 / 构造推断） 
唯一规范形 T*（rawptr[T] ≡ t.CPtr[T] ≡ T|t.CPtr，见 83baf5a/2b2b70e）落地后，
所有"读**已归一实参文本**或**结构体名**并做文本解析/嗅探"的点都必须接受 T* 形，
否则会**静默**走错分支（不是报错，更难发现）：

- VpiReader._resolve_single_vpi_type_str：尾随 * 段按层重写回 rawptr[...] 文本形
  再走原分支（与既有 rawptr[ 分支逐字等价）。必须补的原因：_subst_template_arg
  用特化类名 [...] 内的**已归一实参**替换模板注解里的 T，喂进来的就是 {sha}.AST*；
  旧代码只认 rawptr[ / t.CPtr[ / 裸 t.CPtr ⇒ 落到 strrchr('.') 取末段 "AST*"、
  查 struct miss ⇒ 返回 None/i8*，跨模块参数/返回宽度被悄悄收窄。
- ExprGenCls / AssignGenMixin 的 _extract_annot_class_name（各 2 处）：段尾剔除集
  补 '*'，剥后再 find_struct（旧形态 {sha}.AST|t.CPtr 按 '|' 分段能命中，新形态
  不剥则 miss ⇒ 返回 None ⇒ 链式 .get(0).kind() 分派退化）。
- CallGenCtor._infer_generic_ctor_type_arg：新增 _ptr_layer_type_arg —— 先经
  _norm_type_arg_name 归一（保证类名带定义模块 SHA1，否则裸 "AST*" 无法再归一、
  反而新分裂），再按 VarEntry/FieldEntry 的 Spec.PtrLevel 补 '*'，使构造侧推出的
  类型实参与注解侧同票名（否则 Box(x) 这类隐式特化分裂成两个结构体）。
- CallGenDispatch.__sizeof__：'*' 判据由 strrchr 改为**尾随**判定 —— 原写法会把
  list[{sha}.AST*]（元素为指针的容器）误判成指针并返回 8。

现场：Test/AstTest/App/main.vp:21 的 list[ast.AST | t.CPtr] | t.CPtr 特化链
（→ includes/_list.vp:36 T.__sizeof__()）。
 2026-09-30 21:16:48 +08:00
TermiNexus 83baf5a4b6 fix(TypeGenResolve/ExprGenName): 指针类型实参统一为 T*，消泛型特化名分裂（假报错 CastError） 
用户定口径：t.CPtr[T] / rawptr[T] / T|t.CPtr ≡ T*（与 TPC 侧
SymbolUtils.ResolveTypeArgStr+AddPointerLayers 逐字同形，两侧必须同票名）。

- _norm_type_arg_name：联合一侧为裸 CPtr 标记 ⇒ 折成 <另一侧>*；单实参的
  指针标记容器 rawptr[T]/t.CPtr[T] ⇒ 折成 <实参>*（新增 _is_ptr_marker_text /
  _ptr_star_text；刻意只认 CPtr 一族，与类型域 _is_cptr_marker 同判据，
  避免名字说 T*、类型说 T 的不一致）
- _parse_type_string：能反解析尾随 '*'（按层包回 rawptr[...]，供 ClassGenGeneric
  克隆注解时替换实参文本）
- ExprGenName._list_elem_obj_ty_from_struct_name：元素段剥尾随 '*' 后再查结构体
  （否则对象元素还原失败、静默退回 Ptr(i8) 丢元素类名）

现场：Test/AstTest/App/main.vp:63 classify_list(ifn.orelse, ...) 源
list[rawptr[<sha>.AST]] vs 目标 list[<sha>.AST|t.CPtr] ⇒ 严格指针规则按
「不同非基本类型」拒绝（假报错）；改后同票名 ⇒ 同一结构体。

注意：特化名进结构体名与方法符号名 ⇒ 必须全量重编 includes
（--clean --rebuild-includes --clear-cache）。
 2026-09-30 20:19:42 +08:00
TermiNexus 2a798dd643 fix(类型转换): int→i1 目标改为真值归一化 != 0，不再 trunc 取最低位 
类别：a（编译器缺陷）。`b: bool = f()`（f 运行时返回偶数非零，如 2）此前经
coerce_to_type 的窄化分支走 trunc ⇒ 最低位 0 ⇒ false，而同一值在 `if 2:` /
`bool(2)`（icmp ne 0）为真 —— 两处判据相反（静默语义分裂）。

- ExprGenBase.coerce_to_type：整数窄化分支前先判目标位宽 == 1 ⇒ `icmp ne x, 0`
  （C 6.3.1.2 的 _Bool 转换语义）。归一化不丢位，故对 i1 目标不再适用下方
  「窄化截断溢出」常量诊断（先返回）——`b: bool = 2` 由编译期 OverflowError
  变为正确的 true。
- CallGenCtor._translate_t_type_cast：显式 `t.CBool(x)` 与隐式落存储同一判据。

判据与 bool(x)（CallGenDispatch.vp:255-281）、条件归一化（AsyncGenMixin.vp:1611
_normalize_cond）、and/or 操作数三处统一。App/ 与 includes/ 全量检索未见
`: bool = …(& | >> | // | |)` 位提取写法，既有代码无依赖 trunc 取最低位的点。

生效需重新自举 TransPyV.exe（并清缓存）。
 2026-09-30 15:14:32 +08:00
TermiNexus aa52cf157d revert(transpyv): 回滚跨模块链表 Next 改访问器（改由编译器沿继承链解析字段名） 
回滚 13080f6 的 110 处访问器调用，恢复裸字段访问 `x.Next`。

理由：该批访问器是把访问移到定义模块内执行，**绕开**了"继承字段名解析"，
属于规避而非修复；缺陷本体在 TPC 侧（导入侧继承展平把泛型基类的继承字段
记成 __inherited_N 占位名，名字丢失）。TPC 已按语义修正：
  · e6451a07 继承展平沿继承链取真实字段名（泛型特化回退模板名），
    展平表直接落 `[("Next", <槽位类型>), ...]`，属性访问是普通表命中；
  · 3ca46c01 顺带修掉 _get_or_create_struct 里"同名枚举成员遮蔽类定义"的 i32 出口。
因此源码侧恢复为唯一写法（裸字段访问），由编译器负责解析。

注：本 commit 只回滚访问器；13080f6 里夹带的 CallGenProp.vp 续行合并（非访问器改动）
已在工作区保留（未提交）。
 2026-09-28 21:48:53 +08:00
TermiNexus 13080f646f fix(transpyv): 跨模块链表 Next 字段改用访问器（消除 __inherited_N 占位名 fail-fast） 
c 源码违规：llvmlite 的 Value/ParamNode/Function/Param/GlobalVariable/PhiIncoming/
SwitchCase 的 Next 继承自泛型基类 GSListNode[T]，而其泛型特化体不在任何 .vpi 中
⇒ 导入侧 class_members 只有 __inherited_N 占位名；严格属性解析（回退已移除）下
裸写 `x.Next` fail-fast。现场：CallGenCall.vp `cur_fb = cur_fb.Next` 报
"[fast-fail] 属性 Next 在类 ParamNode 中找不到（class_members=[__inherited_0, Ty]）"。

按仓库既有约定（_Type.md：链表遍历用 paramnode_get_next/paramnode_set_next；
VarGenMixin/TypeSpec/StructGenMixin/VpiReader 等已如此书写）统一改为访问器：
  value_get_next/value_set_next、paramnode_get_next/paramnode_set_next、
  function_get_next、param_get_next、globalvariable_get_next、
  phiincoming_set_next、switchcase_set_next
覆盖 24 个文件共 110 处（含 CallGenProp.vp:122 的嵌套读 cur_arg_pc.Next）。

访问器在 includes 侧为定义模块内直通实现（None 守卫 + x.Next），语义等价、零行为
变化。已全量扫描 core\Gen 全 47 文件与 Stub/Phase/core/main：App 侧已无裸继承字段
访问（剩余 .Next 命中全部在注释里）。
 2026-09-28 21:20:58 +08:00
TermiNexus 825fe6d326 fix(TransPyV): 指针 cast 的跨层 idiom 修正：(str | t.CPtr)(x) → rawptr(x) 
c 类（源码违规）：(str | t.CPtr)(x) 按既定语义 = i8**（char**，指针的指针），

而这些位置要的是 i8*。TPC 的 return/赋值检查现在按声明精确校验（本次即

TypeGenResolve.vp:1221 `return (str | t.CPtr)(v)` 声明返回 i8* 却 return i8** 被抳下），

该 idiom 在旧的无条件 bitcast 下一直不可见。

改法：86 处 (str | t.CPtr)(X) → rawptr(X)（rawptr 是 t.CPtr 的内置名，同为 i8*；

整数操作数走 inttoptr，指针操作数走 bitcast）。不用 str(X)：整数操作数会编译成 itoa

（Gen/FuncGenMixin.vp:1159 注释已记录该陷阱），精确类型仍由使用处的 `: str` 标注承担。

保留 4 处本就该是 i8** 的用例（未改）：Converter.vp:820（_g_pyi_cdef_names 声明为

str | t.CPtr 的指针数组）、CallGenCBuiltin.vp:1194/1215（声明即 str | t.CPtr）、

1411（先 cast 再 [0] 取首元素）。

另：Gen/Type/TypeGenResolve.vp:1221 手工改为 return t.CPtr(v)（该文件含你的未提交改动，未一并提交）。
 2026-09-28 18:43:59 +08:00
TermiNexus d579d70113 fix(TransPyV): 修正形参/字段链节点的注解为 llvmlite.ParamNode* 
c 类（源码违规）：这些变量由 new_param_node 构造、或取自 get_struct_fields /

param_list_append / function_get_param_head，实际是 llvmlite.ParamNode 链节点，

注解却写成 llvmlite.Function*。旧的无条件指针 bitcast 掩盖了该错误，严格指针规则下暴露。

涉及：VarGenMixin / CallGenVt / VpiReader / ClassGenEnum / ClassGenVTable /

ExprGenName / FuncGenMixin / FuncGenDef / TypeGenResolve / TypeSpec /

StmtGenCifMixin / AssignGenMixin（纯注解替换，零语义变化）。15 行。
 2026-09-28 17:54:13 +08:00
TermiNexus eb1065f387 fix(CallGen): Function 的 Param 形参链与 llvmlite.Func 的 ParamNode 构造链不可互传（Vipeye 329/401/1065） 
① 新增 CallGenBase._FuncTyFromFunction(pool, f_ref)：Function.Params 是 Param 链（__function.vp），LLVMType.Func 的类型构造链是 ParamNode 链（__types.vp，new_param_node/paramnode_set_next），两者是不相关 class ⇒ 严格指针规则下 Func(pool, ret, p_head, cnt) 的实参传递直接报错。改为逐个 new_param_node 重建 ParamNode 链（语义等价，只取各参数类型）。CallGenCBuiltin 329/401 + ExprGenOps 878（第 3 处同型缺陷）三处统一走该 helper。

② CallGenCBuiltin 1065 asm-out 全局变量回退：原把 find_global_in_module 的 GlobalVariable* 直接赋给 llvmlite.Value* 变量（不相关类；且 GlobalVariable 字段序为 Name→Ty，Value 为 Ty→Name，旧无条件 bitcast 会让 .Ty 读到 Name，后续 alloca.Ty.Pointee 全是错位数据）⇒ 改走 c.Addr(模块全局) 分支同款写法 make_global_ref(pool, Name, Ty) 构造带引号的 Ptr(Ty) Value 引用，同时修掉该错位读取。
 2026-09-28 17:16:57 +08:00
TermiNexus be1acdb602 feat(cast): 放行数组退让（[N]T* → T* 单向），与 TPC 同口径 
新增 _is_array_decay（复用 is_array_type + LLVMType.Array 解构 + AssignGen._stg_ty_equal），在 _pointee_convert_reason 的非基本分支里紧接 _is_inheritance_upcast 之后调用

与 TPC 真值表一致：数组→元素指针 ALLOW、反向 DENY、多维只退一层；其余规则（通用指针/层数/完全相同/None/构造物化/标量无损/继承上转）未动
 2026-09-28 15:38:42 +08:00
TermiNexus e2c4c7645e fix(cast): 补继承上转豁免（Derived*→Base* 放行），与 TPC 同口径 
新增 _class_name_of_ptr_pointee（复用 StructGen.get_class_name_by_type）与 _is_inheritance_upcast（复用 StructGen.get_mro_chain：目标类名命中源类 MRO 链自身之后的祖先即放行，含多级）

在 _pointee_convert_reason 落入“非基本类型”分支前插入上转豁免；其余规则（通用指针通配/层数不同即禁/完全相同放行/None 任意/构造物化豁免/标量无损）未动；Base*→Derived* 与无关结构体仍禁

注：本提交顺带带入 App/main.vp 的既有版本号改动（0.0.5-dev.479，非本次会话产出）
 2026-09-28 15:29:42 +08:00
TermiNexus f03aea15c7 fix(cast): 规则③两侧对齐——聚合值↔指针也上闸，仅豁免构造物化（p: Point = Point()） 
TPV 的 coerce_to_type 两条“聚合值↔指针”路径不再无条件放行：新增 _ctor_call_agg_ty（AST 层识别构造调用，经 _value_node_of 下沉 + find_struct 取聚合类型）与 _same_agg_ty（委托 _stg_ty_equal）；非构造物化一律 fatal_error，报文前缀与 TPC 逐字一致

无损口径以本文件 _scalar_convert_reason 为真源（int↔int 全向、float↔float 全向、int→float 需目标浮点位宽≥源整数位宽、float→int 有损），未动

已知未覆盖：泛型构造（Box(42)）静态拿不到特化 struct 名 ⇒ 不豁免；部分 coerce 调用点不传 node ⇒ 可能误报（需实机确认）
 2026-09-28 15:17:37 +08:00
TermiNexus ee50ce61fe feat(cast): 指针隐式转换按“同级+被指类型无损”判定（通用指针 t.CPtr/i8* 通配），并修诊断错位 
_ptr_cast_reason 统一判据：层数不同→禁；完全相同类型→放行；任一侧通用指针(i8*/t.CPtr)→放行；否则按被指类型：非基本类型→禁，基本标量按既有无损规则（int↔int、float↔float、int→float 需目标浮点位宽≥源整数位宽、float→int 有损）

4 处禁令与新增的“指针→指针”处统一走 _value_node_of/_cast_fail_where：外层 Assign(kind=3) 下沉到真正被转换的值节点；列号按有符号打印（-1/未知打 -，不再出现 4294967295）；附源码片段

未动“聚合值↔指针”那条路径（构造返回指针 load 回结构体，如 p: Point = Point()）：LLVM 层无法与真实 Foo*→Foo 区分，禁止会直接编不过；规则③在该轴上的收紧待 AST 层区分构造调用后另做
 2026-09-28 15:10:30 +08:00
TermiNexus 59a9fc5b1f fix(cast): None 允许隐式转换为任意类型（修 p.fd_used[fd] = None 被“指针隐式转整数已禁止”拦下） 
coerce_to_type 顶部新增单一短路判据 IsNoneValue(val, node)：AST 为 CONST_NONE，或已物化的 null 常量（实机报错里 node 是外层 Assign kind=3、col=-1，拿不到 None 字面量节点，故以值判定为主）

指针目标保持既有 bitcast 形态（与 T* x = None 初始化一致）；非指针目标按目标类型物化零值：整数 0 / 浮点 0.0 / 聚合与其余用 ConstZero

覆盖范围：App/** 下真正 fatal 的指针/整数禁令只有 coerce_to_type 内 4 处，均在短路之后；CallGenDispatch/ExprGenAttr/CallGenLib 等命中都是注释或不报错的原样返回，无遗漏

未动指针层级/被指类型的转换规则（待确认后另行实现）
 2026-09-28 14:59:31 +08:00
TermiNexus 0279965074 fix(codegen): 指针强转基座 T*(x) 的字段读写补按需过滤类名通道 
(ast.Call*(vinner)).IsVolatile 报属性写入失败：T*(x) 被 parser 的 _consume_ptr_suffix_call 解析成 (T | t.CPtr)(x) 强转调用，结果类型是联合简化后的 i8*，lookup_field(i8,...) 必失败，而按需过滤的类名提取只认 Name/Attribute。新增 _base_class_from_cast_base：从强转注解（func 是 BitOr 联合）取裸类名，读路径、写路径、属性链递归父节点三处接入。取裸名而非模块限定名——lookup_field_by_class 的模块限定分支对「包名可解析、类注册在子模块」的形态会 fail-fast。
 2026-09-27 16:02:04 +08:00
TermiNexus beccb36b66 feat(codegen): 单目 & 支持对构造调用/函数调用结果取址 
&ViperKernel() 此前被左值检查拒绝（只在 Name/Attribute/Subscript 放行）。构造调用 _translate_struct_ctor 返回的就是入口 alloca 的栈存储指针，取址即原样返回该指针；其它返回值落到入口临时槽 alloca+store。复用 translate_unaryop 已求值结果，避免构造被求值两遍（__before_init__/__init__ 跑两次）。
 2026-09-27 15:15:59 +08:00
TermiNexus 4255ab9d32 fix(fstr): f-string 改回每站点栈缓冲 + 禁止逃逸，逃逸点改 stdlib 拷贝 
ExprGenFstr._fstr_finalize：结果缓冲改回每站点栈 alloca（线程安全、零运行时依赖；每站点各建一个，站点之间不再共享），docstring 与文件头写明语义：f-string 结果是当前函数内的临时值。

GenApi 新增唯一判据 fail_if_fstring_escape 与唯一拷贝出口 escape_fstring_copy（stdlib.malloc + string.strcpy）；逃逸位置接护栏：translate_return（函数返回值）、translate_assign（字段/元素/全局变量赋值）、handle_module_level_var（模块级 AnnAssign 初始化）。

编译器自身 7 处逃逸点（ExprGenBase._cast_fail_where 6 处、AssignGenMixin.const_assign_msg 1 处）改为 escape_fstring_copy 显式拷贝——正是造成 ASan stack-buffer-underflow in vsnprintf 的那条路径。

残留（已在 GenApi 头注释诚实记录）：间接逃逸（把 f-string 传进会保存它的函数、或放进容器后带走容器）静态判不出；类字段默认值路径未接护栏。全仓自查：TransPyV/App、includes、ViperApps 均无 容器/字段/全局 存 f-string 的写法，也无残留 return f-string。
 2026-09-27 14:45:28 +08:00
TermiNexus 72a3c483e4 fix(fstr): f-string 结果缓冲改为模块级全局，修 return f-string 的悬空栈指针 
现象：--asan 下 ASan stack-buffer-underflow（READ size 1，地址落在栈左红区）in vsnprintf，栈为 ExprGenBase.coerce_to_type:409 的 f-string 报文；非 asan 构建表现为随机乱码或 0xC0000005。

根因：_fstr_finalize 用 _alloca_at_entry 在当前函数开一个 [FSTR_BUF_SIZE x i8] 栈缓冲并返回其指针；而 f-string 结果在全仓被大量 return 带出函数（ExprGenBase._cast_fail_where、AssignGenMixin.const_assign_msg、CallGenLib 报文构造等），返回后再作 %s 喂给 snprintf 即读已弹栈的帧；且同一函数内多个 f-string 共用同一个 entry alloca 会互相覆盖。

修法：结果缓冲改为每个 f-string 站点一个模块级可写全局 internal unnamed_addr global [N x i8] zeroinitializer，经 bitcast 取 i8*（与 ExprGenConst.create_global_string 同一构造路径，符号链接期解析）。被否决的中间方案记录在注释里：编译期池缓冲 + inttoptr 常量地址会把编译进程的宿主地址烘进 .ll，对产出程序无效，绝不可用。

已知取舍（注释中写明，与 C 的 static char buf[N] 惯用法同）：同一站点反复求值且同时保留多个结果时后者覆盖前者；多线程避免共享同一站点结果。彻底消除需运行时字符串分配器（当前无）。
 2026-09-27 14:33:54 +08:00
TermiNexus 12bd7b7a16 fix(gen): 收敛 static 跨模块拦截为独立方法，消除类型推断污染 
新增五个独立方法承载 static 检查与登记：_CheckStaticCrossModule（mod.name 取值）、_CheckStaticCallCrossModule（mod.fn 调用）、_CheckStaticFromImport（from-import）、_RegisterStaticModuleVar（模块级变量登记）、_RegisterStaticFunc（函数登记）。调用点只保留一行调用——内联新增分支会改变超大函数的类型推断，曾导致 translate_attribute 后续 match obj_ptr.Ty 报指针隐式转整数已禁止。

删除 _resolve_module_attribute_global 内与入口检查重复的 static 拦截（其两个调用点均在 _CheckStaticCrossModule 之后）。
 2026-09-27 13:12:22 +08:00
TermiNexus dd56580855 feat(gen,static): static 符号禁止跨模块使用（定义侧登记 + 引用侧三处拦截） 
语义 = C 的 internal linkage：static 符号（函数/变量）只在定义模块内可见，任何跨模块引用一律 fail-fast（NameError）。

- 登记表：CallGenBase 新增 StaticSha1Arr/StaticNameArr/StaticCount（PermPool 定长槽，与 CexportSha1Arr 同款）+ RegisterStaticSymbol/IsStaticSymbol（按 (符号名, 模块 SHA1) 精确配对，避免跨模块同名误判）。

- 定义侧登记：FuncGenDef 识别注解形态（-> t.CVoid | t.CStatic）与装饰器形态（@t.CStatic；裸 static def 已由解析层归一为装饰器）→ 登记函数名；TranslatorGenMixin.handle_module_level_var 识别注解形态（static x: int 已归一为 t.CStatic | int）→ 登记变量名。

- 引用侧拦截（三处，覆盖全部跨模块形态）：ExprGenAttr.translate_attribute 入口统一拦截 mod.name（含 import 别名还原）；CallGenMixin.translate_call 入口拦截 mod.fn(...) 调用（按 AST 形态一次覆盖 found_func/vpi/裸名兜底各分支）；ImportsGenMixin.translate_import_from_names 拦截 from mod import name。

- 性能：三处检查均以 StaticCount > 0 快速短路——项目中无 static 符号时零开销（不触碰逐条线性扫描与 sha1 解析）。

- 同模块自引用（sha1 相同）与非模块基座（self.method / obj.field / Class.static_method）一律放行。
 2026-09-27 12:58:51 +08:00
TermiNexus 7d28c9649e feat(gen,err): CastError 定位到出错表达式；vpi 生成 fail-fast；函数属性接受直接形态 
- ExprGenBase：新增 _cast_fail_where，指针/整数隐式转换失败时打印出错表达式与列号（多实参调用可定位到具体实参，如 Name 'toggle_ptr'）

- Converter：import / from-import 别名列表为空、Alias 指针为空、name 为空分别 fail-fast，不再写出 import ,  这类残缺 vpi 行（该残缺会让包重导出注册失效，报出与根因无关的 NameError）

- FuncGenBase.extract_func_attrs：接受直接 @t.attr.<name> 装饰器形态（与类侧 _has_decorator 同口径），使 inline def 在无 import c 的文件里也生效

- 附：CallGenDispatch 内保留一处临时 [MDISP] 探针（MpoolOopTest pool.alloc 定位用）
 2026-09-27 11:41:11 +08:00
TermiNexus 373a20c3e5 perf(prof,gen): 编译热点优化 + 内存池 OOM 诊断接线 + REnum 指针载荷修正 
CallGenBase: 模块返回类型文本表改单趟登记+查找，find_func_in_module 合并为单趟链表遍历（PROF 热点）

BuildPipeline: ensure_dir 增加快速路径（已存在目录直接返回）

AssignGenMixin/Translator: alloc 失败打印 Pool/PermPool 统计与阶段上下文（SetAllocCtx）

CallGenCtor: REnum 指针载荷补显式 build_ptrtoint 再 coerce/store；新增 DebugInfoGen.vp

其余为历史累积改动一并入库
 2026-09-26 19:27:23 +08:00
TermiNexus a7af34bd7e 修正了部分代码的表达方式，最后可用版本，mlirlite 已基本完善 2026-09-23 17:41:49 +08:00
TermiNexus 951b89be36 修正了部分代码的表达方式，最后可用版本，正在为 mlirlite 做准备 2026-09-23 16:09:32 +08:00
TermiNexus a5ceb3d4eb 增加 JIT REPL 2026-09-21 16:17:19 +08:00
TermiNexus 9910e05760 修复了一些错误，更改了一点语法 2026-09-18 20:00:40 +08:00
TermiNexus 9e2ccbfab7 将部分 | t.CPtr 修正为 rawptr[T] 2026-09-18 17:56:24 +08:00
TermiNexus cb0836de8a 清理了 t.CVoid 2026-09-16 16:06:48 +08:00
TermiNexus 9a191daa8d 错拼 rowptr 改为 rawptr 2026-09-16 11:42:28 +08:00
TermiNexus 7cba4cbc95 chore: 清理超长历史注释，并一并提交并行会话的代码改动 
注释清理（65 文件 / 约 -2578 行 / 约 516 处）：删除/压缩叙述式历史注释——多行根因叙事、工作代号段（D25/D30/N11/B5/S4/阶段E 等）、改前改后与先例叙述、逐条推导块，压成一行讲清作用信息；契约类注释（用途、参数与返回、关键约束与不变量、IR 结构说明）与被注释掉的代码一律保留

存疑 标记 6 处一字未动：StubMergerStore.vp、VpiReader.vp、VLogger.vp、AssignGenMixin.vp、CallGenLib.vp、CallGenLeafKit.vp

本次一并带入并行会话的代码改动（同批文件，按文件粒度无法拆分）：fileio.File -> rowptr[fileio.File] 等

已知副作用/残留：① CallGenDispatch.vp 有 2 行非注释行的行尾被 LF->CRLF 规范化（纯字节变化，无文本改动）；② core/Gen 区约 24 处压缩因并行会话整文件覆写被写回原样，尚未生效（StmtGenCifMixin/ClassGenVTable/FuncGenDef/ClassGenEnum/StructGenMixin/TypeSpec 等）

清单与复跑判据见 Debugger/comment_cleanup_summary.md（该目录不受版本控制）
 2026-09-16 11:27:05 +08:00
TermiNexus 813f0157e3 fix(Gen/Expr): 类名不再被当模块级全局变量制造引用，消除 ASan 构建 undefined symbol 
ExprGenAttr._resolve_module_attribute_global 在未命中已注入全局时会新建 @<sha>.ClassName = external global i8* 并 load；该 load 无使用者，非 ASan 构建被 llc 删除，ASan 插桩后其全局地址参与 shadow 检查无法删除 => ld.lld: undefined symbol 481fd55266ff1187.LLVMType (.refptr)。若属性名是已注册类/结构体/REnum(StructGen.find_struct 命中)则直接返回 None，交给类/REnum 路径。
 2026-09-15 20:47:15 +08:00
TermiNexus 8312e653e8 fix(CodeGen): 裸结构体形参按 C ABI 按值、修正 |t.CPtr 指针层级，对齐 TPC 并消除签名发散 
- FuncGenDef/VpiReader._AggregateParamTy: C ABI 外部声明(t.CExtern/t.State)的裸结构体形参按值 %Struct(可取完整定义时)，真 opaque 降级 i64；TPV 内部函数/方法维持 Ptr(struct)。三处(定义侧/函数注入侧/方法注入侧)同口径

- TypeGenResolve/VpiReader: BinOp(A|t.CPtr) 的指针别名守卫改为 pointee 为已注册 struct 才吸收，否则追加一层 => VOIDPTR|t.CPtr 由 i8* 修正为 i8**(对齐 TPC)

- 效果: SetConsoleScreenBufferSize 等 6 个符号由 i64/%COORD* 双形态收敛为按值，同符号多形态数 193->186
 2026-09-15 20:47:14 +08:00
TermiNexus 31df298341 fix(gen): 修 REnum match case 静默丢弃与 CDefine 负 64 位常量截断，补 void 注解放行、移植类型定义前移 
- MatchGenMixin: 2a 路径查变体 tag 改用裸类名(注解书写形态带模块前缀，与变体表裸名注册口径不一致致 tag=-1、case 被静默丢弃、match 全走 default)，并在 build_switch 前硬校验 应提交 case 数==sw_count，不再静默丢

- ExprGenCdef: _const_int_for_cdefine 补 value < -2147483648 下限判据，修正 (0xA5A5A5A5<<32)|0xA5A5A5A5 等负 64 位模式被物化为 i32(写入 inttoptr 零扩展 vs 比较 sext 不一致，致 MemBuddy canary 假阳性 rc=6)

- FuncGenDef/ClassGenVTable: 掉尾检查新增注解级 void 判据(t.CVoid/裸名 CVoid/None)，不再因 REnum match 退化误判 void 函数缺 return

- StubMergerBuild: 移植 TPC 的 类型定义前移 遍，满足 llc 对 by-value 具名类型需先定义的要求(invalid type for function argument)

- main.vp/Phase1Main.vp/project.vpj: 新增 --detection-deep 深诊断开关与 canary 哨兵、ASan 静态库声明
 2026-09-15 19:11:54 +08:00
TermiNexus 51daf28297 fix(expr): 三元表达式 else 分支按 then 的指针类型下传目标类型 
VpiReader.vp:1963 的 rel_path_rt if rel_path_rt is not None else 单字符问号 触发 CastError（探针 kind=35 IfExp、val.Ty=i32、target_ty=i8*）。根因并非跨模块函数返回类型未解析：then 分支 rel_path_rt 已是 i8*（解析成功，赋值处与已有 fail-fast 均未触发，三条独立证据）；真正的整数来自 else 分支——单引号单字符字面量在词法层被判定为 CONST_CHAR，而 translate_ifexp 翻译 else 时未下传目标类型上下文，遂物化为 i32（63），随后在类型对齐阶段被按 then 的指针类型 coerce，撞上整数隐式转指针的 fail-fast。

改为：仅当 then 分支是指针时，把其类型作为 else 的 target_ty 下传；单字符字面量随即走 ExprGenConst 的指针目标分支物化为 1 字符字符串（对齐 TPC 的引号推断），两分支同为 i8*，不再进入 coerce。非指针 then 不下传，既有常量物化与位宽行为逐字节不变（如 base64.vp 中 then 为 char 的两处不受影响）。

另经核查：模块级函数返回类型并无静默默认 i32 的问题——「依赖已就绪却解析不到」已是 fail-fast（CallGenMixin 跨模块函数路径与方法侧 _fail_method_ret_ty 同构），保留 i32 的仅是多遍收敛中间态的占位，故本次不动。
 2026-09-14 19:26:46 +08:00
TermiNexus a46391bf42 fix(expr): coerce_to_type 拓宽方向判定改传 builder.Pool，修正未定义实参 pool 
coerce_to_type 作用域内并无 pool（其参数是 builder），L425 却把 pool 作为第 1 个实参传给 _zext_or_sext_val。此前该实参翻译失败会被静默按类型零值兜底，使传给 ExprGenOps.should_zext_widen 的池为空、变量注解符号性判定失效，从而在无符号拓宽时错走 sext（即该处注释所述的无符号扩展缺陷根因）。

改为传 builder.Pool（与同函数内 llvmlite.const_int64(builder.Pool, 0) 等一致，是共同值所处的池）。该未定义实参由本会话新增的「实参翻译失败即 fail-fast」规则暴露。
 2026-09-14 15:48:09 +08:00
TermiNexus ea2abba574 refactor(tpv): 删除 _deps_pending 置位面与 Phase A pending 多遍收敛机制 
69 个工程成功编译且 _phaseA_pending.log 恒 0 字节，证实 14 个置位点全部零命中。删除 14 个 _MarkDepsPending 调用点（原「依赖未就绪」分支保留默认类型或原报错路径）；删除 _MarkDepsPending 与 _AppendPhaseAPending 及 _phaseA_pending.log 读写；删除 Phase A 出口「pending 则不写盘、回滚 MethodsEmitted、continue」整段；删除 _deps_pending 与 _pf_dbg_pend_flagged 字段及全部读取分支；清理遗留探针 [PF-DBG] 与 [METHDBG]。16 files changed, +37 / -558
 2026-09-12 19:24:52 +08:00
TermiNexus 967095df5b refactor(tpv): _deps_pending 置位收敛到唯一入口 _MarkDepsPending（S4 第一步） 
- CallGenBase 新增 _MarkDepsPending(trans,kind,cls,method,dep,extra)：一处实现「置标志 + 统一格式 [DEPDBG] + 持久化 _phaseA_pending.log」三连

- 14 处置位点（D7-1 清单：attr_read/attr_write/method_ret/mro_ret/mro_anc/special_ret/prop_ret/dispatch_ret/dispatch_sp/func_ret/func_mangled/global_stub/class_parent/class_field_ty）全部改经该入口

- 行为不变；DEPDBG 行格式统一为 pending(<kind>): mod=.. cls=.. method=.. dep=.. extra=..，供下一步按 kind 统计命中数、删除死点
 2026-09-12 13:53:20 +08:00
TermiNexus 82eea2719f refactor(tpv): rowptr[T] 迁移 + D 表定长缓冲改精确分配 + SHA1 前缀判定收敛（D1/D3/D4/D5/D6/D7/C10） 2026-09-12 11:09:35 +08:00
TermiNexus 679758c05b refactor(tpv): 删无符号判定的旧字符串兜底，真源唯一（S4 去字符串化收尾） 
删 _type_name_unsigned_legacy / _annot_str_unsigned_scan / _annot_str_unsigned_legacy / _last_dot_tail / _is_simple_ident；_type_name_unsigned 与 _annot_str_unsigned 变为真源唯一（spec_sign_of_annot）。

依据：真源已含顶层 | 分段、去括号/空白、IDENT[INNER] 取元素、去模块前缀、精确名白名单、CTypedef 链展开，旧路径能力是它的真子集（S2 已把旧路径修到与真源一致），差异面就是假阳性区 —— strstr 子串扫描正是 A4/A5 根因（BYTEPTR 含 BYTE、任何含 uint32 的 mangled 名都被判无符号）。现语义：真源 UNKNOWN=不表态 => 返回 0；若日后发现漏判，补白名单/补 CTypedef，不恢复子串扫描。
 2026-09-12 10:26:51 +08:00
TermiNexus 19fca19ca7 refactor(tpv): get_llvm_type_bits 双副本收敛到 TSpec.SpecTypeBits 
TypeSpec 新增 SpecTypeBits 作为「LLVMType → 整数位宽」块的唯一实现（对齐 SpecTypePtrLevel 的收拢先例）；ExprGenBase/TypeGenErr 两份同码副本改为委托，TypeGenErr 补 TypeSpec 导入（无环）。

保留方法名与 self. 调用点：@t.NoVTable 静态绑定下 Mixin 内部大量 self.get_llvm_type_bits 依赖其存在，只换实现体不动签名。副本分叉会导致同一类型两处算出不同位宽的隐蔽不一致。
 2026-09-11 23:14:51 +08:00
TermiNexus a4bc5dc0ce refactor(tpv): 删除 IsPtrElement 字段，指针元素语义承载于 Spec.ElemBits 
- TypeSpec 抽 _spec_clone（消除 SpecWithSign/Source/ElemBits 三处重复逐字段拷贝）
- 新增 SpecWithElemBits：覆盖元素槽位宽（独立副本不驻留，ElemBits 不在驻留键内）
- set_var_ptr_element 改写 Spec.ElemBits=64；Spec 不可承载（非指针/缺失）即 fail-fast
- 新增 var_is_ptr_element（PtrLevel>=1 且 Elem.Bits==8 且 ElemBits==64，排除真实 i64* 与纯 str）
- ExprGenName 4 处下标读写切读该入口；GenTypes 删 VarEntry.IsPtrElement
 2026-09-11 22:09:18 +08:00
TermiNexus 95133d8483 refactor(tpv): 变量/字段注解类名读取统一走 Spec.SourceName 封装 
- VarGenMixin 新增 var_annot_class_name（SourceName 优先，回退 AnnotClassName）
- 变量侧类名恢复与诊断读取切读：ExprGenAttr(5) / ExprGenOps(6) / ExprGenName(1)
  / CallGenDispatch(3) / CallGenCall / CallGenProp / CallGenVt / ExprGenCls / AssignGenMixin / MatchGenMixin
- ExprGenAttr 字段侧直读改走 get_field_annot_class_name
 2026-09-11 22:02:28 +08:00
TermiNexus 7028399366 refactor(tpv): 无符号判定切读 Spec（条目级 TS_UINT 优先） 
- 新增 _entry_spec_unsigned：Spec.Kind==TS_UINT 为注解明确无符号的强信号
- _node_type_unsigned 的 Name/Subscript 分支、Attribute 字段分支切读 Spec 优先
- 只切无符号方向（TS_INT 含未表态，不可反推 SIGNED，仍走字符串真源）
 2026-09-11 21:51:11 +08:00
TermiNexus f0deff931d refactor(tpv): S3 无符号判定切读真源，指针层级收拢到 TypeSpec 
- ExprGenOps: _type_name_unsigned / _annot_str_unsigned 改为真源优先（UNSIGNED->1 / SIGNED->0），仅真源不表态 UNKNOWN 时按需回退旧子串路径（热路径避免双份开销）
- ExprGenOps: 删除 S2 的双写一致性闸门 _spec_sign_check（切读后读即取真源，比对恒等、无意义）
- TypeSpec: 新增 SpecTypePtrLevel -- 指针层级推导的唯一实现，原 get_ptr_level 记录的 match codegen 缺陷规避写法随实现移入
- ExprGenBase: get_ptr_level 删去同码副本，改为委托 TSpec.SpecTypePtrLevel（行为等价）
- TypeGenCType: spec_sign_of_annot 注释更新为无符号判定的读入口
- 注: 值级切读（读 Spec.PtrLevel）仍需条目双写（VarEntry.Spec / FieldEntry.Spec 等）接线，S2 路线 C 未做，留待下一步
 2026-09-11 20:40:26 +08:00
TermiNexus b7100e9dc1 feat(tpv): S2 落无符号判定双写闸门，并修 i8 拓宽丢符号与 WCHARPTR 旧判 
- TypeSpec: 新增 SpecFromLLVMType（LLVM 类型 -> TypeSpec 结构转换器，当前无调用点）；SpecSignFromTypeName 拆出零分配切片版 Span
- TypeGenCType: 新增 lookup_ctypedef_span 与独立符号性真源 spec_sign_of_annot（精确名白名单 + CTypedef 链逐层展开）
- ExprGenOps: 旧判定改名 *_legacy，外层加双写闸门 _spec_sign_check（新真源明确表态且不一致即 fatal；S2 不切读）
- ExprGenOps: 修旧符号性两个洞 -- 子串表补 WORD、裸别名沿 CTypedef 链展开（闸门实测暴露 WCHARPTR 旧判 signed、新真源 unsigned）
- ExprGenOps: should_zext_widen 的 i8 分支补「源注解明确有符号则 sext」例外，修 b8470c1 引入的 TypeCastTest 回归（t.CInt32T(v) 丢符号）；新增 _node_type_signed
- TypeGenBase: 补 import lib.core.Gen.Type.TypeSpec（此前遗漏）并接入驻留表 ensure_spec_arena（PermPool 惰性创建）
- 修两条链接错误: TypeSpec.vp 残留 stdlib.atoi 改 string.atoi；模块别名与模块内类名同名会被误解析为该类静态方法（隐式补 self 实参），四处导入别名统一改 TSpec
 2026-09-11 20:32:55 +08:00
TermiNexus b8470c1cae fix(tpv): 拓宽方向统一为单一真源，并修 TypeStr 变参与 should_zext_widen 缺参 
三项独立缺陷（均来自类型系统盘点 _Type.md D7）：

1) should_zext_widen 签名缺 trans 形参，函数体内的 trans 退化为隐式全局（恒
   None），而 translate_binop 两处调用早已在传第 5 实参（被静默丢弃）⇒ 注释所
   述「源无符号 → zext」补救从未生效：Name/Subscript 形态的无符号源（uint16/
   uint32 变量、数组元素）在比较/二元路径恒被 sext 扩展（ide.vp/timer.vp 根因）。
   修：should_zext_widen 补 trans 形参并明确为拓宽方向的单一真源；
   translate_compare 两处补传 trans；ExprGenBase._zext_or_sext_val 改为委托
   should_zext_widen（wide_val=None 使「宽侧常量」启发式自然失效）。

2) _translate_t_type_cast 原以「目标类型名符号性」决策整数拓宽，且 target_name
   未知时默认 zext，与 coerce_to_type / should_zext_widen 的默认 sext 极性相反。
   修：统一由源的符号性决定（与 coerce 同源），并删除已无使用点的 target_name
   形参（1 处签名 + 7 处调用点）。

3) TypeStr 生成（FuncEntry.TypeStr 的唯一生产者）与其现算现用副本
   （ClassGenVTable._format_func_type_str）都未打印变参后缀 ...，而 FuncGenDef
   对 *args 会设 IsVarArg=1，且继承方法强制走 TypeStr 回退 ⇒ vtable 中的函数
   指针类型与真实签名不符。修：按 llvmlite IR 打印规则补齐（有参 ", ..."，
   无参 "..."）。
 2026-09-11 19:57:18 +08:00
TermiNexus cfb92e5da5 初步清理 t. 类型异味 2026-09-11 18:36:32 +08:00
TermiNexus d3690f9143 fix(tpv): 依赖注入期默认参数按定义模块 SHA1 登记，消除跨模块同名函数串味 
N17：VpiReader 注入函数/方法 declare 时显式传入 src_sha1（被依赖模块自身
sha1），add_func_to_table 透传至 _register_global_defaults；调用点默认值查找
改用 find_func_entry_in_table_owned 按 "{owner_sha1}." 前缀限定。修复
usb.uhci.init 误命中 mm.init 的 5 形参/2 默认值而凭空补 2 个 i32 0 的 ABI
错位（IR 实证：call @...init(i16 %4, i32 0, i32 0) → (i16 %4)）。

同轮并入的其他编译器侧改动：
- N11 Converter.vp：无 -> 但带 @c.CReturn 时合成 tuple 返回注解，与 define 对齐
- N12 VpiReader.vp：union 指针（T | t.CPtr）stub 解析与定义侧收敛到 i8*
- N14 ExprGenFstr.vp：f-string 32 位整型不再写 l 修饰符
- N2 撤回 ExprGenOps.vp：删除在 _node_type_unsigned 热点查/填 vpi 缓存的
  _call_ret_annot_unsigned（有副作用，触发 fat32_diskio.vp match 路径崩溃）
 2026-09-11 17:39:21 +08:00
TermiNexus e66d9e3adb fix(tpv): 修 N 系列 codegen 缺陷（常量位宽/无符号判定/实参扩宽/结构体取址） 
- N1 ExprGenConst/CallGenDispatch: CONST_INT 按 target_ty 位宽物化, 修 uint64(0xFFFFFFFFFFFFFFFF) 被降 i32 再 zext

- N2 ExprGenOps: 新增 _call_ret_annot_unsigned 查被调方 vpi 返回注解, 修 uint32 返回值 >> 生成 ashr

- N3 TypeGenResolve: 联合注解提取跳过存储类限定宏, 修模块级全局 uint32 比较生成 sge/slt

- N5 CallGenLib: 常量实参按形参扩宽 + _coerce_args_to_def_params 支持 3 段方法调用

- N17 CallGenLeafKit/CallGenMixin: 默认值表按定义模块 sha1 限定 + 收紧交叉校验守卫

- N18 ExprGenBase/CallGenLib: rvalue 结构体实参落栈取址
 2026-09-11 15:50:09 +08:00
TermiNexus e20a6f3d11 fix(tpv): 修 VKernel 暴露的 codegen 缺陷（浮点 CDefine/__sizeof__ packed/CONST_STR/alloca/无符号/ABI） 
- 浮点 t.CDefine 初值序列化与源恢复（gfx PI 编成 0.0）

- __sizeof__ 按 packed 计算（cpu _tss memset 越界写 4B）

- 数组初始化器支持 CONST_STR 单字符；模块级别名不再产出 global i32 0 假全局

- 临时缓冲/构造临时量 alloca 提升至入口块（B6 未覆盖路径）

- 无符号判定补 CSizeT/小写别名/结构体字段 + udiv/urem + range 位宽与符号 + zext 扩展

- 跨模块 declare 形参按 vpi 定义侧收敛（修 _vpi_method_param_annot 拒绝 cls_name=None 导致 coerce 恒失效）
 2026-09-11 14:26:54 +08:00