@bli-cockpit/cli 0.2.236 → 0.2.237

package/dist/commands/cal-overlay.js

@@ -0,0 +1,63 @@
+import { askAgentDoor, emitAgentDoor, failAgentDoor } from "./agent-door.js";
+import { readPipedText, isInteractiveStdin, writeLine } from "./cli-io.js";
+export async function runCalOverlay(command, door) {
+    if (command.action === "calendar-change") {
+        let body = command.color ? { color_override: command.color === "provider" ? null : command.color } : {};
+        if (!command.color && !isInteractiveStdin(door.io)) {
+            try {
+                const parsed = JSON.parse(await readPipedText(door.io.stdin, { maxChars: 4000, overflowMessage: "Preferences are too large." }));
+                if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+                    throw new Error("invalid_preferences");
+                body = parsed;
+            }
+            catch {
+                return failAgentDoor(door, "[cal cli]", "invalid_body", "Pipe JSON preferences or use --color '#4285f4' (provider resets).");
+            }
+        }
+        if (!Object.keys(body).length)
+            return failAgentDoor(door, "[cal cli]", "invalid_body", "Use --color '#4285f4', --color provider, or pipe JSON with color_override/selected.");
+        const answer = await askAgentDoor(door, { method: "PATCH", path: `/api/cal/calendars/${encodeURIComponent(command.subjectId)}`, body, label: "cal calendar-change", timeoutMs: 30000 });
+        if (!answer.ok)
+            return failAgentDoor(door, "[cal cli]", answer.reason, answer.detail);
+        if (door.json)
+            return emitAgentDoor(door, answer.body);
+        writeLine(door.io.stdout, "Calendar preferences saved. Provider sync preserves your colour override.");
+        return 0;
+    }
+    const query = new URLSearchParams({ tz: command.timeZone ?? Intl.DateTimeFormat().resolvedOptions().timeZone });
+    if (command.from)
+        query.set("from", command.from);
+    if (command.to)
+        query.set("to", command.to);
+    if (command.offset !== undefined)
+        query.set("offset", String(command.offset));
+    if (command.includeDeselected)
+        query.set("all", "true");
+    const answer = await askAgentDoor(door, { method: "GET", path: `/api/cal/conflicts?${query}`, label: "cal conflicts", timeoutMs: 30000 });
+    if (!answer.ok)
+        return failAgentDoor(door, "[cal cli]", answer.reason, answer.detail);
+    if (door.json)
+        return emitAgentDoor(door, answer.body);
+    const result = answer.body;
+    const zone = result.window?.time_zone ?? command.timeZone ?? Intl.DateTimeFormat().resolvedOptions().timeZone;
+    writeLine(door.io.stdout, `${result.groups.length} double-bookings · own calendars`);
+    for (const group of result.groups) {
+        const parts = new Intl.DateTimeFormat("en-GB", { timeZone: zone, weekday: "short", day: "numeric", month: "short", hour: "2-digit", minute: "2-digit", hourCycle: "h23" }).formatToParts(new Date(group.from));
+        const part = (name) => parts.find(item => item.type === name)?.value;
+        writeLine(door.io.stdout, `${part("weekday")} ${part("day")} ${part("month")} ${part("hour")}:${part("minute")}: ${group.meetings.map(meeting => `${meeting.event.title} · ${meeting.event.calendar_name}`).join(" / ")}`);
+    }
+    const checked = result.coverage.calendars.filter(calendar => calendar.checked);
+    const oldest = Math.min(...checked.map(calendar => calendar.lastSyncAt ? Date.parse(calendar.lastSyncAt) : NaN));
+    const minutes = Math.max(0, Math.floor((Date.now() - oldest) / 60000));
+    const age = !checked.length ? "none checked" : !Number.isFinite(oldest) ? "sync age unknown" : minutes < 1 ? "just now" : minutes < 60 ? `${minutes} min ago` : minutes < 1440 ? `${Math.floor(minutes / 60)} h ago` : `${Math.floor(minutes / 1440)} days ago`;
+    writeLine(door.io.stdout, `Checked ${checked.length} calendar${checked.length === 1 ? "" : "s"} · ${age}`);
+    for (const calendar of result.coverage.calendars.filter(calendar => calendar.hidden || !calendar.checked)) {
+        writeLine(door.io.stdout, `${calendar.name}: ${calendar.hidden ? "hidden; " : ""}${calendar.checked ? "included by request" : `not checked (${(calendar.excludedReason ?? "unavailable").replaceAll("_", " ")})`}`);
+    }
+    for (const account of result.coverage.accounts ?? [])
+        if (!account.calendars)
+            writeLine(door.io.stdout, `${account.label}: no discovered calendars (${account.status.replaceAll("_", " ")})`);
+    if (result.coverage.incomplete || result.coverage.truncated || result.coverage.notes.length)
+        writeLine(door.io.stdout, "Incomplete window. This check cannot confirm free time.");
+    return 0;
+}

package/dist/commands/cal.js

@@ -22,6 +22,7 @@
  */
 import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor, } from "./agent-door.js";
 import { runCalAddIcal, runCalDetach, runCalShare, runCalSync } from "./cal-calendars-write.js";
