@fonlan/dsh-task-kanban 0.2.6 → 0.2.7

package/lib/types/server/settings.d.ts

@@ -1,35 +1,15 @@
 /**
  * User-facing plugin settings (global parallel worker count, per-session-type
- * model/effort/preset defaults), persisted through the settings service
- * namespace `task-kanban`. The DSH settings service requires a lowercase
- * kebab-case namespace (/^[a-z][a-z0-9-]*$/), so the scoped package name
- * cannot be used here.
+ * model/effort/preset defaults), carried by this bundle's entry config: dsh
+ * >= 0.1.7 owns plugin settings as entry config (the plugin's `Config`
+ * schema), so the face reads the config it was applied with and persists
+ * updates through `settings.update`.
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { KanbanSessionKind, KanbanSettingsShape } from '../shared/card.js';
 export declare const KANBAN_SETTINGS_NS = "task-kanban";
-export declare const KanbanSettingsSchema: z<Schemastery.ObjectS<{
-    maxParallelWorkers: z<number, number>;
-    refinementModel: z<string, string>;
-    refinementProvider: z<string, string>;
-    refinementReasoningEffort: z<string, string>;
-    refinementPreset: z<string, string>;
-    phaseModel: z<string, string>;
-    phaseProvider: z<string, string>;
-    phaseReasoningEffort: z<string, string>;
-    phasePreset: z<string, string>;
-}>, Schemastery.ObjectT<{
-    maxParallelWorkers: z<number, number>;
-    refinementModel: z<string, string>;
-    refinementProvider: z<string, string>;
-    refinementReasoningEffort: z<string, string>;
-    refinementPreset: z<string, string>;
-    phaseModel: z<string, string>;
-    phaseProvider: z<string, string>;
-    phaseReasoningEffort: z<string, string>;
-    phasePreset: z<string, string>;
-}>>;
+export declare const KanbanSettingsSchema: z<KanbanSettingsShape>;
 /** The per-session-type default slice a session kind resolves. */
 export interface KanbanSessionDefaults {
     model: string;
@@ -52,4 +32,4 @@ export interface KanbanSettingsFace {
      */
     sessionDefaults(kind: KanbanSessionKind): KanbanSessionDefaults;
 }
-export declare function registerSettings(ctx: Context): KanbanSettingsFace;
+export declare function registerSettings(ctx: Context, config: KanbanSettingsShape): KanbanSettingsFace;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonlan/dsh-task-kanban",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "DSH web plugin: a task kanban that refines requirements into phased plans, auto-executes them in git worktrees (one session per phase), and auto-merges into the main branch on completion.",
   "license": "MIT",
   "repository": {
@@ -80,52 +80,52 @@
     "@deepseek-ai/cordis": "^4.0.2",
     "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.2",
     "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-layout": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-session": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-workspace": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.2",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "@types/react": "~18.3.1",
-    "@types/react-dom": "~18.3.0",
-    "tsdown": "^0.22.14",
-    "typescript": "^5.9.0",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
     "@deepseek-ai/schemastery": "^3.18.2",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-layout": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-session": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-client-ui-workspace": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.3",
+    "@types/node": "^22.0.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "tsdown": "^0.22.14",
+    "typescript": "^5.9.0",
     "vitest": "^3.2.0"
   },
   "packageManager": "pnpm@11.21.0"

package/src/client/board.css

@@ -386,110 +386,3 @@
   font-size: 13px;
   line-height: 1.5;
 }
