@bli-cockpit/cli 0.2.144 → 0.2.145

package/dist/agent-rules-claude-fold.js

@@ -0,0 +1,30 @@
+/**
+ * Whether CLAUDE.md already gets the Tower agent rules for free through its
+ * `@~/.codex/AGENTS.md` include line, so the installer should not duplicate
+ * the managed block there too.
+ *
+ * BLI-10574: `~/.claude/CLAUDE.md` commonly reads
+ * "Shared rules for every agent: `~/.codex/AGENTS.md` ... @~/.codex/AGENTS.md"
+ * — Claude loads the codex file wholesale. When that include line is present
+ * AND codex is part of the same install/inspect call, writing our block into
+ * CLAUDE.md too is pure duplication: Claude already reads it via the include,
+ * and a second copy only goes stale on its own schedule.
+ */
+import path from "node:path";
+export function claudeFoldsIntoCodexInclude(host, hostsInCall, claudeFileContents, homeDir) {
+    if (host !== "claude")
+        return false;
+    if (!hostsInCall.includes("codex"))
+        return false;
+    return includesCodexAgentsInclude(claudeFileContents, homeDir);
+}
+function includesCodexAgentsInclude(contents, homeDir) {
+    if (!contents.trim())
+        return false;
+    const absoluteCodexAgentsFile = path.join(homeDir, ".codex", "AGENTS.md");
+    const pattern = new RegExp(`^\\s*@(?:~/\\.codex/AGENTS\\.md|${escapeRegExp(absoluteCodexAgentsFile)})\\s*$`, "mu");
+    return pattern.test(contents);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}

package/dist/agent-rules-unmanaged-block.js

