@bli-cockpit/cli 0.2.45 → 0.2.46

package/dist/commands/brief.js

@@ -59,6 +59,11 @@ export async function runBrief(command, io) {
         visible_because: body.visibleBecause ?? null,
         tldr: Boolean(command.tldr),
         pinned_version: command.version != null,
+        asked_day: command.date != null,
+        day: body.day?.date ?? null,
+        history_count: body.history?.length ?? null,
+        history_truncated: body.historyTruncated ?? null,
+        delta: command.delta ? (body.delta ? "answered" : (body.deltaReason ?? "missing")) : null,
         subject: command.subject ? "selected" : "caller",
         version_count: body.versions?.length ?? null,
         versions_reason: body.versionsReason ?? null,
@@ -127,12 +132,24 @@ function queryFor(command) {
         params.set("p", command.subject);
     if (command.version)
         params.set("v", command.version);
+    if (command.date)
+        params.set("d", command.date);
     if (command.tldr)
         params.set("tldr", "1");
     if (command.versions)
         params.set("versions", "1");
     if (command.claims)
         params.set("claims", "1");
+    if (command.action === "history") {
+        params.set("history", "1");
+        if (command.days !== undefined)
+            params.set("days", String(command.days));
+    }
+    if (command.delta) {
+        params.set("delta", "1");
+        if (command.against)
+            params.set("against", command.against);
+    }
     const query = params.toString();
     return query ? `?${query}` : "";
 }
@@ -145,9 +162,20 @@ function writeHuman(io, command, body) {
     // moment rather than something that failed to update.
     const whose = page.displayName ? `${page.displayName}'s page` : "This page";
     const pinned = page.olderVersionLabel ? ` · version from ${page.olderVersionLabel}` : "";
-    writeLine(io.stdout, dim(`${whose}${pinned}`, styled));
+    // BLI-3484: which day, in the SUBJECT's zone, said with the zone beside it so
+    // nobody has to work out whose midnight this is.
+    const day = body.day?.date ? ` · ${body.day.date}${body.day.zone ? ` ${body.day.zone}` : ""}` : "";
+    writeLine(io.stdout, dim(`${whose}${pinned}${day}`, styled));
+    // `history` lists days and prints no page — a list of dates under a full
+    // brief would bury the thing somebody asked for.
+    if (command.action === "history") {
+        writeHistory(io, body, styled);
+        return;
+    }
     writeLine(io.stdout, "");
     writeLine(io.stdout, body.text ?? "");
+    if (command.delta)
+        writeDelta(io, body, styled);
     if (body.claims && body.claims.length > 0) {
         writeLine(io.stdout, "");
         writeLine(io.stdout, dim("Claim ids — pass one to `cockpit correct --claim`:", styled));
@@ -181,6 +209,72 @@ function writeHuman(io, command, body) {
         }
     }
 }
+/**
+ * `cockpit brief history` — the days there are, newest first (BLI-3484).
+ *
+ * The masthead line beside each date is what makes the list browsable: a column
+ * of dates is a filing cabinet, a column of dates with "Two reviews waiting,
+ * one shipped" beside them is a history somebody can find their way around.
+ *
+ * A short window says so. The oldest date printed is not the oldest date there
+ * is when the index hit its cap, and a person picking through history has to
+ * know which of those they are looking at.
+ */
+function writeHistory(io, body, styled) {
+    const history = body.history ?? [];
+    writeLine(io.stdout, "");
+    if (history.length === 0) {
+        writeLine(io.stdout, dim("No days with a page yet.", styled));
+        return;
+    }
+    writeLine(io.stdout, dim("Days — pass one to `cockpit brief --date`:", styled));
+    for (const entry of history) {
+        const compiles = typeof entry.versionCount === "number" && entry.versionCount > 1
+            ? ` (${entry.versionCount} compiles)`
+            : "";
+        const heading = entry.heading ? ` — ${entry.heading}` : "";
+        writeLine(io.stdout, `${dim(`  ${entry.date ?? "?"}`, styled)}${heading}${dim(compiles, styled)}`);
+    }
+    if (body.historyTruncated) {
+        writeLine(io.stdout, "");
+        writeLine(io.stdout, dim("There are older days than these. Ask for more with `--days <n>`.", styled));
+    }
+}
+/**
+ * `--delta` — what changed between this day and the one before it.
+ *
+ * The headline first, then the lines that moved, because the headline is the
+ * answer and the detail is the evidence for it. A missing delta prints its
+ * reason: silence here would read as "nothing changed", which is a completely
+ * different and much worse claim than "I could not work it out".
+ */
+function writeDelta(io, body, styled) {
+    writeLine(io.stdout, "");
+    if (!body.delta) {
+        writeLine(io.stdout, dim(`No day-over-day comparison (${body.deltaReason ?? "no reason given"}).`, styled));
+        return;
+    }
+    const delta = body.delta;
+    const from = delta.from?.date ?? "the day before";
+    const to = delta.to?.date ?? "this day";
+    writeLine(io.stdout, dim(`What changed, ${from} → ${to}:`, styled));
+    writeLine(io.stdout, `  ${delta.headline ?? "(no headline)"}`);
+    for (const item of delta.detail ?? []) {
+        writeLine(io.stdout, "");
+        if (item.before)
+            writeLine(io.stdout, `${dim("  was:", styled)} ${item.before}`);
+        if (item.after)
+            writeLine(io.stdout, `${dim("  now:", styled)} ${item.after}`);
+        if (item.because)
+            writeLine(io.stdout, `${dim("  why:", styled)} ${item.because}`);
+    }
+    if (delta.storedReason) {
+        // Not a failure and not hidden either: this comparison skips versions, so
+        // it is worked out fresh every time somebody asks for it.
+        writeLine(io.stdout, "");
+        writeLine(io.stdout, dim(`(not kept: ${delta.storedReason})`, styled));
+    }
+}
 function writeFailure(command, io, reason, detail) {
     if (command.json) {
         writeLine(io.stdout, JSON.stringify({ ok: false, error: reason, detail }));

package/dist/commands/jarvis.js

@@ -174,6 +174,9 @@ async function sendOneTurn(context, prompt, io) {
                 thread: context.command.thread,
                 subject: context.command.subject,
                 model: context.command.model,
+                // BLI-3484: which day's page this turn is about. Sent verbatim — the
+                // dashboard decides what counts as a date and whose day it is.
+                date: context.command.date,
             },
         log,
     });
@@ -263,6 +266,8 @@ function buildAttachmentForm(command, prompt, attachment) {
         form.set("subject", command.subject);
     if (command.model)
         form.set("model", command.model);
+    if (command.date)
+        form.set("date", command.date);
     form.set("image", new File([attachment.bytes], attachment.fileName, { type: attachment.mimeType }));
     return form;
 }

package/dist/commands/local-args.js

@@ -842,6 +842,8 @@ function parseJarvisArgs(args) {
             "--image",
             "--file",
             "--no-stream",
+            // BLI-3484: which day's page this turn is about.
+            "--date",
             // BLI-3458: reading back what was already said, rather than saying
             // something new. Neither takes a turn or reaches the model.
             "--threads",
@@ -858,6 +860,7 @@ function parseJarvisArgs(args) {
             "--model",
             "--image",
             "--file",
+            "--date",
             "--limit",
         ],
     });