-.kb-footer-action {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  gap: 6px;
-  width: 32px;
-  height: 32px;
-  border-radius: 6px;
-  border: none;
-  background: transparent;
-  /* same foreground as the settings trigger (its trigger css uses this var) */
-  color: var(--dsw-alias-label-primary, inherit);
-  cursor: pointer;
-}
-.kb-footer-action:hover { background: rgba(128, 128, 128, 0.18); }
-.kb-footer-action-active { background: rgba(59, 130, 246, 0.25); }
-/* Wide mode borrows the settings trigger's metrics (34px tall, 14px label,
-   18px icon) so both controls read as siblings on the same line. */
-.kb-footer-action-wide {
-  width: auto;
-  height: 34px;
-  padding: 0 8px;
-  border-radius: 12px;
-  font-size: 14px;
-}
-.kb-footer-action-wide .kb-footer-label {
-  font-size: 14px;
-  line-height: 22px;
-}
-/* Theme following is handled by the --dsw-alias-* tokens above: they change
-   value with the shell's selected light/dark appearance, so no OS-level
-   prefers-color-scheme override is needed (and one would fight the app
-   theme when the two disagree). */
-/* Same-line placement WITHOUT moving any DOM: the sidebar foot area becomes
-   a reversed flex row, so its LAST child (the settings area) renders on the
-   LEFT and the FIRST child (footer actions = the kanban button) on the RIGHT
-   — exactly "settings, then kanban". The settings trigger flexes to fill the
-   remaining width; the button keeps its content width. */
-.kb-foot-row {
-  display: flex;
-  flex-direction: row-reverse;
-  align-items: stretch;
-  gap: 4px;
-}
-.kb-foot-row > div:first-child {
-  flex: none;
-  width: auto;
-  min-width: 0;
-  display: flex;
-  align-items: center;
-}
-.kb-foot-row > div:last-child {
-  flex: 1;
-  min-width: 0;
-}
-/* Rail (collapsed sidebar): column-reverse stacks the settings circle on top
-   and the kanban icon below it, both centered; the kanban button borrows the
-   settings trigger's rail chrome (36px circle) so the two match. */
-.kb-foot-rail {
-  flex-direction: column-reverse;
-  align-items: center;
-}
-.kb-foot-rail .kb-footer-action {
-  width: 36px;
-  height: 36px;
-  border-radius: 50%;
-  margin: 8px 0 10px;
-}
-.kb-footer-label {
-  max-width: 110px;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-/* Narrow screens (mobile drawer / auto-collapse breakpoint): the drawer's
-   foot area is ~256-280px but the footer actions row carries the kanban
-   button PLUS mobile-nav's drawer actions (Files / session log), which
-   together exceed the row and squeeze the settings trigger to zero width
-   (row-reverse overflows left, clipping the button). Below the shell's
-   auto-collapse breakpoint, stack the settings row above the actions and
-   let the actions wrap so nothing is squeezed or clipped. */
-@media (max-width: 1023px) {
-  .kb-foot-row {
-    flex-direction: column-reverse;
-    align-items: stretch;
-  }
-  .kb-foot-row > div:first-child {
-    flex: none;
-    width: 100%;
-    display: flex;
-    flex-wrap: wrap;
-    justify-content: flex-start;
-    gap: 4px;
-    padding-top: 4px;
-  }
-  .kb-foot-row > div:last-child {
-    flex: none;
-    width: 100%;
-  }
-  /* The footer-actions entries are display:contents wrappers, so the kanban
-     button itself is a flex item of the wrapping actions row; pull it to the
-     first wrap position so it sits directly below the settings row (the
-     mobile-nav drawer actions follow on their own wrapped line). */
-  .kb-foot-row .kb-footer-action {
-    order: -1;
-  }
-}

package/src/client/board.tsx

@@ -2,7 +2,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
 import type { KanbanCard, Lane, PhaseAttempt, PlanPhase } from '../shared/card'
 import { DROP_RULES, laneOf } from '../shared/lanes'
 import { api, gatewaySkillList, type SkillOption } from './api'
-import { exitBoard, getClient } from './kanban-state'
+import { getClient, leaveKanbanPanel } from './kanban-state'
 import { en, zh } from './locales'
 import './board.css'
 
@@ -158,7 +158,10 @@ export function BoardRoot(props: BoardProps): JSX.Element {
 
   const openSession = useCallback((sessionId: string) => {
     const ctx = getClient()
-    exitBoard()
+    // Return the center column to the Conversation first: `sessions.open` is
+    // wrapped by bindSessionNavigation as well, but a runtime without that
+    // binding must still leave the board before the session renders.
+    leaveKanbanPanel(ctx)
     if (ctx === null) return
     try {
       ;(ctx.sessions as { open(id: string): void }).open(sessionId)

package/src/client/icons.tsx

@@ -0,0 +1,74 @@
+import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+
+/** Props every shell icon accepts: square edge in px, color rides currentColor. */
+export interface IconProps {
+  size?: number
+  className?: string
+}
+
+/** One shell icon component. */
+export type IconComponent = (props: IconProps) => JSX.Element
+
+/** The runtime export table, read by capability instead of by one hard-coded name. */
+const table = primitives as unknown as Record<string, IconComponent | undefined>
+
+/** First name the runtime actually provides (a missing export is `undefined`). */
+function firstDefined(...names: string[]): IconComponent | undefined {
+  for (const name of names) {
+    let candidate: IconComponent | undefined
+    try {
+      candidate = table[name]
+    } catch {
+      // Some module namespaces reject unknown names instead of yielding
+      // `undefined`; a rename must never throw on its way to the fallback.
+      continue
+    }
+    if (typeof candidate === 'function') return candidate
+  }
+  return undefined
+}
+
+/**
+ * Self-contained 16×16 checklist glyph (the 0.1.7 artwork) used when the shell
+ * primitives expose none of the names above: the footer entry must render
+ * something even on a runtime whose icon exports we do not know.
+ */
+function ChecklistFallback({ size = 14, className }: IconProps): JSX.Element {
+  return (
+    <svg
+      width={size}
+      height={size}
+      className={className}
+      viewBox="0 0 16 16"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      aria-hidden="true"
+      strokeWidth={1}
+    >
+      <path d="M3.75 6.25C4.7165 6.25 5.5 5.4665 5.5 4.5C5.5 3.5335 4.7165 2.75 3.75 2.75C2.7835 2.75 2 3.5335 2 4.5C2 5.4665 2.7835 6.25 3.75 6.25Z" stroke="currentColor" />
+      <path d="M7.5 4.5H13.5" stroke="currentColor" />
+      <path d="M3.75 13.25C4.7165 13.25 5.5 12.4665 5.5 11.5C5.5 10.5335 4.7165 9.75 3.75 9.75C2.7835 9.75 2 10.5335 2 11.5C2 12.4665 2.7835 13.25 3.75 13.25Z" stroke="currentColor" />
+      <path d="M7.5 11.5H13.5" stroke="currentColor" />
+    </svg>
+  )
+}
+
+/**
+ * The checklist icon used by the sidebar panel row entry.
+ *
+ * DSH 0.1.7 renamed every size-suffixed shell icon (`IconChecklistOutline14`)
+ * into stroke-weight variants (`…Regular` 1px / `…Medium` 1.3px) inside
+ * `@deepseek-ai/dsh-client-ui-primitives`. A stale named import resolves to
+ * `undefined` and React then throws "Element type is invalid" while rendering
+ * the slot entry — the entry is dropped and the button silently disappears
+ * (exactly what upgrading to 0.1.7 did to this plugin). Resolve the name at
+ * runtime, newest first, so the next rename degrades to another shipped
+ * variant instead of taking the button down with it.
+ */
+export const ChecklistIcon: IconComponent =
+  firstDefined(
+    'IconChecklistOutlineRegular',
+    'IconChecklistOutlineMedium',
+    'IconChecklistOutline',
+    'IconChecklistOutline14',
+  ) ?? ChecklistFallback

package/src/client/index.tsx

@@ -6,9 +6,9 @@ import type {} from '@deepseek-ai/dsh-client-ui-layout/client'
 import type {} from '@deepseek-ai/dsh-client-ui-conversation/client'
 import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
 import { BoardRoot } from './board'
-import { KanbanFooterButton, KanbanSettingsSection } from './sections'
+import { KanbanPanelIcon, KanbanSettingsSection } from './sections'
 import { LOCALE_NS, zh, en } from './locales'
-import { setClient, setBoardRoot, bindSessionNavigation } from './kanban-state'
+import { KANBAN_PANEL_ID, setClient, bindSessionNavigation } from './kanban-state'
 
 /** The settings sidebar entry this plugin's page owns (must stay stable). */
 const SETTINGS_SECTION_ID = 'task-kanban'
@@ -19,8 +19,7 @@ export const inject = ['slots', 'sessions', 'workspaces', 'locale']
 /** Client plugin body. */
 export function apply(ctx: ClientContext): void {
   setClient(ctx)
-  setBoardRoot(BoardRoot as unknown as (props: Record<string, unknown>) => React.ReactNode)
-  // Selecting a session while the board is open must leave the board first.
+  // Selecting a session while the board is open must return to the Conversation.
   bindSessionNavigation(ctx)
 
   // Live translate bound to the active locale (labels re-read it per call).
@@ -30,14 +29,30 @@ export function apply(ctx: ClientContext): void {
     return () => off()
   }, 'task-kanban: dictionaries')
 
-  ctx.slots.inject('sidebar.footer.action', () =>
+  // The board is a GLOBAL MAIN PANEL: the shell renders one `main` entry per
+  // selected panel id, so keying it (instead of replacing `main.conversation`)
+  // keeps the Conversation mounted and selectable beside the board, and the
+  // sidebar's own panel row owns the button that selects it (the
+  // `sidebar.panellist` entry below). Nothing of this plugin sits in the
+  // sidebar foot any more, so the Settings trigger can never be squeezed.
+  ctx.slots.inject('main', () =>
     ctx.slots.register({
-      name: 'sidebar.footer.action',
-      id: 'task-kanban',
-      order: 60,
+      name: 'main',
+      key: KANBAN_PANEL_ID,
+      locale: LOCALE_NS,
+    } as never, BoardRoot as never),
+  )
+
+  // Sidebar panel row: the shell renders the row (label, tooltip, active state)
+  // and calls `layout.selectPanel(id)` on click; the entry supplies the glyph.
+  ctx.slots.inject('sidebar.panellist', () =>
+    ctx.slots.register({
+      name: 'sidebar.panellist',
+      id: KANBAN_PANEL_ID,
+      order: 20,
       label: () => t('kanban'),
       locale: LOCALE_NS,
-    }, KanbanFooterButton as never),
+    }, KanbanPanelIcon as never),
   )
 
   // The plugin's own settings page (设置 -> 侧栏「任务看板」) rides the
@@ -53,4 +68,4 @@ export function apply(ctx: ClientContext): void {
       locale: LOCALE_NS,
     }, KanbanSettingsSection as never),
   )
-}
+}

