@lumoai/cli 1.54.0 → 1.55.0

package/assets/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: lumo
-description: 'Use when the user mentions a Lumo task id (LUM-N, or any team prefix like SPEC-12) or the `lumo` CLI, in any language; is starting, resuming, or about to claim completion of a task; asks what to work on next; or works with any Lumo resource — task context, sessions, acceptance criteria, machine verification, tasks, ideas, projects, milestones, sprints, docs, artifacts, Figma links, dependencies, team memory, priorities, or worktrees. Key triggers: "LUM-", "lumo", "task context", "session attach", "verify", "task status", "acceptance criteria", "what should I work on", "resume task".'
+description: 'Use when the user mentions a Lumo task id (LUM-N, or any team prefix like SPEC-12) or the `lumo` CLI, in any language; is starting, resuming, or about to claim completion of a task; asks what to work on next; or works with any Lumo resource — task context, sessions, acceptance criteria, machine verification, tasks, ideas, plan runs (the idea→plan converter), projects, milestones, sprints, docs, artifacts, Figma links, dependencies, team memory, priorities, or worktrees. Key triggers: "LUM-", "lumo", "task context", "session attach", "verify", "task status", "acceptance criteria", "what should I work on", "resume task".'
 ---
 
 ## Prerequisites
@@ -75,6 +75,12 @@ The command catalog below is a **map**: it lists every command grouped by domain
 - `lumo idea "<statement>" [--context <text>]` — capture a team-level idea into the pool in <10s. Provenance is grabbed opportunistically and never blocks the capture: the current `CLAUDE_CODE_SESSION_ID` (→ sourceSessionId) and the session's bound task (→ sourceTaskId, null when nothing is bound). Prints an **I-prefixed** id (`✓ 想法 LUM-I42 已入池`) — the `I` keeps ideas from colliding with task ids (`LUM-42`) in the same team namespace. Ideas are team-scoped (no project); the workspace's default team owns them. The unprocessed (CAPTURED) pool is what the Phase-2 transformer consumes.
   - **When to suggest**: the user has a stray idea/thought/improvement they want to park without derailing the current task ("记一下这个想法", "capture this idea", "add to the backlog of ideas"). Prefer this over `task create` for un-triaged sparks — an idea is above projects and isn't yet actionable work.
 
+**Plan runs (design-thinking 转换器)**
+
+- `lumo plan [--abandon-active]` — start a converter run that turns the team's captured idea pool + current priority into an executable plan through a 3-gate recoverable state machine (聚类→对齐→成计划). Freezes the input snapshot at start and enforces **one active run per team**: if a run is already active it refuses and points to `lumo plan status`; `--abandon-active` abandons the prior run first, then starts fresh. On success it prints (and opens) the **gate-A** web deep-link (`/workspace/<slug>/plan/<runId>`). The CLI only triggers — **all editing and gate confirmation happen in web**.
+- `lumo plan status` — print the active run's current stage (working segment or the open `*_READY` gate) and the deep-link to act on its next gate; with no active run, prompts to run `lumo plan`.
+  - **When to suggest**: the user wants to turn the parked idea pool into a plan / "跑一下转换器" / "start a planning run" / "把想法变成计划"; or asks where an in-flight plan run stands ("plan 到哪一步了", "plan status"). The gate work itself is web-only — the CLI hands off the deep-link.
+
 **Task dependencies** — see [task-deps.md](references/task-deps.md)
 
 - `lumo task deps list <id>` — list dependency edges both directions, grouped CONFIRMED / SUGGESTED / DISMISSED (each row: short edge id + other task + detected evidence)

