agent-lyceum 0.9.0 → 0.9.1

package/README.md

@@ -36,6 +36,8 @@ Requires Node 20+, plus `claude` and/or `codex` on your `PATH` (already logged i
 | Run | `memory tidy [-p name] [--agent a] [--layer project\|global] [--dry-run]` | Have agents tidy their own memory (manual only; archives, never deletes). [details](docs/commands.md#memory-tidy) |
 | Run | `memory restore <timestamp> -p name --agent a` | Undo a tidy: move its archived files back. [details](docs/commands.md#memory-restore) |
 
+`agent-lyceum --help` lists each command with a one-line summary; `agent-lyceum <command> --help` prints its full description and options.
+
 Ctrl-C cancels a run cleanly and it can be continued with `resume` ([Stopping a run](docs/commands.md#stopping-a-run)). `run` and `resume` exit `0` only when the lead reported `completed`, `2` for partial or blocked, `1` for failed, `3` while waiting for your answers, `130` for cancelled ([Exit codes](docs/commands.md#exit-codes)). Without `-p`, the project is inferred from the current directory ([Choosing the project](docs/commands.md#choosing-the-project)).
 
 ## Running one agent on its own

package/README.zh-TW.md

@@ -36,6 +36,8 @@ npx agent-lyceum status
 | 執行 | `memory tidy [-p name] [--agent a] [--layer project\|global] [--dry-run]` | 讓 agent 整理自己的記憶（只能手動觸發；封存而非刪除）。 [詳細](docs/commands.zh-TW.md#memory-tidy) |
 | 執行 | `memory restore <時間戳> -p name --agent a` | 還原一次整理：把封存的檔案搬回。 [詳細](docs/commands.zh-TW.md#memory-restore) |
 
+`agent-lyceum --help` 只列出每個指令的一行簡述；`agent-lyceum <指令> --help` 會印出該指令的完整說明與選項。
+
 Ctrl-C 會乾淨地取消 run，之後可用 `resume` 接續（[中止 run](docs/commands.zh-TW.md#中止-run)）。`run`／`resume` 只有在 lead 回報 `completed` 時才 exit `0`；`partial`／`blocked` 為 `2`，`failed` 為 `1`，等待你回答時為 `3`，取消為 `130`（[退出碼](docs/commands.zh-TW.md#退出碼)）。未指定 `-p` 時，專案由目前目錄推斷（[選擇專案](docs/commands.zh-TW.md#選擇專案)）。
 
 ## 單獨呼叫一個 agent

package/dist/cli.js

@@ -222,7 +222,8 @@ async function driveRun(pr, runDir, first, assumeDefaults) {
 }
 program
     .command("run [task]")
-    .description('Start the dispatcher: give the task to the lead. Use "<task>" or --task-file <path>. With --agent, give it to that one member alone.')
+    .summary("Start the dispatcher with a task for the lead")
+    .description('Start the dispatcher: give the task to the lead.\n\nGive the task either way:\n  - "<task>": as text\n  - --task-file <path>: from a file\n\nWho gets it:\n  - by default, the lead\n  - --agent <name>: that one member alone')
     .option("-p, --project <name>")
     .option("--task-file <path>", "read the task from a file")
     .option("--agent <name>", "run only this member of the project, alone: it cannot mail teammates or ask you, and its own `done` ends the run")
@@ -268,7 +269,8 @@ program
 });
 program
     .command("resume [run-id]")
-    .description("Continue an interrupted (or failed) run: same run dir, sessions and round count; the task is not re-sent. Without an id, picks the newest run that is not done or running; with an id, continues that run.")
+    .summary("Continue an interrupted (or failed) run")
+    .description("Continue an interrupted (or failed) run: same run dir, sessions and round count; the task is not re-sent.\n\nWhich run:\n  - without an id: the newest run that is not done or running\n  - with an id: that run")
     .option("-p, --project <name>")
     .option("--answer", "the run is waiting for answers: open ask-reply.md in $EDITOR, check the answers, then continue")
     .option("--no-edit", "with --answer: do not open the editor; check the file as it is")
@@ -347,9 +349,13 @@ function unlockProject(pr, force) {
 }
 program
     .command("clear [run-id]")
-    .description("Delete a task (run) by id: its run directory (state, log, result, mailboxes), its task memory and its agent worktrees, branches and snapshots. " +
-    "Long-term (global and project) memory is never touched. Refuses while the run is running, or while a worktree holds work that is not in the repo. " +
-    "With --lock (and no run id) it instead removes the run lock a crashed run left behind; that needs --force.")
+    .summary("Delete a run by id, or remove a stale run lock")
+    .description("Delete a task (run) by id: its run directory (state, log, result, mailboxes), its task memory and its agent worktrees, branches and snapshots.\n\n" +
+    "Long-term (global and project) memory is never touched.\n" +
+    "Refuses while the run is running, or while a worktree holds work that is not in the repo.\n\n" +
+    "With --lock (no run id) it does something else:\n" +
+    "  - removes the run lock a crashed run left behind\n" +
+    "  - needs --force to actually remove it")
     .option("-p, --project <name>")
     .option("--dry-run", "only list what would be deleted and what would be kept")
     .option("--lock", "remove the project's run lock left behind by a crashed run (takes no run id; needs --force)")
@@ -412,7 +418,8 @@ program
 });
 program
     .command("doctor")
-    .description("Check the setup without running any agent: configuration and enforcement levels, git, the project lock, and what each runtime CLI supports (from --version/--help). With --resolved, print every effective setting and where it came from instead.")
+    .summary("Check the setup without running any agent")
+    .description("Check the setup without running any agent. It checks:\n  - configuration and enforcement levels\n  - git\n  - the project lock\n  - what each runtime CLI supports (read from its --version and --help)\n\nWith --resolved it checks nothing and instead prints:\n  - every effective setting\n  - where each one came from")
     .option("-p, --project <name>")
     .option("--task-file <path>", "also check a task file")
     .option("--resolved", "print the merged settings (global library, project file, defaults) and their sources; runs no other check")
@@ -466,7 +473,8 @@ function printResolved(projectName, json) {
 }
 program
     .command("call <agent> [task]")
-    .description("Call one agent of the global library on its own, outside any project: it works in --dir (default: the current directory) and its final answer is printed. It cannot mail anyone or ask you.")
+    .summary("Call one global-library agent on its own, outside any project")
+    .description("Call one agent of the global library on its own, outside any project.\n\n  - it works in --dir (default: the current directory)\n  - its final answer is printed\n  - it cannot mail anyone or ask you")
     .option("--task-file <path>", "read the task from a file")
     .option("--dir <path>", "the directory the agent works in (default: the current directory)")
     .action(async (agentName, task, opts) => {
@@ -509,7 +517,8 @@ function layerOpt(v) {
 }
 memoryCmd
     .command("tidy")
-    .description("Have agents tidy their own memory: merge duplicates, fix stale entries, archive what is obsolete (never deletes). Manual only; nothing triggers it automatically.")
+    .summary("Have agents tidy their own memory")
+    .description("Have agents tidy their own memory: merge duplicates, fix stale entries, archive what is obsolete (never deletes).\n\nManual only; nothing triggers it automatically.")
     .option("-p, --project <name>")
     .option("--agent <name>", "tidy only this agent (default: every agent)")
     .option("--layer <layer>", "project (default) or global; global memory is shared by every project, so it is never tidied unless you ask")

package/package.json

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