tuiboard 0.6.2 → 0.7.1

package/.tuiboard/config.example.yaml

@@ -31,6 +31,20 @@ done_column: Done
 # doesn't exist in a board, tuiboard creates it on the fly.
 archive_column: Archive
 
+# Optional: pick which zones you want. The board is always on; the other three
+# are yours to turn off. Each takes one of:
+#   on      enabled and shown at launch (the default)
+#   off     disabled entirely — never rendered, skipped by Shift-Tab, its F-key
+#           is inert, and its background work never runs (no calendar fetch, no
+#           ~/.claude reads). Use this for a pure kanban, or kanban + one panel.
+#   hidden  enabled but collapsed at launch — reveal it any time with its F-key
+# Want just a kanban? Set agenda and agents to off. (true/false also work.)
+#
+# zones:
+#   planner: on      # Today/Tomorrow cross-board panel        (F1)
+#   agenda: on       # 24h agenda + calendar overlay           (F2)
+#   agents: on       # live Claude Code session view           (F3)
+
 # Optional: override what Enter does in the Agents zone ("open the selected
 # Claude Code session"). An argv array — the tokens {cwd} and {sessionId} are
 # substituted, then it's run directly (no shell). Point it at your own script

package/CHANGELOG.md

@@ -0,0 +1,98 @@
+# Changelog
+
+All notable changes to **tuiboard** are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.7.1] - 2026-06-02
+
+### Changed
+- Modals (new task, schedule, time block, assign, delete, detail, search, help)
+  now open in the Agenda's slot — an opaque panel of the same width — instead of
+  a side panel that pushed the dashboard left. Opening a modal no longer reflows
+  the board/planner; the Agenda returns when the modal closes.
+- Modal titles now ride in the panel's top border (`┤ … ├`), matching the board
+  columns and the zones, instead of sitting as a body text line.
+- A clipped board column keeps its task rows until it's scrolled down to less
+  than half visible (previously: blanked as soon as it was clipped at all), so a
+  column that's mostly on-screen stays useful.
+
+## [0.7.0] - 2026-06-01
+
+### Added
+- **Configurable zones.** A `zones:` config block turns the planner, agenda, or
+  agents view off (`off`), starts it collapsed (`hidden`), or leaves it on
+  (`on`, the default; `true`/`false` alias `on`/`off`). The board is always on.
+  tuiboard can now be a pure kanban, kanban + calendar, kanban + agents, or any
+  mix. A disabled zone is never rendered, is skipped by `Shift-Tab`, has an
+  inert F-key, and **its background work never starts** — no calendar fetch and
+  no `~/.claude` reads when the agents zone is off.
+- Documented zones in the README, the AI setup prompt, and `config.example.yaml`.
+
+### Changed
+- Renamed the internal "virtual" zone to **"planner"** throughout (code,
+  identifiers, comments, and the `VirtualPanel`/`virtual-panel` files) for
+  clarity. The visible "Today/Tomorrow" panel is unchanged.
+- Reworked the responsive layout to combine three inputs — `enabled ∧ desired ∧
+  fits-width`. Auto-hide now only reports what fits; it never force-shows a
+  disabled or intentionally-hidden zone, and `F1`/`F2`/`F3` toggles persist
+  across terminal resizes.
+
+## [0.6.2] - 2026-05-30
+
+### Changed
+- Updated the hero screenshot to show the live calendar overlay (Google +
+  Microsoft 365 events side by side) and the aligned agent rows.
+- Refreshed the README intro to mention the calendar overlay.
+
+## [0.6.1] - 2026-05-30
+
+### Added
+- **Manual full-refresh key (`r`).** Reloads boards from disk, rescans agents,
+  and force-refetches the agenda calendar (bypassing the 30-minute cache) so
+  externally-edited events show without a restart.
+
+### Changed
+- Day-navigation keys (`[` / `]` / `\`) now work from any zone, not just when
+  the agenda is focused; pressing one also moves focus to the agenda.
+- Added arrow keys and `r refresh` to the bottom cheat-sheet; the day-navigation
+  hint is now always visible in the agenda's resting state.
+- Agent rows right-align the activity age in a fixed-width field so the end of
+  each working directory lines up across rows.
+
+## [0.6.0] - 2026-05-30
+
+First public release on npm. This entry captures the full feature set at launch.
+
+### Added
+- **Kanban board** over plain CommonMark files using the Obsidian Tasks-plugin
+  emoji vocabulary — no lock-in, the files stay yours. Multiple boards as tabs;
+  `##` headings become columns; `Done` and `Archive` columns are treated
+  specially. Quick-add syntax (`@assignee`, `#tag`, scheduling, time blocks,
+  priority), multi-select (`Space`), undo (`Ctrl-Z`), filters, search (`/`),
+  zoom (`z`), and atomic file round-trips with an external-edit watcher.
+- **Planner** — a Today/Tomorrow panel aggregating everything scheduled across
+  all boards.
+- **Agenda** — a 24-hour timeline with click-to-arm time-blocking, plus a
+  read-only **calendar overlay** for Google Calendar and Microsoft 365
+  (dependency-light, bring-your-own-credentials, all-day events skipped, each
+  calendar in its own color). Day-navigation with `[` / `]` / `\` pages tasks
+  and events across days.
+- **`tuiboard calendar-setup`** — one-time OAuth for new users (Google browser
+  flow, Microsoft device-code flow); prints the exact `calendars:` block to add.
+- **Live agents view** — reads local Claude Code sessions from `~/.claude` with
+  zero setup, showing status, branch, and last activity. `Enter` opens a session
+  in a terminal; the launch command is overridable via `resume_command`.
+- **Keyboard-first with full mouse support**, a responsive multi-zone layout
+  that adapts to terminal width, standalone `--view=` modes, and the `tb` alias.
+- Config resolution via `$TUIBOARD_CONFIG`, a project-local `.tuiboard/`, the
+  global `~/.config/tuiboard/`, or a cwd fallback scan.
+
+Built with [OpenTUI](https://opentui.com) + SolidJS on Bun.
+
+[0.7.1]: https://github.com/NazzarenoGiannelli/tuiboard/releases/tag/v0.7.1
+[0.7.0]: https://github.com/NazzarenoGiannelli/tuiboard/releases/tag/v0.7.0
+[0.6.2]: https://github.com/NazzarenoGiannelli/tuiboard/releases/tag/v0.6.2
+[0.6.1]: https://github.com/NazzarenoGiannelli/tuiboard/releases/tag/v0.6.1
+[0.6.0]: https://github.com/NazzarenoGiannelli/tuiboard/releases/tag/v0.6.0

package/README.md

@@ -1,6 +1,6 @@
 # tuiboard
 
-A terminal dashboard that unifies **kanban**, a **Today/Tomorrow virtual
+A terminal dashboard that unifies **kanban**, a **Today/Tomorrow planner
 panel**, a **24-hour agenda** (with a read-only Google / Microsoft 365
 calendar overlay), and a **live agent view** for Claude Code sessions — all
 on top of plain markdown task files.
@@ -98,12 +98,17 @@ https://github.com/NazzarenoGiannelli/tuiboard). Set it up for me from scratch:
 3. Create a global config at `~/.config/tuiboard/config.yaml` (resolve the real
    home path) with a `boards:` list pointing at those files by ABSOLUTE path,
    plus `assignees: [...]`, `done_column: Done`, `archive_column: Archive`.
-4. Do NOT configure the Agent view — tuiboard reads `~/.claude` automatically.
+4. Ask me which zones I want besides the kanban board: the Today/Tomorrow
+   planner, the 24h agenda, and the live Claude Code agents view. For any I
+   don't want, add a `zones:` block setting it to `off` (e.g. someone who
+   doesn't use Claude Code would set `agents: off`). If I want them all, omit
+   the block. Do NOT configure the agents view beyond on/off — it reads
+   `~/.claude` automatically when enabled.
 5. Ask me whether I want to overlay my Google Calendar or Microsoft 365 events
-   on the Agenda. If yes, tell me to run `tuiboard calendar-setup google` (or
-   `microsoft`) — it interviews me, opens the browser, and prints the exact
-   `calendars:` YAML block to add. Don't try to do the OAuth yourself. If no,
-   skip it (it's optional and can be added later).
+   on the Agenda (skip this if I turned the agenda off). If yes, tell me to run
+   `tuiboard calendar-setup google` (or `microsoft`) — it interviews me, opens
+   the browser, and prints the exact `calendars:` YAML block to add. Don't try
+   to do the OAuth yourself. If no, skip it (it's optional and can be added later).
 6. Show me the final config, then tell me to run `tuiboard`, and how to add a
    board later (create a new `.md` and append it to the `boards:` list).
 
@@ -143,6 +148,34 @@ archive_column: Archive
 # resume_command: ["nu", "C:/Users/you/.config/tuiboard/code-resume.nu", "{cwd}", "{sessionId}"]
 ```
 
+## Zones
+
+tuiboard is four zones — **board** (kanban), **planner** (Today/Tomorrow across
+all boards), **agenda** (24h timeline + calendar overlay), and **agents** (live
+Claude Code sessions). Only want some of them? The board is always on; the other
+three are yours to configure:
+
+```yaml
+zones:
+  planner: on      # Today/Tomorrow panel          (toggle at runtime with F1)
+  agenda: on       # 24h agenda + calendars        (F2)
+  agents: off      # live Claude Code view         (F3)
+```
+
+Each zone takes one of:
+
+| Value | Behavior |
+|---|---|
+| `on` | Enabled and shown at launch (the default). |
+| `off` | **Disabled entirely** — never rendered, skipped by `Shift-Tab`, its F-key is inert, and its background work never starts (no calendar fetch, no `~/.claude` reads). |
+| `hidden` | Enabled but **collapsed at launch** — reveal it any time with its F-key. |
+
+`true`/`false` work as aliases for `on`/`off`. So a pure kanban is just
+`agenda: off` and `agents: off`; kanban + calendar is `agents: off`. The
+difference between `off` and the F-key hide: `off` means the feature never runs
+at all — handy if you don't use Claude Code and don't want tuiboard reading
+`~/.claude`.
+
 ## Calendars (Agenda overlay)
 
 The **Agenda** zone (the 24h timeline) can overlay read-only events from Google
@@ -241,7 +274,7 @@ Launch `tuiboard` with no flag for the default 4-zone dashboard.
 | Flag | View | Use case |
 |---|---|---|
 | (none) | **Dashboard** — all 4 zones | Default; everything in one terminal |
-| `--view=board` | Kanban + virtual panel only | Focus mode, or a single WezTerm pane |
+| `--view=board` | Kanban + planner panel only | Focus mode, or a single WezTerm pane |
 | `--view=timeline` | Timeline fullscreen | Wall-mounted "what's now" |
 | `--view=agents` | Agent view fullscreen | Cross-machine session monitor |
 
@@ -249,9 +282,9 @@ The dashboard auto-collapses optional zones on narrow terminals:
 
 | Terminal width | Default zones visible |
 |---|---|
-| ≥ 150 cols | virtual + board + timeline + agents |
-| 120–149 | virtual + board + agents |
-| 100–119 | virtual + board |
+| ≥ 150 cols | planner + board + timeline + agents |
+| 120–149 | planner + board + agents |
+| 100–119 | planner + board |
 | < 100 | board only |
 
 `F1` / `F2` / `F3` toggles override the auto-collapse for the current
@@ -266,9 +299,9 @@ session (until the next terminal resize).
 | `h j k l` / arrows | Move cursor inside the active zone |
 | `Tab` | Cycle to next board |
 | `1`..`9` | Jump to board N |
-| `v` | Toggle Today/Tomorrow virtual panel focus |
-| `Shift-Tab` | Cycle active zone (virtual → board → timeline → agents) |
-| `F1` / `F2` / `F3` | Toggle visibility of Virtual / Timeline / Agents zones |
+| `v` | Toggle Today/Tomorrow planner panel focus |
+| `Shift-Tab` | Cycle active zone (planner → board → timeline → agents) |
+| `F1` / `F2` / `F3` | Toggle visibility of Planner / 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) |
 
