agent-lyceum 0.4.14 → 0.6.0

package/dist/schema.d.ts

@@ -9,51 +9,30 @@ export declare const RUNTIME_EFFORTS: Record<Runtime, readonly Effort[]>;
 /** Guess the runtime from a model name: Claude aliases/IDs -> claude-code, GPT/o-series/codex names -> codex. */
 export declare function inferRuntime(model: string | undefined): Runtime | undefined;
 export declare const AgentPartial: z.ZodObject<{
-    runtime: z.ZodOptional<z.ZodEnum<["claude-code", "codex"]>>;
+    runtime: z.ZodOptional<z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+    }>>;
     model: z.ZodOptional<z.ZodString>;
-    effort: z.ZodOptional<z.ZodEnum<["minimal", "low", "medium", "high", "xhigh", "max"]>>;
+    effort: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        low: "low";
+        max: "max";
+        medium: "medium";
+        minimal: "minimal";
+        xhigh: "xhigh";
+    }>>;
     agent_md: z.ZodOptional<z.ZodString>;
     memory: z.ZodOptional<z.ZodObject<{
         global: z.ZodOptional<z.ZodString>;
         project: z.ZodOptional<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        global?: string | undefined;
-        project?: string | undefined;
-    }, {
-        global?: string | undefined;
-        project?: string | undefined;
-    }>>;
+    }, z.core.$strict>>;
     resume: z.ZodOptional<z.ZodBoolean>;
-    can_message: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"all">, z.ZodArray<z.ZodString, "many">]>>;
+    can_message: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>>;
     can_edit_agent_md: z.ZodOptional<z.ZodBoolean>;
-    owns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strict", z.ZodTypeAny, {
-    runtime?: "claude-code" | "codex" | undefined;
-    model?: string | undefined;
-    effort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-    agent_md?: string | undefined;
-    memory?: {
-        global?: string | undefined;
-        project?: string | undefined;
-    } | undefined;
-    resume?: boolean | undefined;
-    can_message?: string[] | "all" | undefined;
-    can_edit_agent_md?: boolean | undefined;
-    owns?: string[] | undefined;
-}, {
-    runtime?: "claude-code" | "codex" | undefined;
-    model?: string | undefined;
-    effort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-    agent_md?: string | undefined;
-    memory?: {
-        global?: string | undefined;
-        project?: string | undefined;
-    } | undefined;
-    resume?: boolean | undefined;
-    can_message?: string[] | "all" | undefined;
-    can_edit_agent_md?: boolean | undefined;
-    owns?: string[] | undefined;
-}>;
+    can_ask_user: z.ZodOptional<z.ZodBoolean>;
+    owns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
 export type AgentPartialT = z.infer<typeof AgentPartial>;
 export declare const DispatcherPartial: z.ZodObject<{
     max_rounds: z.ZodOptional<z.ZodNumber>;
@@ -61,232 +40,84 @@ export declare const DispatcherPartial: z.ZodObject<{
     wake_timeout_sec: z.ZodOptional<z.ZodNumber>;
     retry: z.ZodOptional<z.ZodNumber>;
     strict: z.ZodOptional<z.ZodBoolean>;
-    workspace_mode: z.ZodOptional<z.ZodEnum<["auto", "shared", "worktree"]>>;
-}, "strict", z.ZodTypeAny, {
-    strict?: boolean | undefined;
-    max_rounds?: number | undefined;
-    max_parallel?: number | undefined;
-    wake_timeout_sec?: number | undefined;
-    retry?: number | undefined;
-    workspace_mode?: "shared" | "auto" | "worktree" | undefined;
-}, {
-    strict?: boolean | undefined;
-    max_rounds?: number | undefined;
-    max_parallel?: number | undefined;
-    wake_timeout_sec?: number | undefined;
-    retry?: number | undefined;
-    workspace_mode?: "shared" | "auto" | "worktree" | undefined;
-}>;
+    workspace_mode: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        shared: "shared";
+        worktree: "worktree";
+    }>>;
+    log_max_bytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
 export declare const GlobalConfig: z.ZodObject<{
     agents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-        runtime: z.ZodOptional<z.ZodEnum<["claude-code", "codex"]>>;
+        runtime: z.ZodOptional<z.ZodEnum<{
+            "claude-code": "claude-code";
+            codex: "codex";
+        }>>;
         model: z.ZodOptional<z.ZodString>;
-        effort: z.ZodOptional<z.ZodEnum<["minimal", "low", "medium", "high", "xhigh", "max"]>>;
+        effort: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            low: "low";
+            max: "max";
+            medium: "medium";
+            minimal: "minimal";
+            xhigh: "xhigh";
+        }>>;
         agent_md: z.ZodOptional<z.ZodString>;
         memory: z.ZodOptional<z.ZodObject<{
             global: z.ZodOptional<z.ZodString>;
             project: z.ZodOptional<z.ZodString>;
-        }, "strict", z.ZodTypeAny, {
-            global?: string | undefined;
-            project?: string | undefined;
-        }, {
-            global?: string | undefined;
-            project?: string | undefined;
-        }>>;
+        }, z.core.$strict>>;
         resume: z.ZodOptional<z.ZodBoolean>;
