linear-sdk-cli 0.1.0 → 0.1.2

package/src/services/project.ts

@@ -8,12 +8,7 @@
 import type { LinearClient } from "@linear/sdk";
 import { withRetry } from "../client.js";
 import { shape } from "../lib/shape.js";
-import {
-  collect,
-  collectRawQuery,
-  inheritPaginationMetadata,
-  pageSize,
-} from "../lib/pagination.js";
+import { collect, collectRawQuery } from "../lib/pagination.js";
 import { usageError, notFound, ambiguous } from "../lib/errors.js";
 import { assertMutation, unwrapMutation } from "../lib/mutation.js";
 import {
@@ -211,10 +206,7 @@ query CliProjectDetail($filter: ProjectFilter!, $includeArchived: Boolean!) {
   }
 }`;
 
-export async function getProjectDetail(
-  client: LinearClient,
-  idArg: string,
-): Promise<ProjectDetail> {
+export async function getProjectDetail(client: LinearClient, idArg: string): Promise<ProjectDetail> {
   const byId = isUuid(idArg);
   const filter = byId ? { id: { eq: idArg } } : { name: { eqIgnoreCase: idArg } };
   const data: any = await withRetry(() =>
@@ -345,10 +337,7 @@ export async function updateProject(client: LinearClient, idArg: string, opts: U
 export async function archiveProject(client: LinearClient, idArg: string) {
   const projectId = await resolveProjectId(client, idArg);
   const project = await withRetry(() => client.project(projectId));
-  await assertMutation(
-    withRetry(() => client.archiveProject(projectId)),
-    "Project archive",
-  );
+  await assertMutation(withRetry(() => client.archiveProject(projectId)), "Project archive");
   return project;
 }
 
@@ -361,10 +350,7 @@ export async function archiveProject(client: LinearClient, idArg: string) {
 export async function deleteProject(client: LinearClient, idArg: string) {
   const projectId = await resolveProjectId(client, idArg);
   const project = await withRetry(() => client.project(projectId));
-  await assertMutation(
-    withRetry(() => client.deleteProject(projectId)),
-    "Project deletion",
-  );
+  await assertMutation(withRetry(() => client.deleteProject(projectId)), "Project deletion");
   return project;
 }
 
@@ -390,17 +376,16 @@ export async function listMilestones(
 ): Promise<MilestoneRow[]> {
   const projectId = await resolveProjectId(client, idArg);
   const project = await withRetry(() => client.project(projectId));
-  const conn = await withRetry(() => project.projectMilestones({ first: pageSize(limit) }));
-  const nodes = await collect(conn as any, limit);
-  return inheritPaginationMetadata(
-    nodes.map((m: any) => ({
-      id: m.id,
-      name: m.name,
-      targetDate: m.targetDate ?? null,
-      progress: m.progress ?? null,
-    })),
-    nodes,
+  const conn = await withRetry(() =>
+    project.projectMilestones({ first: Math.min(limit === Infinity ? 100 : limit, 100) }),
   );
+  const nodes = await collect(conn as any, limit);
+  return nodes.map((m: any) => ({
+    id: m.id,
+    name: m.name,
+    targetDate: m.targetDate ?? null,
+    progress: m.progress ?? null,
+  }));
 }
 
 export interface UpdateRow {
@@ -418,22 +403,21 @@ export async function listUpdates(
 ): Promise<UpdateRow[]> {
   const projectId = await resolveProjectId(client, idArg);
   const project = await withRetry(() => client.project(projectId));
-  const conn = await withRetry(() => project.projectUpdates({ first: pageSize(limit) }));
+  const conn = await withRetry(() =>
+    project.projectUpdates({ first: Math.min(limit === Infinity ? 100 : limit, 100) }),
+  );
   const nodes = await collect(conn as any, limit);
-  return inheritPaginationMetadata(
-    await Promise.all(
-      nodes.map(async (u: any) => {
-        const user = await u.user;
-        return {
-          id: u.id,
-          createdAt: u.createdAt?.toISOString?.() ?? String(u.createdAt),
-          user: user?.displayName ?? "unknown",
-          body: u.body ?? "",
-          health: u.health ?? null,
-        };
-      }),
-    ),
-    nodes,
+  return Promise.all(
+    nodes.map(async (u: any) => {
+      const user = await u.user;
+      return {
+        id: u.id,
+        createdAt: u.createdAt?.toISOString?.() ?? String(u.createdAt),
+        user: user?.displayName ?? "unknown",
+        body: u.body ?? "",
+        health: u.health ?? null,
+      };
+    }),
   );
 }
 
@@ -473,22 +457,17 @@ async function resolveTeamIds(
 /** Resolve a project status (by name or type) to a status id. */
 async function resolveStatusId(client: LinearClient, input: string): Promise<string> {
   if (isUuid(input)) return input;
-  const conn = await withRetry(() => client.projectStatuses({ first: 250 }));
-  const statuses = (await collect(conn as any, Infinity)) as Array<{
-    id: string;
-    name: string;
-    type: string;
-  }>;
+  const statuses = await withRetry(() => client.projectStatuses({ first: 100 }));
   const lower = input.toLowerCase();
-  const byName = statuses.filter((s) => s.name.toLowerCase() === lower);
-  const matches = byName.length ? byName : statuses.filter((s) => s.type.toLowerCase() === lower);
+  const byName = statuses.nodes.filter((s) => s.name.toLowerCase() === lower);
+  const matches = byName.length
+    ? byName
+    : statuses.nodes.filter((s) => s.type.toLowerCase() === lower);
   if (matches.length === 0)
     throw notFound(
-      `No project status '${input}'. Available: ${statuses.map((s) => s.name).join(", ")}`,
+      `No project status '${input}'. Available: ${statuses.nodes.map((s) => s.name).join(", ")}`,
     );
   if (matches.length > 1)
-    throw ambiguous(
-      `Multiple project statuses match '${input}': ${matches.map((s) => s.name).join(", ")}`,
-    );
+    throw ambiguous(`Multiple project statuses match '${input}': ${matches.map((s) => s.name).join(", ")}`);
   return matches[0]!.id;
 }

package/src/services/roadmap.ts

@@ -13,7 +13,7 @@
 import type { LinearClient } from "@linear/sdk";
 import { withRetry } from "../client.js";
 import { shape } from "../lib/shape.js";
-import { collect, inheritPaginationMetadata, pageSize } from "../lib/pagination.js";
+import { collect } from "../lib/pagination.js";
 import { usageError, notFound, ambiguous } from "../lib/errors.js";
 import { assertMutation, unwrapMutation } from "../lib/mutation.js";
 import { resolveUserId, isUuid } from "../lib/resolve.js";
@@ -44,9 +44,11 @@ export function toRow(r: any): RoadmapRow {
 }
 
 export async function listRoadmaps(client: LinearClient, limit: number): Promise<RoadmapRow[]> {
-  const conn = await withRetry(() => client.roadmaps({ first: pageSize(limit) }));
+  const conn = await withRetry(() =>
+    client.roadmaps({ first: limit === Infinity ? 100 : Math.min(limit, 100) }),
+  );
   const nodes = await collect(conn as any, limit);
-  return inheritPaginationMetadata(nodes.map(toRow), nodes);
+  return nodes.map(toRow);
 }
 
 export interface RoadmapDetail {
@@ -151,10 +153,7 @@ export async function updateRoadmap(client: LinearClient, idArg: string, opts: U
 
 export async function deleteRoadmap(client: LinearClient, idArg: string) {
   const roadmap = await resolveRoadmap(client, idArg);
-  await assertMutation(
-    withRetry(() => client.deleteRoadmap(roadmap.id)),
-    "Roadmap deletion",
-  );
+  await assertMutation(withRetry(() => client.deleteRoadmap(roadmap.id)), "Roadmap deletion");
   return roadmap;
 }
 

package/src/services/state.ts

@@ -10,7 +10,7 @@
 import type { LinearClient } from "@linear/sdk";
 import { withRetry } from "../client.js";
 import { shape } from "../lib/shape.js";
-import { collect, pageSize, setPaginationMetadata } from "../lib/pagination.js";
+import { collect, pageSize } from "../lib/pagination.js";
 import { usageError } from "../lib/errors.js";
 import { resolveTeam, resolveStateId, isUuid } from "../lib/resolve.js";
 
@@ -41,14 +41,8 @@ export async function listStates(
   const team = await resolveTeam(client, teamInput, defaultTeamKey);
   const teamModel = await withRetry(() => client.team(team.id));
   const conn = await withRetry(() => teamModel.states({ first: pageSize(limit) }));
-  // The API's connection order is unrelated to workflow position. Sort the
-  // complete small state set, then apply the caller's limit.
-  const nodes = await collect(conn as any, Infinity);
-  const rows = nodes.map(toRow).sort((a, b) => a.position - b.position);
-  return setPaginationMetadata(
-    limit === Infinity ? rows : rows.slice(0, limit),
-    rows.length > limit,
-  );
+  const nodes = await collect(conn as any, limit);
+  return nodes.map(toRow).sort((a, b) => a.position - b.position);
 }
 
 export interface StateDetail {

package/src/services/team.ts

@@ -9,12 +9,7 @@
 import type { LinearClient } from "@linear/sdk";
 import { withRetry } from "../client.js";
 import { shape } from "../lib/shape.js";
-import {
-  collect,
-  inheritPaginationMetadata,
-  pageSize,
-  setPaginationMetadata,
-} from "../lib/pagination.js";
+import { collect, pageSize } from "../lib/pagination.js";
 import { usageError } from "../lib/errors.js";
 import { assertMutation, unwrapMutation } from "../lib/mutation.js";
 import { resolveTeam, type ResolvedTeam } from "../lib/resolve.js";
@@ -28,23 +23,11 @@ export interface TeamRow {
 /** The row's shape as `linear commands` advertises it (TES-610); checked against the interface. */
 export const TEAM_ROW_SHAPE = shape<TeamRow>({ id: "string", key: "string", name: "string" });
 
-/** Resolve the selected team to its canonical key, UUID, and name. */
-export async function getTeamIdentity(
-  client: LinearClient,
-  keyArg: string | undefined,
-  defaultTeamKey: string | undefined,
-): Promise<ResolvedTeam> {
-  return resolveTeam(client, keyArg, defaultTeamKey);
-}
-
 /** All teams (key, name, id). */
 export async function listTeams(client: LinearClient, limit: number): Promise<TeamRow[]> {
-  const conn = await withRetry(() => client.teams({ first: pageSize(limit) }));
+  const conn = await withRetry(() => client.teams({ first: limit === Infinity ? 100 : Math.min(limit, 250) }));
   const nodes = await collect(conn as any, limit);
-  return inheritPaginationMetadata(
-    nodes.map((t: any) => ({ id: t.id, key: t.key, name: t.name })),
-    nodes,
-  );
+  return nodes.map((t: any) => ({ id: t.id, key: t.key, name: t.name }));
 }
 
 export interface TeamDetail {
@@ -145,16 +128,13 @@ export async function listMembers(
     (await withRetry(() => team.members({ first: pageSize(limit), includeDisabled }))) as any,
     limit,
   );
-  return inheritPaginationMetadata(
-    nodes.map((u: any) => ({
-      id: u.id,
-      displayName: u.displayName,
-      name: u.name,
-      email: u.email,
-      active: !!u.active,
-    })),
-    nodes,
-  );
+  return nodes.map((u: any) => ({
+    id: u.id,
+    displayName: u.displayName,
+    name: u.name,
+    email: u.email,
+    active: !!u.active,
+  }));
 }
 
 export interface StateRow {
@@ -181,8 +161,8 @@ export async function listStates(
 ): Promise<StateRow[]> {
   const resolved = await resolveTeam(client, keyArg, defaultTeamKey);
   const team = await withRetry(() => client.team(resolved.id));
-  const nodes = await collect((await withRetry(() => team.states())) as any, Infinity);
-  const rows = nodes
+  const nodes = await collect((await withRetry(() => team.states())) as any, limit);
+  return nodes
     .map((s: any) => ({
       id: s.id,
       name: s.name,
@@ -191,10 +171,6 @@ export async function listStates(
       position: s.position,
     }))
     .sort((a: StateRow, b: StateRow) => a.position - b.position);
-  return setPaginationMetadata(
-    limit === Infinity ? rows : rows.slice(0, limit),
-    rows.length > limit,
-  );
 }
 
 export interface LabelRow {
@@ -203,11 +179,7 @@ export interface LabelRow {
   color: string;
 }
 
-export const TEAM_LABEL_ROW_SHAPE = shape<LabelRow>({
-  id: "string",
-  name: "string",
-  color: "string",
-});
+export const TEAM_LABEL_ROW_SHAPE = shape<LabelRow>({ id: "string", name: "string", color: "string" });
 
 export async function listLabels(
   client: LinearClient,
@@ -218,10 +190,7 @@ export async function listLabels(
   const resolved = await resolveTeam(client, keyArg, defaultTeamKey);
   const team = await withRetry(() => client.team(resolved.id));
   const nodes = await collect((await withRetry(() => team.labels())) as any, limit);
-  return inheritPaginationMetadata(
-    nodes.map((l: any) => ({ id: l.id, name: l.name, color: l.color })),
-    nodes,
-  );
+  return nodes.map((l: any) => ({ id: l.id, name: l.name, color: l.color }));
 }
 
 export interface CycleRow {
@@ -248,20 +217,14 @@ export async function listCycles(
 ): Promise<CycleRow[]> {
   const resolved = await resolveTeam(client, keyArg, defaultTeamKey);
   const team = await withRetry(() => client.team(resolved.id));
-  const nodes = await collect((await withRetry(() => team.cycles())) as any, Infinity);
-  const rows = nodes
-    .map((c: any) => ({
-      id: c.id,
-      number: c.number,
-      name: c.name ?? null,
-      startsAt: c.startsAt?.toISOString?.() ?? (c.startsAt ? String(c.startsAt) : null),
-      endsAt: c.endsAt?.toISOString?.() ?? (c.endsAt ? String(c.endsAt) : null),
-    }))
-    .sort((a, b) => b.number - a.number);
-  return setPaginationMetadata(
-    limit === Infinity ? rows : rows.slice(0, limit),
-    rows.length > limit,
-  );
+  const nodes = await collect((await withRetry(() => team.cycles())) as any, limit);
+  return nodes.map((c: any) => ({
+    id: c.id,
+    number: c.number,
+    name: c.name ?? null,
+    startsAt: c.startsAt?.toISOString?.() ?? (c.startsAt ? String(c.startsAt) : null),
+    endsAt: c.endsAt?.toISOString?.() ?? (c.endsAt ? String(c.endsAt) : null),
+  }));
 }
 
 export interface CreateTeamOptions {
@@ -358,10 +321,7 @@ export async function moveTeamIssues(
   to: ResolvedTeam,
 ): Promise<number> {
   const team = await withRetry(() => client.team(from.id));
-  const issues = await collect(
-    (await withRetry(() => team.issues({ first: 100 }))) as any,
-    Infinity,
-  );
+  const issues = await collect((await withRetry(() => team.issues({ first: 100 }))) as any, Infinity);
   const ids = issues.map((i: any) => i.id as string);
   for (let i = 0; i < ids.length; i += MOVE_BATCH) {
     const batch = ids.slice(i, i + MOVE_BATCH);
@@ -379,8 +339,5 @@ export async function moveTeamIssues(
  * user as `feature_not_accessible` like every other plan gate.
  */
 export async function deleteTeam(client: LinearClient, team: ResolvedTeam): Promise<void> {
-  await assertMutation(
-    withRetry(() => client.deleteTeam(team.id)),
-    "Team deletion",
-  );
+  await assertMutation(withRetry(() => client.deleteTeam(team.id)), "Team deletion");
 }

package/src/services/user.ts

@@ -9,7 +9,7 @@
 import type { LinearClient } from "@linear/sdk";
 import { withRetry } from "../client.js";
 import { shape } from "../lib/shape.js";
-import { collect, inheritPaginationMetadata, pageSize } from "../lib/pagination.js";
+import { collect, pageSize } from "../lib/pagination.js";
 import { resolveUserId } from "../lib/resolve.js";
 
 export interface UserRow {
@@ -45,7 +45,7 @@ export async function listUsers(
 ): Promise<UserRow[]> {
   const conn = await withRetry(() => client.users({ first: pageSize(limit), includeDisabled }));
   const nodes = await collect(conn as any, limit);
-  return inheritPaginationMetadata(nodes.map(toRow), nodes);
+  return nodes.map(toRow);
 }
 
 export interface UserDetail {

package/src/services/webhook.ts

@@ -9,8 +9,8 @@
 import { type LinearClient, WebhookResourceType } from "@linear/sdk";
 import { withRetry } from "../client.js";
 import { shape } from "../lib/shape.js";
-import { collect, inheritPaginationMetadata, pageSize } from "../lib/pagination.js";
-import { usageError, notFound, normalizeError } from "../lib/errors.js";
+import { collect } from "../lib/pagination.js";
+import { usageError, notFound } from "../lib/errors.js";
 import { assertMutation, unwrapMutation } from "../lib/mutation.js";
 import { resolveTeam } from "../lib/resolve.js";
 
@@ -56,18 +56,17 @@ export const WEBHOOK_ROW_SHAPE = shape<WebhookRow>({
 
 /** All webhooks in the workspace (relation-light, so no N+1). */
 export async function listWebhooks(client: LinearClient, limit: number): Promise<WebhookRow[]> {
-  const conn = await withRetry(() => client.webhooks({ first: pageSize(limit) }));
-  const nodes = await collect(conn as any, limit);
-  return inheritPaginationMetadata(
-    nodes.map((w: any) => ({
-      id: w.id,
-      url: w.url ?? null,
-      enabled: w.enabled,
-      resourceTypes: w.resourceTypes ?? [],
-      label: w.label ?? null,
-    })),
-    nodes,
+  const conn = await withRetry(() =>
+    client.webhooks({ first: limit === Infinity ? 100 : Math.min(limit, 100) }),
   );
+  const nodes = await collect(conn as any, limit);
+  return nodes.map((w: any) => ({
+    id: w.id,
+    url: w.url ?? null,
+    enabled: w.enabled,
+    resourceTypes: w.resourceTypes ?? [],
+    label: w.label ?? null,
+  }));
 }
 
 export interface WebhookDetail {
@@ -175,9 +174,7 @@ export async function updateWebhook(client: LinearClient, id: string, opts: Upda
   if (opts.secret !== undefined) input.secret = opts.secret;
 
   if (Object.keys(input).length === 0)
-    throw usageError(
-      "Nothing to update; pass at least one of --url, --enabled/--disabled, --resource.",
-    );
+    throw usageError("Nothing to update; pass at least one of --url, --enabled/--disabled, --resource.");
 
   return unwrapMutation(
     withRetry(() => client.updateWebhook(id, input as any)),
@@ -187,17 +184,9 @@ export async function updateWebhook(client: LinearClient, id: string, opts: Upda
 }
 
 export async function deleteWebhook(client: LinearClient, id: string): Promise<WebhookDetail> {
-  let webhook: WebhookDetail;
-  try {
-    webhook = await getWebhookDetail(client, id);
-  } catch (err) {
-    const normalized = normalizeError(err);
-    if (normalized.code === "not_found") throw notFound(`No webhook matching '${id}'.`);
-    throw normalized;
-  }
-  await assertMutation(
-    withRetry(() => client.deleteWebhook(id)),
-    "Webhook deletion",
-  );
+  const webhook = await getWebhookDetail(client, id).catch(() => {
+    throw notFound(`No webhook matching '${id}'.`);
+  });
+  await assertMutation(withRetry(() => client.deleteWebhook(id)), "Webhook deletion");
   return webhook;
 }

package/skills/linear-sdk-cli/references/open.md

@@ -1,29 +0,0 @@
-# linear open
-
-> Open the workspace, an issue, team, project, or URL
-
-_Generated from `linear commands --json`. `linear open --help` (or `<subcommand> --help`) is authoritative._
-
-Every command also accepts the global flags `-j/--json`, `--no-input`, `-y/--yes`, `-q/--quiet`, `--workspace <slug>`, `--api-key <key>`, `-t/--team <key>`, `-n/--limit <n>`, `--all`, `-f/--fields <a,b,c>`, `--no-ansi` (alias `--no-color`), and `--debug`. Only command-specific options are listed below.
-
-### `linear open`
-
-Open the workspace, an issue, team, project, or URL
-
-```
-linear open [options] [target]
-```
-
-| Option      | Description                               |
-| ----------- | ----------------------------------------- |
-| `--app`     | open in Linear.app (macOS)                |
-| `-w, --web` | open in the default browser (the default) |
-
-**Output (`--json`)**: a receipt object
-
-```text
-target: string
-url: string
-label: string
-opened: boolean
-```

package/src/commands/open.ts

@@ -1,84 +0,0 @@
-/** `linear open` — open a workspace, team, project, issue, or explicit URL. */
-
-import { Command } from "commander";
-import { action } from "../lib/action.js";
-import { usageError } from "../lib/errors.js";
-import { openUrl } from "../lib/open.js";
-import { normalizeIssueReference, resolveProjectId, resolveTeam } from "../lib/resolve.js";
-import type { Context } from "../context.js";
-import { getIssueDetail } from "../services/issue.js";
-import { getOrganizationDetail } from "../services/organization.js";
-import { getProjectDetail } from "../services/project.js";
-
-const ISSUE_REFERENCE = /^[a-zA-Z][a-zA-Z0-9]*-\d+$/;
-const URL = /^https?:\/\//i;
-type OpenTarget = "workspace" | "team" | "project" | "issue" | "url";
-
-export function registerOpen(program: Command): void {
-  program
-    .command("open [target]")
-    .description("Open the workspace, an issue, team, project, or URL")
-    .option("--app", "open in Linear.app (macOS)")
-    .option("-w, --web", "open in the default browser (the default)")
-    .addHelpText(
-      "after",
-      [
-        "",
-        "Targets: an issue id (TES-123), `team:<key>`, `project:<name>`, or an https URL.",
-        "With no target, opens the current workspace. A bare team key opens that team.",
-      ].join("\n"),
-    )
-    .action(
-      action(async (ctx: Context, opts, target?: string) => {
-        if (opts.app && opts.web) throw usageError("Pass either --web or --app, not both.");
-        const resolved = await resolveOpenTarget(ctx, target);
-        await openUrl(resolved.url, { app: opts.app === true });
-        ctx.output.emit({ ...resolved, opened: true }, () =>
-          ctx.output.success(
-            `Opened ${resolved.label} in ${opts.app ? "Linear.app" : "the browser"}`,
-          ),
-        );
-      }),
-    );
-}
-
-async function resolveOpenTarget(
-  ctx: Context,
-  target: string | undefined,
-): Promise<{ target: OpenTarget; url: string; label: string }> {
-  if (!target) {
-    const org = await getOrganizationDetail(ctx.client);
-    return { target: "workspace", url: `https://linear.app/${org.urlKey}`, label: org.name };
-  }
-  if (URL.test(target)) return { target: "url", url: target, label: target };
-  if (target.startsWith("team:")) {
-    const team = await resolveTeam(ctx.client, target.slice("team:".length), ctx.defaultTeam);
-    const org = await getOrganizationDetail(ctx.client);
-    return {
-      target: "team",
-      url: `https://linear.app/${org.urlKey}/team/${team.key}/all`,
-      label: `${team.key} (${team.name})`,
-    };
-  }
-  if (target.startsWith("project:")) {
-    const project = await getProjectDetail(
-      ctx.client,
-      await resolveProjectId(ctx.client, target.slice("project:".length)),
-    );
-    return { target: "project", url: project.url, label: project.name };
-  }
-  const issueReference = /^\d+$/.test(target)
-    ? normalizeIssueReference(target, ctx.defaultTeam)
-    : target;
-  if (ISSUE_REFERENCE.test(issueReference)) {
-    const issue = await getIssueDetail(ctx.client, issueReference, { includeComments: false });
-    return { target: "issue", url: issue.url, label: issue.identifier };
-  }
-  const team = await resolveTeam(ctx.client, target, ctx.defaultTeam);
-  const org = await getOrganizationDetail(ctx.client);
-  return {
-    target: "team",
-    url: `https://linear.app/${org.urlKey}/team/${team.key}/all`,
-    label: `${team.key} (${team.name})`,
-  };
-}

