linear-sdk-cli 0.1.0 → 0.1.2

package/src/services/issue.ts

@@ -143,7 +143,7 @@ export interface ListFilters {
 export const MINE_STATE_TYPES = ["unstarted"];
 
 /** The sort orders `issue list` accepts, in `--sort`, env, and config alike. */
-export const ISSUE_SORTS = ["priority", "manual", "updated", "created"] as const;
+export const ISSUE_SORTS = ["priority", "updated", "created"] as const;
 export type IssueSort = (typeof ISSUE_SORTS)[number];
 
 type SortConfig = Pick<
@@ -237,9 +237,7 @@ export async function buildFilter(
   // --all-teams wins over both the flag and the configured default.
   // Uppercase first, then dedupe: `--team tes --team TES` is one team.
   const teamKeys = [
-    ...new Set(
-      asList(f.allTeams ? undefined : (f.team ?? defaultTeamKey)).map((k) => k.toUpperCase()),
-    ),
+    ...new Set(asList(f.allTeams ? undefined : (f.team ?? defaultTeamKey)).map((k) => k.toUpperCase())),
   ];
   // One team keeps the exact `eq` shape it has always sent; several use `in`
   // (the reference CLI spells the same thing as `or: [{ key: { eq } }, …]`).
@@ -371,11 +369,6 @@ export function sortSpec(sort: IssueSort = "priority"): Array<Record<string, unk
       ];
     case "created":
       return [{ createdAt: { order: "Descending" } }];
-    case "manual":
-      // Linear's board order, without injecting workflow-state or priority
-      // grouping. This is the reference CLI's `issue_sort = "manual"` and is
-      // useful when a carefully curated backlog should read exactly as arranged.
-      return [{ manual: { nulls: "last", order: "Ascending" } }];
     case "updated":
       return [{ updatedAt: { order: "Descending" } }];
   }
@@ -493,57 +486,6 @@ function lifecycle(n: any) {
  * flattened to strings here: `team: "TES Test-workspace-bla"` is not even
  * parseable, since a team name can contain spaces.)
  */