-        can_message: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"all">, z.ZodArray<z.ZodString, "many">]>>;
+        can_message: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>>;
         can_edit_agent_md: z.ZodOptional<z.ZodBoolean>;
-        owns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strict", z.ZodTypeAny, {
-        runtime?: "claude-code" | "codex" | undefined;
-        model?: string | undefined;
-        effort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        agent_md?: string | undefined;
-        memory?: {
-            global?: string | undefined;
-            project?: string | undefined;
-        } | undefined;
-        resume?: boolean | undefined;
-        can_message?: string[] | "all" | undefined;
-        can_edit_agent_md?: boolean | undefined;
-        owns?: string[] | undefined;
-    }, {
-        runtime?: "claude-code" | "codex" | undefined;
-        model?: string | undefined;
-        effort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        agent_md?: string | undefined;
-        memory?: {
-            global?: string | undefined;
-            project?: string | undefined;
-        } | undefined;
-        resume?: boolean | undefined;
-        can_message?: string[] | "all" | undefined;
-        can_edit_agent_md?: boolean | undefined;
-        owns?: string[] | undefined;
-    }>>>;
-}, "strict", z.ZodTypeAny, {
-    agents: Record<string, {
-        runtime?: "claude-code" | "codex" | undefined;
-        model?: string | undefined;
-        effort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        agent_md?: string | undefined;
-        memory?: {
-            global?: string | undefined;
-            project?: string | undefined;
-        } | undefined;
-        resume?: boolean | undefined;
-        can_message?: string[] | "all" | undefined;
-        can_edit_agent_md?: boolean | undefined;
-        owns?: string[] | undefined;
-    }>;
-}, {
-    agents?: Record<string, {
-        runtime?: "claude-code" | "codex" | undefined;
-        model?: string | undefined;
-        effort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        agent_md?: string | undefined;
-        memory?: {
-            global?: string | undefined;
-            project?: string | undefined;
-        } | undefined;
-        resume?: boolean | undefined;
-        can_message?: string[] | "all" | undefined;
-        can_edit_agent_md?: boolean | undefined;
-        owns?: string[] | undefined;
-    }> | undefined;
-}>;
+        can_ask_user: z.ZodOptional<z.ZodBoolean>;
+        owns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
 export declare const ProjectConfig: z.ZodObject<{
     dir: z.ZodString;
     team: z.ZodObject<{
         lead: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        lead: string;
-    }, {
-        lead: string;
-    }>;
+    }, z.core.$strict>;
     dispatcher: z.ZodDefault<z.ZodObject<{
         max_rounds: z.ZodOptional<z.ZodNumber>;
         max_parallel: z.ZodOptional<z.ZodNumber>;
         wake_timeout_sec: z.ZodOptional<z.ZodNumber>;
         retry: z.ZodOptional<z.ZodNumber>;
         strict: z.ZodOptional<z.ZodBoolean>;
-        workspace_mode: z.ZodOptional<z.ZodEnum<["auto", "shared", "worktree"]>>;
-    }, "strict", z.ZodTypeAny, {
-        strict?: boolean | undefined;
-        max_rounds?: number | undefined;
-        max_parallel?: number | undefined;
-        wake_timeout_sec?: number | undefined;
-        retry?: number | undefined;
-        workspace_mode?: "shared" | "auto" | "worktree" | undefined;
-    }, {
-        strict?: boolean | undefined;
-        max_rounds?: number | undefined;
-        max_parallel?: number | undefined;
-        wake_timeout_sec?: number | undefined;
-        retry?: number | undefined;
-        workspace_mode?: "shared" | "auto" | "worktree" | undefined;
-    }>>;
+        workspace_mode: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            shared: "shared";
+            worktree: "worktree";
+        }>>;
+        log_max_bytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
     agents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-        runtime: z.ZodOptional<z.ZodEnum<["claude-code", "codex"]>>;
