@brainbase-labs/cli 0.29.0 → 0.30.0

package/dist/index.js

@@ -36018,7 +36018,7 @@ function padStart(s, n) {
 // package.json
 var package_default = {
   name: "@brainbase-labs/cli",
-  version: "0.29.0",
+  version: "0.30.0",
   description: "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   type: "module",
   bin: {
@@ -40969,7 +40969,7 @@ function acquireLock(lockFile, timeoutMs) {
 function acquireAuthLock() {
   const release = acquireLock(AUTH_LOCK_FILE, AUTH_LOCK_TIMEOUT_MS);
   if (!release) {
-    throw new Error(`Timed out waiting to update CLI authentication; if no other brainbase process is running, remove ${AUTH_LOCK_FILE}`);
+    throw new Error(`Timed out waiting to update CLI authentication.${lockHolderState(AUTH_LOCK_FILE)} Retry, or remove ${AUTH_LOCK_FILE}`);
   }
   return release;
 }
@@ -41021,10 +41021,44 @@ class AuthSessionChangedError extends Error {
     this.name = "AuthSessionChangedError";
   }
 }
+function heldFor(lockFile) {
+  try {
+    const ms = Date.now() - fs6.statSync(lockFile).mtimeMs;
+    if (!Number.isFinite(ms) || ms < 0)
+      return "";
+    if (ms < 60000)
+      return ` Held for ${Math.round(ms / 1000)}s.`;
+    if (ms < 3600000)
+      return ` Held for ${Math.round(ms / 60000)}m.`;
+    return ` Held for ${Math.round(ms / 3600000)}h.`;
+  } catch {
+    return "";
+  }
+}
+function lockHolderState(lockFile) {
+  let pid;
+  try {
+    pid = Number.parseInt(fs6.readFileSync(lockFile, "utf8").split(":")[0] ?? "", 10);
+  } catch {
+    return "";
+  }
+  if (!Number.isInteger(pid) || pid <= 0)
+    return "";
+  const age = heldFor(lockFile);
+  try {
+    process.kill(pid, 0);
+    return ` A process with pid ${pid} is running, so this may clear on its own — but pids get reused, so if that is not a brainbase command the lock is stale.${age}`;
+  } catch (error) {
+    if (error.code === "EPERM") {
+      return ` A process with pid ${pid} is running, so this may clear on its own — but pids get reused, so if that is not a brainbase command the lock is stale.${age}`;
+    }
+    return ` The process that held it (pid ${pid}) is gone, so this lock is stale and will not clear itself.${age}`;
+  }
+}
 
 class AuthRefreshLockTimeoutError extends Error {
   constructor() {
-    super(`Timed out waiting to refresh CLI authentication; retry, or if no other brainbase process is running, remove ${REFRESH_LOCK_FILE}`);
+    super(`Timed out waiting to refresh CLI authentication.${lockHolderState(REFRESH_LOCK_FILE)} Retry, or remove ${REFRESH_LOCK_FILE}`);
     this.name = "AuthRefreshLockTimeoutError";
   }
 }
@@ -53890,7 +53924,7 @@ var StoredTokenSchema = exports_external.object({
 function withTokenLock(operation) {
   const release = acquireLock(TOKEN_LOCK_FILE, TOKEN_LOCK_TIMEOUT_MS);
   if (!release) {
-    throw new Error(`Timed out waiting to update the local CLI token; if no other brainbase process is running, remove ${TOKEN_LOCK_FILE}`);
+    throw new Error(`Timed out waiting to update the local CLI token.${lockHolderState(TOKEN_LOCK_FILE)} Retry, or remove ${TOKEN_LOCK_FILE}`);
   }
   try {
     return operation();
@@ -62374,14 +62408,16 @@ var McpEntrySchema = exports_external.object({
   args: exports_external.array(exports_external.string()).optional(),
   env: exports_external.record(exports_external.string()).optional(),
   headers: exports_external.record(exports_external.string()).optional(),
-  is_enabled: exports_external.boolean().optional()
+  is_enabled: exports_external.boolean().optional(),
+  runtime_meta: exports_external.record(exports_external.unknown()).optional()
 });
 var CapabilitiesSchema = exports_external.object({
   memory: exports_external.boolean().optional(),
   browser: exports_external.boolean().optional(),
   slack: exports_external.boolean().optional(),
   meeting: exports_external.boolean().optional(),
-  github: exports_external.boolean().optional()
+  github: exports_external.boolean().optional(),
+  linear: exports_external.boolean().optional()
 });
 var EvalOutputShape = exports_external.enum(["binary", "rating", "classification"]);
 var EVAL_SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
@@ -63547,6 +63583,39 @@ function buildGithubMcpComponent(scope) {
   };
 }
 
+// src/core/linear-mcp.ts
+var DEFAULT_LINEAR_MCP_BASE = "https://brainbase-linear-mcp.onrender.com";
+var LINEAR_MCP_SLUG = "brainbase-linear";
+function linearMcpBaseUrl() {
+  const envOverride = process.env.BRAINBASE_LINEAR_MCP_URL;
+  if (envOverride)
+    return envOverride.replace(/\/+$/, "");
+  return DEFAULT_LINEAR_MCP_BASE;
+}
+function linearMcpUrl() {
+  return `${linearMcpBaseUrl()}/t/\${BRAINBASE_THREAD_ID}/mcp`;
+}
+function linearMcpPayload() {
+  return {
+    url: linearMcpUrl(),
+    headers: {
+      Authorization: "Bearer ${BRAINBASE_TOKEN}"
+    }
+  };
+}
+function buildLinearMcpComponent(scope) {
+  return {
+    type: "mcp",
+    slug: LINEAR_MCP_SLUG,
+    scope,
+    rootDir: "",
+    description: "This agent's Linear connector (read and update issues, comment, and " + "report progress on delegated work). Scoped to this agent only.",
+    meta: { mcp: linearMcpPayload() },
+    payload: linearMcpPayload(),
+    checksum: "builtin:brainbase-linear:v1"
+  };
+}
+
 // src/core/browser-mcp.ts
 var DEFAULT_BROWSER_MCP_BASE = "https://brainbase-browser-mcp.onrender.com";
 var BROWSER_MCP_SLUG = "brainbase-browser";
@@ -63587,7 +63656,8 @@ function capabilitiesFromAgent(agent) {
     browser: agent.browser_enabled !== false,
     slack: agent.slack_connected === true,
     meeting: agent.meeting_connected === true,
-    github: agent.github_connected === true
+    github: agent.github_connected === true,
+    linear: agent.linear_connected === true
   };
 }
 function capabilitiesFromManifest(manifest) {
@@ -63597,7 +63667,8 @@ function capabilitiesFromManifest(manifest) {
     browser: c2.browser !== false,
     slack: c2.slack === true,
     meeting: c2.meeting === true,
-    github: c2.github === true
+    github: c2.github === true,
+    linear: c2.linear === true
   };
 }
 function resolveBuiltinMcps(input) {
@@ -63608,7 +63679,8 @@ function resolveBuiltinMcps(input) {
     { slug: BROWSER_MCP_SLUG, enabled: caps.browser, build: buildBrowserMcpComponent },
     { slug: SLACK_MCP_SLUG, enabled: caps.slack, build: buildSlackMcpComponent },
     { slug: MEETING_MCP_SLUG, enabled: caps.meeting, build: buildMeetingMcpComponent },
-    { slug: GITHUB_MCP_SLUG, enabled: caps.github, build: buildGithubMcpComponent }
+    { slug: GITHUB_MCP_SLUG, enabled: caps.github, build: buildGithubMcpComponent },
+    { slug: LINEAR_MCP_SLUG, enabled: caps.linear, build: buildLinearMcpComponent }
   ];
   const install = [];
   const removeSlugs = [];
@@ -64374,7 +64446,7 @@ function diffAgentMeta(manifestMeta, lockMeta, cloudMeta) {
   };
 }
 var WRITABLE_CAPABILITIES = ["memory", "browser"];
-var MIRRORED_CAPABILITIES = ["slack", "meeting", "github"];
+var MIRRORED_CAPABILITIES = ["slack", "meeting", "github", "linear"];
 function manifestConfigState(manifest) {
   return {
     ...manifest.machine_kind !== undefined ? { machine_kind: manifest.machine_kind } : {},
@@ -64398,7 +64470,8 @@ function staleConnectionMirrors(manifest, cloud) {
   const actualByName = {
     slack: cloud.slack_connected,
     meeting: cloud.meeting_connected,
-    github: cloud.github_connected
+    github: cloud.github_connected,
+    linear: cloud.linear_connected
   };
   const stale = [];
   for (const name of MIRRORED_CAPABILITIES) {
@@ -64561,6 +64634,41 @@ function capabilityBaselineAfterPush(cloudAgent, previous, diff2) {
   return out;
 }
 
+// src/core/mcp-merge.ts
+var RUNTIME_META_PREFIX = "runtime_";
+function runtimeMetaFromComponent(component) {
+  const meta = component.meta ?? {};
+  const carried = {};
+  for (const [key2, value] of Object.entries(meta)) {
+    if (key2.startsWith(RUNTIME_META_PREFIX) && value !== undefined) {
+      carried[key2] = value;
+    }
+  }
+  return Object.keys(carried).length > 0 ? carried : undefined;
+}
+function mcpEntriesFromCloudComponents(components) {
+  return components.filter((c2) => c2.type === "mcp").map((c2) => {
+    const payload = (c2.meta ?? {}).mcp ?? {};
+    const entry = { name: c2.slug };
+    if (typeof payload.url === "string")
+      entry.url = payload.url;
+    if (typeof payload.command === "string")
+      entry.command = payload.command;
+    if (Array.isArray(payload.args))
+      entry.args = payload.args.map(String);
+    if (payload.env && typeof payload.env === "object")
+      entry.env = payload.env;
+    if (payload.headers && typeof payload.headers === "object")
+      entry.headers = payload.headers;
+    if (typeof payload.is_enabled === "boolean")
+      entry.is_enabled = payload.is_enabled;
+    const runtimeMeta = runtimeMetaFromComponent(c2);
+    if (runtimeMeta)
+      entry.runtime_meta = runtimeMeta;
+    return entry;
+  });
+}
+
 // src/core/secrets-env.ts
 import path78 from "node:path";
 import fs71 from "node:fs";
@@ -65411,23 +65519,7 @@ function mergeManifest(cwd2, prev, cloud, cloudAgent, harness, localOnly = {}, s
       content
     };
   });
-  const mcp = cloud.components.filter((c2) => c2.type === "mcp").map((c2) => {
-    const payload = (c2.meta ?? {}).mcp ?? {};
-    const entry = { name: c2.slug };
-    if (typeof payload.url === "string")
-      entry.url = payload.url;
-    if (typeof payload.command === "string")
-      entry.command = payload.command;
-    if (Array.isArray(payload.args))
-      entry.args = payload.args.map(String);
-    if (payload.env && typeof payload.env === "object")
-      entry.env = payload.env;
-    if (payload.headers && typeof payload.headers === "object")
-      entry.headers = payload.headers;
-    if (typeof payload.is_enabled === "boolean")
-      entry.is_enabled = payload.is_enabled;
-    return entry;
-  });
+  const mcp = mcpEntriesFromCloudComponents(cloud.components);
   const evals = evalsFromCloudComponents(cloud.components);
   const caps = capabilitiesFromAgent(cloudAgent);
   const machineKind = cloudAgent.machine_kind ?? prev?.machine_kind;
@@ -65462,7 +65554,8 @@ function mergeManifest(cwd2, prev, cloud, cloudAgent, harness, localOnly = {}, s
       browser: caps.browser,
       slack: caps.slack,
       meeting: caps.meeting,
-      github: caps.github
+      github: caps.github,
+      linear: caps.linear
     }
   };
 }
@@ -65847,7 +65940,7 @@ async function buildOutgoingComponents(cwd2, manifest, cloud, resolvedVersions)
       slug: entry.name,
       hash: "",
       files: [],
-      meta: { mcp: payload }
+      meta: { ...entry.runtime_meta ?? {}, mcp: payload }
     });
   }
   return out;
@@ -69010,23 +69103,7 @@ function buildManifestFromCloud(cloud, agent, localOnly = {}) {
     return { source: `registry:${c2.slug}` };
   });
   const hasInstructions = cloud.components.some((c2) => c2.type === "instruction" && c2.files[0]?.content?.trim());
-  const mcp = cloud.components.filter((c2) => c2.type === "mcp").map((c2) => {
-    const payload = (c2.meta ?? {}).mcp ?? {};
-    const entry = { name: c2.slug };
-    if (typeof payload.url === "string")
-      entry.url = payload.url;
-    if (typeof payload.command === "string")
-      entry.command = payload.command;
-    if (Array.isArray(payload.args))
-      entry.args = payload.args.map(String);
-    if (payload.env && typeof payload.env === "object")
-      entry.env = payload.env;
-    if (payload.headers && typeof payload.headers === "object")
-      entry.headers = payload.headers;
-    if (typeof payload.is_enabled === "boolean")
-      entry.is_enabled = payload.is_enabled;
-    return entry;
-  });
+  const mcp = mcpEntriesFromCloudComponents(cloud.components);
   const playbooks = cloud.components.filter((c2) => c2.type === "playbook").map((c2) => {
     const raw = c2.files[0]?.content ?? "";
     const { frontmatter } = stripPlaybookFrontmatter(raw);
@@ -69066,7 +69143,8 @@ function buildManifestFromCloud(cloud, agent, localOnly = {}) {
       browser: caps.browser,
       slack: caps.slack,
       meeting: caps.meeting,
-      github: caps.github
+      github: caps.github,
+      linear: caps.linear
     }
   };
 }
@@ -89014,6 +89092,7 @@ function help() {
   out.push(`  ${import_picocolors61.default.dim("BRAINBASE_SLACK_MCP_URL")}         override the built-in Slack MCP host`);
   out.push(`  ${import_picocolors61.default.dim("BRAINBASE_MEETING_MCP_URL")}       override the built-in meeting MCP host`);
   out.push(`  ${import_picocolors61.default.dim("BRAINBASE_GITHUB_MCP_URL")}        override the built-in GitHub MCP host`);
+  out.push(`  ${import_picocolors61.default.dim("BRAINBASE_LINEAR_MCP_URL")}        override the built-in Linear MCP host`);
   out.push(`  ${import_picocolors61.default.dim("BRAINBASE_ORCHESTRATION_MCP_URL")} override the built-in orchestration MCP host`);
   out.push("");
   out.push(divider("HARNESSES"));
@@ -89253,8 +89332,8 @@ async function main() {
   const limitFlag = Number.isInteger(limitParsed) && limitParsed >= 1 && limitParsed <= 200 ? limitParsed : undefined;
   const archivedFlag = hasFlag2(sharedArgs, "--archived");
   ensureSkillResolversRegistered();
-  await requireAuth(cmd);
   try {
+    await requireAuth(cmd);
     switch (cmd) {
       case "login": {
         await runLogin(cwd2, { web });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainbase-labs/cli",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   "type": "module",
   "bin": {