@bli-cockpit/cli 0.2.111 → 0.2.112

package/dist/commands/agent-session-report.js

@@ -139,6 +139,8 @@ function sessionReportEntry(result, context) {
         ? (context.claudePriorDurablePointers.get(result.session_id) ?? null)
         : null;
     return {
+        ticket_id: context.ticketByWorktree?.get(result.worktree?.worktree_fingerprint ?? "") ?? null,
+        ticket_binding_source: context.ticketByWorktree?.has(result.worktree?.worktree_fingerprint ?? "") ? "explicit_bind" : null,
         codex_session_id: result.session_id,
         source: result.source,
         observed_at: context.now.toISOString(),
@@ -225,6 +227,7 @@ export function buildAgentSessionReport(options) {
     const uploadOutcomes = sessionUploadOutcomesByKey(options.outcomes);
     return [...bestByKey.values()].map((result) => sessionReportEntry(result, {
         ...uploadOutcomes,
+        ticketByWorktree: options.ticketByWorktree,
         claudePriorDurablePointers: options.claudePriorDurablePointers,
         now: options.now,
     }));

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

@@ -1,15 +1,15 @@
 import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
 export function parseUsageArgs(args) {
-    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 values = parseNamedArgs(args, { allowedFlags: ["--by-task", "--task", "--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: ["--task", "--subject", "--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 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 (!["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") };
+    if (action === "sessions" && !values.flags.get("--subject") && !values.flags.get("--session") && !values.flags.get("--task"))
+        throw new Error("usage sessions requires --task, --subject or --session.");
+    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")), 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,8 +143,8 @@ export const TOWER_COMMAND_HELP = [
     [
         "usage",
         [
-            "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]",
+            "Usage: cockpit usage people [--by-repo | --by-topic | --by-subject | --by-task] [--min-confidence high|medium|low] [--person <email|me>] [--all] [--since <n>d|<n>h|<iso>] [--detail] [--until <iso>] [--include-automated] [--json]",
+            "  cockpit usage sessions [--task <BLI-NNNN> | --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.",
             "",

package/dist/commands/local-help.js

@@ -104,10 +104,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 sessions --subject <name> [--repo <label>] [--since <window>] [--json]",
+        "  cockpit usage sessions [--task <BLI-NNNN> | --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]",
+        "  cockpit usage people [--by-repo | --by-topic | --by-subject | --by-task] [--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.111");
+    writeLine(io?.stdout ?? process.stdout, "0.2.112");
     return 0;
   }
 

package/dist/commands/session-sync.js

@@ -1,3 +1,4 @@
+import { readLocalWorkContextForRepo } from "../local-state.js";
 /**
  * One attributed sync pass: scan both session stores, attribute what they hold,
  * upload it through every target worktree, write down what happened, and judge
@@ -91,7 +92,16 @@ export async function runAttributedWorktreeSync(options) {
         plan,
         scan,
     });
+    const ticketByWorktree = new Map();
+    for (const worktree of options.worktrees) {
+        const context = await readLocalWorkContextForRepo(paths, worktree.repo_root).catch(() => null);
+        const ticket = context?.linear_ticket_id ?? context?.active_ticket_id;
+        if (ticket)
+            ticketByWorktree.set(worktree.worktree_fingerprint, ticket);
+    }
+    console.error("[session-sync] bindings read", JSON.stringify({ bound_worktrees: ticketByWorktree.size, reason: "active_work_context" }));
     const sessions = buildAgentSessionReport({
+        ticketByWorktree,
         codexResults: scan.codexAttribution.results,
         claudeResults: scan.claudeAttribution.results,
         outcomes: worktreePass.outcomes,

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.byTask)
+        query.set("groupBy", "ticket");
     if (command.bySubject)
         query.set("groupBy", "topic");
     if (command.minConfidence)
@@ -18,7 +20,7 @@ export async function runUsage(command, io) {
     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]])
+        for (const [key, value] of [["task", command.task], ["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 });
@@ -50,12 +52,14 @@ export async function runUsage(command, io) {
         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 (command.byTask && body.people?.some(person => !Array.isArray(person.tickets)))
+        return failAgentDoor(door, "[usage]", "ticket_grouping_unavailable", "Deploy the dashboard task split before using --by-task.");
     if (door.json)
         return emitAgentDoor(door, body);
     let nameWidth = 20;
-    if (command.byRepo || command.byTopic) {
+    if (command.byTask || command.byRepo || command.byTopic) {
         for (const person of body.people ?? []) {
-            const repos = (command.byTopic ? person.task_types : person.repos) ?? [];
+            const repos = (command.byTask ? person.tickets : command.byTopic ? person.task_types : person.repos) ?? [];
             for (const repo of command.all ? repos : repos.slice(0, 10))
                 nameWidth = Math.max(nameWidth, repo.repo_label.length + 2);
         }
@@ -84,15 +88,17 @@ export async function runUsage(command, io) {
                 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) ?? [];
+        if (command.byTask || command.byRepo || command.byTopic) {
+            const repos = (command.byTask ? row.tickets : command.byTopic ? row.task_types : row.repos) ?? [];
             for (const repo of command.all ? repos : repos.slice(0, 10)) {
+                if (command.byTask)
+                    writeLine(io.stdout, `  ${repo.ticket_title ?? ""} Sources: ${Object.entries(repo.binding_sources ?? {}).map(([source, count]) => `${source} ${count}`).join(", ")}`);
                 if (command.byTopic && repo.confidence)
                     writeLine(io.stdout, `  Confidence: ${repo.confidence.high} high, ${repo.confidence.medium} medium, ${repo.confidence.low} low`);
                 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 ${command.byTopic ? "topics" : "repos"}`);
+                writeLine(io.stdout, `  and ${repos.length - 10} more ${command.byTask ? "tasks" : command.byTopic ? "topics" : "repos"}`);
         }
     }
     writeLine(io.stdout, "");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.111",
+  "version": "0.2.112",
   "private": false,
   "type": "module",
   "bin": {
@@ -27,8 +27,8 @@
     "test": "node dist/cli.js --help && node ../../scripts/assert-public-cli-routing.mjs && node ../../scripts/assert-public-cli-verb-help.mjs && node ../../scripts/assert-public-cli-runtime-files.mjs && node ../../scripts/assert-public-cli-exit-contract.mjs && node ../../scripts/assert-public-cli-no-fleet-posts.mjs && node ../../scripts/assert-public-package-pack.mjs --workspace=@bli-cockpit/cli"
   },
   "dependencies": {
-    "@bli-cockpit/memory-mcp": "0.1.29",
-    "@bli-cockpit/mcp": "0.1.39",
-    "@bli-cockpit/telemetry-core": "0.1.45"
+    "@bli-cockpit/memory-mcp": "0.1.30",
+    "@bli-cockpit/mcp": "0.1.40",
+    "@bli-cockpit/telemetry-core": "0.1.46"
   }
 }