add tasks source linear

ai/memories/changelogs/202603311620-docs-linear-task-plugin-integration-design.md

@@ -0,0 +1,15 @@
+## 2026-03-31 16:20: docs: add Linear task plugin integration design
+
+**What changed:**
+- Added a new product/technical design document for Linear task integration as an independent plugin.
+- Defined scope for OAuth connection, bidirectional task sync, and connection status management in Settings.
+- Documented architecture decisions aligned with current plugin runtime, including required plugin permissions and SDK task wrapper extension.
+- Added phased implementation plan, sync/conflict strategy, risks, and acceptance mapping.
+
+**Why:**
+- Provide a concrete implementation blueprint before coding the Linear integration.
+- Ensure requirements are explicit: plugin install-gated behavior, two-way sync, and visible connection state.
+
+**Files affected:**
+- `docs/plans/2026-03-31-linear-task-plugin-integration-design.md`
+- `ai/memories/changelogs/202603311620-docs-linear-task-plugin-integration-design.md`

ai/memories/changelogs/202603311644-feat-linear-api-key-auth.md

@@ -0,0 +1,20 @@
+## 2026-03-31 16:44: feat: switch Linear integration auth from OAuth to API key
+
+**What changed:**
+- Reworked `plugins/linear` authentication flow from OAuth to API key secret storage (`linear-api-key`).
+- Replaced panel connect UX with API key input/save flow, keeping disconnect and manual sync actions.
+- Updated plugin manifest tools to `linear_set_api_key` and removed OAuth-specific permissions/tool surface.
+- Updated integration design and manual QA docs to align with API key onboarding, validation, and failure paths.
+- Rebuilt and installed latest plugin artifact to `~/.peekoo/plugins/linear` for immediate local validation.
+
+**Why:**
+- Match product requirement update to use Linear personal/team API keys.
+- Simplify desktop setup by avoiding browser callback/OAuth token lifecycle handling.
+
+**Files affected:**
+- `plugins/linear/peekoo-plugin.toml`
+- `plugins/linear/src/lib.rs`
+- `plugins/linear/ui/panel.html`
+- `plugins/linear/ui/panel.js`
+- `docs/plans/2026-03-31-linear-task-plugin-integration-design.md`
+- `docs/plans/2026-03-31-linear-integration-manual-qa.md`

ai/memories/changelogs/202603311740-feat-linear-plugin-foundation.md

@@ -0,0 +1,26 @@
+## 2026-03-31 17:40: feat: add Linear plugin foundation with task sync and settings status
+
+**What changed:**
+- Added a new first-party plugin at `plugins/linear` with OAuth connect/disconnect, panel snapshot provider, manual sync trigger, periodic scheduler sync, and two-way task sync scaffolding against Linear GraphQL.
+- Added a new `tasks` module in `crates/peekoo-plugin-sdk` and wired raw host function bindings so plugins can create/list/update/delete/toggle/assign Peekoo tasks safely.
+- Added a new settings hook and UI section to show Linear integration status in Settings, including install/enable/connected/sync/error surfaces.
+- Updated `justfile` to include `linear` in `plugin-build-all`.
+
+**Why:**
+- Implement the approved design direction for Linear as an install-gated independent plugin.
+- Enable plugin-side background synchronization without coupling Linear logic into core app crates.
+- Satisfy acceptance criteria that connection status is visible in Settings.
+
+**Files affected:**
+- `plugins/linear/Cargo.toml`
+- `plugins/linear/peekoo-plugin.toml`
+- `plugins/linear/src/lib.rs`
+- `plugins/linear/ui/panel.html`
+- `plugins/linear/ui/panel.css`
+- `plugins/linear/ui/panel.js`
+- `crates/peekoo-plugin-sdk/src/host_fns.rs`
+- `crates/peekoo-plugin-sdk/src/tasks.rs`
+- `crates/peekoo-plugin-sdk/src/lib.rs`
+- `apps/desktop-ui/src/features/settings/useLinearIntegrationStatus.ts`
+- `apps/desktop-ui/src/features/settings/SettingsPanel.tsx`
+- `justfile`

