@lumoai/cli 1.11.0 → 1.17.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/dist/cli/src/commands/milestone-archive.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatArchiveResult = formatArchiveResult;
+exports.milestoneArchive = milestoneArchive;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_1 = require("../lib/resolve");
+const sanitize_1 = require("../lib/sanitize");
+function formatArchiveResult(name) {
+    return `Archived "${(0, sanitize_1.sanitizeField)(name)}"`;
+}
+async function milestoneArchive(identifier, opts) {
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const apiUrl = (0, api_1.resolveAuthedApiUrl)(creds.apiUrl);
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    let milestoneId;
+    try {
+        const resolved = await (0, resolve_1.resolveMilestoneId)(base, creds.token, identifier, opts.project);
+        milestoneId = resolved.id;
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    let res;
+    try {
+        res = await fetch(`${base}/api/milestones/${milestoneId}/archive`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${creds.token}` },
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`Error: could not reach Lumo API at ${apiUrl} (${msg})`);
+        return 1;
+    }
+    if (res.status === 401) {
+        console.error('Error: API key invalid or revoked. Run `lumo auth login`.');
+        return 1;
+    }
+    if (!res.ok) {
+        let errMsg = `milestone archive failed (HTTP ${res.status})`;
+        try {
+            const body = (await res.json());
+            if (body.error)
+                errMsg = body.error;
+        }
+        catch {
+            // non-JSON body; keep the status-only message
+        }
+        console.error(`Error: ${(0, sanitize_1.sanitizeField)(errMsg)}`);
+        return 1;
+    }
+    const { milestone } = (await res.json());
+    process.stdout.write(formatArchiveResult(milestone.name) + '\n');
+}

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

@@ -6,6 +6,14 @@ const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const resolve_1 = require("../lib/resolve");
 const sanitize_1 = require("../lib/sanitize");
+const HEALTH_LABEL = {
+    'on-track': 'ON-TRACK',
+    'at-risk': 'AT-RISK',
+    overdue: 'OVERDUE',
+};
+function formatHealth(health) {
+    return health ? HEALTH_LABEL[health] : '-';
+}
 function formatDate(iso) {
     if (!iso)
         return '-';
@@ -13,7 +21,10 @@ function formatDate(iso) {
 }
 /**
  * Render milestones as fixed-width rows:
- *   <STATUS>  <target-date or ->  <name>
+ *   <STATUS>  <HEALTH>  <target-date or ->  <name>
+ *
+ * HEALTH is the target-date risk light (ON-TRACK / AT-RISK / OVERDUE), or `-`
+ * when no light applies (terminal status or no target date).
  *
  * Sorted server-side by targetDate asc nulls last, createdAt asc.
  */
@@ -21,9 +32,10 @@ function formatMilestoneList(rows) {
     if (rows.length === 0)
         return 'No milestones.';
     const statusW = Math.max(...rows.map(r => r.status.length));
+    const healthW = Math.max(...rows.map(r => formatHealth(r.health).length));
     const dateW = Math.max(...rows.map(r => formatDate(r.targetDate).length));
     return rows
-        .map(r => `${r.status.padEnd(statusW)}  ${formatDate(r.targetDate).padEnd(dateW)}  ${(0, sanitize_1.sanitizeField)(r.name)}`)
+        .map(r => `${r.status.padEnd(statusW)}  ${formatHealth(r.health).padEnd(healthW)}  ${formatDate(r.targetDate).padEnd(dateW)}  ${r.archivedAt ? `${(0, sanitize_1.sanitizeField)(r.name)} (archived)` : (0, sanitize_1.sanitizeField)(r.name)}`)
         .join('\n');
 }
 async function milestoneList(options) {
@@ -43,9 +55,16 @@ async function milestoneList(options) {
         console.error(`Error: ${msg}`);
         return 1;
     }
-    const res = await fetch(`${base}/api/projects/${projectId}/milestones`, {
-        headers: { Authorization: `Bearer ${creds.token}` },
-    });
+    if (options.archived && options.all) {
+        console.error('Error: --archived and --all are mutually exclusive.');
+        return 1;
+    }
+    const filter = options.all ? 'all' : options.archived ? 'archived' : 'active';
+    const query = new URLSearchParams({ filter });
+    const term = options.search?.trim();
+    if (term)
+        query.set('search', term);
+    const res = await fetch(`${base}/api/projects/${projectId}/milestones?${query.toString()}`, { headers: { Authorization: `Bearer ${creds.token}` } });
     if (!res.ok) {
         console.error(`Error: milestone list failed (HTTP ${res.status})`);
         return 1;