@g3nomaly/g3n-mods 0.1.3 → 0.1.5

package/mods/focus-mode/hooks/register.tsx

@@ -8,8 +8,17 @@ const PANE = 'focus-mode'
 const TITLE = 'Focus'
 const block = atom({ plugin: 'focus-mode', key: 'block' } as const, null)
 const finished = atom({ plugin: 'focus-mode', key: 'finished' } as const, 0)
+const length = atom({ plugin: 'focus-mode', key: 'length' } as const, 0)
 
 const DEFAULT_MINUTES = 25
+
+/** Minutes the pane's − and + buttons move the block length by, and its bounds. */
+const STEP_MINUTES = 5
+const MIN_MINUTES = 5
+const MAX_MINUTES = 240
+
+/** Key in the plugin's store that remembers the chosen block length between sessions. */
+const LENGTH_KEY = 'minutes'
 const MAX_SQUARES = 30
 const FILLED = '#e6b450'
 const EMPTY = '#3a3f4b'
@@ -59,6 +68,18 @@ function squaresSvg(count: number, filled: number): string {
   return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${size}" viewBox="0 0 ${width} ${size}">${rects.join('')}</svg>`
 }
 
+/**
+ * Sets the block length the pane's start button uses, for this session and later ones.
+ *
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
+ * @param minutes - New length in minutes, kept within `MIN_MINUTES` and `MAX_MINUTES`.
+ */
+async function setLength($: EngineInterface, minutes: number): Promise<void> {
+  const kept = Math.min(MAX_MINUTES, Math.max(MIN_MINUTES, Math.round(minutes)))
+  await update($, length, () => kept)
+  await $.store.set(LENGTH_KEY, kept)
+}
+
 /**
  * Starts a block of `minutes`, replacing one already running, and shows the pane.
  *
@@ -107,7 +128,20 @@ async function tick($: EngineInterface): Promise<void> {
 }
 
 /**
- * Registers this mod's `focus-mode` command, its session hook, its tick, and its pane.
+ * Finds the running block, if any: while one runs the person is away from the keyboard.
+ *
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
+ * @returns The block, or `null` when none runs or its time is up.
+ */
+async function awayBlock($: EngineInterface): Promise<FocusBlock | null> {
+  const current = await read($, block)
+  if (current === null) return null
+  return (await $.clock.now()) < current.endsAt ? current : null
+}
+
+/**
+ * Registers this mod's `focus-mode` command, its session hook, its tick, its pane, and the hooks that keep Claude
+ * from asking anything during a block: questions are refused, and so are permission prompts.
  *
  * @param on - Hook registration function the engine passes in.
  * @param options - Plugin options; `minutes` sets the default block length.
@@ -117,9 +151,11 @@ export const register: Register = (on, options) => {
   const defaultMinutes = Number.isFinite(configured) && configured > 0 ? configured : DEFAULT_MINUTES
 
   on('session.start', async ($, e, next) => {
+    const remembered = Number(await $.store.get(LENGTH_KEY).catch(() => undefined))
+    await update($, length, () => (Number.isFinite(remembered) && remembered > 0 ? remembered : defaultMinutes))
     await $.command.register({
       name: 'focus-mode',
-      description: `Start a focus block (${defaultMinutes} min by default), or end the running one`,
+      description: 'Start a focus block in which Claude asks you nothing (the length you set, or the minutes given), or end the running one',
       argumentHint: '[minutes] | end',
     })
     void $.ui.open({ id: PANE, title: TITLE })
@@ -133,24 +169,52 @@ export const register: Register = (on, options) => {
       await endFocus($, false)
       return { text: 'Focus block ended.' }
     }
-    const minutes = arg === '' ? defaultMinutes : Number(arg)
+    const chosen = (await read($, length)) || defaultMinutes
+    const minutes = arg === '' ? chosen : Number(arg)
     if (!Number.isFinite(minutes) || minutes <= 0 || minutes > 600) {
       return { text: `"${arg}" is not a number of minutes. Use /focus-mode 25, or /focus-mode end.` }
     }
+    // A length typed with the command becomes the one the pane starts with next time.
+    if (arg !== '') await setLength($, minutes)
     await startFocus($, minutes)
     return { text: `Focus block started: ${minutes} min.` }
   })
 
+  // While a block runs the person is away: a question Claude puts to them is refused, so Claude decides on its own.
+  on('tool.call', { tool: 'AskUserQuestion' }, async ($, e, next) => {
+    const away = await awayBlock($)
+    if (away === null) return next(e)
+    return { deny: `The user is in a focus block until ${wallTime(away.endsAt)} and cannot answer. Pick the option you would recommend, say in your reply what you assumed, and carry on.` }
+  }).catch(($, e, next) => next(e))
+
+  // A permission prompt would wait for the person too: refuse it, so Claude works around the step or leaves it for later.
+  on('classic.PermissionRequest', async ($, e, next) => {
+    const away = await awayBlock($)
+    if (away === null) return next(e)
+    return {
+      decision: {
+        behavior: 'deny',
+        message: `The user is in a focus block until ${wallTime(away.endsAt)} and cannot approve ${e.tool_name}. Do what you can without it, and list this step at the end of your reply for the user to approve later.`,
+      },
+    }
+  }).catch(($, e, next) => next(e))
+
   on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
     const { Box, Text, Button } = $.ui.resolve(e)
     const current = await read($, block)
 
     if (current === null) {
       const done = await read($, finished)
+      const minutes = (await read($, length)) || defaultMinutes
       return (
-        <Box flexDirection="row" justifyContent="space-between" alignItems="center">
-          <Text dimColor>{done > 0 ? `${done} focus block${done === 1 ? '' : 's'} done this session.` : 'No focus block running.'}</Text>
-          <Button key="start" label={`start ${defaultMinutes} min`} variant="primary" onPress={() => startFocus($, defaultMinutes)} />
+        <Box flexDirection="row" justifyContent="space-between" alignItems="center" columnGap={2}>
+          <Text dimColor wrap="truncate-end">{done > 0 ? `${done} focus block${done === 1 ? '' : 's'} done this session.` : 'No focus block running.'}</Text>
+          <Box flexDirection="row" alignItems="center" columnGap={1}>
+            <Button key="shorter" label="−" onPress={() => setLength($, minutes - STEP_MINUTES)} />
+            <Text bold>{minutes} min</Text>
+            <Button key="longer" label="+" onPress={() => setLength($, minutes + STEP_MINUTES)} />
+            <Button key="start" label="start" variant="primary" onPress={() => startFocus($, minutes)} />
+          </Box>
         </Box>
       )
     }
@@ -176,7 +240,7 @@ export const register: Register = (on, options) => {
         <Text bold>{clock(remaining)}</Text>
         <Box flexDirection="column" flexGrow={1} gap={0}>
           {squares}
-          <Text dimColor>focus block · {current.minutes} min · ends {wallTime(current.endsAt)}</Text>
+          <Text dimColor>away until {wallTime(current.endsAt)} · Claude asks you nothing</Text>
         </Box>
         <Button key="end" label="end focus" onPress={() => endFocus($, false)} />
       </Box>

package/mods/focus-mode/types/index.d.ts

@@ -9,6 +9,6 @@ export type FocusBlock = {
 
 declare module 'claude-code' {
   interface PluginState {
-    'focus-mode': { block: FocusBlock | null; finished: number }
+    'focus-mode': { block: FocusBlock | null; finished: number; length: number }
   }
 }

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

@@ -14,6 +14,9 @@ const MINES = 10
 const BEST_KEY = 'best-seconds'
 /** 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. */
