GVSDS/ViperC
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
745 Commits 1 Branch 2 Tags
41674d125c722f3dcb037b22a2d4b131f180dc14
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
TermiNexus 41674d125c fix(gen): 修 vpi 生成阶段 is_file_func 读到已回收池的悬垂表（ASan 野读崩溃） 
现场：TransPyV.exe（ASan）编译 EscapeOkTest 崩在 Phase A-pre-vpi →
_GeneratePyiFromAst → _PyiFunction → compute_escape_summary → _ScanEscapes →
_PushInductionEntry → is_file_func → HashTable._slot_hash
（access-violation on unknown address 0xffffffffffffffff）。

根因（潜伏已久，非本阶段语义改动引起）：
- FileClassNames / FileFuncNames / FileVarNames / FileModuleSha1 是按文件重建的表，
  表与键共用该文件的瞬时池；契约要求跨文件/跨阶段先清空再重建
  （原写在 reset_visible_structs 里那四行）。
- Phase A-pre-vpi 为生成 vpi 会重新 lex/parse 每个文件，但不走 register_file_*、
  也不清表 → _PushInductionEntry 的 is_file_func 只认 range 的判据，落在 Phase1
  最后一个文件的表上，而那个池已被 reset_to(mark1) 回收。非 ASan 下常表现为读到
  0/旧值 的静默错答，ASan 下 0xfd 填充 → 垃圾容量/垃圾 __slots__ → 野读崩溃。

修法：
- 抽出 reset_file_name_window() 作为文件级名字窗口的唯一开启入口（原四行清空搬进去，
  reset_visible_structs 改为调它），并在注释里写死契约。
- 新增轻量 register_file_func_names(pool, tree)：只重建本文件顶层函数名（核对过 vpi
  路径只需这一张；FileClassNames/FileModuleSha1/FileVarNames 的读取点全在翻译期）。
- Phase A-pre-vpi 循环里，在 _GeneratePyiFromAst 之前调用
  reset_file_name_window() + register_file_func_names(mb, tree_vp2)。
- register_file_classes / register_file_funcs 改为无条件重建（原来 没有才建 的写法在
  表已被别的阶段建过时会静默复用悬垂表）。
 2026-10-10 09:41:15 +08:00
TermiNexus 79d1c86982 fix(gen): return 本帧存储改为声明感知 fail-fast（A2 方案 A） 
A2 原本整体移除定义端 return <本帧地址> 的 fail-fast，导致无 @life(ret(...))
声明的函数返回本帧存储时静默通过（调用点只拿到 LIFE_UNKNOWN，悬垂一路无声）。
现改为按被调者自己的 ret 声明判定：
- ret(frame) / ret(borrows=<该形参>) → 放行；
- ret(heap|static|borrows=none) → 报错（声明与返回值矛盾）；
- 无声明 → 报错（提示补 @life(ret(frame)) 或 ret(borrows=<param>)）。
落点：AssignGenMixin.check_return_frame_decl（判据复用 life_of_expr，target_ty 传
返回类型，与移除前的口径一致）；ret_kind 由 StructGenMixin.get_ret_kind_by_func
反查 EscFuncTable → EscDirTable（顶层函数/方法/嵌套 def 一次覆盖，无需猜类名），
当前 FunctionDef 取 StructGenMixin.NllCurFunc。
新检查是旧检查的严格子集 ⇒ 自举无回归。
 2026-10-10 09:16:26 +08:00
TermiNexus 6da8e2e095 feat(gen): 落地 @life(ret(...)) 返回值生命期契约（A2） 
- GenApi：新增 compute_life_anno / _RetKindFromTag 与 RET_KIND_* 编码，
  提供 get_ret_kind / get_ret_kind_method / lookup_ret_kind_via_vpi；
  _WillFreeMergeTag 不再拦截 ret（改由 compute_life_anno 收集校验）。
- StructGenMixin：EscDirTable 由 3 槽扩到 4 槽（新增 ret_kind 列），
  compute_escape_summary 把契约落在 box[5] 并登记。
- Stub：.vpi 行尾新增 escr=<ret_kind>（Converter 写、VpiReader 读 _g_vpi_esd_r）。
- AssignGenMixin.life_of_expr(Call)：@life(ret(...)) 声明优先于任何推断；
  frame/heap/static/borrows=none 直接映射，borrows=x 取对应实参生命期，
  方法调用按接收者静态类型解析类名。
- StmtGenCifMixin：同批移除定义端 return <本帧地址> 的 fail-fast，
  返回值去向改由调用点按被调者契约判定。
 2026-10-09 22:58:33 +08:00
TermiNexus 4907e64714 feat(lifetime): _g_new_life 透传——new stack/slife 的构造也算 FRAME（参与构造器同命裁剪） 
新增模块级 _g_new_life 与 _g_new_storage 同步维护（set/restore 支持嵌套 ctor），口径与 life_of_expr 的
New 分支一致：stack(含 stack slife)/slife → LIFE_FRAME；heap·memgr + 缺省/hlife → LIFE_HEAP；-1 = 未知。
_translate_struct_ctor 两份副本的 recv_life_ct 改为：裸 T() → FRAME；有 new → 取 _g_new_life。
于是 new stack S(&l) / new heap slife S(&l) 不再误报，new heap hlife S(&l) 仍报。
 2026-10-09 22:43:43 +08:00
TermiNexus 953c829e9f feat(lifetime): 构造器路径填 recv_life——裸 T() 构造（入口块 alloca）算 FRAME 
_translate_struct_ctor 两份副本都算 recv_life_ct：_g_new_storage == None（无 new 描述符提供存储）→
裸 T() 的存储是入口块 alloca → LIFE_FRAME（参与构造器同命裁剪）；非空（存储来自 new …）→ -1 不裁剪。
两处 __init__ 调用点（:171 / :675）均传入。覆盖 CtorHolder(&l) / BoxCtor(&l) 这类裸构造误报。
 2026-10-09 22:40:30 +08:00
TermiNexus 357a8bba05 feat(lifetime): 构造器路径同命裁剪的透传管道（recv_life，默认 -1 = 现状不变） 
_call_method_on_ptr 新增 recv_life: int = -1（被构造对象的生命期，由调用方 CallGenCtor 算出）；
构造器分支在指令最终裁决之后，若 recv_life ∈ {FRAME, VALUE} 则复用 _FrameArgsEscapeClearsMethod
（recv_node=None，接收者已由 recv_life 判定）清"写进形参对象字段"那类位。
下一轮只需在 3 个 __init__ 调用点（CallGenCtor:171/665、ExprGenConst:257）填 recv_life；未填 = 完全现状。
 2026-10-09 22:36:09 +08:00
TermiNexus bf5ecd7668 fix(lifetime): 方法路径补上"同命裁剪"（此前缺失）—— h.set_q(l) 不该报 
现场：h: S* = new heap slife S()（生命期本就是 FRAME：作用域出口释放）+ l 是栈数组；
h.set_q(l) 却报"escaping method parameter"。根因：同命裁剪只做在模块级函数路径，方法路径一直没接
（此前已明确告知"还差一半"）。

新增 CallGenMixin._FrameArgsEscapeClearsMethod：位 0 = 接收者(self)、位 (i+1) = 用户第 i 个实参；
某位可清 ⇔ 该位对应实参是 FRAME/VALUE 且其余全部实参（含接收者）也在本帧。
CallGenCall 方法路径在 refine 之后、指令最终裁决之前套用；硬位仍用 get_param_escapes_hard_method 排除。
构造器路径暂未接（__init__ 的 self 是"正在构造的对象"，此处拿不到接收者 AST 变量）。
 2026-10-09 22:30:35 +08:00
TermiNexus 6000734704 feat(life): A1——@life 新增 stores(x)/borrows(x)（复用 escape/noescape 契约位）；ret/owns 显式报未实现 
§14 路线 A 第一步（零语义变化）：
- stores(x) 归到"强制逃逸"位、borrows(x) 归到"强制不逃逸"位（同一对契约位，调用点已在最后套用、.vpi 已有 esce=/escn= 通道）
- _WillFreeMergeTag 白名单同步扩 stores/borrows；ret/owns 显式 fail-fast "not implemented yet (planned A2/A3)"，不做静默忽略
- 矛盾契约报文改为 escape/stores 与 noescape/borrows 两两对立
 2026-10-09 22:14:26 +08:00
TermiNexus 71730d920c chore(dbg): 删除 NLL 临时诊断（§13 已在 EscapeTest 上验证通过） 
实测：var=h confined=1，g(l,h) 不再报错；报错前移到真正的泄漏点 `if 1==0 or a == 1: return l`（where=a return value）。
 2026-10-09 21:59:48 +08:00
