Commit Graph

8 Commits

Author SHA1 Message Date
skycurtain 63e4610833 fix(array-tracer): 修复初始数组长度元数据未更新的问题
在构建初始数组时,同步更新metadata.length,确保元数据与数组实际状态一致。
2026-03-04 14:48:22 +08:00
skycurtain 5a80d653c1 refactor(array-tracer): 移除泛型默认值并重命名参数
- 移除 `T extends JsonValue = JsonValue` 中的默认类型参数
- 将接口中的 `item` 参数重命名为 `element` 以提高可读性
- 删除被注释掉的调试代码 `console.log`
2026-03-04 14:45:57 +08:00
skycurtain a0c0c17984 refactor(tracers): 简化 ArrayTracerMetadata 为接口类型
将类型别名改为接口声明,并移除已被注释的属性,使类型定义更清晰。
2026-03-04 11:24:10 +08:00
skycurtain 9aad52347b refactor(tracers): 统一命令字段名并重构数组追踪器创建逻辑
- 将所有命令的 `params` 字段重命名为 `payload`,以保持命名一致性
- 将 `ArrayTracerCreateOptions` 从联合类型简化为单一接口,移除 `array` 参数,新增 `initial` 和 `walker` 参数
- 引入 `buildInitial` 函数集中处理初始数组的构建逻辑
- 使用 `metadata` 对象管理数组长度状态,替代独立的 `arrayLength` 变量
- 更新错误消息格式,移除方括号前缀
- 调整泛型参数,使 `createArrayTracer` 更通用
2026-03-04 02:34:12 +08:00
skycurtain 4929ca496b feat: 新增 GraphTracer 并重构 ArrayTracer 的初始化方式
- 新增 GraphTracer 及其类型定义,支持图的创建和操作命令
- 重构 ArrayTracer 的 create 函数,使用 walker/commit 模式替代直接的 array 参数,提高灵活性
- 更新类型导出和命令联合类型以包含 GraphTracer
- 调整示例代码以使用新的初始化方式
2026-02-14 01:30:30 +08:00
skycurtain a3328b8617 fix(array-tracer): 修正创建命令中数组参数的必填性
将 `ArrayTracerCreateCommand.params.array` 从可选参数改为必填参数,以匹配实际实现逻辑。
同时更新 `createArrayTracer` 函数,确保在未提供 `array` 时使用空数组作为默认值,保持向后兼容性。
2026-02-08 23:29:24 +08:00
skycurtain 5cc4f96b46 docs: 新增设计决策文档并实现数组追踪器校验
- 新增决策文档:移除 preset 指令,将其合并到 create 指令中,以简化生命周期和系统复杂度
- 新增决策文档:确立 SDK 侧影子状态校验机制,实现快速失败和最小必要状态原则
- 在 ArrayTracer 中实现影子状态校验,维护数组长度并进行索引边界检查
2026-02-06 01:56:52 +08:00
skycurtain a3bbd5638a refactor: 重构项目结构,将 tracer 模块提取为独立子包
- 将 tracer 相关代码移动到 tracers.ts 子目录中
- 新增类型定义文件,统一管理命令类型
- 实现上下文管理机制,集中处理 tracer 命令
- 更新构建配置和依赖管理
- 移除旧的根目录文件,保持代码结构清晰
2026-02-04 13:45:17 +08:00