+import { runCalOverlay } from "./cal-overlay.js";
 import { runCalDelete } from "./cal-delete.js";
 import { runCalSyncStatus } from "./cal-sync-status.js";
 import { writeLine } from "./cli-io.js";
@@ -32,6 +33,9 @@ const WRITE_DEADLINE_MS = 60_000;
 export async function runCal(command, io) {
     const door = await openAgentDoor("cal", command, io);
     switch (command.action) {
+        case "conflicts":
+        case "calendar-change":
+            return runCalOverlay(command, door);
         case "today":
         case "week":
         case "next":

package/dist/commands/doctor-usage-telemetry.js

@@ -12,7 +12,8 @@ export function mergeClaudeUsageSettings(raw, origin, token, off) {
         throw new Error("config_unreadable");
     root.env = { ...root.env, CLAUDE_CODE_ENABLE_TELEMETRY: off ? "0" : "1",
         OTEL_METRICS_EXPORTER: off ? "none" : "otlp", OTEL_LOGS_EXPORTER: off ? "none" : "otlp",
-        OTEL_EXPORTER_OTLP_PROTOCOL: "http/json", OTEL_EXPORTER_OTLP_ENDPOINT: `${new URL(origin).origin}/api/otel`,
+        OTEL_LOGS_EXPORT_INTERVAL: "60000", OTEL_METRIC_EXPORT_INTERVAL: "300000",
+        OTEL_EXPORTER_OTLP_COMPRESSION: "gzip", OTEL_EXPORTER_OTLP_PROTOCOL: "http/json", OTEL_EXPORTER_OTLP_ENDPOINT: `${new URL(origin).origin}/api/otel`,
         OTEL_EXPORTER_OTLP_HEADERS: `Authorization=Bearer ${token}` };
     // OTEL_LOG_USER_PROMPTS is never added or changed. Existing person keys survive.
     return `${JSON.stringify(root, null, 2)}\n`;

package/dist/commands/local-args-tower-cal.js

@@ -20,6 +20,7 @@
  */
 import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs, } from "./local-arg-values.js";
 const CAL_ACTIONS = new Set([
+    "conflicts", "calendar-change",
     "today",
     "week",
     "next",
@@ -35,7 +36,7 @@ const CAL_ACTIONS = new Set([
     "delete",
 ]);
 /** Every verb that names ONE thing first — a calendar id, or (delete) an event id. */
-const CAL_ACTIONS_NEEDING_A_SUBJECT = new Set(["sync", "detach", "share", "delete", "change", "cancel"]);
+const CAL_ACTIONS_NEEDING_A_SUBJECT = new Set(["calendar-change", "sync", "detach", "share", "delete", "change", "cancel"]);
 /** `sync-status [<calendar id>]` — every calendar, or one's. Ticket 10730. */
 const CAL_ACTIONS_WITH_OPTIONAL_SUBJECT = new Set(["sync-status"]);
 export function parseCalArgs(args) {
@@ -43,6 +44,7 @@ export function parseCalArgs(args) {
         allowedFlags: [
             "--home",
             "--dashboard-url",
+            "--color",
             "--calendar",
             "--account",
             "--tz",
@@ -69,6 +71,7 @@ export function parseCalArgs(args) {
         valueFlags: [
             "--home",
             "--dashboard-url",
+            "--color",
             "--calendar",
             "--account",
             "--tz",
@@ -100,7 +103,7 @@ function readCalAction(values) {
     const first = values.positionals[0];
     const action = (first === undefined ? "today" : first);
     if (!CAL_ACTIONS.has(action)) {
-        throw new Error(`Unknown cal command: ${first}. Try today, week, next, find, calendars, add-ical, create, share, detach, sync, sync-status, or delete.`);
+        throw new Error(`Unknown cal command: ${first}. Try today, week, conflicts, calendar-change, next, find, calendars, add-ical, create, share, detach, sync, sync-status, or delete.`);
     }
     return { action, rest: values.positionals.slice(first === undefined ? 0 : 1) };
 }
@@ -170,6 +173,7 @@ function readCalOffset(values) {
 function buildCalCommand(values, action, subject, query, title, startsAt, endsAt, offset, limit) {
     return {
         kind: "cal",
+        color: optionalNonEmpty(values.flags.get("--color")),
         action,
         homeDir: optionalNonEmpty(values.flags.get("--home")),
         dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),

package/dist/commands/local-args-tower-docs-msg.js

@@ -243,146 +243,4 @@ function buildDocsCommand(values, action, docRef, docRefs, visibility, clearPare
         json: values.booleans.has("--json"),
     };
 }
-const MSG_ACTIONS = new Set(["channels", "read", "send", "thread", "create", "dm"]);
-const MSG_ACTIONS_NEEDING_A_CHANNEL = new Set(["read", "send"]);
-/**
- * `--members a@x.test,b@y.test` — addresses only, split on commas, never
- * fuzzy (BLI-3749). The door resolves each one exactly, so a typo comes back
- * as `person_not_found` naming the address rather than as a stranger added
- * to a private channel.
- */
-function parseMemberEmails(raw) {
-    const value = optionalNonEmpty(raw);
-    if (!value)
-        return undefined;
-    const emails = value
-        .split(",")
-        .map((part) => part.trim())
-        .filter((part) => part !== "");
-    if (emails.length === 0)
-        throw new Error("msg create --members needs at least one email address.");
-    const notAnAddress = emails.find((email) => !email.includes("@"));
-    if (notAnAddress) {
-        throw new Error(`msg create --members takes email addresses; "${notAnAddress}" is not one.`);
-    }
-    return emails;
-}
-export function parseMsgArgs(args) {
-    const values = parseNamedArgs(args, {
-        allowedFlags: [
-            "--home",
-            "--dashboard-url",
-            "--channel",
-            "--thread",
-            "--limit",
-            "--private",
-            "--members",
-            "--description",
-            "--json",
-        ],
-        valueFlags: ["--home", "--dashboard-url", "--channel", "--thread", "--limit", "--members", "--description"],
-    });
-    const { action, rest } = parseMsgAction(values.positionals);
-    const { channelName, dmEmail } = parseMsgCreateTarget(action, rest);
-    const { isPrivate, memberEmails, description } = parseMsgCreateFlags(action, values);
-    const { channelRef, threadId, limit } = parseMsgReadTarget(action, rest, values);
-    return buildMsgCommand(values, action, channelRef, channelName, dmEmail, memberEmails, description, isPrivate, threadId, limit);
-}
-function parseMsgAction(positionals) {
-    const first = positionals[0];
-    const action = (first === undefined ? "channels" : first);
-    if (!MSG_ACTIONS.has(action)) {
-        throw new Error(`Unknown msg command: ${first}. Try channels, read, send, thread, create, or dm.`);
-    }
-    return { action, rest: positionals.slice(first === undefined ? 0 : 1) };
-}
-function parseMsgCreateTarget(action, rest) {
-    let channelName;
-    let dmEmail;
-    if (action === "create") {
-        channelName = optionalNonEmpty(rest[0]);
-        if (!channelName)
-            throw new Error("msg create needs a channel name, e.g. `cockpit msg create general`.");
-        if (rest.length > 1)
-            throw new Error(`msg create takes one channel name, not ${rest.length}.`);
-        // `#general` is how a person says it and how `read`/`send` accept it, so
-        // the leading # is dropped here rather than becoming part of the name.
-        if (channelName.startsWith("#"))
-            channelName = channelName.slice(1);
-        if (channelName === "")
-            throw new Error("msg create needs a channel name, e.g. `cockpit msg create general`.");
-    }
-    else if (action === "dm") {
-        dmEmail = optionalNonEmpty(rest[0]);
-        if (!dmEmail)
-            throw new Error("msg dm needs the person's email address, e.g. `cockpit msg dm ada@example.com`.");
-        if (rest.length > 1)
-            throw new Error(`msg dm takes one email address, not ${rest.length}.`);
-        if (!dmEmail.includes("@"))
-            throw new Error(`msg dm takes an email address; "${dmEmail}" is not one.`);
-    }
-    return { channelName, dmEmail };
-}
-function parseMsgCreateFlags(action, values) {
-    const isPrivate = values.booleans.has("--private");
-    if (isPrivate && action !== "create") {
-        throw new Error("--private belongs to `cockpit msg create`.");
-    }
-    const memberEmails = parseMemberEmails(values.flags.get("--members"));
-    if (memberEmails && action !== "create") {
-        throw new Error("--members belongs to `cockpit msg create`.");
-    }
-    const description = optionalNonEmpty(values.flags.get("--description"));
-    if (description && action !== "create") {
-        throw new Error("--description belongs to `cockpit msg create`.");
-    }
-    return { isPrivate, memberEmails, description };
-}
-function parseMsgReadTarget(action, rest, values) {
-    let channelRef;
-    if (MSG_ACTIONS_NEEDING_A_CHANNEL.has(action)) {
-        channelRef = optionalNonEmpty(rest[0]);
-        if (!channelRef)
-            throw new Error(`msg ${action} needs a channel id or name.`);
-        if (rest.length > 1)
-            throw new Error(`msg ${action} takes one channel, not ${rest.length}.`);
-    }
-    else if (action === "thread") {
-        // `thread <id> --channel <channel>` — the channel is a flag here because
-        // the positional names the THREAD, not the channel (`--channel` below).
-        if (rest.length > 1)
-            throw new Error(`msg thread takes one thread id, not ${rest.length}.`);
-    }
-    else if (action !== "create" && action !== "dm" && rest.length > 0) {
-        throw new Error(`msg ${action} does not take "${rest[0]}".`);
-    }
-    const threadFlag = optionalNonEmpty(values.flags.get("--thread"));
-    const threadId = action === "thread" ? optionalNonEmpty(rest[0]) : threadFlag;
-    if (action === "thread" && !threadId)
-        throw new Error("msg thread needs a thread id.");
-    const channelFlag = optionalNonEmpty(values.flags.get("--channel"));
-    if (action === "thread")
-        channelRef = channelFlag;
-    const limit = optionalPositiveInteger(values.flags.get("--limit"), "--limit");
-    if (limit !== undefined && action !== "read" && action !== "thread") {
-        throw new Error("--limit belongs to `cockpit msg read` or `cockpit msg thread`.");
-    }
-    return { channelRef, threadId, limit };
-}
-function buildMsgCommand(values, action, channelRef, channelName, dmEmail, memberEmails, description, isPrivate, threadId, limit) {
-    return {
-        kind: "msg",
-        action,
-        homeDir: optionalNonEmpty(values.flags.get("--home")),
-        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
-        ...(channelRef ? { channelRef } : {}),
-        ...(channelName ? { channelName } : {}),
-        ...(dmEmail ? { dmEmail } : {}),
-        ...(memberEmails ? { memberEmails } : {}),
-        ...(description ? { description } : {}),
-        isPrivate,
-        ...(threadId ? { threadId } : {}),
-        ...(limit === undefined ? {} : { limit }),
-        json: values.booleans.has("--json"),
-    };
-}
+export { parseMsgArgs } from "./local-args-tower-msg.js";

package/dist/commands/local-args-tower-msg.js

@@ -0,0 +1,149 @@
+import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+const MSG_ACTIONS = new Set(["channels", "read", "send", "thread", "create", "dm", "show"]);
+const MSG_ACTIONS_NEEDING_A_CHANNEL = new Set(["read", "send"]);
+/**
+ * `--members a@x.test,b@y.test` — addresses only, split on commas, never
+ * fuzzy (BLI-3749). The door resolves each one exactly, so a typo comes back
+ * as `person_not_found` naming the address rather than as a stranger added
+ * to a private channel.
+ */
+function parseMemberEmails(raw) {
+    const value = optionalNonEmpty(raw);
+    if (!value)
+        return undefined;
+    const emails = value
+        .split(",")
+        .map((part) => part.trim())
+        .filter((part) => part !== "");
+    if (emails.length === 0)
+        throw new Error("msg create --members needs at least one email address.");
+    const notAnAddress = emails.find((email) => !email.includes("@"));
+    if (notAnAddress) {
+        throw new Error(`msg create --members takes email addresses; "${notAnAddress}" is not one.`);
+    }
+    return emails;
+}
+export function parseMsgArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--dashboard-url",
+            "--channel",
+            "--thread",
+            "--limit",
+            "--before",
+            "--private",
+            "--members",
+            "--description",
+            "--json",
+        ],
+        valueFlags: ["--home", "--dashboard-url", "--channel", "--thread", "--limit", "--members", "--description", "--before"],
+    });
+    const { action, rest } = parseMsgAction(values.positionals);
+    if (values.flags.has("--before") && action !== "read" && action !== "thread") {
+        throw new Error("--before belongs to msg read or msg thread.");
+    }
+    const { channelName, dmEmail } = parseMsgCreateTarget(action, rest);
+    const { isPrivate, memberEmails, description } = parseMsgCreateFlags(action, values);
+    const { channelRef, threadId, limit } = parseMsgReadTarget(action, rest, values);
+    return buildMsgCommand(values, action, channelRef, channelName, dmEmail, memberEmails, description, isPrivate, threadId, limit);
+}
+function parseMsgAction(positionals) {
+    const first = positionals[0];
+    const action = (first === undefined ? "channels" : first);
+    if (!MSG_ACTIONS.has(action)) {
+        throw new Error(`Unknown msg command: ${first}. Try channels, read, send, thread, create, dm, or show.`);
+    }
+    return { action, rest: positionals.slice(first === undefined ? 0 : 1) };
+}
+function parseMsgCreateTarget(action, rest) {
+    let channelName;
+    let dmEmail;
+    if (action === "create") {
+        channelName = optionalNonEmpty(rest[0]);
+        if (!channelName)
+            throw new Error("msg create needs a channel name, e.g. `cockpit msg create general`.");
+        if (rest.length > 1)
+            throw new Error(`msg create takes one channel name, not ${rest.length}.`);
+        // `#general` is how a person says it and how `read`/`send` accept it, so
+        // the leading # is dropped here rather than becoming part of the name.
+        if (channelName.startsWith("#"))
+            channelName = channelName.slice(1);
+        if (channelName === "")
+            throw new Error("msg create needs a channel name, e.g. `cockpit msg create general`.");
+    }
+    else if (action === "dm") {
+        dmEmail = optionalNonEmpty(rest[0]);
+        if (!dmEmail)
+            throw new Error("msg dm needs the person's email address, e.g. `cockpit msg dm ada@example.com`.");
+        if (rest.length > 1)
+            throw new Error(`msg dm takes one email address, not ${rest.length}.`);
+        if (!dmEmail.includes("@"))
+            throw new Error(`msg dm takes an email address; "${dmEmail}" is not one.`);
+    }
+    return { channelName, dmEmail };
+}
+function parseMsgCreateFlags(action, values) {
+    const isPrivate = values.booleans.has("--private");
+    if (isPrivate && action !== "create") {
+        throw new Error("--private belongs to `cockpit msg create`.");
+    }
+    const memberEmails = parseMemberEmails(values.flags.get("--members"));
+    if (memberEmails && action !== "create") {
+        throw new Error("--members belongs to `cockpit msg create`.");
+    }
+    const description = optionalNonEmpty(values.flags.get("--description"));
+    if (description && action !== "create") {
+        throw new Error("--description belongs to `cockpit msg create`.");
+    }
+    return { isPrivate, memberEmails, description };
+}
+function parseMsgReadTarget(action, rest, values) {
+    let channelRef;
+    if (MSG_ACTIONS_NEEDING_A_CHANNEL.has(action)) {
+        channelRef = optionalNonEmpty(rest[0]);
+        if (!channelRef)
+            throw new Error(`msg ${action} needs a channel id or name.`);
+        if (rest.length > 1)
+            throw new Error(`msg ${action} takes one channel, not ${rest.length}.`);
+    }
+    else if (action === "thread" || action === "show") {
+        // `thread <id> --channel <channel>` — the channel is a flag here because
+        // the positional names the THREAD, not the channel (`--channel` below).
+        if (rest.length > 1)
+            throw new Error(`msg thread takes one thread id, not ${rest.length}.`);
+    }
+    else if (action !== "create" && action !== "dm" && rest.length > 0) {
+        throw new Error(`msg ${action} does not take "${rest[0]}".`);
+    }
+    const threadFlag = optionalNonEmpty(values.flags.get("--thread"));
+    const threadId = (action === "thread" || action === "show") ? optionalNonEmpty(rest[0]) : threadFlag;
+    if ((action === "thread" || action === "show") && !threadId)
+        throw new Error("msg thread needs a thread id.");
+    const channelFlag = optionalNonEmpty(values.flags.get("--channel"));
+    if (action === "thread")
+        channelRef = channelFlag;
+    const limit = optionalPositiveInteger(values.flags.get("--limit"), "--limit");
+    if (limit !== undefined && action !== "read" && action !== "thread") {
+        throw new Error("--limit belongs to `cockpit msg read` or `cockpit msg thread`.");
+    }
+    return { channelRef, threadId, limit };
+}
+function buildMsgCommand(values, action, channelRef, channelName, dmEmail, memberEmails, description, isPrivate, threadId, limit) {
+    return {
+        kind: "msg",
+        action,
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        ...(values.flags.has("--before") ? { before: optionalNonEmpty(values.flags.get("--before")) } : {}),
+        ...(channelRef ? { channelRef } : {}),
+        ...(channelName ? { channelName } : {}),
+        ...(dmEmail ? { dmEmail } : {}),
+        ...(memberEmails ? { memberEmails } : {}),
+        ...(description ? { description } : {}),
+        isPrivate,
+        ...(threadId ? { threadId } : {}),
+        ...(limit === undefined ? {} : { limit }),
+        json: values.booleans.has("--json"),
+    };
+}

package/dist/commands/local-help-commands-tower.js

@@ -77,7 +77,7 @@ export const TOWER_COMMAND_HELP = [
     [
         "msg",
         [
-            "Usage: cockpit msg [channels|create <name>|dm <email>|read <channel>|send <channel>|thread <id> --channel <channel>] [flags]",
+            "Usage: cockpit msg [channels|create <name>|dm <email>|read <channel>|send <channel>|thread <id> --channel <channel>|show <message-id>] [flags]",
             "",
             "Channels and messages, typed. <channel> is a channel id, or its name with or without a leading #.",
             "channels — every channel you are a member of (or, as a super_admin, every channel).",
@@ -85,7 +85,8 @@ export const TOWER_COMMAND_HELP = [
             "dm <email> — opens (or re-opens) the direct message with one person. Idempotent: the same address always resolves to the same channel, and you never have to name yourself.",
             "read <channel> [--limit <n>] [--thread <id>] — the channel's most recent top-level messages, oldest first; --thread <id> reads one thread's replies instead.",
             "send <channel> [--thread <id>] — posts a message. The content is never accepted on the command line: pipe it in, e.g. `echo \"hello\" | cockpit msg send general`.",
-            "thread <id> --channel <channel> — one thread's replies by the parent message's id.",
+            "thread <id> --channel <channel> [--before <cursor>] [--limit <n>] — one thread's replies by the parent message's id.",
+            "show <message-id> — exact message, thread root and bounded neighbors. read/thread --before takes the preceding nextCursor; repeat until hasMore is false.",
             "--json writes one machine-readable object to stdout; every reason and receipt line stays on stderr.",
             "A refusal keeps Tower's own reason label — needs_rls_client, channel_not_found_or_unreadable, content_too_long, and so on.",
             "The command uses the existing paired device identity. Run `cockpit login` first if this machine is not paired.",
@@ -142,13 +143,15 @@ export const TOWER_COMMAND_HELP = [
     [
         "cal",
         [
-            'Usage: cockpit cal [today|week|next|find "<words>"|calendars|add-ical|create|share <id>|sync <id>|sync-status [<id>]|detach <id>|delete <event id> --yes] [flags]',
+            'Usage: cockpit cal [today|week|conflicts|calendar-change <id> --color <hex-or-provider>|next|find "<words>"|calendars|add-ical|create|share <id>|sync <id>|sync-status [<id>]|detach <id>|delete <event id> --yes] [flags]',
             "",
             "Every calendar you attached, in one place — plus any calendar a colleague marked shared.",
             "today [--offset 1] [--tz <zone>] — what is on today, in YOUR zone (this machine's, unless --tz says otherwise). --offset 1 is tomorrow, -1 yesterday.",
             "week [--offset 1] — Monday to Sunday. The week starts on Monday here.",
             "next [--hours 12] — what is coming, from RIGHT NOW rather than from midnight. Defaults to the next 72 hours, so a Friday evening still answers.",
             'find "<words>" — full text over titles, locations and descriptions. A repeating event is answered with the NEXT time it happens, not its first one in 2024.',
+            "conflicts [--from <iso> --to <iso>] [--tz <IANA>] — own-account double-bookings with duplicate invitation merging, checked calendars and age. Visible calendars only by default; --all includes hidden calendars. All-day and free events never conflict.",
+            "calendar-change <id> --color <hex|provider> — persistent owner colour override, or reset to provider colour. Also accepts stdin JSON {color_override, selected}. History is retained.",
             "calendars — every calendar, its provider (google_oauth or ical_url), whether it is shared, and when it last synced. The ids other verbs take are on the last line.",
             "add-ical [--name \"<what to call it>\"] — attaches a personal calendar by its SECRET iCal ADDRESS, read from stdin. There is no flag for it:",
             '      macOS:      printf "%s" "https://calendar.google.com/calendar/ical/…/basic.ics" | cockpit cal add-ical --name "Personal"',

package/dist/commands/local-help.js

@@ -143,10 +143,10 @@ export function localCommandHelp(command) {
         "  cockpit clean [--dry-run] [--all-committed] [--reconcile] [--dashboard-url <url>] [--json]",
         "  cockpit sources check [--older-than <days>] [--dashboard-url <url>] [--json]",
         "  cockpit docs [list|tree|read <id|slug>|create --title <t>|update <id>|delete <id|slug>] [--parent <id>|root|--clear-parent] [--query <text> [--word]] [--limit <n>] [--visibility org|private] [--file <path>|--body-stdin] [--allow-empty] [--dashboard-url <url>] [--json]",
-        "  cockpit msg [channels|create <name>|dm <email>|read <channel>|send <channel>|thread <id> --channel <channel>] [--private] [--members a@x,b@y] [--description <text>] [--thread <id>] [--limit <n>] [--dashboard-url <url>] [--json]",
+        "  cockpit msg [channels|create <name>|dm <email>|read <channel>|send <channel>|thread <id> --channel <channel>|show <message-id>] [--private] [--members a@x,b@y] [--description <text>] [--thread <id>] [--limit <n>] [--before <cursor>] [--dashboard-url <url>] [--json]",
         "  cockpit issue [list|show <BLI-id>|create --title <t>|update <BLI-id>|move <BLI-id> <state>|comment <BLI-id>|history <BLI-id>] [--state <s>] [--assignee me|unassigned|<uuid>] [--project <name|id>] [--limit <n>] [--priority 0-4] [--size S|M|L] [--parent <BLI-id>] [--file <path>|--body-stdin] [--dashboard-url <url>] [--json]",
         "  cockpit mail [accounts|add-imap --address <a>|inbox|read <thread>|search \"<words>\"|send --account <id> --to <a> --subject <s>|draft --account <id> --to <a> --subject <s> [--reply-to <message id>]|attachment <id> --out <path>|sync <account>|detach <account>] [--account <id>] [--limit <n>] [--unread] [--label <l>] [--file <path>] [--attach <path>]... [--dashboard-url <url>] [--json]",
-        "  cockpit cal [today|week|next|find \"<words>\"|calendars|add-ical|create --calendar <id> --title <t> --at <iso> --until <iso>|share <id> --org-visible|--private|sync <id> [--full]|detach <id>] [--tz <zone>] [--offset <n>] [--hours <n>] [--from <d> --to <d>] [--calendar <id>] [--limit <n>] [--all] [--dashboard-url <url>] [--json]",
+        "  cockpit cal [today|week|conflicts|calendar-change <id> --color <hex-or-provider>|next|find \"<words>\"|calendars|add-ical|create --calendar <id> --title <t> --at <iso> --until <iso>|share <id> --org-visible|--private|sync <id> [--full]|detach <id>] [--tz <zone>] [--offset <n>] [--hours <n>] [--from <d> --to <d>] [--calendar <id>] [--limit <n>] [--all] [--dashboard-url <url>] [--json]",
         "  cockpit project [list] [--archived] [--dashboard-url <url>] [--json]",
         "  cockpit github <pr|merge|retitle|rerun> <owner/repo> <n> [--claim <state>] [--method squash|merge|rebase] [--title \"<text>\"] [--run <id>] [--confirm <code>] [--dashboard-url <url>] [--json]",
         `  cockpit search "<words>" [--kind <category,...>] [--limit <n>] [--dashboard-url <url>] [--json]`,

package/dist/commands/mail.js

@@ -278,7 +278,7 @@ async function send(command, door) {
         body: message.body,
     });
     if (!answer.ok)
-        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+        return failAgentDoor(door, TAG, answer.httpStatus ? answer.reason : "send_outcome_unknown", answer.httpStatus ? answer.detail : "The send receipt was lost. Check Sent before sending again; Tower will not retry automatically.");
     const sent = answer.body.sent;
     // Report only what the door's receipt shows (BLI-12661), never what was posted.
     const unconfirmed = unconfirmedAttachments(message.receipt, sent?.attachments, "send");
@@ -339,8 +339,8 @@ async function sync(command, door) {
         writeLine(door.io.stdout, "Tower answered without a run. Nothing to report.");
         return 0;
     }
-    if (run.reason === "ok") {
-        writeLine(door.io.stdout, `Synced: ${run.messagesAdded} new, ${run.messagesUpdated} updated, ${run.messagesDeleted} gone.`);
+    if (["ok", "quota_deferred", "history_gap", "interrupted"].includes(run.reason)) {
+        writeLine(door.io.stdout, `Sync pass: ${run.messagesAdded} new, ${run.messagesUpdated} updated, ${run.messagesDeleted} gone. ${run.reason}${run.coverage?.complete === false ? "; more work remains" : ""}.`);
         return 0;
     }
     // A failure names itself; the exit code says it failed.
@@ -367,11 +367,13 @@ async function syncStatus(command, door) {
         return 0;
     }
     for (const account of accounts) {
+        const coverage = account.last_run?.coverage;
+        const coverageLine = coverage ? `  requested=${coverage.requested} returned=${coverage.returned} unique=${coverage.unique} pending=${coverage.pending} complete=${coverage.complete}` : "";
         const lastRun = account.last_run
             ? `${account.last_run.reason} @ ${account.last_run.started_at} (${account.last_run.items} item(s))`
             : "never synced";
         const lag = account.lag ? `${account.lag.lag_seconds}s` : "unknown";
-        writeLine(door.io.stdout, `${account.address}  last_success=${account.last_success_at ?? "never"}  last_run=${lastRun}  failures_24h=${account.failures_24h}  lag=${lag}${account.data_incomplete ? "  (partial read)" : ""}`);
+        writeLine(door.io.stdout, `${account.address}  last_success=${account.last_success_at ?? "never"}  last_run=${lastRun}  failures_24h=${account.failures_24h}  lag=${lag}${account.data_incomplete ? "  (partial read)" : ""}${coverageLine}`);
     }
     return 0;
 }

package/dist/commands/msg.js

@@ -25,6 +25,8 @@ const CONTENT_MAX_CHARS = 8_000;
 export async function runMsg(command, io) {
     const door = await openAgentDoor("msg", command, io);
     switch (command.action) {
+        case "show":
+            return showMessage(command, door);
         case "channels":
             return listChannels(door);
         case "read":
@@ -59,9 +61,20 @@ async function fetchChannels(door) {
     });
     if (!answer.ok)
         return { ok: false, reason: answer.reason, detail: answer.detail };
+    const channels = answer.body.channels ?? [];
+    let page = answer.body;
+    for (let count = 0; page.hasMore; count++) {
+        if (count >= 200 || !page.nextCursor)
+            return { ok: false, reason: "read_failed", detail: "Channel listing is incomplete. Retry online or use an ID." };
+        const next = await askAgentDoor(door, { path: `/api/msg/channels?before=${encodeURIComponent(page.nextCursor)}`, method: "GET", label: "msg channels page", timeoutMs: READ_DEADLINE_MS });
+        if (!next.ok)
+            return { ok: false, reason: next.reason, detail: next.detail };
+        channels.push(...(next.body.channels ?? []));
+        page = next.body;
+    }
     return {
         ok: true,
-        channels: answer.body.channels ?? [],
+        channels,
         fromCache: answer.fromCache,
         ageMs: answer.ageMs,
         coverage: answer.coverage,
@@ -89,6 +102,12 @@ async function listChannels(door) {
 }
 /** Exact id, or exact name with or without a leading `#`. Never fuzzy. */
 async function resolveChannelId(door, ref) {
+    if (/^[0-9a-f]{8}-[0-9a-f-]{27}$/i.test(ref)) {
+        const answer = await askAgentDoor(door, { path: `/api/msg/channels?channel_id=${encodeURIComponent(ref)}`, method: "GET", label: "msg channel", timeoutMs: READ_DEADLINE_MS });
+        if (!answer.ok)
+            return answer.reason === "channel_not_found_or_unreadable" ? { status: "not_found" } : { status: "list_failed", reason: answer.reason, detail: answer.detail };
+        return { status: "ok", id: ref };
+    }
     const fetched = await fetchChannels(door);
     if (!fetched.ok)
         return { status: "list_failed", reason: fetched.reason, detail: fetched.detail };
@@ -112,6 +131,8 @@ async function readChannel(command, door) {
     if (resolved.status === "not_found")
         return channelNotFound(door, ref);
     const query = new URLSearchParams();
+    if (command.before)
+        query.set("before", command.before);
     if (command.limit !== undefined)
         query.set("limit", String(command.limit));
     if (command.threadId)
@@ -124,7 +145,7 @@ async function readChannel(command, door) {
         timeoutMs: READ_DEADLINE_MS,
     });
     if (!answer.ok)
-        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+        return failAgentDoor(door, TAG, answer.reason, answer.detail, answer.body?.coverage === "failed_partial" ? answer.body : {});
     const body = answer.body;
     const messages = body.messages ?? [];
     // BLI-10449: whether this channel is Tower's own or a Slack snapshot, and
@@ -132,12 +153,14 @@ async function readChannel(command, door) {
     const provenance = body.provenance ?? null;
     const limitApplied = body.limitApplied ?? null;
     if (door.json)
-        return emitAgentDoor(door, { ok: true, channelId: resolved.id, provenance, limitApplied, messages });
+        return emitAgentDoor(door, { ok: true, ...body, channelId: resolved.id, provenance, limitApplied, messages, nextCursor: body.nextCursor, hasMore: body.hasMore, coverage: body.coverage });
     if (provenance?.sentence)
         writeLine(door.io.stdout, provenance.sentence);
     if (limitApplied !== null) {
         writeLine(door.io.stdout, `Showing the newest ${limitApplied}: one read returns at most ${limitApplied} messages.`);
     }
+    if (body.nextCursor)
+        writeLine(door.io.stdout, `More history: --before ${body.nextCursor}`);
     if (messages.length === 0) {
         writeLine(door.io.stdout, "No messages.");
         return 0;
@@ -145,7 +168,7 @@ async function readChannel(command, door) {
     for (const message of [...messages].reverse()) {
         // An imported Slack message has no Tower user; its Slack name is the label.
         const who = message.agent_label ?? message.user_id ?? message.slack_author_label ?? "someone";
-        writeLine(door.io.stdout, `${message.created_at}  ${who}  ${message.content ?? ""}`);
+        writeLine(door.io.stdout, `${message.id}  ${message.created_at}  ${who}  ${message.content ?? ""}`);
     }
     return 0;
 }
@@ -159,23 +182,26 @@ async function readThread(command, door) {
     if (resolved.status === "not_found")
         return channelNotFound(door, command.channelRef);
     const answer = await askAgentDoor(door, {
-        path: `/api/msg/channels/${encodeURIComponent(resolved.id)}/messages?thread_parent_id=${encodeURIComponent(command.threadId ?? "")}`,
+        path: `/api/msg/channels/${encodeURIComponent(resolved.id)}/messages?thread_parent_id=${encodeURIComponent(command.threadId ?? "")}${command.before ? `&before=${encodeURIComponent(command.before)}` : ""}${command.limit ? `&limit=${command.limit}` : ""}`,
         method: "GET",
         label: "msg thread",
         timeoutMs: READ_DEADLINE_MS,
     });
     if (!answer.ok)
-        return failAgentDoor(door, TAG, answer.reason, answer.detail);
-    const messages = answer.body.messages ?? [];
+        return failAgentDoor(door, TAG, answer.reason, answer.detail, answer.body?.coverage === "failed_partial" ? answer.body : {});
+    const body = answer.body;
+    const messages = body.messages ?? [];
     if (door.json)
-        return emitAgentDoor(door, { ok: true, channelId: resolved.id, threadParentId: command.threadId, messages });
+        return emitAgentDoor(door, { ok: true, ...body, channelId: resolved.id, threadParentId: command.threadId, messages, nextCursor: body.nextCursor, hasMore: body.hasMore, coverage: body.coverage });
+    if (body.nextCursor)
+        writeLine(door.io.stdout, `More history: --before ${body.nextCursor}`);
     if (messages.length === 0) {
         writeLine(door.io.stdout, "No replies.");
         return 0;
     }
     for (const message of [...messages].reverse()) {
         const who = message.agent_label ?? message.user_id;
-        writeLine(door.io.stdout, `${message.created_at}  ${who}  ${message.content ?? ""}`);
+        writeLine(door.io.stdout, `${message.id}  ${message.created_at}  ${who}  ${message.content ?? ""}`);
     }
     return 0;
 }
@@ -307,4 +333,20 @@ async function openDm(command, door) {
     // true either way rather than claiming a creation that may not have happened.
     writeLine(door.io.stdout, `Direct message with ${email}: ${channel?.id ?? "?"}`);
     return 0;
+}
+async function showMessage(command, door) {
+    const answer = await askAgentDoor(door, { path: `/api/msg/messages/${encodeURIComponent(command.threadId ?? "")}`, method: "GET", label: "msg show", timeoutMs: READ_DEADLINE_MS });
+    if (!answer.ok)
+        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, ...answer.body });
+    const body = answer.body;
+    writeLine(door.io.stdout, body.href ?? "Message context");
+    for (const page of [body.channelPage, body.threadPage]) {
+        for (const row of [...(page?.messages ?? [])].reverse())
+            writeLine(door.io.stdout, `${row.id}  ${row.created_at}  ${row.content ?? ""}`);
+        if (page?.nextCursor)
+            writeLine(door.io.stdout, `More history: --before ${page.nextCursor}`);
+    }
+    return 0;
 }

package/dist/commands/public-root.js

@@ -21,7 +21,7 @@ export async function runCockpitCli(argv, io) {
   }
 
   if (command === "--version" || command === "-V" || command === "version") {
-    writeLine(io?.stdout ?? process.stdout, "0.2.236");
+    writeLine(io?.stdout ?? process.stdout, "0.2.237");
     return 0;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.236",
+  "version": "0.2.237",
   "private": false,
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@bli-cockpit/memory-mcp": "0.1.69",
-    "@bli-cockpit/mcp": "0.1.141",
+    "@bli-cockpit/mcp": "0.1.142",
     "@bli-cockpit/telemetry-core": "0.1.76"
   },
   "repository": {