Repository navigation
Releases: avery20024/herdr-async-message-relay
Release list
v0.8.0
What's Changed
- feat: 新增 .hrelay 根目錄標記檔與 hrelay init by @avery20024 in #11
- feat: 新增實例管理指令與 Herdr 結束時自動退出 by @avery20024 in #12
- feat: 以 Herdr agent 名稱決定座位角色 by @avery20024 in #13
- chore: 準備 v0.8.0 發布 by @avery20024 in #14
Full Changelog: v0.7.0...v0.8.0
v0.7.0
What's Changed
- feat: 改善角色探索與親測介面 by @avery20024 in #9
- chore: 準備 v0.7.0 發布 by @avery20024 in #10
Full Changelog: v0.6.0...v0.7.0
v0.6.0
v0.6.0
Highlights
- Team-wide Claude question interception, default on, with a Ctrl+P setting and continuous lifecycle recording even while interception is off.
- Pointer-targeted wheel scrolling for the list, metadata and body; pinned muted notices and accented metadata values.
ggjumps to the first loaded message;G/Shift+gjumps to the last currently loaded message without fetching another page. Late pagination responses cannot override explicit jumps.
Important upgrade notice
This is a behavior change from v0.5.1. Missing team policy defaults to on; Claude roles without scoped Hooks and valid new-session initialization will defer notifications. Legacy per-role policy files are retained but no longer control dispatch; use claude-guard --team enable|disable|status instead of role enable/disable.
Publishing or installing the CLI does not upgrade a running worker, install Hooks, restart agents or enable production protection. Review the migration and recovery guide before upgrading. Team settings require both UI and worker support for v0.6.0. A deliberately staged team-off rollout is an explicit deployment choice, not an automatic migration default.
Configured valid Hooks continue recording when interception is off; Herdr blocked still prevents dispatch. No question or answer body is recorded. Missing completion never fabricates an end time or unlocks by timeout. Event history is append-only without automatic rotation; event and state files are not one transaction.
Validation and limits
Independent local review and Ubuntu/macOS PR CI passed, including Go race, 39 Python/PTY tests, dependency and sqlc consistency checks. Real Claude/Herdr end-to-end validation of this team-policy implementation and physical-mouse/manual terminal acceptance remain incomplete. This is an additional AskUserQuestion defense, not a guarantee against every race or every interactive dialog.
Metadata hard-wraps at cell boundaries, so words may break mid-word; terminal-native text selection may require a bypass modifier while mouse reporting is enabled. No queue DB migration, new dependency or TCP listener is introduced. Release artifacts and their checksums are provided below; non-native binaries are not claimed to have been executed on this machine.
繁體中文
本版重點
- 團隊共用、預設開啟的 Claude 問答攔截,支援
Ctrl+P設定;關閉攔截仍持續記錄已接線、有效 Hooks 的生命週期。 - 滑鼠依所在區域分派列表/資料/本文捲動,左下說明固定置底淡化,欄位值套用主題強調樣式。
gg跳至已載入第一筆;G/Shift+g跳至當時已載入末筆,不額外載入歷史。晚到分頁不可覆蓋明確跳轉。
升級前務必確認
v0.5.1 升級後不再是每角色 opt-in。 缺少團隊政策時預設攔截開啟,未接線/未初始化的 Claude 角色會延後通知;舊 role policy 保留但不再控制新版投遞。團隊設定要求 UI 與 worker 均支援 v0.6.0。
發布、安裝 CLI、替換運行中的 worker 與 Hooks 接線是不同操作。本版不自動修改 Claude 設定、安裝全域 Hooks、重啟座位或切換正式服務。請先查核既有 pending/session 資料,在隔離環境驗證真實新會話;尚未準備完成的團隊須明確安排過渡政策,不刪證據或偽造 ready。
關閉攔截不繞過 Herdr blocked,缺少完成事件不偽造結束/耗時,也不以逾時解鎖;不記錄問題或答案本文。持久事件日誌無自動輪替,與 state 並非跨檔交易。
驗證與限制
功能與版本提交已通過獨立本地及 Ubuntu/macOS PR CI,涵蓋 Go race、39 項 Python/PTY、依賴與 sqlc 一致性。真實 Claude/Herdr 團隊政策問答端對端、實體滑鼠及各終端手動畫面仍未完成,不因發布成功宣稱正式環境已升級或防護已生效。
欄位硬換行可能中斷長單字;滑鼠回報可能使終端原生文字選取需搭配繞過修飾鍵。沒有佇列 DB migration、新依賴或 TCP listener。
完整變更、遷移與復原:v0.6.0 發布說明、問答閘門文件。
v0.5.1
What's Changed
- docs: 重整安裝與主題導覽 by @avery20024 in #4
- fix: 修正未送出訊息重試與座位解析 by @avery20024 in #5
Full Changelog: v0.5.0...v0.5.1
v0.5.0
v0.5.0 — 訊息歷史終端介面
新功能
- 新增
hrelay ui:以唯讀介面查閱歷史訊息、篩選寄件/收件角色與狀態、瀏覽完整本文,不變更佇列派送規則或資料庫 Schema。 - 固定上方歷史列表與下方詳細資料/本文區,下方採 40%/60% 配置;窄終端改用卡片呈現,最低支援 20×10,兩個詳細區可獨立翻頁。
- 支援手動刷新、一秒自動刷新、選取保留、載入取消及離線舊資料提示。
- 新增 Terminal、Catppuccin Latte、Dracula、Rosé Pine、Vesper 主題;支援英語與繁體中文,以及帳號共用的語言/主題偏好。
- 新增
?快捷鍵說明:62×27 置中彈窗,小終端自動縮小;單欄精簡清單、統一背景、標題跟隨主題一般文字色,底部固定退出提示。
常用鍵位
j/k或方向鍵:選取訊息;u/d:列表半頁。U/D:本文翻頁;[/]:詳細資料翻頁。Ctrl+F:篩選;P(Shift+P):清除已套用篩選。Ctrl+P:偏好設定;Ctrl+R:僅重載設定。r:刷新訊息;Ctrl+W:切換自動刷新。?:說明;Esc:關閉說明;q或Ctrl+C:離開主介面。
使用與相容性
- 使用新介面時,CLI 與 worker 應搭配 v0.5.0;下載或發布本身不會升級、安裝或重啟現有服務。
- 偏好預設存於帳號設定目錄的
hrelay/ui-preferences.json;可用絕對路徑HERDR_RELAY_UI_CONFIG隔離。採嚴格驗證、私有檔案權限與原子寫入,外部變更須手動重載。 NO_COLOR或不支援色彩的終端不輸出顏色。
驗證與已知限制
- 本地獨立審核、Ubuntu/macOS CI、sqlc 再現及 race 測試通過;包含 36 項 Python 測試與 10 項 PTY 測試。
- Latte 標題使用一般文字色,對比為 5.17:1。
- 窄矮終端的說明內容可捲動,但沒有捲動提示;說明開啟時外部底欄留白,部分刷新/設定回饋需關閉說明後查看,背景刷新仍持續。
- 真機終端/IME、部分早期未保存回歸腳本與 Shift+/ 實際編碼尚未完整驗證;部分極窄畫面的提示可能縮短。
下載
提供 darwin/linux × arm64/amd64 四平台壓縮檔與 checksums.txt。每個套件包含 hrelay、LICENSE、README.md 及 THIRD_PARTY_NOTICES.txt;請下載符合平台的套件並核對 SHA-256。
v0.4.0
What's Changed
- feat: 整合問答閘門與指令說明 by @avery20024 in #1
New Contributors
- @avery20024 made their first contribution in #1
Full Changelog: v0.3.0...v0.4.0
v0.3.0
Highlights
- Add English and Traditional Chinese native CLI help and diagnostics. Select
--lang en,--lang zh-TW, or--lang autobefore the subcommand, or setHERDR_RELAY_LANG. - Automatically select a supported display language from
LC_ALL,LC_MESSAGES, orLANG; unsupported or absent system locales fall back to English. Explicit unsupported choices fail instead of silently falling back. - Replace the AI batch header, independence/authorization reminder, and message boundaries with concise, fixed English. Preserve original message bodies, complete IDs, role identities, FIFO order, and rendered byte limits.
- Include bilingual documentation and the optional stable-role wrapper example.
Compatibility
Successful command output remains machine-readable JSON. API fields, state values, original bodies, and raw API error evidence are unchanged. Language selection is per CLI invocation; it does not change service registration, restart a worker, or resume a paused queue. External OS/Go/Herdr diagnostics and the optional Bash wrapper's own messages are not translated.
Delivery semantics are unchanged: accepted means durably stored, and submitted is not a read or task-acceptance receipt. This release does not add end-to-end receipts or change interactive-form detection.
Install
herdr plugin install avery20024/herdr-async-message-relay --ref v0.3.0Four checksummed binaries are provided for macOS/Linux on arm64/amd64. Installation does not require Go.
Updating the native CLI alone does not replace a healthy running worker. Apply the new envelope through an operator-controlled worker upgrade. A restart can leave an in-flight batch uncertain; inspect before retrying rather than blindly replaying messages.
Linux native systemd user-session startup/shutdown remains unverified; cross-compilation and CI do not replace that validation.