@@ -282,7 +315,7 @@ session (until the next terminal resize).
 | `j` / `k` | While armed: nudge the block ±15 min |
 | `+` / `-` | While armed: resize the block's end ±15 min |
 
-### Task actions (work in board, virtual, AND timeline zones)
+### Task actions (work in board, planner, AND timeline zones)
 
 | Key | Action |
 |---|---|
@@ -320,10 +353,15 @@ session (until the next terminal resize).
 
 ## Status
 
+See [CHANGELOG.md](CHANGELOG.md) for the full release history.
+
+- **v0.7** — configurable zones: turn the planner, agenda, or agents view off
+  (or start it collapsed) via the `zones:` config, so tuiboard can be a pure
+  kanban, kanban + calendar, or any mix.
 - **v0.6** — adds the Agenda calendar overlay (Google + Microsoft 365,
   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
+- **v0.5** — daily-driver ready. Kanban + planner + timeline + agents
   all functional, multi-select, undo, atomic file roundtrip, mouse click,
   responsive layout. Tested on Windows with WezTerm; Linux/macOS should
   work via the same OpenTUI binaries (untested).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tuiboard",
-  "version": "0.6.2",
+  "version": "0.7.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",
@@ -36,6 +36,7 @@
     "bin/",
     ".tuiboard/config.example.yaml",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "scripts": {

package/src/app.tsx

@@ -4,7 +4,7 @@
  * Loads config, builds the reactive store, parses argv, and dispatches
  * to one of four root views:
  *   - undefined → Dashboard (all 4 zones)
- *   - "board"   → BoardOnly  (kanban + virtual fullscreen)
+ *   - "board"   → BoardOnly  (kanban + planner fullscreen)
  *   - "timeline"→ TimelineOnly
  *   - "agents"  → AgentsOnly
  *
@@ -22,7 +22,7 @@ import {
   createTuiStore,
   type TuiStore,
 } from "~/store/index";
-import { buildVirtualItems } from "~/store/virtual-panel";
+import { buildPlannerItems } from "~/store/planner-panel";
 import { T } from "~/ui/glyphs";
 import { TopBar, BottomBar } from "~/ui/Chrome";
 import { ModalLayer } from "~/ui/Modal";
@@ -62,16 +62,21 @@ process.on("SIGTERM", () => {
 //   ≥ 150 col → all four zones
 //   120–149   → hide timeline
 //   100–119   → hide agents too
-//   < 100     → hide virtual too (board is non-hideable)
+//   < 100     → hide planner too (board is non-hideable)
 //
-// User F1/F2/F3 toggles still work — they last until the next resize, at
-// which point auto re-evaluates. Acceptable trade-off: resize events are
-// rare, predictable layout > sticky overrides.
+// This only reports what FITS. The store combines it with each zone's enabled
+// flag and the user's desired visibility, so F1/F2/F3 toggles persist across
+// resizes and a disabled/hidden zone is never force-shown.
 function applyResponsiveLayout(): void {
   const width = process.stdout.columns ?? 200;
-  store.setZoneVisible("timeline", width >= 150);
-  store.setZoneVisible("agents", width >= 120);
-  store.setZoneVisible("virtual", width >= 100);
+  // Report which zones FIT at this width. The store ANDs this with each zone's
+  // enabled flag and the user's desired visibility, so a disabled or
+  // intentionally-hidden zone is never force-shown just because there's room.
+  store.applyResponsiveFits({
+    planner: width >= 100,
+    timeline: width >= 150,
+    agents: width >= 120,
+  });
 }
 applyResponsiveLayout();
 process.stdout.on("resize", applyResponsiveLayout);
@@ -79,8 +84,8 @@ process.stdout.on("resize", applyResponsiveLayout);
 // Land on the Today/Tomorrow panel by default — for a daily-planning tool the
 // first question is "what's on my plate today", and that panel answers it. On
 // a narrow terminal where the panel auto-hides, fall back to the board.
-if (store.state.ui.visibleZones.virtual) {
-  store.setActiveZone("virtual");
+if (store.state.ui.visibleZones.planner) {
+  store.setActiveZone("planner");
 }
 
 const { view } = parseArgs(process.argv.slice(2));
@@ -97,11 +102,11 @@ function rootViewFor(v: ViewKind | undefined, s: TuiStore) {
 }
 
 function App() {
-  const virtualItems = createMemo(() =>
-    buildVirtualItems(store.state.boards.map((b) => b.board)),
+  const plannerItems = createMemo(() =>
+    buildPlannerItems(store.state.boards.map((b) => b.board)),
   );
 
-  useKeyboard((key) => handleKey(store, key, virtualItems().length));
+  useKeyboard((key) => handleKey(store, key, plannerItems().length));
 
   return (
     <box
@@ -116,11 +121,11 @@ function App() {
       <TopBar store={store} />
       <box style={{ height: 1 }} />
       {/*
-        rootView and ModalLayer are siblings inside a flex-row so the
-        modal can sit beside the view as a fixed-width, full-height
-        side panel. ModalLayer renders only when ui.modal is set,
-        otherwise its <Show> resolves to nothing and the rootView gets
-        the whole row.
+        rootView + ModalLayer are flex-row siblings. The modal panel is exactly
+        the Agenda's width, and the Dashboard hides the Agenda while a modal is
+        open — so the modal drops into the Agenda's slot with zero reflow of the
+        left side (board / planner / agents). When no modal is open ModalLayer
+        renders nothing and rootView gets the whole row.
       */}
       <box style={{ flexDirection: "row", flexGrow: 1 }}>
         <box style={{ flexDirection: "column", flexGrow: 1 }}>

package/src/config/loader.ts

@@ -49,6 +49,30 @@ export interface Config {
    * Tokens are produced by `tuiboard calendar-setup`.
    */
   calendars?: CalendarsConfig;
+  /**
+   * Which optional zones are enabled and how they start. The board zone is
+   * always on (load-bearing) and not configurable here.
+   */
+  zones: ZonesConfig;
+}
+
+/**
+ * Per-zone startup mode:
+ *   - "on"     → enabled and visible at launch (default)
+ *   - "off"    → disabled entirely: never rendered, skipped by Shift-Tab, its
+ *                F-key is inert, and its background work (calendar fetch /
+ *                `~/.claude` watcher) never starts
+ *   - "hidden" → enabled but collapsed at launch; reveal it with its F-key
+ */
+export type ZoneMode = "on" | "off" | "hidden";
+
+export interface ZonesConfig {
+  /** Today/Tomorrow cross-board panel. */
+  planner: ZoneMode;
+  /** 24h agenda + calendar overlay (internally the "timeline" zone). */
+  agenda: ZoneMode;
+  /** Live Claude Code session view. */
+  agents: ZoneMode;
 }
 
 export interface GoogleCalendarConfig {
@@ -79,6 +103,7 @@ export const DEFAULT_CONFIG: Omit<Config, "root" | "loaded" | "boards"> = {
   assignees: [],
   doneColumn: "Done",
   archiveColumn: "Archive",
+  zones: { planner: "on", agenda: "on", agents: "on" },
 };
 
 /**
@@ -135,6 +160,13 @@ interface RawConfig {
       color?: string;
     };
   };
+  // Values may be boolean (js-yaml parses on/off/yes/no → boolean) or the
+  // string "hidden"/"collapsed". Anything else falls back to "on".
+  zones: {
+    planner?: boolean | string;
+    agenda?: boolean | string;
+    agents?: boolean | string;
+  };
 }
 
 /** Expand `~` to the home dir; resolve relative paths against the config dir. */
@@ -173,6 +205,24 @@ function normalizeCalendars(
   return out.google || out.microsoft ? out : undefined;
 }
 
+/** Normalize one zone's raw value to a ZoneMode. Default (undefined) → "on". */
+function normalizeZoneMode(v: boolean | string | undefined): ZoneMode {
+  if (v === undefined || v === true) return "on";
+  if (v === false) return "off";
+  const s = String(v).toLowerCase();
+  if (s === "off" || s === "false" || s === "no" || s === "none") return "off";
+  if (s === "hidden" || s === "collapsed" || s === "closed") return "hidden";
+  return "on";
+}
+
+function normalizeZones(raw: RawConfig["zones"] | undefined): ZonesConfig {
+  return {
+    planner: normalizeZoneMode(raw?.planner),
+    agenda: normalizeZoneMode(raw?.agenda),
+    agents: normalizeZoneMode(raw?.agents),
+  };
+}
+
 interface FoundConfig {
   path: string;
   dir: string;
@@ -239,6 +289,7 @@ function normalize(raw: Partial<RawConfig>, root: string, loaded: boolean): Conf
         ? raw.resume_command.map(String)
         : undefined,
     calendars: normalizeCalendars(raw.calendars, root),
+    zones: normalizeZones(raw.zones),
   };
 }
 

package/src/input/handleKey.ts

@@ -2,11 +2,11 @@
  * Centralized keyboard input handler. Dispatches based on:
  *   1. modal state (modal eats most keys)
  *   2. global keys (quit, help, undo, board switch, escape, zone cycle)
- *   3. active zone (virtual / board / timeline / agents)
+ *   3. active zone (planner / board / timeline / agents)
  *
  * Task-level actions (`t`/`m`/`s`/`b`/`a`/`o`/`Space`/`X`/`d`/`p`/`.`/`Enter`)
  * all route through `dispatchTaskAction`, so they work identically on a
- * cursor task whether you reach it via the kanban board, the virtual
+ * cursor task whether you reach it via the kanban board, the planner
  * panel, or a timeline block.
  *
  * Extracted from app.tsx so every root view (Dashboard, BoardOnly, etc.)
@@ -24,7 +24,7 @@ import {
 } from "~/store/index";
 import type { Board, PriorityLevel } from "~/types";
 import { buildTimelineEntries, formatAgendaDay } from "~/store/timeline";
-import { buildVirtualItems } from "~/store/virtual-panel";
+import { buildPlannerItems } from "~/store/planner-panel";
 import { jumpToKanban } from "~/ui/TimelineView";
 
 interface KeyEvent {
@@ -37,7 +37,7 @@ interface KeyEvent {
 export function handleKey(
   store: TuiStore,
   key: KeyEvent,
-  virtualCount: number,
+  plannerCount: number,
 ): void {
   const ui = store.state.ui;
   const board = store.state.boards[ui.activeBoardIndex]?.board;
@@ -125,17 +125,18 @@ export function handleKey(
     return;
   }
 
-  // F1/F2/F3 toggle zone visibility. Board cannot be hidden.
+  // F1/F2/F3 toggle zone visibility. Board cannot be hidden; a disabled zone's
+  // key is inert (toggleZoneDesired no-ops).
   if (key.name === "f1") {
-    store.setZoneVisible("virtual", !ui.visibleZones.virtual);
+    store.toggleZoneDesired("planner");
     return;
   }
   if (key.name === "f2") {
-    store.setZoneVisible("timeline", !ui.visibleZones.timeline);
+    store.toggleZoneDesired("timeline");
     return;
   }
   if (key.name === "f3") {
-    store.setZoneVisible("agents", !ui.visibleZones.agents);
+    store.toggleZoneDesired("agents");
     return;
   }
 
@@ -150,9 +151,9 @@ export function handleKey(
     return;
   }
 
-  // Switch in/out of virtual panel with `v`
+  // Switch in/out of planner panel with `v`
   if (key.name === "v") {
-    store.setActiveZone(ui.activeZone === "virtual" ? "board" : "virtual");
+    store.setActiveZone(ui.activeZone === "planner" ? "board" : "planner");
     return;
   }
 
@@ -183,7 +184,7 @@ export function handleKey(
     return;
   }
 
-  // Zoom toggle: focus the active panel (board column or virtual panel)
+  // Zoom toggle: focus the active panel (board column or planner panel)
   // at full width.
   if (key.name === "z") {
     store.toggleZoom();
@@ -227,8 +228,8 @@ export function handleKey(
 
   // ─── Per-zone dispatching ───────────────────────────────────────────────
 
-  if (ui.activeZone === "virtual") {
-    handleVirtualZone(store, key, virtualCount, openLater);
+  if (ui.activeZone === "planner") {
+    handlePlannerZone(store, key, plannerCount, openLater);
     return;
   }
 
@@ -249,19 +250,19 @@ export function handleKey(
 
 // ─── Zone handlers ──────────────────────────────────────────────────────────
 
-function handleVirtualZone(
+function handlePlannerZone(
   store: TuiStore,
   key: KeyEvent,
-  virtualCount: number,
+  plannerCount: number,
   openLater: (m: ModalKind) => void,
 ): void {
   const ui = store.state.ui;
-  const items = buildVirtualItems(store.state.boards.map((b) => b.board));
+  const items = buildPlannerItems(store.state.boards.map((b) => b.board));
   const target = items[ui.row];
 
   // Navigation
   if (key.name === "j" || key.name === "down") {
-    store.setCursor(ui.col, Math.min(virtualCount - 1, ui.row + 1));
+    store.setCursor(ui.col, Math.min(plannerCount - 1, ui.row + 1));
     return;
   }
   if (key.name === "k" || key.name === "up") {
@@ -273,7 +274,7 @@ function handleVirtualZone(
     return;
   }
 
-  // Task actions on the virtual cursor's target (works cross-board).
+  // Task actions on the planner cursor's target (works cross-board).
   if (target) {
     dispatchTaskAction(store, key, target.ref, openLater);
   }
@@ -501,7 +502,7 @@ function handleBoardZone(
     // unrendered, unscrollable column.
     const prev = adjacentVisibleColumn(store, board, ui.col, -1);
     if (prev === undefined) {
-      store.setActiveZone("virtual");
+      store.setActiveZone("planner");
     } else {
       store.setCursor(prev, 0);
     }
@@ -551,7 +552,7 @@ function handleBoardZone(
 
 /**
  * Apply a task-level action to the given cursorRef. Used by every zone
- * (board / virtual / timeline) so the keys feel identical wherever the
+ * (board / planner / timeline) so the keys feel identical wherever the
  * cursor lives. Multi-select aware: when there are marked tasks, the
  * action operates on all of them via `applyToMarkedOr`.
  *
@@ -565,7 +566,7 @@ function dispatchTaskAction(
   ref: TaskRef,
   openLater: (m: ModalKind) => void,
 ): boolean {
-  // Toggle done (Enter). Only meaningful for board/virtual; timeline has
+  // Toggle done (Enter). Only meaningful for board/planner; timeline has
   // its own Enter behavior (jump to kanban) which is handled earlier.
   if (key.name === "enter" || key.name === "return") {
     const n = store.applyToMarkedOr(ref, (r) => store.toggleDone(r));
@@ -623,7 +624,7 @@ function dispatchTaskAction(
   // Calendar arm mode (lowercase c): toggle a persistent mode for batch
   // scheduling onto the timeline. Entering also arms the cursor task and
   // focuses the timeline so you can immediately click a slot. While the mode
-  // is on, clicking ANY task (board / virtual) arms it — click a task, click a
+  // is on, clicking ANY task (board / planner) arms it — click a task, click a
   // slot, repeat. `c` again or `Esc` exits. Works from any zone.
   if (key.name === "c" && !key.shift) {
     if (store.state.ui.armMode) {