@@ -892,6 +895,14 @@ function parseJarvisArgs(args) {
     if ((threads || history) && image) {
         throw new Error("jarvis --threads and --history do not take an attachment.");
     }
+    // BLI-3484. `--date` binds the page that was live on one of the subject's
+    // days, so a turn can be about Sunday's page. Refused on the two reading
+    // commands for the same reason an attachment is: they replay what was said
+    // and bind no page at all.
+    const date = optionalNonEmpty(values.flags.get("--date"));
+    if ((threads || history) && date) {
+        throw new Error("jarvis --threads and --history replay what was said; they bind no page.");
+    }
     return {
         kind: "jarvis",
         homeDir: optionalNonEmpty(values.flags.get("--home")),
@@ -905,6 +916,7 @@ function parseJarvisArgs(args) {
         // BLI-3381: no client-side allowlist — the dashboard forwards this key
         // to the inference server's own allowlist and relays its refusal.
         model: optionalNonEmpty(values.flags.get("--model")),
+        ...(date ? { date } : {}),
         imagePath: image ?? file,
         // BLI-3457: streaming is on unless a caller opts out. A dashboard that
         // does not stream yet still answers plain JSON, so this flag is for
@@ -1137,6 +1149,12 @@ function parseWorkbookArgs(args) {
  * does: the dashboard resolves it against the roster and the database (or the
  * route's own mirror of the database's rule) decides whether the page opens.
  * Nothing is decided here.
+ *
+ * `--date` (BLI-3484) is the terminal's `?d=`, and the same sentence applies to
+ * it twice over: what counts as a date, where that person's day starts, and
+ * whether anything was compiled for it are all the dashboard's answer. A local
+ * copy of "when does Tuesday begin" would be a second answer to a question this
+ * product already answers per person, per zone.
  */
 function parseBriefArgs(args) {
     const values = parseNamedArgs(args, {
@@ -1147,6 +1165,10 @@ function parseBriefArgs(args) {
             "--as",
             "--who",
             "--version",
+            "--date",
+            "--delta",
+            "--against",
+            "--days",
             "--tldr",
             "--full",
             "--versions",
@@ -1157,15 +1179,26 @@ function parseBriefArgs(args) {
             "--no-wait",
             "--json",
         ],
-        valueFlags: ["--home", "--dashboard-url", "--for", "--as", "--who", "--version", "--reason"],
+        valueFlags: [
+            "--home",
+            "--dashboard-url",
+            "--for",
+            "--as",
+            "--who",
+            "--version",
+            "--date",
+            "--against",
+            "--days",
+            "--reason",
+        ],
     });
     // Bare `cockpit brief` reads the page, which is what somebody typing it almost
     // always wants — the same shape `cockpit notes` and `cockpit scout` have.
     // `status` (BLI-3462) answers why a brief was or was not delivered.
     const first = values.positionals[0];
     const action = (first === undefined ? "read" : first);
-    if (!["read", "edit", "rewrite", "status"].includes(action)) {
-        throw new Error(`Unknown brief command: ${first}. Try edit, rewrite or status, or nothing to read it.`);
+    if (!["read", "edit", "rewrite", "history", "status"].includes(action)) {
+        throw new Error(`Unknown brief command: ${first}. Try edit, rewrite, history or status, or nothing to read it.`);
     }
     if (values.positionals.length > (first === undefined ? 0 : 1)) {
         throw new Error(`brief ${action} does not take "${values.positionals[1]}".`);
@@ -1192,6 +1225,29 @@ function parseBriefArgs(args) {
     if (action !== "rewrite" && (wait || noWait)) {
         throw new Error("--wait and --no-wait belong to `cockpit brief rewrite`.");
     }
+    // ── Reading a past day (BLI-3484) ────────────────────────────────────────
+    const date = optionalNonEmpty(values.flags.get("--date"));
+    const against = optionalNonEmpty(values.flags.get("--against"));
+    const delta = values.booleans.has("--delta");
+    const days = optionalPositiveInteger(values.flags.get("--days"), "--days");
+    if (date && action !== "read") {
+        throw new Error("--date belongs to `cockpit brief` on its own — it reads one day's page.");
+    }
+    if (delta && action !== "read") {
+        throw new Error("--delta belongs to `cockpit brief` on its own.");
+    }
+    if (against && !delta) {
+        // Said rather than silently ignored: somebody who typed `--against` asked
+        // for a comparison, and running the plain read would answer a different
+        // question without saying so.
+        throw new Error("--against needs --delta: it names the day to compare against.");
+    }
+    if (days !== undefined && action !== "history") {
+        throw new Error("--days belongs to `cockpit brief history`.");
+    }
+    if (action === "history" && (values.booleans.has("--tldr") || values.booleans.has("--claims"))) {
+        throw new Error("brief history lists days; --tldr and --claims belong to reading a page.");
+    }
     // `--as` is accepted as an alias so the two conversational commands read the
     // same way; `cockpit jarvis --as <person>` has meant this since BLI-3380.
     // `--who` is the third spelling, and it exists because `cockpit brief status
@@ -1215,6 +1271,10 @@ function parseBriefArgs(args) {
         dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
         subject: forPerson ?? asPerson ?? whoPerson,
         version: optionalNonEmpty(values.flags.get("--version")),
+        ...(date ? { date } : {}),
+        ...(delta ? { delta: true } : {}),
+        ...(against ? { against } : {}),
+        ...(days !== undefined ? { days } : {}),
         tldr,
         versions: values.booleans.has("--versions"),
         claims: values.booleans.has("--claims"),

package/dist/commands/local-help.js

@@ -56,7 +56,7 @@ export function localCommandHelp(command) {
         "  cockpit start [--ticket <id>|--clear-ticket] [--topic <label>] [--intent <intent>] [--phase <phase>] [--workspace <path>] [--branch <name>] [--max-depth <n>] [--max-repos <n>] [--json]",
         "  cockpit sync [--workspace <path>] [--dashboard-url <url>] [--max-depth <n>] [--max-repos <n>] [--json]",
         "  cockpit analyze [--workspace <path>] [--dashboard-url <url>] [--max-depth <n>] [--max-repos <n>] [--json]",
-        "  cockpit jarvis [question] [--prompt <question>] [--as <person>] [--thread <name>] [--model <key>] [--image <path>|--file <path>] [--no-stream] [--threads|--history [--limit <n>]] [--dashboard-url <url>] [--json]",
+        "  cockpit jarvis [question] [--prompt <question>] [--as <person>] [--date <YYYY-MM-DD>] [--thread <name>] [--model <key>] [--image <path>|--file <path>] [--no-stream] [--threads|--history [--limit <n>]] [--dashboard-url <url>] [--json]",
         "  cockpit model [show|set <provider:model>] [--json]",
         "  cockpit scout [start|dismiss|undo <experiment-id>] [--days <n>] [--dashboard-url <url>] [--json]",
         "  cockpit ops [status [--job <id>] [--skips] | recompile --person <email|name|id> [--dry-run]] [--dashboard-url <url>] [--json]",
@@ -64,7 +64,7 @@ export function localCommandHelp(command) {
         "  cockpit settings [personal [--chat-model <key>] [--brief-model <key>] | switches [set <key> <value>] | models [set --chat <key>] [--memory <id>] | env list|set --project <p> --file <f> --content-stdin|delete --id <uuid> [--yes]] [--json]",
         "  cockpit team [members | invite <email> --role <role> [--team-id <uuid>] | role <userId> --role <role> [--yes]] [--json]",
         "  cockpit workbook [<project> [<doc>]] [--section <id>] [--markdown] [--width <n>] [--dashboard-url <url>] [--json]",
-        "  cockpit brief [edit|rewrite] [--for <person>] [--version <pageId>] [--tldr|--full] [--versions] [--claims] [--reason \"<why>\"] [--wait|--no-wait] [--dashboard-url <url>] [--json]",
+        "  cockpit brief [edit|rewrite|history] [--for <person>] [--date <YYYY-MM-DD>] [--delta [--against <YYYY-MM-DD>]] [--version <pageId>] [--tldr|--full] [--versions] [--claims] [--days <n>] [--reason \"<why>\"] [--wait|--no-wait] [--dashboard-url <url>] [--json]",
         "  cockpit brief status [--who <person>] [--render] [--dashboard-url <url>] [--json]",
         "  cockpit correct --claim <claimId> --text \"<what is wrong>\" [--for <person>] [--version <pageId>] [--supersedes <id>] [--dashboard-url <url>] [--json]",
         "  cockpit notes [list|show <id>|shelf|shelves|upload <paths...>|paste|share <id>|unshare <id>|move <id>] [--series <shelf>] [--kind <kind>] [--since <YYYY-MM-DD>] [--until <YYYY-MM-DD>] [--limit <n>] [--file <path>] [--name <n>] [--exclude \"<sentence>\"] [--to \"<shelf>\"|--clear-shelf] [--yes] [--dashboard-url <url>] [--json]",
@@ -274,10 +274,11 @@ function localSubcommandHelp(command) {
         [
             "jarvis",
             [
-                "Usage: cockpit jarvis [question] [--prompt <question>] [--as <person>] [--thread <name>] [--model <key>] [--image <path>|--file <path>] [--no-stream] [--threads|--history [--limit <n>]] [--dashboard-url <url>] [--json]",
+                "Usage: cockpit jarvis [question] [--prompt <question>] [--as <person>] [--date <YYYY-MM-DD>] [--thread <name>] [--model <key>] [--image <path>|--file <path>] [--no-stream] [--threads|--history [--limit <n>]] [--dashboard-url <url>] [--json]",
                 "",
                 "Chats with the same JARVIS used by Tower web chat and the BLI Slack DM.",
                 "--as selects the existing website person space; it changes who the chat is about, never who is authenticated.",
+                "--date <YYYY-MM-DD> binds the page that was live on one of that person's days (`today` and `yesterday` work too), so the turn is about that day's page instead of the newest one. A day with nothing compiled binds no page and JARVIS says so rather than answering from a different day.",
                 "--model <key> requests one provider:model pair (e.g. openai:gpt-5.6-terra); an unrecognised key is refused by the dashboard, not this command.",
                 "--image <path> (alias --file) attaches one local PNG, JPEG, or WEBP under 10 MB with the question, the same one-image gate the JARVIS panel uses. A bad path, an unsupported type, or an oversized file is refused with its own plain sentence — never a stack trace.",
                 "Run with no question for an interactive terminal conversation.",
@@ -377,7 +378,7 @@ function localSubcommandHelp(command) {
         [
             "brief",
             [
-                "Usage: cockpit brief [edit|rewrite] [--for <person>] [--version <pageId>] [--tldr|--full] [--versions] [--claims] [--reason \"<why>\"] [--wait|--no-wait] [--dashboard-url <url>] [--json]",
+                "Usage: cockpit brief [edit|rewrite|history] [--for <person>] [--date <YYYY-MM-DD>] [--delta [--against <YYYY-MM-DD>]] [--version <pageId>] [--tldr|--full] [--versions] [--claims] [--days <n>] [--reason \"<why>\"] [--wait|--no-wait] [--dashboard-url <url>] [--json]",
                 "",
                 "Prints the TODAY page — the same page the Tower website shows, rendered for a terminal.",
                 "--for opens somebody else's page; the website's own rule decides whether you may, and it refuses in plain words when you may not.",
@@ -386,6 +387,14 @@ function localSubcommandHelp(command) {
                 "--claims prints the [claimId] beside every line, which is what `cockpit correct --claim` takes.",
                 "Reading it here counts as opening it, exactly as opening it in a browser does.",
                 "",
+                "--date <YYYY-MM-DD> reads the page that was live on one day — `today` and `yesterday` work too. Days are that person's own days, in their own timezone, so a page always sits on the date its own masthead says.",
+                "  A day with nothing compiled says so by name, and says which day is nearest. It never quietly hands you a different day's page.",
+                "--delta says what changed between that day and the day before it, in the same words the website's version history uses. --against <day> compares against a day you name instead.",
+                "  Comparisons that skip versions are worked out fresh each time and say `(not kept)` — a day with several compiles is one of those.",
+                "",
+                "history — the days there are, newest first, each with its masthead line and how many times it compiled that day. --days <n> asks for more than the last 14.",
+                "  Pass any date it prints back to `--date`.",
+                "",
                 "  cockpit brief status [--who <person>] [--render]",
                 "      Why your brief did or did not arrive this morning — one reason, from the same",
                 "      chain the Slack DM cron itself follows: not_due, not_monday, not_the_1st,",

package/dist/commands/public-root.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.45",
+  "version": "0.2.46",
   "private": false,
   "type": "module",
   "bin": {