feat: more : commands, grouped help, legible vim prompt

Adds :today, :next/:prev, :first/:last, :random, :clear, :reload, :copy,
:export, :stats and :theme, plus bangs on :w, :wq and :e. Every command now
declares a group so :help can lay them out under headings.

The help sheet flowed its columns wider than the sheet and clipped the
descriptions; it is newspaper columns now, and it lists the ! variants.

CodeMirror's base theme styles panels for a light editor with selectors the
app stylesheet cannot outrank, so the vim `:` prompt rendered black on black.
Those rules move into the editor's own theme, which does win, and the theme
declares itself dark so the light defaults stop applying at all.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01476ZKdB4k3rPDwvVhXcnDg

web/src/lib/commands.ts

@@ -1,5 +1,5 @@
 import { diary, type Theme } from './store.svelte'
-import { parseDay } from './util'
+import { formatDay, parseDay } from './util'
 
 /** Filled in by App.svelte so ex-commands can reach the DOM-bound bits. */
 export const hooks = {
@@ -10,10 +10,15 @@ export const hooks = {
   openCommandLine: (_initial: string) => {},
 }
 
+/** Help groups the command list under these headings, in this order. */
+export const groups = ['entries', 'editing', 'sharing', 'view'] as const
+export type Group = (typeof groups)[number]
+
 export interface CommandSpec {
   name: string
   aliases?: string[]
   args?: string
+  group: Group
   help: string
   run: (arg: string) => void | Promise<void>
   /** The forcing variant, `:name!` — vim hands the bang over as an argument. */
@@ -28,26 +33,61 @@ const requireOpen = () => {
   return diary.open
 }
 
+/** Move the cursor and follow it, so `:next` reads as well as `j` then `Enter`. */
+const jumpTo = async (index: number) => {
+  if (diary.entries.length === 0) return diary.say('no entries', 'error')
+  diary.cursor = Math.min(Math.max(index, 0), diary.entries.length - 1)
+  await diary.guard(() => diary.openSelected())
+}
+
+const themes: Theme[] = ['mocha', 'green', 'amber', 'ice']
+
+const setTheme = (name: string) => {
+  if (!themes.includes(name as Theme)) {
+    return diary.say(`unknown theme: ${name} — try ${themes.join(', ')}`, 'error')
+  }
+  diary.setTheme(name as Theme)
+  diary.say(`theme ${name}`)
+}
+
+/** A filename that survives a download folder: `2026-09-05-first-light.md`. */
+const exportName = (title: string, at: number) => {
+  const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '')
+  return `${formatDay(at)}${slug ? `-${slug}` : ''}.md`
+}
+
 export const commands: CommandSpec[] = [
   {
     name: 'write',
     aliases: ['w'],
+    group: 'editing',
     help: 'save the open entry',
     run: () => diary.guard(() => diary.save()),
+    bang: { help: 'same as :w — the bang is accepted out of habit', run: () => diary.guard(() => diary.save()) },
   },
   {
     name: 'wq',
     aliases: ['x'],
+    group: 'editing',
     help: 'save and leave insert/editor mode',
     run: async () => {
       await diary.guard(() => diary.save())
       diary.editing = false
       hooks.focusList()
     },
+    bang: {
+      help: 'same as :wq — the bang is accepted out of habit',
+      run: async () => {
+        await diary.guard(() => diary.save())
+        diary.editing = false
+        hooks.focusList()
+      },
+    },
   },
   {
     name: 'quit',
     aliases: ['q'],
+    group: 'editing',
     help: 'close the editor, or the entry when already reading',
     run: () => {
       if (diary.dirty) {
@@ -76,6 +116,7 @@ export const commands: CommandSpec[] = [
     name: 'new',
     aliases: ['n', 'o'],
     args: '[yyyy-mm-dd]',
+    group: 'entries',
     help: 'start a new entry, optionally dated',
     run: async (arg) => {
       await diary.guard(async () => {
@@ -91,10 +132,29 @@ export const commands: CommandSpec[] = [
       hooks.focusEditor()
     },
   },
+  {
+    name: 'today',
+    aliases: ['t'],
+    group: 'entries',
+    help: "open today's entry, starting one if there is none yet",
+    run: async () => {
+      await diary.guard(async () => {
+        if (diary.query) await diary.search('')
+        const midnight = new Date()
+        midnight.setHours(0, 0, 0, 0)
+        const from = Math.floor(midnight.getTime() / 1000)
+        const entry = diary.entries.find((e) => e.created_at >= from && e.created_at < from + 86400)
+        if (entry) await diary.openEntry(entry.id, true)
+        else await diary.createEntry()
+      })
+      hooks.focusEditor()
+    },
+  },
   {
     name: 'edit',
     aliases: ['e'],
     args: '[id]',
+    group: 'editing',
     help: 'edit the open entry, or open an entry by id',
     run: async (arg) => {
       const id = arg ? Number(arg) : diary.open?.id ?? diary.selected?.id
@@ -102,11 +162,54 @@ export const commands: CommandSpec[] = [
       await diary.guard(() => diary.openEntry(id, true))
       hooks.focusEditor()
     },
+    bang: {
+      help: 'throw away the draft and re-read the entry from the server',
+      run: async () => {
+        const open = requireOpen()
+        if (!open) return
+        diary.dirty = false
+        await diary.guard(() => diary.openEntry(open.id, diary.editing))
+        diary.say(`entry:${open.id} reloaded`)
+      },
+    },
+  },
+  {
+    name: 'next',
+    aliases: ['bn'],
+    group: 'entries',
+    help: 'open the next entry down the list',
+    run: () => jumpTo(diary.cursor + 1),
+  },
+  {
+    name: 'prev',
+    aliases: ['bp'],
+    group: 'entries',
+    help: 'open the previous entry',
+    run: () => jumpTo(diary.cursor - 1),
+  },
+  {
+    name: 'first',
+    group: 'entries',
+    help: 'open the newest entry',
+    run: () => jumpTo(0),
+  },
+  {
+    name: 'last',
+    group: 'entries',
+    help: 'open the oldest entry',
+    run: () => jumpTo(diary.entries.length - 1),
+  },
+  {
+    name: 'random',
+    group: 'entries',
+    help: 'open an entry at random — good for re-reading',
+    run: () => jumpTo(Math.floor(Math.random() * diary.entries.length)),
   },
   {
     name: 'delete',
     aliases: ['d', 'rm'],
     args: '[id]',
+    group: 'entries',
     help: 'delete an entry (asks first)',
     run: async (arg) => {
       const id = arg ? Number(arg) : diary.open?.id ?? diary.selected?.id
@@ -118,6 +221,7 @@ export const commands: CommandSpec[] = [
   {
     name: 'title',
     args: '<text>',
+    group: 'editing',
     help: 'set the title of the open entry',
     run: async (arg) => {
       if (!requireOpen()) return
@@ -129,6 +233,7 @@ export const commands: CommandSpec[] = [
   {
     name: 'date',
     args: '<yyyy-mm-dd>',
+    group: 'editing',
     help: 're-date the open entry',
     run: async (arg) => {
       if (!requireOpen()) return
@@ -141,6 +246,7 @@ export const commands: CommandSpec[] = [
   },
   {
     name: 'share',
+    group: 'sharing',
     help: 'publish the entry behind an unguessable link and copy it',
     run: async () => {
       const id = diary.open?.id ?? diary.selected?.id
@@ -152,6 +258,7 @@ export const commands: CommandSpec[] = [
   },
   {
     name: 'unshare',
+    group: 'sharing',
     help: 'revoke the share link',
     run: async () => {
       const id = diary.open?.id ?? diary.selected?.id
@@ -163,6 +270,7 @@ export const commands: CommandSpec[] = [
   },
   {
     name: 'link',
+    group: 'sharing',
     help: 'copy the share link of the current entry',
     run: async () => {
       const token = diary.open?.share_token ?? diary.selected?.share_token
@@ -171,14 +279,46 @@ export const commands: CommandSpec[] = [
       diary.say((await diary.copy(url)) ? `copied ${url}` : url)
     },
   },
+  {
+    name: 'copy',
+    aliases: ['yank'],
+    group: 'sharing',
+    help: 'copy the whole entry to the clipboard as markdown',
+    run: async () => {
+      if (!requireOpen()) return
+      const { title, body } = diary.draft
+      const text = title.trim() ? `# ${title.trim()}\n\n${body}` : body
+      diary.say((await diary.copy(text)) ? 'entry copied' : 'the clipboard said no', 'info')
+    },
+  },
+  {
+    name: 'export',
+    aliases: ['exp'],
+    group: 'sharing',
+    help: 'download the open entry as a .md file',
+    run: () => {
+      if (!requireOpen()) return
+      const { title, body, created_at } = diary.draft
+      const text = title.trim() ? `# ${title.trim()}\n\n${body}` : body
+      const url = URL.createObjectURL(new Blob([text], { type: 'text/markdown' }))
+      const anchor = document.createElement('a')
+      anchor.href = url
+      anchor.download = exportName(title.trim(), created_at)
+      anchor.click()
+      URL.revokeObjectURL(url)
+      diary.say(`wrote ${anchor.download}`)
+    },
+  },
   {
     name: 'upload',
     aliases: ['up'],
+    group: 'editing',
     help: 'pick files to attach at the cursor',
     run: () => hooks.pickFiles(),
   },
   {
     name: 'media',
+    group: 'editing',
     help: 'browse everything you have uploaded',
     run: () => diary.guard(async () => {
       await diary.loadMedia()
@@ -189,25 +329,64 @@ export const commands: CommandSpec[] = [
     name: 'search',
     aliases: ['se'],
     args: '[text]',
+    group: 'entries',
     help: 'full-text search (empty clears)',
     run: (arg) => diary.guard(() => diary.search(arg)),
   },
+  {
+    name: 'clear',
+    aliases: ['noh'],
+    group: 'entries',
+    help: 'clear the search filter',
+    run: () => diary.guard(() => diary.search('')),
+  },
+  {
+    name: 'reload',
+    aliases: ['r'],
+    group: 'entries',
+    help: 're-read the entry list from the server',
+    run: () =>
+      diary.guard(async () => {
+        await diary.refresh()
+        diary.say(`${diary.entries.length} entries`)
+      }),
+  },
+  {
+    name: 'stats',
+    group: 'view',
+    help: 'word, line and entry counts',
+    run: () => {
+      const body = diary.open ? diary.draft.body : ''
+      const words = body.split(/\s+/).filter(Boolean).length
+      const here = diary.open ? `entry:${diary.open.id} ${words}w ${body.split('\n').length}L · ` : ''
+      diary.say(`${here}${diary.entries.length} entries${diary.query ? ` matching "${diary.query}"` : ''}`)
+    },
+  },
+  {
+    name: 'theme',
+    args: '<mocha|green|amber|ice>',
+    group: 'view',
+    help: 'switch the colour scheme',
+    run: (arg) => setTheme(arg.trim() || diary.theme),
+  },
   {
     name: 'set',
     args: '<option>',
+    group: 'view',
     help: 'theme=mocha|green|amber|ice, vim, novim',
     run: (arg) => {
       const option = arg.trim()
       if (option === 'vim') return diary.setVim(true), diary.say('vim keys on')
       if (option === 'novim') return diary.setVim(false), diary.say('vim keys off')
-      const theme = /^theme=(mocha|green|amber|ice)$/.exec(option)?.[1]
-      if (theme) return diary.setTheme(theme as Theme), diary.say(`theme ${theme}`)
+      const theme = /^theme=(\w+)$/.exec(option)?.[1]
+      if (theme) return setTheme(theme)
       diary.say(`unknown option: ${option}`, 'error')
     },
   },
   {
     name: 'help',
     aliases: ['h'],
+    group: 'view',
     help: 'show the key and command reference',
     run: () => {
       diary.overlay = diary.overlay === 'help' ? 'none' : 'help'
@@ -215,6 +394,7 @@ export const commands: CommandSpec[] = [
   },
   {
     name: 'logout',
+    group: 'view',
     help: 'end the session',
     run: () => diary.guard(() => diary.logout()),
   },