@mduan/paseo-cli 0.11.0-fork.30 → 0.11.0-fork.31

package/node_modules/@getpaseo/protocol/dist/messages.d.ts

@@ -718,6 +718,20 @@ export declare const WorkspaceLinearIssuesUpdateRequestSchema: z.ZodObject<{
     remove: z.ZodOptional<z.ZodArray<z.ZodString>>;
     requestId: z.ZodString;
 }, z.core.$strip>;
+export declare const WorkspaceRefreshMetadataRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"workspace.refresh_metadata.request">;
+    workspaceId: z.ZodString;
+    requestId: z.ZodString;
+}, z.core.$strip>;
+export declare const WorkspaceRefreshMetadataResponseSchema: z.ZodObject<{
+    type: z.ZodLiteral<"workspace.refresh_metadata.response">;
+    payload: z.ZodObject<{
+        requestId: z.ZodString;
+        workspaceId: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export declare const WorkspaceLinearIssuesUpdateResponseSchema: z.ZodObject<{
     type: z.ZodLiteral<"workspace.linear_issues.update.response">;
     payload: z.ZodObject<{
@@ -5362,6 +5376,10 @@ export declare const SessionInboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
     add: z.ZodOptional<z.ZodArray<z.ZodString>>;
     remove: z.ZodOptional<z.ZodArray<z.ZodString>>;
     requestId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"workspace.refresh_metadata.request">;
+    workspaceId: z.ZodString;
+    requestId: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"integrations.linear.get_connection.request">;
     requestId: z.ZodString;
@@ -7950,6 +7968,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         directorySync: z.ZodOptional<z.ZodBoolean>;
         workspaceLabels: z.ZodOptional<z.ZodBoolean>;
         workspaceLinearIssues: z.ZodOptional<z.ZodBoolean>;
+        workspaceMetadataRefresh: z.ZodOptional<z.ZodBoolean>;
         linearIntegration: z.ZodOptional<z.ZodBoolean>;
         workspaceSetupRun: z.ZodOptional<z.ZodBoolean>;
         turnDiffs: z.ZodOptional<z.ZodBoolean>;
@@ -8070,6 +8089,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         directorySync?: boolean | undefined;
         workspaceLabels?: boolean | undefined;
         workspaceLinearIssues?: boolean | undefined;
+        workspaceMetadataRefresh?: boolean | undefined;
         linearIntegration?: boolean | undefined;
         workspaceSetupRun?: boolean | undefined;
         turnDiffs?: boolean | undefined;
@@ -8191,6 +8211,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         directorySync?: boolean | undefined;
         workspaceLabels?: boolean | undefined;
         workspaceLinearIssues?: boolean | undefined;
+        workspaceMetadataRefresh?: boolean | undefined;
         linearIntegration?: boolean | undefined;
         workspaceSetupRun?: boolean | undefined;
         turnDiffs?: boolean | undefined;
@@ -34037,6 +34058,14 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
         }, z.core.$strip>>;
         error: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"workspace.refresh_metadata.response">;
+    payload: z.ZodObject<{
+        requestId: z.ZodString;
+        workspaceId: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"integrations.linear.get_connection.response">;
     payload: z.ZodObject<{
@@ -38718,6 +38747,10 @@ export declare const WSSessionInboundSchema: z.ZodObject<{
         add: z.ZodOptional<z.ZodArray<z.ZodString>>;
         remove: z.ZodOptional<z.ZodArray<z.ZodString>>;
         requestId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"workspace.refresh_metadata.request">;
+        workspaceId: z.ZodString;
+        requestId: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"integrations.linear.get_connection.request">;
         requestId: z.ZodString;
@@ -50995,6 +51028,14 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
             }, z.core.$strip>>;
             error: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"workspace.refresh_metadata.response">;
+        payload: z.ZodObject<{
+            requestId: z.ZodString;
+            workspaceId: z.ZodString;
+            success: z.ZodBoolean;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"integrations.linear.get_connection.response">;
         payload: z.ZodObject<{
@@ -55315,6 +55356,10 @@ export declare const WSInboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         add: z.ZodOptional<z.ZodArray<z.ZodString>>;
         remove: z.ZodOptional<z.ZodArray<z.ZodString>>;
         requestId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"workspace.refresh_metadata.request">;
+        workspaceId: z.ZodString;
+        requestId: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"integrations.linear.get_connection.request">;
         requestId: z.ZodString;
@@ -67594,6 +67639,14 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             }, z.core.$strip>>;
             error: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"workspace.refresh_metadata.response">;
+        payload: z.ZodObject<{
+            requestId: z.ZodString;
+            workspaceId: z.ZodString;
+            success: z.ZodBoolean;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"integrations.linear.get_connection.response">;
         payload: z.ZodObject<{

package/node_modules/@getpaseo/protocol/dist/messages.js

@@ -874,6 +874,20 @@ export const WorkspaceLinearIssuesUpdateRequestSchema = z.object({
     remove: z.array(z.string()).optional(),
     requestId: z.string(),
 });
+export const WorkspaceRefreshMetadataRequestSchema = z.object({
+    type: z.literal("workspace.refresh_metadata.request"),
+    workspaceId: z.string(),
+    requestId: z.string(),
+});
+export const WorkspaceRefreshMetadataResponseSchema = z.object({
+    type: z.literal("workspace.refresh_metadata.response"),
+    payload: z.object({
+        requestId: z.string(),
+        workspaceId: z.string(),
+        success: z.boolean(),
+        error: z.string().optional(),
+    }),
+});
 export const WorkspaceLinearIssuesUpdateResponseSchema = z.object({
     type: z.literal("workspace.linear_issues.update.response"),
     payload: z.object({
@@ -2929,6 +2943,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ProjectIconColorSetRequestSchema,
     ProjectRemoveRequestSchema,
     WorkspaceLinearIssuesUpdateRequestSchema,
+    WorkspaceRefreshMetadataRequestSchema,
     LinearGetConnectionRequestSchema,
     LinearSetKeyRequestSchema,
     LinearDisconnectRequestSchema,
@@ -3290,6 +3305,8 @@ export const ServerInfoStatusPayloadSchema = z
         workspaceLabels: z.boolean().optional(),
         // COMPAT(workspaceLinearIssues): added in v0.11.0-fork.27, remove gate after 2027-04-21.
         workspaceLinearIssues: z.boolean().optional(),
+        // COMPAT(workspaceMetadataRefresh): added in v0.11.0-fork.30, remove gate after 2027-04-21.
+        workspaceMetadataRefresh: z.boolean().optional(),
         // COMPAT(linearIntegration): added in v0.11.0-fork.28, remove gate after 2027-04-21.
         linearIntegration: z.boolean().optional(),
         // COMPAT(workspaceSetupRun): added in v0.8.0, remove gate after 2027-09-02.
@@ -6466,6 +6483,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ProjectIconColorSetResponseSchema,
     ProjectRemoveResponseSchema,
     WorkspaceLinearIssuesUpdateResponseSchema,
+    WorkspaceRefreshMetadataResponseSchema,
     LinearGetConnectionResponseSchema,
     LinearSetKeyResponseSchema,
     LinearDisconnectResponseSchema,

package/node_modules/@getpaseo/protocol/dist/validation/ws-outbound-schema-metadata.d.ts

@@ -9869,6 +9869,14 @@ export declare const WSOutboundMessageSchema: {
                 }, import("zod/v4/core").$strip>>;
                 error: import("zod").ZodNullable<import("zod").ZodString>;
             }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"workspace.refresh_metadata.response">;
+            payload: import("zod").ZodObject<{
+                requestId: import("zod").ZodString;
+                workspaceId: import("zod").ZodString;
+                success: import("zod").ZodBoolean;
+                error: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             type: import("zod").ZodLiteral<"integrations.linear.get_connection.response">;
             payload: import("zod").ZodObject<{

package/node_modules/@getpaseo/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/protocol",
-  "version": "0.11.0-fork.30",
+  "version": "0.11.0-fork.31",
   "description": "Paseo shared protocol schemas and wire types",
   "files": [
     "dist",

package/node_modules/@getpaseo/relay/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/relay",
-  "version": "0.11.0-fork.30",
+  "version": "0.11.0-fork.31",
   "description": "Paseo relay for bridging daemon and client connections",
   "files": [
     "dist",

package/node_modules/@getpaseo/server/dist/server/builtin-plugins/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/builtin-plugins",
-  "version": "0.11.0-fork.30",
+  "version": "0.11.0-fork.31",
   "private": true,
   "type": "module",
   "scripts": {

package/node_modules/@getpaseo/server/dist/server/server/authorization/operation-permissions.js

@@ -212,6 +212,7 @@ const INBOUND_PERMISSION = {
     "workspace.script.start.request": "workspace.write",
     "workspace.script.stop.request": "workspace.write",
     "workspace.linear_issues.update.request": ["workspace.manage", "hub.execute"],
+    "workspace.refresh_metadata.request": "workspace.read",
     "integrations.linear.get_connection.request": "daemon.read",
     "integrations.linear.set_key.request": "daemon.manage",
     "integrations.linear.disconnect.request": "daemon.manage",
@@ -449,6 +450,7 @@ const OUTBOUND_PERMISSION = {
     "workspace.script.start.response": "workspace.write",
     "workspace.script.stop.response": "workspace.write",
     "workspace.linear_issues.update.response": ["workspace.manage", "hub.execute"],
+    "workspace.refresh_metadata.response": "workspace.read",
     "integrations.linear.get_connection.response": "daemon.read",
     "integrations.linear.set_key.response": "daemon.manage",
     "integrations.linear.disconnect.response": "daemon.manage",

package/node_modules/@getpaseo/server/dist/server/server/session.d.ts

@@ -414,6 +414,7 @@ export declare class Session {
     private handleProjectRemoveRequest;
     private dispatchLinearIntegrationMessage;
     private handleLinearIntegrationRequest;
+    private handleWorkspaceMetadataRefresh;
     private handleWorkspaceLinearIssuesUpdate;
     private handleWorkspaceTitleSetRequest;
     private handleWorkspacePinSetRequest;

package/node_modules/@getpaseo/server/dist/server/server/session.js

@@ -2074,6 +2074,8 @@ export class Session {
                 return this.handleProjectIconColorSetRequest(msg);
             case "workspace.linear_issues.update.request":
                 return this.handleWorkspaceLinearIssuesUpdate(msg);
+            case "workspace.refresh_metadata.request":
+                return this.handleWorkspaceMetadataRefresh(msg);
             case "workspace.title.set.request":
                 return this.handleWorkspaceTitleSetRequest(msg.workspaceId, msg.title, msg.requestId);
             case "workspace.pin.set.request":
@@ -2799,6 +2801,42 @@ export class Session {
             });
         }
     }
+    async handleWorkspaceMetadataRefresh(request) {
+        const { workspaceId, requestId } = request;
+        try {
+            const workspace = await this.workspaceRegistry.get(workspaceId);
+            if (!workspace)
+                throw new Error("Workspace not found");
+            await Promise.all([
+                this.workspacePorts?.refresh(),
+                this.workspaceGitService
+                    .getSnapshot(workspace.cwd, {
+                    force: true,
+                    includeForge: true,
+                    refreshGit: false,
+                    queueIfBusy: false,
+                    reason: "workspace-hover",
+                })
+                    .then((snapshot) => this.linearIntegration.getPullRequestIssues(snapshot.forge.pullRequest?.url, {
+                    force: true,
+                }))
+                    .then((prIssues) => this.linearIntegration.resolve(mergeLinearIssues(workspace.linearIssues, prIssues), {
+                    force: true,
+                })),
+            ]);
+            await this.emitWorkspaceUpdatesForWorkspaceIds([workspaceId]);
+            this.emit({
+                type: "workspace.refresh_metadata.response",
+                payload: { workspaceId, requestId, success: true },
+            });
+        }
+        catch (error) {
+            this.emit({
+                type: "workspace.refresh_metadata.response",
+                payload: { workspaceId, requestId, success: false, error: getErrorMessage(error) },
+            });
+        }
+    }
     async handleWorkspaceLinearIssuesUpdate(request) {
         const { workspaceId, requestId, add, remove } = request;
         let updated;

package/node_modules/@getpaseo/server/dist/server/server/websocket-server.js

@@ -1310,6 +1310,7 @@ export class VoiceAssistantWebSocketServer {
                 // COMPAT(workspaceSetupRun): added in v0.7.3, remove gate after 2027-09-02.
                 workspaceSetupRun: true,
                 workspaceLinearIssues: true,
+                workspaceMetadataRefresh: true,
                 linearIntegration: true,
                 // COMPAT(turnDiffs): added in v0.11.0, remove gate after 2027-10-03.
                 turnDiffs: true,

package/node_modules/@getpaseo/server/dist/server/server/workspace-git-service.d.ts

@@ -155,6 +155,7 @@ export type WorkspaceGitBranchSuggestion = BranchSuggestion;
 export type WorkspaceGitWorktreeInfo = PaseoWorktreeInfo;
 export type WorkspaceGitSnapshotOptions = WorkspaceGitReadOptions & {
     includeForge?: boolean;
+    refreshGit?: boolean;
     queueIfBusy?: boolean;
 };
 interface WorkspaceGitServiceDependencies {

package/node_modules/@getpaseo/server/dist/server/server/workspace-git-service.js

@@ -2167,8 +2167,8 @@ export class WorkspaceGitServiceImpl {
         const force = options?.force === true;
         return {
             force,
-            refreshStructure: true,
-            refreshWorktree: true,
+            refreshStructure: options?.refreshGit !== false,
+            refreshWorktree: options?.refreshGit !== false,
             includeForge: options?.includeForge ?? true,
             reason: options?.reason ?? defaultReason,
             notify,

package/node_modules/@getpaseo/server/dist/server/server/workspace-ports/service.d.ts

@@ -11,7 +11,8 @@ export declare class WorkspacePortsService {
     private readonly options;
     private active;
     private disposed;
-    private running;
+    private pending?;
+    private lastScanAt?;
     private timer?;
     private readonly details;
     private ports;
@@ -20,7 +21,9 @@ export declare class WorkspacePortsService {
     getPorts(workspaceId: string): WorkspacePort[];
     setConnected(connected: boolean): void;
     dispose(): void;
-    private refresh;
+    refresh(): Promise<void>;
+    private startRefresh;
+    private scan;
 }
 export {};
 //# sourceMappingURL=service.d.ts.map

package/node_modules/@getpaseo/server/dist/server/server/workspace-ports/service.js

@@ -5,7 +5,6 @@ export class WorkspacePortsService {
         this.options = options;
         this.active = false;
         this.disposed = false;
-        this.running = false;
         this.details = new Map();
         this.ports = [];
         this.byWorkspace = new Map();
@@ -20,16 +19,34 @@ export class WorkspacePortsService {
         if (this.timer)
             clearTimeout(this.timer);
         this.timer = undefined;
-        if (connected && !this.running)
-            void this.refresh();
+        if (connected && !this.pending)
+            void this.startRefresh();
     }
     dispose() {
         this.setConnected(false);
         this.disposed = true;
         this.details.clear();
     }
-    async refresh() {
-        this.running = true;
+    refresh() {
+        if (this.disposed)
+            return Promise.resolve();
+        if (this.pending)
+            return this.pending;
+        // Hovering across rows must not launch a host-wide process scan for every row.
+        if (this.lastScanAt !== undefined && Date.now() - this.lastScanAt < 5000)
+            return Promise.resolve();
+        return this.startRefresh();
+    }
+    startRefresh() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+        this.pending = this.scan().finally(() => {
+            this.pending = undefined;
+        });
+        return this.pending;
+    }
+    async scan() {
         try {
             const scan = this.options.scan ??
                 ((details) => scanListeningPorts({ details, logger: this.options.logger }));
@@ -55,9 +72,9 @@ export class WorkspacePortsService {
             this.options.logger.warn({ err: error }, "Failed to publish workspace ports");
         }
         finally {
-            this.running = false;
+            this.lastScanAt = Date.now();
             if (this.active) {
-                this.timer = setTimeout(() => void this.refresh(), 30000);
+                this.timer = setTimeout(() => void this.startRefresh(), 30000);
                 this.timer.unref();
             }
         }

package/node_modules/@getpaseo/server/dist/server/services/linear-integration.d.ts

@@ -1,11 +1,14 @@
 import type { Logger } from "pino";
 import { type LinearConnection, type LinearIssue } from "@getpaseo/protocol/messages";
+type LookupOptions = {
+    force?: boolean;
+};
 export type LinearIntegrationService = {
     getConnection(): Promise<LinearConnection>;
     setKey(apiKey: string): Promise<LinearConnection>;
     disconnect(): Promise<LinearConnection>;
-    getPullRequestIssues(url?: string): Promise<LinearIssue[]>;
-    resolve(issues?: readonly LinearIssue[]): Promise<LinearIssue[] | undefined>;
+    getPullRequestIssues(url?: string, options?: LookupOptions): Promise<LinearIssue[]>;
+    resolve(issues?: readonly LinearIssue[], options?: LookupOptions): Promise<LinearIssue[] | undefined>;
 };
 type Options = {
     paseoHome: string;

package/node_modules/@getpaseo/server/dist/server/services/linear-integration.js

@@ -212,7 +212,7 @@ export function createLinearIntegrationService({ paseoHome, logger, request = fe
                 return describe(undefined);
             });
         },
-        async getPullRequestIssues(url) {
+        async getPullRequestIssues(url, options) {
             if (!url)
                 return [];
             try {
@@ -220,7 +220,9 @@ export function createLinearIntegrationService({ paseoHome, logger, request = fe
                 if (!connection)
                     return [];
                 let entry = pullRequestCache.get(url);
-                if (!entry || entry.expiresAt <= now()) {
+                if (!entry ||
+                    entry.expiresAt <= now() ||
+                    (options?.force && Number.isFinite(entry.expiresAt))) {
                     const pending = limitRequests(() => loadPullRequestIssues({ url, apiKey: connection.apiKey }));
                     entry = { pending, expiresAt: Number.POSITIVE_INFINITY };
                     const current = entry;
@@ -242,7 +244,7 @@ export function createLinearIntegrationService({ paseoHome, logger, request = fe
                 return [];
             }
         },
-        async resolve(issues) {
+        async resolve(issues, options) {
             if (!issues?.length)
                 return issues ? [...issues] : undefined;
             let connection;
@@ -261,7 +263,9 @@ export function createLinearIntegrationService({ paseoHome, logger, request = fe
                 if (!normalized)
                     return issue;
                 let entry = cache.get(normalized.url);
-                if (!entry || entry.expiresAt <= now()) {
+                if (!entry ||
+                    entry.expiresAt <= now() ||
+                    (options?.force && Number.isFinite(entry.expiresAt))) {
                     const pending = limitRequests(() => loadIssue({ issue: normalized, apiKey }));
                     entry = { pending, expiresAt: Number.POSITIVE_INFINITY };
                     cache.set(normalized.url, entry);