@bli-cockpit/cli 0.2.103 → 0.2.104

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: ["--since", "--until", "--include-automated", "--detail", "--home", "--dashboard-url", "--json"], valueFlags: ["--since", "--until", "--home", "--dashboard-url"] });
+    const values = parseNamedArgs(args, { allowedFlags: ["--by-repo", "--person", "--all", "--since", "--until", "--include-automated", "--detail", "--home", "--dashboard-url", "--json"], valueFlags: ["--person", "--since", "--until", "--home", "--dashboard-url"] });
     const action = values.positionals[0] ?? "people";
     if (action !== "people" || values.positionals.length > 1)
         throw new Error("usage takes one verb: people.");
-    return { kind: "usage", action: "people", 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 { kind: "usage", byRepo: values.booleans.has("--by-repo"), person: optionalNonEmpty(values.flags.get("--person")), all: values.booleans.has("--all"), action: "people", 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-help-commands-tower.js

@@ -143,8 +143,9 @@ export const TOWER_COMMAND_HELP = [
     [
         "usage",
         [
-            "Usage: cockpit usage people [--since <n>d|<n>h|<iso>] [--detail] [--until <iso>] [--include-automated] [--json]",
+            "Usage: cockpit usage people [--by-repo] [--person <email|me>] [--all] [--since <n>d|<n>h|<iso>] [--detail] [--until <iso>] [--include-automated] [--json]",
             "",
+            "--by-repo adds project rows under each person (top 10; --all shows every repo). --person me uses your signed-in email.",
             "Claude Code and Codex usage per person: sessions observed and extracted, tokens (total, output,",
             "and the input / cache split when the row carries it), and an API list-price equivalent that is",
             "labelled as such and is never actual spend. A super_admin sees everyone; a member sees their own row.",

package/dist/commands/local-help.js

@@ -102,7 +102,7 @@ export function localCommandHelp(command) {
         `  cockpit search "<words>" [--kind ${SEARCH_KINDS.join(",")}] [--limit <n>] [--dashboard-url <url>] [--json]`,
         "  cockpit release [--dry-run] [--skip-checks] [--no-floor] [--tag <tag>] [--access <public|restricted>] [--otp <code>]",
         "  cockpit careers [list|show <id>|rescreen <id>] [--role <slug>] [--min-score <n>] [--since <date>] [--json]",
-        "  cockpit usage people [--since 30d|<iso>] [--until <iso>] [--include-automated] [--dashboard-url <url>] [--json]",
+        "  cockpit usage people [--by-repo] [--person <email|me>] [--all] [--detail] [--since <n>d|<n>h|<iso>] [--until <iso>] [--include-automated] [--dashboard-url <url>] [--json]",
         "",
         `Default dashboard: ${DEFAULT_DASHBOARD_URL}. Omit --dashboard-url for normal production use; pass it only for staging/custom dashboards or to force a different pairing.`,
     ].join("\n");

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.103");
+    writeLine(io?.stdout ?? process.stdout, "0.2.104");
     return 0;
   }
 

package/dist/commands/usage-format.js

@@ -12,6 +12,8 @@ export function formatCount(value) {
     return String(value);
 }
 export function formatUsageDollars(value) {
+    if (value === null)
+        return "Unavailable";
     return new Intl.NumberFormat("en-US", {
         style: "currency", currency: "USD", maximumFractionDigits: 0,
     }).format(value);

package/dist/commands/usage.js

@@ -1,9 +1,12 @@
+import { loadPairedSession } from "../tower-client.js";
 import { formatCount, formatUsageDollars } from "./usage-format.js";
 import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor } from "./agent-door.js";
 import { writeLine } from "./cli-io.js";
 export async function runUsage(command, io) {
     const door = await openAgentDoor("usage", command, io);
     const query = new URLSearchParams({ since: command.since });
+    if (command.byRepo)
+        query.set("groupBy", "repo");
     if (command.until)
         query.set("until", command.until);
     if (command.includeAutomated)
@@ -12,9 +15,27 @@ export async function runUsage(command, io) {
     if (!answer.ok)
         return failAgentDoor(door, "[usage]", answer.reason, answer.detail);
     const body = answer.body;
+    if (command.person) {
+        const email = command.person === "me" ? (await loadPairedSession("usage", command.homeDir)).email : command.person;
+        if (!email)
+            return failAgentDoor(door, "[usage]", "caller_email_unavailable", "The paired session has no email. Sign in again or pass --person <email>.");
+        body.people = (body.people ?? []).filter((person) => person.email?.toLowerCase() === email.toLowerCase());
+        body.coverage = { sessions_extracted: body.people.reduce((total, person) => total + person.sessions_extracted, 0), sessions_observed: body.people.reduce((total, person) => total + person.sessions_observed, 0) };
+    }
+    if (command.byRepo && body.people?.some((person) => !Array.isArray(person.repos))) {
+        return failAgentDoor(door, "[usage]", "repo_grouping_unavailable", "The dashboard returned person totals without project rows. Deploy the dashboard project split before using --by-repo.");
+    }
     if (door.json)
         return emitAgentDoor(door, body);
-    const widths = [20, 8, 15, 12, 10, 10, 12, 14];
+    let nameWidth = 20;
+    if (command.byRepo) {
+        for (const person of body.people ?? []) {
+            const repos = person.repos ?? [];
+            for (const repo of command.all ? repos : repos.slice(0, 10))
+                nameWidth = Math.max(nameWidth, repo.repo_label.length + 2);
+        }
+    }
+    const widths = [nameWidth, 8, 15, 12, 10, 10, 12, 14];
     const printRow = (cells) => writeLine(io.stdout, cells.map((cell, index) => index === 0 ? cell.padEnd(widths[index]) : cell.padStart(widths[index])).join("  ").trimEnd());
     printRow(["Person", "Tokens", "List equivalent", "Coverage", ...(command.detail ? ["Output", "Input", "Cache read", "Cache creation"] : [])]);
     for (const row of body.people ?? []) {
@@ -25,6 +46,14 @@ export async function runUsage(command, io) {
             `${row.sessions_extracted}/${row.sessions_observed}`,
             ...(command.detail ? [row.output_tokens, row.input_tokens, row.cache_read_input_tokens, row.cache_creation_input_tokens].map(formatCount) : []),
         ]);
+        if (command.byRepo) {
+            const repos = row.repos ?? [];
+            for (const repo of command.all ? repos : repos.slice(0, 10)) {
+                printRow([`  ${repo.repo_label}`, formatCount(repo.tokens), formatUsageDollars(repo.api_list_price_equivalent_usd), `${repo.extracted_sessions}/${repo.sessions}`, ...(command.detail ? [repo.output, repo.input, repo.cache_read, repo.cache_creation].map(formatCount) : [])]);
+            }
+            if (!command.all && repos.length > 10)
+                writeLine(io.stdout, `  and ${repos.length - 10} more repos`);
+        }
     }
     writeLine(io.stdout, "");
     writeLine(io.stdout, body.api_list_price_equivalent_label ?? "API list-price equivalent (not actual spend)");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.103",
+  "version": "0.2.104",
   "private": false,
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@bli-cockpit/memory-mcp": "0.1.27",
-    "@bli-cockpit/mcp": "0.1.33",
+    "@bli-cockpit/mcp": "0.1.34",
     "@bli-cockpit/telemetry-core": "0.1.43"
   }
 }