@bli-cockpit/cli 0.2.109 → 0.2.110

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

@@ -1,13 +1,15 @@
 import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
 export function parseUsageArgs(args) {
-    const values = parseNamedArgs(args, { allowedFlags: ["--min-confidence", "--by-topic", "--by-repo", "--person", "--all", "--since", "--until", "--include-automated", "--detail", "--home", "--dashboard-url", "--json"], valueFlags: ["--min-confidence", "--person", "--since", "--until", "--home", "--dashboard-url"] });
-    if (values.booleans.has("--by-repo") && values.booleans.has("--by-topic"))
-        throw new Error("--by-repo and --by-topic cannot be used together.");
+    const values = parseNamedArgs(args, { allowedFlags: ["--by-subject", "--subject", "--repo", "--session", "--from-window", "--min-confidence", "--by-topic", "--by-repo", "--person", "--all", "--since", "--until", "--include-automated", "--detail", "--home", "--dashboard-url", "--json"], valueFlags: ["--subject", "--repo", "--session", "--from-window", "--min-confidence", "--person", "--since", "--until", "--home", "--dashboard-url"] });
+    if (["--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.");
     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.");
     const action = values.positionals[0] ?? "people";
-    if (action !== "people" || values.positionals.length > 1)
-        throw new Error("usage takes one verb: people.");
-    return { 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: "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") };
+    if (!["people", "sessions"].includes(action) || values.positionals.length > 1)
+        throw new Error("usage takes people or sessions.");
+    if (action === "sessions" && !values.flags.get("--subject") && !values.flags.get("--session"))
+        throw new Error("usage sessions requires --subject or --session.");
+    return { bySubject: values.booleans.has("--by-subject"), subject: optionalNonEmpty(values.flags.get("--subject")), repo: optionalNonEmpty(values.flags.get("--repo")), session: 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, 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,7 +143,10 @@ export const TOWER_COMMAND_HELP = [
     [
         "usage",
         [
-            "Usage: cockpit usage people [--by-repo | --by-topic] [--min-confidence high|medium|low] [--person <email|me>] [--all] [--since <n>d|<n>h|<iso>] [--detail] [--until <iso>] [--include-automated] [--json]",
+            "Usage: cockpit usage people [--by-repo | --by-topic | --by-subject] [--min-confidence high|medium|low] [--person <email|me>] [--all] [--since <n>d|<n>h|<iso>] [--detail] [--until <iso>] [--include-automated] [--json]",
+            "  cockpit usage sessions --subject <name> [--repo <label>] [--since <window>] [--json]",
+            "  cockpit usage sessions --session <id> [--from-window <n>] [--json]",
+            "  --by-topic groups work types; --by-subject groups open subjects from session summaries.",
             "",
             "--by-topic adds topic rows, including (unlabelled). Choose only one grouping. --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,",

package/dist/commands/local-help.js

@@ -102,7 +102,10 @@ 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 [--by-repo | --by-topic] [--min-confidence high|medium|low] [--person <email|me>] [--all] [--detail] [--since <n>d|<n>h|<iso>] [--until <iso>] [--include-automated] [--dashboard-url <url>] [--json]",
+        "  cockpit usage sessions --subject <name> [--repo <label>] [--since <window>] [--json]",
+        "  cockpit usage sessions --session <id> [--from-window <n>] [--json]",
+        "  --by-topic groups work types; --by-subject groups open subjects from session summaries.",
+        "  cockpit usage people [--by-repo | --by-topic | --by-subject] [--min-confidence high|medium|low] [--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.109");
+    writeLine(io?.stdout ?? process.stdout, "0.2.110");
     return 0;
   }
 

package/dist/commands/usage.js

@@ -5,6 +5,8 @@ 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.bySubject)
+        query.set("groupBy", "topic");
     if (command.minConfidence)
         query.set("minConfidence", command.minConfidence);
     if (command.byTopic)
@@ -15,6 +17,21 @@ export async function runUsage(command, io) {
         query.set("until", command.until);
     if (command.includeAutomated)
         query.set("include_automated", "1");
+    if (command.action === "sessions") {
+        for (const [key, value] of [["subject", command.subject], ["repo", command.repo], ["session", command.session], ["fromWindow", command.fromWindow]])
+            if (value)
+                query.set(key, value);
+        const response = await askAgentDoor(door, { path: `/api/usage/sessions?${query}`, method: "GET", label: "usage sessions", timeoutMs: 30_000 });
+        if (!response.ok)
+            return failAgentDoor(door, "[usage]", response.reason, response.detail);
+        if (door.json || command.session)
+            return emitAgentDoor(door, response.body);
+        const sessions = response.body.sessions ?? [];
+        for (const session of sessions)
+            writeLine(io.stdout, `${session.session_id}  ${formatCount(session.tokens)}  ${session.task_type}  ${session.title}`);
+        writeLine(io.stdout, `${sessions.length} sessions`);
+        return 0;
+    }
     const answer = await askAgentDoor(door, { path: `/api/usage/people?${query}`, method: "GET", label: "usage people", timeoutMs: 30_000 });
     if (!answer.ok)
         return failAgentDoor(door, "[usage]", answer.reason, answer.detail);
@@ -31,6 +48,8 @@ export async function runUsage(command, io) {
     }
     if (command.byTopic && body.people?.some((person) => !Array.isArray(person.task_types)))
         return failAgentDoor(door, "[usage]", "topic_grouping_unavailable", "The dashboard returned person totals without topic rows. Deploy the dashboard topic split before using --by-topic.");
+    if (command.bySubject && body.people?.some(person => !Array.isArray(person.subjects)))
+        return failAgentDoor(door, "[usage]", "subject_grouping_unavailable", "Deploy the dashboard subject split before using --by-subject.");
     if (door.json)
         return emitAgentDoor(door, body);
     let nameWidth = 20;
@@ -41,6 +60,13 @@ export async function runUsage(command, io) {
                 nameWidth = Math.max(nameWidth, repo.repo_label.length + 2);
         }
     }
+    if (command.bySubject)
+        for (const person of body.people ?? [])
+            for (const subject of person.subjects ?? []) {
+                nameWidth = Math.max(nameWidth, subject.repo_label.length + subject.topic.length + 5);
+                for (const sub of subject.children ?? [])
+                    nameWidth = Math.max(nameWidth, sub.subtopic.length + 4);
+            }
     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"] : [])]);
@@ -52,6 +78,12 @@ 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.bySubject)
+            for (const subject of row.subjects ?? []) {
+                printRow([`  ${subject.repo_label} / ${subject.topic}`, formatCount(subject.tokens), formatUsageDollars(subject.api_list_price_equivalent_usd), `${subject.extracted_sessions}/${subject.sessions}`, ...(command.detail ? [subject.output, subject.input, subject.cache_read, subject.cache_creation].map(formatCount) : [])]);
+                for (const sub of subject.children ?? [])
+                    printRow([`    ${sub.subtopic}`, formatCount(sub.tokens), formatUsageDollars(sub.api_list_price_equivalent_usd), `${sub.extracted_sessions}/${sub.sessions}`, ...(command.detail ? [sub.output, sub.input, sub.cache_read, sub.cache_creation].map(formatCount) : [])]);
+            }
         if (command.byRepo || command.byTopic) {
             const repos = (command.byTopic ? row.task_types : row.repos) ?? [];
             for (const repo of command.all ? repos : repos.slice(0, 10)) {
@@ -66,6 +98,8 @@ export async function runUsage(command, io) {
     writeLine(io.stdout, "");
     writeLine(io.stdout, body.api_list_price_equivalent_label ?? "API list-price equivalent (not actual spend)");
     writeLine(io.stdout, `${body.coverage?.sessions_extracted ?? 0} of ${body.coverage?.sessions_observed ?? 0} sessions extracted`);
+    if (command.bySubject)
+        writeLine(io.stdout, `${(body.people ?? []).reduce((n, person) => n + (person.sessions_summarized ?? 0), 0)} of ${body.coverage?.sessions_observed ?? 0} sessions summarized`);
     if (command.byTopic)
         writeLine(io.stdout, `${body.coverage?.sessions_labelled ?? 0} of ${body.coverage?.sessions_observed ?? 0} sessions labelled by topic`);
     return 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.109",
+  "version": "0.2.110",
   "private": false,
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@bli-cockpit/memory-mcp": "0.1.28",
-    "@bli-cockpit/mcp": "0.1.37",
+    "@bli-cockpit/mcp": "0.1.38",
     "@bli-cockpit/telemetry-core": "0.1.44"
   }
 }