@lumoai/cli 1.15.0 → 1.18.0

package/assets/skill/references/sprints.md

@@ -0,0 +1,157 @@
+# Sprint Management
+
+## Sprint Management
+
+### `lumo sprint list [flags]` — list sprints in a team
+
+Prints fixed-width rows: `<NUMBER>  <STATUS>  <start>  <end>  <name>`, sorted newest-first (server sort).
+
+| Flag                   | Type    | Notes                                                 |
+| ---------------------- | ------- | ----------------------------------------------------- |
+| `--team <ref>`         | string  | Team name or slug. Required in multi-team workspaces. |
+| `-s, --status <value>` | enum    | `draft \| active \| closed`.                          |
+| `-n, --limit <count>`  | integer | Cap output to the first N rows.                       |
+
+```bash
+lumo sprint list
+lumo sprint list --status active
+lumo sprint list --team backend --limit 5
+```
+
+When to suggest: user asks "what sprints do we have", "which sprint is active", "list sprints", "show me the current sprint", "active sprints".
+
+### `lumo sprint create [flags]` — create a sprint
+
+| Flag             | Type   | Notes                                                 |
+| ---------------- | ------ | ----------------------------------------------------- |
+| `--team <ref>`   | string | Team name or slug. Required in multi-team workspaces. |
+| `--start <date>` | string | **Required.** YYYY-MM-DD.                             |
+| `--end <date>`   | string | **Required.** YYYY-MM-DD.                             |
+| `-n, --name <>`  | string | Optional. Server fills a default name when omitted.   |
+
+```bash
+lumo sprint create --start 2026-06-01 --end 2026-06-14
+lumo sprint create --name "Sprint 4" --start 2026-06-01 --end 2026-06-14 --team backend
+```
+
+On success: `Created sprint #<number> "<name>"  <id>`.
+
+When to suggest: user says "create a sprint", "new sprint", "新建冲刺", "start a new iteration".
+
+### `lumo sprint show <identifier> [--team <ref>]` — show sprint detail + task table
+
+`<identifier>` accepts a sprint number (e.g. `3`) or a UUID. `--team` is required when using a number in a multi-team workspace.
+
+Output: key:value header (number, name, status, dates, team), then a `Progress:` line, then a **`Health:` line** with the sprint's risk level (`HEALTHY` / `WATCH` / `AT-RISK`), then a task table listing every task in the sprint.
+
+The risk level reuses the same engine as project/workspace stats, fed the sprint's task set (thresholds come from the workspace risk config — sprints have no per-sprint overrides). When the engine flags reasons they print as `- <detail>` lines under `Health:`, and a `Blockers:` section lists the top offenders per category (`Overdue` / `Stalled` / `Agent fail` / `Stale PRs`). A healthy sprint with no blockers shows just the `Health:` line.
+
+```
+Progress:  4 / 10
+Health:    AT-RISK
+  - 4/10 tasks overdue (40%)
+  - 3 tasks with no progress in 7 days
+Blockers:
+  Overdue:   LUM-1 Fix login, LUM-8 Wire API
+  Stalled:   LUM-5 Add tests
+  Stale PRs: #12, #15
+```
+
+```bash
+lumo sprint show 3
+lumo sprint show 3 --team backend
+lumo sprint show 11111111-2222-3333-4444-555555555555
+```
+
+When to suggest: user asks "what's in sprint 3", "show me the current sprint", "冲刺里有什么", "what tasks are in this sprint", "is this sprint at risk", "冲刺风险", "sprint health".
+
+### `lumo sprint update <identifier> [flags]` — patch a sprint
+
+Updates sprint metadata. At least one flag required. **No `--status` flag** — use `lumo sprint start` / `lumo sprint close` to transition status.
+
+| Flag             | Type   | Notes                                                           |
+| ---------------- | ------ | --------------------------------------------------------------- |
+| `--team <ref>`   | string | Required when identifier is a number in a multi-team workspace. |
+| `-n, --name <>`  | string | New name. Cannot be empty.                                      |
+| `--start <date>` | string | YYYY-MM-DD. `--start ""` clears.                                |
+| `--end <date>`   | string | YYYY-MM-DD. `--end ""` clears.                                  |
+
+```bash
+lumo sprint update 3 --name "Sprint 4 (extended)"
+lumo sprint update 3 --end 2026-06-21
+```
+
+When to suggest: user wants to rename a sprint, extend dates, or fix sprint metadata.
+
+### `lumo sprint delete <identifier> --yes` — delete a sprint (DRAFT only)
+
+Requires `--yes`; no interactive prompt (agent-friendly). Server rejects with an error if the sprint is ACTIVE or CLOSED.
+
+```bash
+lumo sprint delete 3 --yes
+```
+
+When to suggest: user wants to remove a draft sprint that was created by mistake.
+
+### `lumo sprint start <identifier>` — transition DRAFT → ACTIVE
+
+No additional flags. Fails if the sprint is already ACTIVE or CLOSED.
+
+```bash
+lumo sprint start 3
+```
+
+When to suggest: user says "start the sprint", "开始冲刺", "kick off sprint 3", "activate sprint".
+
+### `lumo sprint close <identifier> [flags]` — transition ACTIVE → CLOSED
+
+Handles unfinished tasks based on flags. Without flags: closes only if all tasks are done; otherwise prints a list of unfinished tasks and refuses.
+
+| Flag            | Type    | Notes                                                                            |
+| --------------- | ------- | -------------------------------------------------------------------------------- |
+| `--move-all`    | boolean | Move all unfinished tasks to the next sprint. Requires `--yes`.                  |
+| `--backlog-all` | boolean | Remove all unfinished tasks from the sprint (send to backlog). Requires `--yes`. |
+| `--yes`         | boolean | Required when `--move-all` or `--backlog-all` is given.                          |
+
+```bash
+lumo sprint close 3                          # fails if unfinished tasks exist
+lumo sprint close 3 --move-all --yes         # move unfinished to next sprint
+lumo sprint close 3 --backlog-all --yes      # send unfinished to backlog
+```
+
+When to suggest: user says "close the sprint", "关闭冲刺", "end sprint 3", "wrap up the sprint". If they haven't decided what to do with unfinished tasks, ask before adding `--move-all` or `--backlog-all`.
+
+### `lumo sprint summary <identifier> [--retry]` — fetch AI-generated sprint retro
+
+Prints the AI-generated retrospective summary for the sprint. A 404 response means no summary has been generated yet ("no summary yet").
+
+| Flag      | Type    | Notes                                             |
+| --------- | ------- | ------------------------------------------------- |
+| `--retry` | boolean | Queue a regeneration (async, server returns 202). |
+
+```bash
+lumo sprint summary 3
+lumo sprint summary 3 --retry
+```
+
+When to suggest: user asks "summarize the sprint", "sprint retro", "give me a summary of sprint 3", "冲刺总结".
+
+### `lumo sprint add <identifier> <task>` — bind a task to a sprint
+
+Adds `<task>` (e.g. `LUM-48`) to the sprint. Same-team check applies — the task's team must match the sprint's team.
+
+```bash
+lumo sprint add 3 LUM-48
+```
+
+When to suggest: user says "add LUM-48 to sprint 3", "把任务挂到冲刺", "put this task in the sprint".
+
+### `lumo sprint remove <identifier> <task>` — unbind a task from a sprint
+
+Removes `<task>` from the sprint. Idempotent — if the task is not in the sprint, the server returns success.
+
+```bash
+lumo sprint remove 3 LUM-48
+```
+
+When to suggest: user says "remove LUM-48 from the sprint", "take this task out of sprint 3", "move task to backlog".

