@g3nomaly/g3n-mods 0.1.6 → 0.1.8

package/mods/mini-game/hooks/register.tsx

@@ -1,123 +1,80 @@
 // packages/g3n-mods/mods/mini-game/hooks/register.tsx
 import { atom, read, update } from 'claude-code'
-import type { EngineInterface, Register } from 'claude-code'
+import type { EngineInterface, Register, RenderChildren } from 'claude-code'
 
-import type { Game } from '../types'
+import type { Game, View, Whack } from '../types'
+import { adjacentMines, newGame, reveal, toggleFlag } from './minesweeper'
+import { LIVES, escape, newWhack, quit, startWhack, whack as whackHole } from './mole'
 
 const PANE = 'mini-game'
-const TITLE = 'Minesweeper'
+const TITLES: Record<View, string> = { mines: 'Minesweeper', mole: 'Whack-a-mole' }
+/** What `/mini-game` takes after its name, each mapped to the game it opens. */
+const VIEW_ARGS: Record<string, View> = { mines: 'mines', minesweeper: 'mines', mole: 'mole', whack: 'mole' }
+
+const view = atom({ plugin: 'mini-game', key: 'view' } as const, 'mines')
 const game = atom({ plugin: 'mini-game', key: 'game' } as const, null)
 const best = atom({ plugin: 'mini-game', key: 'best' } as const, null)
+const whack = atom({ plugin: 'mini-game', key: 'whack' } as const, null)
+const whackBest = atom({ plugin: 'mini-game', key: 'whackBest' } as const, null)
 
-const SIZE = 9
-const MINES = 10
 const BEST_KEY = 'best-seconds'
+const WHACK_BEST_KEY = 'whack-best'
 /** How long a turn runs before the mod suggests a game, once per session. */
 const HINT_AFTER_MS = 60_000
-/** Width of every cell, in columns: room for the widest glyph (`■`, `⚑`, `✹`) on any surface. */
+/** Width of every cell, in columns: room for the widest glyph (`■`, `⚑`, `✹`, `🐹`) on any surface. */
 const CELL_WIDTH = 2
 
 const NUMBER_COLORS = [undefined, '#6b8fd6', '#7cc47f', '#e06c6c', '#9b87f5', '#e0775a', '#5fb3c4', '#d0d0d0', '#8a8f98']
 
 /**
- * Lists the cells around `cell` on a `size` × `size` board.
- *
- * @param cell - Cell number, counted row by row from `0`.
- * @param size - Board width and height in cells.
- * @returns The neighboring cell numbers, from one to eight of them.
- */
-export function neighbors(cell: number, size: number): number[] {
-  const row = Math.floor(cell / size)
-  const col = cell % size
-  const found: number[] = []
-  for (let dr = -1; dr <= 1; dr++) {
-    for (let dc = -1; dc <= 1; dc++) {
-      const r = row + dr
-      const c = col + dc
-      if ((dr !== 0 || dc !== 0) && r >= 0 && r < size && c >= 0 && c < size) found.push(r * size + c)
-    }
-  }
-  return found
-}
-
-/**
- * Counts the mines in the cells around `cell`.
- *
- * @param board - Board to read, see `Game`.
- * @param cell - Cell number to count around.
- * @returns Number of neighboring mines, from `0` to `8`.
- */
-function adjacentMines(board: Game, cell: number): number {
-  return neighbors(cell, board.size).filter(n => board.mines.includes(n)).length
-}
-
-/**
- * Picks random cells for the mines, leaving `safe` and the cells around it free.
+ * Opens the pane in the Claude Code chat, titled after the game it holds.
  *
- * @param board - Board to place mines on, see `Game`.
- * @param safe - Cell the first reveal hit, which must not be a mine.
- * @returns Mine cell numbers, `board.mineCount` of them.
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
  */