TermiNexus 0f504a9010 chore(dbg): 给 NLL 谓词插桩（[NLL-ST] 逐条语句 + [NLL-UNSAFE]/[NLL-MENTION] 拒绝原因），定位后删除 2026-10-09 21:53:44 +08:00
TermiNexus 960ecdfd74 fix(nll): 补 BoolOp/Compare 的字段递归（if 1==0 or a == 1 曾把整条判据否掉） 
_init_ast 里 node.children = None 是**默认值**（只有语句体这类显式赋值的才有子树），所以"认不出的表达式
一律保守"这条策略会被任何未列举的表达式种类触发。新用例的 if 条件 BoolOp(values) 与 Compare(left/comparators)
就是这种。补上后 h 应能降级，报错位置回到真正的泄漏点 return l（第 19 行）。
 2026-10-09 21:34:17 +08:00
TermiNexus 5a10a2ea10 fix(nll): 谓词改为按字段显式递归（AST 表达式节点不填 children，导致 new stack [2]char 被误判"提及"） 
根因（[NLL-DBG] var=l 已证实）：_set_parent_list 只设父指针、不填 children，故 New/Attribute/Call 等表达式节点
的 children 基本都是 None。原实现把"children==None"当作"提及/拿不到子树"，于是 k 里第一条
`l = new stack [2]char` 就把整条判据否掉（var=h confined=0）。

现在 _NllMentions / _NllExprUnsafe 均按字段显式递归：Name/Constant/Attribute/Subscript/Call/New/UnaryOp/
BinOp/IfExp/Tuple|List|Set；认不出的种类保守（提及=1 / 不安全=1）。_NllStmts 的"认不出的语句"
分支改为按子节点判（无子节点的 pass 之类放行）。
 2026-10-09 21:23:51 +08:00
TermiNexus e82e2ac768 chore(dbg): 加 NLL 判定链临时诊断（[NLL-DBG]），定位后删除 2026-10-09 21:05:31 +08:00
TermiNexus 337be883d3 fix(nll): Attribute 节点显式只递归 .value，避免"拿不到子树=算提及"把 stdio.printf(...) 误判成不安全 
现场：EscapeTest 的 h = new heap S() 永不降级（g(l,h) 照旧报逃逸）。根因是 _NllMentions 对 Attribute
落进保守分支（children 不含 value 时返回"提及"）→ _NllExprUnsafe 把 stdio.printf("%s", h.q) 判为不安全
→ 整个 NLL 判据返回 0。属性名是静态字符串，变量只可能在基对象里，显式递归 .value 即可。
 2026-10-09 20:57:31 +08:00
TermiNexus d0ffb094c2 feat(lifetime): §13 NLL——默认生命期的 new heap 证明帧内封闭时降级为帧对象 
StructGenMixin: 新增 NllFrameConfined 及遍历器（_NllStmts/_NllExprUnsafe/_NllMentions/_NllInSet/_NllAdd/_NllCalleeEscMask）+
has_param_escapes（区分"有记录=权威不逃逸"与"无记录=判不定"）；别名集只增不减故单遍即可，if/while/for 全走、
不进嵌套 def/class；认不出的语句"不提及别名才放行"；取址/实参位逃逸/return/长命目标一律按外泄拒绝。

CallGenCtor._new_is_nll_demotable：只降级"堆且未显式指定生命期"的 new；AssignGenMixin.propagate_life
判据成立则 life=FRAME（于是调用点同命裁剪放过 g(l,h)），_slife_note_assign 接 target_name、判据成立按托管堆
对象登记 → 复用 slife 的作用域出口释放（手动 free/del 也会被既有检查挡住）。

三条函数体翻译入口记录 NllCurFunc（谓词要遍历当前函数体），与 traceback 推帧同一处。

注：谓词按 §13.2 保守优先，判不定一律维持 HEAP；本提交未编译验证。
 2026-10-09 20:49:21 +08:00
TermiNexus 79299ec47d feat(lifetime): 声明式指令契约落 .vpi（esce=/escn=），跨模块调用点也能最终裁决 
写侧 Converter：读 compute_escape_summary 落在 box[3]/box[4] 的契约掩码，随函数头行尾写 esce=<强制逃逸位> / escn=<强制不逃逸位>；
只有指令（既无 esc/ret 也无 wf）时也补一个 "# esc=0 ret=0" 注释段——读侧是"见 # 才解析"。

读侧 VpiReader：_cache_vpi_esc_clears_text 同一次行扫描里顺带收 esce=/escn= 进 _g_vpi_esd_*（与 escg 同键 sha1[.Cls].func）；
新增 _lookup_vpi_escape_dir(.., noescape)；CallGenBase.lookup_escape_dir_via_vpi 包装。

调用点：模块级函数 / 方法 / 构造器三条路径在本文件指令表为空（= 跨模块）时改查对方 .vpi，
仍放在所有推断/回退之后最后套用：esc_mask = (esc_mask | esce) & ~escn。
 2026-10-09 20:40:30 +08:00
TermiNexus 2bd37e80e3 feat(lifetime): 方法/构造器调用点也接 @life(escape/noescape) 最终裁决 
StructGenMixin: 新增 _DirForceOf / _DirForceMethod（查 "Class.method" 并沿 MRO 回退）与
get_param_escape_force_method / get_param_noescape_force_method；GenApi 加同名委托。

CallGenCall: 构造器分支（esc_mask_ci）与方法分支（esc_mask_mc）在跨模块回退、常量特化之后
最后套用一次 esc_mask = (esc_mask | escape_force) & ~noescape_force，与模块级函数那条口径一致。
 2026-10-09 20:34:34 +08:00
TermiNexus fc7c5d5560 feat(lifetime): @life(escape/noescape) 升为调用点最终裁决（契约不可被推断推翻） 
StructGenMixin: 新增 EscDirTable（3 槽/项：[名哈希, 强制逃逸位, 强制不逃逸位]），
_RegisterFuncEscapeSummary 把 compute_escape_summary 落在 box[3]/box[4] 的指令掩码单独落表
（与 EscTable 的"推断结果"分开）；新增 _DirLookup / get_param_escape_force / get_param_noescape_force。
compute_escape_summary 的指令输出缓冲由 g+68 改为 box[3]（同一内存，语义显式化）。

CallGenMixin: 在常量特化、同命裁剪、跨模块回退**全部做完之后**，最后套用一次指令：
esc_mask = (esc_mask | escape_force) & ~noescape_force。这样 escape(...) 不会被"死分支/同命"折掉，
noescape(...) 也不会被任何上游路径重新解释成"逃逸"。
 2026-10-09 20:30:03 +08:00
TermiNexus 8881dea2e2 fix(diag): 泄漏点采集改为"确认报错后才跑"，并保存/恢复扫描期状态 
原先在调用点的位循环里就调 escape_leak_line：该函数会重扫被调者函数体并改 EscConstEnv/EscIndCount，
而循环里可能紧接着发现"该实参其实不是帧生命期"从而不报错 —— 等于白白跑一遍扫描、还留下脏状态。
现在改成把 (被调者, 形参位) 传给检查方，过了 LIFE_FRAME 判定才采集；escape_leak_line 内部
把 EscConstEnv/EscIndCount/EscLeakWant 先存后还。
 2026-10-09 19:50:31 +08:00
TermiNexus 2353dca8ec feat(diag): 逃逸类 LifetimeError 追加 File lifetime leak 帧，标出泄漏点 
StructGenMixin: 新增 escape_leak_line——错误路径重扫被调者函数体，取指定形参的**首个逃逸点**行号；
_NoteLeak 在三处置位来源采集（字段/全局写、return 形参、传递闭包调用），新增 EscLeakWant/EscLeakLine。

Diag: DiagEntry 增加 LeakFileName/LeakLine + set_leak + emit_leak_frame（标签 File lifetime leak），
打印顺序 = 调用链 → 错误点 → 泄漏点 → 类别: 消息。

TypeGenErr.fatal_error / GenApi.fail_if_stack_addr_escape 增加 leak_file/leak_line 透传；
CallGenMixin 调用点按失败实参位取行号。**仅同模块**：跨模块 EscFuncTable 无 AST → 返回 0，不打该帧。
 2026-10-09 19:32:54 +08:00
TermiNexus c98730f717 refactor(diag): 精简 LifetimeError 报错词，去掉冗长从句 
逃逸主报文由三段长从句压缩为「frame-local + 悬垂 + 修法」两句：
  stack address escapes: `&x` is frame-local; using it at {where} hands out a dangling pointer
  once this frame returns. Copy the value, or allocate on the heap (`new heap hlife ...`).

同步缩短 where 短语（return value / escaping callee|method parameter / constructor parameter stored
into a field / longer-lived field-element / module-level global）

其余冗长报文一并精简：willFree 失效、slife 手动 free/del、async slife、stack+hlife 矛盾、三处容量上限、
@life 标签实参缺失

