k0-board 0.3.0 → 0.5.0

package/platform/shared/tmux.js

@@ -36,6 +36,9 @@ const EMULATORS = [
   { bin: 'xterm', args: (cmd) => ['-e', ...cmd] },
 ]
 
+/** How much of the work area a window takes unless the mode asks for more. */
+const COVERAGE = 0.86
+
 /**
  * Which emulator to open. `K0_TERMINAL` wins, because no list of ours will ever cover every
  * terminal anybody uses, and being wrong about it should not mean being stuck with it.
@@ -83,10 +86,10 @@ export async function open({ command, title }) {
   const session = sessionName()
 
   // The session runs the command directly rather than a shell that then runs it: when Claude
-  // Code exits, the session ends, which is what makes a finished card's terminal disappear
+  // Code exits, the session ends, which is what makes a finished story's terminal disappear
   // instead of leaving an idle shell behind.
   await run(tmux, ['new-session', '-d', '-s', session, '-n', title || session, command])
-  // Off by default, and worth turning on: it is what puts the card's name in the window's
+  // Off by default, and worth turning on: it is what puts the story's name in the window's
   // title bar rather than "tmux".
   await runQuiet(tmux, ['set-option', '-t', session, 'set-titles', 'on'])
   await runQuiet(tmux, ['set-option', '-t', session, 'set-titles-string', title || session])
@@ -183,8 +186,12 @@ async function windowId(handle) {
   return String(out).trim().split('\n').filter(Boolean).pop() || null
 }
 
-export async function focus(handle) {
-  if (!handle) return { ok: false, error: 'This card has no terminal of its own' }
+/**
+ * `title` is accepted and unused: here the handle IS the name tmux put on the window, so the
+ * lookup below is already the search by name that macOS has to fall back to.
+ */
+export async function focus(handle, title) {
+  if (!handle) return { ok: false, error: 'This story has no terminal of its own' }
   if (!canPlaceWindows()) return { ok: false, error: 'k0 cannot raise windows on this desktop' }
   const id = await windowId(handle)
   if (!id) return { ok: false, error: 'That window is gone' }
@@ -195,16 +202,17 @@ export async function focus(handle) {
 /**
  * Geometry, best effort. There is no NSScreen here to ask for the usable area net of panels
  * and docks, so the work area comes from the window manager's own `_NET_WORKAREA` by way of
- * xdotool, and the same 86% margin as everywhere else is applied to it.
+ * xdotool, and the same share of it as everywhere else is applied — all of it when the mode asks
+ * for windows readable from across the room.
  */
-export async function relayout(handles) {
+export async function relayout(handles, { coverage = COVERAGE } = {}) {
   if (!canPlaceWindows()) return { touched: 0 }
   const xdotool = XDOTOOL()
   const geom = await runQuiet(xdotool, ['getdisplaygeometry'])
   const [sw, sh] = String(geom).trim().split(/\s+/).map(Number)
   if (!sw || !sh) return { touched: 0 }
-  const w = Math.round(sw * 0.86)
-  const h = Math.round(sh * 0.86)
+  const w = Math.round(sw * coverage)
+  const h = Math.round(sh * coverage)
   const x = Math.round((sw - w) / 2)
   const y = Math.round((sh - h) / 2)
   let touched = 0
@@ -219,24 +227,34 @@ export async function relayout(handles) {
 }
 
 /**
- * Font size belongs to the emulator, and every emulator spells it differently — some only in
- * a config file that is read at startup. There is no honest generic answer, so k0 says it
- * cannot and driving mode changes only the board's own text.
+ * What the mode asks for, as far as this platform can give it: the window takes its share of the
+ * screen. Font size belongs to the emulator, and every emulator spells it differently — some only
+ * in a config file read at startup. There is no honest generic answer, so k0 says it cannot: here
+ * driving mode makes the windows bigger and leaves the text to the emulator.
  */
-export async function setFont() {
-  return { touched: 0 }
-}
+export const applyMode = (handles, { coverage } = {}) => relayout(handles, { coverage })
 
 export async function defaultFontSize() {
   return 12
 }
 
+/**
+ * Not yet. `send-keys` would probably do it, but it has not been seen to: whether Claude Code
+ * takes a slash command that arrives that way, or reads it as a message the way it reads the
+ * block `type` writes on macOS, is exactly the kind of thing this file does not guess at. Until
+ * somebody checks on a Linux machine, a live session keeps its name until it ends.
+ */
+export async function command() {
+  return { sent: false, why: 'Running a command inside a live session is not available with tmux yet' }
+}
+
 export const capabilities = () => ({
   windows: canPlaceWindows(),
   font: false,
   readScreen: !!TMUX(),
   pasteWithoutSending: !!TMUX(),
   title: !!TMUX(),
+  commands: false,
 })
 
 export { posixCommand as buildCommand } from './command.js'

package/platform/win32/index.js

@@ -24,6 +24,7 @@ export const capabilities = {
   service: service.capabilities(),
   tray: hasPowerShell(),
   revealInFileManager: true,
+  openInFileManager: true,
 }
 
 export const notes = {
@@ -33,10 +34,13 @@ export const notes = {
     'Windows gives no way to read what is printed inside another process’s console, so k0 ' +
     'cannot tell exactly when Claude Code has finished starting: it waits a fixed moment ' +
     'instead. On a slow machine the prompt can arrive early — press Escape, then paste it ' +
-    'again from the card.',
+    'again from the story.',
   'terminal.title':
-    'Windows Terminal owns its tab titles, so renaming a card does not rename a window that ' +
+    'Windows Terminal owns its tab titles, so renaming a story does not rename a window that ' +
     'is already open. The new name shows up next time the session starts.',
+  'terminal.commands':
+    'Renaming a story renames its Claude Code session only once the session has ended: k0 ' +
+    'cannot read what is on a terminal’s screen here, so it will not type /rename into one blind.',
   'terminal.font':
     'Font size lives in your terminal’s own profile, which k0 will not rewrite, so driving ' +
     'mode enlarges the board but not the terminals.',

package/platform/win32/shell.js

@@ -8,6 +8,9 @@ const EXPLORER = () => which('explorer') || 'explorer.exe'
 /** `explorer /select,` opens the folder with the file already highlighted. */
 export const revealInFileManager = (abs) => runQuiet(EXPLORER(), [`/select,${path.normalize(abs)}`])
 
+/** The same command without `/select,` opens the folder itself. */
+export const openInFileManager = (abs) => runQuiet(EXPLORER(), [path.normalize(abs)])
+
 export const openBrowser = (url) => runQuiet('cmd', ['/c', 'start', '', url])
 
 const programFiles = [
@@ -61,4 +64,4 @@ export function findClaude() {
   return claudeBin
 }
 
-export const capabilities = () => ({ revealInFileManager: true })
+export const capabilities = () => ({ revealInFileManager: true, openInFileManager: true })

package/platform/win32/terminal.js

@@ -26,6 +26,9 @@ import { ps, psJson, psq } from './powershell.js'
 const WT = () => which('wt')
 const POWERSHELL_BIN = () => which('pwsh') || which('powershell')
 
+/** How much of the work area a window takes unless the mode asks for more. */
+const COVERAGE = 0.86
+
 /** The user32 declarations every window operation here needs, added once per PowerShell run. */
 const USER32 = `
 Add-Type -Namespace K0 -Name Win -MemberDefinition @'
@@ -66,7 +69,7 @@ export async function open({ command, title }) {
 
 /**
  * Windows Terminal owns its tab titles and does not take instructions about them from
- * outside, so a card renamed after its session started keeps the old name in the title bar
+ * outside, so a story renamed after its session started keeps the old name in the title bar
  * until the session is restarted. Reported as unavailable rather than failing silently.
  */
 export async function setTitle() {
@@ -74,7 +77,7 @@ export async function setTitle() {
 }
 
 export async function focus(handle) {
-  if (!handle) return { ok: false, error: 'This card has no terminal window of its own' }
+  if (!handle) return { ok: false, error: 'This story has no terminal window of its own' }
   const found = await psJson(
     `${USER32}
      $p = ${findWindow(handle)}
@@ -86,14 +89,14 @@ export async function focus(handle) {
   return found?.ok ? { ok: true } : { ok: false, error: 'That window is gone' }
 }
 
-export async function relayout(handles) {
+export async function relayout(handles, { coverage = COVERAGE } = {}) {
   let touched = 0
   for (const handle of handles || []) {
     const ok = await psJson(
       `${USER32}
        Add-Type -AssemblyName System.Windows.Forms -ErrorAction SilentlyContinue
        $area = [System.Windows.Forms.Screen]::PrimaryScreen.WorkingArea
-       $w = [int]($area.Width * 0.86); $h = [int]($area.Height * 0.86)
+       $w = [int]($area.Width * ${coverage}); $h = [int]($area.Height * ${coverage})
        $x = $area.X + [int](($area.Width - $w) / 2); $y = $area.Y + [int](($area.Height - $h) / 2)
        $p = ${findWindow(handle)}
        if ($p) { [K0.Win]::MoveWindow($p.MainWindowHandle, $x, $y, $w, $h, $true) | Out-Null; @{ ok = $true } }
@@ -105,10 +108,13 @@ export async function relayout(handles) {
   return { touched }
 }
 
-/** Font size lives in the terminal's own profile, which k0 will not rewrite. */
-export async function setFont() {
-  return { touched: 0 }
-}
+/**
+ * What the mode asks for, as far as this platform can give it: the window takes its share of
+ * the screen. The font size lives in the terminal's own profile, which k0 will not rewrite —
+ * so here driving mode makes the windows bigger and leaves the text alone, which is what the
+ * `terminal.font` capability has always said.
+ */
+export const applyMode = (handles, { coverage } = {}) => relayout(handles, { coverage })
 
 export async function defaultFontSize() {
   return 12
@@ -198,12 +204,22 @@ export async function close({ handle, pid }) {
   return { closed: !!res?.ok }
 }
 
+/**
+ * Not here: a command is only worth typing into a live session once the screen says the input
+ * box is free and, afterwards, that the line came out right — and Windows gives no way to read
+ * the screen (see the top of this file). A live session keeps its name until it ends.
+ */
+export async function command() {
+  return { sent: false, why: 'k0 cannot read a terminal on Windows, so it will not type into one blind' }
+}
+
 export const capabilities = () => ({
   windows: !!POWERSHELL_BIN(),
   font: false,
   readScreen: false,
   pasteWithoutSending: !!POWERSHELL_BIN(),
   title: false,
+  commands: false,
 })
 
 export { powershellCommand as buildCommand } from '../shared/command.js'

package/platform/win32/tray.ps1

@@ -75,12 +75,12 @@ $menu = New-Object System.Windows.Forms.ContextMenuStrip
 $notify.ContextMenuStrip = $menu
 
 # Clicking the balloon brings that session's terminal up front, which is the whole point of being
-# told. Windows shows one balloon at a time and replaces it rather than queueing, so the card the
+# told. Windows shows one balloon at a time and replaces it rather than queueing, so the story the
 # click belongs to is always the last one announced — there is nothing else it could be.
 $script:LastNotified = $null
 $notify.Add_BalloonTipClicked({
     if ($null -ne $script:LastNotified) {
-      Invoke-K0 "/api/card/$($script:LastNotified)/focus" @{} | Out-Null
+      Invoke-K0 "/api/story/$($script:LastNotified)/focus" @{} | Out-Null
     }
   }) | Out-Null
 
@@ -100,10 +100,10 @@ function Update-K0Menu($Waiting, [bool]$Down) {
   } elseif (-not $Waiting -or $Waiting.Count -eq 0) {
     Add-K0Item 'Nothing waiting for you' $null $false | Out-Null
   } else {
-    foreach ($card in $Waiting) {
-      $label = "$($Labels[$card.status]) - $($card.title)"
-      $id = $card.id
-      Add-K0Item $label ([System.EventHandler]{ Invoke-K0 "/api/card/$id/focus" @{} | Out-Null }.GetNewClosure()) | Out-Null
+    foreach ($story in $Waiting) {
+      $label = "$($Labels[$story.status]) - $($story.title)"
+      $id = $story.id
+      Add-K0Item $label ([System.EventHandler]{ Invoke-K0 "/api/story/$id/focus" @{} | Out-Null }.GetNewClosure()) | Out-Null
     }
   }
 
@@ -126,17 +126,17 @@ function Update-K0Menu($Waiting, [bool]$Down) {
     }) | Out-Null
 }
 
-# Notify about cards that have just started waiting, not about every one on every pass.
+# Notify about stories that have just started waiting, not about every one on every pass.
 function Show-K0Notifications($Waiting) {
   $now = @{}
-  foreach ($card in $Waiting) { $now["$($card.id):$($card.status)"] = $true }
+  foreach ($story in $Waiting) { $now["$($story.id):$($story.status)"] = $true }
   if (-not $script:FirstPass) {
-    foreach ($card in $Waiting) {
-      $key = "$($card.id):$($card.status)"
+    foreach ($story in $Waiting) {
+      $key = "$($story.id):$($story.status)"
       if (-not $script:Seen.ContainsKey($key)) {
-        $script:LastNotified = $card.id
-        $notify.BalloonTipTitle = $Labels[$card.status]
-        $notify.BalloonTipText = $card.title
+        $script:LastNotified = $story.id
+        $notify.BalloonTipTitle = $Labels[$story.status]
+        $notify.BalloonTipText = $story.title
         $notify.ShowBalloonTip(4000)
       }
     }