agent-lyceum 0.4.9 → 0.4.11

package/README.md

@@ -44,7 +44,7 @@ Without `--project`, the project is the registered one whose `dir` is the longes
 
 ## Monitor plugin (Claude Code)
 
-`plugins/agent-lyceum-monitor` is a Claude Code plugin that shows live run status for one or several projects.
+`plugins/agent-lyceum-monitor` is a Claude Code **mod**: a plugin made of hooks (status line, toasts, a `/team-monitor` pane) that runs inside the Claude Code session and polls `agent-lyceum status --json`. It needs a Claude Code build that supports mods (the `claude-code` hooks API); it does not change how agent-lyceum itself runs. It shows live run status for one or several projects.
 
 **Load it.** Build first (`npm run build`; the plugin runs `dist/cli.js`), then start a session with:
 
@@ -52,11 +52,11 @@ Without `--project`, the project is the registered one whose `dir` is the longes
 claude --plugin-dir /path/to/agent-lyceum/plugins/agent-lyceum-monitor
 ```
 
-`--plugin-dir` only applies when a session starts; an already-open session must be restarted (`claude --resume --plugin-dir ...` keeps the conversation). To load it every time, add `alias claude='claude --plugin-dir /path/to/agent-lyceum/plugins/agent-lyceum-monitor'` to your shell rc.
+`--plugin-dir` only applies when a session starts; an already-open session must be restarted (`claude --resume --plugin-dir ...` keeps the conversation). To load it every time, add `alias claude='claude --plugin-dir /path/to/agent-lyceum/plugins/agent-lyceum-monitor'` to your shell rc, or, for hosts where you cannot pass a flag (desktop app, SDK), set `CLAUDE_CODE_PLUGIN_DIRS` to the plugin folder. While a session is running, saving a file in the plugin folder hot-reloads it.
 
 **Use it.**
 - **Status line:** always on once loaded; shows the run state, round `n/max`, output tokens, the current step and unread mail. With several projects it shows one overview line (`team 1/3 running · a ... | b ...`).
-- **Toasts:** a message pops up when a run finishes or fails (prefixed `[project]` when several are watched). Nothing to do.
+- **Toasts:** a message pops up when a run finishes, is interrupted, or an agent's wake fails (prefixed `[project]` when several are watched). Nothing to do.
 - **`/team-monitor`:** type it in the prompt to open the pane. It shows, per project: the run id and state, task, progress and checklist, the agents working now and the queued mail, blocked integrations, notes and result summary, output tokens per runtime, per-agent wake statistics, the last 8 wakes and the last 5 runs. It refreshes with the polling interval while open. Click **關閉** (Close) to dismiss it.
 
 **Configure it.** In `~/.claude/settings.json` under `pluginConfigs."agent-lyceum-monitor@inline"` (`options`):

package/README.zh-TW.md

@@ -44,7 +44,7 @@ npx agent-lyceum status
 
 ## 監控 plugin（Claude Code）
 
-`plugins/agent-lyceum-monitor` 是 Claude Code plugin，會顯示一個或多個專案的即時執行狀態。
+`plugins/agent-lyceum-monitor` 是 Claude Code **mod**：由 hook 組成的 plugin（狀態列、通知、`/team-monitor` 面板），在 Claude Code session 內執行，並輪詢 `agent-lyceum status --json`。需要支援 mod 的 Claude Code 版本（`claude-code` hooks API）；不會改變 agent-lyceum 本身的運作。會顯示一個或多個專案的即時執行狀態。
 
 **載入。** 先 build（`npm run build`；plugin 會執行 `dist/cli.js`），再用下面的指令啟動 session：
 
@@ -52,11 +52,11 @@ npx agent-lyceum status
 claude --plugin-dir /path/to/agent-lyceum/plugins/agent-lyceum-monitor
 ```
 
-`--plugin-dir` 只在 session 啟動時生效，已開著的 session 要重開（`claude --resume --plugin-dir ...` 可保留對話）。想每次都載入，就在 shell rc 加 `alias claude='claude --plugin-dir /path/to/agent-lyceum/plugins/agent-lyceum-monitor'`。
+`--plugin-dir` 只在 session 啟動時生效，已開著的 session 要重開（`claude --resume --plugin-dir ...` 可保留對話）。想每次都載入，就在 shell rc 加 `alias claude='claude --plugin-dir /path/to/agent-lyceum/plugins/agent-lyceum-monitor'`；無法帶參數的環境（桌面 app、SDK）則把 `CLAUDE_CODE_PLUGIN_DIRS` 設成 plugin 資料夾。session 執行中儲存 plugin 資料夾內的檔案會自動 hot reload。
 
 **操作。**
 - **狀態列：** 載入後常駐，顯示執行狀態、輪數 `n/max`、output tokens、目前步驟與未讀信件。監看多個專案時顯示一行總覽（`team 1/3 執行中 · a ... | b ...`）。
-- **通知：** 執行完成或失敗時會跳出訊息（監看多個專案時前面加 `[專案名]`），不需要任何操作。
+- **通知：** 執行完成、被中斷或某個 agent 喚醒失敗時會跳出訊息（監看多個專案時前面加 `[專案名]`），不需要任何操作。
 - **`/team-monitor`：** 在輸入框輸入即可開啟面板。每個專案顯示：執行 id 與狀態、任務、進度與清單、正在工作的 agent 與排隊中的信件、受阻的整合、備註與結果摘要、各 runtime 的 output tokens、各 agent 的喚醒統計、最近 8 次喚醒與最近 5 次執行。面板開著時會依輪詢間隔自動更新，按 **關閉** 即可收起。
 
 **設定。** 在 `~/.claude/settings.json` 的 `pluginConfigs."agent-lyceum-monitor@inline"`（`options`）：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-lyceum",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "description": "Config + dispatcher for teams of Claude Code / Codex agents with scoped context and file-based mailboxes",
   "keywords": [
     "ai",