测试只断言关键字 LifetimeError，不受文案影响（Test/*.py 已确认）。
 2026-10-09 19:22:04 +08:00
TermiNexus 007943142a fix(diag): DiagEntry.File 改名 FileName，避开与 fileio.File 的非限定名相撞 
现场：TPC 编译 Diag.vp 时 read_source_line 的 fileio.File(...) 报 llvmlite
"Type of #1 arg mismatch: i8** != %"1f18c0c34662cbfb.File"*"
（1f18c0c34662cbfb = fileio 的模块 sha1，即 self 形参被解析成 i8**，实参本是正确的 fileio.File*）。

Diag.vp 是唯一一个"类字段名 == 同模块 import 的类名"的模块（全仓仅此处有 File: 字段），
而其余 24 个调用 fileio.File(...) 的模块（含 BuildPipeline.vp 的 6 个类）都无此字段且编译正常。
TPC 的 Gen.structs / SymbolTable / _mangle_func_name 均按非限定名索引，故改名规避。
 2026-10-09 19:12:10 +08:00
TermiNexus 6769cf0335 refactor(diag): 编译期 traceback 抽为 Diag 模块，单条诊断携带完整调用链 
- 新增 Diag.DiagEntry 与 new_entry/begin/set_current/add_frame/emit/free_entry，方向由 DIAG_DIR_* 决定

- TypeGenErr.fatal_error 改走 DiagEntry：填调用链 + 当前帧，emit(UP) 后 free + finish

- 顶层函数体/嵌套函数体/方法体三处翻译入口各 push/pop 一帧（def 位置），报错可回溯所在函数
 2026-10-09 18:45:06 +08:00
TermiNexus c791bd5e46 feat(new): new 支持标量/数组与前导 [N]T；类名解析不出时回落基本类型路径 
- CallGenCtor._translate_new_primitive：认 Array 元素类型，返回值退化为首元素指针，零初始化按整体类型写
 2026-10-09 18:45:01 +08:00
TermiNexus fc797da542 feat(lifetime): @life(escape/noescape) 多形参、硬逃逸位同命精化、归纳变量区间与跨模块常量特化 
- GenApi：escape/noescape 标签支持多实参；新增 compute_escape_directives 与若干委托

- StructGenMixin：硬逃逸位（box[2]）、常量与归纳变量区间折叠、_PackEscapeClear/compute_escape_clears

- Call 系：调用点同命裁剪（_FrameArgsEscapeClears）+ 跨模块 escg= 查询；写侧 Converter、读侧 VpiReader

- AssignGenMixin：裸 T()（无 new、无 __new__）判为帧生命期
 2026-10-09 18:44:51 +08:00
TermiNexus 14a8dcb98b feat(gen): new 支持基本类型 + 跨过程常量特化重算逃逸摘要 
- CallGenCtor._translate_new_primitive：
ew [stack|heap|memgr(x)] T（T 为标量）取存储 + 零初始化 → T*；stack 走入口块 alloca、heap 走 malloc、memgr 复用既有通道；标量带实参 fail-fast，不引入第二套标量构造语义

- StructGenMixin：新增 EscFuncTable / EscRefineScratch / EscConstEnv 与常量求值器 _EvalConstInt / _EvalConstCond；_ScanEscapes 的 if 分支按形参常量折叠只扫被走到的分支（死分支里的写不记为逃逸）

- 调用点（普通函数 + 方法，方法沿 MRO 回退）在逃逸检查前用常量实参重算摘要；跨模块拿不到函数体仍保守返回原掩码

- 折叠只会减少逃逸位，不引入新的误报
 2026-10-09 14:55:28 +08:00
TermiNexus ab30b264fc feat(gen): P3 覆盖注解形态的属性/下标目标 
- translate_annassign 原先对非 Name 目标直接 return 0，obj.f: T = v / rr[i]: T = v 整条语句被静默丢弃（既不报错也不写出）

- 新增 _translate_lvalue_annassign：解析注解（先特化泛型）→ get_attribute_ptr / get_subscript_ptr 求左值指针 → 走同一处 P3 长命左值检查 → RHS 以注解为靶型求值 → coerce_to_type 后写出；const / volatile / f-string 逃逸与普通 Assign 同口径

- 所有失败路径 fail-fast，不再有静默丢语句
 2026-10-09 14:55:10 +08:00
TermiNexus d926987d44 chore(dbg): 清除 P4 转移分支的逐点探针 
崩点根因已定位（slife 登记表跨文件悬垂），debugger 探针全部移除。
 2026-10-09 13:04:40 +08:00
TermiNexus eb0c3dfd31 fix(gen): slife 登记表改为跨文件存活，并修正区间弹回 
- _g_slife_owned 原先从 trans.Pool（每文件池）分配，Phase2 每文件 reset_to(mark2) 后表体即悬垂，第二个文件起每次登记都写坏活跃池数据（现场 access-violation on 0x0，崩点随分配漂移、ASan 无法给栈）

- _SlifeRestore 只还了 count、未还 top，top 随函数数量单调增长；上一文件/函数的陈旧条目留在扫描区间内，因每文件池地址复用被误判为新变量，_SlifeShadow 返回悬垂影子槽，_SlifeNoteStore 直接写坏内存

- 新增 _g_slife_save/_g_slife_depth：进入时保存 count/top 两个边界，退出时一起弹回

- _SlifeDropOwnedUnlessSame 补 Pointee==0 守卫（与 _SlifeEmitGuardedFree 同口径）
 2026-10-09 13:04:26 +08:00
TermiNexus 1a3ef521b3 chore(dbg): P4 转移分支逐点探针（owned/begin/ensured/drop.begin/dropped） 
崩点已后移到 CaseOwnershipTransfer 的 q = p（P4 别名转移），逐点定位该分支内具体崩溃位置。TEMP。
 2026-10-09 12:43:59 +08:00
TermiNexus aeb396831a chore(dbg): 清除 CallGenMixin 残留的 call.enter 探针 2026-10-09 12:43:28 +08:00
TermiNexus 6758ecbf69 chore(dbg): 清除最后一处 TEMP 探针（AssignGenMixin slife.note） 2026-10-09 12:03:43 +08:00
TermiNexus 5f92abb7bc fix(gen): 补回 CallGenMixin 的 _FreedMark（修行尾时被 checkout 回滚） 
TPC 报 MemberLookupFailFast: 属性 Freed 在 VarEntry 中找不到 —— 该文件的行尾修复用 git checkout 恢复过，把未提交的 _FreedMark 改动一并回滚了，残留 ent_wf.Freed = 1。
 2026-10-09 12:03:23 +08:00
TermiNexus dd24dc670f fix(gen): P2 失效状态改存独立槽表，不再给 VarEntry 加字段 
现象：任何工程编译都在函数形参注册刚结束处 access-violation（pc=0，逐字节可复现）。定位：逐层探针把崩点压到 FuncGenDef 的 pre_scan 段，而该段对 Check（body 仅 if+return）应为空操作，唯一变量是 VarEntry 这个热结构被加了 Freed 字段。修法：撤销 VarEntry.Freed，改用 VarGenMixin 的独立失效槽表 _g_freed_slots（键 = 变量槽 alloca，整次翻译内唯一，故全局累积、无需按函数 reset/restore）；_FreedMark/_FreedCheck/_FreedClearSlot 三个 API 替换字段读写，P2 语义不变。同时清除全部 TEMP 探针。
 2026-10-09 11:51:11 +08:00
TermiNexus 95b076581a chore(dbg): pre-scan 与 _SlifeReset 之间补 p1d 探针（TEMP） 
p1c 之后仍崩，最后一段只剩 pre-scan 与 _SlifeReset；p1d 把两者分开。
 2026-10-09 11:30:33 +08:00
TermiNexus 054dcf0a0b chore(dbg): 形参注册与 pre-scan 之间补 p1c 探针（TEMP） 
add_var 三次全过（esz=56），崩点在其后。p1c 夹出 L700-763（状态保存）与 L765-775（pre-scan）两段。
 2026-10-09 11:24:29 +08:00
TermiNexus 07ff906338 chore(dbg): add_var 逐行探针 a1..a8（TEMP） 
崩点落在形参注册段，而这段里唯一的结构性改动是 VarEntry 加了字段。逐行埋点定位到具体哪一步（esz/cnt 也会打出来，可用于核对 sizeof 是否异常）。
 2026-10-09 11:12:31 +08:00
TermiNexus a2e1c651fc fix(gen): 变量表 Freed 不再逐个字段写，统一依赖 init_vars 的整块清零 
崩点已定位在普通函数形参注册段（auto_addr 之后、_SlifeReset 之前）。add_var 里对刚加过字段的 VarEntry 末端逐个写 entry.Freed 疑似越界/踩偏移；init_vars 本就 memset 整块，去掉冗余写入。
 2026-10-09 11:01:08 +08:00
TermiNexus 9b97470c09 chore(dbg): 函数翻译内段探针 p1/p2/p3 
夹住 auto_addr → 形参注册/pre-scan → slife reset → 语句翻译 四段；TEMP，定位后移除。
 2026-10-09 10:44:56 +08:00
TermiNexus 20e3f3694f chore(dbg): 补语句级与调用级探针（stmt.kind / call.enter fn） 
崩点已收窄到 Check 函数体内的翻译，这两个探针把范围压到具体语句与具体被调者。均为 TEMP，定位后移除。
 2026-10-09 10:39:24 +08:00
TermiNexus 400cc6e17b chore(dbg): 再加两个探针（函数名 / slife 赋值 rhs kind） 
TR.fn: <name> 定位到具体函数；slife.note rhs_kind=<k> 定位到 _slife_note_assign 的哪条 RHS 路径。均为 TEMP，定位后移除。
 2026-10-09 10:19:29 +08:00
TermiNexus be2521fe46 chore(dbg): 临时阶段日志定位 Phase A 崩溃点（定位后移除） 
四个探针：PhaseA translating <path> / vpi.gen <rel_path> / TR.enter sha1 / TR.prelude.done。用于把崩溃点夹在 解析→vpi生成→模块前言→函数体翻译 四段之间。
 2026-10-09 10:08:43 +08:00
TermiNexus 8b63ae4ca2 fix(gen): 模块前言的声明池逐级判空，避免 PermPool 未就绪时空指针崩溃 
现象：TransPyV.exe 编译任何工程都 AddressSanitizer access-violation on address 0x0（pc=0）。根因：_emit_module_prelude 跑在每个模块翻译的开头，此时 CompilerFactory.factory 或其 PermPool 可能尚未就绪，直接 factory.PermPool.alloc(...) 解引用空指针（PermPool 是 factory 的首字段，偏移 0，与 ASan 报的地址 0x0 吻合）。改为 factory / PermPool 逐级判空，不可用时回退模块池。
 2026-10-09 09:45:36 +08:00
TermiNexus b71ed43f10 feat(gen): P5 slife 登记表容量提到 256，超限 fail-fast 
分配与上限判定共用 _SLIFE_MAX = 256（原 128 且满时静默停止登记）。_SlifeEnsureOwned 超限改为 fatal_error（LifetimeError）：静默返回 None 会让该对象永不登记、永不释放（纯泄漏），与编译器自动管理的承诺矛盾。
 2026-10-09 08:46:24 +08:00
TermiNexus efb4a54428 fix(gen): P4 自别名重复赋值不得释放共持对象 
q = p; q = p 这类自别名重复赋值在覆盖释放时会把两个槽共持的对象提前释放（q 与 p 同时悬垂）。新增 _SlifeDropOwnedUnlessSame：在 IR 里比较 target 与源槽的当前值，相同则跳过整个覆盖释放（含析构调度），不同才走常规保护式释放。P4 转移改用它。
 2026-10-09 08:45:09 +08:00
TermiNexus 3209a7a633 feat(gen): P4 别名赋值改为所有权转移（影子标志从源槽移到目标槽） 
q = p 时若源槽确实拥有 slife 对象，则把所有权影子标志转移：先按覆盖释放处理目标槽原有对象，再置 q=1 / p=0。于是 q = p; p = None 不再释放对象（q 不悬垂），出口只释放 q 恰好一次。自赋值 p = p 与源不拥有（普通/外来指针）保持原状。
 2026-10-09 08:43:48 +08:00
TermiNexus 301a9d3328 feat(gen): P3 左值比右值长命时禁止写入本帧栈地址 
新增 AssignGenMixin.life_of_lvalue：Name 目标取变量槽本身的生命期（局部 FRAME / 全局 STATIC），Attribute/Subscript 目标递归其基对象的 life_of_expr（h.p 的生命期 = h 指向的存储）。在 propagate_life 的非 Name 目标出口比较：仅当左值明确长命（LIFE_HEAP/LIFE_STATIC）且右值为 LIFE_FRAME 时报 LifetimeError（复用 fail_if_life_escapes）。h.p = &local 被拒；local_struct.f = &local2 与 p = &local 放行（不误报）。已知缺口：AnnAssign 的属性/下标目标不走该出口。
 2026-10-08 22:47:28 +08:00
TermiNexus 2b5ff215c7 fix(gen): 跨模块裸名 CExport/State 函数不再被误清，关键字实参不解析时 fail-fast 
现象：stdlib.free(p = p) 生成 llvm.call @free()（零实参），mlir-opt 报 incorrect number of operands (0) for callee。根因：跨模块检查要求函数名前 16 字符等于模块 sha1，而 CExport/t.State 型函数（stdlib.free 等）本来就以裸名定义与声明，于是 found_func 被清成 None → 关键字实参路径整体跳过 → 位置实参循环一个也不翻译。修两处：1) 该检查对 is_cexport_func / _is_state_func_from_vpi 命中的函数放行；2) 带关键字实参却解析不出签名时 fail-fast，不再静默丢弃实参。
 2026-10-08 22:38:28 +08:00
TermiNexus 8b2008031d fix(gen): 模块前言 C 库声明名改落 PermPool，避免被回绕的模块池覆盖 
现象：@malloc 的声明名被渲染成乱码，mlir-opt 报 llvm.call @malloc does not reference a symbol in the current scope。根因：create_declare 用 _str_dup(pool, name) 把名字拷进传入的池，而前言用的是模块池（大模块上会被复用/回绕），早期分配的声明名被后续分配覆盖；类型是 mlirlite 内部 interned 的，所以只有名字坏、参数类型正常。修法：声明与参数名改落 CompilerFactory.PermPool（never reset）。
 2026-10-08 22:30:07 +08:00
TermiNexus 8fb0e38f4c fix(gen): 泛型类构造只在真有 __init__ 时才调 __before_init__/__init__ 
无方法的泛型类（如 NewTest 的 Box[T]）没有 __init__，ClassGenVTable 也就不会生成 __before_init__，但 _translate_generic_ctor_call 无条件发射这两个调用，导致链接期 undefined symbol（1cf2df6387df0bbf.Box[int].__before_init__ / .__init__）。改为与非泛型 _translate_struct_ctor 同判据：有 __init__ 才走 __before_init__ + __init__，否则按字段顺序逐字段 store。
 2026-10-08 22:16:23 +08:00
TermiNexus c02aa3a2eb fix(gen): @life/@willFree 不再被当作运行时装饰器 
自定义装饰器检测（__decor_wrap_<name> 生成路径）此前把 P2 的编译期标注当成 User 装饰器：会生成 wrapper 调用并不存在的 @life/@willFree，并把被装饰的 extern def（如 stdlib.free）变成本模块 internal 声明，llc 报 invalid linkage for function declaration。把 life/willFree 加入该处标记白名单。
 2026-10-08 21:43:47 +08:00
TermiNexus b60ce06335 feat(gen): willFree 覆盖关键字实参、方法调用与取地址三条路径 
关键字/混合实参：CallGenMixin._MarkWillFreeKwargs 按形参序（位置实参占前 can 个形参，其余按关键字名匹配）标记。方法调用：CallGenCall._translate_method_call 的 kwargs 与位置两条循环，实参链含 self 故用户第 ai 个实参对应 bit (ai+1)；新增 GenApi/StructGenMixin.get_param_willfree_method（查 Class.method 并沿 MRO 回退）。取地址：ExprGenOps 的 AddrOf 分支对已失效变量 fail-fast。
 2026-10-08 21:39:53 +08:00
TermiNexus d921dcd9e7 fix(gen): willFree 形参表访问先转 Arguments*，修复 TPC 侧 MemberLookupFailFast 
FunctionDef.args 的字段静态类型是 AST*，直接写 fn.args.args 会在 AST 类上查 args（class_members=7 不含 args）。改为先 ast.Arguments*(fn.args) 再取 .args 列表，与 VpiReader / FuncGenMixin / ClassGenVTable 等既有写法一致。
 2026-10-08 21:34:14 +08:00
TermiNexus 97313e9e55 feat(gen): P2 生命期标注 @life(willFree(...)) 驱动释放后使用与二次释放检查 
标注面：@life(willFree(<形参名|0起序号>))，兼容叠加式 @willFree(...)，可混用累加；序号按形参表下标、self/cls 计入。GenApi.compute_willfree_mask 解析标注并对非法标注 fail-fast。本文件表 StructGenMixin.WfTable + 跨模块 .vpi 行尾 wf=<mask>（Converter 写 / VpiReader 读 / CallGenBase 查）。调用点在实参全部翻译之后把对应实参变量槽置 VarEntry.Freed；其后的读取路径报 LifetimeError。重新赋值清除失效态。
 2026-10-08 21:28:49 +08:00
TermiNexus 9ff5a3a03e fix(gen): 泛型类构造复用 new 描述符存储，并支持泛型下标 callee 
- _translate_generic_ctor_call 之前一律 _alloca_at_entry：new memgr(pool) hlife list[int](...) 会忽略描述符给的内存、把对象构造到栈上、返回栈地址（静默悬垂）。改为与 _translate_struct_ctor 同款：tmp = _g_new_storage，为空才回落 alloca。

- _translate_new_expr 支持泛型下标 callee（Box[int]）：新增 _specialize_new_generic_class 先特化模板拿具体类名，再走同一条取存储路径。
 2026-10-08 21:04:41 +08:00
TermiNexus b6a9b50f93 fix(gen): 异常与传播出口也释放 slife（P1） 
插桩点选在 StmtGenMixin._eh_ret_default —— 异常路径上真正离开函数的唯一汇聚点（translate_raise 的 bare raise / StopIteration / 传播三条分支 + try 的 UnhandledBB 传播分支都走它），发 ret 前 _SlifeEmitFrees。不得改在 raise 语句本身：被本函数 except 捕获时对象仍在用（那一步只 br 到 DispatchBB）；EH 返回值也不会是 slife 对象（逃逸检查已拒）。
 2026-10-08 21:04:33 +08:00
TermiNexus 70390858d8 feat(gen): 协程体里的 new heap slife fail-fast（释放点无法确定） 
AsyncGenMixin 的状态机会把协程 body 拆成多个 state 块并多次转译，编译器无法确定 slife 的释放点；此前是静默漏释放。新增锚点 trans._coro_body_func（Translator 字段 + init 置 None），只在 body 翻译期间由 translate_async_function 设置并保存/恢复旧值；_translate_new_expr 以**函数对象同一性**（_coro_body_func == _cur_func）判定并 fatal_error(LifetimeError)。嵌套普通函数会换掉 _cur_func 故不误报；new stack 与 hlife 不受影响。
 2026-10-08 20:42:09 +08:00
TermiNexus 2178970ff7 feat(gen): slife 释放前调度析构 __del__，并禁止手动 del（§3.6 落地） 
- 释放统一入口 _SlifeEmitGuardedFree 改为「先析构、再 free」；析构名定案 __del__（对齐 TPC LLVMCG/MemoryOps._emit_local_heap_frees 的释放路径；del obj 那条语句走的仍是 __delete__）。

- 查表沿 MRO / 跨模块 stub 回退（复用 ExprGenOps._resolve_dunder_by_class）；类未定义 __del__ 时**不加任何分支**，常见路径零开销。

- 析构用条件分支而不是 select：未拥有的路径必须完全不进析构体（析构体里会解引用 self，传 null 进去会踩空）；块标签走 trans._label_counter，避免同函数内重名。

- §2.4 判据5 扩展：对 slife 对象手动 del obj → LifetimeError（否则析构跑两次）。hlife 路径不受影响。

- 为把 trans 传进析构查找，_SlifeEmitFrees / _SlifeEmitGuardedFree / _SlifeDropOwned 加 trans 形参，9 处调用点同步。
 2026-10-08 20:34:11 +08:00
TermiNexus 78b2052445 feat(gen): 接线 M3 owned slife 的 RAII 出口释放（函数级 scope guard） 
- 所有权影子标志（i8，登记时入口块置 0）+ free(select(影子!=0, load 槽, null)) 保护式释放：赋值在分支/循环里而未执行 → free(NULL)；槽里写入外来指针或别名 → 清影子，绝不 free 外来指针；循环反复 new → 赋值前覆盖释放上一轮，不累积。

- 三条函数体转译路径（FuncGenDef 主路径 / FuncGenMixin 嵌套函数提升为 __closure_* / ClassGenVTable 方法体）各自抬升与弹回登记区间；修两处漏 reset 导致内层出口 free 外层对象再被外层 free 一次 = double free（Windows STATUS_HEAP_CORRUPTION）。出口按槽去重做兜底。

- free 由模块前言统一声明（Translator.vp，紧挨 malloc）；释放点只查表 + fail-fast，绝不吐指向未声明符号的 llvm.call。

- 赋值处记账：new heap slife → 登记 + 覆盖释放 + 影子置 1；其它 RHS（new stack / hlife / 别名 / 外来指针 / None）→ 已登记则交还所有权。手动 free slife 对象 → LifetimeError。
 2026-10-08 20:03:54 +08:00
TermiNexus 934708b206 fix(type): 数组退让豁免提到级数检查之前，修 [N]str 形参被误判 CastError 
形参侧 CArray 按 C 语义退让成元素指针 str*（级数 2），实参仍是 [N]str 的数组地址（级数 1）→ _ptr_cast_reason 先查级数就判 PC_DEPTH，_pointee_convert_reason 里那条既有数组退让豁免成了死代码。元素为 i8 时级数不变所以一直没暴露，元素本身是指针才炸（现场：includes/tomllib _parse_key_path 的 segs）。
 2026-10-08 20:03:42 +08:00
TermiNexus 1dd53ebff5 feat(gen): M3 owned slife 登记机制（函数级 scope guard 的底座） 
登记本函数内由 new heap/memgr slife 直接绑定的变量 alloca，提供 Reset/Register/Owned/MarkAliased/EmitFrees/ReleaseOld 六个 API，供出口插桩与覆盖释放使用。

为什么是函数级而非块级（已核实）：Stmt 层（if/while/for/with）不调用 enter_scope/exit_scope，局部存储一律入口块 alloca（函数级寿命）——块级释放会让"块之后仍可达的变量"变悬垂。别名（q = p）在覆盖释放时保守跳过（宁可泄漏不悬垂），函数出口释放不受别名影响。

本提交仅机制，尚未接线（无行为变化）；下一步接 4 处钩子：函数入口/收尾、translate_return 的 3 个 build_ret、赋值处的登记与覆盖释放、以及 §4.3 手动 free 判据。
 2026-10-08 18:41:52 +08:00
TermiNexus 09b5bf5ac3 docs(gen): _translate_new_expr 注明缺省规则（stack 默认 slife） 
缺省规则（§3.2 / D3）：来源缺省 = heap；生命期缺省由来源决定——stack → slife（故 new stack T(...) 不写 slife 也等效），heap/memgr → hlife。生命期在 life_of_expr 按同一张表落地（LIFE_FRAME / LIFE_HEAP）。
 2026-10-08 18:21:00 +08:00
TermiNexus 9e55e909a8 feat(gen): LifeTag 接到 new 描述符；vpi 文本缓存收敛为单一入口 
life_of_expr 新增 ASTKind.New 分支（§2.3 矩阵）：stack→LIFE_FRAME；heap/memgr 的 slife 同样按帧生命期（作用域末 RAII 释放，逃逸必悬垂）；hlife→LIFE_HEAP。于是 new stack slife Foo() 的结果被赋给变量/返回时会被既有汇点判据 fail_if_life_escapes 拦住（该判据本来就是生命期驱动，无需再加语法特例）。

VpiReader 新增 _cache_vpi_annots_text 单一入口（ret/param/逃逸摘要一次喂齐），两个 vpi 加载点都改调它：从结构上消除"某个加载点漏喂某类缓存"这类静默退化（本次 EscapeXmodTest 漏检的根因类别）。
 2026-10-08 18:19:15 +08:00
TermiNexus 8a98051759 fix(gen): new 的分配尺寸常量改用 const_int64，修 mlir-opt 校验失败 
ConstInt 的第 4 个参数是常量在 IR 里的文本（不是注释/名字），此前传 "newsize" 会打印成 llvm.mlir.constant(newsize : i64)，mlir-opt 报 expected attribute value。已改用项目通用的 mlirlite.const_int64(pool, size_bytes)。
 2026-10-08 18:18:03 +08:00
TermiNexus c77d38e923 fix(gen): new heap/memgr 的尺寸改用 ClassGenEnum._get_type_size，修结构体报 cannot determine the size 
原先调用 TypeGenResolve.get_type_size_bytes，它只解析 typedef/标量，结构体一律返回 0，于是 new heap Point(3,4) 在语义期 fail-fast。

改用语言级 T.__sizeof__() 的同一实现 ClassGenEnum._get_type_size(struct_ty)，保证 new 分配的尺寸与源码手写 __sizeof__() 完全一致（含对齐/填充）。
 2026-10-08 18:07:28 +08:00
TermiNexus 14920c0e1e fix(vpi): 逃逸摘要在所有 vpi 加载点都喂缓存，修 EscapeXmodTest 跨模块漏检 
_ensure_vpi_ret_annot_loaded 开头有"本模块 ret 注解已缓存则直接 return 1"的短路：若某模块先经 _ParseVpiIntoModuleImpl（stub 注入）加载，而该处只喂了 ret/param 缓存、没喂逃逸缓存，后续跨模块逃逸查询就会永久查空。现场：EscapeXmodTest 漏检——box.vpi 里 `# esc=2 ret=0` 落盘正确，查询侧却命中不到。在该加载点补 _cache_vpi_escape_annots_text。
 2026-10-08 17:58:07 +08:00
TermiNexus 64502471e1 feat(gen): M2.4 new 描述符语义落地（stack/heap/memgr 三来源） 
CallGenCtor 新增 _translate_new_expr：只替换取存储一步——stack 用帧内 alloca、heap 用 malloc(sizeof)+bitcast、memgr(x) 用 x.alloc(sizeof)+bitcast；其余构造序列（__before_init__ → __init__ / 字段赋值）用合成 Call 复用原路径，因此 __init__ 的逃逸检查对 new 同样生效；结果恒为 T*。

文件级 _g_new_storage 承接描述符算出的存储，两个 ctor 入口的默认 alloca 改为有则复用；_translate_new_expr 前后保存/恢复，支持嵌套 new。

§2.4：stack+hlife 语义矛盾 fail-fast；memgr(x) 拿不到管理器类 fail-fast。ExprGenMixin 分派 ASTKind.New。
 2026-10-08 17:45:39 +08:00
TermiNexus cd68bb62ac feat(gen): M2.3 v3 跨模块逃逸摘要 + 全局赋值判据双保险 
【v3 跨模块摘要】Converter._PyiFunction 在每个 def 签名行尾写 `# esc=<mask> ret=<ret>`（仅非零时写）；VpiReader 新增逃逸摘要缓存（键 {sha1}.{Class}.{method} / {sha1}.{func}，值打包 mask|ret<<32），与返回注解缓存同一次加载解析，并加"模块已加载"备忘 + 键前缀过滤避免拖慢编译；StructGenMixin 抽出 compute_escape_summary 供登记与落盘共用；CallGenBase.lookup_escape_via_vpi 按本类 + MRO 祖先模块 sha1 查询，方法/构造器/模块级函数三处调用点在本地表未命中时回退查 vpi。

【修复】Converter._PyiEnsureEscScratch 补 global（漏写导致全局仍 NULL，box 算成 0+520 → ASan WRITE on 0x208）；函数内写"本文件已声明的模块全局"且无 global/nonlocal 时必须 fail-fast——原判据只看 SymTab.Root.Vars，部分时序看不到模块全局而静默建局部影子；新增 FileVarNames（register_file_funcs 预扫收集顶层变量名）+ is_file_var() 兜底，普通赋值与注解式重声明两处都接上。
 2026-10-08 17:28:06 +08:00
TermiNexus 9f98e683a9 feat(gen): M2.3 覆盖面扩展——类方法与嵌套函数的逃逸摘要 
摘要键约定：模块级/嵌套函数用裸名（与调用点 func_name 一致），类方法用 "Class.method"，查询沿 MRO 回退；刻意不回退裸名，避免方法名与同名模块函数（error/init 等）串味产生误报。

register_file_funcs 登记类方法与嵌套函数摘要，v2 传递闭包相应覆盖（_RescanEscapes 拆为 _RescanOne/_RescanNested/_RescanClassMethods）。

调用点新增：_translate_method_call 的方法路径检查（形参下标含 self，用户第 ai 个实参对应 bit ai+1）、_call_method_on_ptr 的 __init__ 构造器检查（self.f = p 的逃逸；__new__ 形参可能与 __init__ 共享并裁剪，不查）。

已知边界：摘要表按文件重置，跨模块查询待 v3；_PropagateCallEscapes 只处理裸名被调者，方法调用链的传递待补。
 2026-10-08 16:55:34 +08:00
TermiNexus b03e55bb7e fix(gen): 类归属不采信星号导入候选，收口 fatal_error 返回类型与默认值补全 
TypeGenResolve._class_true_def_sha1 / CallGenBase._lookup_reexport_from_vpi 新增 allow_star 参数：类归属只采信具名 re-export。此前 `from X import *` 候选被当成类的真实定义模块，而几乎每个文件都 star-import stdint，导致 TypeGenErr 前向声明被建成 "stdint.TypeGenErr"；该名字在 StructTable 里只剩一个错误 sha1 的条目，fatal_error 的跨模块返回类型解析全部落空并 fail-fast。

TypeGenErr.fatal_error/fatal_type_error 显式 -> int（留空会解析出退化类型 i0，命中 CallGenCall 的 i0 守卫）；_fail_method_ret_ty 增加失败上下文转储并并入同一条 VLogger.error（批处理下 error 即 sys.exit，其后代码全是死代码）。

CallGenMixin 模块级调用：默认值已知但重建不出时 fail-fast，不再静默产出操作数不足的 llvm.call（只会被 MLIR 校验拦下）；AssignGenMixin 两处 VLogger.error 补上 category 实参。

M2.3 v1b 收尾：逃逸摘要表与扫描临时区改为只分配一次、传递闭包扫到不动点、u64 改 sizet；VpiReader 不再 free 跨阶段引用的 src_sha1（heap-use-after-free）。
 2026-10-08 16:38:35 +08:00
TermiNexus 1fb0f4a4ea feat(gen): 逃逸摘要传递闭包（M2.3 v2） 
- walker 认值位置上的调用（Return/Assign/AnnAssign/Expr 的 value 为 Call）。 - 传递规则：g(p,...) 中 g 会逃逸的实参位若绑到本函数形参 p，则 p 也逃逸。 - 注册完再重扫 2 遍（单调 OR-in）。已知：超过 2 层的链仍可能漏，真正收敛需改为扫描到不变为止。
 2026-10-08 13:47:54 +08:00
TermiNexus 52fd89decf feat(gen): 调用点逃逸检查（M2.3 v1b 步骤4） 
translate_call 里按被调者摘要核对实参：第 k 位为 1（该形参会逃逸/被返回）的形参位上，实参若交出本帧栈地址（&local / 局部数组退让）即报 LifetimeError。此处拿不到被调者形参类型，故传哑指针类型，仅用于让 life_of_expr 判定裸局部数组名处于指针位置=退让。
 2026-10-08 13:41:00 +08:00
TermiNexus 4ce577d8fb feat(gen): 函数生命期摘要表 + 逃逸 walker（M2.3 v1b 步骤1-3） 
- StructGenMixin：EscTable/EscCount（追加在类末尾，避免偏移漂移）；register_file_funcs 每文件重置并逐函数算摘要。 - 逃逸 walker：return p / global 赋值 / obj.f 赋值，递归 if/while/for；不进嵌套 def/class；形参访问逐级显式重转（AST 退化）。 - 表内只存 u64 名哈希（djb2-64），不解引用字符串指针，消除槽内坏指针导致的 strcmp 崩溃。 - 表从 PermPool 分配并 memset。 - GenApi：get_param_escapes/get_ret_borrow 查询入口。调用点检查（步骤4）待接。
 2026-10-08 13:29:28 +08:00
TermiNexus a6e1957768 feat(gen): 控制流汇合 Meet（M2.2） 
- VarGenMixin：life_capture/life_restore/life_join（作用域链快照，池上 [count,(entry,life)…] 数组）。 - StmtGenCifMixin.translate_if：进分支前快照、then 末快照、else 前复位、出口按 min 合并。 - StmtGenMixin：while/for 统一在语句分派处 capture→run→join（一处覆盖全部迭代形态与解糖，含 0 次迭代路径）。
 2026-10-08 12:35:59 +08:00
TermiNexus ec47401151 feat(gen): 生命期标签（LifeTag）与借用传播（M2.1） 
- GenTypes：新增 define LIFE_VALUE/FRAME/HEAP/STATIC/UNKNOWN 与 VarEntry.Life。 - VarGenMixin：set_var_life/get_var_life/life_meet；add_var 初始化 Life=UNKNOWN。 - AssignGenMixin：life_of_expr（&local、数组退让、变量 Life 读取）、propagate_life（赋值传播）、fail_if_life_escapes（汇点检查，LifetimeError）；在 AnnAssign 与单 Name Assign 处挂传播。 - GenApi.fail_if_stack_addr_escape 改为薄壳并委托 fail_if_life_escapes；原 (a)(b) 语法判据并入 life_of_expr。于是 s: str = l; return s 被拦截。
 2026-10-08 12:22:10 +08:00
TermiNexus 7070bc1608 feat(gen): 栈地址逃逸检查（LifetimeError）、按值返回聚合、标量→聚合 fail-fast 
- GenApi.fail_if_stack_addr_escape：禁止把本帧栈地址写出帧外（显式 &local，以及局部数组名退让到指针目标，如 return arr with '-> char*'）；裸聚合名 + 同型聚合目标是值拷贝，不在其列；err_type 记为 LifetimeError。 - StmtGenCifMixin.translate_return：按值返回聚合时，对被指类型与返回聚合类型同一的指针补 load（与多返回值 struct 的 ret 同形），修复 return 局部数组报 CastError。 - ExprGenBase.coerce_to_type：聚合目标不接受标量（旧行为落成 store i32 0, ptr，只写首元素字节并抬高对齐），改为编译期 fail-fast。
 2026-10-08 12:10:13 +08:00
TermiNexus 2ab6342d3c fix(gen): arg 糖支持转发形态的 va_list 
_translate_arg_sugar 原本在 trans._va_list_ptr 为 None 时（非变参的 vprintf 式包装函数，如 vsnprintf(buf,size,fmt,args)）直接返回 0，转发下来的 va_list 因此读不到；现增加回退：按名 args 取形参 alloca 并 load 出槽内的 va_list 指针（自身变参形态仍用 trans._va_list_ptr，不 load）。点号形式 stdarg.arg(...) 经 ExprGenBase.get_func_name 取属性短名，已天然命中同一分派，未改动。
 2026-10-07 20:15:40 +08:00
TermiNexus c20bd4734b feat(gen): 值引用自动取址接入虚分派/构造/属性/静态等全部方法调用路径 
CallGenBase 新增 _vpi_auto_addr_mode（把原先埋在 _coerce_args_to_def_params 里的 vpi 注解解析抽成唯一实现，两处共用）与 _apply_auto_addr_to_call_args（同模块先查 AutoAddrModes，跨模块回退 vpi 注解）。接入原先完全不查表的路径：虚分派（原在 vpi 取址前 return）、_call_method_on_ptr 覆盖的构造 __new__/__init__（含泛型）与 dunder 分派、属性 getter/setter/deleter、静态/类方法、super()、FakeDuck；属性 setter 由 AssignGenMixin 传入 rhs AST 以支持 &T 取左值地址。
 2026-10-07 19:59:52 +08:00
TermiNexus 5c1b882169 chore(gen): c.CIf 家族移除报错覆盖 CElif/CElse/CEndif，注释口径统一为 cif 
ExprGenName / CallGenDispatch 的「已删除拼写」守卫原本只认 CIf/CIfdef/CIfndef，现补齐 CElif/CElse/CEndif 六个（与 TPC 侧一致），报文同步；StmtGenCifMixin 的头注释、docstring 与状态注释把语句统一称作 cif，内部标记仍写作 c.@CIf 族。
 2026-10-07 19:10:05 +08:00
TermiNexus 2fb648d68a feat(lang): 新增 cif/celif/celse 条件编译与值引用注解 &T/&temp T，assert 改译 testcheck.check 
cif 三件套：StmtGenCifMixin 负责常量求值（含 defined(模块宏) 的 Attribute 形式），链式错配与含运行时变量一律 fail-fast；删掉 c.CIf 家族。值引用：TypeGenResolve 让 CRef/CTempRef 与 t.CPtr 走同一解析路径（&void 折叠为 i8*，删除 t.CNeedPtr），CallGenBase 在调用点按形参模式自动取址（ref 只接受左值，右值 fail-fast；temp 物化临时栈），跨模块经 VpiReader/StubMergerBuild 传递模式。assert：StmtGenMixin 合成 testcheck.check(cond, None, msg)，Translator 检测到 assert 时自动注入 testcheck 导入（带去重与防环），深递归守卫改用 stdio.printf + stdlib.exit（Translator 无 Gen 成员）。
 2026-10-07 19:03:16 +08:00
TermiNexus ce50daa87a refactor(build): 构建产物目录去掉 _mlir 后缀（temp/output） 
TempDir/OutputDir 回归 {BuildDir}/temp 与 {BuildDir}/output，与 TPC 及项目脚本预期一致；mlir_dir_suffix() 仅保留给 includes 二进制缓存（其布局为 sha1 子目录，与 TPC 的扁平 obj 缓存不同，合并会混淆）。
 2026-10-07 19:03:02 +08:00
TermiNexus 3b4bd1c6dc fix(gen): 跨模块函数作值时不再伪造同名外部全局 
`serial.puts` 这类模块属性指向的是函数（elf.vp 的 _resolve_symbol 返回它作
函数指针），属性兜底路径却为它造了一个 llvm.mlir.global external @<sha1>.puts，
与已有的 llvm.func @<sha1>.puts 同名，mlir-opt 报 redefinition of symbol named。
改为在伪造之前先精确匹配函数符号（目标模块 sha1 前缀过的函数名与 Function.Name
逐字符相等，避免误命中他模块同名函数），命中则返回函数符号引用本身
（@<mangled>，类型 Ptr(Func)，与同模块 &f 分支同一形态），并让属性读路径跳过
对该值的 load（函数地址即值，load 会去读函数体）。
EOF
 2026-10-07 15:59:54 +08:00
TermiNexus edca6c3760 chore(detsite): 类型文本 4096 缓冲补插桩 
19 处 TypePrint(..., 4096, ...) 对应的 pool.alloc(4096) 全部改用 alloc_tagged
（AssignGenMixin/ClassGenVTable/FuncGenDef/ExprGenBase/ExprGenCdef/CallGenLeafKit/
TypeGenCType/TypeGenResolve/CallGenCBuiltin/ExprGenOps），tag 33..51 见 memhub.vp。
detection==0 时 alloc_tagged 直接转发，无布局与性能变化。
 2026-10-07 15:16:52 +08:00
TermiNexus f3628a797a fix(global): 修复存储结构体字段零值文本的池缓冲溢出 
_stg_field_zero_text 分配 160 字节，却用 snprintf(buf, 576, ...) 写出，长类型文本
（如 !llvm.array<8 x i8> zeroinitializer）可越界 415 字节，写穿相邻空闲块的元数据，
触发 [MEM] _fl_pop / [FREEFRAME] 空闲块被写穿（内核编译在 PhaseA 45/50 处中断）。
按实际类型文本长度分配（strlen+24），并把 snprintf 上限与分配对齐。

本文件同时含 3 处 DETSITE 插桩（elem_ty_str_n / ty_str / ty_buf_v）。
 2026-10-07 15:16:47 +08:00
TermiNexus 12b15958c6 feat(global): 支持模块级符号地址初始化器 
新增 init_kind=5（符号地址）：分类阶段识别 UnaryOp(AddrOf, Name)，不再把它
误送进整数常量提取器；发射阶段取模块作用域里该全局的引用文本（@mangled /
@mangled 带引号两种形式）作为初始化器，MLIR 层渲染为 llvm.mlir.addressof。
类型/操作数/引用目标不合法时按 fail-fast 报错。

复现：_v: int = 1 / _p: rawptr = &_v
      修复前报 CDefine value extraction failed（该分支原假设所有 UnaryOp 都是负数/取反字面量）
 2026-10-07 14:54:44 +08:00
TermiNexus 5993affd9c fix(type): const 等限定联合不再被误判为 str*/bytes* 
_is_ptr_element_annotation 原先只要注解联合里出现 str/bytes 就返回 1（按 i8** 处理，
8 字节元素步长），于是 const str（t.CConst | str，实际仍是 i8*）的下标取到的是指针。
现在要求联合必须带 CPtr 标记（真正的 str*/bytes*）才判定；模块级全局的同一处逻辑
（TranslatorGenMixin）同步收紧。新增 _annotation_has_cptr_marker 供两处复用。

