7 Commits

Include renames

Author	SHA1	Message	Date
thzxx	4ab04df882	fix(A15): 三值逻辑求值器统一 —— 消除 WHERE 的第二套语义（静默错值根治） ... 背景（PLAN-v0.7.5.md 根因 1/7、缺陷 A15）： 项目里 `matchWhere`（布尔版，自带 matchField）与三值求值器并存。同一条 SQL 的 语义取决于走哪个函数，实测三类静默错值： - `WHERE n = NULL` 命中 NULL 行、`WHERE n != NULL` 返回所有非 NULL 行； - `WHERE s NOT LIKE 'x'` 会把 NULL 行判真（布尔取反）； - `WHERE n NOT BETWEEN 1 AND 2` 恒空集 —— parser 生成的字段级 `{ n: { $or: [ {$lt:1}, {$gt:2} ] } }` 递归进了 where 子句级求值器， 子项 `{ $lt: 1 }` 被当成"查询列 `$lt`" → 每行 UNKNOWN。 根治方式（不是打补丁，而是取消第二套实现）： 1. where-matcher.ts 重写为**唯一一个递归求值器**，同时理解 where 子句级 （键是列名/逻辑连接词）与操作符级（键是 `$gt` …），位置由上下文承载而非 由另一个函数承载；`matchWhere` 退化为"三值结果是否恰为 TRUE"。 行上下文随求值上下文下传，`$col` 在任意嵌套深度都能解析。 2. parser：`IS NULL` / `IS NOT NULL` 生成 `$isNull` / `$isNotNull` **谓词** （此前与 `= NULL` / `!= NULL` 共用 `$eq: null` / `$ne: null`，两者语义无法区分）； `BETWEEN` 生成真正的范围条件（此前把同一对象同时当操作符对象与操作数）； `NOT BETWEEN` 展开为 `$or: [{$lt}, {$gt}]`。 3. executor 新增 enginePreFilter：逐行求值谓词（`$col` / `$exists` / CASE 键） 必须整体移出引擎层 —— 引擎无外层行上下文，会把它们判 UNKNOWN 并把**所有行** 过滤掉，逐行求值再正确也无行可算。粒度按连接词决定：`$and` 成员可单独移除， `$or`/`$not` 成员一移除就改变结果集（漏行/多行），故整条下推放弃。 契约变更（旧测试编码了错误语义，已按 SQL 标准改正并注明理由）： - a) `{ $eq: null }` 不再命中 NULL 行（`= NULL` 恒 UNKNOWN）→ 用 `$isNull`； - b) `IN` 列表含 NULL：`x IN (NULL, 'a')` 只命中 'a'（`null = NULL` 为 UNKNOWN）， 未命中的行仍因 UNKNOWN 不保留。 - c) 引擎层 `$in: [null, ...]` 与 `$eq: null` 的断言同步修正。 验证： - 新增 tests/v080-sql-three-valued.test.ts：26 条 SQL 语义矩阵 × 4 引擎 （memory/disk/hybrid/aria）+ UPDATE/DELETE 写路径，共 104 断言； - 全量 83 套件 / 1458 测试通过（含 Aria 生产负载 10 万行）； - typecheck(src+tests) 与 lint 零错误。	2026-09-14 23:22:26 +08:00
thzxx	674da6b7b7	fix(A9/A10): 发布订阅接线 + 列对列比较与关联子查询（静默空结果根治） ... A9 db.subscribe 对本地写入永不触发 全库唯一调用 emit 的地方在 BroadcastChannel 收到**其它标签页**消息的分支里， 于是 README:232「订阅表变更」与 site/docs.html:667-679 的示例 （event.type: 'insert'|'update'|'delete'、event.row）全部不成立。 根治方式：新增 src/engine/change-notifier.ts —— IStorageEngine 装饰器， 把变更通知收敛到**引擎接口**这一个位置（三个写入入口 SQL/Table/Builder 与 事务内写入都必须经过它），避免在三条路径上各写一份变更描述逻辑。 事件语义（兑现文档承诺）：INSERT 逐行带 row+key；UPDATE/DELETE 写入前快照 受影响行、成功后逐行发事件并带更新后/删除前的行；CLEAR/DDL 表级事件。 订阅者返回 Promise 时被 await；订阅者抛错不影响写入结果（只上报 onError）。 两个实现细节值得记录： 1. 引擎被装饰后，core 里 `this.engine instanceof HybridEngine` 恒为 false → Hybrid 跨标签页重载静默失效。新增 unwrapEngine() 对**内层**引擎做能力探测。 2. 外部事件（external）绝不能重新广播 —— 否则 A↔B 互相转发形成无限循环 （实测 8 次以上且不终止）。已分离 emitExternal 路径。 A10 列对列比较与关联 IN 子查询静默空结果 1) `WHERE t.x = t.y`（唯一可解析的列对列写法）返回 []： - 引擎层 matchWhere 无 $col 上下文，把 `{ $col: ... }` 当普通对象比较； - executor.filterCorrelated 调用 matchWhere 时**没传** `{ $col: true }`。 修复：engine 层遇到未解析操作数（$col/$subquery）时**放行**而非判假 —— 引擎的过滤只允许缩小候选集，最终判定始终由带上下文的 executor 完成； executor 侧补上 `{ $col: true }`。 同时修正 MemoryEngine/AriaEngine 的索引下推：非原始值（对象）不走索引， 否则 String({...}) 得到无意义键、查找为空并短路全表扫描 → 静默空结果。 2) `WHERE id IN (SELECT user_id FROM o WHERE o.user_id = u.id)` 返回 []： 子查询执行**不传外层行上下文**，`u.id` 绑定为 null → 子查询空集 → `$in: []`。 （结构相同的 EXISTS 走另一条分支、结果正确 —— 又一处"同一语义两条路径"。） 修复：resolveOperatorSubqueries 接收并传递 contextRow；bindColumnRefs 递归 进入 $subquery 绑定外层引用；新增 lookupOuterValue 先剥外层表名/别名前缀 再取值（外层行键不带前缀，否则 `u.id` 取 undefined 被 `?? null` 静默成 null）。 ChangeNotifierEngine 能力转发 装饰器只实现 IStorageEngine 声明的成员，导致： - 可选能力缺失时抛原生 Error，破坏 `NOT_SUPPORTED` 错误码契约（14 个用例失败） → 新增 requireCapability，统一抛 NOT_SUPPORTED 并保留方法名； - 接口外方法（analyzeTable/reindexTable/vacuum）在被包装后静默消失 → 新增 requireOptionalMethod 显式转发（ANALYZE/REINDEX/VACUUM 恢复可用）。 新增 tests/v080-subscribe.test.ts（5 用例，四引擎 × 三种入口）、 tests/v080-correlated.test.ts（4 用例，含"关联 IN 与等价 EXISTS 结果一致"护栏）。	2026-09-14 22:29:51 +08:00
thzxx	d4a3f4acd2	fix: v0.7.4 写语句子查询 / 约束硬化 / 真惰性流式 — UPDATE-DELETE WHERE 子查询静默 0 行（四引擎，关联引用显式 NOT_SUPPORTED + EXPLAIN 同步）/ 主键 NULL-undefined 强制拒绝 / DROP INDEX 保留建表 UNIQUE（仅索引来源可解除）/ GROUP BY-DISTINCT-UNION 键类型安全编码 / UPDATE 未知列报错 / queryStream 多语句拒绝 / KVStore 后台错误跨 reopen 清理 + Hybrid begin 补偿 / RB-Tree 删除双黑修复 + LSM 死代码清理 / findStream 迭代器化真惰性（limit 早停 O(1) 内存）/ REINDEX 单次扫描 + 48 回归	2026-08-15 15:08:33 +08:00
thzxx	05e6823bf1	fix: v0.7.2 语句级原子性 + 事务 DDL 拒绝 + 约束/绑定硬化 — 6 项修复 + 43 回归 + CI 重型套件串行 ... - UPDATE 语句级部分提交（P1，四引擎）：两阶段全量预检后执行，批内唯一互查， 任何一行失败整句不执行（aria 场景 WAL 与内存不再错位） - 事务内 ALTER/CREATE INDEX/DROP INDEX 残留（P1）：Memory/KVStore 显式拒绝 （对齐 Aria），createTable/dropTable 保持可回滚 - SET NULL 级联绕过 required 约束（P1）：预检阶段整体拒绝 FOREIGN_KEY_VIOLATION - bindParameters 注释误判（P2）：行注释/块注释中的 ? 与引号不再参与绑定 - 未闭合字符串静默接受 → lexer 抛 PARSE_ERROR；未知 where 操作符抛 QUERY_ERROR - UPDATE undefined 覆盖列值 → 语义化为不更新（null 仍置空） - Hybrid 写穿透非原子（P1）：磁盘失败自动重载内存对齐磁盘再抛原错误 - CI：Run tests 拆常规并行 + 重型串行（runInBand），重型测试超时余量提升， 性能护栏 kv 120→240s / opfs 150→300s（仍拦截悬崖回归） - 测试 1155 → 1198（74 套件），覆盖率 89.82% 保持	2026-08-13 15:31:16 +08:00
thzxx	a1e4f5071c	release: v0.4.1 — Aria 级联/ALTER/clearAll + 流式查询/派生表 + 正确性加固 ... 新增： - AriaEngine 外键级联（CASCADE/SET NULL/RESTRICT）+ clearAll() 重置 API - 引擎级 alterTable：Aria DROP COLUMN 重写存储行 + schema 持久化 - 流式查询 queryStream / findStream（LSM 惰性扫描不物化） - FROM 派生表 / 多列 ON 哈希连接 / COUNT(DISTINCT) / NULLS FIRST/LAST - 普通列别名 + ORDER BY 别名 + 无表查询 + 字符串常量列 - 演示页引擎切换器（Memory/Aria）+ 预设自动重置 修复： - Aria WAL DROP_TABLE 崩溃恢复（删表复活）+ 恢复后 WAL 截断 - Memory update/delete 索引维护（unique 约束绕过） - 关联 EXISTS 绑定失效 / HAVING 标量子查询 / INSERT SELECT 位置错位 - 裸布尔列条件（WHERE done / CASE WHEN done） - Aria $in 重复行 / JOIN 主表 WHERE 下推 / DROP INDEX 报错 - ORDER BY/GROUP BY/SELECT 表前缀列 + SQL '' 标准转义 质量：894 测试 · 47 套件 · 81.5% 覆盖率	2026-08-08 13:36:34 +08:00
thzxx	d544501e1c	release: v0.3.2 — 质量加固 + SQL扩展 + 表达式 + 并发同步 ... v0.2.6 质量加固: - 修复 AriaEngine 二级索引 SSTable 互相覆盖(命名空间隔离) - 修复 LSM 多版本读取顺序错误 + MergeIterator 取最新来源 - 重写 LZ4 压缩器(往返一致性 + 缓冲区溢出) - sstableCache LRU 上限 + 预加载兜底(BufferPool 配置生效) - 修复 React/Vue 集成 import type 运行时 bug + exports 子路径 - 新增 38 个测试(LZ4往返/Crypto/集成), 删除伪测试 v0.3.0 SQL 功能扩展: - 多语句 parseAll + 事务语句 BEGIN/COMMIT/ROLLBACK - INSERT INTO ... SELECT + UNION/UNION ALL + EXISTS 关联子查询 - CREATE/DROP INDEX 五引擎实现 + 别名 WHERE 修复 - benchmark 页面 + 36 个新测试 v0.3.1 表达式与性能: - CASE WHEN 表达式(SELECT 列/WHERE/聚合) - JOIN + 关联子查询逐行绑定 - WAL 批量组提交(写放大 O(N)→O(1)) - 修复 pending frozen 可见性 + flush 缓存竞争 v0.3.2 并发: - CASE WHEN 用于 WHERE/聚合 + JOIN 哈希连接 - 多标签页同步(multiTabSync + BroadcastChannel) - IndexedDB schema 持久化(reopen 后表结构恢复) - 修复 where-matcher 顶层 $not - 修复 CJS 产物 .js 被 ESM 解析(exports 空) — .cjs 后缀 + exports 修正 - 836 测试 / 44 套件 / 81.0% 覆盖率	2026-08-08 10:41:30 +08:00
thzxx	e2a590c5b1	feat: metona-sqlark v0.1.12 — 前端TypeScript关系型数据库 ... - 4种存储引擎：Memory / IndexedDB / OPFS / Hybrid - 完整SQL支持：SELECT/INSERT/UPDATE/DELETE/JOIN/GROUP BY/HAVING/DISTINCT - Query Builder链式API + TypeScript泛型支持 - 聚合函数：COUNT/SUM/AVG/MIN/MAX - 事务、插件系统(14 hooks)、发布订阅、数据迁移、导入导出 - React/Vue框架集成 - 264个测试用例，93.46%覆盖率 - 零运行时依赖	2026-07-26 15:00:01 +08:00