agent-lyceum 0.33.0 → 0.34.0

package/README.md

@@ -90,4 +90,5 @@ Likewise, older versions refuse a `project.yaml` that contains `verify` ("Unreco
 | Letting an agent search or fetch the web | [Web access](docs/web-access.md) |
 | Live run status inside Claude Code (a framed, state-coloured tree of agents; pane or full-width band) | [Monitor mod](docs/monitor.md) |
 | All commands in full | [Commands](docs/commands.md) |
+| A task file template (scope, acceptance criteria, verification) | [Task template](docs/task-template.md) |
 | Coming from an older version | [Upgrading to run v2](docs/upgrading-run-v2.md) |

package/README.zh-TW.md

@@ -90,4 +90,5 @@ agents:
 | 讓 agent 搜尋或讀取網頁 | [網路存取](docs/web-access.zh-TW.md) |
 | 在 Claude Code 內看即時 run 狀態（每個 agent 一個依狀態上色的外框，樹狀排列；面板或整寬橫幅） | [監控 mod](docs/monitor.zh-TW.md) |
 | 所有指令的完整說明 | [指令](docs/commands.zh-TW.md) |
+| 任務檔範本（範圍、驗收條件、驗證指令） | [任務檔範本](docs/task-template.zh-TW.md) |
 | 從舊版升級 | [升級到 run v2](docs/upgrading-run-v2.md) |

package/dist/status-watch.d.ts

@@ -13,8 +13,19 @@ export type WatchFrame = {
  * A task that was running in the previous frame and has finished (completed or partial) since is included once more, so the reader sees
  * it finish (and can toast) before it is dropped. `tracked` is that previous set; it is replaced by the ids running now.
  */
+/**
+ * Reports of finished runs, kept so a sweep does not rebuild them (about 300 ms each). An entry is reused while the
+ * run's state.json is unchanged and it is younger than `FINISHED_TTL_MS`; the TTL picks up what lives outside that file
+ * (unread mail, memory advice).
+ */
+export type FinishedCache = Map<string, {
+    stamp: string;
+    at: number;
+    report: StatusReport;
+}>;
 export declare function buildWatchFrame(project: ResolvedProject, tracked: Set<string>, opts?: {
     allTasks?: boolean;
+    cache?: FinishedCache;
 }): WatchFrame;
 export interface WatchDeps {
     /** The project, loaded again each time so config edits and new runs show up. */

package/dist/status-watch.js

@@ -1,11 +1,16 @@
 import fs from "node:fs";
-import { buildStatusReport, buildTaskListReport, isFinishedRun } from "./status.js";
-/**
- * The frame for now. Every task that is not finished (running, interrupted, waiting for answers, or ended blocked,
- * failed or cancelled) gets its own report, so it stays listed until it is resumed or cleared.
- * A task that was running in the previous frame and has finished (completed or partial) since is included once more, so the reader sees
- * it finish (and can toast) before it is dropped. `tracked` is that previous set; it is replaced by the ids running now.
- */
+import path from "node:path";
+import { buildStatusReport, buildTaskListReport, currentRun, isFinishedRun } from "./status.js";
+const FINISHED_TTL_MS = 5 * 60_000;
+function stampOf(project, id) {
+    try {
+        const st = fs.statSync(path.join(project.paths.runs, id, "state.json"));
+        return `${st.mtimeMs}:${st.size}`;
+    }
+    catch {
+        return "";
+    }
+}
 export function buildWatchFrame(project, tracked, opts) {
     const all = buildTaskListReport(project).runs;
     const running = all.filter((r) => r.state === "running").map((r) => r.run_id);
@@ -13,9 +18,27 @@ export function buildWatchFrame(project, tracked, opts) {
     const runs = {};
     // The web page keeps every task. The terminal watch drops one after it has finished, once the finish has been seen.
     const ids = opts?.allTasks ? all.map((r) => r.run_id) : [...open, ...tracked];
-    for (const id of new Set(ids))
+    const finished = new Set(all.filter(isFinishedRun).map((r) => r.run_id));
+    const cache = opts?.cache;
+    const now = Date.now();
+    for (const id of new Set(ids)) {
+        const stamp = cache && finished.has(id) ? stampOf(project, id) : "";
+        const hit = stamp ? cache?.get(id) : undefined;
+        if (hit && hit.stamp === stamp && now - hit.at < FINISHED_TTL_MS) {
+            runs[id] = hit.report;
+            continue;
+        }
         runs[id] = buildStatusReport(project, id);
-    const report = buildStatusReport(project);
+        if (stamp)
+            cache?.set(id, { stamp, at: now, report: runs[id] });
+    }
+    if (cache)
+        for (const id of cache.keys())
+            if (!finished.has(id))
+                cache.delete(id);
+    // The project's own report shows the current run, which is usually one already built above.
+    const currentId = currentRun(project)?.state.run_id;
+    const report = currentId && runs[currentId] ? runs[currentId] : buildStatusReport(project);
     tracked.clear();
     for (const id of running)
         tracked.add(id);
@@ -31,6 +54,7 @@ function fsWatch(dir, onChange) {
  */
 export function createStatusWatcher(d) {
     const tracked = new Set();
+    const cache = new Map();
     const watch = d.watch ?? fsWatch;
     let lastLine = "";
     let watching = "";
@@ -41,7 +65,7 @@ export function createStatusWatcher(d) {
         let project;
         try {
             project = d.load();
-            frame = buildWatchFrame(project, tracked, { allTasks: d.allTasks });
+            frame = buildWatchFrame(project, tracked, { allTasks: d.allTasks, cache });
         }
         catch (e) {
             frame = { schema_version: 1, error: e.message };

package/package.json

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

package/web/dist/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+  <rect width="32" height="32" rx="7" fill="#0f172a"/>
+  <path d="M5 17h5l3-8 5 14 3-6h6" fill="none" stroke="#34d399" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/web/dist/public/index.html

@@ -3,6 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
     <title>agent-lyceum</title>
     <script type="module" crossorigin src="/assets/index-BgL-BtfE.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-4MtRuQC3.css">