@yannelli/paseo-linear-plugin 1.1.0-beta.1 → 1.1.0-beta.3

package/shared/live.ts

@@ -1,6 +1,7 @@
 import { defineRpc } from "@getpaseo/plugin";
 import { z } from "zod";
 import { McpHttpServerSchema, ToolPolicySchema } from "./agent-tools";
+import { type AreaRef, areasIn } from "./knowledge";
 import { IssueCardSchema, WorkflowStateSchema } from "./linear";
 
 // Contracts for Linear Live, todo sync, and project setup. Agents the plugin starts for itself
@@ -40,6 +41,9 @@ export const InitProposalSchema = z.object({
   steps: z.array(z.string()).default([]),
   implement: z.string().default(""),
   review: z.string().default(""),
+  /** Saved to the project knowledge at once; not part of the prompt proposal. */
+  summary: z.string().default(""),
+  areas: z.array(z.object({ path: z.string(), summary: z.string() })).max(80).default([]),
 });
 export type InitProposal = z.infer<typeof InitProposalSchema>;
 
@@ -194,18 +198,30 @@ export interface SemanticIssue {
   children: readonly { identifier: string; title: string }[];
 }
 
+/** What project knowledge adds to a ticket-text map. */
+export interface MapHints {
+  /** Ticket paths matched to real files, such as "linear.ts" to "server/linear.ts". */
+  resolved?: ReadonlyMap<string, string>;
+  /** A service or package the text names puts its folder on the map. */
+  areas?: readonly AreaRef[];
+}
+
 // Linear sends sub-issue titles but not their descriptions, so a path in the parent's text
 // belongs to the sub-issue its line names and otherwise to the parent.
