@lumoai/cli 1.55.0 → 1.57.0

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

@@ -7,6 +7,7 @@ const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const sanitize_1 = require("../lib/sanitize");
 const rank_tasks_1 = require("../lib/rank-tasks");
+const next_steps_1 = require("../lib/next-steps");
 const claimable_filter_1 = require("../lib/claimable-filter");
 /**
  * `lumo next [-n, --count <N>]` — recommend the next task(s) to work on.
@@ -132,7 +133,14 @@ poolNoun = 'open') {
         lines.push(`     ↳ ${r.reasons.join(' · ')}`);
     });
     lines.push('');
-    lines.push(`Next: lumo session attach ${first.identifier} && lumo task context ${first.identifier}`);
+    // LUM-686: was a hand-written string here — the original drift source this
+    // feature exists to remove. Same advice, now through the shared renderer.
+    lines.push((0, next_steps_1.formatNextSteps)([
+        {
+            command: `lumo session attach ${first.identifier} && lumo task context ${first.identifier}`,
+            why: 'start on the top-ranked task',
+        },
+    ]));
     if (ranked.length > 1) {
         lines.push('(or pick any other LUM-N from the list)');
     }

package/dist/cli/src/commands/session-attach.js

@@ -4,6 +4,7 @@ exports.sessionAttach = sessionAttach;
 const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const sanitize_1 = require("../lib/sanitize");
+const next_steps_1 = require("../lib/next-steps");
 const resolve_project_1 = require("../lib/resolve-project");
 const memory_auto_1 = require("../lib/memory-auto");
 /**
@@ -166,6 +167,9 @@ async function sessionAttach(identifier, options) {
     catch {
         // best-effort — the bind already succeeded; never surface a sync error here
     }
+    // Last, after the contract/memory/sync sections — the block reads as the
+    // closing "so do this now" line rather than interrupting them (LUM-686).
+    (0, next_steps_1.emitNextSteps)(body.nextSteps ?? [], options ?? {});
 }
 /**
  * LUM-640: the `--steward` form — bind this session to a MILESTONE as a

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

@@ -41,6 +41,7 @@ const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
 const hooks_template_1 = require("../lib/hooks-template");
+const next_steps_1 = require("../lib/next-steps");
 const git_hook_template_1 = require("../lib/git-hook-template");
 const line_prompt_1 = require("../lib/line-prompt");
 const agent_1 = require("../lib/agent");
@@ -246,20 +247,28 @@ function printPostInstall() {
     const onPath = isLumoOnPath();
     const credsPath = path.join((0, config_1.configDir)(), 'credentials.json');
     const authed = fs.existsSync(credsPath);
-    process.stdout.write('\nNext steps:\n');
+    // LUM-686: same conditional advice, now assembled as NextStep[] and handed
+    // to the shared renderer. Locally static — setup has no task state to judge.
+    const steps = [];
     if (!onPath || isRunningUnderNpx()) {
-        process.stdout.write('  • Install the CLI globally so Claude Code hooks can find it:\n' +
-            '      npm install -g @lumoai/cli\n');
+        steps.push({
+            command: 'npm install -g @lumoai/cli',
+            why: 'install the CLI globally so Claude Code hooks can find it',
+        });
     }
     if (!authed) {
-        process.stdout.write('  • Authenticate so the CLI can sync with the Lumo server:\n' +
-            '      lumo auth login\n');
+        steps.push({
+            command: 'lumo auth login',
+            why: 'authenticate so the CLI can sync with the Lumo server',
+        });
     }
     if (onPath && authed && !isRunningUnderNpx()) {
-        process.stdout.write('  • All set. Open Claude Code in this directory — the SKILL.md and\n' +
-            '    hooks are wired in.\n');
+        steps.push({
+            command: null,
+            why: 'All set. Open Claude Code in this directory — the SKILL.md and hooks are wired in.',
+        });
     }
-    process.stdout.write('\n');
+    process.stdout.write(`\n${(0, next_steps_1.formatNextSteps)(steps)}\n\n`);
 }
 function isLumoOnPath() {
     try {

package/dist/cli/src/commands/task-comment-list.js

@@ -54,11 +54,12 @@ function formatCommentThread(comments, opts = {}) {
     if (opts.full)
         return blocks.join('\n\n');
     const id = opts.identifier ?? '<LUM-N>';
+    const fetchCommand = opts.fetchCommand ?? 'task comments list';
     return (0, output_budget_1.truncateUnitsToBudget)({
         units: blocks,
         maxTokens: opts.maxTokens,
         unitNoun: 'comments',
-        fetchHint: `read the whole thread with: lumo task comments list ${id} --full`,
+        fetchHint: `read the whole thread with: lumo ${fetchCommand} ${id} --full`,
         separator: '\n\n',
     }).text;
 }

package/dist/cli/src/commands/task-context.js

@@ -5,9 +5,10 @@ exports.formatTaskContextMarkdown = formatTaskContextMarkdown;
 const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const sanitize_1 = require("../lib/sanitize");
+const next_steps_1 = require("../lib/next-steps");
 const format_1 = require("../lib/format");
 const output_budget_1 = require("../../../shared/src/output-budget");
-async function taskContext(identifier) {
+async function taskContext(identifier, options) {
     if (!identifier) {
         console.error('Error: missing <identifier>. Usage: lumo task context <LUM-42>');
         return 1;
@@ -45,6 +46,9 @@ async function taskContext(identifier) {
     const data = (await res.json());
     const now = new Date();
     process.stdout.write(formatTaskContextMarkdown(data, now));
+    // Emitted outside the rendered markdown so the output budget can never drop
+    // it — the closing "so do this now" line is the cheapest section here.
+    (0, next_steps_1.emitNextSteps)(data.nextSteps ?? [], options ?? {});
 }
 /**
  * Render a TaskContextResponse as the agent-facing markdown handoff. Pure

package/dist/cli/src/commands/task-create.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertSameTeam = assertSameTeam;
 exports.normalizePriority = normalizePriority;
+exports.formatCreateOutput = formatCreateOutput;
 exports.formatCreatedTaskLine = formatCreatedTaskLine;
 exports.taskCreate = taskCreate;
 const config_1 = require("../lib/config");
@@ -9,6 +10,7 @@ const api_1 = require("../lib/api");
 const tag_resolver_1 = require("../lib/tag-resolver");
 const resolve_1 = require("../lib/resolve");
 const sanitize_1 = require("../lib/sanitize");
+const next_steps_1 = require("../lib/next-steps");
 const ALLOWED_PRIORITIES = ['LOW', 'MEDIUM', 'HIGH', 'URGENT'];
 /**
  * Assert that the sprint belongs to the same team as the newly created task.
@@ -80,6 +82,21 @@ function normalizePriority(value) {
         ? upper
         : null;
 }
+/**
+ * Compose the full `task create` output: the result line first, then the
+ * server-computed next-step block (LUM-686). Exported so the render test
+ * exercises the real composition rather than re-assembling the parts itself.
+ *
+ * The result line stays byte-identical and first — a reader taking line 1 is
+ * unaffected by the block below it.
+ */
+function formatCreateOutput(task, steps = [], opts = {}, env = process.env) {
+    const head = formatCreatedTaskLine(task);
+    if ((0, next_steps_1.nextStepsSilenced)(env, opts))
+        return head;
+    const block = (0, next_steps_1.formatNextSteps)(steps);
+    return block === '' ? head : `${head}\n\n${block}`;
+}
 /**
  * Format the single-line success output. Title is double-quoted; embedded
  * double-quotes are backslash-escaped so the output stays parseable as one
@@ -173,7 +190,7 @@ async function taskCreate(title, opts) {
     if (res.status === 201) {
         const data = (await res.json());
         const responseTagNames = (data.task.taskTags ?? []).map(t => t.name);
-        process.stdout.write(formatCreatedTaskLine({ ...data.task, tags: responseTagNames }) + '\n');
+        process.stdout.write(formatCreateOutput({ ...data.task, tags: responseTagNames }, data.nextSteps ?? [], opts) + '\n');
         // Sprint binding (optional): if --sprint was passed, bind the new task.
         if (opts.sprint) {
             const workspaceSlug = creds.workspaceSlug ?? '';

package/dist/cli/src/commands/task-update.js

@@ -11,6 +11,7 @@ const task_create_1 = require("./task-create");
 const tag_resolver_1 = require("../lib/tag-resolver");
 const resolve_1 = require("../lib/resolve");
 const sanitize_1 = require("../lib/sanitize");
+const next_steps_1 = require("../lib/next-steps");
 const ALLOWED_STATUSES = ['TODO', 'IN_PROGRESS', 'IN_REVIEW', 'DONE'];
 /**
  * Pure function: given the task's current sprint binding and the resolved
@@ -101,7 +102,21 @@ function formatUpdatedTaskLine(task) {
     }
     return head;
 }
+/**
+ * Thin wrapper so the next-step block always lands last (LUM-686). The update
+ * flow has several success exits — a plain PATCH, plus the sprint bind/unbind
+ * branches — and hints belong after whatever the command printed, not wedged
+ * before the Sprint line. Only the wrapper emits; the inner run just collects.
+ */
 async function taskUpdate(identifier, opts) {
+    const collected = { steps: [] };
+    const code = await runTaskUpdate(identifier, opts, collected);
+    // Success only — a failed update's advice would be noise on top of an error.
+    if (code === undefined)
+        (0, next_steps_1.emitNextSteps)(collected.steps, opts);
+    return code;
+}
+async function runTaskUpdate(identifier, opts, collected) {
     if (!identifier || identifier.trim().length === 0) {
         console.error('Error: missing <identifier>. Usage: lumo task update <LUM-42> [options]');
         return 1;
@@ -249,6 +264,7 @@ async function taskUpdate(identifier, opts) {
             if (responseTagNames !== undefined)
                 taskLine.tags = responseTagNames;
             process.stdout.write(formatUpdatedTaskLine(taskLine) + '\n');
+            collected.steps = data.nextSteps ?? [];
         }
         else {
             let serverMsg = null;

package/dist/cli/src/commands/worktree-add.js

@@ -37,15 +37,20 @@ exports.worktreeAdd = worktreeAdd;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
+const next_steps_1 = require("../lib/next-steps");
 const worktree_1 = require("../lib/worktree");
+const worktree_ref_1 = require("../lib/worktree-ref");
 function printGuidance(dir, branch) {
     console.log('');
     console.log(`✓ Worktree ready: ${dir}`);
     console.log(`  branch:        ${branch}`);
     console.log(`  node_modules:  symlinked to main checkout`);
     console.log('');
-    console.log('Next:');
-    console.log(`  cd ${dir}`);
+    // Locally-static source: no server round-trip to carry steps, but the same
+    // renderer so the block looks identical everywhere (LUM-686).
+    console.log((0, next_steps_1.formatNextSteps)([
+        { command: `cd ${dir}`, why: 'work from the isolated checkout' },
+    ]));
     console.log('');
     console.log('Gotchas baked into this worktree:');
     console.log('  • prisma: the generated client is SHARED via the node_modules symlink.');
@@ -55,9 +60,16 @@ function printGuidance(dir, branch) {
     console.log('          cli/package.json haste collision silently runs the wrong tests.');
 }
 async function worktreeAdd(rawId, slug, opts) {
-    const taskId = (0, worktree_1.normalizeTaskId)(rawId);
+    let taskId;
+    try {
+        taskId = await (0, worktree_ref_1.resolveWorktreeTaskId)(rawId);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
     if (!taskId) {
-        console.error(`Error: "${rawId}" is not a task id (expected LUM-N or N)`);
+        console.error(`Error: "${rawId}" is not a task id (expected <TEAM>-N like LUM-42 or SPEC-12, or a bare number)`);
         return 1;
     }
     if (!(0, worktree_1.isMainCheckout)()) {

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

@@ -46,7 +46,7 @@ function nodeModulesLinked(dir) {
         return false;
     }
 }
-/** Pull a LUM-N from a worktree dir basename or its branch, else '—'. */
+/** Pull a `<TEAM>-N` id from a worktree dir basename or its branch, else '—'. */
 function taskIdOf(dirBase, branch) {
     return ((0, git_task_1.matchTaskIdentifier)(dirBase) ??
         (branch ? (0, git_task_1.matchTaskIdentifier)(branch) : null) ??

package/dist/cli/src/commands/worktree-rm.js

@@ -2,10 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.worktreeRm = worktreeRm;
 const worktree_1 = require("../lib/worktree");
+const worktree_ref_1 = require("../lib/worktree-ref");
 async function worktreeRm(rawId, opts) {
-    const taskId = (0, worktree_1.normalizeTaskId)(rawId);
+    let taskId;
+    try {
+        taskId = await (0, worktree_ref_1.resolveWorktreeTaskId)(rawId);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
     if (!taskId) {
-        console.error(`Error: "${rawId}" is not a task id (expected LUM-N or N)`);
+        console.error(`Error: "${rawId}" is not a task id (expected <TEAM>-N like LUM-42 or SPEC-12, or a bare number)`);
         return 1;
     }
     if (!(0, worktree_1.isMainCheckout)()) {

package/dist/cli/src/index.js

@@ -47,6 +47,19 @@ 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 idea_slack_add_1 = require("./commands/idea-slack-add");
+const idea_slack_show_1 = require("./commands/idea-slack-show");
+const idea_slack_rm_1 = require("./commands/idea-slack-rm");
+const idea_web_add_1 = require("./commands/idea-web-add");
+const idea_web_show_1 = require("./commands/idea-web-show");
+const idea_web_rm_1 = require("./commands/idea-web-rm");
+const idea_figma_add_1 = require("./commands/idea-figma-add");
+const idea_figma_list_1 = require("./commands/idea-figma-list");
+const idea_figma_rm_1 = require("./commands/idea-figma-rm");
+const idea_figma_refresh_1 = require("./commands/idea-figma-refresh");
+const idea_figma_context_1 = require("./commands/idea-figma-context");
+const idea_comment_1 = require("./commands/idea-comment");
+const initiative_1 = require("./commands/initiative");
 const plan_1 = require("./commands/plan");
 const cost_1 = require("./commands/cost");
 const priority_1 = require("./commands/priority");
@@ -203,8 +216,18 @@ const program = new commander_1.Command()
     // point at --help instead of dead-ending on "unknown option". Subcommands
     // created via .command() inherit these settings.
     .showSuggestionAfterError(true)
-    .showHelpAfterError('(run the command with --help to list its valid flags and arguments)');
+    .showHelpAfterError('(run the command with --help to list its valid flags and arguments)')
+    // LUM-686: global mute for the trailing next-step block. `LUMO_NO_HINTS=1`
+    // does the same for a whole shell.
+    .option('--no-hints', 'suppress the trailing next-step suggestions');
 exports.program = program;
+// Commander does not merge program-level options into a subcommand's own
+// opts(), so the global `--no-hints` is folded into the env channel before any
+// action runs. One silencing path (`nextStepsSilenced`) instead of two.
+program.hook('preAction', thisCommand => {
+    if (thisCommand.opts().hints === false)
+        process.env.LUMO_NO_HINTS = '1';
+});
 const auth = program.command('auth').description('Manage Lumo authentication');
 auth
     .command('login')
@@ -279,11 +302,103 @@ program
     .option('-n, --count <N>', 'Number of tasks to recommend (default 3)')
     .option('--claimable', 'Only recommend agent-claimable tasks that are unblocked (F3) and within milestone budget (F2)')
     .action(wrap(options => (0, next_1.nextCommand)(options)));
-program
-    .command('idea <statement>')
+const ideaCmd = program
+    .command('idea [statement]')
     .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)));
+ideaCmd
+    .command('list')
+    .description('List the team idea pool newest-first — each line shows the LUM-I<n> id, status (CAPTURED|DEVELOPING|PLANNED|DROPPED) and statement.')
+    .action(wrap(() => (0, idea_1.ideaList)()));
+ideaCmd
+    .command('update <id>')
+    .description('Move an idea through its lifecycle (LUM-679). Allowed: CAPTURED↔DEVELOPING→PLANNED and any state→DROPPED (DROPPED is terminal). <id> is the LUM-I<n> id (a bare number also resolves).')
+    .option('-s, --status <value>', 'New status: captured | developing | planned | dropped (case-insensitive)')
+    .action(wrap((id, options) => (0, idea_1.ideaUpdate)(id, options)));
+// Idea evidence commands (LUM-681): mirrors `task slack/web/figma`, hitting
+// `/api/ideas/:id/...` instead of `/api/tasks/:id/...`. Lets an agent attach
+// Slack threads, web links, and Figma design links to an idea before it goes
+// through the plan-run converter.
+const ideaSlack = ideaCmd
+    .command('slack')
+    .description('Attach & inspect Slack context on an idea');
+ideaSlack
+    .command('add <idea> <permalink>')
+    .description('Attach a Slack thread to an idea')
+    .action(wrap((id, p) => (0, idea_slack_add_1.ideaSlackAdd)(id, p)));
+ideaSlack
+    .command('show <idea> <contextId>')
+    .description('Show the full stored Slack thread snapshot')
+    .action(wrap((id, ctx) => (0, idea_slack_show_1.ideaSlackShow)(id, ctx)));
+ideaSlack
+    .command('rm <idea> <contextId>')
+    .description('Remove a Slack context from an idea')
+    .action(wrap((id, ctx) => (0, idea_slack_rm_1.ideaSlackRm)(id, ctx)));
+const ideaWeb = ideaCmd
+    .command('web')
+    .description('Attach & inspect web links on an idea');
+ideaWeb
+    .command('add <idea> <url>')
+    .description('Attach a web link to an idea')
+    .action(wrap((id, u) => (0, idea_web_add_1.ideaWebAdd)(id, u)));
+ideaWeb
+    .command('show <idea> <linkId>')
+    .description('Show the fetched web link body as plain text')
+    .action(wrap((id, l) => (0, idea_web_show_1.ideaWebShow)(id, l)));
+ideaWeb
+    .command('rm <idea> <linkId>')
+    .description('Remove a web link from an idea')
+    .action(wrap((id, l) => (0, idea_web_rm_1.ideaWebRm)(id, l)));
+const ideaFigma = ideaCmd
+    .command('figma')
+    .description('Attach Figma links to an idea');
+ideaFigma
+    .command('add <idea> <url>')
+    .description('Attach a Figma file/frame URL to an idea')
+    .action(wrap((id, u) => (0, idea_figma_add_1.ideaFigmaAdd)({ identifier: id, url: u })));
+ideaFigma
+    .command('list <idea>')
+    .description('List Figma links on an idea')
+    .action(wrap(id => (0, idea_figma_list_1.ideaFigmaList)({ identifier: id })));
+ideaFigma
+    .command('rm <idea> <link-id-or-url>')
+    .description('Remove a Figma link from an idea (idempotent)')
+    .action(wrap((id, l) => (0, idea_figma_rm_1.ideaFigmaRm)({ identifier: id, linkIdOrUrl: l })));
+ideaFigma
+    .command('refresh <idea>')
+    .description('Re-fetch Figma metadata for every link on an idea')
+    .action(wrap(id => (0, idea_figma_refresh_1.ideaFigmaRefresh)({ identifier: id })));
+ideaFigma
+    .command('context <idea> <linkId>')
+    .description('Show cached Figma design context')
+    .action(wrap((id, l) => (0, idea_figma_context_1.ideaFigmaContext)(id, l)));
+ideaCmd
+    .command('comment <id> <body>')
+    .description('Comment on an idea (LUM-680). <id> is the LUM-I<n> id (a bare number also resolves). Body is plain text — quote it to pass spaces or newlines.')
+    .action(wrap((id, body) => (0, idea_comment_1.ideaComment)(id, body)));
+// Plural `comments` parent (mirrors `task comments`): `idea comment <id> <body>`
+// already exists for posting, and commander disallows a duplicate name.
+const ideaComments = ideaCmd
+    .command('comments')
+    .description('Inspect an idea comment thread');
+ideaComments
+    .command('list <id>')
+    .description('List an idea comment thread (capped to the output budget; --full prints every comment).')
+    .option('--full', 'Print every comment, bypassing the output-token cap')
+    .action(wrap((id, opts) => (0, idea_comment_1.ideaCommentList)(id, opts)));
+const initiativeCmd = program
+    .command('initiative')
+    .description('Team-level Initiatives (LUM-INIT-<n>): create one directly (no plan run required) or list them. Converter-materialised initiatives show here too.');
+initiativeCmd
+    .command('create <goal>')
+    .description('Create a team-level initiative directly from a goal statement — no plan run required. Prints the LUM-INIT-<n> id; --assumption records the bet behind it.')
+    .option('--assumption <text>', 'The bet/assumption behind the initiative (赌注旁注)')
+    .action(wrap((goal, options) => (0, initiative_1.initiativeCreate)(goal, options)));
+initiativeCmd
+    .command('list')
+    .description('List the team initiatives newest-first — each line shows the LUM-INIT-<n> id, status (ACTIVE|DONE|DROPPED) and goal.')
+    .action(wrap(() => (0, initiative_1.initiativeList)()));
 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.')

package/dist/cli/src/lib/idea-figma-api.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addIdeaFigmaLink = addIdeaFigmaLink;
+exports.listIdeaFigmaLinks = listIdeaFigmaLinks;
+exports.removeIdeaFigmaLink = removeIdeaFigmaLink;
+exports.refreshIdeaFigmaLinks = refreshIdeaFigmaLinks;
+const api_1 = require("./api");
+const config_1 = require("./config");
+function buildErr(status, body) {
+    const err = Object.assign(new Error(body.error ?? `HTTP ${status}`), {
+        status,
+    });
+    if (body.code !== undefined)
+        err.code = body.code;
+    return err;
+}
+async function call(path, init) {
+    const creds = (0, config_1.readCredentials)();
+    if (!creds)
+        throw new Error('Not logged in. Run: lumo auth login');
+    const apiUrl = (0, api_1.resolveAuthedApiUrl)(creds.apiUrl);
+    const res = await fetch(`${(0, api_1.trimTrailingSlash)(apiUrl)}${path}`, {
+        ...init,
+        headers: {
+            Authorization: `Bearer ${creds.token}`,
+            'Content-Type': 'application/json',
+            ...(init.headers ?? {}),
+        },
+    });
+    if (!res.ok) {
+        let parsed = {};
+        try {
+            parsed = (await res.json());
+        }
+        catch {
+            /* non-JSON body */
+        }
+        throw buildErr(res.status, parsed);
+    }
+    return (await res.json());
+}
+/**
+ * Idea-side counterpart to `cli/src/lib/figma-api.ts` (LUM-681). Same shape,
+ * same error codes (`figma_not_connected` / `figma_needs_reauth`), only the
+ * URL prefix differs: `/api/ideas/:id/...` instead of `/api/tasks/:id/...`.
+ */
+async function addIdeaFigmaLink(identifier, url) {
+    return call(`/api/ideas/${encodeURIComponent(identifier)}/figma`, {
+        method: 'POST',
+        body: JSON.stringify({ url }),
+    });
+}
+async function listIdeaFigmaLinks(identifier) {
+    return call(`/api/ideas/${encodeURIComponent(identifier)}/figma`, {
+        method: 'GET',
+    });
+}
+async function removeIdeaFigmaLink(identifier, linkId) {
+    return call(`/api/ideas/${encodeURIComponent(identifier)}/figma/${encodeURIComponent(linkId)}`, { method: 'DELETE' });
+}
+async function refreshIdeaFigmaLinks(identifier) {
+    return call(`/api/ideas/${encodeURIComponent(identifier)}/figma/refresh`, {
+        method: 'POST',
+    });
+}

package/dist/cli/src/lib/next-steps.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NEXT_STEPS_MAX = void 0;
+exports.nextStepsSilenced = nextStepsSilenced;
+exports.formatNextSteps = formatNextSteps;
+exports.emitNextSteps = emitNextSteps;
+const sanitize_1 = require("./sanitize");
+/** Mirrors NEXT_STEPS_MAX server-side; a defence in depth, not the only cap. */
+exports.NEXT_STEPS_MAX = 3;
+const HEADING = 'Next:';
+/**
+ * True when the user has muted suggestions. Hints cost tokens on every command;
+ * anyone who finds them noise must be able to turn them off for good.
+ */
+function nextStepsSilenced(env = process.env, opts = {}) {
+    // Commander maps `--no-hints` to `opts.hints === false`.
+    if (opts.hints === false)
+        return true;
+    const flag = env.LUMO_NO_HINTS;
+    return flag !== undefined && flag !== '' && flag !== '0';
+}
+/**
+ * Render the trailing suggestion block. Returns "" when there is nothing to
+ * say, so callers can append unconditionally without emitting a bare heading.
+ */
+function formatNextSteps(steps) {
+    const capped = steps.slice(0, exports.NEXT_STEPS_MAX);
+    if (capped.length === 0)
+        return '';
+    const lines = [HEADING];
+    for (const step of capped) {
+        const why = (0, sanitize_1.sanitizeField)(step.why);
+        lines.push(step.command === null
+            ? `  ${why}`
+            : `  ${(0, sanitize_1.sanitizeField)(step.command)}\n      ${why}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Write the block to **stdout**, after the command's own result line.
+ *
+ * Deliberately not stderr: suggestions are not errors, `2>/dev/null` would
+ * swallow them, some harnesses read any stderr output as failure, and with
+ * both streams redirected to one file the block can surface *above* the result
+ * it follows. Machine consumers are served by `--json` instead, where the
+ * steps ride as a field rather than as text.
+ */
+function emitNextSteps(steps, opts = {}, out = process.stdout, env = process.env) {
+    if (nextStepsSilenced(env, opts))
+        return;
+    const block = formatNextSteps(steps);
+    if (block === '')
+        return;
+    out.write(`\n${block}\n`);
+}

package/dist/cli/src/lib/worktree-ref.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWorktreeTaskId = resolveWorktreeTaskId;
+const config_1 = require("./config");
+const api_1 = require("./api");
+const worktree_1 = require("./worktree");
+/**
+ * Resolve a user-supplied worktree ref to a canonical `<TEAM>-<n>` id.
+ *
+ * - Explicit prefix (`SPEC-12`, `lum-267`) → normalized locally, NO network.
+ * - Bare number (`267`) → completed with the workspace's DEFAULT team prefix
+ *   (GET /api/teams: the `isDefault` team, or the sole team in a single-team
+ *   workspace). Worktree tooling is otherwise purely local; the API is touched
+ *   only to disambiguate a prefix-less number.
+ *
+ * Returns null when `raw` is not a task-id shape at all (caller prints the
+ * "expected <TEAM>-N" usage error). Throws Error with a user-facing message
+ * when a bare number needs the default team but it can't be determined
+ * (not logged in / offline / ambiguous multi-team without a default) — every
+ * message points the user at passing an explicit prefix instead.
+ */
+async function resolveWorktreeTaskId(raw) {
+    const explicit = (0, worktree_1.normalizeTaskId)(raw);
+    if (explicit)
+        return explicit;
+    const bare = raw.trim().match(/^(\d+)$/);
+    if (!bare)
+        return null;
+    const n = bare[1];
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        throw new Error(`a bare number needs your default team prefix — run \`lumo auth login\`, or pass an explicit id like LUM-${n}`);
+    }
+    const base = (0, api_1.trimTrailingSlash)((0, api_1.resolveAuthedApiUrl)(creds.apiUrl));
+    let teams;
+    try {
+        const res = await fetch(`${base}/api/teams`, {
+            headers: { Authorization: `Bearer ${creds.token}` },
+        });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        ({ teams } = (await res.json()));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`could not resolve the default team for bare id "${n}" (${msg}) — pass an explicit id like LUM-${n}`);
+    }
+    const def = teams.find(t => t.isDefault) ?? (teams.length === 1 ? teams[0] : undefined);
+    if (!def) {
+        throw new Error(`workspace has multiple teams and no default — pass an explicit id like SPEC-${n} instead of a bare number`);
+    }
+    return `${def.identifier.toUpperCase()}-${n}`;
+}

package/dist/cli/src/lib/worktree.js

@@ -46,19 +46,21 @@ exports.getGitCommonDir = getGitCommonDir;
 exports.isMainCheckout = isMainCheckout;
 exports.getRepoRoot = getRepoRoot;
 /**
- * Normalize a user-supplied task reference to canonical `LUM-<n>` form.
- * Accepts `LUM-267`, `lum-267`, and bare `267`. Returns null for anything
- * that is not a recognizable task id.
+ * Normalize a user-supplied task reference to canonical `<TEAM>-<n>` form.
+ * Accepts any team prefix (`LUM-267`, `SPEC-12`, `spec-12`), not just LUM —
+ * the prefix is a team's configured identifier (1–10 letters), matching the
+ * single-sourced shape in shared/src/task-identifier.ts (LUM-419). The prefix
+ * is upper-cased; the number is preserved.
+ *
+ * A bare number (`267`) returns null here: without team context the prefix
+ * cannot be inferred locally. Team-aware bare-number resolution (via the
+ * workspace's default team) lives in `resolveWorktreeTaskId` (worktree-ref.ts).
  */
 function normalizeTaskId(input) {
-    const trimmed = input.trim();
-    const prefixed = trimmed.match(/^lum-?(\d+)$/i);
-    if (prefixed)
-        return `LUM-${prefixed[1]}`;
-    const bare = trimmed.match(/^(\d+)$/);
-    if (bare)
-        return `LUM-${bare[1]}`;
-    return null;
+    const m = input.trim().match(/^([A-Za-z]{1,10})-(\d+)$/);
+    if (!m)
+        return null;
+    return `${m[1].toUpperCase()}-${m[2]}`;
 }
 /**
  * Turn an arbitrary human slug into a branch/dir-safe segment: lowercase,

package/package.json

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