@stevecastaneda/paseo-progress 1.4.0 → 1.5.1

package/README.md

@@ -18,7 +18,7 @@ The dashboard shows:
 
 <img src="images/2-ticket.png" alt="A ticket's story: its status, time against the estimate, the agent on it, and its timeline" width="400"> <img src="images/3-question.png" alt="A question waiting for an answer, with lettered options, the agent's recommendation and Copy buttons" width="400">
 
-<img src="images/5-settings.png" alt="The Questions setting in Paseo's Settings, set to Work around" width="600">
+<img src="images/5-settings.png" alt="Progress settings in Paseo: the Questions setting set to Work around, and the Language setting set to System" width="600">
 
 The panel lives in Explorer, beside the agent chat, so you can watch both. Open it from Command Center with **Open Progress**. The cog at the top right of the panel opens the plugin's Settings. After an update, the panel shows what's new in that version once. When questions are waiting or something is stuck, a pill above the message box says so, for example `3 questions`. With something stuck too, it shortens to `3Q · 1 stuck` to fit. Pressing it opens a popover with each open question, its choices and their Copy buttons, and what is stuck, so you can answer without leaving the chat. **Open Progress** at the bottom opens the panel in Explorer.
 
@@ -58,6 +58,14 @@ The command, and **Install skill** in the panel, look for Paseo's own command in
 
 Setting `PASEO_PROGRESS_PLUGIN_DIR` to a plugin folder makes the command run that copy without asking Paseo. Use it only for testing, because an installed plugin's folder changes with every update.
 
+## Language
+
+Progress comes in English and Simplified Chinese. To pick one, open the cog in the Progress panel and choose **Display → Language**. **System** follows each device's language and falls back to English for anything other than Simplified Chinese, so Traditional Chinese stays in English for now.
+
+The choice is saved on the Paseo host, so every device connected to it shows the same language. Progress can't follow Paseo's own language setting, because Paseo doesn't share it with plugins. Open dialogs and pills switch as soon as you change it. The **Progress** name and its **Open Progress** and **Settings** entries stay in English.
+
+Progress translates its own labels, not what agents write. Titles, questions, choices, stages, notes, item labels like `Ticket`, file paths and release notes stay as written, and so do error messages from the host. The `paseo-progress` command and the reply you copy for an agent stay in English too.
+
 ## Where progress is kept
 
 Each worktree's progress lives outside the repo, in its own folder under `~/.local/state/paseo-progress/` on the daemon host. There's nothing to set up and nothing to hide: git never sees these files, and the plugin never edits a `.gitignore` or git's exclude file. The panel's empty state shows the exact path.
@@ -137,6 +145,15 @@ The progress file, `progress.jsonl`, holds one JSON event per line, each with a
 
 ## Changelog
 
+### 1.5.1
+
+- [New] **Simplified Chinese.** Progress now comes in English and Simplified Chinese. Pick one under Display in Progress settings, or let it follow each device's language. Thanks to @xzthemeofsss for the translation.
+- [Improved] **Settings screenshot.** It shows the new Language setting.
+
+### 1.5.0
+
+- [New] **Simplified Chinese.** Progress now comes in English and Simplified Chinese. Pick one under Display in Progress settings, or let it follow each device's language. Thanks to @xzthemeofsss for the translation.
+
 ### 1.4.0
 
 - [New] **Choose what agents do while a question waits.** Open Settings with the cog at the top right of the Progress panel. **Stop** halts all work until you answer. **Work around**, the default, holds only what your answer affects, which is how questions already worked. **Keep building** builds the agent's pick and changes course if you choose another.

package/client/attachments.tsx

@@ -6,6 +6,7 @@ import { type Attachment, attachmentIcon, canPreview, shortName } from "../share
 import { errorText } from "./errors";
 import { PressableRow } from "./row";
 import { openDeliverable } from "../shared/rpc";
+import { useProgressLanguage } from "./language";
 
 export { type Attachment, attachmentIcon, deliverableAttachment, questionAttachments, shortName, ticketSourceAttachment } from "../shared/attachments";
 