-function placeMines(board: Game, safe: number): number[] {
-  const banned = new Set([safe, ...neighbors(safe, board.size)])
-  const free = Array.from({ length: board.size * board.size }, (_, i) => i).filter(i => !banned.has(i))
-  for (let i = free.length - 1; i > 0; i--) {
-    const j = Math.floor(Math.random() * (i + 1))
-    ;[free[i], free[j]] = [free[j] ?? 0, free[i] ?? 0]
-  }
-  return free.slice(0, board.mineCount)
+async function openPane($: EngineInterface): Promise<void> {
+  await $.ui.open({ id: PANE, title: TITLES[await read($, view)] })
 }
 
 /**
- * @brief Reveals one cell: the first reveal places the mines, a zero opens its
- * neighbours, a mine ends the game, and the last safe cell wins it.
+ * Titles the pane after the game it holds where the Claude Code chat shows it, and redraws it. A press never opens
+ * it there: a pane the mods viewer alone draws stays out of the chat.
  *
- * @param board - Board to reveal on, see `Game`.
- * @param cell - Cell number to reveal.
- * @param now - Milliseconds since the epoch, stamped as the start or end time.
- * @returns The board after the reveal, or the same board when the cell cannot be revealed.
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
  */
-export function reveal(board: Game, cell: number, now: number): Game {
-  if (board.status === 'won' || board.status === 'lost') return board
-  if (board.revealed.includes(cell) || board.flagged.includes(cell)) return board
-
-  const mines = board.status === 'ready' ? placeMines(board, cell) : board.mines
-  const started: Game = board.status === 'ready' ? { ...board, mines, status: 'playing', startedAt: now } : board
-  if (mines.includes(cell)) return { ...started, revealed: [...started.revealed, cell], status: 'lost', endedAt: now }
-
-  const open = new Set(started.revealed)
-  const queue = [cell]
-  while (queue.length > 0) {
-    const next = queue.pop() ?? cell
-    if (open.has(next) || started.flagged.includes(next)) continue
-    open.add(next)
-    if (adjacentMines(started, next) === 0) queue.push(...neighbors(next, started.size).filter(n => !open.has(n)))
-  }
-
-  const revealed = [...open]
-  const isWon = revealed.length === started.size * started.size - started.mineCount
-  return isWon ? { ...started, revealed, status: 'won', endedAt: now } : { ...started, revealed }
+async function showGame($: EngineInterface): Promise<void> {
+  if ((await $.ui.panes()).some(pane => pane.id === PANE)) await openPane($)
+  else $.ui.invalidate('ui.render')
 }
 
 /**
- * Creates a board in the `ready` state, with no mines placed yet.
+ * Starts a new Minesweeper board and shows it.
  *
- * @param now - Milliseconds since the epoch, stamped as the start time.
- * @returns The new board, see `Game`.
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
  */
-function newGame(now: number): Game {
-  return { size: SIZE, mineCount: MINES, mines: [], revealed: [], flagged: [], status: 'ready', isFlagMode: false, startedAt: now }
+async function startGame($: EngineInterface): Promise<void> {
+  const now = await $.clock.now()
+  await update($, game, () => newGame(now))
+  await showGame($)
 }
 
 /**
- * Starts a new board and shows the pane.
+ * Switches the pane to `next`, setting up its game when there is none to play.
+ * Leaving whack-a-mole mid-round ends the round, so moles do not escape unseen.
  *
  * @param $ - Engine handle the hook received, see `EngineInterface`.
+ * @param next - Game to show.
  */
-async function startGame($: EngineInterface): Promise<void> {
-  const now = await $.clock.now()
-  await update($, game, () => newGame(now))
-  await $.ui.open({ id: PANE, title: TITLE })
+async function showView($: EngineInterface, next: View): Promise<void> {
+  await update($, view, () => next)
+  if (next === 'mole') {
+    await update($, whack, current => current ?? newWhack())
+    await showGame($)
+    return
+  }
+  await changeWhack($, quit)
+  const current = await read($, game)
+  if (current === null || current.status === 'won' || current.status === 'lost') await startGame($)
+  else await showGame($)
 }
 
 /**
@@ -130,10 +87,7 @@ async function pressCell($: EngineInterface, cell: number): Promise<void> {
   const now = await $.clock.now()
   const after = await update($, game, board => {
     if (board === null) return board
-    if (!board.isFlagMode) return reveal(board, cell, now)
-    if (board.revealed.includes(cell) || board.status === 'won' || board.status === 'lost') return board
-    const flagged = board.flagged.includes(cell) ? board.flagged.filter(c => c !== cell) : [...board.flagged, cell]
-    return { ...board, flagged }
+    return board.isFlagMode ? toggleFlag(board, cell) : reveal(board, cell, now)
   })
   if (after?.status === 'won' && after.endedAt === now) {
     const seconds = Math.round((now - after.startedAt) / 1000)
@@ -156,12 +110,46 @@ async function toggleFlagMode($: EngineInterface): Promise<void> {
 }
 
 /**
- * Redraws the timer once a second while a game is on.
+ * Applies `change` to the whack-a-mole game, times each new mole's escape, and
+ * records the score when the round ends.
+ *
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
+ * @param change - Pure step from `mole.ts` to apply.
+ */
+async function changeWhack($: EngineInterface, change: (current: Whack) => Whack): Promise<void> {
+  let wasPlaying = false
+  let moleIdBefore = 0
+  const after = await update($, whack, current => {
+    if (current === null) return current
+    wasPlaying = current.status === 'playing'
+    moleIdBefore = current.moleId
+    return change(current)
+  })
+  if (after === null) return
+
+  if (after.status === 'playing' && after.moleId !== moleIdBefore) {
+    const moleId = after.moleId
+    $.clock.after(after.windowMs, () => void changeWhack($, current => escape(current, moleId)))
+  }
+
+  if (wasPlaying && after.status === 'over') {
+    const previous = await read($, whackBest)
+    const isBest = after.score > 0 && (previous === null || after.score > previous)
+    if (isBest) {
+      await update($, whackBest, () => after.score)
+      await $.store.set(WHACK_BEST_KEY, after.score)
+    }
+    $.ui.toast(`Game over: ${after.score} whacked${isBest ? ', a new high score' : ''}`)
+  }
+}
+
+/**
+ * Redraws the timer once a second while a Minesweeper game is on.
  *
  * @param $ - Engine handle the hook received, see `EngineInterface`.
  */
 async function tick($: EngineInterface): Promise<void> {
-  if ((await read($, game))?.status === 'playing') $.ui.invalidate('ui.render')
+  if ((await read($, view)) === 'mines' && (await read($, game))?.status === 'playing') $.ui.invalidate('ui.render')
 }
 
 let hintTurn: string | undefined
@@ -177,29 +165,39 @@ async function hint($: EngineInterface, turnId: string): Promise<void> {
   if (isHinted || hintTurn !== turnId) return
   if ((await $.ui.panes()).some(pane => pane.id === PANE)) return
   isHinted = true
-  $.ui.toast('Waiting on Claude? /mini-game opens Minesweeper.')
+  $.ui.toast('Waiting on Claude? /mini-game opens Minesweeper, /mini-game mole opens whack-a-mole.')
 }
 
 /**
  * Registers this mod's `mini-game` command, its session, turn and pane hooks.
  *
  * @param on - Hook registration function the engine passes in.
+ * @param options - Plugin options; `showInClaudeCode` opens the pane in the Claude Code chat at session start.
  */
-export const register: Register = on => {
+export const register: Register = (on, options) => {
   on('session.start', async ($, e, next) => {
-    await $.command.register({ name: 'mini-game', description: 'Play Minesweeper while Claude works' })
-    const stored = await $.store.get(BEST_KEY)
-    if (typeof stored === 'number') await update($, best, () => stored)
-    void $.ui.open({ id: PANE, title: TITLE })
+    await $.command.register({ name: 'mini-game', description: 'Play Minesweeper or whack-a-mole while Claude works' })
+    const storedBest = await $.store.get(BEST_KEY)
+    if (typeof storedBest === 'number') await update($, best, () => storedBest)
+    const storedWhackBest = await $.store.get(WHACK_BEST_KEY)
+    if (typeof storedWhackBest === 'number') await update($, whackBest, () => storedWhackBest)
+    if (options.showInClaudeCode === true) void openPane($)
     $.clock.every(1000, () => void tick($))
     return next(e)
   })
 
-  on('command.run', { command: 'mini-game' }, async $ => {
-    const current = await read($, game)
-    if (current === null || current.status === 'won' || current.status === 'lost') await startGame($)
-    else await $.ui.open({ id: PANE, title: TITLE })
-    return { text: 'Minesweeper is open. Clear the board without hitting a mine.' }
+  on('command.run', { command: 'mini-game' }, async ($, e) => {
+    const arg = e.args.trim().toLowerCase()
+    const next = arg === '' ? await read($, view) : VIEW_ARGS[arg]
+    if (next === undefined) return { text: `Unknown game "${arg}". Use /mini-game mines or /mini-game mole.`, exitCode: 1 }
+    await showView($, next)
+    // Typed in the chat, so the game shows there too.
+    await openPane($)
+    return {
+      text: next === 'mines'
+        ? 'Minesweeper is open. Clear the board without hitting a mine.'
+        : 'Whack-a-mole is open. Hit the mole before it hides; three misses and the round ends.',
+    }
   })
 
   on('turn.start', async ($, e, next) => {
@@ -216,66 +214,126 @@ export const register: Register = on => {
 
   on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
     const { Box, Text, Button } = $.ui.resolve(e)
-    const board = await read($, game)
-    if (board === null) {
-      return <Button key="new" label="new game" variant="primary" onPress={() => startGame($)} />
-    }
+    const current = await read($, view)
+
+    const tabs = (
+      <Box flexDirection="row" columnGap={1}>
+        {(Object.keys(TITLES) as View[]).map(v => (
+          <Button key={`view:${v}`} label={TITLES[v]} variant={v === current ? 'primary' : 'secondary'} onPress={() => showView($, v)} />
+        ))}
+      </Box>
+    )
 
-    const now = await $.clock.now()
-    const elapsed = board.status === 'ready' ? 0 : Math.round(((board.endedAt ?? now) - board.startedAt) / 1000)
-    const record = await read($, best)
-    const isOver = board.status === 'won' || board.status === 'lost'
+    // Every cell sits in a box of one fixed width, so changing a cell never moves the others: glyphs differ in width.
+    const grid = (size: number, face: (cell: number) => RenderChildren) => (
+      <Box flexDirection="column">
+        {Array.from({ length: size }, (_, r) => (
+          <Box flexDirection="row" columnGap={1}>
+            {Array.from({ length: size }, (_, c) => (
+              <Box width={CELL_WIDTH} flexShrink={0} justifyContent="center">{face(r * size + c)}</Box>
+            ))}
+          </Box>
+        ))}
+      </Box>
+    )
 
     /**
-     * Draws what a cell shows: a number, a flag, a mine, or a button that reveals or flags it.
+     * Draws whack-a-mole: lives, score and high score, and the holes, each a button while a round is on.
      *
-     * @param cell - Cell number to draw.
-     * @returns The cell's content.
+     * @param round - Game to draw, see `Whack`.
+     * @returns The status line, the controls and the holes.
      */
-    const cellFace = (cell: number) => {
-      const isRevealed = board.revealed.includes(cell)
-      const isMine = board.mines.includes(cell)
-      if (isRevealed || (isOver && isMine)) {
-        if (isMine) return <Text color="#e06c6c">✹</Text>
-        const n = adjacentMines(board, cell)
-        return <Text color={NUMBER_COLORS[n]}>{n === 0 ? ' ' : String(n)}</Text>
+    const moleView = async (round: Whack) => {
+      const record = await read($, whackBest)
+      const isPlaying = round.status === 'playing'
+
+      const holeFace = (hole: number) => {
+        if (!isPlaying) return <Text dimColor>○</Text>
+        return (
+          <Button key={`hole:${hole}`} plain onPress={() => changeWhack($, current => whackHole(current, hole))}>
+            {hole === round.mole ? <Text>🐹</Text> : <Text color="#6b7280">○</Text>}
+          </Button>
+        )
       }
-      const label = board.flagged.includes(cell) ? '⚑' : '■'
-      if (isOver) return <Text dimColor>{label}</Text>
+
+      const hearts = '♥'.repeat(round.lives) + '♡'.repeat(LIVES - round.lives)
+      const recordText = record === null ? '' : ` · best ${record}`
+      const status = round.status === 'over'
+        ? <Text color="#e06c6c" bold>Game over. {round.score} whacked{recordText}</Text>
+        : round.status === 'ready'
+          ? <Text dimColor>Hit the mole before it hides{recordText}</Text>
+          : <Text><Text color="#e06c6c">{hearts}</Text><Text dimColor> · {round.score} whacked{recordText}</Text></Text>
+
       return (
-        <Button key={`cell:${cell}`} plain onPress={() => pressCell($, cell)}>
-          <Text color={label === '⚑' ? '#e0775a' : '#6b7280'}>{label}</Text>
-        </Button>
+        <Box flexDirection="column" gap={1}>
+          <Box flexDirection="row" justifyContent="space-between" alignItems="center">
+            {status}
+            {isPlaying ? '' : <Button key="play" label={round.status === 'over' ? 'play again' : 'start'} variant="primary" onPress={() => changeWhack($, startWhack)} />}
+          </Box>
+          {grid(round.size, holeFace)}
+        </Box>
       )
     }
 
-    // Every cell sits in a box of one fixed width, so revealing a cell never moves the others: glyphs differ in width.
-    const cellView = (cell: number) => (
-      <Box width={CELL_WIDTH} flexShrink={0} justifyContent="center">{cellFace(cell)}</Box>
-    )
+    /**
+     * Draws the Minesweeper board: numbers, flags, mines, and buttons for hidden cells.
+     *
+     * @param board - Board to draw, see `Game`.
+     * @returns The status line, the controls and the board.
+     */
+    const minesView = async (board: Game) => {
+      const now = await $.clock.now()
+      const elapsed = board.status === 'ready' ? 0 : Math.round(((board.endedAt ?? now) - board.startedAt) / 1000)
+      const record = await read($, best)
+      const isOver = board.status === 'won' || board.status === 'lost'
 
-    const rows = Array.from({ length: board.size }, (_, r) => (
-      <Box flexDirection="row" columnGap={1}>
-        {Array.from({ length: board.size }, (_, c) => cellView(r * board.size + c))}
-      </Box>
-    ))
+      const cellFace = (cell: number) => {
+        const isRevealed = board.revealed.includes(cell)
+        const isMine = board.mines.includes(cell)
+        if (isRevealed || (isOver && isMine)) {
+          if (isMine) return <Text color="#e06c6c">✹</Text>
+          const n = adjacentMines(board, cell)
+          return <Text color={NUMBER_COLORS[n]}>{n === 0 ? ' ' : String(n)}</Text>
+        }
+        const label = board.flagged.includes(cell) ? '⚑' : '■'
+        if (isOver) return <Text dimColor>{label}</Text>
+        return (
+          <Button key={`cell:${cell}`} plain onPress={() => pressCell($, cell)}>
+            <Text color={label === '⚑' ? '#e0775a' : '#6b7280'}>{label}</Text>
+          </Button>
+        )
+      }
 
-    const status = board.status === 'won'
-      ? <Text color="#7cc47f" bold>Cleared in {elapsed}s</Text>
-      : board.status === 'lost'
-        ? <Text color="#e06c6c" bold>Boom. {board.revealed.length} cells cleared</Text>
-        : <Text dimColor>💣 {board.mineCount - board.flagged.length} · ⏱ {elapsed}s{record === null ? '' : ` · best ${record}s`}</Text>
+      const status = board.status === 'won'
+        ? <Text color="#7cc47f" bold>Cleared in {elapsed}s</Text>
+        : board.status === 'lost'
+          ? <Text color="#e06c6c" bold>Boom. {board.revealed.length} cells cleared</Text>
+          : <Text dimColor>💣 {board.mineCount - board.flagged.length} · ⏱ {elapsed}s{record === null ? '' : ` · best ${record}s`}</Text>
 
-    return (
-      <Box flexDirection="column" gap={1}>
-        <Box flexDirection="row" justifyContent="space-between" alignItems="center">
-          {status}
-          <Box flexDirection="row" columnGap={1}>
-            {isOver ? '' : <Button key="flag" label={board.isFlagMode ? '⚑ flagging' : '⚑ flag'} variant={board.isFlagMode ? 'primary' : 'secondary'} onPress={() => toggleFlagMode($)} />}
-            <Button key="new" label="new game" onPress={() => startGame($)} />
+      return (
+        <Box flexDirection="column" gap={1}>
+          <Box flexDirection="row" justifyContent="space-between" alignItems="center">
+            {status}
+            <Box flexDirection="row" columnGap={1}>
+              {isOver ? '' : <Button key="flag" label={board.isFlagMode ? '⚑ flagging' : '⚑ flag'} variant={board.isFlagMode ? 'primary' : 'secondary'} onPress={() => toggleFlagMode($)} />}
+              <Button key="new" label="new game" onPress={() => startGame($)} />
+            </Box>
           </Box>
+          {grid(board.size, cellFace)}
         </Box>
-        <Box flexDirection="column">{rows}</Box>
+      )
+    }
+
+    const board = await read($, game)
+    const round = await read($, whack)
+    const body = current === 'mole'
+      ? await moleView(round ?? newWhack())
+      : (board === null ? <Button key="new" label="new game" variant="primary" onPress={() => startGame($)} /> : await minesView(board))
+
+    return (
+      <Box flexDirection="column" gap={1}>
+        {tabs}
+        {body}
       </Box>
     )
   })

package/mods/mini-game/types/index.d.ts

@@ -14,8 +14,25 @@ export type Game = {
   endedAt?: number
 }
 
+/** A whack-a-mole game; holes are numbered row by row from 0. */
+export type Whack = {
+  size: number
+  /** Hole the mole is up in; `null` before the start and after the end */
+  mole: number | null
+  /** Counts the moles put up, so a timer knows whether its mole is still the one up */
+  moleId: number
+  score: number
+  lives: number
+  /** How long the current mole stays up; shrinks with each hit */
+  windowMs: number
+  status: 'ready' | 'playing' | 'over'
+}
+
+/** The game the pane shows. */
+export type View = 'mines' | 'mole'
+
 declare module 'claude-code' {
   interface PluginState {
-    'mini-game': { game: Game | null; best: number | null }
+    'mini-game': { view: View; game: Game | null; best: number | null; whack: Whack | null; whackBest: number | null }
   }
 }

package/mods/mini-game/view/panes.json

@@ -0,0 +1,8 @@
+{
+  "panes": [
+    {
+      "id": "mini-game",
+      "title": "Mini game"
+    }
+  ]
+}

package/mods/tool-timeline/.claude-plugin/plugin.json

@@ -5,5 +5,13 @@
   "author": {
     "name": "g3ntrovert"
   },
-  "types": "./types/index.d.ts"
+  "types": "./types/index.d.ts",
+  "userConfig": {
+    "showInClaudeCode": {
+      "type": "boolean",
+      "title": "Show in Claude Code",
+      "default": false,
+      "description": "Open this mod's pane in the Claude Code chat when a session starts. The mods viewer shows it either way."
+    }
+  }
 }

package/mods/tool-timeline/hooks/register.tsx

@@ -12,6 +12,19 @@ const selected = atom({ plugin: 'tool-timeline', key: 'selected' } as const, '')
 /** Calls kept in state; older ones fall off. */
 const KEEP = 100
 
+/** Prop the mods viewer adds to every pane it draws; the Claude Code extension draws on the `vscode` surface too, without it. */
+const VIEWER_PROP = 'g3nViewer'
+
+/**
+ * Tells whether the mods viewer asked for this drawing, rather than the Claude Code extension on the same surface.
+ *
+ * @param props - The `Pane` props of the `ui.render` argument.
+ * @returns `true` when the viewer's prop is set.
+ */
+function isViewer(props: object): boolean {
+  return (props as Readonly<Record<string, unknown>>)[VIEWER_PROP] === true
+}
+
 /** Approximate pixel width of one cell of the editor's code font. */
 const CELL_PX = 7
 
@@ -250,11 +263,12 @@ async function toggleSelected($: EngineInterface, id: string): Promise<void> {
  * @brief Subscribes the timeline's handlers to the engine's events, its command and its pane.
  *
  * @param on - Subscribes a handler to one engine event, optionally filtered.
+ * @param options - Plugin options; `showInClaudeCode` opens the pane in the Claude Code chat at session start.
  */
-export const register: Register = on => {
+export const register: Register = (on, options) => {
   on('session.start', async ($, e, next) => {
-    await $.command.register({ name: 'tool-timeline', description: 'Show or hide the tool call timeline' })
-    void $.ui.open({ id: PANE, title: TITLE })
+    await $.command.register({ name: 'tool-timeline', description: 'Show or hide the tool call timeline in the Claude Code chat' })
+    if (options.showInClaudeCode === true) void $.ui.open({ id: PANE, title: TITLE })
     $.clock.every(1000, () => void tick($))
     return next(e)
   })
@@ -329,7 +343,7 @@ export const register: Register = on => {
     const axis = placeCalls(shown, now)
 
     // The viewer draws the timeline with the mod's own view: hand it the calls as data.
-    if (e.surface === 'vscode') {
+    if (e.surface === 'vscode' && isViewer(e.props)) {
       const { Input } = $.ui.resolve(e)
       const spans = screenSpans(list, now)
       const data: TimelineViewData = {

package/mods/tool-timeline/view/panes.json

@@ -0,0 +1,8 @@
+{
+  "panes": [
+    {
+      "id": "tool-timeline",
+      "title": "Tool timeline"
+    }
+  ]
+}

package/mods/you-should-know/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "you-should-know",
   "version": "0.1.0",
-  "description": "A card under long replies that flags their key point: a headline and one supporting line.",
+  "description": "A compact card under a reply: the questions it asks you word for word, and for long replies what changed and what it concluded, each line tagged.",
   "author": {
     "name": "g3ntrovert"
   },
@@ -10,8 +10,8 @@
     "minChars": {
       "type": "number",
       "title": "Minimum reply length",
-      "default": 1500,
-      "description": "Replies shorter than this many characters get no card"
+      "default": 800,
+      "description": "Replies shorter than this many characters get no changes, conclusions or facts; their questions still show"
     },
     "model": {
       "type": "string",