@bli-cockpit/cli 0.2.224 → 0.2.237

package/dist/commands/local-args-tower-logs-search.js

@@ -0,0 +1,51 @@
+/**
+ * `cockpit logs search` argument parsing (BLI-20654).
+ *
+ *   cockpit logs search <project> [--source gcp|supabase|vercel|railway|deploys|db-host|<label>] [--stream api|postgres|auth]
+ *        [--since 30m|6h (default 1h) | --from <iso> [--to <iso>]]  [--status 500|5xx|500-503] [--method GET] [--route <text>]
+ *        [--severity error] [--q <text>] [--limit <n>] [--context] [--json]
+ *
+ * Plain words: it asks Tower to read the project's raw logs NOW, from the platform, and print the matching lines, scrubbed.
+ * Owner or admin only (the server decides). The values are validated by the server; this parser only checks the shape.
+ */
+import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+export function parseLogsSearchArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--source", "--stream", "--since", "--from", "--to", "--status", "--method", "--route", "--severity", "--q", "--limit", "--context", "--home", "--dashboard-url", "--json"],
+        valueFlags: ["--source", "--stream", "--since", "--from", "--to", "--status", "--method", "--route", "--severity", "--q", "--limit", "--home", "--dashboard-url"],
+    });
+    const project = values.positionals[0];
+    if (!project || values.positionals.length > 1)
+        throw new Error("Use cockpit logs search <project> --since 30m [--source gcp] [--status 500] [--method GET] [--route <text>] [--q <text>] [--context] [--json].");
+    const from = optionalNonEmpty(values.flags.get("--from"));
+    // No window named means the last hour: a search is for something that just happened, and a default keeps the bare verb runnable.
+    const since = optionalNonEmpty(values.flags.get("--since")) ?? (from ? undefined : "1h");
+    if (since && from)
+        throw new Error("logs search takes --since or --from, not both.");
+    const limit = optionalPositiveInteger(values.flags.get("--limit"), "--limit");
+    const pick = (name) => optionalNonEmpty(values.flags.get(name));
+    return {
+        kind: "logs",
+        source: project,
+        stored: false,
+        list: false,
+        allLevels: false,
+        search: {
+            ...(pick("--source") ? { logSource: pick("--source") } : {}),
+            ...(pick("--stream") ? { stream: pick("--stream") } : {}),
+            ...(since ? { since } : {}),
+            ...(from ? { from } : {}),
+            ...(pick("--to") ? { to: pick("--to") } : {}),
+            ...(pick("--status") ? { status: pick("--status") } : {}),
+            ...(pick("--method") ? { method: pick("--method") } : {}),
+            ...(pick("--route") ? { route: pick("--route") } : {}),
+            ...(pick("--severity") ? { severity: pick("--severity") } : {}),
+            ...(pick("--q") ? { q: pick("--q") } : {}),
+            ...(limit === undefined ? {} : { limit }),
+            context: values.booleans.has("--context"),
+        },
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        json: values.booleans.has("--json"),
+    };
+}

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