-export function semanticMap(issue: SemanticIssue, now = new Date()): IssueMap {
+export function semanticMap(issue: SemanticIssue, now = new Date(), hints: MapHints = {}): IssueMap {
   const owners = new Map<string, string>();
   const childKeys = new Set(issue.children.map((child) => child.identifier.toUpperCase()));
+  const found = (text: string) => [
+    ...pathsIn(text).map((path) => hints.resolved?.get(path) ?? path),
+    ...areasIn(text, hints.areas ?? []).map((area) => area.path),
+  ];
   for (const child of issue.children) {
-    for (const path of pathsIn(child.title)) owners.set(path, child.identifier);
+    for (const path of found(child.title)) owners.set(path, child.identifier);
   }
   const lines = `${issue.title}\n${issue.description ?? ""}`.split("\n");
   for (const line of lines) {
     const named = (line.match(ISSUE_KEY) ?? []).find((key) => childKeys.has(key));
-    for (const path of pathsIn(line)) {
+    for (const path of found(line)) {
       if (!owners.has(path)) owners.set(path, named ?? issue.identifier);
     }
   }

package/shared/map-model.ts

@@ -1,4 +1,5 @@
 import type { DirTouch, FileTouch } from "./activity";
+import { type AreaRef, areaLabel, areaOf, whereLabel } from "./knowledge";
 import { dirOf, type MapFile } from "./live";
 
 // The Linear Live map: predicted files and touched files grouped into folder zones, and the
@@ -31,12 +32,21 @@ export interface MapZone {
   /** Touched files that are on the map. */
   hits: number;
   explored: ZoneExplored;
+  /** The service, package, or main folder the zone is in, from the project knowledge. */
+  area: AreaRef | null;
+}
+
+/** Touched files the map did not predict, grouped by where they are. */
+export interface OffMapGroup {
+  where: string;
+  files: number;
 }
 
 export interface MapModel {
   zones: MapZone[];
   touched: number;
   hits: number;
+  offMap: OffMapGroup[];
 }
 
 // Search hits alone do not count: one broad search would flood the map with off-map tiles.
@@ -98,6 +108,7 @@ export function buildMapModel(
   touches: readonly FileTouch[],
   listing: ReadonlyMap<string, readonly string[]>,
   dirs: readonly DirTouch[] = [],
+  areas: readonly AreaRef[] = [],
 ): MapModel {
   const predicted = predictions(files);
   const touched = new Map(touches.filter(isTouched).map((file) => [file.path, file]));
@@ -134,11 +145,19 @@ export function buildMapModel(
       touched: tiles.filter((tile) => tile.touch !== "none").length,
       hits: tiles.filter((tile) => tile.touch !== "none" && tile.onMap).length,
       explored: exploredState(dir, dirs),
+      area: areaOf(dir, areas),
     };
   });
   let hits = 0;
-  for (const path of touched.keys()) if (ownerOf(path, predicted)) hits += 1;
-  return { zones, touched: touched.size, hits };
+  const off = new Map<string, number>();
+  for (const path of touched.keys()) {
+    if (ownerOf(path, predicted)) hits += 1;
+    else off.set(whereLabel(path, areas), (off.get(whereLabel(path, areas)) ?? 0) + 1);
+  }
+  const offMap = [...off]
+    .map(([where, count]) => ({ where, files: count }))
+    .sort((a, b) => b.files - a.files || a.where.localeCompare(b.where));
+  return { zones, touched: touched.size, hits, offMap };
 }
 
 export function hitRateLine(model: MapModel): string {
@@ -147,6 +166,35 @@ export function hitRateLine(model: MapModel): string {
   return `${model.touched} ${noun} touched, ${model.hits} on the map`;
 }
 
+const OFF_MAP_SHOWN = 4;
+
+/** Such as "Off the map: billing-api · service (3), docs (1)"; null when all are on it. */
+export function offMapLine(model: MapModel): string | null {
+  if (model.offMap.length === 0) return null;
+  const shown = model.offMap.slice(0, OFF_MAP_SHOWN).map((group) => `${group.where} (${group.files})`);
+  const more = model.offMap.length - OFF_MAP_SHOWN;
+  return `Off the map: ${shown.join(", ")}${more > 0 ? `, ${more} more` : ""}`;
+}
+
+/** Where the file is when the agent touched it off the map; null on the map or untouched. */
+export function offMapWhere(model: MapModel, path: string | null, areas: readonly AreaRef[]): string | null {
+  if (!path) return null;
+  for (const zone of model.zones) {
+    const tile = zone.tiles.find((entry) => entry.path === path && !entry.ghost);
+    if (tile) return tile.touch !== "none" && !tile.onMap ? whereLabel(path, areas) : null;
+  }
+  return null;
+}
+
+/** The area a zone header names; only the part its folder name does not already say. */
+export function zoneAreaLabel(zone: MapZone): string | null {
+  const area = zone.area;
+  if (!area || area.path === "") return null;
+  const folder = area.path.replace(/\/$/, "").split("/").pop();
+  if (zone.dir !== area.path || area.name !== folder) return areaLabel(area);
+  return area.role || (area.kind === "folder" ? null : area.kind);
+}
+
 export const ZONE_GAP = 10;
 
 // Rough zone height from its tiles, so zones can go to the shortest column. Tiles wrap, so

package/shared/project-setup.ts

@@ -3,6 +3,7 @@ import type { ProjectConfig } from "./settings";
 
 // A setup proposal shows only fields that change; accepted fields append to the prompts.
 export type ProposalField = "instructions" | "steps" | "implement" | "review";
+type PromptProposal = Pick<InitProposal, ProposalField>;
 
 export interface FieldDiff {
   field: ProposalField;
@@ -11,7 +12,7 @@ export interface FieldDiff {
   proposed: string;
 }
 
-export function proposalDiffs(config: ProjectConfig, proposal: InitProposal): FieldDiff[] {
+export function proposalDiffs(config: ProjectConfig, proposal: PromptProposal): FieldDiff[] {
   const steps = proposal.steps.map((step) => step.trim()).filter(Boolean);
   const rows: FieldDiff[] = [
     {
@@ -43,7 +44,7 @@ export function proposalDiffs(config: ProjectConfig, proposal: InitProposal): Fi
 }
 
 export function applyProposal(
-  proposal: InitProposal,
+  proposal: PromptProposal,
   fields: ReadonlySet<ProposalField>,
 ): Partial<ProjectConfig> {
   const patch: Partial<ProjectConfig> = {};

package/shared/settings.ts

@@ -1,5 +1,6 @@
 import { defineRpc, defineSettings } from "@getpaseo/plugin";
 import { z } from "zod";
+import { IconSettingsSchema } from "./custom-icon";
 
 export const AGENT_ACTIONS = ["implement", "review"] as const;
 export type AgentAction = (typeof AGENT_ACTIONS)[number];
@@ -101,6 +102,8 @@ export const linearSettings = defineSettings({
       })
       .prefault({}),
     projects: z.array(ProjectConfigSchema).default([]),
+    /** The icon of pills and other plugin places: built-in or the user's SVG. */
+    icon: IconSettingsSchema.prefault({}),
   }),
 });