@lumoai/cli 1.0.0

package/dist/cli/src/commands/sprint-close.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCloseDecisions = buildCloseDecisions;
+exports.formatUnfinishedRefusal = formatUnfinishedRefusal;
+exports.sprintClose = sprintClose;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_1 = require("../lib/resolve");
+const format_1 = require("../lib/format");
+/**
+ * Build the decisions map for POST /api/sprints/<id>/close.
+ * Only non-DONE tasks get a decision entry; DONE tasks are excluded entirely.
+ */
+function buildCloseDecisions(tasks, mode) {
+    const decision = mode === 'move' ? 'moveToNext' : 'backToBacklog';
+    const result = {};
+    for (const task of tasks) {
+        if (task.status !== 'DONE') {
+            result[task.id] = decision;
+        }
+    }
+    return result;
+}
+/**
+ * Format a refusal message when unfinished tasks exist and no mode flag was given.
+ * Filters out DONE tasks before counting and rendering the list.
+ */
+function formatUnfinishedRefusal(number, name, tasks) {
+    const unfinished = tasks.filter(t => t.status !== 'DONE');
+    const lines = [
+        `Refusing to close sprint #${number} "${name}": ${unfinished.length} task(s) not DONE.`,
+        '',
+        (0, format_1.formatTaskListTable)(unfinished),
+        '',
+        'To resolve, pass one of:',
+        '  --move-all --yes     move all unfinished tasks to the next sprint',
+        '  --backlog-all --yes  return all unfinished tasks to the backlog',
+        '  Web UI               decide task-by-task at lumo.so',
+    ];
+    return lines.join('\n');
+}
+async function sprintClose(identifier, opts) {
+    // CLI-side mutex: both flags together is an error.
+    if (opts.moveAll && opts.backlogAll) {
+        console.error('Error: --move-all and --backlog-all are mutually exclusive. Pick one.');
+        return 1;
+    }
+    // CLI-side: mode flags require --yes.
+    if ((opts.moveAll || opts.backlogAll) && !opts.yes) {
+        const flag = opts.moveAll ? '--move-all' : '--backlog-all';
+        console.error(`Error: ${flag} requires --yes to confirm. Re-run with --yes.`);
+        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);
+    const workspaceSlug = creds.workspaceSlug ?? '';
+    let resolved;
+    try {
+        resolved = await (0, resolve_1.resolveSprintId)(base, creds.token, identifier, opts.team, workspaceSlug);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    // Fetch sprint + tasks in parallel so we can validate unfinished tasks.
+    let sprintRes;
+    let tasksRes;
+    try {
+        ;
+        [sprintRes, tasksRes] = await Promise.all([
+            fetch(`${base}/api/sprints/${resolved.id}`, {
+                headers: { Authorization: `Bearer ${creds.token}` },
+            }),
+            fetch(`${base}/api/sprints/${resolved.id}/tasks`, {
+                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 (sprintRes.status === 401 || tasksRes.status === 401) {
+        console.error('Error: API key invalid or revoked. Run `lumo auth login`.');
+        return 1;
+    }
+    if (!sprintRes.ok) {
+        console.error(`Error: sprint fetch failed (HTTP ${sprintRes.status})`);
+        return 1;
+    }
+    if (!tasksRes.ok) {
+        console.error(`Error: sprint tasks fetch failed (HTTP ${tasksRes.status})`);
+        return 1;
+    }
+    const { sprint } = (await sprintRes.json());
+    const { tasks } = (await tasksRes.json());
+    const unfinished = tasks.filter(t => t.status !== 'DONE');
+    // No mode flag: refuse if there are unfinished tasks.
+    if (!opts.moveAll && !opts.backlogAll) {
+        if (unfinished.length > 0) {
+            console.error(formatUnfinishedRefusal(sprint.number, sprint.name, tasks));
+            return 1;
+        }
+        // All tasks done — post with empty decisions.
+    }
+    // Build decisions map.
+    const decisions = opts.moveAll || opts.backlogAll
+        ? buildCloseDecisions(tasks, opts.moveAll ? 'move' : 'backlog')
+        : {};
+    let res;
+    try {
+        res = await fetch(`${base}/api/sprints/${resolved.id}/close`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${creds.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ decisions }),
+        });
+    }
+    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 = `sprint close 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(`Closed sprint #${sprint.number} "${sprint.name}"\n`);
+}

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

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCreateSprintPayload = buildCreateSprintPayload;
+exports.formatCreatedSprintLine = formatCreatedSprintLine;
+exports.sprintCreate = sprintCreate;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_1 = require("../lib/resolve");
+function buildCreateSprintPayload(opts) {
+    // start/end are required by the server schema; caller validates presence.
+    const payload = {
+        startDate: opts.start,
+        endDate: opts.end,
+    };
+    if (opts.name && opts.name.length > 0)
+        payload.name = opts.name;
+    return payload;
+}
+function formatCreatedSprintLine(sprint) {
+    return `Created sprint #${sprint.number} "${sprint.name}"  ${sprint.id}`;
+}
+async function sprintCreate(opts) {
+    if (!opts.start || !opts.end) {
+        console.error('Error: --start and --end are required (YYYY-MM-DD)');
+        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 teamId;
+    try {
+        const team = await (0, resolve_1.resolveTeamId)(base, creds.token, opts.team);
+        teamId = team.id;
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    const payload = buildCreateSprintPayload(opts);
+    let res;
+    try {
+        res = await fetch(`${base}/api/teams/${teamId}/sprints`, {
+            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 {
+            // ignore
+        }
+        console.error(`Error: ${serverMsg ?? `sprint create failed (HTTP ${res.status})`}`);
+        return 1;
+    }
+    const sprint = (await res.json());
+    process.stdout.write(formatCreatedSprintLine(sprint) + '\n');
+}

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

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDeleteRefusal = formatDeleteRefusal;
+exports.sprintDelete = sprintDelete;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_1 = require("../lib/resolve");
+function formatDeleteRefusal(number, name, taskCount) {
+    const head = `Refusing to delete sprint #${number} "${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 sprintId is cleared.\n${tail}`;
+}
+async function sprintDelete(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);
+    const workspaceSlug = creds.workspaceSlug ?? '';
+    let resolved;
+    try {
+        resolved = await (0, resolve_1.resolveSprintId)(base, creds.token, identifier, opts.team, workspaceSlug);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    // Fetch sprint + progress for the refusal message (and to confirm it exists).
+    let showRes;
+    try {
+        showRes = await fetch(`${base}/api/sprints/${resolved.id}`, {
+            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: sprint fetch failed (HTTP ${showRes.status})`);
+        return 1;
+    }
+    const { sprint, progress } = (await showRes.json());
+    if (!opts.yes) {
+        console.error(formatDeleteRefusal(sprint.number, sprint.name, progress.total));
+        return 1;
+    }
+    let res;
+    try {
+        res = await fetch(`${base}/api/sprints/${resolved.id}`, {
+            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 = `sprint 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 sprint #${sprint.number} "${sprint.name}"\n`);
+}

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

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSprintList = formatSprintList;
+exports.sprintList = sprintList;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_1 = require("../lib/resolve");
+const VALID_STATUSES = ['DRAFT', 'ACTIVE', 'CLOSED'];
+function formatDate(iso) {
+    if (!iso)
+        return '-';
+    return iso.slice(0, 10);
+}
+/**
+ * Render sprints as fixed-width rows (server already sorts by number desc):
+ *   <STATUS>  #<number>  <start>..<end>  <name>
+ */
+function formatSprintList(rows) {
+    if (rows.length === 0)
+        return 'No sprints.';
+    const statusW = Math.max(...rows.map(r => r.status.length));
+    const numW = Math.max(...rows.map(r => String(r.number).length));
+    return rows
+        .map(r => {
+        const statusCol = r.status.padEnd(statusW);
+        const numCol = `#${r.number}`.padEnd(numW + 1); // +1 for the '#'
+        const dateRange = `${formatDate(r.startDate)}..${formatDate(r.endDate)}`;
+        return `${statusCol}  ${numCol}  ${dateRange}  ${r.name}`;
+    })
+        .join('\n');
+}
+async function sprintList(options) {
+    // Validate --status if provided
+    let normalizedStatus;
+    if (options.status !== undefined) {
+        normalizedStatus = options.status.toUpperCase();
+        if (!VALID_STATUSES.includes(normalizedStatus)) {
+            console.error(`Error: invalid --status "${options.status}". Valid values: draft | active | closed`);
+            return 1;
+        }
+    }
+    const limit = options.limit !== undefined ? parseInt(options.limit, 10) : undefined;
+    if (limit !== undefined && (Number.isNaN(limit) || limit < 1)) {
+        console.error(`Error: invalid --limit "${options.limit}" (expected a positive integer)`);
+        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 teamId;
+    try {
+        const team = await (0, resolve_1.resolveTeamId)(base, creds.token, options.team);
+        teamId = team.id;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`Error: ${msg}`);
+        return 1;
+    }
+    const params = new URLSearchParams();
+    if (normalizedStatus)
+        params.set('status', normalizedStatus);
+    if (limit !== undefined)
+        params.set('limit', String(limit));
+    const query = params.toString();
+    const url = `${base}/api/teams/${teamId}/sprints${query ? `?${query}` : ''}`;
+    const res = await fetch(url, {
+        headers: { Authorization: `Bearer ${creds.token}` },
+    });
+    if (res.status === 401) {
+        console.error('Error: API key invalid or revoked. Run `lumo auth login`.');
+        return 1;
+    }
+    if (!res.ok) {
+        console.error(`Error: sprint list failed (HTTP ${res.status})`);
+        return 1;
+    }
+    const data = (await res.json());
+    process.stdout.write(formatSprintList(data.sprints) + '\n');
+}

package/dist/cli/src/commands/sprint-remove.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sprintRemove = sprintRemove;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_1 = require("../lib/resolve");
+async function sprintRemove(identifier, taskIdentifier, 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);
+    const workspaceSlug = creds.workspaceSlug ?? '';
+    let resolved;
+    try {
+        resolved = await (0, resolve_1.resolveSprintId)(base, creds.token, identifier, opts.team, workspaceSlug);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    const tr = await fetch(`${base}/api/tasks/by-identifier/${encodeURIComponent(taskIdentifier)}`, { headers: { Authorization: `Bearer ${creds.token}` } });
+    if (!tr.ok) {
+        console.error(`Error: task ${taskIdentifier} not found (HTTP ${tr.status})`);
+        return 1;
+    }
+    const { task } = (await tr.json());
+    let res;
+    try {
+        res = await fetch(`${base}/api/sprints/${resolved.id}/tasks/${task.id}`, {
+            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.ok && res.status !== 204) {
+        let errMsg = `sprint remove failed (HTTP ${res.status})`;
+        try {
+            const errBody = (await res.json());
+            if (errBody.error)
+                errMsg = errBody.error;
+        }
+        catch {
+            // ignore
+        }
+        console.error(`Error: ${errMsg}`);
+        return 1;
+    }
+    process.stdout.write(`Removed ${taskIdentifier} from sprint #${resolved.number}\n`);
+}

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

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSprintShow = formatSprintShow;
+exports.sprintShow = sprintShow;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_1 = require("../lib/resolve");
+const format_1 = require("../lib/format");
+function fmtDate(iso) {
+    return iso ? iso.slice(0, 10) : '-';
+}
+function formatSprintShow(s, progress, tasks) {
+    const lines = [
+        `Sprint:    #${s.number} ${s.name}`,
+        `Status:    ${s.status}`,
+        `Team:      ${s.team.name}`,
+        `Start:     ${fmtDate(s.startDate)}`,
+        `End:       ${fmtDate(s.endDate)}`,
+        `Started:   ${fmtDate(s.startedAt)}`,
+        `Closed:    ${fmtDate(s.closedAt)}`,
+        ``,
+        `Progress:  ${progress.done} / ${progress.total}`,
+    ];
+    if (tasks.length > 0) {
+        lines.push('', (0, format_1.formatTaskListTable)(tasks));
+    }
+    return lines.join('\n');
+}
+async function sprintShow(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 sprintId;
+    try {
+        const resolved = await (0, resolve_1.resolveSprintId)(base, creds.token, identifier, opts.team, creds.workspaceSlug);
+        sprintId = resolved.id;
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    // Fetch sprint details and tasks in parallel.
+    let sprintRes;
+    let tasksRes;
+    try {
+        ;
+        [sprintRes, tasksRes] = await Promise.all([
+            fetch(`${base}/api/sprints/${sprintId}`, {
+                headers: { Authorization: `Bearer ${creds.token}` },
+            }),
+            fetch(`${base}/api/sprints/${sprintId}/tasks`, {
+                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 (sprintRes.status === 401 || tasksRes.status === 401) {
+        console.error('Error: API key invalid or revoked. Run `lumo auth login`.');
+        return 1;
+    }
+    if (!sprintRes.ok) {
+        console.error(`Error: sprint show failed (HTTP ${sprintRes.status})`);
+        return 1;
+    }
+    if (!tasksRes.ok) {
+        console.error(`Error: sprint tasks failed (HTTP ${tasksRes.status})`);
+        return 1;
+    }
+    const { sprint, progress } = (await sprintRes.json());
+    const { tasks } = (await tasksRes.json());
+    process.stdout.write(formatSprintShow(sprint, progress, tasks) + '\n');
+}

package/dist/cli/src/commands/sprint-start.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sprintStart = sprintStart;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const resolve_1 = require("../lib/resolve");
+async function sprintStart(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);
+    const workspaceSlug = creds.workspaceSlug ?? '';
+    let resolved;
+    try {
+        resolved = await (0, resolve_1.resolveSprintId)(base, creds.token, identifier, opts.team, workspaceSlug);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    // Fill in number/name if identifier was a UUID.
+    let displayNumber = resolved.number;
+    let displayName = resolved.name;
+    if (!displayName) {
+        const r = await fetch(`${base}/api/sprints/${resolved.id}`, {
+            headers: { Authorization: `Bearer ${creds.token}` },
+        });
+        if (r.ok) {
+            const { sprint } = (await r.json());
+            displayNumber = sprint.number;
+            displayName = sprint.name;
+        }
+    }
+    let res;
+    try {
+        res = await fetch(`${base}/api/sprints/${resolved.id}/start`, {
+            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 = `sprint start failed (HTTP ${res.status})`;
+        try {
+            const errBody = (await res.json());
+            if (errBody.error)
+                errMsg = errBody.error;
+        }
+        catch {
+            // ignore
+        }
+        console.error(`Error: ${errMsg}`);
+        return 1;
+    }
+    process.stdout.write(`Started sprint #${displayNumber} "${displayName}"\n`);
+}