@@ -16,12 +16,15 @@
  */
 import { LOG_PROJECT_PATTERN } from "@bli-cockpit/telemetry-core/log-digest";
 import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+import { parseLogsSearchArgs } from "./local-args-tower-logs-search.js";
 /** The source spellings, for the usage line and the refusal. `railway:<service>` takes any service name. */
 export const LOGS_SOURCES = ["collector", "dashboard", "railway", "railway:<service>", "-", "<project>"];
 /** The spellings that read a local log; every other name is a registry project (stored digests). */
 const LOCAL_SOURCE_PATTERN = /^(collector|dashboard|railway|railway:[A-Za-z0-9][A-Za-z0-9._-]{0,63}|-)$/;
 const SINCE_PATTERN = /^(\d{1,4}[smhd]|\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?(Z|[+-]\d{2}:\d{2})?)?)$/;
 export function parseLogsArgs(args) {
+    if (args[0] === "search")
+        return parseLogsSearchArgs(args.slice(1));
     if (args[0] === "keys") {
         const action = args[1];
         const source = args[2];

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

@@ -32,10 +32,12 @@
  * them; `parseMemoryArgs` in `local-args-collector-status.ts` routes to here.
  */
 import { parseMemoryMapArgs } from "./memory-map.js";
+import { parseMemoryRepeatsArgs } from "./memory-repeats.js";
 import { parseMemoryRulesArgs } from "./memory-rules.js";
 import { optionalNonEmpty, optionalUrl, parseNamedArgs, workRootFlagValue, } from "./local-arg-values.js";
 export const MEMORY_STORE_ACTIONS = new Set([
     "map",
+    "repeats",
     "rules",
     "knowledge",
     "search",
@@ -54,6 +56,10 @@ export const MEMORY_STORE_ACTIONS = new Set([
     "consolidation",
     // BLI-13376: the originals behind a consolidated memory, one id.
     "chain",
+    // BLI-19255: the raw session or meeting behind a memory, as a bounded verbatim excerpt.
+    "source",
+    // BLI-19249: a READ of the nightly memory exam score. The exam is a Railway job; owner-only.
+    "exam",
     "requeue",
 ]);
 const ALLOWED_FLAGS = [
@@ -64,6 +70,12 @@ const ALLOWED_FLAGS = [
     "--container",
     "--limit",
     "--no-recent",
+    "--include-originals",
+    "--no-originals",
+    "--include-source",
+    "--no-source",
+    "--query",
+    "--chars",
     "--custom-id",
     "--alias",
     "--extract",
@@ -75,6 +87,8 @@ const ALLOWED_FLAGS = [
     "--source",
     "--dry-run",
     "--apply",
+    "--misses",
+    "--night",
     "--json",
 ];
 const VALUE_FLAGS = [
@@ -84,6 +98,8 @@ const VALUE_FLAGS = [
     "--repo",
     "--container",
     "--limit",
+    "--query",
+    "--chars",
     "--custom-id",
     "--alias",
     "--file",
@@ -91,10 +107,13 @@ const VALUE_FLAGS = [
     "--since",
     "--until",
     "--source",
+    "--night",
 ];
 export function parseMemoryStoreArgs(action, args) {
     if (action === "map")
         return parseMemoryMapArgs(args);
+    if (action === "repeats")
+        return parseMemoryRepeatsArgs(args);
     if (action === "rules" || action === "knowledge")
         return parseMemoryRulesArgs(args, action);
     const values = parseNamedArgs(args, { allowedFlags: ALLOWED_FLAGS, valueFlags: VALUE_FLAGS });
@@ -106,6 +125,21 @@ export function parseMemoryStoreArgs(action, args) {
     if (action !== "search" && (values.flags.has("--limit") || values.booleans.has("--no-recent"))) {
         throw new Error("--limit and --no-recent only apply to memory search.");
     }
+    if (action !== "search" && (values.booleans.has("--include-originals") || values.booleans.has("--no-originals"))) {
+        throw new Error("--include-originals and --no-originals only apply to memory search.");
+    }
+    if (values.booleans.has("--include-originals") && values.booleans.has("--no-originals")) {
+        throw new Error("--include-originals and --no-originals are opposites; name one.");
+    }
+    if (action !== "search" && (values.booleans.has("--include-source") || values.booleans.has("--no-source"))) {
+        throw new Error("--include-source and --no-source only apply to memory search.");
+    }
+    if (values.booleans.has("--include-source") && values.booleans.has("--no-source")) {
+        throw new Error("--include-source and --no-source are opposites; name one.");
+    }
+    if (action !== "source" && (values.flags.has("--query") || values.flags.has("--chars"))) {
+        throw new Error("--query and --chars only apply to memory source.");
+    }
     if (action === "consolidation" && rest.length > 0) {
         throw new Error("memory consolidation takes no positionals: `cockpit memory consolidation [--container <tag>] [--json]`.");
     }
@@ -126,6 +160,9 @@ export function parseMemoryStoreArgs(action, args) {
             || values.booleans.has("--dry-run") || values.booleans.has("--apply"))) {
         throw new Error("--since, --until, --source, --dry-run and --apply only apply to memory requeue.");
     }
+    if (action !== "exam" && (values.flags.has("--night") || values.booleans.has("--misses"))) {
+        throw new Error("--night and --misses only apply to memory exam.");
+    }
     if (values.flags.has("--file") && action !== "save" && action !== "update") {
         throw new Error("--file only applies to memory save and memory update.");
     }
@@ -187,11 +224,40 @@ export function parseMemoryStoreArgs(action, args) {
         const query = rest.join(" ").trim();
         if (!query)
             throw new Error("memory search needs a question, e.g. `cockpit memory search \"pagination rule\"`.");
-        return { ...command, action, query, limit: readLimit(values.flags.get("--limit")), includeRecent: !values.booleans.has("--no-recent") };
+        // BLI-19246: both flags absent leaves the choice to the door (exact-detail questions reach the originals).
+        const includeOriginals = values.booleans.has("--include-originals") ? true : values.booleans.has("--no-originals") ? false : undefined;
+        // BLI-19255: the raw source behind the top hits; absent lets the door decide by the question.
+        const includeSource = values.booleans.has("--include-source") ? true : values.booleans.has("--no-source") ? false : undefined;
+        return {
+            ...command, action, query, limit: readLimit(values.flags.get("--limit")), includeRecent: !values.booleans.has("--no-recent"),
+            ...(includeOriginals === undefined ? {} : { includeOriginals }),
+            ...(includeSource === undefined ? {} : { includeSource }),
+        };
     }
     if (action === "consolidation") {
         return { ...command, action };
     }
+    if (action === "exam") {
+        if (rest.length > 0)
+            throw new Error("memory exam takes no words: `cockpit memory exam [--night <YYYY-MM-DD>] [--misses] [--json]`.");
+        const night = optionalNonEmpty(values.flags.get("--night"));
+        if (night && !/^\d{4}-\d{2}-\d{2}$/.test(night))
+            throw new Error("--night must be a date like 2026-10-14.");
+        return { ...command, action, ...(night ? { night } : {}), misses: values.booleans.has("--misses") };
+    }
+    if (action === "source") {
+        // BLI-19255: one memory, named by the id `cockpit memory search` printed; `--query` steers which part of the source.
+        const memoryId = optionalNonEmpty(rest[0]);
+        if (!memoryId)
+            throw new Error("memory source needs the memory id `cockpit memory search` printed.");
+        if (rest.length > 1)
+            throw new Error("memory source takes one id.");
+        const rawChars = values.flags.get("--chars");
+        const chars = rawChars === undefined ? undefined : Number(rawChars);
+        if (chars !== undefined && (!Number.isInteger(chars) || chars < 200 || chars > 6000))
+            throw new Error("--chars is a whole number from 200 to 6000.");
+        return { ...command, action, memoryId, ...(values.flags.get("--query") ? { sourceQuery: values.flags.get("--query") } : {}), ...(chars === undefined ? {} : { sourceChars: chars }) };
+    }
     if (action === "private" || action === "public" || action === "chain") {
         // BLI-12927: one memory, named by the id `cockpit memory search` printed.
         const memoryId = optionalNonEmpty(rest[0]);

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-args-tower-pages.js

@@ -200,6 +200,7 @@ const NOTES_ACTIONS = new Set([
     "paste",
     "share",
     "unshare",
+    "summarize",
     "move",
     "place",
     // BLI-4383: the notetaker a person connects, and the meetings it records.
@@ -223,6 +224,7 @@ const NOTES_ACTIONS_NEEDING_A_NOTE = new Set([
     "show",
     "share",
     "unshare",
+    "summarize",
     "move",
     "place",
     // BLI-12926: `recordings` names the note, `recording` names the recording.
@@ -299,7 +301,7 @@ export function parseNotesArgs(args) {
     const first = values.positionals[0];
     const action = (first === undefined ? "list" : first);
     if (!NOTES_ACTIONS.has(action)) {
-        throw new Error(`Unknown notes command: ${first}. Try list, show, shelf, shelves, upload, paste, share, unshare, move, place, accounts, connect, detach, sync, sync-status, recordings, recording, webhook, granola-status, or transcription-stats.`);
+        throw new Error(`Unknown notes command: ${first}. Try list, show, shelf, shelves, upload, paste, share, unshare, summarize, move, place, accounts, connect, detach, sync, sync-status, recordings, recording, webhook, granola-status, or transcription-stats.`);
     }
     const rest = values.positionals.slice(first === undefined ? 0 : 1);
     const json = values.booleans.has("--json");

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

@@ -0,0 +1,25 @@
+/**
+ * `cockpit people` argument parsing (ticket 19252).
+ *
+ *   cockpit people show [<person>] [--json]
+ *
+ * The owner-only people models: one profile per principal and teammate. Reads `GET /api/people` with this machine's
+ * device token; only the company owner (and the owner's own owner-scoped brain token) is answered. A name of several
+ * words needs no quotes. No person lists everyone with a profile.
+ */
+import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+export function parsePeopleArgs(args) {
+    const values = parseNamedArgs(args, { allowedFlags: ["--home", "--dashboard-url", "--json"], valueFlags: ["--home", "--dashboard-url"] });
+    const [action, ...rest] = values.positionals;
+    if (action !== "show")
+        throw new Error("people takes one verb: `show`. Example: `cockpit people show` or `cockpit people show Ada Lovelace`.");
+    const person = optionalNonEmpty(rest.join(" ").trim());
+    return {
+        kind: "people",
+        action: "show",
+        ...(person ? { person } : {}),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        json: values.booleans.has("--json"),
+    };
+}

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

@@ -1,8 +1,8 @@
 import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
 export function parseUsageArgs(args) {
-    const values = parseNamedArgs(args, { allowedFlags: ["--by-task", "--task", "--by-subject", "--subject", "--tool", "--cursor", "--limit", "--repo", "--session", "--from-window", "--min-confidence", "--by-topic", "--by-repo", "--person", "--all", "--since", "--until", "--include-automated", "--detail", "--home", "--dashboard-url", "--json"], valueFlags: ["--task", "--subject", "--tool", "--cursor", "--limit", "--repo", "--session", "--from-window", "--min-confidence", "--person", "--since", "--until", "--home", "--dashboard-url"] });
-    if (["--by-task", "--by-repo", "--by-topic", "--by-subject"].filter(flag => values.booleans.has(flag)).length > 1)
-        throw new Error("--by-repo and --by-topic cannot be used together or with --by-subject or --by-task.");
+    const values = parseNamedArgs(args, { allowedFlags: ["--by-client", "--by-task", "--task", "--by-subject", "--subject", "--tool", "--cursor", "--limit", "--repo", "--session", "--from-window", "--min-confidence", "--by-topic", "--by-repo", "--person", "--all", "--since", "--until", "--include-automated", "--detail", "--home", "--dashboard-url", "--json"], valueFlags: ["--task", "--subject", "--tool", "--cursor", "--limit", "--repo", "--session", "--from-window", "--min-confidence", "--person", "--since", "--until", "--home", "--dashboard-url"] });
+    if (["--by-task", "--by-repo", "--by-topic", "--by-subject", "--by-client"].filter(flag => values.booleans.has(flag)).length > 1)
+        throw new Error("--by-repo and --by-topic cannot be used together or with --by-subject, --by-task or --by-client.");
     const minConfidence = values.flags.get("--min-confidence");
     if (minConfidence !== undefined && !["high", "medium", "low"].includes(minConfidence))
         throw new Error("--min-confidence accepts high, medium or low.");
@@ -11,5 +11,5 @@ export function parseUsageArgs(args) {
         throw new Error("usage takes people, sessions or session <id>.");
     if (action === "session" && !values.positionals[1])
         throw new Error("usage session requires an id.");
-    return { byTask: values.booleans.has("--by-task"), task: optionalNonEmpty(values.flags.get("--task")), bySubject: values.booleans.has("--by-subject"), subject: optionalNonEmpty(values.flags.get("--subject")), repo: optionalNonEmpty(values.flags.get("--repo")), tool: optionalNonEmpty(values.flags.get("--tool")), cursor: optionalNonEmpty(values.flags.get("--cursor")), limit: optionalNonEmpty(values.flags.get("--limit")), session: action === "session" ? values.positionals[1] : optionalNonEmpty(values.flags.get("--session")), fromWindow: optionalNonEmpty(values.flags.get("--from-window")), kind: "usage", ...(minConfidence ? { minConfidence: minConfidence } : {}), byTopic: values.booleans.has("--by-topic"), byRepo: values.booleans.has("--by-repo"), person: optionalNonEmpty(values.flags.get("--person")), all: values.booleans.has("--all"), action: (action === "session" ? "sessions" : action), since: optionalNonEmpty(values.flags.get("--since")) ?? "30d", until: optionalNonEmpty(values.flags.get("--until")), detail: values.booleans.has("--detail"), includeAutomated: values.booleans.has("--include-automated"), homeDir: optionalNonEmpty(values.flags.get("--home")), dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")), json: values.booleans.has("--json") };
+    return { byTask: values.booleans.has("--by-task"), task: optionalNonEmpty(values.flags.get("--task")), bySubject: values.booleans.has("--by-subject"), subject: optionalNonEmpty(values.flags.get("--subject")), repo: optionalNonEmpty(values.flags.get("--repo")), tool: optionalNonEmpty(values.flags.get("--tool")), cursor: optionalNonEmpty(values.flags.get("--cursor")), limit: optionalNonEmpty(values.flags.get("--limit")), session: action === "session" ? values.positionals[1] : optionalNonEmpty(values.flags.get("--session")), fromWindow: optionalNonEmpty(values.flags.get("--from-window")), kind: "usage", ...(minConfidence ? { minConfidence: minConfidence } : {}), byTopic: values.booleans.has("--by-topic"), byRepo: values.booleans.has("--by-repo"), byClient: values.booleans.has("--by-client"), person: optionalNonEmpty(values.flags.get("--person")), all: values.booleans.has("--all"), action: (action === "session" ? "sessions" : action), since: optionalNonEmpty(values.flags.get("--since")) ?? "30d", until: optionalNonEmpty(values.flags.get("--until")), detail: values.booleans.has("--detail"), includeAutomated: values.booleans.has("--include-automated"), homeDir: optionalNonEmpty(values.flags.get("--home")), dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")), json: values.booleans.has("--json") };
 }

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

@@ -0,0 +1,36 @@
+/**
+ * `cockpit who` argument parsing (ticket 19251).
+ *
+ *   cockpit who [<topic>] [--layer frontend|backend|data|infrastructure|docs|tooling] [--limit <1-10>] [--json]
+ *
+ * Who knows what: the ranked owners of a project, a layer or a category, with the evidence counts behind each.
+ * Reads `GET /api/who` with this machine's device token. A topic of several words needs no quotes.
+ */
+import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+/** The layers the directory ranks; `general` is a label for "none of these" and owns nothing. */
+export const WHO_LAYERS = ["frontend", "backend", "data", "infrastructure", "docs", "tooling"];
+export function parseWhoArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--layer", "--limit", "--home", "--dashboard-url", "--json"],
+        valueFlags: ["--layer", "--limit", "--home", "--dashboard-url"],
+    });
+    const topic = optionalNonEmpty(values.positionals.join(" ").trim());
+    const layer = optionalNonEmpty(values.flags.get("--layer"))?.toLowerCase();
+    if (layer && !WHO_LAYERS.includes(layer))
+        throw new Error(`--layer wants one of ${WHO_LAYERS.join(", ")}.`);
+    const rawLimit = optionalNonEmpty(values.flags.get("--limit"));
+    const limit = rawLimit === undefined ? undefined : Number(rawLimit);
+    if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 10))
+        throw new Error("--limit wants a whole number from 1 to 10.");
+    if (layer && !topic)
+        throw new Error("--layer needs a topic: `cockpit who Tower --layer backend`.");
+    return {
+        kind: "who",
+        ...(topic ? { topic } : {}),
+        ...(layer ? { layer } : {}),
+        ...(limit ? { limit } : {}),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        json: values.booleans.has("--json"),
+    };
+}

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

@@ -42,9 +42,16 @@ export { parseSpeedArgs } from "./local-args-tower-speed.js";
 export { parseUsageArgs } from "./local-args-tower-usage.js";
 export { parseLogsArgs } from "./local-args-tower-logs.js";
 export { parseBrainArgs } from "./local-args-tower-brain.js";
+export { parseHitsArgs } from "./local-args-tower-hits.js";
+export { parseIntentionsArgs } from "./local-args-tower-intentions.js";
+export { parseWhoArgs } from "./local-args-tower-who.js";
+export { parsePeopleArgs } from "./local-args-tower-people.js";
 export { parseApprovalsArgs } from "./local-args-tower-approvals.js";
+export { parseDrillsArgs } from "./local-args-tower-drills.js";
 export { parseManagerArgs } from "./local-args-tower-manager.js";
 export { parseImageArgs } from "./local-args-tower-image.js";
 export { parseCareersArgs } from './local-args-tower-careers.js';
 export { parseRenameArgs } from './local-args-tower-rename.js';
-export { parseGlossaryArgs } from "./glossary.js";
+export { parseGlossaryArgs } from "./glossary.js";
+export { parseSpendArgs } from "./spend.js";
+export { parseCiArgs } from "./ci.js";

package/dist/commands/local-args.js

@@ -16,10 +16,11 @@
  * verbatim, no logic change.
  */
 import { parseGlossaryArgs } from "./glossary.js";
+import { parseSpendArgs } from "./spend.js";
 import { parseRootsArgs } from "./roots.js";
 import { SURFACE_ALIASES } from "./local-help.js";
 import { parseAgentRulesArgs, parseAnalyzeArgs, parseAutostartArgs, parseBackfillArgs, parseCleanArgs, parseDoctorArgs, parseInstallArgs, parseLoginArgs, parseMemoryArgs, parseLogoutArgs, parseOnboardArgs, parseReleaseArgs, parseServeArgs, parseSessionsArgs, parseSourcesArgs, parseStartArgs, parseStatusArgs, parseSyncArgs, parseUpdateArgs, } from "./local-args-collector.js";
-import { parseBriefArgs, parseCorrectArgs, parseDocsArgs, parseIssueArgs, parseJarvisArgs, parseMailArgs, parseCalArgs, parseModelArgs, parseMsgArgs, parseNotesArgs, parseOpsArgs, parseProjectArgs, parseModelsArgs, parseScoutArgs, parseGithubArgs, parseSearchArgs, parseSettingsArgs, parseSlackArgs, parseTeamArgs, parseWorkbookArgs, parseUsageArgs, parseSetupArgs, parseSpeedArgs, parseLogsArgs, parseBrainArgs, parseApprovalsArgs, parseManagerArgs, parseImageArgs, parseCareersArgs, parseRenameArgs, } from "./local-args-tower.js";
+import { parseCiArgs, parseBriefArgs, parseCorrectArgs, parseDocsArgs, parseIssueArgs, parseJarvisArgs, parseMailArgs, parseCalArgs, parseModelArgs, parseMsgArgs, parseNotesArgs, parseOpsArgs, parseProjectArgs, parseModelsArgs, parseScoutArgs, parseGithubArgs, parseSearchArgs, parseSettingsArgs, parseSlackArgs, parseTeamArgs, parseWorkbookArgs, parseUsageArgs, parseSetupArgs, parseSpeedArgs, parseLogsArgs, parseBrainArgs, parseHitsArgs, parseIntentionsArgs, parseWhoArgs, parsePeopleArgs, parseApprovalsArgs, parseDrillsArgs, parseManagerArgs, parseImageArgs, parseCareersArgs, parseRenameArgs, } from "./local-args-tower.js";
 // `normalizeUrl` has always been part of this module's surface — `local.ts` and
 // `local-auth.ts` import it from here — so it stays exported from this address
 // even though it now lives next door. The same goes for the four names the
@@ -76,6 +77,7 @@ export function parseLocalArgs(argv) {
             return parseModelsArgs(argv.slice(1));
         case "scout":
             return parseScoutArgs(argv.slice(1));
+        case "ci": return parseCiArgs(argv.slice(1));
         case "ops":
             return parseOpsArgs(argv.slice(1));
         case "slack":
@@ -112,6 +114,8 @@ export function parseLocalArgs(argv) {
             return parseSourcesArgs(argv.slice(1));
         case "glossary":
             return parseGlossaryArgs(argv.slice(1));
+        case "spend":
+            return parseSpendArgs(argv.slice(1));
         case "docs":
             return parseDocsArgs(argv.slice(1));
         case "msg":
@@ -144,8 +148,18 @@ export function parseLocalArgs(argv) {
             return parseLogsArgs(argv.slice(1));
         case "brain":
             return parseBrainArgs(argv.slice(1));
+        case "hits":
+            return parseHitsArgs(argv.slice(1));
+        case "intentions":
+            return parseIntentionsArgs(argv.slice(1));
+        case "who":
+            return parseWhoArgs(argv.slice(1));
+        case "people":
+            return parsePeopleArgs(argv.slice(1));
         case "approvals":
             return parseApprovalsArgs(argv.slice(1));
+        case "drills":
+            return parseDrillsArgs(argv.slice(1));
         case "manager":
             return parseManagerArgs(argv.slice(1));
         case "image":

package/dist/commands/local-command-shapes-auth.js

@@ -0,0 +1 @@
+export {};

package/dist/commands/local-command-shapes-drills.js

@@ -0,0 +1,7 @@
+/**
+ * `cockpit drills` command shape (BLI-19259), beside `local-command-shapes-approvals.ts` for the same reason:
+ * `local-command-shapes.ts` sits at the readability ceiling.
+ *
+ * `theme set` is typed as two words and parsed to ONE action word (`theme-set`), the way `rules create` becomes `rules-create`.
+ */
+export {};

package/dist/commands/local-command-shapes-hits.js

@@ -0,0 +1,5 @@
+/**
+ * `cockpit hits` command shape (BLI-19257), beside `local-command-shapes-brain.ts` for the same reason:
+ * `local-command-shapes.ts` sits at the readability ceiling.
+ */
+export {};