Skip to content

v0.2.0

Choose a tag to compare

@pardnchiu pardnchiu released this 24 May 07:19

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