apps/desktop-ui/src/components/sprite/SpriteActionMenu.tsx

@@ -48,6 +48,10 @@ export function SpriteActionMenu({
   const { t } = useTranslation();
   const [pluginsPopupOpen, setPluginsPopupOpen] = useState(false);
   const enabledPlugins = installedPlugins.filter((plugin) => {
+    if (plugin.pluginKey === "linear") {
+      return false;
+    }
+
     if (!plugin.enabled) {
       return false;
     }

apps/desktop-ui/src/features/settings/SettingsPanel.tsx

@@ -1,4 +1,5 @@
 import { useGlobalSettings } from "./useGlobalSettings";
+import { useLinearIntegrationStatus } from "./useLinearIntegrationStatus";
 import { SpriteSelector } from "./SpriteSelector";
 import { AgentProviderPanel } from "@/features/agent-runtimes/AgentProviderPanel";
 import { Button } from "@/components/ui/button";
@@ -30,6 +31,12 @@ export function SettingsPanel() {
     setAppLanguage,
     setLogLevel,
   } = useGlobalSettings();
+  const {
+    status: linearStatus,
+    isLoading: linearLoading,
+    error: linearError,
+    refresh: refreshLinearStatus,
+  } = useLinearIntegrationStatus();
 
   if (loading) {
     return (

apps/desktop-ui/src/features/settings/useLinearIntegrationStatus.ts

@@ -0,0 +1,148 @@
+import { useCallback, useEffect, useState } from "react";
+import { invoke } from "@tauri-apps/api/core";
+
+const POLL_INTERVAL_MS = 15000;
+
+type UiStatus =
+  | "uninstalled"
+  | "disabled"
+  | "disconnected"
+  | "connecting"
+  | "connected"
+  | "syncing"
+  | "error"
+  | "unknown";
+
+interface PluginSummary {
+  pluginKey: string;
+  enabled: boolean;
+}
+
+interface PluginConnectionStatus {
+  connected?: boolean;
+  status?: string;
+  workspaceName?: string | null;
+  userName?: string | null;
+  userEmail?: string | null;
+  lastSyncAt?: string | null;
+  lastError?: string | null;
+}
+
+export interface LinearIntegrationStatus {
+  uiStatus: UiStatus;
+  installed: boolean;
+  enabled: boolean;
+  connected: boolean;
+  workspaceName: string | null;
+  userName: string | null;
+  userEmail: string | null;
+  lastSyncAt: string | null;
+  lastError: string | null;
+}
+
+const DEFAULT_STATUS: LinearIntegrationStatus = {
+  uiStatus: "uninstalled",
+  installed: false,
+  enabled: false,
+  connected: false,
+  workspaceName: null,
+  userName: null,
+  userEmail: null,
+  lastSyncAt: null,
+  lastError: null,
+};
+
+function mapPluginStatus(status: string | undefined, connected: boolean): UiStatus {
+  switch (status) {
+    case "connected":
+      return connected ? "connected" : "disconnected";
+    case "connecting":
+      return "connecting";
+    case "syncing":
+      return "syncing";
+    case "error":
+      return "error";
+    case "disconnected":
+      return "disconnected";
+    default:
+      return connected ? "connected" : "unknown";
+  }
+}
+
+export function useLinearIntegrationStatus() {
+  const [status, setStatus] = useState<LinearIntegrationStatus>(DEFAULT_STATUS);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  const refresh = useCallback(async () => {
+    try {
+      setError(null);
+
+      const plugins = await invoke<PluginSummary[]>("plugins_list");
+      const linear = plugins.find((plugin) => plugin.pluginKey === "linear");
+
+      if (!linear) {
+        setStatus(DEFAULT_STATUS);
+        setIsLoading(false);
+        return;
+      }
+
+      if (!linear.enabled) {
+        setStatus({
+          ...DEFAULT_STATUS,
+          uiStatus: "disabled",
+          installed: true,
+          enabled: false,
+        });
+        setIsLoading(false);
+        return;
+      }
+
+      const raw = await invoke<string>("plugin_query_data", {
+        pluginKey: "linear",
+        providerName: "connection_status",
+      });
+
+      const parsed = JSON.parse(raw) as PluginConnectionStatus;
+      const connected = Boolean(parsed.connected);
+
+      setStatus({
+        uiStatus: mapPluginStatus(parsed.status, connected),
+        installed: true,
+        enabled: true,
+        connected,
+        workspaceName: parsed.workspaceName ?? null,
+        userName: parsed.userName ?? null,
+        userEmail: parsed.userEmail ?? null,
+        lastSyncAt: parsed.lastSyncAt ?? null,
+        lastError: parsed.lastError ?? null,
+      });
+    } catch (err) {
+      setError(String(err));
+      setStatus((prev) => ({
+        ...prev,
+        uiStatus: prev.installed ? "error" : "unknown",
+      }));
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    void refresh();
+    const interval = window.setInterval(() => {
+      void refresh();
+    }, POLL_INTERVAL_MS);
+
+    return () => {
+      window.clearInterval(interval);
+    };
+  }, [refresh]);
+
+  return {
+    status,
+    isLoading,
+    error,
+    refresh,
+  };
+}

apps/desktop-ui/src/features/tasks/TasksPanel.tsx

@@ -74,6 +74,10 @@ export function TasksPanel() {
   } = useTasks();
 
   const [mainTab, setMainTab] = useState<MainTab>("tasks");
+  const linearPlugin = plugins.find((plugin) => plugin.pluginKey === "linear");
+  const linearPanel = pluginPanels.find((panel) => panel.pluginKey === "linear");
+  const showLinearButton = Boolean(linearPlugin && linearPanel);
+  const canOpenLinearPanel = Boolean(linearPanel);
 
   if (isLoading) {
     return (

apps/desktop-ui/src/features/tasks/components/TaskLabelPills.tsx

@@ -6,6 +6,24 @@ interface TaskLabelPillsProps {
   maxVisible?: number;
 }
 
+function toSoftBackground(color: string): string {
+  if (color.startsWith("#")) {
+    const hex = color.slice(1);
+    const normalized = hex.length === 3
+      ? hex.split("").map((char) => `${char}${char}`).join("")
+      : hex;
+    if (normalized.length === 6) {
+      const r = Number.parseInt(normalized.slice(0, 2), 16);
+      const g = Number.parseInt(normalized.slice(2, 4), 16);
+      const b = Number.parseInt(normalized.slice(4, 6), 16);
+      if (Number.isFinite(r) && Number.isFinite(g) && Number.isFinite(b)) {
+        return `rgba(${r}, ${g}, ${b}, 0.18)`;
+      }
+    }
+  }
+  return "rgba(120, 130, 120, 0.18)";
+}
+
 export function TaskLabelPills({ labels, maxVisible = 3 }: TaskLabelPillsProps) {
   if (labels.length === 0) return null;
 
@@ -23,9 +41,9 @@ export function TaskLabelPills({ labels, maxVisible = 3 }: TaskLabelPillsProps)
             key={label}
             className="inline-flex items-center px-1.5 py-0.5 rounded-full text-[10px] font-medium leading-none"
             style={{
-              backgroundColor: `${color}20`,
-              color,
-              border: `1px solid ${color}40`,
+              backgroundColor: toSoftBackground(color),
+              color: "#33413A",
+              border: `1px solid ${toSoftBackground(color)}`,
             }}
           >
             {label}

crates/peekoo-plugin-host/src/registry.rs

@@ -19,7 +19,7 @@ use crate::runtime::PluginInstance;
 use crate::state::PluginStateStore;
 
 const DEFAULT_MEMORY_MAX_PAGES: u32 = 256;
-const DEFAULT_TIMEOUT: Duration = Duration::from_millis(5000);
+const DEFAULT_TIMEOUT: Duration = Duration::from_millis(20000);
 
 pub struct PluginRegistry {
     plugins: Mutex<HashMap<String, PluginInstance>>,