wangdl/zhixi-document-runtime
1
0
Fork 0
Code Issues 15 Pull Requests Actions Packages Projects Releases Wiki Activity
55 Commits 1 Branch 0 Tags
Commit Graph

55 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
wangdl
6ae4157c7c fix: cleanup_stale_sessions_v2 also removes orphaned trackers 
Review finding #4: trackers without a corresponding session (e.g., after
lock poisoning during remove) are now cleaned up during stale sweep.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 21:34:06 +08:00
wangdl
5d6bf41cab fix: close_reading_session_v2 takes timestamp, sets closed_at_ms 
Review finding #3: close now accepts timestamp_ms and sets closed_at_ms
automatically, removing the need for a separate set_session_closed_at_ms call.
set_session_closed_at_ms retained for override use cases.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 21:33:42 +08:00
wangdl
d21c93db1e fix: mark_events_failed_v2 idempotent for already-Failed events 
Review finding #2: duplicate mark_failed calls double-counted retry_count.
Now skips events already in Failed state. Added test_mark_failed_idempotent.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 21:31:45 +08:00
wangdl
37f2d9ad7f fix: architecture doc - ReadingMaterialRef → ReadingMaterialRefV2 
Review finding #1: section 3.3 still referenced old V1 type name.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 21:31:20 +08:00
wangdl
af2bfe7c42 docs: V1→V2 compatibility layer (DOC-FULL-034) 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 21:20:28 +08:00
wangdl
e73575205c docs: iOS ReadingEvent V2 integration example (DOC-FULL-008) 
Swift pseudocode showing full V2 event pipeline:
openSession → heartbeat → position → markedAsRead → closeSession
→ export → local queue → ack → error handling → crash recovery

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 21:19:42 +08:00
wangdl
b08fe28525 feat: FFI DTO V2 completion - add EventBufferStateV2 (DOC-FULL-007) 
- 新增 EventBufferStateV2 结构体 (total/pending/exported/failed)
- 新增 get_event_buffer_state_v2() 方法
- FFI 导出 EventBufferStateV2 类型 + 方法
- FFI V2 exports 审计: 6 DTO + 9 方法全部到位
- V1 保留 deprecated，V2 接口显式带 V2 后缀

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 21:13:56 +08:00
wangdl
7f79802e0a docs: update V2 architecture to reflect DOC-FULL-001~006 changes 
- ReadingMaterialRef → ReadingMaterialRefV2 (full fields, camelCase)
- ReadingSessionV2: add closed_at_ms, Interrupted/Failed statuses
- EventBuffer: add reload_stale_events_v2, buffer_size_v2
- V1/V2 diff table: add session status/recovery rows
- Verification chain: add startup recovery + V2 MaterialRef

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 21:10:58 +08:00
wangdl
a29ee12fac feat: ReadingEvent V2 delta semantics verification (DOC-FULL-003) 
- 新增 test_delta_semantics_per_event_type: 验证所有 5 种事件类型的
  activeSecondsDelta 均为增量语义（非累计值）
- ReadingEventV2 + ReadingEventTypeV2 已有完整实现（610行/22测试）
- No readingTargetType/userId/knowledgeBaseId（编译时保证）

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 21:05:17 +08:00
wangdl
c30957e1da feat: ReadingSession V2 complete (DOC-FULL-002) 
- 新增 ReadingSessionStatus::Interrupted / Failed
- ReadingSessionV2 增加 closedAtMs 字段
- 新增 mark_session_interrupted_v2 / mark_session_failed_v2
- 新增 get_active_session_v2 (按 materialId 查 active session)
- 新增 set_session_closed_at_ms (独立设置关闭时间)
- FFI 暴露 6 个新接口
- SessionError 补充 AlreadyInterrupted / AlreadyFailed
- 167 tests passed / 0 failed

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 21:03:19 +08:00
wangdl
c276503b0d feat: ReadingMaterialRef V2 (DOC-FULL-001) 
- 新增 ReadingMaterialRefV2: materialId/filePath/fileName/fileType
  (camelCase) + mimeType/fileSize/contentHash/createdAtMs (可选)