package/dist/cli/src/commands/plan.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPlanDeepLink = formatPlanDeepLink;
+exports.stageLabel = stageLabel;
+exports.plan = plan;
+exports.planStatus = planStatus;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const sanitize_1 = require("../lib/sanitize");
+const browser_1 = require("../lib/browser");
+/**
+ * Web deep-link to a run's converter page: `/workspace/<slug>/plan/<runId>`.
+ * The page routes to whichever gate is open on the run — so the same link is
+ * "gate A" at start (run in CLUSTERING) and "the next gate" mid-run. Editing
+ * and gate confirmation happen in the web UI; the CLI only carries the human
+ * there.
+ */
+function formatPlanDeepLink(base, workspaceSlug, runId) {
+    return `${(0, api_1.trimTrailingSlash)(base)}/workspace/${workspaceSlug}/plan/${runId}`;
+}
+/**
+ * Human label for a run stage. The gates (`*_READY`) name the decision waiting
+ * on the human; the working stages name the LLM segment in flight. Unknown /
+ * future stages fall back to the raw enum so nothing is silently swallowed.
+ */
+function stageLabel(stage) {
+    const LABELS = {
+        CLUSTERING: '聚类中 (clustering)',
+        CLUSTERS_READY: '闸门 A · 聚类待确认 (gate A — confirm clusters)',
+        ALIGNING: '对齐中 (aligning)',
+        ALIGNMENT_READY: '闸门 B · 对齐待确认 (gate B — confirm alignment)',
+        GENERATING: '成计划中 (generating)',
+        DRAFT_READY: '闸门 C · 草案待确认 (gate C — confirm draft)',
+        FAILED: '失败 · 可重试 (failed — retryable)',
+    };
+    return LABELS[stage] ?? stage;
+}
+/**
+ * `lumo plan [--abandon-active]` — start a design-thinking 转换器 run.
+ *
+ * Starts a run and prints (and opens) the gate-A web deep-link. When a run is
+ * already active the server refuses (409) — we point the user at
+ * `lumo plan status` or `--abandon-active`. `--abandon-active` first abandons
+ * the prior run, then starts a fresh one. All editing/confirmation is in web;
+ * the CLI only triggers and hands off the deep-link.
+ */
+async function plan(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);
+    const body = {};
+    if (opts.abandonActive)
+        body.abandonActive = true;
+    let res;
+    try {
+        res = await fetch(`${base}/api/plan-runs`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${creds.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    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.status === 409) {
+        console.error('Error: a plan run is already active for your team.\n' +
+            '  Check it with `lumo plan status`, or start over with ' +
+            '`lumo plan --abandon-active`.');
+        return 1;
+    }
+    if (res.status === 201) {
+        const { run } = (await res.json());
+        const deepLink = formatPlanDeepLink(base, creds.workspaceSlug, run.id);
+        process.stdout.write(`✓ 计划转换 run 已启动 (${run.id}) — 聚类进行中。\n` +
+            '到闸门 A 在 web 端确认聚类结果:\n' +
+            `  ${(0, sanitize_1.sanitizeField)(deepLink)}\n`);
+        (0, browser_1.openBrowser)(deepLink);
+        return;
+    }
+    return reportServerError(res);
+}
+/**
+ * `lumo plan status` — where the active run stands.
+ *
+ * Prints the active run's current stage and the deep-link to act on its next
+ * gate. With no active run, prompts the user to run `lumo plan`.
+ */
+async function planStatus() {
+    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 res;
+    try {
+        res = await fetch(`${base}/api/plan-runs/active`, {
+            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) {
+        return reportServerError(res);
+    }
+    const { run } = (await res.json());
+    if (!run) {
+        process.stdout.write('没有进行中的计划转换 run。运行 `lumo plan` 启动一个。\n');
+        return;
+    }
+    const deepLink = formatPlanDeepLink(base, creds.workspaceSlug, run.id);
+    process.stdout.write(`计划转换 run ${run.id}\n` +
+        `  当前 stage: ${stageLabel(run.stage)}\n` +
+        '  下一个闸门在 web 端处理:\n' +
+        `  ${(0, sanitize_1.sanitizeField)(deepLink)}\n`);
+    return;
+}
+/** Print a server error body (or status-only fallback) to stderr; returns 1. */
+async function reportServerError(res) {
+    let serverMsg = null;
+    try {
+        const errBody = (await res.json());
+        if (typeof errBody.error === 'string')
+            serverMsg = errBody.error;
+    }
+    catch {
+        // Body wasn't JSON; fall through to a status-only message.
+    }
+    if (serverMsg) {
+        console.error(`Error: ${(0, sanitize_1.sanitizeField)(serverMsg)}`);
+    }
+    else {
+        console.error(`Error: plan command failed (HTTP ${res.status})`);
+    }
+    return 1;
+}

package/dist/cli/src/index.js

@@ -47,6 +47,7 @@ const session_attach_1 = require("./commands/session-attach");
 const session_status_1 = require("./commands/session-status");
 const next_1 = require("./commands/next");
 const idea_1 = require("./commands/idea");
+const plan_1 = require("./commands/plan");
 const cost_1 = require("./commands/cost");
 const priority_1 = require("./commands/priority");
 const criteria_audit_1 = require("./commands/criteria-audit");
@@ -283,6 +284,15 @@ program
     .description('Capture a team-level idea into the pool (<10s, no friction). Grabs the current Claude Code session id and its bound task as provenance; prints an I-prefixed id (e.g. LUM-I42). The transformer (Spec 2) consumes the pool.')
     .option('-c, --context <text>', 'Free-text origin context for the idea')
     .action(wrap((statement, options) => (0, idea_1.ideaCapture)(statement, options)));
+const planCmd = program
+    .command('plan')
+    .description('Start a design-thinking 转换器 run (聚类→对齐→成计划) and print the gate-A web deep-link. Refuses when a run is already active (see `lumo plan status`); --abandon-active abandons the prior run first. Editing/confirmation happen in web.')
+    .option('--abandon-active', 'Abandon the team’s existing active run before starting a fresh one')
+    .action(wrap(options => (0, plan_1.plan)(options)));
+planCmd
+    .command('status')
+    .description('Print the active plan run’s current stage and the deep-link to its next gate; with no active run, prompts to run `lumo plan`.')
+    .action(wrap(() => (0, plan_1.planStatus)()));
 program
     .command('cost')
     .description('Show per-operation (per-tool) token cost. Defaults to a workspace 30-day window; scope with --task / --session')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumoai/cli",
-  "version": "1.54.0",
+  "version": "1.55.0",
   "description": "Lumo CLI — manage tasks and sessions from the terminal",
   "license": "MIT",
   "author": "cli@uselumo.ai",