@lumoai/cli 1.0.0

package/dist/cli/src/commands/doc-share.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeRole = normalizeRole;
+exports.docShare = docShare;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_doc_id_1 = require("../lib/resolve-doc-id");
+const resolve_member_1 = require("../lib/resolve-member");
+const ALLOWED_ROLES = ['VIEWER', 'EDITOR', 'MANAGER'];
+function normalizeRole(value) {
+    if (!value)
+        return null;
+    const upper = value.toUpperCase();
+    return ALLOWED_ROLES.includes(upper)
+        ? upper
+        : null;
+}
+async function docShare(docRef, memberRef, opts) {
+    if (!docRef || !memberRef) {
+        console.error('Error: usage: lumo doc share <doc> <member> [--role viewer|editor|manager]');
+        return 1;
+    }
+    let role = 'VIEWER';
+    if (opts.role !== undefined) {
+        const normalized = normalizeRole(opts.role);
+        if (!normalized) {
+            console.error(`Error: invalid role "${opts.role}". Allowed: viewer, editor, manager`);
+            return 1;
+        }
+        role = normalized;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const docId = await (0, resolve_doc_id_1.lookupDocId)(apiUrl, creds.token, docRef);
+    if (!docId) {
+        console.error(`Error: Document not found: ${docRef}`);
+        return 1;
+    }
+    let members;
+    try {
+        members = await (0, resolve_member_1.fetchMembers)(apiUrl, creds.token);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        return 1;
+    }
+    const result = (0, resolve_member_1.resolveMember)(members, memberRef, creds.email);
+    if (result.kind === 'not_found') {
+        console.error(`Error: no member matches "${result.query}".`);
+        return 1;
+    }
+    if (result.kind === 'ambiguous') {
+        const list = result.candidates.map(c => c.email ?? c.displayName).join(', ');
+        console.error(`Error: multiple members match "${result.query}": ${list}`);
+        return 1;
+    }
+    const url = `${(0, api_1.trimTrailingSlash)(apiUrl)}/api/documents/${docId}/shares`;
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${creds.token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ memberId: result.member.memberId, role }),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        console.error(`Error: ${res.status} ${res.statusText}: ${text}`);
+        return 1;
+    }
+    console.log(`Shared ${docId} ↔ ${result.member.displayName} (${role})`);
+}

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

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatShowOutput = formatShowOutput;
+exports.docShow = docShow;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const markdown_tiptap_1 = require("../lib/markdown-tiptap");
+const resolve_doc_id_1 = require("../lib/resolve-doc-id");
+function scopeLabel(s) {
+    if (s === 'PRIVATE')
+        return 'personal';
+    if (s === 'WORKSPACE')
+        return 'workspace';
+    return 'shared';
+}
+function formatShowOutput(vm) {
+    const lines = [
+        `ID: ${vm.id}`,
+        `Title: ${vm.title}`,
+        `Scope: ${scopeLabel(vm.scope)}`,
+        `Project: ${vm.projectName ?? '-'}`,
+        `Created: ${vm.createdAt}`,
+        `Updated: ${vm.updatedAt}`,
+        `Mentioned tasks: ${vm.mentionedTasks.length ? vm.mentionedTasks.join(', ') : '-'}`,
+    ];
+    const header = lines.join('\n');
+    return vm.bodyMarkdown ? `${header}\n\n${vm.bodyMarkdown}` : header;
+}
+async function docShow(reference) {
+    if (!reference) {
+        console.error('Error: missing <doc>. Usage: lumo doc show <doc>');
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const id = await (0, resolve_doc_id_1.lookupDocId)(apiUrl, creds.token, reference);
+    if (!id) {
+        console.error(`Error: Document not found: ${reference}`);
+        return 1;
+    }
+    const res = await fetch(`${(0, api_1.trimTrailingSlash)(apiUrl)}/api/documents/${id}`, {
+        headers: { Authorization: `Bearer ${creds.token}` },
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        console.error(`Error: ${res.status} ${res.statusText}: ${text}`);
+        return 1;
+    }
+    // The exact shape of the GET response is not guaranteed; defensively unwrap.
+    const data = (await res.json());
+    const d = data.document;
+    if (!d) {
+        console.error('Error: server returned an empty document response');
+        return 1;
+    }
+    // Server returns `contentMarkdown` derived from the HTML body (LUM-83+).
+    // Fall back to parsing the raw content as legacy Tiptap JSON for docs
+    // written before the storage shape changed.
+    let body = '';
+    if (d.contentMarkdown) {
+        body = d.contentMarkdown;
+    }
+    else if (d.content) {
+        try {
+            body = (0, markdown_tiptap_1.tiptapToMarkdown)(JSON.parse(d.content));
+        }
+        catch {
+            body = '';
+        }
+    }
+    // mentions may carry a flat identifier or a (team.identifier + number) shape.
+    const mentionedTasks = (d.mentions ?? [])
+        .map(m => {
+        if (!m.task)
+            return null;
+        if (m.task.identifier)
+            return m.task.identifier;
+        if (m.task.team?.identifier && typeof m.task.number === 'number') {
+            return `${m.task.team.identifier}-${m.task.number}`;
+        }
+        return null;
+    })
+        .filter((x) => x !== null);
+    console.log(formatShowOutput({
+        id: d.id,
+        title: d.title,
+        scope: d.visibility ?? 'PRIVATE',
+        projectName: d.project?.name ?? null,
+        createdAt: d.createdAt ?? '',
+        updatedAt: d.updatedAt ?? '',
+        mentionedTasks,
+        bodyMarkdown: body,
+    }));
+}

package/dist/cli/src/commands/doc-unbind.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.docUnbind = docUnbind;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_doc_id_1 = require("../lib/resolve-doc-id");
+async function docUnbind(docRef, task) {
+    if (!docRef || !task) {
+        console.error('Error: usage: lumo doc unbind <doc> <task>');
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const docId = await (0, resolve_doc_id_1.lookupDocId)(apiUrl, creds.token, docRef);
+    if (!docId) {
+        console.error(`Error: Document not found: ${docRef}`);
+        return 1;
+    }
+    // The DELETE route accepts either cuid or LUM-N as the [taskId] segment; the server resolves it.
+    const url = `${(0, api_1.trimTrailingSlash)(apiUrl)}/api/documents/${docId}/mentions/${encodeURIComponent(task)}`;
+    const res = await fetch(url, {
+        method: 'DELETE',
+        headers: { Authorization: `Bearer ${creds.token}` },
+    });
+    if (res.status === 409) {
+        const { error } = (await res.json());
+        console.error(`Error: ${error}`);
+        return 1;
+    }
+    if (!res.ok) {
+        const text = await res.text();
+        console.error(`Error: ${res.status} ${res.statusText}: ${text}`);
+        return 1;
+    }
+    const data = (await res.json());
+    if (data.removed === 0) {
+        console.log(`Already unbound ${docId} ↔ ${data.taskIdentifier}`);
+    }
+    else {
+        console.log(`Unbound ${docId} ↔ ${data.taskIdentifier}`);
+    }
+}

package/dist/cli/src/commands/doc-unshare.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.docUnshare = docUnshare;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_doc_id_1 = require("../lib/resolve-doc-id");
+const resolve_member_1 = require("../lib/resolve-member");
+async function docUnshare(docRef, memberRef) {
+    if (!docRef || !memberRef) {
+        console.error('Error: usage: lumo doc unshare <doc> <member>');
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const docId = await (0, resolve_doc_id_1.lookupDocId)(apiUrl, creds.token, docRef);
+    if (!docId) {
+        console.error(`Error: Document not found: ${docRef}`);
+        return 1;
+    }
+    let members;
+    try {
+        members = await (0, resolve_member_1.fetchMembers)(apiUrl, creds.token);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        return 1;
+    }
+    const result = (0, resolve_member_1.resolveMember)(members, memberRef, creds.email);
+    if (result.kind === 'not_found') {
+        console.error(`Error: no member matches "${result.query}".`);
+        return 1;
+    }
+    if (result.kind === 'ambiguous') {
+        const list = result.candidates.map(c => c.email ?? c.displayName).join(', ');
+        console.error(`Error: multiple members match "${result.query}": ${list}`);
+        return 1;
+    }
+    // The DELETE endpoint takes a share-row id, not a memberId. Fetch the
+    // current shares to find the row for this member.
+    const sharesUrl = `${(0, api_1.trimTrailingSlash)(apiUrl)}/api/documents/${docId}/shares`;
+    const listRes = await fetch(sharesUrl, {
+        headers: { Authorization: `Bearer ${creds.token}` },
+    });
+    if (!listRes.ok) {
+        const text = await listRes.text();
+        console.error(`Error: ${listRes.status} ${listRes.statusText}: ${text}`);
+        return 1;
+    }
+    const { shares } = (await listRes.json());
+    const row = shares.find(s => s.member.id === result.member.memberId);
+    if (!row) {
+        console.log(`Not shared with ${result.member.displayName}`);
+        return;
+    }
+    const delUrl = `${(0, api_1.trimTrailingSlash)(apiUrl)}/api/documents/${docId}/shares/${row.id}`;
+    const delRes = await fetch(delUrl, {
+        method: 'DELETE',
+        headers: { Authorization: `Bearer ${creds.token}` },
+    });
+    if (!delRes.ok) {
+        const text = await delRes.text();
+        console.error(`Error: ${delRes.status} ${delRes.statusText}: ${text}`);
+        return 1;
+    }
+    console.log(`Unshared ${docId} ↔ ${result.member.displayName}`);
+}

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

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatUpdatedDocLine = formatUpdatedDocLine;
+exports.docUpdate = docUpdate;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const doc_input_1 = require("../lib/doc-input");
+const doc_create_1 = require("./doc-create");
+const resolve_doc_id_1 = require("../lib/resolve-doc-id");
+const tag_resolver_1 = require("../lib/tag-resolver");
+function formatUpdatedDocLine(doc) {
+    const escaped = doc.title.replace(/"/g, '\\"');
+    const head = `Updated ${doc.id} "${escaped}"  ${doc.url}`;
+    if (doc.tags && doc.tags.length > 0) {
+        return `${head}\nTags: ${doc.tags.join(', ')}`;
+    }
+    return head;
+}
+async function docUpdate(reference, opts) {
+    if (!reference) {
+        console.error('Error: missing <doc>. Usage: lumo doc update <doc> [flags]');
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    // CLI-side mutex check: --tag/--tag-id (bulk replace) vs --add-tag/--add-tag-id/--remove-tag/--remove-tag-id (incremental)
+    const hasBulk = (opts.tag && opts.tag.length > 0) || (opts.tagId && opts.tagId.length > 0);
+    const hasIncremental = (opts.addTag && opts.addTag.length > 0) ||
+        (opts.addTagId && opts.addTagId.length > 0) ||
+        (opts.removeTag && opts.removeTag.length > 0) ||
+        (opts.removeTagId && opts.removeTagId.length > 0);
+    if (hasBulk && hasIncremental) {
+        console.error('Error: --tag/--tag-id are mutually exclusive with --add-tag/--add-tag-id/--remove-tag/--remove-tag-id');
+        return 1;
+    }
+    const id = await (0, resolve_doc_id_1.lookupDocId)(apiUrl, creds.token, reference);
+    if (!id) {
+        console.error(`Error: Document not found: ${reference}`);
+        return 1;
+    }
+    const body = {};
+    if (opts.title !== undefined) {
+        if (opts.title.trim().length === 0) {
+            console.error('Error: --title cannot be empty');
+            return 1;
+        }
+        body.title = opts.title.trim();
+    }
+    if (opts.scope !== undefined) {
+        const v = (0, doc_create_1.normalizeScope)(opts.scope);
+        if (!v) {
+            console.error(`Error: invalid scope "${opts.scope}". Allowed: personal, workspace`);
+            return 1;
+        }
+        body.visibility = v;
+    }
+    if (opts.project !== undefined) {
+        body.projectRef = opts.project === '' ? null : opts.project;
+    }
+    const content = await (0, doc_input_1.resolveDocContent)({
+        content: opts.content,
+        file: opts.file,
+        stdinIsTTY: Boolean(process.stdin.isTTY),
+        readStdin: doc_input_1.readStdinToString,
+        readFile: doc_input_1.readFileUtf8,
+    });
+    if (content.kind === 'error') {
+        console.error(`Error: ${content.message}`);
+        return 1;
+    }
+    if (content.kind === 'ok')
+        body.contentMarkdown = content.markdown;
+    // Resolve tag refs into ids
+    const deps = { apiUrl, token: creds.token };
+    let tagIds;
+    let addTagIds;
+    let removeTagIds;
+    try {
+        if (hasBulk) {
+            tagIds = await (0, tag_resolver_1.resolveTagRefs)({ names: opts.tag ?? [], ids: opts.tagId ?? [] }, deps);
+        }
+        else if (hasIncremental) {
+            if ((opts.addTag && opts.addTag.length > 0) ||
+                (opts.addTagId && opts.addTagId.length > 0)) {
+                addTagIds = await (0, tag_resolver_1.resolveTagRefs)({ names: opts.addTag ?? [], ids: opts.addTagId ?? [] }, deps);
+            }
+            if ((opts.removeTag && opts.removeTag.length > 0) ||
+                (opts.removeTagId && opts.removeTagId.length > 0)) {
+                // NOTE: --remove-tag <unknown-name> creates the Tag via find-or-create, then
+                // the detach is a no-op. Net effect: orphan Tag row. Acceptable v1 trade-off.
+                removeTagIds = await (0, tag_resolver_1.resolveTagRefs)({ names: opts.removeTag ?? [], ids: opts.removeTagId ?? [] }, deps);
+            }
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        return 1;
+    }
+    if (tagIds !== undefined)
+        body.tagIds = tagIds;
+    if (addTagIds !== undefined)
+        body.addTagIds = addTagIds;
+    if (removeTagIds !== undefined)
+        body.removeTagIds = removeTagIds;
+    if (Object.keys(body).length === 0) {
+        console.error('Error: no fields to update — provide at least one flag');
+        return 1;
+    }
+    const url = `${(0, api_1.trimTrailingSlash)(apiUrl)}/api/documents/${id}`;
+    const res = await fetch(url, {
+        method: 'PATCH',
+        headers: {
+            Authorization: `Bearer ${creds.token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        console.error(`Error: ${res.status} ${res.statusText}: ${text}`);
+        return 1;
+    }
+    const { document } = (await res.json());
+    const docUrlStr = `${(0, api_1.trimTrailingSlash)(apiUrl)}/workspace/${creds.workspaceSlug ?? 'lumo'}/documents/${document.slug}`;
+    // Read tag names off the response (present when tags were changed)
+    const responseTagNames = tagIds !== undefined ||
+        addTagIds !== undefined ||
+        removeTagIds !== undefined
+        ? (document.docTags ?? []).map(t => t.name)
+        : undefined;
+    const lineDoc = {
+        id: document.id,
+        title: document.title,
+        url: docUrlStr,
+    };
+    if (responseTagNames !== undefined)
+        lineDoc.tags = responseTagNames;
+    console.log(formatUpdatedDocLine(lineDoc));
+}

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hookCommand = hookCommand;
+const hook_runner_1 = require("../lib/hook-runner");
+const hook_log_1 = require("../lib/hook-log");
+/**
+ * Dispatcher for the `lumo hook <path>` subcommands.
+ *
+ * Always exits 0. Failures are logged to `~/.lumo/hook.log` — never to
+ * stderr. The inner try/catch is a belt-and-suspenders guard so that even
+ * if `runHook` someday throws (it currently never does), Claude Code is
+ * not disrupted.
+ */
+async function hookCommand(path) {
+    try {
+        await (0, hook_runner_1.runHook)(path);
+    }
+    catch (err) {
+        (0, hook_log_1.logHookError)(`[${path}] dispatcher`, err);
+    }
+}

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

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCreatePayload = buildCreatePayload;
+exports.formatCreatedMilestoneLine = formatCreatedMilestoneLine;
+exports.milestoneCreate = milestoneCreate;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_1 = require("../lib/resolve");
+function buildCreatePayload(name, opts) {
+    const payload = { name };
+    if (opts.description !== undefined)
+        payload.description = opts.description;
+    if (opts.start !== undefined)
+        payload.startDate = opts.start;
+    if (opts.target !== undefined)
+        payload.targetDate = opts.target;
+    return payload;
+}
+function formatCreatedMilestoneLine(milestone) {
+    return `Created milestone "${milestone.name}"  ${milestone.id}`;
+}
+async function milestoneCreate(name, opts) {
+    if (!name || !name.trim()) {
+        console.error('Error: milestone name is required');
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    let projectId;
+    try {
+        projectId = await (0, resolve_1.resolveProjectId)(base, creds.token, opts.project);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    const payload = buildCreatePayload(name.trim(), opts);
+    let res;
+    try {
+        res = await fetch(`${base}/api/projects/${projectId}/milestones`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${creds.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(payload),
+        });
+    }
+    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 serverMsg = null;
+        try {
+            const errBody = (await res.json());
+            if (typeof errBody.error === 'string')
+                serverMsg = errBody.error;
+        }
+        catch {
+            // Body wasn't JSON; fall through to status-only message
+        }
+        if (serverMsg) {
+            console.error(`Error: ${serverMsg}`);
+        }
+        else {
+            console.error(`Error: milestone create failed (HTTP ${res.status})`);
+        }
+        return 1;
+    }
+    const { milestone } = (await res.json());
+    process.stdout.write(formatCreatedMilestoneLine(milestone) + '\n');
+}

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

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDeleteRefusal = formatDeleteRefusal;
+exports.milestoneDelete = milestoneDelete;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_1 = require("../lib/resolve");
+function formatDeleteRefusal(name, taskCount) {
+    const head = `Refusing to delete milestone "${name}" without --yes.`;
+    const tail = `Re-run with --yes to confirm.`;
+    if (taskCount === 0)
+        return `${head}\n${tail}`;
+    return `${head}\n${taskCount} tasks under it will keep their data; only milestoneId is cleared.\n${tail}`;
+}
+function totalTasks(counts) {
+    return counts.TODO + counts.IN_PROGRESS + counts.IN_REVIEW + counts.DONE;
+}
+async function milestoneDelete(identifier, opts) {
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    let milestoneId;
+    let resolvedName;
+    try {
+        const resolved = await (0, resolve_1.resolveMilestoneId)(base, creds.token, identifier, opts.project);
+        milestoneId = resolved.id;
+        resolvedName = resolved.name;
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    // Always fetch the milestone first — we need name + taskCounts for the
+    // refusal message, and the same data confirms the milestone exists.
+    let showRes;
+    try {
+        showRes = await fetch(`${base}/api/milestones/${milestoneId}`, {
+            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 (showRes.status === 401) {
+        console.error('Error: API key invalid or revoked. Run `lumo auth login`.');
+        return 1;
+    }
+    if (!showRes.ok) {
+        console.error(`Error: milestone fetch failed (HTTP ${showRes.status})`);
+        return 1;
+    }
+    const { milestone } = (await showRes.json());
+    const name = resolvedName || milestone.name;
+    const total = totalTasks(milestone.taskCounts);
+    if (!opts.yes) {
+        console.error(formatDeleteRefusal(name, total));
+        return 1;
+    }
+    let res;
+    try {
+        res = await fetch(`${base}/api/milestones/${milestoneId}`, {
+            method: 'DELETE',
+            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 delete failed (HTTP ${res.status})`;
+        try {
+            const errBody = (await res.json());
+            if (errBody.error)
+                errMsg = errBody.error;
+        }
+        catch {
+            // body wasn't JSON
+        }
+        console.error(`Error: ${errMsg}`);
+        return 1;
+    }
+    process.stdout.write(`Deleted milestone "${name}"\n`);
+}