v0.2.0 Release Notes - pardnchiu/KuraDB Docs

v0.1.0 -> v0.2.0

Summary

Rewires the server bootstrap so OpenAI secrets live in the OS keychain instead of a plaintext dotfile, lowercases the config directory to align with Unix conventions, and persists the listening URL to a fixed path for downstream consumers. Agenvoy tool manifest registration is paused while the surface stabilizes.

翻譯

重整 server 啟動流程：OpenAI 密鑰改由作業系統 keychain 讀取而非明文 dotfile、配置目錄改為小寫對齊 Unix 慣例、並將監聽 URL 寫入固定路徑供下游消費者取用。Agenvoy tool manifest 註冊在介面穩定前暫時停用。

⚠️ Breaking Changes

Config directory renamed to lowercase

Before: ~/.config/KuraDB/

After: ~/.config/kuradb/

Migration:

mv ~/.config/KuraDB ~/.config/kuradb

翻譯

配置目錄全小寫化以對齊 Unix 慣例與 ~/.config/agenvoy/。symlink ~/Kura_<db> 與品牌名 KuraDB 不變。

`.env` no longer auto-loaded by the binary

The joho/godotenv dependency was removed. .env is now sourced via the Makefile's include .env + export block. Running ./bin/kura directly no longer picks up .env.

Migration (pick one):

Run through make app so .env is loaded by Make.

Or move the API key into the OS keychain (now the primary lookup):

# macOS
security add-generic-password -s KuraDB -a OPENAI_API_KEY -w sk-...
# Linux
echo -n "sk-..." | secret-tool store --label "KuraDB/OPENAI_API_KEY" \
  service KuraDB account OPENAI_API_KEY

Or export the key in the parent shell before invoking the binary.

翻譯

OPENAI_API_KEY 優先從 OS keychain 讀取（macOS security / Linux secret-tool），找不到才退回 os.Getenv。.env 載入由 Makefile 接手，binary 直接呼叫時不再自動套用。

Agenvoy tool manifest registration paused

runHTTP no longer writes ~/.config/agenvoy/tools/api/rag_*.json on startup or removes them on shutdown. Existing manifests from prior versions are not cleaned up automatically.

Migration:

rm -f ~/.config/agenvoy/tools/api/rag_search_keyword.json
rm -f ~/.config/agenvoy/tools/api/rag_search_semantic.json
rm -f ~/.config/agenvoy/tools/api/rag_list_db.json

Consumers should read the new endpoint file (~/.config/kuradb/endpoint) for the current server URL instead.

翻譯

agenvoy.Register / Unregister 暫時註解，等介面穩定後恢復。消費者改讀 ~/.config/kuradb/endpoint 取得當前 server URL。

Changes

FEAT

Write http://localhost:<port> to ~/.config/kuradb/endpoint on startup, remove on shutdown (@pardnchiu) [bebdcd0]

翻譯

啟動時將 server URL 寫入 ~/.config/kuradb/endpoint，shutdown 時移除

REFACTOR

Rework server bootstrap: keychain-first OPENAI_API_KEY lookup, lowercase config dir, paused Agenvoy registration (@pardnchiu) [bebdcd0]

翻譯

重整啟動流程：OPENAI_API_KEY 改 keychain 優先、配置目錄改小寫、暫停 Agenvoy 註冊

CHORE

Drop github.com/joho/godotenv; delegate .env loading to Makefile (@pardnchiu) [bebdcd0]

翻譯

移除 github.com/joho/godotenv 依賴，.env 載入改由 Makefile 接管

Scope

cmd/app/main.go — REFACTOR
cmd/app/http.go — FEAT, REFACTOR
internal/openai/openai.go — REFACTOR
internal/agenvoy/agenvoy.go — REFACTOR
Makefile — UPDATE
go.mod, go.sum �� CHORE

Generated by SKILL