Skip to content

feat(v0.19.0): SQLite WAL + devkit_index_health + roadmap overhaul#37

Merged
juice094 merged 1 commit into
mainfrom
feat/v0.19.0-storage-reliability
May 14, 2026
Merged

feat(v0.19.0): SQLite WAL + devkit_index_health + roadmap overhaul#37
juice094 merged 1 commit into
mainfrom
feat/v0.19.0-storage-reliability

Conversation

@juice094
Copy link
Copy Markdown
Owner

Sprint A — 存储可靠性加固

解决用户反馈的"玩具感"核心问题:devbase 首先是一个可靠的本地知识基础设施,然后才是一个 World Model Compiler。

变更摘要

模块 变更
SQLite WAL migrate.rs + storage.rs 双点注入 journal_mode = WAL,解决 111MB registry.db 并发锁定问题
devkit_index_health 新增第 65 个 MCP Tool,返回索引健康评分 (0-100) + schema 有效性 + consistency 诊断
文档联动 README 四层纵深架构图、AGENTS.md §知识库缺口、ROADMAP.md v0.19.0–v0.21.0 路线图
Vault 认知 knowledge-base-production-gap.md + sprint-a-storage-reliability-report.md
代码质量 cargo clippy --fix 自动清理 6 个 pre-existing 警告

关键技术决策

  • PRAGMA journal_mode = WAL 会返回结果行,必须使用 rusqlite::Connection::pragma_update() 而非 execute()
  • devkit_index_health 复用已有 list_indexed_repo_ids_at / orphan_tantivy_docs / RepairResult 基础设施,零新增外部依赖

验证

  • cargo test --all-targets → 464 passed, 0 failed
  • cargo clippy --all-targets -D warnings → 0 warnings
  • cargo fmt --check → clean

关联

  • Closes: 用户反馈"担心实际使用中是玩具而非生产力工具"
  • 遵循: AGENTS.md §知识库生产级缺口与补齐路线、v0.19.0 约束红线

Sprint A — 存储可靠性加固落地:

- SQLite WAL 双点注入(migrate.rs init_db_at + storage.rs build_pool)
  - 使用 pragma_update 而非 execute,避免 PRAGMA 返回结果 panic
- 新增 devkit_index_health MCP tool(第 65 个 tool)
  - 返回 overall_score (0-100)、schema_valid、num_docs、consistency
  - 复用 list_indexed_repo_ids_at + orphan_tantivy_docs + RepairResult 逻辑
- 文档联动更新
  - README: 四层纵深架构图 + Reliability Layer 显式化
  - AGENTS.md: §知识库生产级缺口与补齐路线 + 阶段升级
  - ROADMAP.md: v0.19.0–v0.21.0 Sprint 规划 + 验收标准
- Vault 认知沉淀: knowledge-base-production-gap + sprint-a-report
- clippy --fix: 自动清理 6 个 pre-existing 警告

验证: cargo test --all-targets 464 passed, clippy -D warnings 全绿
@juice094 juice094 merged commit 698953d into main May 14, 2026
6 checks passed
@juice094 juice094 deleted the feat/v0.19.0-storage-reliability branch May 14, 2026 04:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant