tuiboard 0.6.0 → 0.6.1

package/README.md

@@ -269,12 +269,13 @@ session (until the next terminal resize).
 | `Shift-Tab` | Cycle active zone (virtual → board → timeline → agents) |
 | `F1` / `F2` / `F3` | Toggle visibility of Virtual / Timeline / Agents zones |
 | `z` | Zoom active zone to full screen |
+| `r` | Refresh everything — reload boards from disk, rescan agents, force-refetch the agenda calendar (bypasses the 30-min cache) |
 
 ### Agenda (timeline zone)
 
 | Key | Action |
 |---|---|
-| `[` / `]` | Previous / next day — shows that day's tasks **and** calendar events |
+| `[` / `]` | Previous / next day — shows that day's tasks **and** calendar events (works from any zone) |
 | `\` | Jump back to today |
 | `c` | Arm mode: click a task, then click a slot to schedule (works from any zone) |
 | `j` / `k` | While armed: nudge the block ±15 min |
@@ -319,8 +320,8 @@ session (until the next terminal resize).
 ## Status
 
 - **v0.6** — adds the Agenda calendar overlay (Google + Microsoft 365,
-  read-only, BYO credentials) and day-navigation (`[` / `]` / `\`) so you can
-  page tasks and events across days.
+  read-only, BYO credentials), day-navigation (`[` / `]` / `\`) to page tasks
+  and events across days, and a manual full-refresh key (`r`).
 - **v0.5** — daily-driver ready. Kanban + virtual + timeline + agents
   all functional, multi-select, undo, atomic file roundtrip, mouse click,
   responsive layout. Tested on Windows with WezTerm; Linux/macOS should

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tuiboard",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Terminal dashboard for markdown task boards. Kanban + Today/Tomorrow + 24h timeline + Claude Code agent view, all in one TUI.",
   "type": "module",
   "license": "MIT",

package/src/input/handleKey.ts

@@ -174,6 +174,15 @@ export function handleKey(
     return;
   }
 
+  // Manual full refresh: re-read boards from disk, rescan agents, force-
+  // refetch the agenda calendar (bypassing its 30-min cache). For pulling in
+  // external changes — e.g. a calendar event edited in the browser — without
+  // restarting. Shift+R is ignored here so it stays free for future use.
+  if (key.name === "r" && !key.ctrl && !key.shift) {
+    store.refreshAll();
+    return;
+  }
+
   // Zoom toggle: focus the active panel (board column or virtual panel)
   // at full width.
   if (key.name === "z") {
@@ -181,6 +190,35 @@ export function handleKey(
     return;
   }
 
+  // Agenda day navigation works from ANY zone — these keys only ever affect
+  // the Agenda, so there's no need to be focused there first. `[` previous
+  // day, `]` next day, `\` back to today. Pressing one also moves focus to
+  // the Agenda so you can keep paging/navigating. Guarded on the zone being
+  // visible — never steal focus to a hidden zone (F2 can hide it).
+  if (
+    ui.visibleZones.timeline &&
+    (key.name === "[" ||
+      key.sequence === "[" ||
+      key.name === "]" ||
+      key.sequence === "]" ||
+      key.name === "\\" ||
+      key.sequence === "\\")
+  ) {
+    store.setActiveZone("timeline");
+    if (key.name === "\\" || key.sequence === "\\") {
+      store.resetAgendaDay();
+      store.flashBanner("info", "Agenda → Today");
+    } else {
+      const delta = key.name === "]" || key.sequence === "]" ? 1 : -1;
+      store.shiftAgendaDay(delta);
+      store.flashBanner(
+        "info",
+        `${delta > 0 ? "▶" : "◀"} ${formatAgendaDay(store.state.ui.agendaOffset, store.agendaDate())}`,
+      );
+    }
+    return;
+  }
+
   // Defer modal opens by one macrotask so the OpenTUI <input> mounts after
   // the current key event has been fully dispatched.
   const openLater = (m: ModalKind) => {
@@ -247,26 +285,8 @@ function handleTimelineZone(
   openLater: (m: ModalKind) => void,
 ): void {
   const ui = store.state.ui;
-
-  // Day navigation: page the Agenda to other days (tasks + calendar events).
-  // `[` previous, `]` next, `\` back to today. Handled first so they work
-  // regardless of arm/cursor state.
-  if (key.name === "[" || key.sequence === "[") {
-    store.shiftAgendaDay(-1);
-    store.flashBanner("info", `◀ ${formatAgendaDay(store.state.ui.agendaOffset, store.agendaDate())}`);
-    return;
-  }
-  if (key.name === "]" || key.sequence === "]") {
-    store.shiftAgendaDay(1);
-    store.flashBanner("info", `▶ ${formatAgendaDay(store.state.ui.agendaOffset, store.agendaDate())}`);
-    return;
-  }
-  if (key.name === "\\" || key.sequence === "\\") {
-    store.resetAgendaDay();
-    store.flashBanner("info", "Agenda → Today");
-    return;
-  }
-
+  // Note: Agenda day-nav (`[` / `]` / `\`) is handled globally in handleKey
+  // before zone dispatch, so it works from any zone — not repeated here.
   const entries = buildTimelineEntries(
     store.state.boards.map((b) => b.board),
     store.agendaDate(),

package/src/store/calendar.ts

@@ -143,9 +143,15 @@ async function googleAccessToken(tokenPath: string): Promise<string | null> {
   }
 }
 
-async function fetchGoogle(cfg: GoogleCalendarConfig, dateIso: string): Promise<CalEvent[]> {
-  const cached = loadCache("google", dateIso);
-  if (cached) return cached;
+async function fetchGoogle(
+  cfg: GoogleCalendarConfig,
+  dateIso: string,
+  force = false,
+): Promise<CalEvent[]> {
+  if (!force) {
+    const cached = loadCache("google", dateIso);
+    if (cached) return cached;
+  }
 
   const access = await googleAccessToken(cfg.token);
   if (!access) return [];
@@ -304,9 +310,15 @@ function ensureUtc(s: string): string {
   return `${s}Z`;
 }
 
-async function fetchMicrosoft(cfg: MicrosoftCalendarConfig, dateIso: string): Promise<CalEvent[]> {
-  const cached = loadCache("microsoft", dateIso);
-  if (cached) return cached;
+async function fetchMicrosoft(
+  cfg: MicrosoftCalendarConfig,
+  dateIso: string,
+  force = false,
+): Promise<CalEvent[]> {
+  if (!force) {
+    const cached = loadCache("microsoft", dateIso);
+    if (cached) return cached;
+  }
 
   const access = await microsoftAccessToken(cfg);
   if (!access) return [];
@@ -367,15 +379,16 @@ async function fetchMicrosoft(cfg: MicrosoftCalendarConfig, dateIso: string): Pr
 export async function fetchCalendarEvents(
   calendars: CalendarsConfig | undefined,
   dateIso: string,
+  force = false,
 ): Promise<CalEvent[]> {
   if (!calendars) return [];
   const out: CalEvent[] = [];
   const tasks: Array<Promise<CalEvent[]>> = [];
   if (calendars.google?.enabled && calendars.google.token) {
-    tasks.push(fetchGoogle(calendars.google, dateIso));
+    tasks.push(fetchGoogle(calendars.google, dateIso, force));
   }
   if (calendars.microsoft?.enabled && calendars.microsoft.config && calendars.microsoft.tokenCache) {
-    tasks.push(fetchMicrosoft(calendars.microsoft, dateIso));
+    tasks.push(fetchMicrosoft(calendars.microsoft, dateIso, force));
   }
   for (const arr of await Promise.all(tasks)) out.push(...arr);
   out.sort((a, b) => a.startMin - b.startMin);
@@ -389,8 +402,12 @@ export interface CalendarStore {
   events: () => CalEvent[];
   /** Switch which date's events `events()` exposes; fetches it (cache-first). */
   setActiveDate: (dateIso: string) => void;
-  /** Re-fetch the active date now (the 5-min interval calls this too). */
-  refresh: () => void;
+  /**
+   * Re-fetch the active date now (the 5-min interval calls this too). Pass
+   * `force` to bypass the 30-min disk cache — used by the manual `r` refresh
+   * so freshly-edited events show without waiting for the cache to expire.
+   */
+  refresh: (force?: boolean) => void;
   dispose: () => Promise<void>;
 }
 
@@ -409,10 +426,10 @@ export function createCalendarStore(
   let activeDate = initialDate();
   let timer: ReturnType<typeof setInterval> | undefined;
 
-  function refresh(): void {
+  function refresh(force = false): void {
     if (!calendars) return;
     const target = activeDate;
-    void fetchCalendarEvents(calendars, target)
+    void fetchCalendarEvents(calendars, target, force)
       .then((evs) => {
         // Guard against out-of-order resolves when the user pages quickly:
         // only apply if this is still the date the user is looking at.

package/src/store/index.ts

@@ -819,6 +819,22 @@ export function createTuiStore({ config }: CreateStoreOptions) {
     setState("ui", "armedTimelineRef", undefined);
   }
 
+  /**
+   * Manual full refresh (the `r` key). Re-reads every board from disk, rescans
+   * Claude Code agents, and force-refetches the Agenda's calendar (bypassing
+   * the 30-min cache). Lets the user pull in external changes — a calendar
+   * event edited in the browser, a board touched elsewhere — without leaving
+   * tuiboard. Boards normally auto-reload via the file watcher; this also
+   * covers the agenda, whose feed is poll-based, not event-driven.
+   */
+  function refreshAll(): void {
+    setState("boards", loadAll(config));
+    setState("rev", (r) => r + 1);
+    agentsStore.refresh();
+    calendarStore.refresh(true);
+    flashBanner("info", "Refreshed boards · agents · agenda");
+  }
+
   // ─── Multi-select ────────────────────────────────────────────────────────
 
   function markKey(ref: TaskRef): string {
@@ -1027,6 +1043,7 @@ export function createTuiStore({ config }: CreateStoreOptions) {
     agendaDate,
     shiftAgendaDay,
     resetAgendaDay,
+    refreshAll,
     setFilter,
     applyBoardFilter,
     setZoomed,

package/src/ui/AgentRow.tsx

@@ -70,11 +70,13 @@ export function AgentRow(props: AgentRowProps) {
           <span style={{ fg: T.textDim }}>{"  "}{props.session.gitBranch}</span>
         </Show>
       </text>
-      {/* cwd + age pinned together on the right, so the session titles align
-          cleanly on the left instead of being pushed around by the path. */}
+      {/* cwd + age pinned together on the right. The age is right-aligned in a
+          fixed-width field (pad to 3: "59m" / "23h" / "10d") so the END of each
+          cwd lands on the same column across rows — a 1- vs 2-digit age no
+          longer shoves the directory names out of vertical alignment. */}
       <text style={{ flexShrink: 0 }} wrapMode="none">
         <span style={{ fg: T.textDim }}>
-          {props.session.cwdShort}{"   "}{ageStr()}
+          {props.session.cwdShort}{"  "}{ageStr().padStart(3)}
         </span>
       </text>
     </box>

package/src/ui/Chrome.tsx

@@ -115,7 +115,7 @@ export function BottomBar(props: { store: TuiStore }) {
         */}
         <text wrapMode="none" truncate>
           <span style={{ fg: T.textDim }}>
-            {"hjkl move · Tab board · ⇧Tab zone · ⏎ done · n new · t today · b block · c schedule · z zoom · ? help · q quit"}
+            {"hjkl ↑↓←→ move · Tab board · ⇧Tab zone · ⏎ done · n new · t today · b block · c schedule · r refresh · z zoom · ? help · q quit"}
           </span>
         </text>
       </box>

package/src/ui/Modal.tsx

@@ -592,6 +592,7 @@ function HelpModal(props: { store: TuiStore }) {
         <span style={{ fg: T.text }}>{"  Shift-Tab         Cycle active zone (virtual → board → timeline → agents)\n"}</span>
         <span style={{ fg: T.text }}>{"  F1 / F2 / F3      Toggle visibility of Virtual / Timeline / Agents zones\n"}</span>
         <span style={{ fg: T.text }}>{"  z                 Zoom active zone (or column) to full screen\n"}</span>
+        <span style={{ fg: T.text }}>{"  r                 Refresh everything (boards from disk, agents, agenda calendar)\n"}</span>
         <span style={{ fg: T.textDim }}>{"\nTask actions (work in board, virtual, AND timeline zones)\n"}</span>
         <span style={{ fg: T.text }}>{"  Enter             Toggle done\n"}</span>
         <span style={{ fg: T.text }}>{"  o                 Open detail view\n"}</span>
@@ -606,7 +607,7 @@ function HelpModal(props: { store: TuiStore }) {
         <span style={{ fg: T.text }}>{"  d                 Delete task (with confirm)\n"}</span>
         <span style={{ fg: T.text }}>{"  X                 Archive task → moves to Archive column\n"}</span>
         <span style={{ fg: T.text }}>{"  C                 Copy task to clipboard (markdown line)\n"}</span>
-        <span style={{ fg: T.textDim }}>{"\nAgenda (timeline) day navigation\n"}</span>
+        <span style={{ fg: T.textDim }}>{"\nAgenda (timeline) day navigation — works from any zone\n"}</span>
         <span style={{ fg: T.text }}>{"  [ / ]              Previous / next day (tasks + calendar events)\n"}</span>
         <span style={{ fg: T.text }}>{"  \\                  Jump back to today\n"}</span>
         <span style={{ fg: T.textDim }}>{"\nAgenda (timeline) scheduling\n"}</span>

package/src/ui/TimelineView.tsx

@@ -335,10 +335,14 @@ export function TimelineView(props: TimelineViewProps) {
           </span>
         </text>
       </Show>
-      <Show when={!isToday()}>
+      {/* Day-navigation hint — always visible in the resting state (not while
+          arming) so the [ ] day-switch is discoverable. Off-today, the
+          "\ today" reset is highlighted to pull the eye back. */}
+      <Show when={!armMode() && !armedTask()}>
         <text wrapMode="none">
           <span style={{ fg: T.warm }}>{"◷ "}</span>
-          <span style={{ fg: T.textDim }}>{"[ prev · ] next · \\ today"}</span>
+          <span style={{ fg: T.textDim }}>{"[ ] change day · "}</span>
+          <span style={{ fg: isToday() ? T.textDim : T.warm }}>{"\\ today"}</span>
         </text>
       </Show>
       <Show when={!armedTask() && rowMap().overflow > 0}>