+        runtime: z.ZodOptional<z.ZodEnum<{
+            "claude-code": "claude-code";
+            codex: "codex";
+        }>>;
         model: z.ZodOptional<z.ZodString>;
-        effort: z.ZodOptional<z.ZodEnum<["minimal", "low", "medium", "high", "xhigh", "max"]>>;
+        effort: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            low: "low";
+            max: "max";
+            medium: "medium";
+            minimal: "minimal";
+            xhigh: "xhigh";
+        }>>;
         agent_md: z.ZodOptional<z.ZodString>;
         memory: z.ZodOptional<z.ZodObject<{
             global: z.ZodOptional<z.ZodString>;
             project: z.ZodOptional<z.ZodString>;
-        }, "strict", z.ZodTypeAny, {
-            global?: string | undefined;
-            project?: string | undefined;
-        }, {
-            global?: string | undefined;
-            project?: string | undefined;
-        }>>;
+        }, z.core.$strict>>;
         resume: z.ZodOptional<z.ZodBoolean>;
-        can_message: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"all">, z.ZodArray<z.ZodString, "many">]>>;
+        can_message: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>>;
         can_edit_agent_md: z.ZodOptional<z.ZodBoolean>;
-        owns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strict", z.ZodTypeAny, {
-        runtime?: "claude-code" | "codex" | undefined;
-        model?: string | undefined;
-        effort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        agent_md?: string | undefined;
-        memory?: {
-            global?: string | undefined;
-            project?: string | undefined;
-        } | undefined;
-        resume?: boolean | undefined;
-        can_message?: string[] | "all" | undefined;
-        can_edit_agent_md?: boolean | undefined;
-        owns?: string[] | undefined;
-    }, {
-        runtime?: "claude-code" | "codex" | undefined;
-        model?: string | undefined;
-        effort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        agent_md?: string | undefined;
-        memory?: {
-            global?: string | undefined;
-            project?: string | undefined;
-        } | undefined;
-        resume?: boolean | undefined;
-        can_message?: string[] | "all" | undefined;
-        can_edit_agent_md?: boolean | undefined;
-        owns?: string[] | undefined;
-    }>>>;
-}, "strict", z.ZodTypeAny, {
-    agents: Record<string, {
-        runtime?: "claude-code" | "codex" | undefined;
-        model?: string | undefined;
-        effort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        agent_md?: string | undefined;
-        memory?: {
-            global?: string | undefined;
-            project?: string | undefined;
-        } | undefined;
-        resume?: boolean | undefined;
-        can_message?: string[] | "all" | undefined;
-        can_edit_agent_md?: boolean | undefined;
-        owns?: string[] | undefined;
-    }>;
-    dir: string;
-    team: {
-        lead: string;
-    };
-    dispatcher: {
-        strict?: boolean | undefined;
-        max_rounds?: number | undefined;
-        max_parallel?: number | undefined;
-        wake_timeout_sec?: number | undefined;
-        retry?: number | undefined;
-        workspace_mode?: "shared" | "auto" | "worktree" | undefined;
-    };
-}, {
-    dir: string;
-    team: {
-        lead: string;
-    };
-    agents?: Record<string, {
-        runtime?: "claude-code" | "codex" | undefined;
-        model?: string | undefined;
-        effort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        agent_md?: string | undefined;
-        memory?: {
-            global?: string | undefined;
-            project?: string | undefined;
-        } | undefined;
-        resume?: boolean | undefined;
-        can_message?: string[] | "all" | undefined;
-        can_edit_agent_md?: boolean | undefined;
-        owns?: string[] | undefined;
-    }> | undefined;
-    dispatcher?: {
-        strict?: boolean | undefined;
-        max_rounds?: number | undefined;
-        max_parallel?: number | undefined;
-        wake_timeout_sec?: number | undefined;
-        retry?: number | undefined;
-        workspace_mode?: "shared" | "auto" | "worktree" | undefined;
-    } | undefined;
-}>;
+        can_ask_user: z.ZodOptional<z.ZodBoolean>;
+        owns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
 export interface DispatcherSettings {
     max_rounds: number;
     max_parallel: number;
@@ -295,9 +126,11 @@ export interface DispatcherSettings {
     strict: boolean;
     /** "auto": a git worktree per non-lead agent when agents can run in parallel, otherwise one shared checkout. */
     workspace_mode: "auto" | "shared" | "worktree";
+    /** log.jsonl is rotated to log.1.jsonl past this size; 0 = never. */
+    log_max_bytes: number;
 }
 export declare const DISPATCHER_DEFAULTS: DispatcherSettings;
 /** How a run turned out, independent of why it stopped (`EndReason`). Only "completed" means success. */
-export declare const RUN_OUTCOMES: readonly ["completed", "partial", "blocked", "failed", "cancelled"];
+export declare const RUN_OUTCOMES: readonly ["completed", "partial", "blocked", "failed", "waiting", "cancelled"];
 export type RunOutcome = (typeof RUN_OUTCOMES)[number];
-export declare function exitCodeForOutcome(outcome: RunOutcome): 0 | 1 | 2 | 130;
+export declare function exitCodeForOutcome(outcome: RunOutcome): 0 | 1 | 2 | 3 | 130;

package/dist/schema.js

@@ -34,6 +34,7 @@ export const AgentPartial = z
     resume: z.boolean().optional(),
     can_message: z.union([z.literal("all"), z.array(z.string())]).optional(),
     can_edit_agent_md: z.boolean().optional(),
+    can_ask_user: z.boolean().optional(),
     owns: z.array(z.string()).optional(),
 })
     .strict();
