@enrichlayer/el-linear 1.9.0 → 1.15.0

package/dist/queries/issues-types.d.ts

@@ -0,0 +1,481 @@
+/**
+ * Typed response shapes for the GraphQL queries in `./issues.ts`.
+ *
+ * Pre-fix, every consumer used `GraphQLResponseData` (a recursive
+ * `Record<string, unknown>`) and re-cast every field with `as
+ * string` / `as GraphQLResponseData`. A renamed Linear field would
+ * silently produce `undefined` at runtime; transformers had no
+ * compile-time check that they were reading the fields the queries
+ * actually requested.
+ *
+ * These interfaces mirror the shape of `COMPLETE_ISSUE_FRAGMENT` /
+ * `COMPLETE_ISSUE_WITH_COMMENTS_FRAGMENT` (defined in
+ * `./common.ts`) so the transformer can consume a typed node and
+ * the compiler catches drift between query and consumer.
+ *
+ * Pattern for adding new types: define a `Foo` node interface +
+ * a `GetFooResponse` (or list-shape) wrapper. Co-locate them in
+ * this file or a sibling `*-types.ts` so they live next to the
+ * query string.
+ *
+ * Refs ALL-937.
+ */
+import type { LinearPriority } from "../types/linear.js";
+/** A reference to a related entity — id + display fields. */
+interface IdNameRef {
+    id: string;
+    name: string;
+}
+interface IdKeyNameRef {
+    id: string;
+    key: string;
+    name: string;
+}
+interface IdIdentifierTitleRef {
+    id: string;
+    identifier: string;
+    title: string;
+}
+interface AssigneeNode {
+    id: string;
+    name: string;
+    url?: string;
+}
+/**
+ * Comment shape as embedded inside `COMPLETE_ISSUE_WITH_COMMENTS_FRAGMENT`
+ * (i.e. comments fetched as part of an issue query). Distinct from
+ * `comments-types.ts:CommentResourceNode`, which is the shape returned by
+ * the standalone comment queries (`LIST_COMMENTS_QUERY`,
+ * `CREATE_COMMENT_MUTATION`, `UPDATE_COMMENT_MUTATION`). The two have
+ * incompatible `user` shapes — this one allows `null` and uses the
+ * issue-page \"assignee\"-style fields, while the standalone resource
+ * shape always populates `user` and includes the comment-author-only
+ * `CommentUserRef` fields (DEV-4068 T2).
+ */
+export interface IssueCommentNode {
+    id: string;
+    body: string;
+    createdAt: string;
+    updatedAt: string;
+    user: AssigneeNode | null;
+}
+interface CycleNode {
+    id: string;
+    name: string | null;
+    number: number;
+}
+interface ProjectMilestoneNode {
+    id: string;
+    name: string;
+    targetDate: string | null;
+}
+/**
+ * Linear's documented generation states for issue summaries. If Linear
+ * adds a new state in the future the runtime API would deserialize the
+ * new string verbatim — TypeScript wouldn't catch the divergence, but
+ * the typical `=== "completed"` check keeps working safely. Widen the
+ * union here when Linear documents a new state.
+ */
+type IssueSummaryGenerationStatus = "completed" | "pending" | "failed";
+interface IssueSummary {
+    content: unknown;
+    generationStatus: IssueSummaryGenerationStatus;
+}
+/**
+ * Mirrors `COMPLETE_ISSUE_FRAGMENT` from `src/queries/common.ts`.
+ * The transformer in `graphql-issues-service.ts` reads these
+ * fields. Keep the shapes in lock-step — if you add a field to
+ * the fragment, add it here.
+ */
+export interface IssueNode {
+    id: string;
+    identifier: string;
+    title: string;
+    description: string | null;
+    summary: IssueSummary | null;
+    branchName: string;
+    priority: LinearPriority;
+    estimate: number | null;
+    dueDate: string | null;
+    url: string;
+    createdAt: string;
+    updatedAt: string;
+    state: IdNameRef | null;
+    assignee: AssigneeNode | null;
+    delegate: AssigneeNode | null;
+    team: IdKeyNameRef | null;
+    project: IdNameRef | null;
+    labels: {
+        nodes: IdNameRef[];
+    };
+    cycle: CycleNode | null;
+    projectMilestone: ProjectMilestoneNode | null;
+    parent: IdIdentifierTitleRef | null;
+    children: {
+        nodes: IdIdentifierTitleRef[];
+    };
+}
+/**
+ * Mirrors `COMPLETE_ISSUE_WITH_COMMENTS_FRAGMENT` — same as
+ * `IssueNode` but with the comments connection materialized.
+ */
+export interface IssueWithCommentsNode extends IssueNode {
+    comments: {
+        nodes: IssueCommentNode[];
+    };
+}
+/** Response shape for `GET_ISSUE_BY_ID_QUERY`. */
+export interface GetIssueByIdResponse {
+    issue: IssueWithCommentsNode | null;
+}
+/** Response shape for `GET_ISSUE_BY_IDENTIFIER_QUERY`. */
+export interface GetIssueByIdentifierResponse {
+    issues: {
+        nodes: IssueWithCommentsNode[];
+    };
+}
+/** Response shape for `GET_ISSUES_QUERY`. */
+export interface GetIssuesResponse {
+    issues: {
+        nodes: IssueNode[];
+    };
+}
+/** Response shape for `SEARCH_ISSUES_QUERY` (full-text). */
+export interface SearchIssuesResponse {
+    searchIssues: {
+        nodes: IssueNode[];
+    };
+}
+/** Response shape for `CREATE_ISSUE_MUTATION`. */
+export interface CreateIssueResponse {
+    issueCreate: {
+        success: boolean;
+        issue: IssueNode | null;
+    };
+}
+/** Response shape for `UPDATE_ISSUE_MUTATION`. */
+export interface UpdateIssueResponse {
+    issueUpdate: {
+        success: boolean;
+        issue: IssueNode | null;
+    };
+}
+export interface IssueArchiveEntity {
+    id: string;
+}
+interface IssueArchivePayload {
+    success: boolean;
+    lastSyncId: number;
+    entity: IssueArchiveEntity | null;
+}
+/** Response shape for `ARCHIVE_ISSUE_MUTATION`. */
+export interface ArchiveIssueResponse {
+    issueArchive: IssueArchivePayload;
+}
+/** Response shape for `DELETE_ISSUE_MUTATION`. */
+export interface DeleteIssueResponse {
+    issueDelete: IssueArchivePayload;
+}
+/** Response shape for `GET_ISSUE_TEAM_QUERY`. */
+export interface GetIssueTeamResponse {
+    issue: {
+        team: {
+            id: string;
+        } | null;
+    } | null;
+}
+type WorkflowStateType = "triage" | "backlog" | "unstarted" | "started" | "completed" | "canceled";
+export interface IssueStartContextResponse {
+    issue: {
+        id: string;
+        identifier: string;
+        state: {
+            id: string;
+            name: string;
+            type: WorkflowStateType;
+        } | null;
+        team: {
+            id: string;
+            key: string;
+            name: string;
+        } | null;
+        delegate: AssigneeNode | null;
+    } | null;
+}
+export interface TeamStartedStatusesResponse {
+    team: {
+        states: {
+            nodes: {
+                id: string;
+                name: string;
+                position: number;
+            }[];
+        };
+    } | null;
+}
+/**
+ * Issue summary returned by `GET_ISSUE_RELATIONS_QUERY` on the
+ * `relatedIssue` / `issue` peer of each relation. Smaller than
+ * `IssueNode` — just enough to display a sidebar entry.
+ */
+export interface RelationPeerNode {
+    id: string;
+    identifier: string;
+    title: string;
+    state: {
+        id: string;
+        name: string;
+    } | null;
+    priority: LinearPriority | null;
+    assignee: {
+        id: string;
+        name: string;
+    } | null;
+    team: {
+        id: string;
+        key: string;
+        name: string;
+    } | null;
+}
+export interface RelationOutgoingNode {
+    id: string;
+    type: string;
+    relatedIssue: RelationPeerNode | null;
+}
+export interface RelationIncomingNode {
+    id: string;
+    type: string;
+    issue: RelationPeerNode | null;
+}
+export interface BatchResolveProjectMilestoneRef {
+    id: string;
+    name: string;
+}
+interface BatchResolveProjectNode {
+    id: string;
+    name: string;
+    /** Present on `BATCH_RESOLVE_FOR_CREATE_QUERY`. */
+    teams?: {
+        nodes: {
+            id: string;
+            key: string;
+        }[];
+    };
+    /** Present on `BATCH_RESOLVE_FOR_CREATE_QUERY` and `BATCH_RESOLVE_FOR_UPDATE_QUERY`. */
+    projectMilestones?: {
+        nodes: BatchResolveProjectMilestoneRef[];
+    };
+}
+export interface BatchResolveLabelNode {
+    id: string;
+    name: string;
+    isGroup: boolean;
+    team: {
+        id: string;
+    } | null;
+}
+interface BatchResolveIssueForUpdate {
+    id: string;
+    identifier: string;
+    team: {
+        id: string;
+        key: string;
+    } | null;
+    labels: {
+        nodes: {
+            id: string;
+            name: string;
+        }[];
+    };
+    project: {
+        id: string;
+        projectMilestones: {
+            nodes: BatchResolveProjectMilestoneRef[];
+        };
+    } | null;
+}
+export interface BatchResolveForCreateResponse {
+    teams: {
+        nodes: {
+            id: string;
+            key: string;
+            name: string;
+        }[];
+    };
+    projectsByName?: {
+        nodes: BatchResolveProjectNode[];
+    };
+    projectsById?: {
+        nodes: BatchResolveProjectNode[];
+    };
+    milestones?: {
+        nodes: BatchResolveProjectMilestoneRef[];
+    };
+    parentIssues: {
+        nodes: {
+            id: string;
+            identifier: string;
+        }[];
+    };
+}
+export interface BatchResolveForSearchResponse {
+    delegates?: {
+        nodes: {
+            id: string;
+            name: string;
+            email: string;
+        }[];
+    };
+    teams: {
+        nodes: {
+            id: string;
+            key: string;
+            name: string;
+        }[];
+    };
+    projects?: {
+        nodes: BatchResolveProjectNode[];
+    };
+    users: {
+        nodes: {
+            id: string;
+            name: string;
+            email: string;
+        }[];
+    };
+}
+export interface BatchResolveForUpdateResponse {
+    projectsByName?: {
+        nodes: BatchResolveProjectNode[];
+    };
+    projectsById?: {
+        nodes: BatchResolveProjectNode[];
+    };
+    milestones?: {
+        nodes: BatchResolveProjectMilestoneRef[];
+    };
+    issues: {
+        nodes: BatchResolveIssueForUpdate[];
+    };
+}
+export interface ResolveLabelsByNameResponse {
+    labels: {
+        nodes: BatchResolveLabelNode[];
+    };
+}
+/**
+ * Merged blob threaded through the field-resolution helpers. All
+ * fields are optional because the helpers don't know which batch
+ * query produced the result — they read only what they need.
+ */
+export interface BatchResolveResult {
+    teams?: {
+        nodes: {
+            id: string;
+            key: string;
+            name: string;
+        }[];
+    };
+    projects?: {
+        nodes: BatchResolveProjectNode[];
+    };
+    milestones?: {
+        nodes: BatchResolveProjectMilestoneRef[];
+    };
+    parentIssues?: {
+        nodes: {
+            id: string;
+            identifier: string;
+        }[];
+    };
+    users?: {
+        nodes: {
+            id: string;
+            name: string;
+            email: string;
+        }[];
+    };
+    delegates?: {
+        nodes: {
+            id: string;
+            name: string;
+            email: string;
+        }[];
+    };
+    issues?: {
+        nodes: BatchResolveIssueForUpdate[];
+    };
+    labels?: {
+        nodes: BatchResolveLabelNode[];
+    };
+}
+/** Response shape for `GET_ISSUE_RELATIONS_QUERY`. */
+export interface GetIssueRelationsResponse {
+    issue: {
+        id: string;
+        identifier: string;
+        title: string;
+        description: string | null;
+        relations: {
+            nodes: RelationOutgoingNode[];
+        };
+        inverseRelations: {
+            nodes: RelationIncomingNode[];
+        };
+    } | null;
+}
+/**
+ * Response shape for `ISSUE_RELATION_CREATE_MUTATION`. The relation
+ * carries both `issue` and `relatedIssue` peers because the caller
+ * decides which side to display based on `reverse`.
+ */
+export interface IssueRelationCreateResponse {
+    issueRelationCreate: {
+        success: boolean;
+        issueRelation: {
+            id: string;
+            type: string;
+            issue: {
+                id: string;
+                identifier: string;
+                title: string;
+            };
+            relatedIssue: {
+                id: string;
+                identifier: string;
+                title: string;
+            };
+        } | null;
+    };
+}
+/** Response shape for `SCAN_ISSUES_QUERY`. */
+export interface ScanIssuesResponse {
+    issues: {
+        nodes: {
+            id: string;
+            identifier: string;
+            description: string | null;
+        }[];
+    };
+}
+interface IssueStateSpanNode {
+    state: {
+        id: string;
+        name: string;
+        type: string;
+    };
+    startedAt: string;
+    endedAt: string | null;
+}
+/** Response shape for `GET_ISSUE_STATE_HISTORY_QUERY`. */
+export interface GetIssueStateHistoryResponse {
+    issue: {
+        id: string;
+        identifier: string;
+        title: string;
+        stateHistory: {
+            nodes: IssueStateSpanNode[];
+        };
+    } | null;
+}
+export {};