package/src/client/kanban-state.ts

@@ -1,44 +1,41 @@
-import { useSyncExternalStore } from 'react'
 import type { Context } from '@deepseek-ai/cordis'
 type ClientContext = Context
 
 /**
- * HMR-safe shared state store keyed on the global symbol registry.
+ * Panel id shared by this plugin's main-panel key (`main`) and its sidebar
+ * entry (`sidebar.panellist`): the shell selects the panel by this id, so the
+ * two registrations must agree.
+ */
+export const KANBAN_PANEL_ID = 'task-kanban'
+
+/**
+ * Structural view of the client shell's panel-navigation face (`ctx.layout`).
+ * Declared locally (no value import) so the plugin keeps working on a runtime
+ * whose layout types differ.
+ */
+interface LayoutLike {
+  selectPanel(panelId: string | null): void
+}
+
+/**
+ * HMR-safe owner context, keyed on the global symbol registry.
  *
  * The client-hmr hot swap re-evaluates this module (a fresh `lib/client.js`
- * bundle) WITHOUT reloading the page. A module-level singleton would then be
- * duplicated per evaluation: the session-navigation wrapper installed by the
- * OLD module copy keeps calling the OLD copy's `exitBoard`, which reads the
- * OLD copy's `boardOpen`/`boardDisposer` — while a board opened after the swap
- * writes the NEW copy's state cell. The wrapper would then no-op and clicking
- * a sidebar session would never leave the board.
- *
- * Keeping every field on one `globalThis`-backed record (via `Symbol.for`, so
- * all bundle copies resolve the same key) makes every copy read/write the same
- * state cell, so exit works regardless of which module copy performed the
- * enter.
+ * bundle) WITHOUT reloading the page; a module-level cell would then be
+ * duplicated per evaluation and an old copy's helper would read a stale owner.
+ * `Symbol.for` makes every bundle copy share one cell.
  */
 const STATE_KEY = Symbol.for('@fonlan/dsh-task-kanban/state')
 
 interface KanbanState {
   client: ClientContext | null
-  boardRoot: ((props: Record<string, unknown>) => React.ReactNode) | null
-  boardDisposer: (() => void) | null
-  boardOpen: boolean
-  listeners: Set<() => void>
 }
 
 function getState(): KanbanState {
   const g = globalThis as unknown as Record<symbol, KanbanState | undefined>
   let state = g[STATE_KEY]
   if (state === undefined) {
-    state = {
-      client: null,
-      boardRoot: null,
-      boardDisposer: null,
-      boardOpen: false,
-      listeners: new Set(),
-    }
+    state = { client: null }
     g[STATE_KEY] = state
   }
   return state
@@ -51,80 +48,49 @@ export function getClient(): ClientContext | null {
   return getState().client
 }
 
-export function setBoardRoot(component: (props: Record<string, unknown>) => React.ReactNode): void {
-  getState().boardRoot = component
-}
-export function getBoardRoot(): ((props: Record<string, unknown>) => React.ReactNode) | null {
-  return getState().boardRoot
-}
-
-function notify(): void {
-  for (const listener of getState().listeners) listener()
-}
-export function isBoardOpen(): boolean {
-  return getState().boardOpen
-}
-function subscribe(cb: () => void): () => void {
-  const listeners = getState().listeners
-  listeners.add(cb)
-  return () => { listeners.delete(cb) }
-}
-export function useBoardOpen(): boolean {
-  return useSyncExternalStore(subscribe, isBoardOpen)
+/** The shell's panel face, when this runtime provides it. */
+function layoutOf(ctx: ClientContext | null): LayoutLike | null {
+  if (ctx === null) return null
+  try {
+    const layout = (ctx as unknown as { layout?: LayoutLike }).layout
+    return typeof layout?.selectPanel === 'function' ? layout : null
+  } catch {
+    return null
+  }
 }
 
-export function enterBoard(): void {
-  const state = getState()
-  const ctx = state.client
-  const root = state.boardRoot
-  if (ctx === null || root === null || state.boardDisposer !== null) return
+/** Select the kanban panel. The sidebar's own entry does this; kept for in-app callers. */
+export function showKanbanPanel(ctx: ClientContext | null = getClient()): void {
   try {
-    // DSH 0.1.5 moved the replaceable shell from the legacy `conversation`
-    // seat to `main.conversation`. Register through `inject` so the board
-    // waits for that owner if the client plugin load order is reversed.
-    state.boardDisposer = ctx.slots.inject('main.conversation', () =>
-      ctx.slots.register({ name: 'main.conversation', priority: -1, locale: 'task-kanban' } as never, root as never),
-    )
-    state.boardOpen = true
-    notify()
+    layoutOf(ctx)?.selectPanel(KANBAN_PANEL_ID)
   } catch (error) {
-    console.error('[@fonlan/dsh-task-kanban] cannot open the board:', error)
+    console.error('[@fonlan/dsh-task-kanban] cannot select the kanban panel:', error)
   }
 }
 
-export function exitBoard(): void {
-  const state = getState()
-  if (state.boardDisposer !== null) {
-    state.boardDisposer()
-    state.boardDisposer = null
-  }
-  if (state.boardOpen) {
-    state.boardOpen = false
-    notify()
+/** Hand the center column back to the Conversation. */
+export function leaveKanbanPanel(ctx: ClientContext | null = getClient()): void {
+  try {
+    layoutOf(ctx)?.selectPanel(null)
+  } catch (error) {
+    console.error('[@fonlan/dsh-task-kanban] cannot leave the kanban panel:', error)
   }
 }
 
-export function toggleBoard(): void {
-  if (isBoardOpen()) exitBoard()
-  else enterBoard()
-}
-
 /**
- * Route session navigation through the board: opening any session while the
- * board is open leaves the board first, so the conversation view can render
- * for the newly selected session.
+ * Route session navigation through the panel selection: opening any session
+ * while the board is the active panel first returns the center column to the
+ * Conversation, so the session view renders.
  *
  * Every sidebar path that selects a session funnels through `sessions.open`
  * (session rows, search results, fork results, New Session) or
  * `sessions.openSubagent` (catalog children) — including re-clicking the
  * already-current session, which never changes `list.current` and therefore
- * cannot be caught by a list-store subscription. Wrapping the two entry
- * points covers all of them in one place.
+ * cannot be caught by a list-store subscription. Wrapping the two entry points
+ * covers all of them in one place.
  *
  * The wrapper is idempotent: a `kbBound` marker on the wrapper prevents a
- * second bind (plugin re-apply / HMR) from stacking another layer. Because the
- * wrapper's exit goes through the shared state store, a wrapper left over from
- * a previous (HMR-replaced) module copy still closes the board correctly.
+ * second bind (plugin re-apply / HMR) from stacking another layer.
  */
 export function bindSessionNavigation(ctx: ClientContext): void {
   const sessions = ctx.sessions
@@ -133,7 +99,7 @@ export function bindSessionNavigation(ctx: ClientContext): void {
   const open = sessions.open
   if (typeof open === 'function' && (open as unknown as { kbBound?: boolean }).kbBound !== true) {
     const bound = ((id: Parameters<typeof open>[0]) => {
-      exitBoard()
+      leaveKanbanPanel(ctx)
       return open.call(sessions, id)
     }) as typeof open
     ;(bound as unknown as { kbBound?: boolean }).kbBound = true
@@ -143,10 +109,10 @@ export function bindSessionNavigation(ctx: ClientContext): void {
   const openSubagent = sessions.openSubagent
   if (typeof openSubagent === 'function' && (openSubagent as unknown as { kbBound?: boolean }).kbBound !== true) {
     const bound = ((address: Parameters<typeof openSubagent>[0]) => {
-      exitBoard()
+      leaveKanbanPanel(ctx)
       return openSubagent.call(sessions, address)
     }) as typeof openSubagent
     ;(bound as unknown as { kbBound?: boolean }).kbBound = true
     sessions.openSubagent = bound
   }
-}
+}