+const CELL_WIDTH = 2
+
 const NUMBER_COLORS = [undefined, '#6b8fd6', '#7cc47f', '#e06c6c', '#9b87f5', '#e0775a', '#5fb3c4', '#d0d0d0', '#8a8f98']
 
 /**
@@ -224,21 +227,21 @@ export const register: Register = on => {
     const isOver = board.status === 'won' || board.status === 'lost'
 
     /**
-     * Draws one cell: a number, a flag, a mine, or a button that reveals or flags it.
+     * Draws what a cell shows: a number, a flag, a mine, or a button that reveals or flags it.
      *
      * @param cell - Cell number to draw.
-     * @returns The cell element.
+     * @returns The cell's content.
      */
-    const cellView = (cell: number) => {
+    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>
+        if (isMine) return <Text color="#e06c6c">✹</Text>
         const n = adjacentMines(board, cell)
-        return <Text color={NUMBER_COLORS[n]}>{n === 0 ? '  ' : `${n} `}</Text>
+        return <Text color={NUMBER_COLORS[n]}>{n === 0 ? ' ' : String(n)}</Text>
       }
       const label = board.flagged.includes(cell) ? '⚑' : '■'
-      if (isOver) return <Text dimColor>{label} </Text>
+      if (isOver) return <Text dimColor>{label}</Text>
       return (
         <Button key={`cell:${cell}`} plain onPress={() => pressCell($, cell)}>
           <Text color={label === '⚑' ? '#e0775a' : '#6b7280'}>{label}</Text>
@@ -246,6 +249,11 @@ export const register: Register = on => {
       )
     }
 