复现：def F(p: str) -> int: / path: const str = p / ch: char = path[i]
      -> CastError 指针转整数（形参位置的 const str 一直正常，仅局部/全局错）
 2026-10-07 14:35:25 +08:00
TermiNexus fb3d3787e6 refactor(build): linker.cmd 由绝对路径改为裸名，--asan 提示文案去硬编码 
- project.vpj / repl.vpj 的 linker.cmd 改为 clang++.exe，交由 PATH 解析

- main.vp 的 --asan 运行库提示改用占位符路径，并说明 clang64 根目录由 PATH 自动探测
 2026-10-07 11:25:38 +08:00
TermiNexus 36d23d2f42 feat(build): 实现 Qt 运行时依赖部署（runtime.qt6_path / qt6_dlls / qt6_plugins） 
背景：project.vpj 里的 runtime 块此前只是声明（编译器不读取），Qr 程序运行时报 Could not find the Qt platform plugin "windows"。

实现：链接成功后（Phase2 的 PhaseC 成功点）调用 BuildPipeline.deploy_runtime_deps(exe_path)——把 qt6_dlls 各项从 <qt6_path>/bin 复制到 exe 同目录；把新增的可选字段 qt6_plugins 各项从 <qt6_path>/plugins 复制到 <exe 目录>/<相对路径>（父目录不存在则 mkdir）。Config.vp 新增 Qt6Path/Qt6Dlls/Qt6Plugins 读取（口径同 LinkerStaticLibs）。

