From 283eb669648a625c416e800e606f2224e4d9761d Mon Sep 17 00:00:00 2001
From: Developer <dev@local>
Date: Wed, 8 Apr 2026 08:25:28 +0800
Subject: [PATCH] chore: bump version to 0.6.3 and update changelog

Changes:
- Add v0.6.3 changelog with Index Creation Guard (#70), LanceDB 0.27.2
- Update README.md and README_zh.md Version History
- Update Latest Version to v0.6.3

Evidence:
- Code: src/store.ts, test/unit/index-race-condition.test.ts
- Tests: 123 unit tests pass
---
 CHANGELOG.md | 33 +++++++++++++++++++++++++++++++++
 README.md    |  5 +++--
 README_zh.md |  3 ++-
 package.json |  2 +-
 4 files changed, 39 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 956bfd1..67a7d88 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,39 @@ Format follows [Keep a Changelog](https://keepachangelog.com/). Versions follow
 
 ---
 
+## [0.6.3] - 2026-04-08
+
+### Added
+
+- **Index Creation Guard for Empty Tables** (user-facing):
+  - Added row count check before attempting vector/FTS index creation to prevent noisy error messages
+  - LanceDB IVF/PQ indices require ≥256 rows for training data
+  - Silently defers index creation with info-level log instead of 3 retry error messages
+  - Evidence:
+    - Spec: N/A (bug fix, no spec required)
+    - Code: src/store.ts (MIN_ROWS_FOR_INDEX constant, countRows guard in createVectorIndexWithRetry/createFtsIndexWithRetry)
+    - Tests: test/unit/index-race-condition.test.ts (6 new test cases)
+    - Surface: internal-api
+  - Fixes #70
+
+### Changed
+
+- **LanceDB Version Bump** (internal-only):
+  - Upgraded `@lancedb/lancedb` from `0.27.1` to `0.27.2`
+  - Evidence:
+    - Code: package.json, package-lock.json
+    - Tests: typecheck, build, test:foundation (31 pass), test:retrieval (2 pass)
+  - Related: #69
+
+### Documentation
+
+- **Test Database Directories** (internal-only):
+  - Added test database directories to .gitignore
+  - Evidence:
+    - Code: .gitignore
+
+---
+
 ## [0.6.2] - 2026-04-05
 
 ### Added
diff --git a/README.md b/README.md
index 96e41e2..4e1f600 100644
--- a/README.md
+++ b/README.md
@@ -173,6 +173,7 @@ Alternatively, install via `.tgz` release asset or build from source. See [Insta
 
 ## 🗺️ Version History
 
+- **v0.6.3**: Index Creation Guard (defer on empty/insufficient tables, fix #70), LanceDB 0.27.2
 - **v0.6.2**: Index Race Condition Fix (concurrent-process conflict handling, jitter backoff)
 - **v0.6.1**: Event TTL/Archival, Index Creation Resilience, Duplicate Consolidation Performance
 - **v0.6.0**: Learning Dashboard, KPI Pipeline, Feedback-Driven Ranking, Task-Type Aware Injection
@@ -198,5 +199,5 @@ See [CHANGELOG.md](CHANGELOG.md) for all changes.
 - **Issues**: Submit errors or requests on [GitHub Issues](https://github.com/tryweb/lancedb-opencode-pro/issues).
 - **License**: MIT License - see [LICENSE](LICENSE).
 
-**Last Updated**: 2026-04-05
-**Latest Version**: v0.6.2
+**Last Updated**: 2026-04-08
+**Latest Version**: v0.6.3
diff --git a/README_zh.md b/README_zh.md
index 0c2c37c..36fcc48 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -166,6 +166,7 @@ docker compose exec opencode-dev npm run verify:full
 
 ## 🗺️ 版本歷史
 
+- **v0.6.3**: 索引建立守衛（空表/不足資料時延後建立，修復 #70）、LanceDB 0.27.2
 - **v0.6.2**: 修復索引競爭條件（並發衝突處理、jitter 重試）
 - **v0.6.1**: 事件 TTL/歸檔、索引建立彈性、去重複效能優化
 - **v0.6.0**: 新增學習儀表板、KPI 管線、反饋驅動排序、任務類型感知注入
@@ -191,5 +192,5 @@ _[舊版歷史請參閱 CHANGELOG.md]_
 - **報告問題**: 軟體錯誤回報或功能請求，請至 [GitHub Issues](https://github.com/tryweb/lancedb-opencode-pro/issues) 提交。
 - **授權協議**: MIT License - 詳見 [LICENSE](LICENSE)。
 
-**最後更新**: 2026-04-05
+**最後更新**: 2026-04-08
 **最新版本**: v0.6.2
diff --git a/package.json b/package.json
index dd7ecce..1f3091f 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "lancedb-opencode-pro",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "LanceDB-backed long-term memory provider for OpenCode",
   "type": "module",
   "main": "dist/index.js",