@mndrk/agx 2.0.44 → 2.0.45

package/cloud-runtime/standalone/components/LinearBoard.tsx

@@ -2,7 +2,7 @@
 
 import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import dynamic from "next/dynamic";
-import { Check, ChevronDown, Clock, Link2, Play, Search, Settings, User } from "lucide-react";
+import { Check, ChevronDown, Clock, Link2, Play, RefreshCw, Search, Settings, User } from "lucide-react";
 import { useLinearIssues, type LinearIssue } from "@/hooks/useLinearIssues";
 import { useLinearConnection } from "@/hooks/useLinearConnection";
 import { useLinearRuns, type LinearRun } from "@/hooks/useLinearRuns";
@@ -126,6 +126,61 @@ const STATUS_DOT_COLORS: Record<LinearRun["status"], string> = {
   cancelled: "bg-zinc-400",
 };
 
+interface FilterOption {
+  value: string;
+  label: string;
+}
+
+interface FilterSelectProps {
+  label: string;
+  value: string;
+  options: FilterOption[];
+  activeClasses: string;
+  onChange: (value: string) => void;
+}
+
+function FilterSelect({ label, value, options, activeClasses, onChange }: FilterSelectProps) {
+  const isActive = value.trim().length > 0;
+
+  return (
+    <div className="relative">
+      <select
+        aria-label={label}
+        className={`max-w-[160px] appearance-none rounded-full border bg-transparent px-2.5 py-0.5 pr-6 text-[11px] font-medium outline-none transition-colors ${
+          isActive
+            ? activeClasses
+            : "border-[var(--card-border)] text-[var(--muted-foreground)] hover:bg-[var(--card-bg)]"
+        }`}
+        value={value}
+        onChange={(event) => onChange(event.target.value)}
+      >
+        {options.map((option) => (
+          <option key={`${label}-${option.value || "all"}`} value={option.value}>
+            {option.label}
+          </option>
+        ))}
+      </select>
+      <ChevronDown
+        size={12}
+        className="pointer-events-none absolute right-2 top-1/2 -translate-y-1/2 text-current"
+      />
+    </div>
+  );
+}
+
+interface CycleOption {
+  id: string;
+  number: number;
+  name: string | null;
+  startsAt: string;
+  endsAt: string;
+}
+
+interface LinearEntityOption {
+  id: string;
+  name: string;
+}
+
 function TicketChatStarter({
   issue,
   participants,
@@ -339,6 +394,7 @@ function TicketChatStarter({
           onSend={handleSend}
           onStop={() => {}}
           participants={participants}
+          projectSlug={projectSlug ?? undefined}
           loading={activityStatus !== "ready"}
           commands={[]}
           activityStatus={activityStatus}
@@ -559,6 +615,7 @@ function ThreadMessageList({
             onSend={handleSend}
             onStop={stop}
             participants={participants}
+            projectSlug={run.projectSlug ?? undefined}
             loading={activityStatus !== "ready"}
             commands={[]}
             activityStatus={activityStatus}
@@ -639,10 +696,10 @@ function TicketRow({
       {selected && (
         <div className="absolute left-0 top-0 bottom-0 w-[3px] rounded-r-full bg-blue-500" />
       )}
-      <span className="w-14 shrink-0 font-mono text-xs text-[var(--muted-foreground)]">
+      <span className="w-24 shrink-0 whitespace-nowrap font-mono text-xs text-[var(--muted-foreground)]">
         {issue.identifier}
       </span>
-      <span className={`flex-1 truncate text-xs ${selected ? "font-medium text-[var(--foreground)]" : "text-[var(--muted-foreground)]"}`}>
+      <span className={`min-w-0 flex-1 truncate text-xs ${selected ? "font-medium text-[var(--foreground)]" : "text-[var(--muted-foreground)]"}`}>
         {issue.title}
       </span>
       <span className="shrink-0 text-xs text-[var(--muted-foreground)]">
@@ -698,31 +755,24 @@ export default function LinearBoard({ projectId, projectSlug, initialShowSetting
     configureMcp,
   } = useLinearConnection();
 
-  interface Cycle {
-    id: string;
-    number: number;
-    name: string | null;
-    startsAt: string;
-    endsAt: string;
-  }
-
   const [setupDismissed, setSetupDismissed] = useState(false);
   const [showSettings, setShowSettings] = useState(initialShowSettings ?? false);
   const [ticketPanelWidth, setTicketPanelWidth] = useState(576);
   const [runsPanelWidth, setRunsPanelWidth] = useState(224);
   const [search, setSearch] = useState("");
   const [debouncedSearch, setDebouncedSearch] = useState("");
-  const [assignedToMe, setAssignedToMe] = useState(false);
-  const [cycles, setCycles] = useState<Cycle[]>([]);
-  const [selectedCycleId, setSelectedCycleId] = useState<string | undefined>(undefined);
-  const [showCyclePicker, setShowCyclePicker] = useState(false);
+  const [assignees, setAssignees] = useState<LinearEntityOption[]>([]);
+  const [workspaces, setWorkspaces] = useState<LinearEntityOption[]>([]);
+  const [selectedAssigneeId, setSelectedAssigneeId] = useState("");
+  const [cycles, setCycles] = useState<CycleOption[]>([]);
+  const [selectedCycleId, setSelectedCycleId] = useState("");
+  const [selectedWorkspaceId, setSelectedWorkspaceId] = useState("");
   const [selectedIssue, setSelectedIssue] = useState<LinearIssue | null>(null);
   const [selectedRunId, setSelectedRunId] = useState<string | null>(null);
   const [participants, setParticipants] = useState<Participant[]>([]);
   const [pickerIssue, setPickerIssue] = useState<LinearIssue | null>(null);
   const [pickerAnchor, setPickerAnchor] = useState<{ top: number; left: number } | null>(null);
   const searchDebounceRef = useRef<ReturnType<typeof setTimeout> | null>(null);
-  const cyclePickerRef = useRef<HTMLDivElement | null>(null);
 
   const handleSearchChange = useCallback((value: string) => {
     setSearch(value);
@@ -740,40 +790,63 @@ export default function LinearBoard({ projectId, projectSlug, initialShowSetting
     };
   }, []);
 
-  // Fetch cycles when connected
+  // Fetch filter options when connected
   useEffect(() => {
     if (!connected) return;
     let cancelled = false;
-    fetch("/api/linear/cycles")
+    fetch("/api/linear/options")
       .then((res) => res.json())
       .then((data) => {
-        if (!cancelled && Array.isArray(data.cycles)) {
-          setCycles(data.cycles);
+        if (cancelled) {
+          return;
         }
+        setAssignees(Array.isArray(data.assignees) ? data.assignees : []);
+        setWorkspaces(Array.isArray(data.teams) ? data.teams : []);
+        setCycles(Array.isArray(data.cycles) ? data.cycles : []);
       })
-      .catch(() => {});
-    return () => { cancelled = true; };
+      .catch(() => {
+        if (!cancelled) {
+          setAssignees([]);
+          setWorkspaces([]);
+          setCycles([]);
+        }
+      });
+    return () => {
+      cancelled = true;
+    };
   }, [connected]);
 
-  // Close cycle picker on outside click
   useEffect(() => {
-    if (!showCyclePicker) return;
-    const handler = (e: MouseEvent) => {
-      if (cyclePickerRef.current && !cyclePickerRef.current.contains(e.target as Node)) {
-        setShowCyclePicker(false);
-      }
-    };
-    document.addEventListener("mousedown", handler);
-    return () => document.removeEventListener("mousedown", handler);
-  }, [showCyclePicker]);
+    if (selectedAssigneeId && !assignees.some((assignee) => assignee.id === selectedAssigneeId)) {
+      setSelectedAssigneeId("");
+    }
+  }, [assignees, selectedAssigneeId]);
+
+  useEffect(() => {
+    if (workspaces.length <= 1 && selectedWorkspaceId) {
+      setSelectedWorkspaceId("");
+      return;
+    }
+
+    if (selectedWorkspaceId && !workspaces.some((workspace) => workspace.id === selectedWorkspaceId)) {
+      setSelectedWorkspaceId("");
+    }
+  }, [selectedWorkspaceId, workspaces]);
+
+  useEffect(() => {
+    if (selectedCycleId && !cycles.some((cycle) => cycle.id === selectedCycleId)) {
+      setSelectedCycleId("");
+    }
+  }, [cycles, selectedCycleId]);
 
   const filters = useMemo(
     () => ({
       search: debouncedSearch || undefined,
-      assignedToMe: assignedToMe || undefined,
-      cycleId: selectedCycleId,
+      assigneeId: selectedAssigneeId || undefined,
+      teamId: selectedWorkspaceId || undefined,
+      cycleId: selectedCycleId || undefined,
     }),
-    [debouncedSearch, assignedToMe, selectedCycleId]
+    [debouncedSearch, selectedAssigneeId, selectedCycleId, selectedWorkspaceId]
   );
 
   const {
@@ -781,7 +854,8 @@ export default function LinearBoard({ projectId, projectSlug, initialShowSetting
     loading: issuesLoading,
     hasMore,
     loadMore,
-  } = useLinearIssues(filters, connected);
+    refresh: refreshIssues,
+  } = useLinearIssues(filters, connected, { projectSlug });
   const {
     runs,
     loading: runsLoading,
@@ -790,6 +864,26 @@ export default function LinearBoard({ projectId, projectSlug, initialShowSetting
   } = useLinearRuns(selectedIssue?.id, projectId ?? null);
 
   const selectedRun = runs.find((run) => run.id === selectedRunId) ?? null;
+  const assigneeOptions = useMemo<FilterOption[]>(
+    () => [{ value: "", label: "Assignee" }, ...assignees.map((assignee) => ({ value: assignee.id, label: assignee.name }))],
+    [assignees]
+  );
+  const workspaceOptions = useMemo<FilterOption[]>(
+    () => [{ value: "", label: "Workspace" }, ...workspaces.map((workspace) => ({ value: workspace.id, label: workspace.name }))],
+    [workspaces]
+  );
+  const cycleOptions = useMemo<FilterOption[]>(
+    () => [
+      { value: "", label: "Cycle" },
+      ...cycles.map((cycle) => ({
+        value: cycle.id,
+        label: cycle.name || `Cycle ${cycle.number}`,
+      })),
+    ],
+    [cycles]
+  );
+  const showCycleFilter = cycleOptions.length > 1;
+  const showWorkspaceFilter = workspaceOptions.length > 2;
 
   useEffect(() => {
     if (issues.length === 0) {
@@ -1021,6 +1115,16 @@ export default function LinearBoard({ projectId, projectSlug, initialShowSetting
                 onChange={(event) => handleSearchChange(event.target.value)}
               />
             </div>
+            <button
+              type="button"
+              className="shrink-0 rounded p-1.5 text-[var(--muted-foreground)] transition-colors hover:bg-[var(--card-bg)] hover:text-[var(--foreground)] disabled:cursor-not-allowed disabled:opacity-50"
+              onClick={() => void refreshIssues()}
+              title="Refresh tickets"
+              aria-label="Refresh tickets"
+              disabled={issuesLoading}
+            >
+              <RefreshCw size={16} className={issuesLoading ? "animate-spin" : undefined} />
+            </button>
             <button
               type="button"
               className="shrink-0 rounded p-1.5 text-[var(--muted-foreground)] transition-colors hover:bg-[var(--card-bg)] hover:text-[var(--foreground)]"
@@ -1031,87 +1135,31 @@ export default function LinearBoard({ projectId, projectSlug, initialShowSetting
             </button>
           </div>
           <div className="flex items-center gap-1.5 px-3 pb-2">
-            <button
-              type="button"
-              className={`rounded-full border px-2.5 py-0.5 text-[11px] font-medium transition-colors ${
-                assignedToMe
-                  ? "border-blue-500/30 bg-blue-500/10 text-blue-400"
-                  : "border-[var(--card-border)] text-[var(--muted-foreground)] hover:bg-[var(--card-bg)]"
-              }`}
-              onClick={() => setAssignedToMe((v) => !v)}
-            >
-              My Issues
-            </button>
-            <div className="relative" ref={cyclePickerRef}>
-              <button
-                type="button"
-                className={`flex items-center gap-1 rounded-full border px-2.5 py-0.5 text-[11px] font-medium transition-colors ${
-                  selectedCycleId
-                    ? "border-purple-500/30 bg-purple-500/10 text-purple-400"
-                    : "border-[var(--card-border)] text-[var(--muted-foreground)] hover:bg-[var(--card-bg)]"
-                }`}
-                onClick={() => setShowCyclePicker((v) => !v)}
-              >
-                <span className="truncate max-w-[120px]">
-                  {selectedCycleId
-                    ? (() => {
-                        const c = cycles.find((cy) => cy.id === selectedCycleId);
-                        return c ? (c.name || `Cycle ${c.number}`) : "Cycle";
-                      })()
-                    : "Cycle"}
-                </span>
-                <ChevronDown size={12} />
-              </button>
-              {showCyclePicker && (
-                <div className="absolute left-0 top-full z-50 mt-1 min-w-[200px] rounded-md border border-[var(--card-border)] bg-[var(--card-bg)] py-1 shadow-lg">
-                  <button
-                    type="button"
-                    className={`flex w-full items-center px-3 py-1.5 text-left text-xs transition-colors hover:bg-[var(--background)] ${
-                      !selectedCycleId ? "font-medium text-[var(--foreground)]" : "text-[var(--muted-foreground)]"
-                    }`}
-                    onClick={() => {
-                      setSelectedCycleId(undefined);
-                      setShowCyclePicker(false);
-                    }}
-                  >
-                    All cycles
-                  </button>
-                  {cycles.map((cycle) => {
-                    const now = new Date();
-                    const start = new Date(cycle.startsAt);
-                    const end = new Date(cycle.endsAt);
-                    const isCurrent = now >= start && now <= end;
-                    const label = cycle.name || `Cycle ${cycle.number}`;
-                    return (
-                      <button
-                        key={cycle.id}
-                        type="button"
-                        className={`flex w-full items-center justify-between px-3 py-1.5 text-left text-xs transition-colors hover:bg-[var(--background)] ${
-                          selectedCycleId === cycle.id ? "font-medium text-[var(--foreground)]" : "text-[var(--muted-foreground)]"
-                        }`}
-                        onClick={() => {
-                          setSelectedCycleId(cycle.id);
-                          setShowCyclePicker(false);
-                        }}
-                      >
-                        <span className="flex items-center gap-1.5">
-                          {label}
-                          {isCurrent && (
-                            <span className="rounded bg-green-500/10 px-1 py-0.5 text-[9px] font-bold uppercase text-green-400">
-                              current
-                            </span>
-                          )}
-                        </span>
-                        {selectedCycleId === cycle.id && <Check size={12} />}
-                      </button>
-                    );
-                  })}
-                  {cycles.length === 0 && (
-                    <div className="px-3 py-2 text-xs text-[var(--muted-foreground)]">No cycles found</div>
-                  )}
-                </div>
-              )}
-            </div>
+            <FilterSelect
+              label="Assignee"
+              value={selectedAssigneeId}
+              options={assigneeOptions}
+              activeClasses="border-blue-500/30 bg-blue-500/10 text-blue-400"
+              onChange={setSelectedAssigneeId}
+            />
+            {showWorkspaceFilter ? (
+              <FilterSelect
+                label="Workspace"
+                value={selectedWorkspaceId}
+                options={workspaceOptions}
+                activeClasses="border-emerald-500/30 bg-emerald-500/10 text-emerald-400"
+                onChange={setSelectedWorkspaceId}
+              />
+            ) : null}
+            {showCycleFilter ? (
+              <FilterSelect
+                label="Cycle"
+                value={selectedCycleId}
+                options={cycleOptions}
+                activeClasses="border-purple-500/30 bg-purple-500/10 text-purple-400"
+                onChange={setSelectedCycleId}
+              />
+            ) : null}
           </div>
         </div>
 

package/cloud-runtime/standalone/components/chat-ui/ChatContainer.tsx

@@ -1543,6 +1543,7 @@ export function ChatContainer({
           participants={activeParticipants}
           projectGroups={threadProjects}
           projects={projectMentions}
+          projectSlug={effectiveProjectSlug}
           messages={messages}
           commands={slashCommands}
           placeholder="Reply — @name to mention, /search, /summarize"
@@ -1554,7 +1555,7 @@ export function ChatContainer({
         />
       );
     },
-    [handleThreadReply, handleStopThread, streaming, activeParticipants, threadProjects, projectMentions, slashCommands, messages, autoMode, handleAutoModeChange, activeProcesses, activeChatRuns, activeProjectRepos, selectedRepoIds, handleRepoSelectionChange]
+    [handleThreadReply, handleStopThread, streaming, activeParticipants, threadProjects, projectMentions, effectiveProjectSlug, slashCommands, messages, autoMode, handleAutoModeChange, activeProcesses, activeChatRuns, activeProjectRepos, selectedRepoIds, handleRepoSelectionChange]
   );
 
   const toggleWorkspaceSidebar = useCallback(() => {
@@ -1950,6 +1951,7 @@ export function ChatContainer({
                     participants={activeParticipants}
                     projects={projectMentions}
                     projectGroups={threadProjects}
+                    projectSlug={effectiveProjectSlug}
                     messages={messages}
                     commands={slashCommands}
                     pendingThreadInsert={pendingThreadInsert}

package/cloud-runtime/standalone/components/chat-ui/Composer.tsx

@@ -6,6 +6,7 @@ import StarterKit from "@tiptap/starter-kit";
 import Placeholder from "@tiptap/extension-placeholder";
 import {
   useMentionAutocomplete,
+  type MentionLinearIssue,
   type MentionProject,
   type MentionSuggestion,
 } from "@/hooks/useMentionAutocomplete";
@@ -15,7 +16,12 @@ import { useFileMention } from "@/hooks/useFileMention";
 import { useThreadMention, type Discussion } from "@/hooks/useThreadMention";
 import { useComposerAttachments } from "@/hooks/useComposerAttachments";
 import { useComposerHistory } from "@/hooks/useComposerHistory";
+import { useLinearIssueMentions } from "@/hooks/useLinearIssueMentions";
 import { buildAgentContext } from "@/lib/chat/agentContextBuilder";
+import {
+  buildLinearIssueContextPrefix,
+  extractMentionedLinearIssueIds,
+} from "@/lib/chat/linear-issue-context";
 import {
   extractComposerRouting,
   type ComposerRoutingMetadata,
@@ -31,6 +37,7 @@ import {
   ProjectMention,
   FileMention,
   ThreadMention,
+  LinearIssueMention,
 } from "@/lib/tiptap/composer-mentions";
 import { serializeToPlainText } from "@/lib/tiptap/serialize-composer";
 import { getCurrentParagraphText, plainTextRangeToPos } from "@/lib/tiptap/editor-utils";
@@ -76,6 +83,8 @@ interface Props {
   projects?: MentionProject[];
   /** Projects with agent rosters */
   projectGroups?: ProjectWithAgents[];
+  /** Active project slug, used for scoping cached Linear issue pulls */
+  projectSlug?: string;
   /** All messages in the current thread — used for @# discussion mentions */
   messages?: GroupMessage[];
   commands: SlashCommand[];
@@ -129,6 +138,7 @@ export function Composer({
   participants,
   projects = [],
   projectGroups = [],
+  projectSlug,
   messages: allMessages = [],
   commands,
   placeholder = "Message — @name to mention, /search, /summarize",
@@ -173,8 +183,16 @@ export function Composer({
   }, []);
 
   const [threadRefs, setThreadRefs] = useState<ThreadRef[]>([]);
-
-  const mention = useMentionAutocomplete({ participants, projectGroups, projects, maxSuggestions: 8 });
+  const { issues: cachedLinearIssues } = useLinearIssueMentions({ projectSlug });
+  const linearIssues = cachedLinearIssues as MentionLinearIssue[];
+
+  const mention = useMentionAutocomplete({
+    participants,
+    projectGroups,
+    projects,
+    linearIssues,
+    maxSuggestions: 8,
+  });
   const command = useCommandAutocomplete({ commands, maxSuggestions: 6 });
   const fileMention = useFileMention({ maxSuggestions: 8 });
   const threadMention = useThreadMention({ messages: allMessages, maxSuggestions: 8 });
@@ -235,6 +253,7 @@ export function Composer({
       ProjectMention,
       FileMention,
       ThreadMention,
+      LinearIssueMention,
     ],
     editorProps: {
       attributes: {
@@ -473,6 +492,17 @@ export function Composer({
                 name: suggestion.project.name,
               },
             }
+          : suggestion.kind === "ticket"
+            ? {
+                type: "linearIssueMention",
+                attrs: {
+                  id: suggestion.issue.id,
+                  identifier: suggestion.issue.identifier,
+                  title: suggestion.issue.title,
+                  status: suggestion.issue.status,
+                  url: suggestion.issue.url,
+                },
+              }
           : {
               type: "participantMention",
               attrs: {
@@ -628,6 +658,28 @@ export function Composer({
       }
     }
 
+    const mentionedLinearIssueIds = extractMentionedLinearIssueIds(doc);
+    if (mentionedLinearIssueIds.length > 0) {
+      try {
+        const response = await fetch("/api/linear/issues/context", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ issueIds: mentionedLinearIssueIds }),
+        });
+        if (!response.ok) {
+          throw new Error(`Failed to load issue context: ${response.status}`);
+        }
+        const data = await response.json().catch(() => ({}));
+        const issues = Array.isArray(data.issues) ? data.issues : [];
+        const issueContext = buildLinearIssueContextPrefix(issues);
+        if (issueContext) {
+          prefixParts.push(issueContext.trimEnd());
+        }
+      } catch (error) {
+        console.error("Failed to load Linear issue mention context:", error);
+      }
+    }
+
     const promptPrefix = prefixParts.length > 0 ? prefixParts.join("\n\n") + "\n\n" : undefined;
     const routing = extractComposerRouting(doc, pinnedParticipantId);
 

package/cloud-runtime/standalone/components/chat-ui/MentionPopover.tsx

@@ -2,7 +2,7 @@
 
 import { useEffect, useRef } from "react";
 import type { MentionSuggestion } from "@/hooks/useMentionAutocomplete";
-import { FolderKanban, Users } from "lucide-react";
+import { FolderKanban, Tag, Users } from "lucide-react";
 
 interface MentionPopoverProps {
   isOpen: boolean;
@@ -55,7 +55,9 @@ export function MentionPopover({
               ? `project-group-${suggestion.project.id}`
               : suggestion.kind === "project"
                 ? `project-${suggestion.project.id}`
-                : suggestion.participant.id;
+                : suggestion.kind === "ticket"
+                  ? `ticket-${suggestion.issue.id}`
+                  : suggestion.participant.id;
           const group = suggestion.group;
 
           // Show group header if this is a new non-empty group
@@ -131,6 +133,45 @@ export function MentionPopover({
             );
           }
 
+          if (suggestion.kind === "ticket") {
+            return (
+              <div key={id}>
+                {groupHeader}
+                <button
+                  type="button"
+                  role="option"
+                  id={`${optionIdPrefix}-${id}`}
+                  aria-selected={isActive}
+                  ref={(element) => {
+                    optionRefs.current[index] = element;
+                  }}
+                  className={`w-full px-3 py-2 text-left text-sm transition-colors ${
+                    isActive ? "bg-[var(--primary-muted)] text-[var(--foreground)]" : "text-[var(--foreground)] hover:bg-[var(--app-shell-subtle)]"
+                  }`}
+                  onMouseDown={(e) => {
+                    e.preventDefault();
+                  }}
+                  onClick={() => onSelect(suggestion)}
+                >
+                  <span className="flex items-start gap-2">
+                    <Tag className="mt-0.5 h-3.5 w-3.5 text-[var(--muted-foreground)]" aria-hidden />
+                    <span className="min-w-0">
+                      <span className="block font-medium">
+                        {suggestion.issue.identifier}
+                        <span className="ml-2 text-xs text-[var(--muted-foreground)]">
+                          {suggestion.issue.status}
+                        </span>
+                      </span>
+                      <span className="block truncate text-xs text-[var(--muted-foreground)]">
+                        {suggestion.issue.title}
+                      </span>
+                    </span>
+                  </span>
+                </button>
+              </div>
+            );
+          }
+
           const participant = suggestion.participant;
           return (
             <div key={id}>

package/cloud-runtime/standalone/hooks/useLinearIssueMentions.ts

@@ -0,0 +1,64 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import type { LinearIssue } from "@/hooks/useLinearIssues";
+
+interface UseLinearIssueMentionsOptions {
+  projectSlug?: string;
+  enabled?: boolean;
+  limit?: number;
+}
+
+interface UseLinearIssueMentionsReturn {
+  issues: LinearIssue[];
+  loading: boolean;
+}
+
+export function useLinearIssueMentions({
+  projectSlug,
+  enabled = true,
+  limit = 500,
+}: UseLinearIssueMentionsOptions = {}): UseLinearIssueMentionsReturn {
+  const [issues, setIssues] = useState<LinearIssue[]>([]);
+  const [loading, setLoading] = useState(false);
+
+  useEffect(() => {
+    if (!enabled) {
+      setIssues([]);
+      setLoading(false);
+      return;
+    }
+
+    let cancelled = false;
+    const params = new URLSearchParams();
+    params.set("limit", String(limit));
+    if (projectSlug) {
+      params.set("projectSlug", projectSlug);
+    }
+
+    setLoading(true);
+    fetch(`/api/linear/issues?${params.toString()}`)
+      .then(async (response) => {
+        const data = await response.json().catch(() => ({}));
+        if (!cancelled) {
+          setIssues(Array.isArray(data.issues) ? data.issues : []);
+        }
+      })
+      .catch(() => {
+        if (!cancelled) {
+          setIssues([]);
+        }
+      })
+      .finally(() => {
+        if (!cancelled) {
+          setLoading(false);
+        }
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [enabled, limit, projectSlug]);
+
+  return { issues, loading };
+}