fail-fast：声明了但源文件不存在 / 复制失败 / mkdir 失败 => VLogger.error 并中止构建；三字段全未声明则整段跳过。

验证：重编 SUCCESS（210.11s）；ViperMNIST 产物含 7 个 Qt6*.dll + platforms/qwindows.dll，实跑 stderr 无插件报错；ViperAIChat / ViperQtHelloWorld 同样 OK 并完成部署。
 2026-10-07 09:08:35 +08:00
TermiNexus 848dc0ab38 fix(compiler): 跨模块调用补全 int→ptr 转换与别名默认参数；类型文本缓冲 512→4096 
1) CallGenMixin.vp（跨模块 extern 实参提升）：指针目标形参改为无条件走 coerce_to_type——原守卫按整数位宽比较，而指针类型的 bits 恒为 0，整段提升被跳过，致 VirtualAlloc(0,...) 以 i32 传入指针形参、mlir-opt 报 operand type mismatch（ViperAIChat 失败）。

2) CallGenMixin.vp（默认参数限定键）：改用 StructGen._resolve_module_sha1 解析模块 SHA——原只精确匹配模块名，import x as y 这类别名取不到真实 SHA，默认值表落空、跨模块调用实参数目不符（ViperRequestsTest 失败）。

3) 11 个文件的 TypePrint 类型文本缓冲 512→4096（分配与传入 size 成对修改）：48 字段类（如 MNIST 的 Net）的 MLIR 结构体类型文本超过 512 被截断并 fail-fast。
 2026-10-07 08:48:09 +08:00
