21 Commits

Include renames

Author	SHA1	Message	Date
thzxx	85f0f170a4	fix(A13): 自引用外键级联（删除/置空/更新/预检四条路径全部生效） ... 缺陷（PLAN §5 #33，实测确认）： MemoryEngine 与 AriaEngine 的级联实现里都有 `if (refTableName === tableName) continue;` —— 自引用外键被整体跳过，四条路径全部失效： - ON DELETE CASCADE：`DELETE root` 只删 root，子树 a/b/c 全部残留， 且 parent_id 指向已删除的行。父行已不在 → 这些行**之后再也无法通过级联清理** （永久悬挂，静默数据不一致）； - ON DELETE SET NULL：子行的 parent_id 保持旧值（等于什么都没做）； - ON UPDATE CASCADE：`UPDATE node SET id='root2'` 后子行仍指向 'root'（悬挂）； - ON DELETE/UPDATE RESTRICT 预检：不检查自引用，约束形同虚设。 两个引擎的跳过条件逐字相同，因此缺陷是同步的（跨引擎一致地错）。 修法： 1. 删除全部 6 处 `refTableName === tableName）continue`（memory 3 + aria 3）。 2. 自引用带来的两个实现约束，已在注释中写明： - **先收集引用者再处理**：自引用时遍历的正是同一个 Map，边遍历边删会让 Map 迭代器跳过条目（memory 侧改为先收集 pk 数组）； - **先递归子树再删父行**：否则删掉父行后子行的 parent_id 再也匹配不上。 Aria 侧本就通过 `getAllRows`（cloneRow 副本）收集，天然满足第一条。 3. 级联写入复用 B-1 的 `validatePartial`（上一提交已做），保持一致。 关于 A14（`ON UPDATE CASCADE` 传递链）——**审计结论有误，实测正常**： 审计记录为"A→B→C 链改 A 主键后 C 悬空"，但 C 引用的是 **b.id**（未变）， 因此 C 不需要更新，"悬空"的推断不成立。本提交的用例把这一结论固化， 并按真正的悬空场景（改 b.id → C 必须跟着更新）补了断言， 避免将来有人按那份错误结论去"修"一个不存在的问题。 验证：新增 tests/v080-foreign-key.test.ts（4 引擎 × 8 项，共 32 断言）， 含"删兄弟分支时只清自己子树""RESTRICT 阻断时三张表都不得变化"等边界； 并做**变异验证**：重新插入一处 skip 后 3 项立即失败，恢复后全绿。 全量 87 套件 / 1729 测试通过；typecheck、lint、build 零错误；dist 已重建。	2026-09-15 01:36:29 +08:00
thzxx	567d150257	feat(A37): 未限定列可作比较操作数 + WHERE/JOIN ON 列引用存在性校验 ... 两个此前互相纠缠的缺陷（PLAN §5 #35/#37、§3 根因 7 的最后一块）。 ① 未限定列不能作比较操作数（语法层） parser 只把 `a.b` 形态当列引用，裸标识符一律走字面量解析，于是： WHERE x = y → PARSE_ERROR: Expected value, got "y" ON k = k → 同上 列对列比较被迫写成 `WHERE t.x = t.y` —— 而多表 JOIN 里未限定列恰恰是最 自然的写法（`ON user_id = id`）。 修法：操作数位置上的 IDENTIFIER **必然是列引用**（字面量各有自己的 token 类型：NUMBER/STRING/TRUE/FALSE/NULL），这一条不需要猜测。 * 排查记录：这里试错了两次。起初用 peekToken 判"下一个是否运算符"， 实测仍报错 —— 因为进入该分支时运算符**已被 parseComparisonOp 消费**， `peek` 是 EOF/AND 而非运算符。最终按"位置"判定，不再依赖 lookahead。 ② `$col` 引用到不存在的列 → 静默空集（语义层） 投影侧早有列存在性校验，WHERE 侧一直没有：`$col` 取不到值 → UNRESOLVED → 比较判 UNKNOWN → **所有行被过滤且不报错**。实测修复前： SELECT id FROM t WHERE id = oops → [] SELECT id FROM t WHERE id = t.oops → [] SELECT id FROM t WHERE x = nope → [] SELECT ... FROM l JOIN r ON l.k = r.nope → []（连接不上任何行） 用户看到的是"没有数据"，与"列名拼错"完全无法区分。 修法：新增 `validateWhereColumns`（WHERE 的键位 + `$col` 值位，含 `$and`/`$or`/`$not` 内部）与 `validateJoinOnColumns`（ON 两侧归属判定）， 两者共用同一遍历实现。 契约变更： - 拼错的列名 → `COLUMN_NOT_FOUND`（此前 PARSE_ERROR 或静默空集）； - JOIN 的 WHERE 里裸写两表同名列 → 歧义报错（SQL 标准要求限定）； - `ON k = k` 这类裸写法仍按"取主表列"解释（不因两表同名而拒绝， 否则会把常见等值连接写法判为错误）。 附带修正：`schema.ts ↔ validation.ts` 的**循环依赖**（rollup 构建告警 "Circular dependency"）。`checkFieldType` 的实现搬到 validation.ts（唯一校验 定义），schema.ts 重新导出以保持公开 API —— 依赖方向改为单向 （validation ← schema）。循环依赖在 ESM 下求值顺序不稳定，是难查的运行时陷阱。 验证：新增 tests/v080-column-resolution.test.ts（4 引擎 × 8 项，共 32 断言， 期望值全部逐个实测得出）；tests/v080-correlated.test.ts 的"裸 x = y 为 PARSE_ERROR"用例改为断言两种写法等价。 全量 86 套件 / 1697 测试通过；e2e 14 项通过（真实 Chromium + OPFS）； typecheck(src+tests)、lint、build 零错误/零告警；dist 已重建。	2026-09-15 01:21:58 +08:00
thzxx	2844a0617c	docs: site 站点全量同步 v0.7.4 — 首页徽章/统计（1304测试 76套件 90.1%）+ 流式真惰性说明、API 文档补写语句子查询与 DROP INDEX UNIQUE 语义 + v0.7.4 里程碑、错误码表补 COLUMN_NOT_FOUND/INDEX_NOT_FOUND、演示/基准版本标注、README 已知限制章节、dist 重建（VERSION 0.7.4）	2026-08-15 15:08:38 +08:00
thzxx	50468b9b0e	fix: v0.7.3 数据正确性与边界窗口收尾 — INSERT 语句级原子（三引擎+Aria PK 批内重复）/ 索引列 IS NULL 恒空 / delete RESTRICT 破坏索引 / queryStream 子查询静默空结果 / ALTER DROP 索引残留 / UNIQUE INDEX 存量校验 / SELECT * 别名投影 / WAL BEGIN/ROLLBACK 事务边界 / aria $in 与级联重复扫描性能 / $and 等值下推 / ANALYZE 索引统计 / React-Vue hooks 生命周期 / 迁移主键兜底 + 58 回归	2026-08-14 22:53:46 +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	cbe407eb49	fix: v0.7.1 API 修复与防御统一 — static create / 未 open 防护 / 原型污染 / lint 清零 ... - MetonaSqlark.create 静态工厂（README 示例在 ESM/Node 下此前 TypeError）， 独立 create 函数委托静态实现 - close 未初始化防御（engine undefined 不再崩溃） - AriaEngine hasTable/getTableNames/getTableSchema 统一 ensureOpen - 事务回滚失败不掩盖原始错误 - __proto__ 列名防护：Executor 列映射 Object.create(null) + schema 校验拒绝 - lint 清零（移除 5 处未使用导入） 测试 1147 → 1155（73 套件）；行覆盖率 89.8%；版本 0.7.1	2026-08-13 11:14:42 +08:00
thzxx	57415975ea	feat: v0.7.0 参数化查询 + 事务增量 flush + 复合主键语义硬化 + EXPLAIN 真实索引信息 ... - 参数化查询 db.query(sql, params)：词法层 ? 绑定 + SQL 字面量安全编码 （'' 转义/注入防护）；参数计数不匹配 PARAM_ERROR；对象参数显式拒绝 - KVStoreEngine 事务增量 flush：行级变更追踪，commit 仅写改动行 （1000 行表改 1 行：日志 1 条目 vs 整表 1000 条目）；级联影响表漏写修复 （txFullTables 同步加入 txDirtyTables）；移除每次 commit 全量 checkpoint （阈值自动 checkpoint + close 统一截断） - 复合主键显式拒绝：createSchema 校验期 SCHEMA_ERROR + ALTER ADD 主键列防护 （此前静默取第一个主键，其余标记失效） - EXPLAIN usingIndex 真实命中信息：pk / index:col / none 测试 1126 → 1147（72 套件）；行覆盖率 89.8%；版本 0.7.0	2026-08-13 10:57:26 +08:00
thzxx	f97c5a6001	fix(P2): v0.6.3 原子性/一致性/资源治理 — 8 项修复 + 12 回归 ... - KVStore 混合写单记录原子：新增 writeBatch（put+delete 同一条日志记录）， KVStoreEngine 全部混合写路径统一（兑现真原子宣称，崩溃无新旧行并存） - WAL full 模式写入失败抛错（此前 console.warn 吞错 → 崩溃即丢且无感知） - MemoryEngine SET NULL 级联索引残留：复用 removeIndexEntries（消除虚假 UNIQUE_VIOLATION） - delete 级联两阶段：先全量 RESTRICT 预检（沿 CASCADE 链递归）再执行，无部分级联 （Memory/Aria 对齐） - BufferPool 驱逐同步清理 pages Map（EvictionManager onRemove 回调，内存预算真实生效） - MVCC commit 清理已提交版本（版本链仅作事务内 undo，消除行数据双份常驻） - LSM.flush 重复入链修复（入链即置空 immutable）+ frozenMemtables 可见性时序 - rollbackToSavepoint 重建受影响表二级索引（消除过期索引条目） 测试 1114 → 1126（71 套件）；行覆盖率 89.7%；版本 0.6.3	2026-08-13 10:30:39 +08:00
thzxx	ef1934a38c	fix(P0): v0.6.2 数据正确性专项 — 深度审计 6 项修复 + 22 回归 ... - KVStoreEngine 数值主键 update 丢行（P0）：String 化主键回查不命中 → 误删 KV 行 （重启丢数据）；改为单次全表扫描 + 受影响集合过滤（兼消 O(N×M) 回查开销） - update 主键撞已有主键静默覆盖（P0，Memory/Aria）：抛 DUPLICATE_KEY，事务路径同拦截 - Aria 二级索引范围查询边界算法错误（P1）：Number(v)±1 构造 key 漏小数/字符串数据； 改全索引扫描 + matchWhere 过滤，边界语义统一 - Aria 索引列 IS NULL 返回空（P1）：null 等值/含 null 的 IN 不走索引（回退全表） - AriaEngine unique 约束未强制（P1）：insert 整批预检（批内互查+索引扫描，失败整批 不落库）+ update 排除自身旧条目检查；新增 LSM.prefetchPrefixRanges 批量预加载 - 非主键 update 索引旧值残留：统一传旧行清理（消除唯一性误报与索引膨胀） - EXPLAIN 写语句产生真实副作用（P2）：仅 SELECT 执行，UPDATE/DELETE 用 count 估算 测试 1092 → 1114（70 套件）；行覆盖率 89.6%；版本 0.6.2	2026-08-13 09:51:26 +08:00
thzxx	0e192e0d84	docs: 重写 README 与 site 站点 — 剥离历史版本注释、统一信息架构（核心特性/快速开始/API速览/引擎对比/AriaEngine 专章/项目状态）；更新 docs.html 存储模式对比表（移除 IndexedDB 遗留列）+ v0.6.1 修复记录；同步测试数 1093/70 套件/89.7%；修正 VERSION 常量 0.6.0→0.6.1 并重建 dist	2026-08-10 21:50:49 +08:00
thzxx	25bab0f9aa	feat: v0.6.1 — AriaEngine 可选自研 KVStore 后端（storageBackend: 'kv'）+ KVStore APPEND 日志类型 + 10 个 aria+kv 集成测试 + 文档全量同步	2026-08-10 14:52:38 +08:00
thzxx	8a78f27f7d	fix: v0.6.1 生产可用性深度审查 — MemoryEngine 级联环无限递归（P0）/ KVStore 多表事务与级联原子化 / 未open防护统一 / 27 个异常场景测试 + aria级联回归	2026-08-10 14:29:40 +08:00
thzxx	a9e1a281d3	fix: v0.6.0 复查修正 — KVStore 快照损坏水位 bug（metaSeq 误跳日志）+ 快照损坏测试盲区修复（此前篡改未生效）+ metaSeq 回归测试 + KVStoreEngine 真实浏览器 e2e（3 用例）+ 版本/配置文档校准	2026-08-10 14:11:44 +08:00
thzxx	24b3ca1079	release: v0.6.0 — 完全移除 IndexedDB，自研 KVStore 事务存储引擎（多key原子写/快照日志恢复/CRC自愈）+ KVStoreEngine + 旧库迁移工具 + 10万级压力验证 + 崩溃注入e2e	2026-08-10 13:56:04 +08:00
thzxx	334067d89e	release: v0.5.1 — 存储后端生产级硬化（CRC-32/全库加密/WAL分片/页面化存储/多标签页锁/e2e）+ 深度审查修复（假实现接线/死代码清理）	2026-08-10 12:07:00 +08:00
thzxx	cff98b0903	release: v0.4.4 — SSTable 编码修复（UTF-8 字节估算 + u32 长度字段 + v1/v2 双格式兼容），大内容不再崩溃	2026-08-09 21:34:28 +08:00
thzxx	d269bdfb75	release: v0.4.3 — 关闭时序与后台任务加固（close 排空、失败不吞错、compaction 竞态修复）+ 提交先 WAL	2026-08-09 19:48:06 +08:00
thzxx	22b0b1fad4	release: v0.4.2 — 生产就绪与崩溃自愈 + 问题清单修复 + 版本迭代	2026-08-09 19:15:37 +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	fda3f1ad34	fix: CI Node 18/20 下 aria-crypto 失败 — SubtleCrypto 跨 realm ArrayBuffer 兼容 ... - crypto.ts encryptPage/decryptPage 改传 TypedArray 视图(ArrayBuffer.isView 检查跨 realm 可靠) - jest.setup.js structuredClone polyfill 用跨 realm toString 标签检查 (修复 fake-indexeddb 存储 ArrayBuffer 被 JSON 破坏成 {} 的问题) - 新增 SSTable 加密真实路径测试(加密落盘→重载解密, 8 个测试) - aria/v025 固定 db 名改随机(fake-indexeddb 真实持久化后防表残留冲突) - Node 18/20/22/24 全矩阵 837 测试通过	2026-08-08 11:07:35 +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