@yannelli/paseo-linear-plugin 1.1.0-beta.2 → 1.1.0-beta.4

package/client/project-knowledge.tsx

@@ -0,0 +1,87 @@
+import { useRpc } from "@getpaseo/plugin/client";
+import {
+  SettingsAction,
+  SettingsCard,
+  SettingsRow,
+  SettingsSection,
+} from "@getpaseo/plugin/client/ui";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  areaLabel,
+  knowledgeGetRpc,
+  knowledgeInspectRpc,
+  MAX_KNOWLEDGE_FILES,
+  type ProjectBrief,
+} from "../shared/knowledge";
+import { errorMessage, relativeTime } from "./ui";
+
+const AREAS_SHOWN = 24;
+
+export const knowledgeKey = (projectId: string) => ["linear", "knowledge", projectId] as const;
+
+function countText(entries: readonly { name: string; files: number }[]): string {
+  return entries.map((entry) => `${entry.name} ${entry.files}`).join(", ");
+}
+
+function overview(brief: ProjectBrief): string {
+  const source = brief.source === "git" ? "files git tracks" : "files found in the folder";
+  const truncated = brief.truncated ? `; the first ${MAX_KNOWLEDGE_FILES.toLocaleString()} are kept` : "";
+  return `${brief.fileCount} ${source}${truncated}. Inspected ${relativeTime(brief.inspectedAt)}.`;
+}
+
+/** What the daemon knows about the project's files, and a button to inspect it again. */
+export function ProjectKnowledgeSection(props: { projectId: string }) {
+  const { projectId } = props;
+  const get = useRpc(knowledgeGetRpc);
+  const inspect = useRpc(knowledgeInspectRpc);
+  const queries = useQueryClient();
+  const query = useQuery({
+    queryKey: knowledgeKey(projectId),
+    queryFn: () => get({ projectId }),
+    staleTime: 60_000,
+    retry: false,
+  });
+  const again = useMutation({
+    mutationFn: () => inspect({ projectId }),
+    onSuccess: (data) => queries.setQueryData(knowledgeKey(projectId), data),
+  });
+  const brief = query.data?.knowledge ?? null;
+  const busy = query.isPending || again.isPending;
+  const failure = again.error ?? query.error;
+  const areas = brief?.areas.filter((area) => area.path !== "") ?? [];
+  return (
+    <SettingsSection title="Project knowledge">
+      <SettingsCard>
+        <SettingsAction
+          label="Inspect the project"
+          hint="The daemon lists the project's files and reads its manifests to find its services, packages, and main folders. No agent runs. Explore and setup agents, ticket-text maps, and Linear Live use what it finds. It inspects again when the knowledge is 6 hours old."
+          actionLabel={busy ? "Inspecting…" : "Inspect again"}
+          disabled={busy}
+          onPress={() => again.mutate()}
+        />
+        {failure ? <SettingsRow label="Inspection did not finish" error={errorMessage(failure)} /> : null}
+        {brief ? (
+          <>
+            <SettingsRow label="Files" hint={overview(brief)} />
+            {brief.summary ? <SettingsRow label="Project" hint={brief.summary} /> : null}
+            {brief.languages.length > 0 ? (
+              <SettingsRow label="Languages" hint={countText(brief.languages)} />
+            ) : null}
+            {brief.commands.length > 0 ? (
+              <SettingsRow label="Commands" hint={brief.commands.join(", ")} />
+            ) : null}
+            {brief.guides.length > 0 ? <SettingsRow label="Guides" hint={brief.guides.join(", ")} /> : null}
+            {areas.slice(0, AREAS_SHOWN).map((area) => {
+              const files = `${area.files} ${area.files === 1 ? "file" : "files"}`;
+              const parts = [areaLabel(area), files, area.languages.join("/"), area.summary];
+              return <SettingsRow key={area.path} label={area.path} hint={parts.filter(Boolean).join(" · ")} />;
+            })}
+            {areas.length > AREAS_SHOWN ? (
+              <SettingsRow label={`${areas.length - AREAS_SHOWN} more areas`} />
+            ) : null}
+          </>
+        ) : null}
+      </SettingsCard>
+    </SettingsSection>
+  );
+}