package/assets/skill/references/task-context.md

@@ -0,0 +1,109 @@
+# Task Context Loading & Context Retrieval
+
+## Task Context Loading
+
+When the user mentions a task identifier or asks for task background, load the context:
+
+```bash
+lumo task context <identifier>
+```
+
+Example: `lumo task context LUM-42`
+
+### Reading the output
+
+The command prints a markdown document to stdout containing:
+
+1. **Task header** — identifier, title, status, description
+2. **Memory section** — cross-session learnings accumulated over prior sessions; treat as trusted background context
+3. **Inline source cards** — Slack / web / Figma / artifacts / documents / comments / Pull Requests (see "Context Retrieval" below)
+4. **PR Review 待办** — mirrored PR review comments as a checkbox todo list: each line-level reviewer comment (shown as `` `file:line` `` + the reviewer's ask + a link to the GitHub comment) and each `changes_requested` review summary (shown as "🛑 整体要求改动"). Present only when the task's PR(s) have review comments. This same block is **auto-injected at session start** (alongside the memory section) when the session is bound to a task — so reviewer asks surface without re-running `task context`.
+   - The **inline source cards** (Slack / web / Figma / PR) are likewise **auto-injected at session start** when the session is bound, under a single global token budget shared with the memory section (priority: memory > PR > Slack > Figma > web). Cards that don't fit the budget are degraded to a one-line manifest carrying just the title and its `lumo task … show` retrieval command — so you still know they exist and can pull the full content on demand.
+5. **Previous sessions** — ordered newest-first, each with:
+   - A headline summary of what was done
+   - Unresolved items (carry-over TODOs from that session)
+
+### How to use the context
+
+- **Unresolved items** from the most recent session are the highest-priority carry-overs — address them before starting new work unless the user says otherwise
+- **PR Review 待办** items are reviewer-requested changes — treat each unchecked box as a TODO to resolve, then reply on the PR (a Lumo comment mirrors back to GitHub)
+- **Memory section** provides validated context that persists across sessions — use it to avoid re-learning decisions or constraints
+- Focus on the **most recent 1–2 sessions** for relevant state; older sessions are for historical reference only
+- If there are **no prior sessions**, this is a fresh start — read the task description carefully and ask clarifying questions if needed
+
+## Context Retrieval (按需取全文)
+
+LUM-122 split task context injection into tiers. `lumo task context <LUM-N>`
+now emits a **cheap inline card** for each source — a short summary or just
+metadata — instead of dumping full bodies. Slack, docs, artifacts, and comments
+get an **LLM summary**; web links, Figma, and PRs get **metadata only**. Each
+card ends with the **retrieval command** you run to pull the heavy content on
+demand.
+
+**How to use it:** when the inline card is not enough and you need the full
+Slack thread, the web page body, the Figma metadata, the entire comment thread,
+or the PR detail — run the matching command below. Pass the same identifier
+(`LUM-N`) plus the id the card shows for that source (a Slack `contextId`, a web
+`linkId`, a Figma `linkId`, or a PR `number`).
+
+All five are **read-only** (no live Slack/GitHub/Figma calls except the web body
+fetch). Web/Figma/PR are v1 metadata-degraded: they print a `note:` explaining
+that live content needs an external integration.
+
+### `lumo task slack show <identifier> <contextId>` — full Slack thread snapshot
+
+Prints the **stored** thread snapshot (no live Slack call), one line per message
+as `author: text`. Author falls back to `@<userId>` when the display name is
+missing. Empty snapshot prints `(no messages in stored snapshot)`.
+
+```bash
+lumo task slack show LUM-42 ctx_abc123
+```
+
+### `lumo task web show <identifier> <linkId>` — fetched web link body
+
+Fetches the page body on demand behind the SSRF guard (cached after first read)
+and prints it as plain text. Empty body prints `(empty body)`. Fetch failures
+(blocked host, timeout) print the server's error message.
+
+```bash
+lumo task web show LUM-42 wl_abc123
+```
+
+### `lumo task figma context <identifier> <linkId>` — Figma link metadata
+
+**v1 metadata fallback.** Prints the cached design metadata as `file:` /
+`frame:` / `url:` / `synced:` (and `syncError:` if the last sync failed) lines.
+Live design context (layers, variables, code connect) requires the Figma MCP
+server, so the command ends with a `note:` saying so.
+
+```bash
+lumo task figma context LUM-42 cfl_abc123
+```
+
+### `lumo task comments list <identifier>` — full comment thread
+
+Prints the **entire** comment thread: each comment as `author · createdAt`
+followed by its plain-text body (comment bodies are stored as HTML and stripped
+to text). Replies are indented two spaces under their parent. Author falls back
+to `unknown`. No comments prints `(no comments)`.
+
+```bash
+lumo task comments list LUM-42
+```
+
+**Plural, and distinct from `task comment`.** `task comments list` _reads_ the
+whole thread (this retrieval command). `task comment <identifier> <body>`
+_writes_ a single new comment (see Task Management). Don't confuse the two —
+the plural `comments` is read-only.
+
+### `lumo task pr show <identifier> <number>` — synced PR metadata
+
+**v1 metadata fallback.** Prints the synced PR record: a `#<number> (repo)
+title` header, then `state:` (with ` · draft` when draft), `ci:`, `author:`,
+`branch: <head> → <base>`, and `url:` lines. The live diff + review comments
+require the GitHub integration, so the command ends with a `note:` saying so.
+
+```bash
+lumo task pr show LUM-42 128
+```

package/assets/skill/references/tasks.md

@@ -0,0 +1,205 @@
+# Task Management
+
+## Task Management
+
+### `lumo task create <title> [flags]` — create a new task
+
+Use this when the user wants to file a new task from the terminal. Title is positional and required (non-empty).
+
+| Flag                     | Type   | Notes                                                                               |
+| ------------------------ | ------ | ----------------------------------------------------------------------------------- |
+| `-d, --description <>`   | string | Optional task description.                                                          |
+| `-p, --priority <level>` | enum   | `low \| medium \| high \| urgent` (case-insensitive). Defaults to `low`.            |
+| `-a, --assignee <ref>`   | string | `me`, an email, or a member name. Defaults to `me`.                                 |
+| `--project <ref>`        | string | Project name or slug. **Required when the workspace has more than one project.**    |
+| `--milestone <ref>`      | string | Milestone name (case-insensitive) within the resolved project. Omit for no binding. |
+| `--sprint <ref>`         | string | Sprint number or UUID to bind the task to on creation. Omit for no sprint binding.  |
+| `--tag <name>`           | string | Attach a tag by name (repeatable). The name is resolved to an id server-side.       |
+| `--tag-id <cuid>`        | string | Attach a tag by cuid (repeatable). Combines with `--tag`.                           |
+
+Examples:
+
+```bash
+lumo task create "Fix Slack OAuth redirect bug"
+lumo task create "Refactor task service" --priority high --description "Split into smaller files"
+lumo task create "Investigate slow query" --assignee teammate@example.com --project backend
+lumo task create "Plan API design" --milestone "v1.0"
+lumo task create "Sprint task" --sprint 3
+lumo task create "Add rate limiting" --tag bug --tag urgent
+lumo task create "Spike: evaluate caching options" --tag rfc --tag-id clm_abc123
+```
+
+On success the command prints one or two lines to stdout:
+
+```
+Created LUM-55 "Title"  https://www.uselumo.ai/workspace/<slug>/my-tasks/LUM-55
+Tags: bug, urgent
+```
+
+The `Tags:` line is omitted when no tags were attached.
+
+If the workspace has multiple projects and `--project` is omitted, the server will return an error naming available projects — re-run with `--project <slug>`.
+
+### When to suggest `task create`
+
+- The user describes wanting a new task ("create a task to ...", "file a bug for ...", "log a TODO that ...", "add a task: ...").
+- After a discussion that ends in "let's track that separately" — offer to create the task with a sensible title and priority.
+- For follow-ups discovered mid-work that shouldn't bloat the current change — propose `task create` rather than silently expanding scope.
+
+### `lumo task update <identifier> [flags]` — patch a task
+
+Pure flag-driven update. Provide at least one of:
+
+| Flag                     | Type                | Notes                                                                                                                                                                                                                                                                 |
+| ------------------------ | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `-t, --title <text>`     | string              | Cannot be empty.                                                                                                                                                                                                                                                      |
+| `-d, --description <>`   | string              | `--description ""` clears the field.                                                                                                                                                                                                                                  |
+| `-s, --status <value>`   | enum                | `todo \| in_progress \| in_review \| done` (case-insensitive).                                                                                                                                                                                                        |
+| `-p, --priority <lvl>`   | enum                | `low \| medium \| high \| urgent`.                                                                                                                                                                                                                                    |
+| `-a, --assignee <ref>`   | string              | `me`, an email, or a member name. `--assignee ""` clears the field.                                                                                                                                                                                                   |
+| `--milestone <ref>`      | string              | Milestone name (case-insensitive) within the task's project. `--milestone ""` unbinds.                                                                                                                                                                                |
+| `--sprint <ref>`         | string              | Sprint number or UUID to bind the task to. `--sprint ""` clears the current sprint binding (idempotent when already unbound).                                                                                                                                         |
+| `--tag <name>`           | string (repeatable) | **Bulk replace** the tag set by name. Creates tag if missing. Max 20. Mutually exclusive with `--add-tag*` / `--remove-tag*`.                                                                                                                                         |
+| `--tag-id <cuid>`        | string (repeatable) | **Bulk replace** the tag set by id. Max 20. Mutually exclusive with `--add-tag*` / `--remove-tag*`.                                                                                                                                                                   |
+| `--add-tag <name>`       | string (repeatable) | Attach tag by name (find-or-create). Max 20.                                                                                                                                                                                                                          |
+| `--add-tag-id <cuid>`    | string (repeatable) | Attach tag by id. Max 20.                                                                                                                                                                                                                                             |
+| `--remove-tag <name>`    | string (repeatable) | Detach tag by name. `--remove-tag <name>` resolves the name via find-or-create on the workspace. If the name was unknown, a new Tag row is created (orphan, no attachments) before the detach runs as a no-op. Use `--remove-tag-id <cuid>` to avoid orphans. Max 20. |
+| `--remove-tag-id <cuid>` | string (repeatable) | Detach tag by id. Unknown ids are a no-op (no side effects). Max 20.                                                                                                                                                                                                  |
+
+`--tag` / `--tag-id` (bulk replace) are mutually exclusive with `--add-tag` / `--add-tag-id` / `--remove-tag` / `--remove-tag-id`. The CLI errors before any network call if both families are mixed.
+
+Examples:
+
+```bash
+lumo task update LUM-48 --status in_progress
+lumo task update LUM-48 --title "Update task from CLI" --priority high
+lumo task update LUM-48 --assignee me
+lumo task update LUM-48 --description ""        # clear description
+lumo task update LUM-48 --assignee ""           # unassign
+lumo task update LUM-48 --milestone "v1.0"      # attach to milestone
+lumo task update LUM-48 --milestone ""          # unbind milestone
+lumo task update LUM-48 --sprint 3              # bind to sprint #3
+lumo task update LUM-48 --sprint ""             # unbind from current sprint
+lumo task update LUM-42 --add-tag urgent --remove-tag draft
+lumo task update LUM-42 --tag final --tag approved   # replace entire tag set
+lumo task update LUM-42 --tag final --add-tag oops
+# Error: --tag/--tag-id are mutually exclusive with --add-tag/--add-tag-id/--remove-tag/--remove-tag-id
+```
+
+On success the command prints one or two lines to stdout:
+
+```
+Updated LUM-48 "Title"  https://www.uselumo.ai/workspace/<slug>/my-tasks/LUM-48
+Tags: urgent
+```
+
+The `Tags:` line is omitted when the resulting tag set is empty.
+
+### When to suggest `task update`
+
+- The user describes a state change in natural language (e.g. "mark LUM-48 as in progress", "rename LUM-12 to ...", "assign LUM-30 to me", "bump the priority on LUM-7").
+- After the agent finishes a task and the user confirms — offer to move it to `done`.
+- Multiple status changes in a row should each be a separate `update` invocation rather than batched.
+
+### Sprint output format
+
+`--sprint <ref>` prints a `Sprint:` line after the update line showing old → new binding:
+
+```
+Sprint: - → #3        # newly bound (was backlog)
+Sprint: #2 → #3       # rebound (moved from sprint 2 to 3)
+Sprint: #3 → -        # unbound
+Task LUM-48 already in sprint #3    # noop (same sprint)
+Task LUM-48 has no sprint binding   # noop (already unbound)
+```
+
+`--sprint` can be combined with other update flags. The PATCH (field updates) runs first; the sprint operation runs after. Failures on either step pass through independently without rollback.
+
+### Out of scope
+
+The CLI does **not** currently update due date or parent task. Those need to be edited in the web UI.
+
+Milestone updates (`--milestone`) and sprint binding (`--sprint`) both work. Full milestone CRUD is available via `lumo milestone create / show / update / delete`, tasks can be bound/unbound in bulk via `lumo milestone add / remove <identifier> <task...>`, and milestones can be manually reordered via `lumo milestone reorder <ref...>` / `lumo milestone move <ref> --before|--after <ref>` (see below). Full sprint CRUD is available via `lumo sprint create / show / update / delete / start / close / add / remove` (see below).
+
+### `lumo task list [flags]` — list tasks assigned to you
+
+Default behavior: prints every task currently assigned to the authenticated user (no project / status filter), one per line, as a fixed-width table:
+
+```
+LUM-42  IN_PROGRESS  HIGH    web        Fix Slack OAuth redirect
+LUM-48  TODO         MEDIUM  backend    Investigate slow query
+```
+
+| Flag                    | Type    | Notes                                                                            |
+| ----------------------- | ------- | -------------------------------------------------------------------------------- |
+| `-s, --status <value>`  | enum    | Filter by status: `todo \| in_progress \| in_review \| done` (case-insensitive). |
+| `-p, --project <ref>`   | string  | Filter by project name (case-insensitive match against display name).            |
+| `-m, --milestone <ref>` | string  | Filter to my tasks under this milestone (name or UUID).                          |
+| `-n, --limit <count>`   | integer | Cap output to the first N rows.                                                  |
+
+When `--milestone` is set, the CLI calls `GET /api/milestones/<id>/tasks?assigned=me` instead of `/api/tasks/me`. Other filters (`--status`, `--limit`) still apply client-side to the milestone-scoped result.
+
+Filtering is currently client-side — the server returns the full "my tasks" set and the CLI slices it. This is fine for typical workspaces (dozens of tasks); revisit if a workspace has hundreds.
+
+### When to suggest `task list`
+
+- The user asks "what am I working on", "what tasks do I have", "list my tasks", "show me my queue".
+- Before suggesting a status change ("mark something as done"), if no task ID is in context — run `task list` first to surface candidates.
+
+### `lumo next [--count <N>]` — recommend the next task to work on
+
+Ranks the tasks assigned to you and prints the top N (default 3), each with a
+one-line reason. Read-only — it does **not** bind or load context. Pick one from
+the list, then run `lumo session attach <LUM-N>` + `lumo task context <LUM-N>`.
+
+Ranking is lexicographic: **priority** (URGENT→LOW) first, then **active-sprint
+membership**, then **due date** (earlier first), then in-flight status
+(IN_PROGRESS / IN_REVIEW ahead of TODO). DONE tasks are excluded. The active
+sprint lookup is best-effort — if it fails the command still recommends, just
+without the sprint boost.
+
+| Flag              | Type    | Notes                                                                   |
+| ----------------- | ------- | ----------------------------------------------------------------------- |
+| `-n, --count <N>` | integer | How many tasks to recommend. Defaults to 3. Must be a positive integer. |
+
+```bash
+lumo next
+lumo next --count 1
+```
+
+Output:
+
+```
+Top 3 recommended tasks (of 12 open):
+
+1. LUM-42  IN_PROGRESS  URGENT  Fix Slack OAuth redirect
+     ↳ URGENT · active sprint · due 2026-06-03 (overdue) · in progress
+2. LUM-48  TODO         HIGH    Investigate slow query
+     ↳ HIGH · active sprint
+3. LUM-12  TODO         MEDIUM  Add rate limiting
+     ↳ MEDIUM · due 2026-06-10
+
+Next: lumo session attach LUM-42 && lumo task context LUM-42
+```
+
+When to suggest: the user asks "what should I work on", "what's next", "推荐下一个任务", "pick my next task", or starts a session without a task in mind. After they choose, run `session attach` + `task context` for the picked task.
+
+### `lumo task show <identifier>` — print one task's detail
+
+Returns a key:value block for a single task — title, status, priority, project, assignee (with display name from Clerk), URL, and the full description below. Lighter than `task context` because it does not load prior session summaries or memory.
+
+```bash
+lumo task show LUM-42
+```
+
+Use when the user wants the current state of a task without the agent-handoff payload.
+
+### `lumo task comment <identifier> <body>` — leave a comment
+
+Two-step under the hood (resolve LUM-N → POST comment). Body is plain text; quote it to embed spaces or newlines.
+
+```bash
+lumo task comment LUM-42 "Reproduced the redirect bug on staging — Safari only, not Chrome."
+```
+
+The CLI does not support @-mention chip syntax. If the user wants to ping someone, they should comment from the web UI.

package/assets/skill/references/worktree.md

@@ -0,0 +1,60 @@
+# Worktrees
+
+Local dev tooling that scaffolds parallel git worktrees. Unlike every other
+`lumo` command, these do **not** touch the Lumo server — they shell out to git
+and the local filesystem. **Run `add` and `rm` from the main checkout**, not from
+inside a worktree (the node_modules symlink source and `.worktrees/` both live
+there); `list` is read-only and runnable from anywhere.
+
+## `lumo worktree add <LUM-N> [slug]`
+
+Creates `.worktrees/<LUM-N>[-slug]` on branch `lumo/<LUM-N>[-slug]`, branched off
+`origin/main` (after a fetch), and symlinks its `node_modules` to the main
+checkout so jest/tsc work immediately. With no slug, the dir and branch use the
+bare `LUM-N` form. Prints next-step guidance plus the two gotchas it can't fix
+for you (shared prisma client, jest cwd).
+
+```bash
+lumo worktree add LUM-267 worktree-scaffold   # → .worktrees/LUM-267-worktree-scaffold
+lumo worktree add LUM-267                      # → .worktrees/LUM-267
+lumo worktree add LUM-267 --base main          # branch off local main, skip fetch
+lumo worktree add LUM-267 --no-fetch           # branch off existing origin/main
+lumo worktree add LUM-267 --verify             # run npx jest baseline after setup
+```
+
+Flags: `--base <ref>` (branch off a ref other than origin/main; skips the
+fetch), `--no-fetch` (skip `git fetch origin main`), `--verify` (run `npx jest`
+in the new worktree). Errors if the target dir already exists; reuses the branch
+if it already exists (adds the worktree without `-b`).
+
+**The prisma gotcha it warns about:** the generated client lives in the shared
+(symlinked) `node_modules`, so a `prisma generate` in one worktree clobbers the
+client every parallel worktree depends on. Verify with jest (SWC mocks Prisma);
+do `generate + tsc` atomically once at the end.
+
+**The jest gotcha it warns about:** always run jest from the worktree root (`cd`
+in first) — `cli/` has no jest config, and running from the main checkout hits
+the `cli/package.json` haste collision and silently runs the wrong tests.
+
+## `lumo worktree rm <LUM-N>`
+
+Removes the worktree for a task. Requires `--yes`. Refuses a dirty worktree
+unless `--force`. Keeps the branch by default (it may hold unpushed work / an
+open PR); `--delete-branch` removes it with `git branch -d` (which itself
+refuses an unmerged branch).
+
+```bash
+lumo worktree rm LUM-267 --yes
+lumo worktree rm LUM-267 --yes --force            # discard uncommitted changes
+lumo worktree rm LUM-267 --yes --delete-branch    # also delete lumo/LUM-267…
+```
+
+## `lumo worktree list`
+
+Lists worktrees under `.worktrees/` with task id, branch, dirty state, and
+whether `node_modules` is symlinked (a `MISSING` link is the first thing to
+check when jest/tsc misbehaves). Read-only; runnable from anywhere in the repo.
+
+```bash
+lumo worktree list
+```

package/dist/cli/src/commands/milestone-show.js

@@ -18,6 +18,27 @@ function fmtDate(iso) {
 function fmtHealth(health) {
     return health ? HEALTH_LABEL[health] : '-';
 }
+function sprintCoverageLines(coverage) {
+    if (!coverage)
+        return [];
+    if (coverage.sprints.length === 0) {
+        return ['', 'Sprint coverage: (no sprint coverage)'];
+    }
+    const numW = Math.max(...coverage.sprints.map(s => `#${s.number}`.length));
+    const statusW = Math.max(...coverage.sprints.map(s => s.status.length));
+    const nameW = Math.max(...coverage.sprints.map(s => (0, sanitize_1.sanitizeField)(s.name).length));
+    const rows = coverage.sprints.map(s => {
+        const num = `#${s.number}`.padEnd(numW);
+        const status = s.status.padEnd(statusW);
+        const name = (0, sanitize_1.sanitizeField)(s.name).padEnd(nameW);
+        return `  ${num}  ${status}  ${name}   ${s.doneCount}/${s.taskCount} done`;
+    });
+    if (coverage.unsprinted > 0) {
+        const label = '未排期'.padEnd(numW + 2 + statusW + 2 + nameW);
+        rows.push(`  ${label}   ${coverage.unsprinted} task${coverage.unsprinted === 1 ? '' : 's'}`);
+    }
+    return ['', 'Sprint coverage:', ...rows];
+}
 function formatMilestoneShow(m, tasks) {
     const total = m.taskCounts.TODO +
         m.taskCounts.IN_PROGRESS +
@@ -36,6 +57,7 @@ function formatMilestoneShow(m, tasks) {
         ``,
         `Tasks:        ${total} total (TODO ${m.taskCounts.TODO} / IN_PROGRESS ${m.taskCounts.IN_PROGRESS} / IN_REVIEW ${m.taskCounts.IN_REVIEW} / DONE ${m.taskCounts.DONE})`,
     ];
+    lines.push(...sprintCoverageLines(m.sprintCoverage));
     if (tasks.length > 0) {
         lines.push('', (0, format_1.formatTaskListTable)(tasks));
     }
@@ -114,5 +136,6 @@ async function milestoneShow(identifier, opts) {
         projectName,
         taskCounts: milestone.taskCounts,
         health: milestone.health,
+        sprintCoverage: milestone.sprintCoverage,
     }, tasks) + '\n');
 }