@@ -31,22 +32,23 @@ export function useAttachmentOpener({ workspaceId, workspaceDirectory, navigatio
   navigation?: Navigation;
   onPreview?(attachment: Attachment): void;
 }) {
+  const { messages: m } = useProgressLanguage();
   const toast = useToast();
   const openOnHostRpc = useRpc(openDeliverable);
   async function copyPath(attachment: Attachment, prefix = "") {
     try {
       await copyText(absolutePath(attachment.path!, workspaceDirectory));
-      toast.show(`${prefix}Copied path`, { variant: prefix ? "warning" : "success" });
+      toast.show(`${prefix}${m.copyPathDone}`, { variant: prefix ? "warning" : "success" });
     } catch {
-      toast.error("Could not copy. Select the path and use Copy.");
+      toast.error(m.copyPathFailure);
     }
   }
   async function openOnHost(attachment: Attachment) {
     try {
       await openOnHostRpc({ workspaceId, workspaceDirectory, ref: attachment.ref });
-      toast.show(`Opened ${attachment.title}`, { variant: "success" });
+      toast.show(m.opened(attachment.title), { variant: "success" });
     } catch (error) {
-      await copyPath(attachment, `${errorText(error, "Could not open it")}. `);
+      await copyPath(attachment, `${errorText(error, m.openFailure)}. `);
     }
   }
   async function open(attachment: Attachment) {
@@ -55,7 +57,7 @@ export function useAttachmentOpener({ workspaceId, workspaceDirectory, navigatio
         if (navigation?.openBrowser) navigation.openBrowser({ url: attachment.url, workspaceId });
         else await openExternalUrl(attachment.url);
       } catch {
-        toast.error("Could not open this link.");
+        toast.error(m.linkFailure);
       }
       return;
     }
@@ -74,11 +76,12 @@ export const ATTACHMENT_ROW = { gap: 2, paddingVertical: 3, lineHeight: 17 };
 // Drawn in dialogs and the popover (surface1) unless `onSurface1` is false.
 // `onOpen` also gets the whole list, so a preview can step through its siblings.
 export function AttachmentList({ colors, attachments, onOpen, onSurface1 = true }: { colors: Colors; attachments: Attachment[]; onOpen(attachment: Attachment, group: Attachment[]): void; onSurface1?: boolean }) {
+  const { messages: m } = useProgressLanguage();
   if (!attachments.length) return null;
   return (
     <View style={{ gap: ATTACHMENT_ROW.gap }}>
       {attachments.map((attachment) => (
-        <PressableRow key={attachment.ref} colors={colors} onSurface1={onSurface1} accessibilityRole={attachment.url ? "link" : "button"} accessibilityLabel={`Open ${attachment.title}`}
+        <PressableRow key={attachment.ref} colors={colors} onSurface1={onSurface1} accessibilityRole={attachment.url ? "link" : "button"} accessibilityLabel={m.openItem(attachment.title)}
           onPress={() => onOpen(attachment, attachments)}
           style={{ flexDirection: "row", gap: 6, alignItems: "center", paddingVertical: ATTACHMENT_ROW.paddingVertical, paddingHorizontal: 4, marginHorizontal: -4, borderRadius: 4 }}>
           {/* A 14px slot, like a section icon, so the title lines up with the heading above. */}

package/client/deliverables.tsx

@@ -4,12 +4,13 @@ import React, { useState } from "react";
 import { Text, View } from "react-native";
 import type { Deliverable } from "../shared/dashboard";
 import { type Attachment, attachmentIcon, deliverableAttachment, shortName, useAttachmentOpener } from "./attachments";
-import { formatAgo } from "../shared/format";
+import { formatClientAgo } from "./i18n";
 import { PressScale } from "./motion";
 import { StackedDialog } from "./dialog-stack";
 import { galleryFiles } from "./preview";
 import { PressableRow } from "./row";
 import { ShowMoreRow, usePaged } from "./show-more";
+import { useProgressLanguage } from "./language";
 
 export { absolutePath } from "./attachments";
 
@@ -25,6 +26,7 @@ export function DeliverablesList({ colors, deliverables, now, workspaceId, works
   workspaceDirectory: string;
   navigation: Navigation;
 }) {
+  const { messages: m, locale } = useProgressLanguage();
   const [previewing, setPreviewing] = useState<Attachment | null>(null);
   const { open, copyPath } = useAttachmentOpener({ workspaceId, workspaceDirectory, navigation, onPreview: setPreviewing });
   const paged = usePaged(deliverables);
@@ -32,7 +34,7 @@ export function DeliverablesList({ colors, deliverables, now, workspaceId, works
     <View>
       {paged.shown.map((deliverable, index) => (
         <PressableRow key={deliverable.id} colors={colors} accessibilityRole={deliverable.url ? "link" : "button"}
-          accessibilityLabel={`Open ${deliverable.title}`}
+          accessibilityLabel={m.openItem(deliverable.title)}
           onPress={() => void open(deliverableAttachment(deliverable))}
           style={{ flexDirection: "row", gap: 8, paddingHorizontal: 10, paddingVertical: 8, borderTopWidth: index ? 1 : 0, borderTopColor: colors.border }}>
           {/* Optical: centers the 14px icon on the 18px title line. */}
@@ -42,12 +44,12 @@ export function DeliverablesList({ colors, deliverables, now, workspaceId, works
             <Text numberOfLines={3} style={{ color: colors.foreground, fontSize: 13, lineHeight: 18 }}>{deliverable.title}</Text>
             {/* Just the name, ticket and age. The full path is one press of Copy away. */}
             <Text numberOfLines={1} style={{ color: colors.foregroundMuted, fontSize: 12, lineHeight: 17 }}>
-              {[shortName(deliverableAttachment(deliverable)), deliverable.ticketLabel ?? deliverable.ticketId, formatAgo(deliverable.addedAt, now)].filter(Boolean).join(" · ")}
+              {[shortName(deliverableAttachment(deliverable)), deliverable.ticketLabel ?? deliverable.ticketId, formatClientAgo(locale, deliverable.addedAt, now)].filter(Boolean).join(" · ")}
             </Text>
           </View>
           {deliverable.path ? (
             // Optical: the 22px button centers on the 18px title line.
-            <PressScale accessibilityRole="button" accessibilityLabel={`Copy the path of ${deliverable.title}`} hitSlop={6} outerStyle={{ marginTop: -2 }}
+            <PressScale accessibilityRole="button" accessibilityLabel={m.copyItemPath(deliverable.title)} hitSlop={6} outerStyle={{ marginTop: -2 }}
               onPress={() => void copyPath(deliverableAttachment(deliverable))}
               // A step above the row's own hover tint (surface1), so it reads as its own target.
               style={({ pressed, hovered }) => ({ padding: 4, borderRadius: 4, backgroundColor: pressed ? colors.border : hovered ? colors.surface2 : "transparent" })}>

package/client/dialog-stack.tsx

@@ -7,6 +7,7 @@ import { NarrowProvider } from "./narrow";
 import { BackButton, galleryFiles, PreviewContent } from "./preview";
 import { QuestionView, useCopy } from "./questions";
 import { TicketStoryView } from "./ticket-dialog";
+import { ProgressLanguageProvider } from "./language";
 
 type Colors = PluginWorkspacePanelProps["theme"]["colors"];
 type AttachmentContext = { workspaceId: string; workspaceDirectory: string; navigation?: PluginWorkspacePanelProps["navigation"] };
@@ -76,6 +77,7 @@ export function StackedDialog({ colors, root, onClose, questions = [], dashboard
       open={Boolean(root)} onOpenChange={(next) => { if (!next) onClose(); }}>
       {/* One Modal.Content for every step: replacing it would re-present the sheet on phones. */}
       <Modal.Content scrollable={!(preview && previewLong)}>
+      <ProgressLanguageProvider>
       {/* A dialog has room for clock times, however narrow the panel that opened it. */}
       <NarrowProvider value={false}>
       {preview ? (
@@ -100,6 +102,7 @@ export function StackedDialog({ colors, root, onClose, questions = [], dashboard
         </>
       )}
       </NarrowProvider>
+      </ProgressLanguageProvider>
       </Modal.Content>
     </Modal>
   );

package/client/history.tsx

@@ -7,6 +7,7 @@ import { PressScale } from "./motion";
 import { PressableRow } from "./row";
 import { listFolders, setHistoryFolder } from "../shared/rpc";
 import { errorText } from "./errors";
+import { ProgressLanguageProvider, useProgressLanguage } from "./language";
 
 type Colors = PluginWorkspacePanelProps["theme"]["colors"];
 
@@ -18,6 +19,7 @@ export function HistoryRow({ colors, workspaceId, directory, savedTo }: {
   directory: string;
   savedTo: string | null;
 }) {
+  const { messages: m } = useProgressLanguage();
   const [picking, setPicking] = useState(false);
   const set = useRpc(setHistoryFolder);
   const queryClient = useQueryClient();
@@ -26,22 +28,22 @@ export function HistoryRow({ colors, workspaceId, directory, savedTo }: {
     mutationFn: (folder: string | null) => set({ workspaceId, workspaceDirectory: directory, folder }),
     onSuccess: ({ savedTo: next }) => {
       queryClient.invalidateQueries({ queryKey: ["progress", "dashboard"] });
-      toast.show(next ? `Each run will be saved to ${next}.` : "Runs will stay on this computer. Files already saved stay in the repo.", { variant: "success" });
+      toast.show(next ? m.historySaved(next) : m.historyStopped, { variant: "success" });
     },
-    onError: (error) => toast.error(errorText(error, "Could not change where runs are saved.")),
+    onError: (error) => toast.error(errorText(error, m.historyFailure)),
   });
   // While saving, the button that started it says so.
   const busy = mutation.isPending ? (mutation.variables === null ? "stop" : "pick") : null;
   const actions: { label: string; busyLabel: string; kind: "pick" | "stop"; onPress(): void }[] = savedTo
-    ? [{ label: "Change…", busyLabel: "Saving…", kind: "pick", onPress: () => setPicking(true) }, { label: "Stop saving", busyLabel: "Stopping…", kind: "stop", onPress: () => mutation.mutate(null) }]
-    : [{ label: "Save to repo…", busyLabel: "Saving…", kind: "pick", onPress: () => setPicking(true) }];
+    ? [{ label: m.changeFolder, busyLabel: m.saving, kind: "pick", onPress: () => setPicking(true) }, { label: m.stopSaving, busyLabel: m.stopping, kind: "stop", onPress: () => mutation.mutate(null) }]
+    : [{ label: m.saveToRepo, busyLabel: m.saving, kind: "pick", onPress: () => setPicking(true) }];
 
   return (
     <View style={{ flexDirection: "row", flexWrap: "wrap", alignItems: "center", columnGap: 8, rowGap: 4, marginHorizontal: 12, marginTop: 16 }}>
       <View style={{ flexDirection: "row", alignItems: "flex-start", gap: 6, flex: 1, minWidth: 180 }}>
         <View style={{ paddingTop: 2 }}><Icon name="History" size={13} color={colors.foregroundMuted} /></View>
         <Text style={{ flex: 1, color: colors.foregroundMuted, fontSize: 12, lineHeight: 17 }}>
-          {savedTo ? <>Each run is saved to <Text style={{ color: colors.foreground }}>{savedTo}</Text> in this repo.</> : "Run history stays on this computer."}
+          {savedTo ? <>{m.historyInRepo[0]}<Text style={{ color: colors.foreground }}>{savedTo}</Text>{m.historyInRepo[1]}</> : m.localHistory}
         </Text>
       </View>
       <View style={{ flexDirection: "row", gap: 4 }}>
@@ -71,6 +73,7 @@ function FolderPicker({ colors, workspaceId, directory, open, start, onClose, on
   onClose(): void;
   onPick(folder: string): void;
 }) {
+  const { messages: m } = useProgressLanguage();
   const parentOf = (path: string) => path.split("/").slice(0, -1).join("/");
   const [at, setAt] = useState(() => parentOf(start));
   const [naming, setNaming] = useState<string | null>(null);
@@ -86,15 +89,16 @@ function FolderPicker({ colors, workspaceId, directory, open, start, onClose, on
   const newName = naming?.trim().replace(/\/+$/, "") ?? "";
 
   return (
-    <Modal title="Save run history to a folder" icon={<Icon name="FolderOpen" size={16} color={colors.foregroundMuted} />} open={open} onOpenChange={(next) => { if (!next) close(); }}>
+    <Modal title={m.historyFolderTitle} icon={<Icon name="FolderOpen" size={16} color={colors.foregroundMuted} />} open={open} onOpenChange={(next) => { if (!next) close(); }}>
       {/* Paseo sizes a non-scrolling dialog to 85% of the window, so let it size to
           its content; the list's own height cap keeps the buttons in view. */}
       <Modal.Content>
+      <ProgressLanguageProvider>
         <Text style={{ color: colors.foregroundMuted, fontSize: 12, lineHeight: 17 }}>
-          Each run becomes its own file in this folder, in every worktree of this repo. Commit them like any other file.
+          {m.historyFolderHint}
         </Text>
         <View style={{ flexDirection: "row", flexWrap: "wrap", alignItems: "center", gap: 2, paddingHorizontal: 4 }}>
-          {["Top of the repo", ...crumbs].map((crumb, index) => (
+          {[m.repoTop, ...crumbs].map((crumb, index) => (
             <React.Fragment key={index}>
               {index ? <Icon name="ChevronRight" size={12} color={colors.foregroundMuted} /> : null}
               <PressScale accessibilityRole="button" disabled={index === crumbs.length} onPress={() => { setNaming(null); setAt(crumbs.slice(0, index).join("/")); }}
@@ -108,9 +112,9 @@ function FolderPicker({ colors, workspaceId, directory, open, start, onClose, on
 
         {/* Only the list scrolls, so Use and Cancel stay in view in a big repo. */}
         <ScrollView style={{ maxHeight: 320, flexGrow: 0 }} contentContainerStyle={{ gap: 2 }}>
-          {listed.isPending ? <ActivityIndicator color={colors.foregroundMuted} accessibilityLabel="Loading folders" style={{ alignSelf: "flex-start", padding: 8 }} /> : null}
+          {listed.isPending ? <ActivityIndicator color={colors.foregroundMuted} accessibilityLabel={m.loadingFolders} style={{ alignSelf: "flex-start", padding: 8 }} /> : null}
           {listed.data?.folders.map((name) => (
-            <PressableRow key={name} colors={colors} accessibilityRole="button" accessibilityLabel={`Open ${name}`} onPress={() => { setNaming(null); setAt(join(name)); }}
+            <PressableRow key={name} colors={colors} accessibilityRole="button" accessibilityLabel={m.openItem(name)} onPress={() => { setNaming(null); setAt(join(name)); }}
               style={{ flexDirection: "row", alignItems: "center", gap: 8, paddingHorizontal: 8, paddingVertical: 6, borderRadius: 6 }}>
               <Icon name="Folder" size={14} color={colors.foregroundMuted} />
               <Text numberOfLines={1} ellipsizeMode="middle" style={{ flex: 1, color: colors.foreground, fontSize: 12, lineHeight: 16 }}>{name}</Text>
@@ -118,40 +122,41 @@ function FolderPicker({ colors, workspaceId, directory, open, start, onClose, on
             </PressableRow>
           ))}
           {listed.data && !listed.data.folders.length ? (
-            <Text style={{ color: colors.foregroundMuted, fontSize: 12, lineHeight: 16, paddingHorizontal: 8, paddingVertical: 6 }}>No folders in here.</Text>
+            <Text style={{ color: colors.foregroundMuted, fontSize: 12, lineHeight: 16, paddingHorizontal: 8, paddingVertical: 6 }}>{m.noFolders}</Text>
           ) : null}
-          {listed.error ? <Text accessibilityRole="alert" style={{ color: colors.statusDanger, fontSize: 12, lineHeight: 17, paddingHorizontal: 8 }}>{errorText(listed.error, "Could not list the folders.")}</Text> : null}
+          {listed.error ? <Text accessibilityRole="alert" style={{ color: colors.statusDanger, fontSize: 12, lineHeight: 17, paddingHorizontal: 8 }}>{errorText(listed.error, m.listFoldersFailure)}</Text> : null}
         </ScrollView>
 
         {naming === null ? (
           <PressScale accessibilityRole="button" onPress={() => setNaming("")}
             style={({ pressed, hovered }) => ({ alignSelf: "flex-start", flexDirection: "row", alignItems: "center", gap: 6, paddingHorizontal: 8, paddingVertical: 5, borderRadius: 6, backgroundColor: pressed ? colors.border : hovered ? colors.surface2 : "transparent" })}>
             <Icon name="FolderPlus" size={14} color={colors.foreground} />
-            <Text style={{ color: colors.foreground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>New folder</Text>
+            <Text style={{ color: colors.foreground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>{m.newFolder}</Text>
           </PressScale>
         ) : (
           <View style={{ flexDirection: "row", alignItems: "center", gap: 6 }}>
             <TextInput autoFocus value={naming} onChangeText={setNaming} onSubmitEditing={() => { if (newName) onPick(join(newName)); }}
-              autoCapitalize="none" autoCorrect={false} spellCheck={false} accessibilityLabel="New folder name" placeholder="progress-history" placeholderTextColor={colors.foregroundMuted}
+              autoCapitalize="none" autoCorrect={false} spellCheck={false} accessibilityLabel={m.newFolderName} placeholder="progress-history" placeholderTextColor={colors.foregroundMuted}
               style={{ flex: 1, color: colors.foreground, fontSize: 12, lineHeight: 16, paddingHorizontal: 8, paddingVertical: 6, borderRadius: 6, borderWidth: 1, borderColor: colors.border, backgroundColor: colors.surface1 }} />
             <PressScale accessibilityRole="button" disabled={!newName} onPress={() => onPick(join(newName))}
               style={({ pressed, hovered }) => ({ paddingHorizontal: 10, paddingVertical: 6, borderRadius: 6, backgroundColor: colors.accent, opacity: !newName ? 0.5 : pressed ? 0.7 : hovered ? 0.85 : 1 })}>
-              <Text style={{ color: colors.accentForeground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>Use new folder</Text>
+              <Text style={{ color: colors.accentForeground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>{m.useNewFolder}</Text>
             </PressScale>
           </View>
         )}
 
         <View style={{ flexDirection: "row", flexWrap: "wrap", alignItems: "center", justifyContent: "flex-end", gap: 8 }}>
-          {at ? null : <Text style={{ flex: 1, minWidth: 140, color: colors.foregroundMuted, fontSize: 12, lineHeight: 17 }}>Open a folder to use it, or make a new one.</Text>}
+          {at ? null : <Text style={{ flex: 1, minWidth: 140, color: colors.foregroundMuted, fontSize: 12, lineHeight: 17 }}>{m.pickFolderHint}</Text>}
           <PressScale accessibilityRole="button" onPress={close}
             style={({ pressed, hovered }) => ({ paddingHorizontal: 12, paddingVertical: 6, borderRadius: 6, backgroundColor: pressed ? colors.border : hovered ? colors.surface2 : "transparent" })}>
-            <Text style={{ color: colors.foreground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>Cancel</Text>
+            <Text style={{ color: colors.foreground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>{m.cancel}</Text>
           </PressScale>
           <PressScale accessibilityRole="button" disabled={!at} onPress={() => onPick(at)} outerStyle={{ flexShrink: 1 }}
             style={({ pressed, hovered }) => ({ paddingHorizontal: 12, paddingVertical: 6, borderRadius: 6, backgroundColor: colors.accent, opacity: !at ? 0.5 : pressed ? 0.7 : hovered ? 0.85 : 1 })}>
-            <Text numberOfLines={1} ellipsizeMode="middle" style={{ color: colors.accentForeground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>{at ? `Use ${crumbs[crumbs.length - 1]}` : "Use folder"}</Text>
+            <Text numberOfLines={1} ellipsizeMode="middle" style={{ color: colors.accentForeground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>{at ? m.useNamedFolder(crumbs[crumbs.length - 1]) : m.useFolder}</Text>
           </PressScale>
         </View>
+      </ProgressLanguageProvider>
       </Modal.Content>
     </Modal>
   );

package/client/i18n.ts

@@ -0,0 +1,86 @@
+import type { Dashboard, HeadlinePart } from "../shared/dashboard";
+import type { LanguagePreference } from "../shared/settings";
+import type { TimelineLabel } from "../shared/ticket-story";
+import type { ProgressMessages } from "./messages";
+import { messages as en } from "./locales/en";
+import { messages as zhCN } from "./locales/zh-CN";
+
+export type { ProgressMessages } from "./messages";
+export type ProgressLocale = "en" | "zh-CN";
+
+export function systemLocale(): string {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().locale;
+  } catch {
+    return "en";
+  }
+}
+
+export function resolveLocale(preference: LanguagePreference, system = systemLocale()): ProgressLocale {
+  if (preference !== "system") return preference;
+  const [language, ...rest] = system.replaceAll("_", "-").toLowerCase().split("-");
+  // Extensions like "-u-nu-hanidec" say nothing about the script.
+  const singleton = rest.findIndex((part) => part.length === 1);
+  const subtags = singleton === -1 ? rest : rest.slice(0, singleton);
+  if (language !== "zh") return "en";
+  // A script tag beats the region: zh-Hans-HK is Simplified.
+  if (subtags.includes("hans")) return "zh-CN";
+  if (subtags.includes("hant")) return "en";
+  return subtags.length === 0 || subtags.some((part) => ["cn", "sg"].includes(part)) ? "zh-CN" : "en";
+}
+
+export function messagesFor(locale: ProgressLocale): ProgressMessages {
+  return locale === "zh-CN" ? zhCN : en;
+}
+
+export function formatClientMinutes(locale: ProgressLocale, totalMin: number): string {
+  const m = messagesFor(locale);
+  const whole = Math.max(0, Math.floor(totalMin));
+  if (whole < 1) return m.lessThanMinute;
+  const hours = Math.floor(whole / 60);
+  const minutes = whole % 60;
+  return !hours ? m.minutes(minutes) : minutes ? m.hoursMinutes(hours, minutes) : m.hours(hours);
+}
+
+export function formatClientWorkDone(locale: ProgressLocale, doneMin: number, totalMin: number, tookMin?: number): string {
+  if (tookMin !== undefined) return formatClientMinutes(locale, tookMin);
+  const m = messagesFor(locale);
+  return m.workDone(doneMin < 1 ? m.zeroMinutes : formatClientMinutes(locale, doneMin), formatClientMinutes(locale, totalMin));
+}
+
+export function formatClientClock(locale: ProgressLocale, iso: string): string {
+  return new Intl.DateTimeFormat(locale, { month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }).format(new Date(iso));
+}
+
+export function formatClientTimeOfDay(locale: ProgressLocale, iso: string, nowMs: number): string {
+  const date = new Date(iso);
+  const now = new Date(nowMs);
+  const sameDay = date.getFullYear() === now.getFullYear() && date.getMonth() === now.getMonth() && date.getDate() === now.getDate();
+  return sameDay ? new Intl.DateTimeFormat(locale, { hour: "numeric", minute: "2-digit" }).format(date) : formatClientClock(locale, iso);
+}
+
+export function formatClientAgo(locale: ProgressLocale, iso: string, nowMs: number): string {
+  const m = messagesFor(locale);
+  const minutes = (nowMs - Date.parse(iso)) / 60_000;
+  return minutes < 1 ? m.justNow : m.ago(formatClientMinutes(locale, minutes));
+}
+
+export function clientHeadline(locale: ProgressLocale, dashboard: Dashboard): HeadlinePart[] {
+  const m = messagesFor(locale);
+  const counted = dashboard.tickets.filter((ticket) => ticket.status !== "skipped");
+  const done = counted.filter((ticket) => ticket.status === "done").length;
+  const parts: HeadlinePart[] = [{ text: m.headlineDone(done, counted.length, dashboard.run?.itemLabel ?? "Ticket"), tone: "normal" }];
+  if (dashboard.questions.open.length) parts.push({ text: m.questionsWaiting(dashboard.questions.open.length), tone: "normal" });
+  if (dashboard.stuck.length) parts.push({ text: m.stuckCount(dashboard.stuck.length), tone: "danger" });
+  return parts;
+}
+
+export function timelineLabel(m: ProgressMessages, label: TimelineLabel): string {
+  switch (label.kind) {
+    case "added": return m.added;
+    case "reset": return m.resetStatus;
+    case "stage": return m.stageLabel(label.stage);
+    case "status": return m.status[label.status];
+    case "waiting": return m.waitingForTicket(label.id);
+  }
+}

package/client/language.tsx

@@ -0,0 +1,23 @@
+import { useSettings } from "@getpaseo/plugin/client";
+import React, { createContext, useContext } from "react";
+import { displaySettings } from "../shared/settings";
+import { messagesFor, resolveLocale } from "./i18n";
+
+function useLanguageSettings() {
+  const settings = useSettings(displaySettings);
+  const locale = resolveLocale(settings.status === "ready" ? settings.values.language : "system");
+  return { locale, messages: messagesFor(locale), settings };
+}
+
+const LanguageContext = createContext<ReturnType<typeof useLanguageSettings> | null>(null);
+
+export function ProgressLanguageProvider({ children }: { children: React.ReactNode }) {
+  const language = useLanguageSettings();
+  return <LanguageContext.Provider value={language}>{children}</LanguageContext.Provider>;
+}
+
+export function useProgressLanguage() {
+  const language = useContext(LanguageContext);
+  if (!language) throw new Error("ProgressLanguageProvider is missing");
+  return language;
+}

package/client/launcher.tsx

@@ -6,7 +6,9 @@ import { Text, View } from "react-native";
 import { PressScale, Presence } from "./motion";
 import { raised } from "./surfaces";
 import { getLauncherStatus, getSkillStatus, installLauncher, installSkill, type LauncherStatus, type SkillStatus } from "../shared/rpc";
+import { messagesFor, type ProgressMessages } from "./i18n";
 import { errorText } from "./errors";
+import { useProgressLanguage } from "./language";
 
 type Colors = PluginWorkspacePanelProps["theme"]["colors"];
 
@@ -19,30 +21,30 @@ export function skillQueryKey(hostId: string) {
 }
 
 // What the banner says, or null when agents can already run the command.
-export function launcherNotice(status: LauncherStatus): { text: string; action?: string } | null {
+export function launcherNotice(status: LauncherStatus, m: ProgressMessages = messagesFor("en")): { text: string; action?: string } | null {
   switch (status.state) {
     case "missing":
-      return { text: `Agents record progress with the paseo-progress command, which isn't installed yet. Installing adds it at ${status.path}`, action: "Install command" };
+      return { text: m.launcherMissing(status.path), action: m.installCommand };
     case "outdated":
-      return { text: `An older paseo-progress command is installed at ${status.path}.`, action: "Update command" };
+      return { text: m.launcherOutdated(status.path), action: m.updateCommand };
     case "foreign":
-      return { text: `Something else already exists at ${status.path}, so the plugin won't install there. The README shows how to install it elsewhere.` };
+      return { text: m.launcherForeign(status.path) };
     case "current":
-      return status.onPath ? null : { text: `paseo-progress is installed, but its folder isn't on the PATH Paseo uses, so agents need the full path: ${status.path}` };
+      return status.onPath ? null : { text: m.launcherOffPath(status.path) };
   }
 }
 
 // What the skill banner says, or null when every agent folder has the skill.
-export function skillNotice(status: SkillStatus): { text: string; action?: string } | null {
+export function skillNotice(status: SkillStatus, m: ProgressMessages = messagesFor("en")): { text: string; action?: string } | null {
   const folders = (state: string) => status.targets.filter((target) => target.state === state).map((target) => target.path.replace(/[\\/]paseo-progress$/, ""));
-  const skipped = folders("foreign").length ? ` Something else is already at ${folders("foreign").join(", ")}, so the plugin leaves it alone.` : "";
+  const skipped = folders("foreign").length ? m.skillSkipped(folders("foreign").join(m.listSeparator)) : "";
   switch (status.state) {
     case "missing":
-      return { text: `Agents learn when to record progress from the paseo-progress skill, which isn't installed yet. Installing adds a link in ${folders("missing").join(", ")}.${skipped}`, action: "Install skill" };
+      return { text: m.skillMissing(folders("missing").join(m.listSeparator), skipped), action: m.installSkill };
     case "outdated":
-      return { text: `The paseo-progress skill in ${folders("outdated").join(", ")} points to a copy of the plugin Paseo no longer runs.${skipped}`, action: "Update skill" };
+      return { text: m.skillOutdated(folders("outdated").join(m.listSeparator), skipped), action: m.updateSkill };
     case "foreign":
-      return { text: `Something else already exists at every paseo-progress skill path, so the plugin won't install the skill.` };
+      return { text: m.skillForeign };
     case "current":
       return null;
   }
@@ -50,6 +52,7 @@ export function skillNotice(status: SkillStatus): { text: string; action?: strin
 
 // Nothing is written until the user presses the button.
 export function LauncherBanner({ colors, host }: { colors: Colors; host: PluginWorkspacePanelProps["host"] }) {
+  const { messages: m } = useProgressLanguage();
   const fetchStatus = useRpc(getLauncherStatus);
   const install = useRpc(installLauncher);
   const queryClient = useQueryClient();
@@ -59,15 +62,16 @@ export function LauncherBanner({ colors, host }: { colors: Colors; host: PluginW
     mutationFn: () => install({}),
     onSuccess: (next) => {
       queryClient.setQueryData(launcherQueryKey(host.id), next);
-      toast.show(`Installed paseo-progress at ${next.path}`, { variant: "success" });
+      toast.show(m.launcherInstalled(next.path), { variant: "success" });
     },
-    onError: (error) => toast.error(errorText(error, "Could not install the command.")),
+    onError: (error) => toast.error(errorText(error, m.installCommandFailure)),
   });
-  const notice = status.data ? launcherNotice(status.data) : null;
+  const notice = status.data ? launcherNotice(status.data, m) : null;
   return <SetupBanner colors={colors} icon="Terminal" notice={notice} pending={mutation.isPending} onPress={() => mutation.mutate()} />;
 }
 
 export function SkillBanner({ colors, host }: { colors: Colors; host: PluginWorkspacePanelProps["host"] }) {
+  const { messages: m } = useProgressLanguage();
   const fetchStatus = useRpc(getSkillStatus);
   const install = useRpc(installSkill);
   const queryClient = useQueryClient();
@@ -77,11 +81,11 @@ export function SkillBanner({ colors, host }: { colors: Colors; host: PluginWork
     mutationFn: () => install({}),
     onSuccess: (next) => {
       queryClient.setQueryData(skillQueryKey(host.id), next);
-      toast.show("Installed the paseo-progress skill. New agent sessions will use it.", { variant: "success" });
+      toast.show(m.skillInstalled, { variant: "success" });
     },
-    onError: (error) => toast.error(errorText(error, "Could not install the skill.")),
+    onError: (error) => toast.error(errorText(error, m.installSkillFailure)),
   });
-  const notice = status.data ? skillNotice(status.data) : null;
+  const notice = status.data ? skillNotice(status.data, m) : null;
   return <SetupBanner colors={colors} icon="Sparkles" notice={notice} pending={mutation.isPending} onPress={() => mutation.mutate()} />;
 }
 
@@ -92,6 +96,7 @@ function SetupBanner({ colors, icon, notice, pending, onPress }: {
   pending: boolean;
   onPress(): void;
 }) {
+  const { messages: m } = useProgressLanguage();
   return (
     <Presence show={Boolean(notice)}>{notice ? (
     <View style={{ flexDirection: "row", alignItems: "center", flexWrap: "wrap", gap: 10, margin: 12, marginBottom: 0, padding: 8, borderRadius: 12, ...raised(colors), backgroundColor: colors.surface1 }}>
@@ -102,7 +107,7 @@ function SetupBanner({ colors, icon, notice, pending, onPress }: {
         <PressScale accessibilityRole="button" disabled={pending} onPress={onPress}
           style={({ pressed, hovered }) => ({ paddingHorizontal: 10, paddingVertical: 5, borderRadius: 4, backgroundColor: colors.accent, opacity: pressed || pending ? 0.7 : hovered ? 0.85 : 1 })}>
           <Text style={{ color: colors.accentForeground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>
-            {pending ? "Installing…" : notice.action}
+            {pending ? m.installing : notice.action}
           </Text>
         </PressScale>
       ) : null}