@@ -1,12 +1,19 @@
 /**
- * A ticket-binding section somebody wrote by hand, and whether it already says
- * what our managed block says.
+ * A Tower-agent-rules section somebody wrote by hand, and whether it already
+ * says what our managed block says.
  *
  * Split out of agent-rules.ts (BLI-10108), which writes the block; this file
  * only READS what is already in a person's rules file and answers two
  * questions: is this good enough to leave alone (`equivalent`), or is it the
  * older vocabulary we should replace (`stale`)?
  *
+ * BLI-10574 replaced the block's ticket-binding-only text with a "Tower
+ * first" mentality (in-house tools before Linear/Notion/Google) folded into
+ * one scope+binding line. The equivalence check below reads for THAT shape;
+ * a hand-typed section still carrying the older "search Linear"/"cockpit
+ * sync" vocabulary no longer counts as equivalent — it is stale and gets
+ * replaced, same as any other superseded wording.
+ *
  * The matching is deliberately loose. These sections were typed by people and
  * by other agents over months, so the test is a handful of cues plus a score,
  * not equality, and every cue is lowercased, unquoted and whitespace-flattened
@@ -17,12 +24,12 @@ export function hasEquivalentUnmanagedTicketBinding(contents, scopePaths = []) {
     const text = normalizeRuleText(contents);
     if (!hasTicketBindingCues(text))
         return false;
+    if (!hasTowerFirstCue(text))
+        return false;
     if (!hasRepoScopeGuard(text))
         return false;
     if (scopePaths.some((scopePath) => !hasScopePath(text, scopePath)))
         return false;
-    if (!hasTicketLookupOrCreationCue(text))
-        return false;
     // Contents without the QA-receipts rule are the older vocabulary and must
     // read as stale — otherwise machines with a hand-written ticket-binding
     // section never receive the definition-of-done rule.
@@ -30,33 +37,30 @@ export function hasEquivalentUnmanagedTicketBinding(contents, scopePaths = []) {
         return false;
     const signals = [
         /cockpit\s+start\s+--ticket\b/u,
-        /before\s+(?:the\s+)?first\s+code\s+edit|before\s+ticketed\s+implementation/u,
-        /general\s+ambient/u,
-        /cockpit\s+sync\s+--repo|cockpit\s+sync\s+--workspace|fresh\s+ticket\/session\s+binding\s+metadata/u,
-        /use\s+--ticket|the\s+flag\s+is\s+--ticket|do\s+not\s+invent\s+--ticketid/u,
+        /before\s+the\s+first\s+edit\b/u,
+        /cockpit\s+doctor\s+repairs\s+the\s+machine\b/u,
+        /file\s+a\s+tower\s+ticket\s+and\s+get\s+it\s+fixed\b/u,
     ];
     const score = signals.filter((signal) => signal.test(text)).length;
-    return score >= 4;
+    return score >= 3;
 }
 function hasQaReceiptsCue(text) {
     return /computer-use\s+qa\s+pass/u.test(text)
         && /receipts/u.test(text);
 }
-function hasTicketLookupOrCreationCue(text) {
-    return /search\s+linear|create\s+(?:a\s+)?(?:narrow\s+)?linear\s+ticket|new\s+linear\s+ticket/u.test(text);
+function hasTowerFirstCue(text) {
+    return /we\s+build\s+tower.*use\s+it\s+first/u.test(text) || /tower\s+first/u.test(text);
 }
 function hasScopePath(text, scopePath) {
     return text.includes(normalizeRuleText(path.resolve(scopePath)));
 }
 function hasRepoScopeGuard(text) {
-    return (/only\s+applies\s+when\s+the\s+current\s+working\s+directory\s+is\s+inside/u.test(text) ||
-        /outside\s+that\s+(?:folder|workspace|repo).*(?:do\s+not|dont)\s+run\s+cockpit/u.test(text) ||
-        /private\s+chats\s+or\s+unrelated\s+repos/u.test(text));
+    return /only:\s*bind\s+ticketed\s+work\s+before\s+the\s+first\s+edit\b/u.test(text);
 }
 export function findStaleUnmanagedTicketBindingBlock(contents, scopePaths = []) {
     const lines = contents.split("\n");
     for (let index = 0; index < lines.length; index += 1) {
-        if (!/^#{1,6}\s+.*(?:cockpit\s+)?ticket\s+binding\b/iu.test(lines[index] ?? "")) {
+        if (!/^#{1,6}\s+.*(?:(?:cockpit\s+)?ticket\s+binding|tower\s+first)\b/iu.test(lines[index] ?? "")) {
             continue;
         }
         let endLine = lines.length;
@@ -86,7 +90,7 @@ export function replaceLineSpan(contents, startLine, endLine, replacement) {
         .trimEnd() + "\n";
 }
 function hasTicketBindingCues(text) {
-    return /\bcockpit\b/u.test(text) && /\bticket\b/u.test(text) && /binding|agent|linear/u.test(text);
+    return /\bcockpit\b/u.test(text) && /\bticket\b/u.test(text) && /binding|agent|linear|tower|doctor/u.test(text);
 }
 function normalizeRuleText(contents) {
     return contents

package/dist/agent-rules.js

@@ -1,6 +1,7 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
+import { claudeFoldsIntoCodexInclude } from "./agent-rules-claude-fold.js";
 import { findStaleUnmanagedTicketBindingBlock, hasEquivalentUnmanagedTicketBinding, replaceLineSpan, } from "./agent-rules-unmanaged-block.js";
 import { describeError, isMissingFileFailure } from "./health-detail.js";
 const MANAGED_BLOCK_START = "<!-- BLI_COCKPIT_AGENT_RULES:START -->";
@@ -12,11 +13,13 @@ export async function installClaudeAgentRules(options = {}) {
     return installAgentRulesForHost("claude", options);
 }
 export async function installAgentRules(options = {}) {
-    const targets = await Promise.all(targetHosts(options.hosts).map((host) => installAgentRulesForHost(host, options)));
+    const hosts = targetHosts(options.hosts);
+    const targets = await Promise.all(hosts.map((host) => installAgentRulesForHost(host, options, hosts)));
     return aggregateAgentRulesResult(targets);
 }
-async function installAgentRulesForHost(host, options = {}) {
-    const rulesFile = agentRulesFile(host, options.homeDir);
+async function installAgentRulesForHost(host, options = {}, hostsInCall = [host]) {
+    const homeDir = options.homeDir ?? os.homedir();
+    const rulesFile = agentRulesFile(host, homeDir);
     const block = cockpitAgentRulesBlock({
         scopePath: options.scopePath,
         scopePaths: options.scopePaths,
@@ -41,6 +44,9 @@ async function installAgentRulesForHost(host, options = {}) {
         }
         existed = false;
     }
+    if (claudeFoldsIntoCodexInclude(host, hostsInCall, existing, homeDir)) {
+        return foldClaudeIntoCodexInclude(host, rulesFile, existing, block);
+    }
     const prepared = prepareManagedBlockInstall(existing, block, scopePaths);
     if (!prepared.next) {
         return agentRulesResult(host, rulesFile, "unchanged", block, prepared.state);
@@ -53,6 +59,15 @@ async function installAgentRulesForHost(host, options = {}) {
     await writeFile(rulesFile, next, "utf8");
     return agentRulesResult(host, rulesFile, existed ? "updated" : "created", block, "managed", prepared.state === "stale");
 }
+async function foldClaudeIntoCodexInclude(host, rulesFile, existing, block) {
+    if (!hasManagedBlock(existing)) {
+        console.info("[agent-rules] claude rules already covered by codex include, skipping duplicate write", JSON.stringify({ reason: "claude_includes_codex_agents_file", host }));
+        return agentRulesResult(host, rulesFile, "unchanged", block, "included");
+    }
+    await writeFile(rulesFile, removeManagedBlock(existing), "utf8");
+    console.info("[agent-rules] removed a duplicate managed block now covered by the codex include", JSON.stringify({ reason: "claude_includes_codex_agents_file", host }));
+    return agentRulesResult(host, rulesFile, "updated", block, "included");
+}
 export async function uninstallCodexAgentRules(options = {}) {
     return uninstallAgentRulesForHost("codex", options);
 }
@@ -96,14 +111,16 @@ export async function inspectClaudeAgentRules(options = {}) {
     return inspectAgentRulesForHost("claude", options);
 }
 export async function inspectAgentRules(options = {}) {
-    const targets = await Promise.all(targetHosts(options.hosts).map((host) => inspectAgentRulesForHost(host, options)));
+    const hosts = targetHosts(options.hosts);
+    const targets = await Promise.all(hosts.map((host) => inspectAgentRulesForHost(host, options, hosts)));
     return {
         ...aggregateAgentRulesResult(targets),
         installed: targets.every((target) => target.installed),
     };
 }
-async function inspectAgentRulesForHost(host, options = {}) {
-    const rulesFile = agentRulesFile(host, options.homeDir);
+async function inspectAgentRulesForHost(host, options = {}, hostsInCall = [host]) {
+    const homeDir = options.homeDir ?? os.homedir();
+    const rulesFile = agentRulesFile(host, homeDir);
     const block = cockpitAgentRulesBlock({
         scopePath: options.scopePath,
         scopePaths: options.scopePaths,
@@ -129,8 +146,15 @@ async function inspectAgentRulesForHost(host, options = {}) {
             installed: false,
         };
     }
+    if (claudeFoldsIntoCodexInclude(host, hostsInCall, existing, homeDir)) {
+        console.info("[agent-rules] claude rules read as installed via the codex include", JSON.stringify({ reason: "claude_includes_codex_agents_file", host }));
+        return {
+            ...agentRulesResult(host, rulesFile, "unchanged", block, "included"),
+            installed: true,
+        };
+    }
     const state = inspectAgentRulesContents(existing, block, scopePaths);
-    const installed = state === "managed" || state === "equivalent";
+    const installed = state === "managed" || state === "equivalent" || state === "included";
     return {
         ...agentRulesResult(host, rulesFile, installed ? "unchanged" : "missing", block, state),
         installed,
@@ -138,20 +162,17 @@ async function inspectAgentRulesForHost(host, options = {}) {
 }
 export function cockpitAgentRulesBlock(options = {}) {
     const scopePaths = normalizeScopePaths(options);
-    const scopeLine = scopePaths.length === 1
-        ? `- Only applies when the current working directory is inside the Tower-onboarded workspace/repo: \`${scopePaths[0]}\`. Outside that folder, do not run Tower ticket binding or sync commands for private chats or unrelated repos.`
+    const scopeDescription = scopePaths.length === 1
+        ? `the Tower-onboarded workspace/repo \`${scopePaths[0]}\``
         : scopePaths.length > 1
-            ? `- Only applies when the current working directory is inside one of these Tower-onboarded workspace roots: ${scopePaths.map((scopePath) => `\`${scopePath}\``).join(", ")}. Outside those folders, do not run Tower ticket binding or sync commands for private chats or unrelated repos.`
-            : "- Only applies when the current working directory is inside the workspace/repo that ran `cockpit doctor` or `cockpit agent-rules install`. Outside that folder, do not run Tower ticket binding or sync commands for private chats or unrelated repos.";
+            ? `one of these Tower-onboarded workspace roots: ${scopePaths.map((scopePath) => `\`${scopePath}\``).join(", ")}`
+            : "the workspace/repo that ran `cockpit doctor` or `cockpit agent-rules install`";
     return [
         MANAGED_BLOCK_START,
-        "## Tower Ticket Binding",
+        "## Tower first",
         "",
-        scopeLine,
-        "- Ticketed work (implement / debug / review / PR / ship): run `cockpit start --ticket <ticket-id> --workspace \"$PWD\"` before the first code edit (the flag is `--ticket`). No ticket ID visible → search Linear first; none exists and the work is ticket-worthy → create a narrow Linear ticket, then bind.",
-        "- If setup or collection needs repair, run `cockpit doctor`. It repairs this machine and prints any remaining action.",
-        "- Truly no ticket → say the session stays in general ambient capture; never invent one.",
-        "- After the first meaningful checkpoint, run `cockpit sync --workspace \"$PWD\" --json`.",
+        "- We build Tower, so we use it first. Tickets (`cockpit work`), docs (`cockpit docs`), meetings (`cockpit cal`), mail, messages and search go through Tower before Linear, Notion or Google. If a Tower tool is missing, broken or clumsy, file a Tower ticket and get it fixed.",
+        `- In ${scopeDescription} only: bind ticketed work before the first edit with \`cockpit start --ticket <id> --workspace "$PWD"\`; \`cockpit doctor\` repairs the machine.`,
         "",
         "## Definition of done — QA receipts",
         "",

package/dist/commands/issue-contracts.js

@@ -15,6 +15,53 @@ export const TAG = "[issue cli]";
 export const READ_DEADLINE_MS = 30_000;
 export const WRITE_DEADLINE_MS = 60_000;
 export const BODY_MAX_CHARS = 200_000;
+/**
+ * `--size S|M|L` (BLI-10575) maps onto the existing `work_issues.estimate`
+ * numeric column — no migration, since a raw estimate already round-trips
+ * through every door untouched (an imported Linear estimate travels through
+ * unmodified, `docs/runbooks/linear-sync.md`). These three numbers are
+ * Tower's OWN convention for a person who wants to size a ticket without
+ * picking a raw number, not a scale Linear enforces: S=1, M=3, L=5. A stored
+ * estimate outside this set (an imported Linear point value, or a number set
+ * some other way) simply has no size label and prints as its plain number.
+ */
+export const SIZE_ESTIMATES = { S: 1, M: 3, L: 5 };
+/** `--size` on the command line, case-insensitive; anything else is refused here rather than reaching the door as a mystery number. */
+export function estimateForSize(value) {
+    const key = value.trim().toUpperCase();
+    if (key !== "S" && key !== "M" && key !== "L") {
+        throw new Error("--size must be S, M, or L.");
+    }
+    return SIZE_ESTIMATES[key];
+}
+/** The reverse: an estimate the door returned, back to a size letter — or null when it does not match Tower's own scale. */
+export function sizeForEstimate(estimate) {
+    if (estimate === null || estimate === undefined)
+        return null;
+    for (const key of Object.keys(SIZE_ESTIMATES)) {
+        if (SIZE_ESTIMATES[key] === estimate)
+            return key;
+    }
+    return null;
+}
+/**
+ * `size` alongside the raw `estimate`, for JSON output — a convenience
+ * label, never a second source of truth.
+ *
+ * `T extends object` rather than `T extends { estimate?: ... }`: TypeScript
+ * refuses an all-optional ("weak") object type when the value shares NO
+ * property with it at all (TS2559), which is exactly what a `{}` fallback
+ * elsewhere in this file looks like. Reading `estimate` off an `object` cast
+ * keeps the same runtime behaviour without that false refusal.
+ */
+export function withSizeLabel(row) {
+    const estimate = row.estimate;
+    return { ...row, size: sizeForEstimate(estimate ?? null) };
+}
+/** The same, when the row itself might be absent (a door answer with no `issue`). */
+export function maybeWithSizeLabel(row) {
+    return row === undefined ? undefined : withSizeLabel(row);
+}
 /** A project id from a project NAME or a uuid — exact after case-folding. */
 export async function resolveProjectId(door, ref) {
     const answer = await askAgentDoor(door, {

package/dist/commands/issue-show.js

@@ -15,7 +15,7 @@ import { mirroredTicketIdInTitle } from "@bli-cockpit/telemetry-core";
 import { askAgentDoor, emitAgentDoor, failAgentDoor, } from "./agent-door.js";
 import { writeLine } from "./cli-io.js";
 import { assigneeLabel, resolveAssigneeDirectory, withAssigneeIdentity } from "./issue-directory.js";
-import { READ_DEADLINE_MS, TAG } from "./issue-contracts.js";
+import { READ_DEADLINE_MS, TAG, sizeForEstimate, withSizeLabel, } from "./issue-contracts.js";
 async function fetchOneIssue(door, ref) {
     const answer = await askAgentDoor(door, {
         path: `/api/work/issues/${encodeURIComponent(ref)}`,
@@ -61,7 +61,8 @@ async function fetchOneIssue(door, ref) {
 function renderOneIssue(door, result, directory) {
     const { issue, comments, linearTicketId } = result;
     writeLine(door.io.stdout, `${issue.identifier}  ${issue.title}`);
-    writeLine(door.io.stdout, `${issue.state}  ·  priority ${issue.priority ?? 0}  ·  assignee ${assigneeLabel(issue.assignee_id, directory)}  ·  updated ${issue.updated_at}`);
+    const size = sizeForEstimate(issue.estimate ?? null);
+    writeLine(door.io.stdout, `${issue.state}  ·  priority ${issue.priority ?? 0}${size ? `  ·  size ${size}` : ""}  ·  assignee ${assigneeLabel(issue.assignee_id, directory)}  ·  updated ${issue.updated_at}`);
     writeLine(door.io.stdout, `id ${issue.id}${issue.parent_id ? `  ·  parent ${issue.parent_id}` : ""}`);
     if (linearTicketId)
         writeLine(door.io.stdout, `Linear: ${linearTicketId}`);
@@ -99,7 +100,7 @@ export async function showIssue(command, door) {
         if (door.json) {
             return emitAgentDoor(door, {
                 ok: true,
-                issue: withAssigneeIdentity(result.issue, directory),
+                issue: withSizeLabel(withAssigneeIdentity(result.issue, directory)),
                 comments: result.comments,
                 ...(result.linearTicketId ? { linear_ticket_id: result.linearTicketId } : {}),
                 ...(result.commentsUnreadReason ? { comments_unread_reason: result.commentsUnreadReason } : {}),
@@ -119,7 +120,7 @@ export async function showIssue(command, door) {
                 ? {
                     ref: result.ref,
                     ok: true,
-                    issue: withAssigneeIdentity(result.issue, directory),
+                    issue: withSizeLabel(withAssigneeIdentity(result.issue, directory)),
                     comments: result.comments,
                     ...(result.linearTicketId ? { linear_ticket_id: result.linearTicketId } : {}),
                     ...(result.commentsUnreadReason ? { comments_unread_reason: result.commentsUnreadReason } : {}),

package/dist/commands/issue-write.js

@@ -9,7 +9,7 @@
  */
 import { askAgentDoor, emitAgentDoor, failAgentDoor, } from "./agent-door.js";
 import { writeLine } from "./cli-io.js";
-import { TAG, WRITE_DEADLINE_MS, readBody, resolveRefs, } from "./issue-contracts.js";
+import { TAG, WRITE_DEADLINE_MS, maybeWithSizeLabel, readBody, resolveRefs, } from "./issue-contracts.js";
 export async function createIssue(command, door) {
     if (!command.title)
         return failAgentDoor(door, TAG, "invalid_body", "issue create needs --title.");
@@ -30,12 +30,13 @@ export async function createIssue(command, door) {
             ...(refs.projectId ? { project_id: refs.projectId } : {}),
             ...(refs.parentId ? { parent_id: refs.parentId } : {}),
             ...(command.priority === undefined ? {} : { priority: command.priority }),
+            ...(command.estimate === undefined ? {} : { estimate: command.estimate }),
             ...(command.assignee ? { assignee_id: command.assignee } : {}),
         },
     });
     if (!answer.ok)
         return failAgentDoor(door, TAG, answer.reason, answer.detail);
-    const issue = answer.body.issue;
+    const issue = maybeWithSizeLabel(answer.body.issue);
     writeLine(door.io.stderr, `${TAG} created ${JSON.stringify({ issue_id: issue?.id ?? null, identifier: issue?.identifier ?? null, description_bytes: Buffer.byteLength(body.text, "utf8") })}`);
     if (door.json)
         return emitAgentDoor(door, { ok: true, issue });
@@ -57,10 +58,11 @@ export async function updateIssue(command, door) {
     if (description === undefined
         && command.title === undefined
         && command.priority === undefined
+        && command.estimate === undefined
         && command.assignee === undefined
         && refs.projectId === undefined
         && refs.parentId === undefined) {
-        return failAgentDoor(door, TAG, "invalid_body", "issue update needs at least one of --title, --priority, --assignee, --project, --parent, or a description on --body-stdin/--file.");
+        return failAgentDoor(door, TAG, "invalid_body", "issue update needs at least one of --title, --priority, --size, --assignee, --project, --parent, or a description on --body-stdin/--file.");
     }
     const answer = await askAgentDoor(door, {
         path: `/api/work/issues/${encodeURIComponent(ref)}`,
@@ -71,6 +73,7 @@ export async function updateIssue(command, door) {
             ...(command.title !== undefined ? { title: command.title } : {}),
             ...(description !== undefined ? { description } : {}),
             ...(command.priority === undefined ? {} : { priority: command.priority }),
+            ...(command.estimate === undefined ? {} : { estimate: command.estimate }),
             ...(command.assignee ? { assignee_id: command.assignee } : {}),
             ...(refs.projectId ? { project_id: refs.projectId } : {}),
             ...(refs.parentId ? { parent_id: refs.parentId } : {}),
@@ -78,7 +81,7 @@ export async function updateIssue(command, door) {
     });
     if (!answer.ok)
         return failAgentDoor(door, TAG, answer.reason, answer.detail);
-    const issue = answer.body.issue;
+    const issue = maybeWithSizeLabel(answer.body.issue);
     writeLine(door.io.stderr, `${TAG} updated ${JSON.stringify({ issue_id: issue?.id ?? null, identifier: issue?.identifier ?? null })}`);
     if (door.json)
         return emitAgentDoor(door, { ok: true, issue });

package/dist/commands/issue.js

@@ -29,7 +29,7 @@ import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor, } from "./ag
 import { writeLine } from "./cli-io.js";
 import { assigneeLabel, resolveAssigneeDirectory, withAssigneeIdentity } from "./issue-directory.js";
 import { showIssue } from "./issue-show.js";
-import { READ_DEADLINE_MS, TAG, resolveProjectId, } from "./issue-contracts.js";
+import { READ_DEADLINE_MS, TAG, resolveProjectId, sizeForEstimate, withSizeLabel, } from "./issue-contracts.js";
 import { commentIssue, createIssue, moveIssue, updateIssue } from "./issue-write.js";
 export async function runIssue(command, io) {
     const door = await openAgentDoor("issue", command, io);
@@ -52,7 +52,9 @@ export async function runIssue(command, io) {
 }
 function issueLine(issue, directory) {
     const assignee = issue.assignee_id ? `  [${assigneeLabel(issue.assignee_id, directory)}]` : "";
-    return `${issue.identifier.padEnd(9)}  ${issue.state.padEnd(11)}  ${issue.title}${assignee}`;
+    const size = sizeForEstimate(issue.estimate ?? null);
+    const sizeTag = size ? `  (${size})` : "";
+    return `${issue.identifier.padEnd(9)}  ${issue.state.padEnd(11)}  ${issue.title}${sizeTag}${assignee}`;
 }
 /**
  * What the list did not show (BLI-10447): a capped window of a larger set,
@@ -123,7 +125,7 @@ async function listIssues(command, door) {
     if (door.json) {
         return emitAgentDoor(door, {
             ok: true,
-            issues: issues.map((issue) => withAssigneeIdentity(issue, directory)),
+            issues: issues.map((issue) => withSizeLabel(withAssigneeIdentity(issue, directory))),
             ...(body.completeness ? { completeness: body.completeness } : {}),
             ...(body.outside_project ? { outside_project: body.outside_project } : {}),
         });

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

@@ -16,6 +16,7 @@
  * shared machine and lands in shell history).
  */
 import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs, } from "./local-arg-values.js";
+import { estimateForSize } from "./issue-contracts.js";
 const ISSUE_ACTIONS = new Set([
     "list",
     "show",
@@ -54,6 +55,7 @@ export function parseIssueArgs(args) {
             "--limit",
             "--title",
             "--priority",
+            "--size",
             "--parent",
             "--file",
             "--body-stdin",
@@ -68,6 +70,7 @@ export function parseIssueArgs(args) {
             "--limit",
             "--title",
             "--priority",
+            "--size",
             "--parent",
             "--file",
         ],
@@ -78,9 +81,10 @@ export function parseIssueArgs(args) {
     const stateFilter = readIssueStateFilter(action, values);
     const title = readIssueTitle(action, values);
     const priority = readIssuePriority(values);
+    const estimate = readIssueSize(values);
     const assignee = readIssueAssignee(action, values);
     const limit = readIssueLimit(action, values);
-    return buildIssueCommand(values, action, issueRef, issueRefs, moveState, stateFilter, title, priority, assignee, limit);
+    return buildIssueCommand(values, action, issueRef, issueRefs, moveState, stateFilter, title, priority, estimate, assignee, limit);
 }
 function readIssueAction(values) {
     const first = values.positionals[0];
@@ -157,6 +161,10 @@ function readIssuePriority(values) {
     }
     return priority;
 }
+function readIssueSize(values) {
+    const raw = optionalNonEmpty(values.flags.get("--size"));
+    return raw === undefined ? undefined : estimateForSize(raw);
+}
 function readIssueAssignee(action, values) {
     // An assignee is `me`, `unassigned`, or a person's uuid. A name or an
     // email is refused HERE rather than travelling to Postgres as a malformed
@@ -177,7 +185,7 @@ function readIssueLimit(action, values) {
     }
     return limit;
 }
-function buildIssueCommand(values, action, issueRef, issueRefs, moveState, stateFilter, title, priority, assignee, limit) {
+function buildIssueCommand(values, action, issueRef, issueRefs, moveState, stateFilter, title, priority, estimate, assignee, limit) {
     return {
         kind: "issue",
         action,
@@ -192,6 +200,7 @@ function buildIssueCommand(values, action, issueRef, issueRefs, moveState, state
         ...(limit === undefined ? {} : { limit }),
         title,
         ...(priority === undefined ? {} : { priority }),
+        ...(estimate === undefined ? {} : { estimate }),
         parentRef: optionalNonEmpty(values.flags.get("--parent")),
         filePath: optionalNonEmpty(values.flags.get("--file")),
         bodyStdin: values.booleans.has("--body-stdin"),

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

@@ -91,11 +91,11 @@ export const TOWER_COMMAND_HELP = [
             "Usage: cockpit issue [list|show <id> [<id>...]|create|update <id>|move <id> <state>|comment <id>|history <id>] [flags]",
             "",
             "Tower's issue tracker. <id> is a BLI-#### identifier (BLI-3654) or an issue's uuid — both work everywhere an issue is named.",
-            "list [--state <s>] [--assignee me|unassigned|<uuid>] [--project <name|id>] [--limit <n>] — the issues you may see, most recently updated first. Each row carries assignee_name/assignee_email alongside the bare assignee_id (BLI-10450, one extra `cockpit team members` call for the whole page, never per row). --json shape: { issues: [{ id, identifier, title, state, priority, assignee_id, assignee_name, assignee_email, project_id, parent_id, updated_at }] }.",
-            "show <id> [<id>...] — one or more issues: title, state, priority, assignee (name and email, not just its id), description, and every comment on each. Several ids read in one call — one bad id never loses the rest.",
-            "  --json shape: one id answers { issue, comments }, unchanged from before BLI-10450. Several ids answer { issues: [{ ref, ok, issue, comments } | { ref, ok: false, error, detail }] }.",
-            "create --title \"<title>\" [--project <name|id>] [--priority 0-4] [--assignee me|<uuid>] [--parent <id>] [--file <path>] — the DESCRIPTION comes from --file or stdin (`cat plan.md | cockpit issue create --title \"...\"`); neither means no description. --json shape: { issue }.",
-            "update <id> [--title \"<t>\"] [--priority 0-4] [--assignee me|<uuid>] [--project <name|id>] [--parent <id>] [--file <path>|--body-stdin] — only the fields you pass change. State does NOT move here; use move. --json shape: { issue }.",
+            "list [--state <s>] [--assignee me|unassigned|<uuid>] [--project <name|id>] [--limit <n>] — the issues you may see, most recently updated first. Each row carries assignee_name/assignee_email alongside the bare assignee_id (BLI-10450, one extra `cockpit team members` call for the whole page, never per row), and a `size` label (S/M/L) alongside the raw `estimate` when it matches Tower's own scale (BLI-10575). --json shape: { issues: [{ id, identifier, title, state, priority, estimate, size, assignee_id, assignee_name, assignee_email, project_id, parent_id, updated_at }] }.",
+            "show <id> [<id>...] — one or more issues: title, state, priority, size, assignee (name and email, not just its id), description, and every comment on each. Several ids read in one call — one bad id never loses the rest.",
+            "  --json shape: one id answers { issue, comments }, unchanged from before BLI-10450 (plus `estimate`/`size`, BLI-10575). Several ids answer { issues: [{ ref, ok, issue, comments } | { ref, ok: false, error, detail }] }.",
+            "create --title \"<title>\" [--project <name|id>] [--priority 0-4] [--size S|M|L] [--assignee me|<uuid>] [--parent <id>] [--file <path>] — the DESCRIPTION comes from --file or stdin (`cat plan.md | cockpit issue create --title \"...\"`); neither means no description. --size maps onto the existing `estimate` column, Tower's own scale: S=1, M=3, L=5 (BLI-10575) — an estimate outside that scale (an imported Linear point value, say) just has no size label on a read. --json shape: { issue }.",
+            "update <id> [--title \"<t>\"] [--priority 0-4] [--size S|M|L] [--assignee me|<uuid>] [--project <name|id>] [--parent <id>] [--file <path>|--body-stdin] — only the fields you pass change. State does NOT move here; use move. --json shape: { issue }.",
             "move <id> <state> — moves an issue and records the move. States: backlog, todo, in_progress, in_review, done, canceled.",
             "comment <id> — posts a comment. The body is never taken on the command line: `echo \"shipped\" | cockpit issue comment BLI-3654`.",
             "history <id> [--limit <n>] — every recorded state move and reassignment, oldest first.",

package/dist/commands/local-help-commands.js

@@ -330,10 +330,12 @@ export function localSubcommandHelp(command) {
             [
                 "Usage: cockpit agent-rules [install|uninstall|status] [--host codex|claude|all] [--workspace <path>] [--json]",
                 "",
-                "Installs a managed Tower Ticket Binding block into ~/.codex/AGENTS.md",
+                "Installs a managed Tower-first block into ~/.codex/AGENTS.md",
                 "and ~/.claude/CLAUDE.md by default. Pass --host to manage only one.",
                 "The block is scoped to --workspace, or the current directory when omitted,",
-                "so Codex and Claude only run Tower ticket binding inside that onboarded folder.",
+                "so ticketed work only binds inside that onboarded folder.",
+                "If CLAUDE.md already includes ~/.codex/AGENTS.md and both hosts are",
+                "installed together, CLAUDE.md is left to the include instead of duplicating it.",
                 "Action defaults to `install`.",
             ],
         ],

package/dist/commands/local-help.js

@@ -119,7 +119,7 @@ export function localCommandHelp(command) {
         "  cockpit clean [--dry-run] [--all-committed] [--reconcile] [--dashboard-url <url>] [--json]",
         "  cockpit docs [list|tree|read <id|slug>|create --title <t>|update <id>|delete <id|slug>] [--parent <id>|root|--clear-parent] [--query <text> [--word]] [--limit <n>] [--visibility org|private] [--file <path>|--body-stdin] [--allow-empty] [--dashboard-url <url>] [--json]",
         "  cockpit msg [channels|create <name>|dm <email>|read <channel>|send <channel>|thread <id> --channel <channel>] [--private] [--members a@x,b@y] [--description <text>] [--thread <id>] [--limit <n>] [--dashboard-url <url>] [--json]",
-        "  cockpit issue [list|show <BLI-id>|create --title <t>|update <BLI-id>|move <BLI-id> <state>|comment <BLI-id>|history <BLI-id>] [--state <s>] [--assignee me|unassigned|<uuid>] [--project <name|id>] [--limit <n>] [--priority 0-4] [--parent <BLI-id>] [--file <path>|--body-stdin] [--dashboard-url <url>] [--json]",
+        "  cockpit issue [list|show <BLI-id>|create --title <t>|update <BLI-id>|move <BLI-id> <state>|comment <BLI-id>|history <BLI-id>] [--state <s>] [--assignee me|unassigned|<uuid>] [--project <name|id>] [--limit <n>] [--priority 0-4] [--size S|M|L] [--parent <BLI-id>] [--file <path>|--body-stdin] [--dashboard-url <url>] [--json]",
         "  cockpit mail [accounts|add-imap --address <a>|inbox|read <thread>|search \"<words>\"|send --account <id> --to <a> --subject <s>|attachment <id> --out <path>|sync <account>|detach <account>] [--account <id>] [--limit <n>] [--unread] [--label <l>] [--file <path>] [--dashboard-url <url>] [--json]",
         "  cockpit cal [today|week|next|find \"<words>\"|calendars|add-ical|create --calendar <id> --title <t> --at <iso> --until <iso>|share <id> --org-visible|--private|sync <id> [--full]|detach <id>] [--tz <zone>] [--offset <n>] [--hours <n>] [--from <d> --to <d>] [--calendar <id>] [--limit <n>] [--all] [--dashboard-url <url>] [--json]",
         "  cockpit project [list] [--archived] [--dashboard-url <url>] [--json]",

package/dist/commands/public-root.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.144",
+  "version": "0.2.145",
   "private": false,
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@bli-cockpit/memory-mcp": "0.1.36",
-    "@bli-cockpit/mcp": "0.1.69",
+    "@bli-cockpit/mcp": "0.1.70",
     "@bli-cockpit/telemetry-core": "0.1.48"
   }
 }