- V1 ReadingMaterialRef 标记 deprecated，保留向后兼容
- session_v2 迁移到 V2 类型
- FFI 层暴露 V2 类型，start_reading_session_v2 接收 V2
- 明确禁止字段: readingTargetType/userId/knowledgeBaseId
- 160 tests passed / 0 failed

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-11 20:59:43 +08:00
wangdl
a81a9d7e1f fix: add reload_stale_events_v2 FFI export + update UDL with V2 types + XCFramework rebuild 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-09 19:58:07 +08:00
wangdl
3b0625ffbb fix: DOC-FULL V1 export deprecated 2026-06-07 20:33:53 +08:00
wangdl
5fb372eb58 feat: DOC-FULL #63 #64 #70 DocumentInfo + Position restore 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 20:31:59 +08:00
wangdl
6499e59718 fix: DOC-FULL #57 #60 iOS doc + xtask verify-ios 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 20:26:48 +08:00
wangdl
b22df85891 feat: DOC-FULL Batch 1 FFI + Compat 
#56 FFI DTO V2 exports (done in A1)
#83 V1 deprecated annotations
#84 V2→API protocol mapping doc

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 20:26:05 +08:00
wangdl
01a64320cc fix: DOC-FULL A1-A8 审查修复 
A1: FFI 导出 V2 函数 (start/pause/resume/close/push/export/ack/mark)
A2: ActiveTimeTracker 集成到 session_v2
A3: push_event 调用 position.normalized()
A4: remove_session 检查 Closed 状态
A5: Buffer 溢出驱逐 if-let 链修正
A8: reload_stale_events_v2() 启动恢复

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 20:16:39 +08:00
wangdl
366ed88317 feat: DOC-FULL-006 EventBuffer ack/failed/state 
BufferedReadingEventV2{event, state: Pending|Exported|Failed, retry_count}
export_pending_events_v2(limit, ts) - marks as Exported
ack_events_v2(eventIds) - removes by eventId
mark_events_failed_v2(eventIds) - for retry
Overflow: Failed→Exported→oldest eviction

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 19:54:34 +08:00
wangdl
661d21de8f fix: DOC-FULL-005 ReadingPosition camelCase + clamp 
Manual Serialize for camelCase JSON output
Clamp progress 0~1 (NaN→0, <0→0, >1→1)
normalized() + progress_value() methods
Backward-compatible Deserialize with #[serde(rename)]

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 19:49:49 +08:00
wangdl
66649bb815 feat: DOC-FULL-004 ActiveTimeTracker 
iOS控制tick节奏，Rust计算delta。start/pause/resume/tick/close。
毫秒余数累计。时间倒退不产生负数。8单元测试。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 19:41:09 +08:00
wangdl
82e8cdfc1f feat: DOC-FULL-003 ReadingEventV2 
5 types: MaterialOpened/Closed/PositionChanged/Heartbeat/MarkedAsRead
active_seconds_delta (增量)
集成 ReadingSessionV2 (clientSessionId/sequence/materialId)
10 单元测试

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 19:37:19 +08:00
wangdl
938ebf890c feat: DOC-FULL-002 ReadingSessionV2 
- clientSessionId UUID 生成
- start/pause/resume/close lifecycle
- sequence 递增
- record_session_event_v2 更新时长和位置
- 7 个单元测试

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 19:34:12 +08:00
wangdl
855c7b15c2 feat: DOC-FULL-001 ReadingMaterialRef 
Rust 只保存 materialId，不区分 KnowledgeSource/TemporaryFile。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 19:26:48 +08:00
wangdl
22276bd44e feat: DOC-FULL-000 完整架构文档 v2 
7 设计决策、V2 核心模型、V1→V2 迁移、API 协议映射、项目结构、验收链路

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-07 19:23:56 +08:00
wangdl
dd360c88e2 fix: RagChatModule 导入 AiModule，修复 AiGatewayService 未注入 
AiGatewayService 使用了 @Optional() 导致不报错但始终为 null，
sendMessage 永远走 fallbackReply。现在导入 AiModule 正确注入。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-06 13:38:57 +08:00
wangdl
2f816510a9 fix: #44 events.rs Mutex poison 时恢复而非静默丢事件 
push_reading_event 改用 match 替代 if let，poison 时通过 into_inner 恢复缓冲区。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-06 13:00:37 +08:00
wangdl
e2c9d3063f fix: #41 detect_material_type 只读前 8KB 做魔数检测 
std::fs::read 整个文件 → File::open + read 前 8192 字节，节省大文件内存。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-06 12:59:19 +08:00
wangdl
0bca088933 fix: #48 markdown.rs 处理 FrontMatter 和 FootnoteDefinition 节点 
FrontMatter → CodeBlock(language=yaml)
FootnoteDefinition → Paragraph

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-06 12:56:45 +08:00
wangdl
fb67b1c13d fix: #39 from_bytes_separate 检查 RustCallStatus 返回值 
分配失败时将 out 参数置零并 return，避免返回未初始化栈垃圾。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-06 12:55:37 +08:00
wangdl
fc9e4eec81 fix: #38 EVENT_BUFFER 增加 MAX_BUFFER_SIZE=1000 上限 
push_reading_event 时超出上限自动丢弃最旧事件，防止未导出事件堆积导致 OOM。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-06 12:55:00 +08:00
wangdl
1a246445fe feat: #37 Batch2+3 — 全部函数迁移到 out-pointer FFI 
新增 8 个 _separate 函数：
- push_reading_event_separate
- update_reading_position_separate
- export_pending_events_separate
- create_note_anchor_separate
- search_markdown_blocks_separate
- search_text_content_separate