TermiNexus 7a9bc5ae75 chore(messages): TransPyV 运行时中文字符串英文化 
把 TransPyV/App 下 57 个文件的运行时中文字符串（编译器报错/告警/日志、CLI 帮助与横幅、REPL 提示、Phase1/Phase2 流程日志、Codegen 各 Mixin 的类型与调用报错、Stub/Vpi 诊断等）共 1091 行译为英文。

口径：只改字符串字面量内部文字，行数零变化（+1092/-1092）；printf 格式符与转义序列多重集合校验不变（_strcheck 异常 0）；译文不引入撇号以免干扰单引号字面量解析。验证：三重重编 SUCCESS（136.20s）+ 全量 77/77 顺序回归通过 + VET 编译 SUCCESS / --search-paths 7 条 exit 0；新产物 help/日志输出已为英文。
 2026-10-07 00:03:58 +08:00
TermiNexus 0cf80632c1 feat(gen): typedef 源文本归一 C 式 const/T*（R16） 
TPV 的 typedef 注册走裸源码扫描，需与 TPC 同形：_parse_typedef_line 把右值的前导 const/volatile 归一为 t.CConst | / t.CVolatile |、末尾 * 归一为 | t.CPtr；register_ctypedef_from_source 的缓冲 320->512 以容纳展开后的文本。
 2026-10-05 20:36:40 +08:00