package/client/settings-icon.tsx

@@ -8,6 +8,7 @@ import {
   SettingsSelect,
   SettingsSwitch,
 } from "@getpaseo/plugin/client/ui";
+import { Icon } from "@getpaseo/plugin/client/react-native";
 import { useCallback, useMemo, useState } from "react";
 import { Platform, Text, View } from "react-native";
 import {
@@ -15,10 +16,11 @@ import {
   type IconPaint,
   type IconSettings,
   MAX_SVG_LENGTH,
+  MENU_ICONS,
   parseIconSvg,
 } from "../shared/custom-icon";
 import { linearSettings } from "../shared/settings";
-import { IconGlyph } from "./plugin-icon";
+import { IconGlyph, useIconSettings } from "./plugin-icon";
 import { MultilineField, type ReadySettings, SaveBar, SettingsGate, useSettingsDraft } from "./settings-fields";
 import type { Theme } from "./ui";
 import { canPickFiles, pickTextFile } from "./web";
@@ -37,6 +39,7 @@ const MAX_FILE_BYTES = MAX_SVG_LENGTH * 4;
 
 export function IconSettingsScreen({ theme }: PluginSurfaceProps) {
   const settings = useSettings(linearSettings);
+  useIconSettings();
   const render = useCallback(
     (ready: ReadySettings) => <IconEditor theme={theme} settings={ready} />,
     [theme],
@@ -85,6 +88,33 @@ function IconPreview({ theme, icon }: { theme: Theme; icon: IconSettings }) {
   );
 }
 
+function MenuPreview({ theme, name }: { theme: Theme; name: string }) {
+  const { colors } = theme;
+  const styles = useMemo(
+    () => ({
+      tab: {
+        flexDirection: "row" as const,
+        alignSelf: "flex-start" as const,
+        alignItems: "center" as const,
+        gap: 6,
+        marginTop: 8,
+        paddingHorizontal: 10,
+        paddingVertical: 5,
+        borderRadius: 6,
+        backgroundColor: colors.surface2,
+      },
+      label: { color: colors.foreground, fontSize: 12 },
+    }),
+    [colors],
+  );
+  return (
+    <View style={styles.tab}>
+      <Icon name={name} size={14} color={colors.foregroundMuted} />
+      <Text style={styles.label}>Linear</Text>
+    </View>
+  );
+}
+
 function IconEditor({ theme, settings }: { theme: Theme; settings: ReadySettings }) {
   const { values, dirty, edit, save, discard } = useSettingsDraft(settings);
   const icon = values.icon;
@@ -123,7 +153,7 @@ function IconEditor({ theme, settings }: { theme: Theme; settings: ReadySettings
       }),
     [applyMarkup],
   );
-  const useBuiltIn = useCallback(() => {
+  const removeSvg = useCallback(() => {
     setFileName(null);
     applyMarkup("");
   }, [applyMarkup]);
@@ -145,6 +175,11 @@ function IconEditor({ theme, settings }: { theme: Theme; settings: ReadySettings
   }, [discard, settings.values.icon.svg]);
   const native = Platform.OS !== "web";
   const custom = icon.svg !== "";
+  const menuOptions = useMemo(() => {
+    const options = MENU_ICONS.map((entry) => ({ label: entry.label, value: entry.name }));
+    if (!options.some((option) => option.value === icon.menu)) options.push({ label: icon.menu, value: icon.menu });
+    return options;
+  }, [icon.menu]);
 
   return (
     <View>
@@ -155,7 +190,7 @@ function IconEditor({ theme, settings }: { theme: Theme; settings: ReadySettings
             hint={
               native
                 ? "The iOS and Android apps cannot draw plugin SVG images, so they show the built-in icon in the color you choose."
-                : "Composer pills, the Linear sidebar row, and Linear screens use this icon. Paseo menus and panel tabs keep the built-in icon."
+                : "Composer pills, the Linear sidebar row, and Linear screens use this icon. Panel tabs and menus use the built-in icon below."
             }
           >
             <IconPreview theme={theme} icon={icon} />
@@ -179,11 +214,11 @@ function IconEditor({ theme, settings }: { theme: Theme; settings: ReadySettings
             onChange={applyMarkup}
           />
           <SettingsAction
-            label="Built-in icon"
-            hint="Remove your SVG and use the Linear board icon."
-            actionLabel="Use built-in"
+            label="Remove SVG"
+            hint="Use the built-in icon everywhere."
+            actionLabel="Remove"
             disabled={!custom && markup === ""}
-            onPress={useBuiltIn}
+            onPress={removeSvg}
           />
         </SettingsCard>
       </SettingsSection>
@@ -208,13 +243,27 @@ function IconEditor({ theme, settings }: { theme: Theme; settings: ReadySettings
           ) : null}
           <SettingsSwitch
             label="Solid"
-            hint={custom ? "Fill shapes that only have an outline, so line icons show as solid shapes." : "Add your SVG to use this. The built-in icon stays as drawn."}
+            hint={custom ? "Fill shapes that only have an outline, so line icons show as solid shapes." : "Add an SVG to use this. Built-in icons stay as drawn."}
             value={icon.solid}
             disabled={!custom}
             onValueChange={(solid) => change({ solid })}
           />
         </SettingsCard>
       </SettingsSection>
+      <SettingsSection title="Built-in icon">
+        <SettingsCard>
+          <SettingsSelect
+            label="Built-in icon"
+            hint="Panel tabs, the new tab menu, and Command Center take built-in icons only, so they use this one. Without an SVG, every place uses it. Tabs that are open change when you reload Paseo or open them again."
+            value={icon.menu}
+            options={menuOptions}
+            onValueChange={(menu) => change({ menu })}
+          />
+          <SettingsRow label="Tab preview">
+            <MenuPreview theme={theme} name={icon.menu} />
+          </SettingsRow>
+        </SettingsCard>
+      </SettingsSection>
       <SaveBar
         theme={theme}
         dirty={dirty}

package/client/settings-projects.tsx

@@ -22,6 +22,7 @@ import {
 } from "../shared/settings";
 import { effectiveKeyScope, KeyScopeProvider } from "./key-scope";
 import { ProjectSetup } from "./project-init";
+import { ProjectKnowledgeSection } from "./project-knowledge";
 import { AccessSection } from "./settings-access";
 import { type PaseoProjectOption, useAuthStatus, useCatalog, useProjects } from "./queries";
 import {
@@ -42,11 +43,15 @@ const STEPS_PLACEHOLDER = "Run the type checker\nUpdate the changelog\nOpen a dr
 
 type Change = (patch: Partial<ProjectConfig>) => void;
 
-export function ProjectSettings({ theme }: PluginSurfaceProps) {
+export function ProjectSettings({ theme, navigation }: PluginSurfaceProps) {
   const settings = useSettings(linearSettings);
+  const openAgent = useMemo(
+    () => (navigation ? (agentId: string) => navigation.openAgent({ agentId }) : undefined),
+    [navigation],
+  );
   const render = useCallback(
-    (ready: ReadySettings) => <ProjectEditor theme={theme} settings={ready} />,
-    [theme],
+    (ready: ReadySettings) => <ProjectEditor theme={theme} settings={ready} openAgent={openAgent} />,
+    [theme, openAgent],
   );
   return (
     <SettingsGate theme={theme} title="Projects" settings={settings}>
@@ -72,7 +77,12 @@ function projectOptions(
   return [...known, ...missing];
 }
 
-function ProjectEditor({ theme, settings }: { theme: Theme; settings: ReadySettings }) {
+function ProjectEditor(props: {
+  theme: Theme;
+  settings: ReadySettings;
+  openAgent?: (agentId: string) => void;
+}) {
+  const { theme, settings } = props;
   const { values, dirty, edit, save, discard } = useSettingsDraft(settings);
   const projects = useProjects();
   const [selectedId, setSelectedId] = useState<string | null>(null);
@@ -140,7 +150,8 @@ function ProjectEditor({ theme, settings }: { theme: Theme; settings: ReadySetti
         </SettingsCard>
       </SettingsSection>
       <TeamsSection config={config} change={change} />
-      <ProjectSetup theme={theme} config={config} change={change} />
+      {paseoProject ? <ProjectKnowledgeSection projectId={paseoProject.projectId} /> : null}
+      <ProjectSetup theme={theme} config={config} change={change} openAgent={props.openAgent} />
       <InstructionsSection theme={theme} config={config} change={change} />
       {AGENT_ACTIONS.map((action) => (
         <ActionSection key={action} theme={theme} action={action} config={config} change={change} />

package/client/web.ts

@@ -3,6 +3,7 @@ import { Platform } from "react-native";
 // The only module that uses the DOM. React wheel listeners are passive, so they cannot keep
 // the page from scrolling while the wheel zooms the graph. Off the web each export does nothing.
 // The file picker is a hidden file input, because plugins cannot use native document pickers.
+// Local storage keeps small values for the next start; it can be missing or blocked.
 
 interface WheelEventLike {
   deltaY: number;
@@ -89,3 +90,34 @@ export function pickTextFile(accept: string, maxBytes: number, onPick: (file: Pi
   };
   input.click();
 }
+
+interface StorageLike {
+  getItem(key: string): string | null;
+  setItem(key: string, value: string): void;
+}
+
+function storage(): StorageLike | null {
+  if (Platform.OS !== "web") return null;
+  try {
+    return (globalThis as { localStorage?: StorageLike }).localStorage ?? null;
+  } catch {
+    return null;
+  }
+}
+
+/** A value saved on this device, or null off the web or when storage is blocked. */
+export function readStored(key: string): string | null {
+  try {
+    return storage()?.getItem(key) ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export function writeStored(key: string, value: string): void {
+  try {
+    storage()?.setItem(key, value);
+  } catch {
+    // Blocked storage only means the next start uses the built-in icon first.
+  }
+}

package/index.client.tsx

@@ -4,7 +4,7 @@ import { openPluginScreen, registerScreen } from "./client/compat";
 import { gateAgentPanel } from "./client/access";
 import { LivePanel } from "./client/live-panel";
 import { contributeComposerPills } from "./client/pill";
-import { PluginIcon } from "./client/plugin-icon";
+import { onMenuIconChange, PluginIcon, startMenuIcon } from "./client/plugin-icon";
 import { ConnectionSettings } from "./client/settings-connection";
 import { IconSettingsScreen } from "./client/settings-icon";
 import { LiveSettings } from "./client/settings-live";
@@ -12,6 +12,7 @@ import { ProjectSettings } from "./client/settings-projects";
 import { PromptSettings } from "./client/settings-prompts";
 import { focusIssue, panelScope, SCREEN_SCOPE, updateBrowser } from "./client/store";
 import { IssueCardRow } from "./client/timeline-card";
+import { BUILT_IN_ICON } from "./shared/custom-icon";
 import { issueAttachments } from "./shared/issues";
 import { ISSUE_CARD_KIND, IssueCardSchema, LINEAR_IDENTIFIER } from "./shared/linear";
 
@@ -19,23 +20,140 @@ const SCREEN_ID = "linear";
 const PANEL_ID = "issues";
 const LIVE_PANEL_ID = "live";
 
+type Cleanup = () => void;
+
+// Panels and Command Center items take the menu icon when they register, so a new choice
+// registers the whole group again. One group keeps their order the same.
+function contributeMenus(client: PluginClientContext, icon: string): Cleanup {
+  const cleanups: Cleanup[] = [];
+  const removeAll = () => {
+    for (const cleanup of cleanups.splice(0).reverse()) cleanup();
+  };
+  try {
+    cleanups.push(
+      client.addWorkspacePanel({
+        id: PANEL_ID,
+        title: "Linear",
+        icon,
+        context: "workspace",
+        locations: ["workspace", "explorer"],
+        Component: LinearPanel,
+      }),
+      client.addWorkspacePanel({
+        id: LIVE_PANEL_ID,
+        title: "Linear Live",
+        icon: "Radar",
+        context: "agent",
+        Component: gateAgentPanel(LivePanel),
+      }),
+      client.addCommandCenterItem({
+        id: "open-issues",
+        title: "Linear: Open issues",
+        icon,
+        keywords: ["linear", "issues", "tickets"],
+        context: "global",
+        onSelect(context) {
+          openPluginScreen(context, SCREEN_ID);
+        },
+      }),
+      client.addCommandCenterItem({
+        id: "create-issue",
+        title: "Linear: Create issue",
+        icon: "Plus",
+        keywords: ["linear", "new", "ticket"],
+        context: "global",
+        onSelect(context) {
+          updateBrowser(SCREEN_SCOPE, { creating: true });
+          openPluginScreen(context, SCREEN_ID);
+        },
+      }),
+      client.addCommandCenterItem({
+        id: "workspace-issues",
+        title: "Linear: Show issues in this workspace",
+        icon,
+        keywords: ["linear", "panel"],
+        context: "workspace",
+        onSelect({ openPanel }) {
+          openPanel(PANEL_ID);
+        },
+      }),
+      client.addCommandCenterItem({
+        id: "open-live",
+        title: "Linear: Open Linear Live",
+        icon: "Radar",
+        keywords: ["linear", "live", "progress", "map"],
+        context: "agent",
+        onSelect({ openPanel }) {
+          openPanel(LIVE_PANEL_ID);
+        },
+      }),
+      client.addCommandCenterItem({
+        id: "setup-project",
+        title: "Linear: Set up project prompts",
+        icon: "Sparkles",
+        keywords: ["linear", "init", "setup", "agents.md", "guidelines"],
+        context: "global",
+        onSelect({ openSettings }) {
+          openSettings("projects");
+        },
+      }),
+      client.addCommandCenterItem({
+        id: "settings",
+        title: "Linear: Settings",
+        icon: "Settings",
+        keywords: ["linear", "api key", "prompts", "projects"],
+        context: "global",
+        onSelect({ openSettings }) {
+          openSettings("connection");
+        },
+      }),
+    );
+  } catch (error) {
+    removeAll();
+    throw error;
+  }
+  return removeAll;
+}
+
+/** Registers the menus with the chosen icon, and again when it changes. */
+function contributeMenusWithIcon(client: PluginClientContext): Cleanup {
+  let icon = startMenuIcon();
+  let removeMenus: Cleanup;
+  try {
+    removeMenus = contributeMenus(client, icon);
+  } catch (error) {
+    console.error("Linear menu icon", error);
+    icon = BUILT_IN_ICON;
+    removeMenus = contributeMenus(client, icon);
+  }
+  const stop = onMenuIconChange((next) => {
+    if (next === icon) return;
+    removeMenus();
+    try {
+      removeMenus = contributeMenus(client, next);
+      icon = next;
+    } catch (error) {
+      // An icon this Paseo does not have: keep the built-in one.
+      console.error("Linear menu icon", error);
+      removeMenus = contributeMenus(client, BUILT_IN_ICON);
+      icon = BUILT_IN_ICON;
+    }
+  });
+  return () => {
+    stop();
+    removeMenus();
+  };
+}
+
 export default function contribute(client: PluginClientContext) {
   client.addAttachmentSource(issueAttachments);
   registerScreen(client, {
     id: SCREEN_ID,
     title: "Linear",
-    icon: "SquareKanban",
+    icon: BUILT_IN_ICON,
     RowIcon: PluginIcon,
     Component: LinearScreen,
   });
-  client.addWorkspacePanel({
-    id: PANEL_ID,
-    title: "Linear",
-    icon: "SquareKanban",
-    context: "workspace",
-    locations: ["workspace", "explorer"],
-    Component: LinearPanel,
-  });
   client.addSettingsScreen({
     id: "connection",
     title: "Account",
@@ -48,13 +166,6 @@ export default function contribute(client: PluginClientContext) {
     icon: "MessageSquare",
     Component: PromptSettings,
   });
-  client.addWorkspacePanel({
-    id: LIVE_PANEL_ID,
-    title: "Linear Live",
-    icon: "Radar",
-    context: "agent",
-    Component: gateAgentPanel(LivePanel),
-  });
   client.addSettingsScreen({
     id: "live",
     title: "Live",
@@ -73,67 +184,7 @@ export default function contribute(client: PluginClientContext) {
     icon: "FolderGit2",
     Component: ProjectSettings,
   });
-  client.addCommandCenterItem({
-    id: "open-issues",
-    title: "Linear: Open issues",
-    icon: "SquareKanban",
-    keywords: ["linear", "issues", "tickets"],
-    context: "global",
-    onSelect(context) {
-      openPluginScreen(context, SCREEN_ID);
-    },
-  });
-  client.addCommandCenterItem({
-    id: "create-issue",
-    title: "Linear: Create issue",
-    icon: "Plus",
-    keywords: ["linear", "new", "ticket"],
-    context: "global",
-    onSelect(context) {
-      updateBrowser(SCREEN_SCOPE, { creating: true });
-      openPluginScreen(context, SCREEN_ID);
-    },
-  });
-  client.addCommandCenterItem({
-    id: "workspace-issues",
-    title: "Linear: Show issues in this workspace",
-    icon: "SquareKanban",
-    keywords: ["linear", "panel"],
-    context: "workspace",
-    onSelect({ openPanel }) {
-      openPanel(PANEL_ID);
-    },
-  });
-  client.addCommandCenterItem({
-    id: "open-live",
-    title: "Linear: Open Linear Live",
-    icon: "Radar",
-    keywords: ["linear", "live", "progress", "map"],
-    context: "agent",
-    onSelect({ openPanel }) {
-      openPanel(LIVE_PANEL_ID);
-    },
-  });
-  client.addCommandCenterItem({
-    id: "setup-project",
-    title: "Linear: Set up project prompts",
-    icon: "Sparkles",
-    keywords: ["linear", "init", "setup", "agents.md", "guidelines"],
-    context: "global",
-    onSelect({ openSettings }) {
-      openSettings("projects");
-    },
-  });
-  client.addCommandCenterItem({
-    id: "settings",
-    title: "Linear: Settings",
-    icon: "Settings",
-    keywords: ["linear", "api key", "prompts", "projects"],
-    context: "global",
-    onSelect({ openSettings }) {
-      openSettings("connection");
-    },
-  });
+  const removeMenus = contributeMenusWithIcon(client);
   client.addSlashCommand({
     name: "linear",
     description: "Open Linear issues, or jump to one by key",
@@ -154,5 +205,9 @@ export default function contribute(client: PluginClientContext) {
     schema: IssueCardSchema,
     Component: IssueCardRow,
   });
-  return contributeComposerPills(client);
+  const removePills = contributeComposerPills(client);
+  return () => {
+    removeMenus();
+    removePills();
+  };
 }

package/index.server.ts

@@ -5,6 +5,7 @@ import { registerAgentTools } from "./server/agent-tools";
 import { createCredentialStore, defaultCredentialPath } from "./server/credentials";
 import { registerHandlers } from "./server/handlers";
 import { registerInit } from "./server/init";
+import { createKnowledge, registerKnowledge } from "./server/knowledge";
 import { registerLive } from "./server/live";
 import { createLaunchQueue, createMapStore } from "./server/stores";
 import { registerSync } from "./server/sync";
@@ -23,9 +24,11 @@ export default function contribute(server: PluginServerContext) {
   const dataDirectory = path.dirname(credentialPath);
   const maps = createMapStore(path.join(dataDirectory, "live-maps.json"));
   const launches = createLaunchQueue(path.join(dataDirectory, "pending-launches.json"));
-  registerLive(server, { access, maps, launches, readSettings });
+  const knowledge = createKnowledge(path.join(dataDirectory, "knowledge"));
+  registerKnowledge(server, knowledge);
+  registerLive(server, { access, maps, launches, knowledge, readSettings });
   registerSync(server, { access, readSettings });
-  registerInit(server, { readSettings });
+  registerInit(server, { readSettings, knowledge });
   registerAgentHooks(server, dataDirectory);
   const closeTools = registerAgentTools(server, { access, dataDirectory });
   server.handle(accessRpc, async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yannelli/paseo-linear-plugin",
-  "version": "1.1.0-beta.2",
+  "version": "1.1.0-beta.4",
   "description": "Browse and triage Linear issues in Paseo and start agents from them",
   "license": "Apache-2.0",
   "type": "module",