agent-lyceum 0.4.12 → 0.5.0

package/dist/schema.d.ts

@@ -9,51 +9,29 @@ 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;
-}>;
+    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 +39,82 @@ 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;
-}>;
+        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;
-}>;
+        owns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
 export interface DispatcherSettings {
     max_rounds: number;
     max_parallel: number;
@@ -295,6 +123,8 @@ 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. */

package/dist/schema.js

@@ -45,11 +45,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 +58,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,6 +68,7 @@ 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"];

package/dist/status.js

@@ -137,7 +137,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;
@@ -251,13 +251,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} 筆`));
     }
@@ -343,7 +346,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 +357,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 +375,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());

package/dist/validate.js

@@ -3,6 +3,7 @@ import { enforcementFor, memoryDirs, ownsDirs } from "./policy.js";
 import { isInside } from "./paths.js";
 import { inferRuntime, RUNTIME_EFFORTS } from "./schema.js";
 import { isGitRepo, resolveWorkspaceMode } from "./worktree.js";
+import { must } from "./assert.js";
 export function validateProject(project) {
     const issues = [];
     const err = (message) => issues.push({ level: "error", message });
@@ -45,8 +46,8 @@ export function validateProject(project) {
             mem.push({ agent: a.name, dir: d });
     for (let i = 0; i < mem.length; i++) {
         for (let j = i + 1; j < mem.length; j++) {
-            const x = mem[i];
-            const y = mem[j];
+            const x = must(mem[i], "memory dir");
+            const y = must(mem[j], "memory dir");
             if (x.agent === y.agent && x.dir !== y.dir)
                 continue;
             if (isInside(x.dir, y.dir) || isInside(y.dir, x.dir)) {
@@ -63,10 +64,12 @@ export function validateProject(project) {
         }
         for (let i = 0; i < withOwns.length; i++) {
             for (let j = i + 1; j < withOwns.length; j++) {
-                for (const x of ownsDirs(project, withOwns[i])) {
-                    for (const y of ownsDirs(project, withOwns[j])) {
+                const ai = must(withOwns[i], "agent");
+                const aj = must(withOwns[j], "agent");
+                for (const x of ownsDirs(project, ai)) {
+                    for (const y of ownsDirs(project, aj)) {
                         if (isInside(x, y) || isInside(y, x)) {
-                            err(`"owns" overlap: ${withOwns[i].name} (${x}) vs ${withOwns[j].name} (${y})`);
+                            err(`"owns" overlap: ${ai.name} (${x}) vs ${aj.name} (${y})`);
                         }
                     }
                 }
@@ -99,11 +102,12 @@ export function validateProject(project) {
     return { issues, enforcement, ok: !issues.some((i) => i.level === "error") };
 }
 export function formatEnforcement(list) {
-    const rows = [["agent", "runtime", "memory", "AGENT.md", "others' ctx", "repo CLAUDE/AGENTS", "owns"]];
+    const header = ["agent", "runtime", "memory", "AGENT.md", "others' ctx", "repo CLAUDE/AGENTS", "owns"];
+    const rows = [header];
     for (const e of list)
         rows.push([e.agent, e.runtime, e.memory, e.agentMd, e.otherContext, e.repoInstructions, e.owns]);
-    const w = rows[0].map((_, i) => Math.max(...rows.map((r) => r[i].length)));
-    const lines = rows.map((r) => r.map((c, i) => c.padEnd(w[i])).join("  ").trimEnd());
+    const w = header.map((_, i) => Math.max(...rows.map((r) => (r[i] ?? "").length)));
+    const lines = rows.map((r) => r.map((c, i) => c.padEnd(w[i] ?? 0)).join("  ").trimEnd());
     lines.splice(1, 0, w.map((n) => "-".repeat(n)).join("  "));
     const extra = [];
     for (const e of list) {

package/dist/worktree.js

@@ -45,7 +45,7 @@ export function dirtyPaths(dir) {
     const parts = out.split("\0").filter(Boolean);
     const paths = [];
     for (let i = 0; i < parts.length; i++) {
-        const entry = parts[i];
+        const entry = parts[i] ?? "";
         paths.push(entry.slice(3));
         if (entry[0] === "R" || entry[0] === "C")
             i++; // a rename lists its old name next
@@ -162,7 +162,7 @@ export function removeAgentWorkspace(project, runId, agent) {
 export function globMatch(glob, file) {
     let re = "";
     for (let i = 0; i < glob.length; i++) {
-        const c = glob[i];
+        const c = glob.charAt(i);
         if (c === "*" && glob[i + 1] === "*") {
             if (glob[i + 2] === "/") {
                 re += "(?:.*/)?";
@@ -210,10 +210,10 @@ export function collectAgentChanges(workspace, owns) {
     const parts = raw.split("\0").filter(Boolean);
     const files = [];
     for (let i = 0; i + 1 < parts.length; i += 2) {
-        const m = /^:(\d+) (\d+) \w+ \w+ (\w)$/.exec(parts[i]);
+        const m = /^:(\d+) (\d+) \w+ \w+ (\w)$/.exec(parts[i] ?? "");
         if (!m)
             continue;
-        files.push({ path: parts[i + 1], status: m[3], mode: m[2] });
+        files.push({ path: parts[i + 1] ?? "", status: m[3], mode: m[2] ?? "" });
     }
     const rel = path.relative(workspace.root, workspace.dir).split(path.sep).join("/");
     const violations = [];
@@ -365,8 +365,9 @@ export function inspectWorkspace(project, runId, agent) {
             const raw = execFileSync("git", ["diff", "--raw", "-z", "--no-renames", "--no-abbrev", ws.base, head], { cwd: root, encoding: "utf8", maxBuffer: 256 * 1024 * 1024 });
             const parts = raw.split("\0").filter(Boolean);
             for (let i = 1; i < parts.length; i += 2) {
-                if (workingBlob(top, parts[i]) !== blobAt(top, head, parts[i]))
-                    work.unintegrated.push(parts[i]);
+                const file = parts[i] ?? "";
+                if (workingBlob(top, file) !== blobAt(top, head, file))
+                    work.unintegrated.push(file);
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-lyceum",
-  "version": "0.4.12",
+  "version": "0.5.0",
   "description": "Config + dispatcher for teams of Claude Code / Codex agents with scoped context and file-based mailboxes",
   "keywords": [
     "ai",
@@ -38,21 +38,27 @@
   "scripts": {
     "dev": "tsx src/cli.ts",
     "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit && npm run typecheck:plugin",
     "test": "vitest run",
     "prepare": "npm run build",
     "prepublishOnly": "npm run typecheck && npm test && npm run build",
-    "release": "bash scripts/release.sh"
+    "release": "bash scripts/release.sh",
+    "typecheck:plugin": "tsc -p plugins/status-monitor/tsconfig.ci.json",
+    "check:pack": "node scripts/check-pack.mjs",
+    "lint": "biome lint",
+    "check:docs": "node scripts/check-docs.mjs"
   },
   "dependencies": {
-    "commander": "^12.1.0",
+    "commander": "^14.0.3",
     "yaml": "^2.5.0",
-    "zod": "^3.23.8"
+    "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@biomejs/biome": "^2.5.15",
+    "@types/node": "^20.19.43",
     "tsx": "^4.19.0",
-    "typescript": "^5.6.0",
-    "vitest": "^2.1.0"
+    "typescript": "^7.0.2",
+    "vite": "^7.3.7",
+    "vitest": "^4.1.11"
   }
 }