-export interface IssueDetailRef {
-  id: string;
-  identifier: string;
-  title: string;
-  state: { id: string; name: string; type: string } | null;
-}
-
-export interface IssueAttachmentDetail {
-  id: string;
-  title: string;
-  url: string;
-  subtitle: string | null;
-  sourceType: string | null;
-  createdAt: string;
-}
-
-export interface IssueDocumentDetail {
-  id: string;
-  title: string;
-  slugId: string;
-  url: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface IssueRelationDetail {
-  id: string;
-  type: string;
-  issue: IssueDetailRef;
-  relatedIssue: IssueDetailRef;
-}
-
-/**
- * A comment embedded in `IssueDetail`. It is a superset of the shared comment
- * row: external authors and resolution metadata are retained so a caller can
- * reconstruct threads without another request.
- */
-export interface IssueCommentDetail {
-  id: string;
-  body: string;
-  url: string;
-  createdAt: string;
-  editedAt: string | null;
-  resolvedAt: string | null;
-  parent: { id: string } | null;
-  user: { id: string; displayName: string } | null;
-  externalUser: { id: string; displayName: string } | null;
-  resolvingCommentId: string | null;
-  resolvingUser: { id: string; displayName: string } | null;
-}
-
 export interface IssueDetail {
   id: string;
   identifier: string;
@@ -568,15 +510,9 @@ export interface IssueDetail {
   project: { id: string; name: string } | null;
   milestone: { id: string; name: string } | null;
   cycle: { id: string; number: number; name: string | null } | null;
-  parent: IssueDetailRef | null;
-  children: IssueDetailRef[];
+  parent: { id: string; identifier: string } | null;
   labels: Array<{ id: string; name: string }>;
   subscribers: Array<{ id: string; displayName: string }>;
-  attachments: IssueAttachmentDetail[];
-  documents: IssueDocumentDetail[];
-  relations: IssueRelationDetail[];
-  inverseRelations: IssueRelationDetail[];
-  comments: IssueCommentDetail[];
 }
 
 /** The detail's shape as `linear commands` advertises it; checked against `IssueDetail`. */
@@ -604,95 +540,9 @@ export const ISSUE_DETAIL_SHAPE = shape<IssueDetail>({
   project: { nullable: { id: "string", name: "string" } },
   milestone: { nullable: { id: "string", name: "string" } },
   cycle: { nullable: { id: "string", number: "number", name: "string|null" } },
-  parent: {
-    nullable: {
-      id: "string",
-      identifier: "string",
-      title: "string",
-      state: { nullable: { id: "string", name: "string", type: "string" } },
-    },
-  },
-  children: [
-    {
-      id: "string",
-      identifier: "string",
-      title: "string",
-      state: { nullable: { id: "string", name: "string", type: "string" } },
-    },
-  ],
+  parent: { nullable: { id: "string", identifier: "string" } },
   labels: [{ id: "string", name: "string" }],
   subscribers: [{ id: "string", displayName: "string" }],
-  attachments: [
-    {
-      id: "string",
-      title: "string",
-      url: "string",
-      subtitle: "string|null",
-      sourceType: "string|null",
-      createdAt: "string",
-    },
-  ],
-  documents: [
-    {
-      id: "string",
-      title: "string",
-      slugId: "string",
-      url: "string",
-      createdAt: "string",
-      updatedAt: "string",
-    },
-  ],
-  relations: [
-    {
-      id: "string",
-      type: "string",
-      issue: {
-        id: "string",
-        identifier: "string",
-        title: "string",
-        state: { nullable: { id: "string", name: "string", type: "string" } },
-      },
-      relatedIssue: {
-        id: "string",
-        identifier: "string",
-        title: "string",
-        state: { nullable: { id: "string", name: "string", type: "string" } },
-      },
-    },
-  ],
-  inverseRelations: [
-    {
-      id: "string",
-      type: "string",
-      issue: {
-        id: "string",
-        identifier: "string",
-        title: "string",
-        state: { nullable: { id: "string", name: "string", type: "string" } },
-      },
-      relatedIssue: {
-        id: "string",
-        identifier: "string",
-        title: "string",
-        state: { nullable: { id: "string", name: "string", type: "string" } },
-      },
-    },
-  ],
-  comments: [
-    {
-      id: "string",
-      body: "string",
-      url: "string",
-      createdAt: "string",
-      editedAt: "string|null",
-      resolvedAt: "string|null",
-      parent: { nullable: { id: "string" } },
-      user: { nullable: { id: "string", displayName: "string" } },
-      externalUser: { nullable: { id: "string", displayName: "string" } },
-      resolvingCommentId: "string|null",
-      resolvingUser: { nullable: { id: "string", displayName: "string" } },
-    },
-  ],
 });
 
 /**
@@ -707,7 +557,7 @@ export const ISSUE_DETAIL_SHAPE = shape<IssueDetail>({
  * depends on the API accepting human identifiers in `issue(id:)`.
  */
 const DETAIL_QUERY = `
-query CliIssueDetail($filter: IssueFilter!, $includeComments: Boolean!) {
+query CliIssueDetail($filter: IssueFilter!) {
   issues(filter: $filter, first: 1, includeArchived: true) {
     nodes {
       id identifier title description priority priorityLabel estimate url branchName dueDate
@@ -718,39 +568,9 @@ query CliIssueDetail($filter: IssueFilter!, $includeComments: Boolean!) {
       project { id name }
       projectMilestone { id name }
       cycle { id number name }
-      parent { id identifier title state { id name type } }
-      children(first: 250) { nodes { id identifier title state { id name type } } }
+      parent { id identifier }
       labels(first: 50) { nodes { id name } }
       subscribers(first: 50) { nodes { id displayName } }
-      attachments(first: 50) {
-        nodes { id title url subtitle sourceType createdAt }
-      }
-      documents(first: 50) {
-        nodes { id title slugId url createdAt updatedAt }
-      }
-      relations(first: 50) {
-        nodes {
-          id type
-          issue { id identifier title state { id name type } }
-          relatedIssue { id identifier title state { id name type } }
-        }
-      }
-      inverseRelations(first: 50) {
-        nodes {
-          id type
-          issue { id identifier title state { id name type } }
-          relatedIssue { id identifier title state { id name type } }
-        }
-      }
-      comments(first: 50, orderBy: createdAt) @include(if: $includeComments) {
-        nodes {
-          id body url createdAt editedAt resolvedAt resolvingCommentId
-          parent { id }
-          user { id displayName }
-          externalUser { id displayName }
-          resolvingUser { id displayName }
-        }
-      }
     }
   }
 }`;
@@ -761,28 +581,15 @@ const IDENTIFIER_RE = /^([a-zA-Z][a-zA-Z0-9]*)-(\d+)$/;
 function detailFilter(input: string): { filter: Record<string, unknown>; label: string } {
   if (isUuid(input)) return { filter: { id: { eq: input } }, label: input };
   const match = input.match(IDENTIFIER_RE);
-  if (!match)
-    throw usageError(`'${input}' is not a valid issue id (expected e.g. TES-123 or a UUID).`);
+  if (!match) throw usageError(`'${input}' is not a valid issue id (expected e.g. TES-123 or a UUID).`);
   const key = match[1]!.toUpperCase();
   const number = Number.parseInt(match[2]!, 10);
-  return {
-    filter: { team: { key: { eq: key } }, number: { eq: number } },
-    label: `${key}-${number}`,
-  };
+  return { filter: { team: { key: { eq: key } }, number: { eq: number } }, label: `${key}-${number}` };
 }
 
-export async function getIssueDetail(
-  client: LinearClient,
-  idArg: string,
-  opts: { includeComments?: boolean } = {},
-): Promise<IssueDetail> {
+export async function getIssueDetail(client: LinearClient, idArg: string): Promise<IssueDetail> {
   const { filter, label } = detailFilter(idArg);
-  const data: any = await withRetry(() =>
-    (client as any).client.rawRequest(DETAIL_QUERY, {
-      filter,
-      includeComments: opts.includeComments !== false,
-    }),
-  );
+  const data: any = await withRetry(() => (client as any).client.rawRequest(DETAIL_QUERY, { filter }));
   const n = data.data?.issues?.nodes?.[0];
   if (!n) throw notFound(`No issue ${label}.`);
   return {
@@ -806,38 +613,8 @@ export async function getIssueDetail(
     milestone: n.projectMilestone ?? null,
     cycle: cycleRef(n.cycle),
     parent: n.parent ?? null,
-    children: n.children?.nodes ?? [],
     labels: n.labels?.nodes ?? [],
     subscribers: n.subscribers?.nodes ?? [],
-    attachments: (n.attachments?.nodes ?? []).map((a: any) => ({
-      id: a.id,
-      title: a.title,
-      url: a.url,
-      subtitle: a.subtitle ?? null,
-      sourceType: a.sourceType ?? null,
-      createdAt: a.createdAt,
-    })),
-    documents: n.documents?.nodes ?? [],
-    relations: n.relations?.nodes ?? [],
-    inverseRelations: n.inverseRelations?.nodes ?? [],
-    comments: (n.comments?.nodes ?? []).map(toIssueCommentDetail),
-  };
-}
-
-/** Normalize nullable comment relations while preserving thread metadata. */
-function toIssueCommentDetail(c: any): IssueCommentDetail {
-  return {
-    id: c.id,
-    body: c.body,
-    url: c.url,
-    createdAt: c.createdAt,
-    editedAt: c.editedAt ?? null,
-    resolvedAt: c.resolvedAt ?? null,
-    parent: c.parent ?? null,
-    user: c.user ?? null,
-    externalUser: c.externalUser ?? null,
-    resolvingCommentId: c.resolvingCommentId ?? null,
-    resolvingUser: c.resolvingUser ?? null,
   };
 }
 
@@ -896,8 +673,7 @@ export async function createIssue(
   }
   if (opts.milestone) {
     // Resolved after the parent so a milestone can name one in the inherited project.
-    if (!input.projectId)
-      throw usageError("A milestone requires --project (or a --parent in a project).");
+    if (!input.projectId) throw usageError("A milestone requires --project (or a --parent in a project).");
     input.projectMilestoneId = await resolveMilestoneId(client, input.projectId, opts.milestone);
   }
   if (opts.cycle) input.cycleId = await resolveCycleId(client, team.id, opts.cycle);
@@ -927,8 +703,6 @@ export interface UpdateOptions {
   estimate?: number;
   parent?: string;
   dueDate?: string;
-  /** Replace the complete label set (including `[]` to clear it). */
-  label?: string[];
   addLabel?: string[];
   removeLabel?: string[];
   /** Clear the assignee. Mutually exclusive with `assignee`. */
@@ -943,8 +717,6 @@ export async function updateIssue(client: LinearClient, idArg: string, opts: Upd
     throw usageError("Pass either --assignee or --unassign, not both.");
   if (opts.clearCycle && opts.cycle)
     throw usageError("Pass either --cycle or --clear-cycle, not both.");
-  if (opts.label !== undefined && (opts.addLabel !== undefined || opts.removeLabel !== undefined))
-    throw usageError("Pass either --label (replace all) or --add-label/--remove-label, not both.");
 
   const issue = await resolveIssue(client, idArg);
   const currentTeamId = (await issue.team)?.id;
@@ -973,9 +745,7 @@ export async function updateIssue(client: LinearClient, idArg: string, opts: Upd
   if (opts.project) input.projectId = await resolveProjectId(client, opts.project);
   if (opts.cycle && teamId) input.cycleId = await resolveCycleId(client, teamId, opts.cycle);
   if (opts.parent) input.parentId = (await resolveIssue(client, opts.parent)).id;
-  if (opts.label !== undefined) input.labelIds = await resolveLabelIds(client, opts.label, teamId);
-  if (opts.addLabel?.length)
-    input.addedLabelIds = await resolveLabelIds(client, opts.addLabel, teamId);
+  if (opts.addLabel?.length) input.addedLabelIds = await resolveLabelIds(client, opts.addLabel, teamId);
   if (opts.removeLabel?.length)
     input.removedLabelIds = await resolveLabelIds(client, opts.removeLabel, teamId);
   if (opts.milestone) {
@@ -985,8 +755,7 @@ export async function updateIssue(client: LinearClient, idArg: string, opts: Upd
     input.projectMilestoneId = await resolveMilestoneId(client, projectId, opts.milestone);
   }
 
-  if (Object.keys(input).length === 0)
-    throw usageError("Nothing to update; pass at least one field.");
+  if (Object.keys(input).length === 0) throw usageError("Nothing to update; pass at least one field.");
   // The updated issue comes from the payload, never from `issue` — falling back
   // to the pre-mutation entity would print "Updated TES-1" for a write the API
   // refused.
@@ -1008,19 +777,14 @@ export async function archiveIssue(client: LinearClient, idArg: string, unarchiv
 
 export async function deleteIssue(client: LinearClient, idArg: string) {
   const issue = await resolveIssue(client, idArg);
-  await assertMutation(
-    withRetry(() => client.deleteIssue(issue.id)),
-    "Issue deletion",
-  );
+  await assertMutation(withRetry(() => client.deleteIssue(issue.id)), "Issue deletion");
   return issue;
 }
 
 export async function setSubscription(client: LinearClient, idArg: string, subscribe: boolean) {
   const issue = await resolveIssue(client, idArg);
   await assertMutation(
-    withRetry(() =>
-      subscribe ? client.issueSubscribe(issue.id) : client.issueUnsubscribe(issue.id),
-    ),
+    withRetry(() => (subscribe ? client.issueSubscribe(issue.id) : client.issueUnsubscribe(issue.id))),
     subscribe ? "Issue subscribe" : "Issue unsubscribe",
   );
   return issue;
@@ -1047,10 +811,7 @@ export async function moveIssueState(client: LinearClient, issue: Issue, opts: S
   const stateId = opts.stateInput
     ? await resolveStateId(client, teamId, opts.stateInput)
     : await firstStateOfType(client, teamId, "started");
-  await assertMutation(
-    withRetry(() => client.updateIssue(issue.id, { stateId })),
-    "Issue update",
-  );
+  await assertMutation(withRetry(() => client.updateIssue(issue.id, { stateId })), "Issue update");
 }
 
 export async function startIssue(client: LinearClient, idArg: string, opts: StartMove) {
@@ -1074,11 +835,7 @@ export async function addRemoveRelation(
   if (op === "add") {
     await assertMutation(
       withRetry(() =>
-        client.createIssueRelation({
-          issueId: from.id,
-          relatedIssueId: to.id,
-          type: apiType as any,
-        }),
+        client.createIssueRelation({ issueId: from.id, relatedIssueId: to.id, type: apiType as any }),
       ),
       "Relation creation",
     );
@@ -1091,8 +848,7 @@ export async function addRemoveRelation(
       collect((await withRetry(() => from.inverseRelations())) as any, Infinity),
     ]);
     const match = await findRelation([...direct, ...inverse] as any[], from.id, to.id, apiType);
-    if (!match)
-      throw notFound(`No ${type} relation between ${issue.identifier} and ${other.identifier}.`);
+    if (!match) throw notFound(`No ${type} relation between ${issue.identifier} and ${other.identifier}.`);
     await assertMutation(
       withRetry(() => client.deleteIssueRelation(match.id)),
       "Relation removal",

package/src/services/label.ts

@@ -78,14 +78,7 @@ export async function listLabels(
     filter = { or: [{ team: { key: { eq: team.key } } }, { team: { null: true } }] };
   }
 
-  return collectRawQuery<LabelRow>(
-    client as any,
-    LIST_QUERY,
-    { filter },
-    "issueLabels",
-    limit,
-    toLabelRow,
-  );
+  return collectRawQuery<LabelRow>(client as any, LIST_QUERY, { filter }, "issueLabels", limit, toLabelRow);
 }
 
 /** Map a tailored-query label node to a display row. */
@@ -168,10 +161,7 @@ export async function deleteLabel(client: LinearClient, idArg: string) {
   const id = await resolveLabel(client, idArg);
   // Fetch the label first so we can report its name after deletion.
   const label = await withRetry(() => client.issueLabel(id));
-  await assertMutation(
-    withRetry(() => client.deleteIssueLabel(id)),
-    "Label deletion",
-  );
+  await assertMutation(withRetry(() => client.deleteIssueLabel(id)), "Label deletion");
   return label;
 }
 

package/src/services/milestone.ts

@@ -11,12 +11,7 @@
 import type { LinearClient } from "@linear/sdk";
 import { withRetry } from "../client.js";
 import { shape } from "../lib/shape.js";
-import {
-  collect,
-  inheritPaginationMetadata,
-  pageSize,
-  pageSizeForMore,
-} from "../lib/pagination.js";
+import { collect, pageSizeForMore } from "../lib/pagination.js";
 import { usageError, notFound } from "../lib/errors.js";
 import { assertMutation, unwrapMutation } from "../lib/mutation.js";
 import { resolveProjectId, resolveMilestoneId, isUuid } from "../lib/resolve.js";
@@ -59,9 +54,11 @@ export async function listMilestones(
 ): Promise<MilestoneRow[]> {
   const projectId = await resolveProjectId(client, projectInput);
   const project = await withRetry(() => client.project(projectId));
-  const conn = await withRetry(() => project.projectMilestones({ first: pageSize(limit) }));
+  const conn = await withRetry(() =>
+    project.projectMilestones({ 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 MilestoneDetail {

package/src/services/notification.ts

@@ -14,7 +14,7 @@ import { withRetry } from "../client.js";
 import { shape } from "../lib/shape.js";
 import { collectRawQuery } from "../lib/pagination.js";
 import { assertMutation } from "../lib/mutation.js";
-import { normalizeError, usageError } from "../lib/errors.js";
+import { normalizeError } from "../lib/errors.js";
 
 export interface NotificationRow {
   id: string;
@@ -122,11 +122,7 @@ export interface MarkAllItem {
   error?: string;
 }
 
-export const MARK_ALL_ITEM_SHAPE = shape<MarkAllItem>({
-  id: "string",
-  read: "boolean",
-  "error?": "string",
-});
+export const MARK_ALL_ITEM_SHAPE = shape<MarkAllItem>({ id: "string", read: "boolean", "error?": "string" });
 
 /**
  * Mark all of the viewer's unread notifications as read. The SDK's
@@ -172,16 +168,6 @@ export async function archiveNotification(client: LinearClient, id: string): Pro
 
 /** Snooze a notification until the given ISO timestamp. */
 export async function snoozeNotification(client: LinearClient, id: string, untilISO: string) {
-  if (
-    !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,9})?)?(?:Z|[+-]\d{2}:\d{2})$/.test(
-      untilISO,
-    ) ||
-    !Number.isFinite(Date.parse(untilISO))
-  ) {
-    throw usageError(
-      `Invalid snooze timestamp '${untilISO}'. Use ISO 8601 with a timezone, e.g. 2026-07-01T09:00:00Z.`,
-    );
-  }
   await assertMutation(
     withRetry(() => client.updateNotification(id, { snoozedUntilAt: untilISO } as any)),
     "Notification snooze",

package/src/services/organization.ts

@@ -11,7 +11,8 @@
 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 { pageSize } from "../lib/pagination.js";
 
 export interface OrganizationDetail {
   id: string;
@@ -82,17 +83,14 @@ export const ORGANIZATION_MEMBER_ROW_SHAPE = shape<MemberRow>({
 export async function listMembers(client: LinearClient, limit: number): Promise<MemberRow[]> {
   const conn = await withRetry(() => client.users({ first: pageSize(limit) }));
   const nodes = await collect(conn as any, limit);
-  return inheritPaginationMetadata(
-    nodes.map((u: any) => ({
-      id: u.id,
-      displayName: u.displayName,
-      name: u.name,
-      email: u.email,
-      admin: !!u.admin,
-      active: !!u.active,
-    })),
-    nodes,
-  );
+  return nodes.map((u: any) => ({
+    id: u.id,
+    displayName: u.displayName,
+    name: u.name,
+    email: u.email,
+    admin: !!u.admin,
+    active: !!u.active,
+  }));
 }
 
 export interface InviteRow {
@@ -130,15 +128,12 @@ export function inviteStatus(invite: { acceptedAt?: unknown; expiresAt?: unknown
 export async function listInvites(client: LinearClient, limit: number): Promise<InviteRow[]> {
   const conn = await withRetry(() => client.organizationInvites({ first: pageSize(limit) }));
   const nodes = await collect(conn as any, limit);
-  return inheritPaginationMetadata(
-    nodes.map((i: any) => ({
-      id: i.id,
-      email: i.email,
-      status: inviteStatus(i),
-      role: i.role ?? "member",
-      external: !!i.external,
-      createdAt: i.createdAt?.toISOString?.() ?? String(i.createdAt),
-    })),
-    nodes,
-  );
+  return nodes.map((i: any) => ({
+    id: i.id,
+    email: i.email,
+    status: inviteStatus(i),
+    role: i.role ?? "member",
+    external: !!i.external,
+    createdAt: i.createdAt?.toISOString?.() ?? String(i.createdAt),
+  }));
 }