@stevecastaneda/paseo-progress 1.9.0 → 1.10.0

package/README.md

@@ -24,7 +24,7 @@ The panel lives in Explorer, beside the agent chat, so you can watch both. Open
 
 <img src="images/4-pill.png" alt="The pill above the message box, showing two questions waiting" width="600">
 
-On phones, where Paseo has no Explorer pane, Progress opens as a tab of its own, and the pill stays above the message box while a run is open so there's always a way in. SVG files and videos preview on desktop; on phones they open on the daemon host.
+On phones with Paseo 0.13 or later, Progress opens in Explorer too. Older phone apps have no Explorer, so there it opens as a tab of its own. On any phone, the pill stays above the message box while a run is open, so there's always a way in. SVG files and videos preview on desktop; on phones they open on the daemon host.
 
 The first time a run starts in a worktree whose Progress panel has never been opened, the pill shows a spinner and reads **Progress** instead; pressing it opens the panel. Once the panel has been opened there, the plugin writes an empty `progress-panel-opened` file next to the progress file and the nudge never comes back, even for later runs. It doesn't open the panel by itself because Paseo switches to a workspace to open its panel, which would pull you away from whatever you're looking at.
 
@@ -145,6 +145,10 @@ The progress file, `progress.jsonl`, holds one JSON event per line, each with a
 
 ## Changelog
 
+### 1.10.0
+
+- [Improved] **Progress opens in Explorer on phones.** On Paseo 0.13 or later, the phone app opens Progress in Explorer, as the desktop app does, and lists it in Explorer's New tab menu. If a Progress tab from an earlier version is still open on your phone, you can close it.
+
 ### 1.9.0
 
 - [Improved] **The pill's popover shows one question at a time.** You used to scroll past every open question to reach the one you wanted. Now **Question 2 of 3** sits at the top with back and next arrows. Copy an answer and the popover opens on the next question the next time you press the pill.

package/client/pill-popover.tsx

@@ -4,7 +4,6 @@ import React, { useRef, useState } from "react";
 import { Text, View } from "react-native";
 import type { Dashboard } from "../shared/dashboard";
 import { useDashboard } from "./dashboard-query";
-import { progressPanel } from "./pills";
 import { PressScale } from "./motion";
 import { type Attachment, isPreviewable, useAttachmentOpener } from "./attachments";
 import { StackedDialog } from "./dialog-stack";
@@ -33,8 +32,8 @@ export function AttentionPopover({ theme, host, layout, workspaceId, close, open
   const colors = theme.colors;
   // Paseo draws the desktop popover on surface1 and the phone sheet on surface0.
   const onSurface1 = !layout.compact;
-  // Phones open the panel as its own tab, and are pressed with a finger.
-  const touch = progressPanel().location === "workspace";
+  // The phone apps are pressed with a finger.
+  const touch = layout.platform !== "web";
   const directory = useWorkspace(workspaceId, (workspace) => workspace.directory);
   const query = useDashboard(host.id, workspaceId, directory);
   const dashboard = query.data?.configured ? query.data.dashboard : null;

package/client/pill-state.ts

@@ -5,8 +5,7 @@ import type { AttentionResult } from "../shared/rpc";
 // icon and what pressing it does can't disagree.
 // - "attention": questions waiting or something stuck; opens a popover.
 // - "started": a run whose panel has never been opened; a one-time nudge.
-// - "open": on a phone, the way into the panel while a run is open, since
-//   phones have no Explorer to open it from.
+// - "open": on a phone, a one-tap way into the panel while a run is open.
 export type Pill =
   | { mode: "attention"; label: string; icon: "stuck" | "questions" }
   | { mode: "started"; label: "Progress"; icon: "started" }

package/client/pills.tsx

@@ -18,13 +18,17 @@ export const PILL_POLL_MS = 5_000;
 // still trigger a check, at most once a poll interval.
 export const IDLE_POLL_EVERY = 6;
 
-// Paseo's desktop app shows the panel in Explorer, beside the chat. The phone
-// apps never draw Explorer's pane, so there the panel is a tab of its own.
-// It has its own id on phones: Paseo 0.10.1 reopens an existing tab where it
+// Phones on Paseo before 0.13 have no Explorer, so there the panel is a tab of
+// its own. addFilePanel arrived in 0.13, the release that gave phones Explorer.
+// The tab has its own id: Paseo 0.10.1 reopens an existing tab where it
 // already is, and earlier versions of this plugin left a "progress" tab in the
 // phone's hidden Explorer pane, which a plugin can't move or close.
-export function progressPanel(): { id: string; location: "explorer" | "workspace" } {
-  return Platform.OS === "web" ? { id: "progress", location: "explorer" } : { id: "progress-tab", location: "workspace" };
+type ProgressPanelPlacement = { id: "progress"; location: "explorer" } | { id: "progress-tab"; location: "workspace" };
+
+export function progressPanel(client: PluginClientContext): ProgressPanelPlacement {
+  return Platform.OS === "web" || "addFilePanel" in client
+    ? { id: "progress", location: "explorer" }
+    : { id: "progress-tab", location: "workspace" };
 }
 
 type Workspace = { id: string; workspaceDirectory?: string; projectRootPath: string };
@@ -44,7 +48,7 @@ export function contributePills(client: PluginClientContext) {
   // The last report per workspace; pillFor turns it into what the pill shows.
   const reports = new Map<string, AttentionResult>();
   let locale = resolveLocale("system");
-  const where = { phone: progressPanel().location === "workspace" };
+  const where = { phone: Platform.OS !== "web" };
   const pillOf = (workspaceId: string) => pillFor(reports.get(workspaceId), where, messagesFor(locale));
   // Bumped on each report so a poll that was already in flight can't bring the pill back.
   let openedReports = 0;
@@ -83,9 +87,9 @@ export function contributePills(client: PluginClientContext) {
     );
   }
 
+  const panel = progressPanel(client);
   const openPanel = (workspaceId: string) => {
-    const { id, location } = progressPanel();
-    client.openPanel(id, { workspaceId, location });
+    client.openPanel(panel.id, { workspaceId, location: panel.location });
   };
 
   const buttonFor = (workspaceId: string, mode: Pill["mode"], label: string) => mode === "attention"

package/index.client.tsx

@@ -9,7 +9,7 @@ const SETTINGS_ID = "settings";
 
 export default function contribute(client: PluginClientContext) {
   const stopPills = contributePills(client);
-  const panel = progressPanel();
+  const panel = progressPanel(client);
   const stopPanel = client.addWorkspacePanel({
     id: panel.id,
     title: "Progress",
@@ -24,7 +24,6 @@ export default function contribute(client: PluginClientContext) {
     icon: "ListChecks",
     keywords: ["dashboard", "tickets", "status", "questions"],
     context: "workspace",
-    // Beside the agent chat where Paseo can show both; a tab of its own on phones.
     onSelect({ openPanel }) {
       openPanel(panel.id, { location: panel.location });
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stevecastaneda/paseo-progress",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "A live progress dashboard per worktree for Paseo, drawn from a file agents write with the paseo-progress command.",
   "license": "MIT",
   "author": "Steve Castaneda",