+    // 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>
+    )
+
     const rows = Array.from({ length: board.size }, (_, r) => (
       <Box flexDirection="row" columnGap={1}>
         {Array.from({ length: board.size }, (_, c) => cellView(r * board.size + c))}

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

@@ -37,6 +37,9 @@ const IDLE_MS = 200
 /** Most characters of a call's input the hover card keeps. */
 const DETAIL_MAX = 2000
 
+/** Most characters of a call's label kept; the pane cuts it to one line anyway. */
+const LABEL_MAX = 200
+
 /** Input fields that say most about a call, tried in order. */
 const LABEL_FIELDS = ['command', 'file_path', 'notebook_path', 'pattern', 'url', 'query', 'description', 'skill', 'prompt'] as const
 
@@ -62,10 +65,10 @@ export function labelOf(input: Record<string, unknown>): string {
     const value = input[field]
     if (typeof value !== 'string' || value.length === 0) continue
     const text = field === 'file_path' || field === 'notebook_path' ? value.split('/').pop() ?? value : value
-    return text.replace(/\s+/g, ' ').trim()
+    return text.replace(/\s+/g, ' ').trim().slice(0, LABEL_MAX)
   }
   const first = Object.values(input).find((value): value is string => typeof value === 'string')
-  return first?.replace(/\s+/g, ' ').trim() ?? ''
+  return first?.replace(/\s+/g, ' ').trim().slice(0, LABEL_MAX) ?? ''
 }
 
 /**
@@ -331,7 +334,7 @@ export const register: Register = on => {
     // One line per call; the keyed row reveals a card with the call's whole input while the pointer is on it.
     const rows = shown.map((call, index) => (
       <Box key={call.id} flexDirection="row" columnGap={1}>
-        <Text bold color={CARD} backgroundColor={colorOf(call.tool)}> {badgeOf(call.tool)} </Text>
+        <Text bold color={CARD} backgroundColor={colorOf(call.tool)}>{e.surface === 'terminal' ? ` ${badgeOf(call.tool)} ` : badgeOf(call.tool)}</Text>
         <Box width={labelCells}>
           <Text wrap="truncate-end" strikethrough={call.status === 'denied'} color={call.status === 'denied' ? ERROR : undefined}>
             {call.agentId === undefined ? '' : '↳ '}{call.tool} <Text dimColor>{call.label}</Text>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@g3nomaly/g3n-mods",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "The g3n Claude Code mods: panes, status lines, commands and hooks, installed with @g3nomaly/mods.",
   "type": "module",
   "files": [
@@ -15,7 +15,7 @@
     "types": "bun scripts/sync-types.ts"
   },
   "devDependencies": {
-    "@g3nomaly/core": "^0.3.1",
+    "@g3nomaly/core": "^0.3.3",
     "@types/bun": "^1.4.0",
     "typescript": "~7.0.2",
     "zod": "^4.4.3"

package/mods/delete-guard/hooks/register.ts

@@ -1,151 +0,0 @@
-// packages/g3n-mods/mods/delete-guard/hooks/register.ts
-import { atom, read, update } from 'claude-code'
-import type { EngineInterface, Register } from 'claude-code'
-
-import type { Deletion } from '../types'
-
-const isOff = atom({ plugin: 'delete-guard', key: 'isOff' } as const, false)
-
-/** Shell syntax that starts a new command: `&&`, `||`, `;`, `|`, a newline, `$(` and a backtick. */
-const SEGMENT_BREAK = /&&|\|\||;|\||\n|\$\(|`/
-
-/** Words that run the command after them: `sudo rm`, `xargs -0 rm`, `env X=1 rm`. */
-const PREFIX = /^(?:\w+=\S*\s+|(?:sudo|command|exec|nice|nohup|time|env)\s+(?:-\S+\s+)*|xargs\s+(?:-\S+\s+)*)+/
-
-const DELETERS = new Set(['rm', 'shred', 'unlink', 'rimraf', 'srm'])
-
-/** Trash commands in order of preference, with how each one is spelled. */
-const TRASH_COMMANDS = [
-  { probe: 'trash', spell: 'trash' },
-  { probe: 'trash-put', spell: 'trash-put' },
-  { probe: 'gio', spell: 'gio trash' },
-] as const
-
-/**
- * Splits a shell command line into its commands, each trimmed.
- *
- * @param command - Shell command line, e.g. `cd build && rm -rf dist`.
- * @returns The non-empty commands in order.
- */
-function segments(command: string): string[] {
-  return command.split(SEGMENT_BREAK).map(part => part.trim()).filter(part => part.length > 0)
-}
-
-/**
- * Splits one command into words, dropping its prefixes and the program's directory.
- *
- * @param segment - One command, as `segments` returns it.
- * @returns The program name first, then its arguments.
- */
-function words(segment: string): string[] {
-  const [program = '', ...rest] = segment.replace(PREFIX, '').split(/\s+/)
-  return [program.split('/').pop() ?? program, ...rest]
-}
-
-/**
- * Picks the operands of a command: every word that is not a flag, and every word after `--`.
- *
- * @param args - Words after the program name.
- * @returns The operands in order.
- */
-function operands(args: readonly string[]): string[] {
-  const end = args.indexOf('--')
-  const flagged = end === -1 ? args : args.slice(0, end)
-  const after = end === -1 ? [] : args.slice(end + 1)
-  return [...flagged.filter(arg => !arg.startsWith('-')), ...after]
-}
-
-/**
- * @brief Finds the first permanent delete in a shell command line.
- *
- * Recognises `rm`, `shred`, `unlink`, `rimraf`, `find -delete`, `find -exec rm`
- * and a forced `git clean`.
- *
- * @param command - Full shell command line, as the Bash tool received it.
- * @returns The delete and what it removes, or `undefined` when nothing is deleted for good.
- */
-export function findDeletion(command: string): Deletion | undefined {
-  for (const segment of segments(command)) {
-    const [program = '', ...args] = words(segment)
-    if (DELETERS.has(program)) {
-      return { segment, kind: 'files', paths: operands(args) }
-    }
-    if (program === 'find' && (args.includes('-delete') || /-exec(?:dir)?\s+(?:\S*\/)?rm\b/.test(segment))) {
-      return { segment, kind: 'find', paths: [] }
-    }
-    if (program === 'git' && args[0] === 'clean' && args.some(arg => /^-\w*f/.test(arg) || arg === '--force')) {
-      return { segment, kind: 'git-clean', paths: [] }
-    }
-  }
-  return undefined
-}
-
-/**
- * Builds the command Claude should run instead of a permanent delete.
- *
- * @param deletion - Delete to replace, see `Deletion`.
- * @param trash - Trash command spelled as this machine has it, e.g. `gio trash`.
- * @returns The suggested command, with `<paths>` where no path was named.
- */
-function insteadOf(deletion: Deletion, trash: string): string {
-  switch (deletion.kind) {
-    case 'files':
-      return deletion.paths.length > 0 ? `${trash} ${deletion.paths.join(' ')}` : `${trash} <paths>`
-    case 'find':
-      return `${deletion.segment.replace(/\s-delete\b/, '').replace(/-exec(?:dir)?\s+.*$/, '')} -exec ${trash} {} +`.replace(/\s+/g, ' ')
-    case 'git-clean':
-      return `git clean -n to list the files, then ${trash} <paths>`
-  }
-}
-
-/**
- * Finds the first trash command on this machine's PATH.
- *
- * @param $ - Engine handle the hook received, see `EngineInterface`.
- * @returns The command as it should be spelled, or `undefined` when none is installed.
- */
-async function detectTrash($: EngineInterface): Promise<string | undefined> {
-  for (const candidate of TRASH_COMMANDS) {
-    const found = await $.process.run(['sh', '-c', `command -v ${candidate.probe}`]).catch(() => undefined)
-    if (found?.exitCode === 0) return candidate.spell
-  }
-  return undefined
-}
-
-/**
- * Registers this mod's `delete-guard` command, its session hook, and its Bash tool hook.
- *
- * @param on - Hook registration function the engine passes in.
- */
-export const register: Register = on => {
-  let trash: string | undefined
-
-  on('session.start', async ($, e, next) => {
-    trash = await detectTrash($)
-    await $.command.register({
-      name: 'delete-guard',
-      description: 'Turn the permanent-delete guard on or off for this session',
-      argumentHint: 'on | off',
-    })
-    return next(e)
-  })
-
-  on('command.run', { command: 'delete-guard' }, async ($, e) => {
-    const wanted = e.args.trim()
-    if (wanted === 'on' || wanted === 'off') await update($, isOff, () => wanted === 'off')
-    const off = await read($, isOff)
-    return { text: `delete-guard is ${off ? 'off: permanent deletes run' : 'on: permanent deletes are denied'}.` }
-  })
-
-  on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
-    if (await read($, isOff)) return next(e)
-    const deletion = findDeletion(e.command)
-    if (deletion === undefined) return next(e)
-
-    const spelled = trash ?? 'trash'
-    const install = trash === undefined ? ' (install trash-cli: sudo apt install trash-cli)' : ''
-    return {
-      deny: `delete-guard: \`${deletion.segment}\` deletes permanently. Move it to the trash instead: \`${insteadOf(deletion, spelled)}\`${install}.`,
-    }
-  }).catch(($, e, next) => (next.called ? next(e) : { deny: 'delete-guard: the guard failed, so the command was not run.' }))
-}