package/dist/queries/issues-types.js

@@ -0,0 +1,23 @@
+/**
+ * Typed response shapes for the GraphQL queries in `./issues.ts`.
+ *
+ * Pre-fix, every consumer used `GraphQLResponseData` (a recursive
+ * `Record<string, unknown>`) and re-cast every field with `as
+ * string` / `as GraphQLResponseData`. A renamed Linear field would
+ * silently produce `undefined` at runtime; transformers had no
+ * compile-time check that they were reading the fields the queries
+ * actually requested.
+ *
+ * These interfaces mirror the shape of `COMPLETE_ISSUE_FRAGMENT` /
+ * `COMPLETE_ISSUE_WITH_COMMENTS_FRAGMENT` (defined in
+ * `./common.ts`) so the transformer can consume a typed node and
+ * the compiler catches drift between query and consumer.
+ *
+ * Pattern for adding new types: define a `Foo` node interface +
+ * a `GetFooResponse` (or list-shape) wrapper. Co-locate them in
+ * this file or a sibling `*-types.ts` so they live next to the
+ * query string.
+ *
+ * Refs ALL-937.
+ */
+export {};

package/dist/queries/issues.d.ts

@@ -1,13 +1,52 @@
-export declare const GET_ISSUES_QUERY = "\n  query GetIssues($first: Int!, $orderBy: PaginationOrderBy) {\n    issues(\n      first: $first\n      orderBy: $orderBy\n      filter: {\n        state: { type: { neq: \"completed\" } }\n      }\n    ) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
-export declare const SEARCH_ISSUES_QUERY = "\n  query SearchIssues($term: String!, $first: Int!) {\n    searchIssues(term: $term, first: $first, includeArchived: false) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
-export declare const FILTERED_SEARCH_ISSUES_QUERY = "\n  query FilteredSearchIssues(\n    $first: Int!\n    $filter: IssueFilter\n    $orderBy: PaginationOrderBy\n  ) {\n    issues(\n      first: $first\n      filter: $filter\n      orderBy: $orderBy\n      includeArchived: false\n    ) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
-export declare const BATCH_RESOLVE_FOR_SEARCH_QUERY = "\n  query BatchResolveForSearch(\n    $teamKey: String\n    $teamName: String\n    $projectName: String\n    $assigneeEmail: String\n  ) {\n    teams(\n      filter: {\n        or: [\n          { key: { eq: $teamKey } }\n          { name: { eqIgnoreCase: $teamName } }\n        ]\n      }\n      first: 1\n    ) {\n      nodes {\n        id\n        key\n        name\n      }\n    }\n\n    projects(filter: { name: { eqIgnoreCase: $projectName } }, first: 1) {\n      nodes {\n        id\n        name\n      }\n    }\n\n    users(filter: { email: { eq: $assigneeEmail } }, first: 1) {\n      nodes {\n        id\n        name\n        email\n      }\n    }\n  }\n";
-export declare const GET_ISSUE_BY_ID_QUERY = "\n  query GetIssue($id: String!) {\n    issue(id: $id) {\n      \n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n\n    }\n  }\n";
-export declare const GET_ISSUE_BY_IDENTIFIER_QUERY = "\n  query GetIssueByIdentifier($teamKey: String!, $number: Float!) {\n    issues(\n      filter: {\n        team: { key: { eq: $teamKey } }\n        number: { eq: $number }\n      }\n      first: 1\n    ) {\n      nodes {\n        \n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n\n      }\n    }\n  }\n";
-export declare const BATCH_RESOLVE_FOR_UPDATE_QUERY = "\n  query BatchResolveForUpdate(\n    $projectName: String\n    $teamKey: String\n    $issueNumber: Float\n    $milestoneName: String\n  ) {\n    projects(filter: { name: { eqIgnoreCase: $projectName } }, first: 1) {\n      nodes {\n        id\n        name\n        projectMilestones {\n          nodes {\n            id\n            name\n          }\n        }\n      }\n    }\n\n    milestones: projectMilestones(\n      filter: { name: { eq: $milestoneName } }\n      first: 1\n    ) {\n      nodes {\n        id\n        name\n      }\n    }\n\n    issues(\n      filter: {\n        and: [\n          { team: { key: { eq: $teamKey } } }\n          { number: { eq: $issueNumber } }\n        ]\n      }\n      first: 1\n    ) {\n      nodes {\n        id\n        identifier\n        team {\n          id\n          key\n        }\n        labels {\n          nodes {\n            id\n            name\n          }\n        }\n        project {\n          id\n          projectMilestones {\n            nodes {\n              id\n              name\n            }\n          }\n        }\n      }\n    }\n  }\n";
-export declare const CREATE_ISSUE_MUTATION = "\n  mutation CreateIssue($input: IssueCreateInput!) {\n    issueCreate(input: $input) {\n      success\n      issue {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
-export declare const UPDATE_ISSUE_MUTATION = "\n  mutation UpdateIssue($id: String!, $input: IssueUpdateInput!) {\n    issueUpdate(id: $id, input: $input) {\n      success\n      issue {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
-export declare const BATCH_RESOLVE_FOR_CREATE_QUERY = "\n  query BatchResolveForCreate(\n    $teamKey: String\n    $teamName: String\n    $projectName: String\n    $parentTeamKey: String\n    $parentIssueNumber: Float\n    $milestoneName: String\n  ) {\n    teams(\n      filter: {\n        or: [\n          { key: { eq: $teamKey } }\n          { name: { eqIgnoreCase: $teamName } }\n        ]\n      }\n      first: 1\n    ) {\n      nodes {\n        id\n        key\n        name\n      }\n    }\n\n    projects(filter: { name: { eqIgnoreCase: $projectName } }, first: 1) {\n      nodes {\n        id\n        name\n        teams {\n          nodes { id key }\n        }\n        projectMilestones {\n          nodes { id name }\n        }\n      }\n    }\n\n    milestones: projectMilestones(\n      filter: { name: { eq: $milestoneName } }\n      first: 1\n    ) {\n      nodes {\n        id\n        name\n      }\n    }\n\n    parentIssues: issues(\n      filter: {\n        and: [\n          { team: { key: { eq: $parentTeamKey } } }\n          { number: { eq: $parentIssueNumber } }\n        ]\n      }\n      first: 1\n    ) {\n      nodes {\n        id\n        identifier\n      }\n    }\n  }\n";
+export declare const GET_ISSUES_QUERY = "\n  query GetIssues($first: Int!, $orderBy: PaginationOrderBy) {\n    issues(\n      first: $first\n      orderBy: $orderBy\n      filter: {\n        state: { type: { neq: \"completed\" } }\n      }\n    ) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const SEARCH_ISSUES_QUERY = "\n  query SearchIssues($term: String!, $first: Int!) {\n    searchIssues(term: $term, first: $first, includeArchived: false) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const FILTERED_SEARCH_ISSUES_QUERY = "\n  query FilteredSearchIssues(\n    $first: Int!\n    $filter: IssueFilter\n    $orderBy: PaginationOrderBy\n  ) {\n    issues(\n      first: $first\n      filter: $filter\n      orderBy: $orderBy\n      includeArchived: false\n    ) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+/**
+ * Batch-resolves a search's team/project/assignee/delegate filter inputs.
+ *
+ * The `projects` block is `@include`-gated: Linear treats a null filter
+ * comparator as "no filter", so an always-on block with an unset
+ * `$projectName` would fetch an arbitrary project. (Search resolves a UUID
+ * `--project` directly without consulting this block, so only the
+ * name-resolution arm is needed here.)
+ */
+export declare const BATCH_RESOLVE_FOR_SEARCH_QUERY = "\n  query BatchResolveForSearch(\n    $teamKey: String\n    $teamName: String\n    $projectName: String\n    $hasProjectName: Boolean = false\n    $assigneeEmail: String\n    $delegateEmail: String\n  ) {\n    teams(\n      filter: {\n        or: [\n          { key: { eq: $teamKey } }\n          { name: { eqIgnoreCase: $teamName } }\n        ]\n      }\n      first: 1\n    ) {\n      nodes {\n        id\n        key\n        name\n      }\n    }\n\n    projects(\n      filter: { name: { eqIgnoreCase: $projectName } }\n      first: 1\n    ) @include(if: $hasProjectName) {\n      nodes {\n        id\n        name\n      }\n    }\n\n    users(filter: { email: { eq: $assigneeEmail } }, first: 1) {\n      nodes {\n        id\n        name\n        email\n      }\n    }\n\n    delegates: users(filter: { email: { eq: $delegateEmail } }, first: 1) {\n      nodes {\n        id\n        name\n        email\n      }\n    }\n  }\n";
+export declare const GET_ISSUE_BY_ID_QUERY = "\n  query GetIssue($id: String!) {\n    issue(id: $id) {\n      \n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n\n    }\n  }\n";
+export declare const GET_ISSUE_BY_IDENTIFIER_QUERY = "\n  query GetIssueByIdentifier($teamKey: String!, $number: Float!) {\n    issues(\n      filter: {\n        team: { key: { eq: $teamKey } }\n        number: { eq: $number }\n      }\n      first: 1\n    ) {\n      nodes {\n        \n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n\n      }\n    }\n  }\n";
+/**
+ * Batch-resolves an update's project/milestone/issue inputs.
+ *
+ * The project and milestone blocks are `@include`-gated for the same
+ * reason as `BATCH_RESOLVE_FOR_CREATE_QUERY`: a null filter comparator is
+ * a no-op that returns an arbitrary record. A UUID `--project` is resolved
+ * by `id` (`projectsById`) so its milestones are still fetched for
+ * `--project-milestone` name resolution; a name uses `projectsByName`.
+ */
+export declare const BATCH_RESOLVE_FOR_UPDATE_QUERY = "\n  query BatchResolveForUpdate(\n    $projectName: String\n    $projectId: ID\n    $hasProjectName: Boolean = false\n    $hasProjectId: Boolean = false\n    $teamKey: String\n    $issueNumber: Float\n    $milestoneName: String\n    $hasMilestoneName: Boolean = false\n  ) {\n    projectsByName: projects(\n      filter: { name: { eqIgnoreCase: $projectName } }\n      first: 1\n    ) @include(if: $hasProjectName) {\n      nodes {\n        id\n        name\n        projectMilestones {\n          nodes {\n            id\n            name\n          }\n        }\n      }\n    }\n\n    projectsById: projects(\n      filter: { id: { eq: $projectId } }\n      first: 1\n    ) @include(if: $hasProjectId) {\n      nodes {\n        id\n        name\n        projectMilestones {\n          nodes {\n            id\n            name\n          }\n        }\n      }\n    }\n\n    milestones: projectMilestones(\n      filter: { name: { eq: $milestoneName } }\n      first: 1\n    ) @include(if: $hasMilestoneName) {\n      nodes {\n        id\n        name\n      }\n    }\n\n    issues(\n      filter: {\n        and: [\n          { team: { key: { eq: $teamKey } } }\n          { number: { eq: $issueNumber } }\n        ]\n      }\n      first: 1\n    ) {\n      nodes {\n        id\n        identifier\n        team {\n          id\n          key\n        }\n        labels {\n          nodes {\n            id\n            name\n          }\n        }\n        project {\n          id\n          projectMilestones {\n            nodes {\n              id\n              name\n            }\n          }\n        }\n      }\n    }\n  }\n";
+export declare const CREATE_ISSUE_MUTATION = "\n  mutation CreateIssue($input: IssueCreateInput!) {\n    issueCreate(input: $input) {\n      success\n      issue {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const UPDATE_ISSUE_MUTATION = "\n  mutation UpdateIssue($id: String!, $input: IssueUpdateInput!) {\n    issueUpdate(id: $id, input: $input) {\n      success\n      issue {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const ARCHIVE_ISSUE_MUTATION = "\n  mutation ArchiveIssue($id: String!) {\n    issueArchive(id: $id) {\n      success\n      lastSyncId\n      entity {\n        id\n      }\n    }\n  }\n";
+export declare const DELETE_ISSUE_MUTATION = "\n  mutation DeleteIssue($id: String!, $permanentlyDelete: Boolean) {\n    issueDelete(id: $id, permanentlyDelete: $permanentlyDelete) {\n      success\n      lastSyncId\n      entity {\n        id\n      }\n    }\n  }\n";
+/**
+ * Batch-resolves a create's team/project/milestone/parent inputs in one
+ * round-trip.
+ *
+ * The project and milestone blocks are gated behind `@include` directives
+ * rather than left always-on. Linear treats a null filter comparator
+ * (`{ name: { eqIgnoreCase: null } }`) as "no filter" — so an always-on
+ * `projects` block with an unset `$projectName` returns an *arbitrary*
+ * project, which the caller would then mistake for the user's project
+ * (e.g. auto-switching the team to that unrelated project's team). The
+ * `has*` booleans ensure a block is fetched only when its input exists.
+ *
+ * A UUID `--project` is resolved by `id` (`projectsById`) so its team
+ * associations are still fetched for team-project validation; a name is
+ * resolved by `name` (`projectsByName`). The two are mutually exclusive,
+ * but GraphQL forbids two same-aliased fields with differing arguments,
+ * so they carry distinct aliases and the service folds whichever ran
+ * into `resolveResult.projects`.
+ */
+export declare const BATCH_RESOLVE_FOR_CREATE_QUERY = "\n  query BatchResolveForCreate(\n    $teamKey: String\n    $teamName: String\n    $projectName: String\n    $projectId: ID\n    $hasProjectName: Boolean = false\n    $hasProjectId: Boolean = false\n    $parentTeamKey: String\n    $parentIssueNumber: Float\n    $milestoneName: String\n    $hasMilestoneName: Boolean = false\n  ) {\n    teams(\n      filter: {\n        or: [\n          { key: { eq: $teamKey } }\n          { name: { eqIgnoreCase: $teamName } }\n        ]\n      }\n      first: 1\n    ) {\n      nodes {\n        id\n        key\n        name\n      }\n    }\n\n    projectsByName: projects(\n      filter: { name: { eqIgnoreCase: $projectName } }\n      first: 1\n    ) @include(if: $hasProjectName) {\n      nodes {\n        id\n        name\n        teams {\n          nodes { id key }\n        }\n        projectMilestones {\n          nodes { id name }\n        }\n      }\n    }\n\n    projectsById: projects(\n      filter: { id: { eq: $projectId } }\n      first: 1\n    ) @include(if: $hasProjectId) {\n      nodes {\n        id\n        name\n        teams {\n          nodes { id key }\n        }\n        projectMilestones {\n          nodes { id name }\n        }\n      }\n    }\n\n    milestones: projectMilestones(\n      filter: { name: { eq: $milestoneName } }\n      first: 1\n    ) @include(if: $hasMilestoneName) {\n      nodes {\n        id\n        name\n      }\n    }\n\n    parentIssues: issues(\n      filter: {\n        and: [\n          { team: { key: { eq: $parentTeamKey } } }\n          { number: { eq: $parentIssueNumber } }\n        ]\n      }\n      first: 1\n    ) {\n      nodes {\n        id\n        identifier\n      }\n    }\n  }\n";
 /**
  * Build a label-resolution query filtered by names (case-insensitive).
  * Uses `or` + `eqIgnoreCase` since Linear's `in` filter may be case-sensitive.
@@ -18,6 +57,8 @@ export declare function buildResolveLabelsByNameQuery(labelNames: string[]): {
 };
 export declare const GET_ISSUE_STATE_HISTORY_QUERY = "\n  query GetIssueStateHistory($id: String!) {\n    issue(id: $id) {\n      id\n      identifier\n      title\n      stateHistory {\n        nodes {\n          state { id name type }\n          startedAt\n          endedAt\n        }\n      }\n    }\n  }\n";
 export declare const GET_ISSUE_TEAM_QUERY = "\n  query GetIssueTeam($issueId: String!) {\n    issue(id: $issueId) {\n      team { id }\n    }\n  }\n";
+export declare const GET_ISSUE_START_CONTEXT_QUERY = "\n  query GetIssueStartContext($id: String!) {\n    issue(id: $id) {\n      id\n      identifier\n      state { id name type }\n      team { id key name }\n      delegate { id name url }\n    }\n  }\n";
+export declare const TEAM_STARTED_STATUSES_QUERY = "\n  query TeamStartedStatuses($teamId: String!) {\n    team(id: $teamId) {\n      states(filter: { type: { eq: \"started\" } }) {\n        nodes {\n          id\n          name\n          position\n        }\n      }\n    }\n  }\n";
 export declare const ISSUE_RELATION_CREATE_MUTATION = "\n  mutation IssueRelationCreate($input: IssueRelationCreateInput!) {\n    issueRelationCreate(input: $input) {\n      success\n      issueRelation {\n        id\n        type\n        issue {\n          id\n          identifier\n          title\n        }\n        relatedIssue {\n          id\n          identifier\n          title\n        }\n      }\n    }\n  }\n";
 export declare const GET_ISSUE_RELATIONS_QUERY = "\n  query GetIssueRelations($id: String!) {\n    issue(id: $id) {\n      id\n      identifier\n      title\n      description\n      relations {\n        nodes {\n          id\n          type\n          relatedIssue {\n            id\n            identifier\n            title\n            state { id name }\n            priority\n            assignee { id name }\n            team { id key name }\n          }\n        }\n      }\n      inverseRelations {\n        nodes {\n          id\n          type\n          issue {\n            id\n            identifier\n            title\n            state { id name }\n            priority\n            assignee { id name }\n            team { id key name }\n          }\n        }\n      }\n    }\n  }\n";
 export declare const SCAN_ISSUES_QUERY = "\n  query ScanIssues($filter: IssueFilter, $first: Int) {\n    issues(filter: $filter, first: $first, orderBy: updatedAt) {\n      nodes { id identifier description }\n    }\n  }\n";