TermiNexus 374921623b fix(gen): 补全新语法 &/* 的取地址与解引用路径 
(*p).attr 属性基址：_get_cderef_attr_base 增加 UnaryOp(Deref) 分支（读写都要求 GEP 指针本身，而非加载后的结构体值）。_is_addrlike_call 增加 AddrOf/Deref 分支：指针型右值不应走模块全局的『静态存储对象拷贝』分支。
 2026-10-05 19:58:45 +08:00
TermiNexus df2de5ecfa refactor: 去 t.CPtr(&a) 冗余包装（R15） 
TransPyV 4 文件 / 7 行：Phase/BuildPipeline.vp、core/Gen/AssignGenMixin.vp、core/Gen/TranslatorGenMixin.vp。验证：自举三重重编 SUCCESS + 全量 77 项顺序回归通过。
 2026-10-05 17:55:52 +08:00
TermiNexus cd55a7e214 refactor: rawptr[T] -> T*（R14）+ 修 REnum 前向占位未就地填充 
R14：rawptr[X] -> X*（56 文件 / 834 行改动）；保留 6 处 rawptr[t.CPtr]（存纯裸指针的规范例外）。 修复：class X(t.REnum) 的变体字段写成自引用 X* 时，字段解析在变体扫描期经 ensure_forward_class 建了一个 opaque 前向占位；末尾 register_struct 按 Ty 指针去重会再建第二个同名 entry，而 find_struct 取首个（占位，0 字段）→ X.__sizeof__() == 0，报「已注册但大小为 0（字段链表未填充）」。改为注册前若命中同模块前向占位则就地填充（与 ensure_forward_class 文档口径一致）。TPC 无此问题，属 TPV 侧缺口。 验证：自举三重重编 SUCCESS；全量 77/77 顺序回归通过（修复前卡在 LLvmLiteTest）。
 2026-10-05 17:38:28 +08:00
TermiNexus aeb4e8e54c refactor(gen): R12 收尾同步——12 处计数 while 循环改 for range 
与 includes 同步：<= 条件转 range(expr + 1)，并放宽初始化行的紧贴要求（同块内最近一次写即为初始化即可）。其余保守守卫不变。

验证：bootstrap 三重重编 SUCCESS；全量 77/77 顺序回归通过。
 2026-10-05 16:36:36 +08:00
TermiNexus fb53f88893 refactor(gen): R12/R13 同步——下标 while 循环改 for range、去 c.Set 
与 includes 同步执行两批源改写：R12 把「i: int = 0 与 while i < N: … i += 1」形式的计数循环改写为「for i in range(N):」；R13 把 c.Set(*p, v) 迁移为 *p = v、c.Set(a, b) 迁移为 a = b（c.Set 是正在退化的路径）。

验证：bootstrap 三重重编 SUCCESS（无 vast_c 解析回退）；全量 77/77 顺序回归通过（WebTest 首轮网络超时，单独重跑通过）。
 2026-10-05 15:33:58 +08:00
TermiNexus a7b8118ce8 fix(call): c.Set 支持 Starred 解引用目标（*p 在实参位被解析为 Starred） 
新规范把 c.Set(c.Deref(p), v) 改写成 c.Set(*p, v)，而实参位的 '*' 由 ast/parser.vp 解析为 Starred(value=p, ctx=Load)，translate_c_set 只认 c.Deref/Call 与 Name 形态 ⇒ 整条 store 被静默丢弃。

后果：zlib 侧 includes 全部 47 处 c.Set(*out_len/*out/*length/*cap/*buf/*best_dist/*p_done, ...) 失效 —— 压缩结果长度恒为 0（decompress 报 Z_DATA_ERROR -3），ZlibTest 运行期 0xC0000005。现按 UnaryOp/Deref 与 Starred 两种形态统一走解引用写入，并对非指针目标 fail-fast。
 2026-10-05 14:35:50 +08:00
TermiNexus 87b24c2445 fix(type): resolve_typedef_or_map 补齐裸内建别名，修复 int(x, t.CPtr) 类型解析 
裸名 str/bytes/int/char/bool/float/double/void 在 map_t_type 中只有 t.CXXX 拼写，导致 _tc_h4 的双参指针包装分支拿不到 bare_ty，落回外部函数返回类型兜底并 fail-fast（argparse.vp:93 c.Deref(int(uint64(ptr), t.CPtr)) 报 TypeError: int）。
 2026-10-05 14:14:29 +08:00
TermiNexus 0f4aeeceff docs(tpv): R11 注释与 docstring 英文化并压缩到 2 行内 
按 wiki/新规范：注释只讲作用、不掺杂历史原因、避免超长、尽可能英文（含三引号 __doc__）。全文 79 个 .vp：# 注释 16269 行（中文 13808）与 docstring（中文 1381 处）全部改英文；超 2 行的注释块（2093）与 docstring（397）全部压到 2 行。运行时可见文本未动（fatal_error/VLogger 的中文报错文案、stdio.printf 的横幅格式串）。校验：屏蔽注释与三引号后逐行比对各文件代码骨架，0 漂移。验证：自举重建 153.48s 通过（跨模块内联完成）；TPV 顺序回归 77/77 全通过。
 2026-10-05 13:38:22 +08:00
TermiNexus a2874a14e6 chore(tpv): 移除 --allow-multiple-definition 兜底并同步缺省链接参数 
main.vp 的缺省 linker flags 与 ViperBuild 内置 _c_linker 默认值去掉 -Wl,--allow-multiple-definition，与 project.vpj 同口径；Phase2 三处引用该 flag 的注释改为描述链接器选 main / 链接前按路径去重的实际机制。重建验证：跨模块内联优化完成、链接成功 139.17s。
 2026-10-05 09:22:58 +08:00