新增 lift_from_raw! 宏用于从原始 buffer 参数反序列化复杂类型。
原 #[uniffi::export] 函数保留（macOS/Android 路径可用）。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-06 12:51:50 +08:00
wangdl
c09caab0e6 feat: #37 Batch1 — detect_material_type/read_image_meta/read_text_stats/parse_text out-pointer FFI 
新增 4 个 _separate 函数绕过 RustBuffer struct-passing：
- ffi_zx_document_ffi_detect_material_type_separate
- ffi_zx_document_ffi_read_image_meta_separate
- ffi_zx_document_ffi_read_text_stats_separate
- ffi_zx_document_ffi_parse_text_separate

提取 write_result_to_out! 宏和 read_str_input helper 减少样板代码。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-06 12:45:56 +08:00
wangdl
65c9ab8a50 fix: #47 移除所有调试 eprintln! 日志 
清理 FFI 调试期间在 lib.rs 和 markdown.rs 中添加的 16 行 eprintln!
调试日志，spam iOS 控制台。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-06 12:40:48 +08:00
wangdl
bae6ef5726 feat: M3 completion — event buffer, FFI search/anchor, PDF strategy, quality fixes 
Rust Core:
- events: global Mutex-buffered event queue (push/export/clear/update_position)
- image_meta: use ImageReader::format() for real decoded format instead of extension
- search: change match_start/match_end usize→u64 for FFI compatibility
- epub/pdf: module-level placeholder comments

FFI (UDL exposed, 12 total functions):
- Added: search_markdown_blocks, search_text_content, create_note_anchor
- Added: push_reading_event, update_reading_position, export_pending_events,
  clear_exported_events

Docs:
- README: synced DocumentBlock model (Table.headers + HorizontalRule),
  simplified dependency recommendations, removed nonexistent doc references
- docs/pdf-strategy.md: PDFKit vs PDFium vs MuPDF evaluation, 5 decisions,
  platform strategy matrix, roadmap

Build:
- .cargo/config.toml: cargo xtask alias
- xtask: CLI implementation (test/build-ios/fixtures commands)
- fixtures: markdown/sample.md (9 block types), text/sample.txt
- XCFramework rebuilt, Swift bindings regenerated (1977 lines)

58 tests pass, zero warnings.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-02 21:23:26 +08:00
wangdl
25ad7490a3 feat: expose parse_text via FFI - returns paragraph blocks from TXT 2026-06-02 19:55:03 +08:00
wangdl
f8c0864b61 feat: expose parse_markdown via FFI - returns [DocumentBlock] with all 8 block types 2026-06-02 19:53:42 +08:00
wangdl
cfbee9ea53 feat: expose 3 FFI functions via UDL - detect_material_type, read_image_meta, read_text_stats 2026-06-02 19:45:54 +08:00
wangdl
917c7a4d2f feat: iOS integration docs + demo app skeleton 2026-06-02 19:33:45 +08:00
wangdl
6a0ac9c15c feat: iOS XCFramework build - device + simulator static libs 2026-06-01 20:09:29 +08:00
wangdl
ddcc5b392c feat: generated Swift bindings from UDL (48KB) 2026-05-30 22:13:22 +08:00
wangdl
9481cc20e9 feat: UniFFI setup - UDL interface, build.rs scaffolding, cargo check passes 2026-05-30 22:11:27 +08:00
wangdl
65bc52bfd7 feat: case-insensitive search for Markdown blocks and TXT text 2026-05-30 21:58:59 +08:00
wangdl
b5f8e273a9 feat: ReadingEvent serde tests + NoteAnchor with from_position constructor and tests 2026-05-30 21:18:30 +08:00
wangdl
b3a7fe0414 test: ReadingPosition serde round-trip tests for all 6 variants 2026-05-30 21:05:34 +08:00
wangdl
8166878bf8 feat: image metadata reading - width, height, format, file_size with fixture test 2026-05-30 20:59:50 +08:00
wangdl
af58a35b0a feat: TXT text reading - paragraph parsing, line/word stats 2026-05-30 20:55:30 +08:00
wangdl
c390718c15 feat: Markdown parsing with comrak - GFM tables, strikethrough, tasklist, all 11 block types 2026-05-30 20:50:54 +08:00
wangdl
43010221ff feat: detect_material_type - file type identification via magic bytes + MIME + extension 2026-05-30 20:34:30 +08:00
wangdl
a0aaf9b713 docs: app-rust-bridge - complete FFI call protocol 2026-05-30 20:27:52 +08:00
wangdl
8042a9d92e feat: core data models - MaterialType, DocumentBlock, ReadingPosition, ReadingEvent, NoteAnchor, SearchResult, DocumentError 2026-05-30 20:22:16 +08:00