package/src/lib/open.ts

@@ -1,32 +0,0 @@
-/** Open a Linear URL in the system browser or the macOS Linear app. */
-
-import { execFile } from "node:child_process";
-import { CliError, usageError } from "./errors.js";
-
-export async function openUrl(url: string, opts: { app?: boolean } = {}): Promise<void> {
-  if (opts.app && process.platform !== "darwin") {
-    throw usageError("--app currently requires macOS with Linear.app installed; use --web here.");
-  }
-  const command =
-    process.platform === "darwin"
-      ? "open"
-      : process.platform === "win32"
-        ? "rundll32.exe"
-        : "xdg-open";
-  const args =
-    process.platform === "darwin"
-      ? opts.app
-        ? ["-a", "Linear", url]
-        : [url]
-      : process.platform === "win32"
-        ? ["url.dll,FileProtocolHandler", url]
-        : [url];
-
-  await new Promise<void>((resolve, reject) => {
-    execFile(command, args, { encoding: "utf8" }, (err, _stdout, stderr) => {
-      if (!err) return resolve();
-      const detail = stderr.trim();
-      reject(new CliError(detail || `Failed to open ${url}: ${err.message}`, "runtime"));
-    });
-  });
-}

package/src/output/color.ts

@@ -1,52 +0,0 @@
-/**
- * Resolve terminal colour and debug policy in one place. Both the per-command
- * Context and the top-level error boundary use these helpers, so a parse-time
- * failure behaves exactly like an API result.
- */
-
-export interface ColorPolicy {
-  /** An explicit CLI opt-out (`--no-ansi` / `--no-color`). */
-  disabled?: boolean;
-  /** JSON is a byte-oriented machine format and never carries terminal ANSI. */
-  json?: boolean;
-  /** TTY state of the stream that will receive the text. */
-  isTTY?: boolean;
-  env?: NodeJS.ProcessEnv;
-}
-
-/** Values conventionally used to turn a forcing variable off. */
-function isFalse(value: string): boolean {
-  return value === "0" || value.toLowerCase() === "false";
-}
-
-/**
- * Whether human output should contain ANSI colour.
- *
- * Precedence is deliberately conservative:
- *
- *   CLI opt-out / JSON > NO_COLOR > FORCE_COLOR > CLICOLOR_FORCE > TTY
- *
- * `FORCE_COLOR=0` is also an explicit opt-out, matching the convention used by
- * Node tooling. `CLICOLOR_FORCE=0` merely means "do not force". This lets a
- * caller keep colour while stdout is connected to a pager without ever
- * putting ANSI into JSON.
- */
-export function shouldUseColor(policy: ColorPolicy): boolean {
-  if (policy.disabled === true || policy.json === true) return false;
-
-  const env = policy.env ?? process.env;
-  if (env.NO_COLOR !== undefined) return false;
-
-  if (env.FORCE_COLOR !== undefined) {
-    return !isFalse(env.FORCE_COLOR);
-  }
-  if (env.CLICOLOR_FORCE !== undefined && !isFalse(env.CLICOLOR_FORCE)) return true;
-
-  return policy.isTTY === true;
-}
-
-/** `--debug` and LINEAR_DEBUG are equivalent, with the flag always additive. */
-export function isDebugEnabled(explicit: boolean | undefined, env = process.env): boolean {
-  const value = env.LINEAR_DEBUG?.toLowerCase();
-  return explicit === true || value === "1" || value === "true";
-}