@@ -45,11 +46,12 @@ export const DispatcherPartial = z
     retry: z.number().int().min(0).optional(),
     strict: z.boolean().optional(),
     workspace_mode: z.enum(["auto", "shared", "worktree"]).optional(),
+    log_max_bytes: z.number().int().min(0).optional(),
 })
     .strict();
 export const GlobalConfig = z
     .object({
-    agents: z.record(AgentPartial).default({}),
+    agents: z.record(z.string(), AgentPartial).default({}),
 })
     .strict();
 export const ProjectConfig = z
@@ -57,7 +59,7 @@ export const ProjectConfig = z
     dir: z.string(),
     team: z.object({ lead: z.string() }).strict(),
     dispatcher: DispatcherPartial.default({}),
-    agents: z.record(AgentPartial).default({}),
+    agents: z.record(z.string(), AgentPartial).default({}),
 })
     .strict();
 export const DISPATCHER_DEFAULTS = {
@@ -67,15 +69,18 @@ export const DISPATCHER_DEFAULTS = {
     retry: 1,
     strict: false,
     workspace_mode: "auto",
+    log_max_bytes: 8 * 1024 * 1024,
 };
 /** How a run turned out, independent of why it stopped (`EndReason`). Only "completed" means success. */
-export const RUN_OUTCOMES = ["completed", "partial", "blocked", "failed", "cancelled"];
+export const RUN_OUTCOMES = ["completed", "partial", "blocked", "failed", "waiting", "cancelled"];
 export function exitCodeForOutcome(outcome) {
     switch (outcome) {
         case "completed":
             return 0;
         case "failed":
             return 1;
+        case "waiting":
+            return 3;
         case "cancelled":
             return 130;
         default:

package/dist/status.d.ts

@@ -44,7 +44,7 @@ export interface RunReport {
     run_id: string;
     dir: string;
     /** running: its dispatcher is alive; interrupted: it died mid-run; ended: it stopped (see end_reason). */
-    state: "running" | "interrupted" | "ended";
+    state: "running" | "interrupted" | "ended" | "waiting";
     live: boolean;
     end_reason?: EndReason;
     outcome?: RunOutcome;
@@ -83,6 +83,12 @@ export interface RunReport {
         ok: boolean;
         error?: string;
     }>;
+    /** Present while the run waits for the user: the file to fill in and how many questions are still open. */
+    ask?: {
+        path: string;
+        total: number;
+        unanswered: number;
+    };
 }
 export interface AgentReport {
     name: string;
@@ -104,6 +110,8 @@ export interface StatusReport {
     };
     agents: AgentReport[];
     run?: RunReport;
+    /** Hints that a `memory tidy` might help. Only a suggestion; nothing runs it. */
+    memory_advice?: string[];
 }
 export interface TaskListReport {
     schema_version: 1;

package/dist/status.js

@@ -1,8 +1,10 @@
 import fs from "node:fs";
 import path from "node:path";
+import { askReplyPath, readAskReply } from "./ask-reply.js";
 import { RESULT_FILE } from "./dispatcher.js";
 import { bindRunProject, loadRunState, outcomeOf } from "./run-store.js";
 import { listUnread } from "./mailbox.js";
+import { tidyAdvice } from "./memory-tidy.js";
 import { inspectProjectLock, lockHolderAlive } from "./project-lock.js";
 export function latestRun(project) {
     const root = project.paths.runs;
@@ -76,8 +78,10 @@ function alive(pid) {
         return e.code === "EPERM";
     }
 }
-const OUTCOME_ZH = { completed: "完成", partial: "部分完成", blocked: "受阻", failed: "失敗", cancelled: "已取消" };
+const OUTCOME_ZH = { completed: "完成", partial: "部分完成", blocked: "受阻", failed: "失敗", waiting: "等待回答", cancelled: "已取消" };
 export function runStateLabel(s, live = alive(s.pid)) {
+    if (s.end_reason === "waiting")
+        return "等待回答";
     if (s.end_reason) {
         const o = outcomeOf(s);
         // Runs from before outcomes existed: keep what they recorded, but never present it as a checked success.
@@ -137,7 +141,7 @@ function stepsLine(steps, c, finished = false) {
 function queueOf(project) {
     const rows = Object.values(project.agents)
         .map((a) => ({ agent: a.name, msg: listUnread(project, a.name)[0] }))
-        .filter((r) => !!r.msg);
+        .flatMap((r) => (r.msg ? [{ agent: r.agent, msg: r.msg }] : []));
     rows.sort((x, y) => {
         if ((x.agent === project.lead) !== (y.agent === project.lead))
             return x.agent === project.lead ? -1 : 1;
@@ -155,10 +159,23 @@ export function buildRunReport(run, project, opts = {}) {
     const result = path.join(run.dir, RESULT_FILE);
     const hasResult = detail && s.end_reason === "done" && fs.existsSync(result);
     const cur = s.steps?.find((x) => !x.done);
+    let ask;
+    if (s.end_reason === "waiting") {
+        try {
+            const r = readAskReply(run.dir);
+            if (r) {
+                const open = r.questions.filter((q) => !q.delivered);
+                ask = { path: askReplyPath(run.dir), total: open.length, unanswered: open.filter((q) => !q.answer?.value.trim()).length };
+            }
+        }
+        catch {
+            ask = { path: askReplyPath(run.dir), total: 0, unanswered: 0 };
+        }
+    }
     return {
         run_id: s.run_id,
         dir: run.dir,
-        state: s.end_reason ? "ended" : live ? "running" : "interrupted",
+        state: s.end_reason === "waiting" ? "waiting" : s.end_reason ? "ended" : live ? "running" : "interrupted",
         live,
         end_reason: s.end_reason,
         outcome: o?.outcome,
@@ -186,6 +203,7 @@ export function buildRunReport(run, project, opts = {}) {
         mail_layout: s.mail_layout,
         workspace_mode: s.workspace_mode,
         last_wake: s.last_wake,
+        ...(ask ? { ask } : {}),
     };
 }
 const projectInfo = (p) => ({ name: p.name, dir: p.dir, lead: p.lead });
@@ -203,6 +221,13 @@ export function buildStatusReport(base, runId) {
     // Mail is per run: count the unread mail of the run being shown.
     const project = run ? bindRunProject(base, run.dir, run.state.mail_layout) : base;
     const report = run ? buildRunReport(run, base) : undefined;
+    let advice = [];
+    try {
+        advice = tidyAdvice(base).map((a) => `${a.agent}: ${a.reason}`);
+    }
+    catch {
+        /* a hint only: never let it break status */
+    }
     return {
         schema_version: 1,
         project: projectInfo(base),
@@ -214,6 +239,7 @@ export function buildStatusReport(base, runId) {
             last_wake: run?.state.last_wake[a.name],
         })),
         run: report,
+        ...(advice.length ? { memory_advice: advice } : {}),
     };
 }
 /** Every run of the project, newest first. */
@@ -251,13 +277,16 @@ function summaryBlock(run, now, c) {
     lines.push(`${L("進度：")}${steps ?? `無清單；已用 ${s.rounds}/${s.max_rounds} 輪（lead 可在信中加入 "## Steps" 清單）`}`);
     const active = Object.entries(s.active ?? {});
     if (active.length) {
-        active.forEach(([agent, a], i) => lines.push(`${i === 0 ? L("現在：") : "          "}${c.cyan(agent)} ${live ? c.green(`工作中 ${since(a.since, now)}`) : c.yellow("曾在工作（已中斷）")}，處理 ${handlingText(a.handling)}`));
+        for (const [i, [agent, a]] of active.entries()) {
+            lines.push(`${i === 0 ? L("現在：") : "          "}${c.cyan(agent)} ${live ? c.green(`工作中 ${since(a.since, now)}`) : c.yellow("曾在工作（已中斷）")}，處理 ${handlingText(a.handling)}`);
+        }
     }
     else
         lines.push(`${L("現在：")}${c.dim(`閒置${s.end_reason ? `（執行已結束：${s.end_reason}）` : live ? "" : "（執行未在運作）"}`)}`);
     const queue = s.queue;
     if (queue.length) {
-        queue.slice(0, 3).forEach((q, i) => lines.push(`${i === 0 ? L("下一個：") : "          "}${c.cyan(q.agent)} ← ${mailText(q)}`));
+        for (const [i, q] of queue.slice(0, 3).entries())
+            lines.push(`${i === 0 ? L("下一個：") : "          "}${c.cyan(q.agent)} ← ${mailText(q)}`);
         if (queue.length > 3)
             lines.push(c.dim(`          … 還有 ${queue.length - 3} 筆`));
     }
@@ -271,6 +300,8 @@ function summaryBlock(run, now, c) {
     const lastWake = (s.wakes ?? []).at(-1);
     if (lastWake)
         lines.push(`${L("上一次：")}#${lastWake.round} ${c.cyan(lastWake.agent)} ${okText(c, lastWake.ok)} → ${sentText(lastWake.sent)}`);
+    if (s.ask)
+        lines.push(`${L("等你回答：")}${s.ask.unanswered}/${s.ask.total} 題未答 → ${s.ask.path}`, c.dim(`          填完後執行 agent-lyceum answer ${s.run_id}（或 resume）`));
     lines.push(`${L("流程：")}${flowLine(s, c)}`);
     return lines;
 }
@@ -343,7 +374,8 @@ export function formatTaskListReport(report, color = false) {
     const head = `${c.bold("專案：")}${report.project.name}  ${c.dim(`（共 ${runs.length} 個任務）`)}`;
     if (!runs.length)
         return `${head}\n\n無執行紀錄。`;
-    const rows = [["ID", "狀態", "輪次", "目前步驟", "任務"]];
+    const header = ["ID", "狀態", "輪次", "目前步驟", "任務"];
+    const rows = [header];
     for (const s of runs) {
         rows.push([
             s.run_id,
@@ -353,11 +385,11 @@ export function formatTaskListReport(report, color = false) {
             clip(taskText(s), 60),
         ]);
     }
-    const w = rows[0].map((_, i) => Math.max(...rows.map((r) => cols(r[i]))));
+    const w = header.map((_, i) => Math.max(...rows.map((r) => cols(r[i] ?? ""))));
     const line = (r, ri) => r
         .map((t, i) => {
-        const p = i === r.length - 1 ? t : padCols(t, w[i]);
-        return ri === 0 ? c.bold(p) : i === 1 ? stateColor(c, t) + " ".repeat(Math.max(0, w[i] - cols(t))) : p;
+        const p = i === r.length - 1 ? t : padCols(t, w[i] ?? 0);
+        return ri === 0 ? c.bold(p) : i === 1 ? stateColor(c, t) + " ".repeat(Math.max(0, (w[i] ?? 0) - cols(t))) : p;
     })
         .join("  ")
         .trimEnd();
@@ -371,23 +403,25 @@ export function formatStatus(base, now = Date.now(), color = false) {
 export function formatStatusReport(report, now = Date.now(), color = false) {
     const c = paint(color);
     const run = report.run;
-    const rows = [["成員", "執行環境", "未讀", "上次喚醒"]];
+    const header = ["成員", "執行環境", "未讀", "上次喚醒"];
+    const rows = [header];
     for (const a of report.agents) {
         const lw = a.last_wake;
         rows.push([a.name + (a.lead ? " (lead)" : ""), a.runtime ?? "?", String(a.unread), lw ? `${lw.ok ? "成功" : "失敗"} ${lw.at}` : "-"]);
     }
-    const w = rows[0].map((_, i) => Math.max(...rows.map((r) => cols(r[i]))));
+    const w = header.map((_, i) => Math.max(...rows.map((r) => cols(r[i] ?? ""))));
     // Pad on the plain text first so ANSI codes never skew the column widths.
     const cell = (r, ri, i) => {
-        const t = i === r.length - 1 ? r[i] : padCols(r[i], w[i]); // no trailing padding, as in plain output
+        const text = r[i] ?? "";
+        const t = i === r.length - 1 ? text : padCols(text, w[i] ?? 0); // no trailing padding, as in plain output
         if (ri === 0)
             return c.bold(t);
         if (i === 0)
-            return r[0].endsWith("(lead)") ? c.cyan(t) : t;
+            return text.endsWith("(lead)") ? c.cyan(t) : t;
         if (i === 2)
-            return r[2] === "0" ? c.dim(t) : c.yellow(t);
+            return text === "0" ? c.dim(t) : c.yellow(t);
         if (i === 3)
-            return r[3].startsWith("失敗") ? c.red(t) : r[3].startsWith("成功") ? c.green(t) : c.dim(t);
+            return text.startsWith("失敗") ? c.red(t) : text.startsWith("成功") ? c.green(t) : c.dim(t);
         return t;
     };
     const table = rows.map((r, ri) => r.map((_, i) => cell(r, ri, i)).join("  ").trimEnd());
@@ -395,5 +429,7 @@ export function formatStatusReport(report, now = Date.now(), color = false) {
     const lines = [`${c.bold("專案：")}${report.project.name}  ${c.dim(`（repo：${report.project.dir}）`)}`, "", ...summaryBlock(run, now, c), "", ...table];
     if (run)
         lines.push("", `輸出 tokens：${tokens(run.output_tokens)}`);
+    if (report.memory_advice?.length)
+        lines.push("", `記憶：${report.memory_advice.join("；")}（建議執行 agent-lyceum memory tidy -p ${report.project.name}；status 只提示，不會自動整理）`);
     return lines.join("\n");
 }