claude-inbox 0.3.0 → 0.4.0

data/mod/tests/pane.test.tsx

@@ -0,0 +1,199 @@
+import type { On } from 'claude-code'
+import { expect, mock, test } from 'claude-code/testing'
+
+const PANE = {
+  plugin: 'inbox-pane',
+  component: 'Pane',
+  requestId: 'inbox',
+  props: { title: 'Inbox', isFocused: true, bodyColumns: 48, placement: 'dock', scroll: { offset: 0, bodyRows: 30 }, view: {} },
+  viewport: { columns: 160, rows: 40 },
+} as const
+
+const ROWS = [
+  { section: 'needs_you', id: 'a1', label: 'needs an answer', state: 'blocked', actionable: true, line: 'confirm: drop it?' },
+  { section: 'active', id: 'b2', label: 'still going', state: 'working', actionable: true, line: 'running bin/ci', pr: { short: '#7', state: 'open', url: 'https://github.com/o/r/pull/7' } },
+  { section: 'active', id: 'uuid-term', label: 'a terminal', state: 'working', actionable: false, isTerminal: true },
+  { section: 'settled', id: 'c3', label: 'put away', state: 'done', actionable: true },
+]
+
+// The op's result rides under `value`, so a seeded read is `{ value: { value, version } }`.
+const seeded = (value: unknown) => ({ value: { value, version: 1 } })
+
+// Answers what a session start asks of the engine, with a fresh snapshot so no headless
+// inbox starts, and records the panes it opens and the state it sets. `polled` settles
+// with the start's first poll.
+const startable = (on: On, sections: Record<string, unknown[]> = {}) => {
+  const opened: string[] = []
+  const set: Record<string, unknown> = {}
+  let done = () => {}
+  const polled = new Promise<void>(resolve => (done = resolve))
+  on('session.start', ($, e) => ({ cwd: e.cwd }))
+  on('command.register', () => ({ value: undefined }))
+  on('session.id', () => ({ value: 'u-test' }))
+  on('fs.read', () => ({ value: JSON.stringify({ written_at: 1_700_000_000, sections }) }))
+  on('state.set', async ($, e, next) => {
+    set[e.key] = e.value
+    const result = await next(e)
+    if (e.key === 'writtenAt') done()
+    return result
+  })
+  on('ui.open', ($, e) => {
+    opened.push(e.id)
+    return { value: { isPlaced: true } }
+  })
+  return { opened, polled, set }
+}
+
+test('without the gem the pane says so, on every surface that seats a pane', async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  for (const surface of ['terminal', 'desktop', 'vscode', 'mobile'] as const) {
+    const ui = await $.ui.mount({ ...PANE, surface })
+    expect(await ui.find({ type: 'Text', text: /claude-inbox is not running/ })).toBeDefined()
+    await ui.unmount()
+  }
+})
+
+test('a snapshot older than thirty seconds is called stale, just now before a minute', async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  on('state.get', ($, e, next) => (e.key === 'writtenAt' ? seeded(1_700_000_000 - 45) : next(e)))
+  const ui = await $.ui.mount({ ...PANE, surface: 'terminal' })
+  expect(await ui.find({ type: 'Text', text: /stopped just now; rows are stale/ })).toBeDefined()
+  await ui.unmount()
+})
+
+test("rows sit under the gem's sections, Settled folded until za opens it", async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  on('state.get', ($, e, next) => {
+    if (e.key === 'rows') return seeded(ROWS)
+    if (e.key === 'writtenAt') return seeded(1_700_000_000)
+    return next(e)
+  })
+  for (const surface of ['terminal', 'desktop'] as const) {
+    const ui = await $.ui.mount({ ...PANE, surface })
+    expect(await ui.find({ type: 'Text', text: /Needs you · 1/ })).toBeDefined()
+    expect(await ui.find({ type: 'Text', text: /Active · 2/ })).toBeDefined()
+    expect(await ui.find({ type: 'Text', text: /Settled · 1/ })).toBeDefined()
+    expect(await ui.find({ type: 'Text', text: /confirm: drop it\?/ })).toBeDefined()
+    expect(await ui.find({ type: 'Text', text: /#7 open/ })).toBeDefined()
+    expect(await ui.find({ type: 'Text', text: /1 folded/ })).toBeDefined()
+    expect(await ui.find({ type: 'Text', text: /put away/ })).toBeUndefined()
+    await ui.press({ key: 'g' })
+    await ui.press({ key: 'e' })
+    await ui.press({ key: 'z' })
+    expect(await ui.find({ type: 'Button', key: 'x' })).toBeUndefined()
+    await ui.press({ key: 'a' })
+    expect(await ui.find({ type: 'Text', text: /put away/ })).toBeDefined()
+    expect(await ui.find({ type: 'Button', key: 'x' })).toBeDefined()
+    await ui.press({ key: 'z' })
+    await ui.press({ key: 'c' })
+    expect(await ui.find({ type: 'Text', text: /put away/ })).toBeUndefined()
+    // Cursor and folds live in session state, so put them back for the next surface.
+    await ui.press({ key: 'g' })
+    await ui.press({ key: 'g' })
+    await ui.unmount()
+  }
+})
+
+test('the session the pane sits in leads the list under This session, with its own keys', async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  const [viewing, ...others] = ROWS
+  on('state.get', ($, e, next) => {
+    if (e.key === 'rows') return seeded(others)
+    if (e.key === 'current') return seeded(viewing)
+    if (e.key === 'writtenAt') return seeded(1_700_000_000)
+    return next(e)
+  })
+  const written: string[] = []
+  on('fs.write', ($, e) => {
+    written.push(e.path)
+    return { value: undefined }
+  })
+  const ui = await $.ui.mount({ ...PANE, surface: 'terminal' })
+  expect(await ui.find({ type: 'Text', text: /^This session$/ })).toBeDefined()
+  expect(await ui.find({ type: 'Text', text: /needs an answer/ })).toBeDefined()
+  expect(await ui.find({ type: 'Text', text: /Needs you/ })).toBeUndefined()
+  await ui.press({ key: 'row:a1' })
+  expect(written).toEqual([])
+  await ui.press({ key: 'x' })
+  expect(written).toEqual(['/Users/me/.config/claude-inbox/actions/pane-1700000000000.json'])
+  await ui.unmount()
+})
+
+test('a poll lifts the row whose session is this one out of the list', async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  const { polled, set } = startable(on, {
+    needs_you: [{ id: 'a1', session: 'u-test', label: 'mine' }],
+    active: [{ id: 'b2', session: 'u-b2', label: 'other' }],
+  })
+  await $.session.start({ cwd: '/tmp/proj', surface: 'terminal', isInteractive: true })
+  await polled
+  expect((set.current as { id?: string } | null)?.id).toBe('a1')
+  expect((set.rows as { id?: string }[]).map(row => row.id)).toEqual(['b2'])
+})
+
+test('x leaves a settle request for the inbox to apply', async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  on('state.get', ($, e, next) => (e.key === 'rows' ? seeded(ROWS) : e.key === 'writtenAt' ? seeded(1_700_000_000) : next(e)))
+  const written: { path: string; text: string }[] = []
+  on('fs.write', ($, e) => {
+    written.push({ path: e.path, text: e.text })
+    return { value: undefined }
+  })
+  const ui = await $.ui.mount({ ...PANE, surface: 'terminal' })
+  await ui.press({ key: 'x' })
+  expect(written.length).toBe(1)
+  expect(written[0]?.path).toBe('/Users/me/.config/claude-inbox/actions/pane-1700000000000.json')
+  expect(JSON.parse(written[0]?.text ?? '{}')).toEqual({ action: 'settle', id: 'a1', at: 1_700_000_000_000 })
+  await ui.unmount()
+})
+
+test('Enter asks the attached inbox for the row, naming this session, and refuses a terminal', async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  on('state.get', ($, e, next) => (e.key === 'rows' ? seeded(ROWS) : e.key === 'writtenAt' ? seeded(1_700_000_000) : next(e)))
+  const written: { path: string; text: string }[] = []
+  on('fs.write', ($, e) => {
+    written.push({ path: e.path, text: e.text })
+    return { value: undefined }
+  })
+  const ui = await $.ui.mount({ ...PANE, surface: 'terminal' })
+  await ui.press({ key: 'row:uuid-term' })
+  expect(written.length).toBe(0)
+  await ui.press({ key: 'row:b2' })
+  expect(written.length).toBe(1)
+  expect(written[0]?.path).toBe('/Users/me/.config/claude-inbox/switch.json')
+  expect(JSON.parse(written[0]?.text ?? '{}')).toEqual({ id: 'b2', from: 'pane', at: 1_700_000_000 })
+  await ui.unmount()
+})
+
+test('an unfocused pane says how to focus it', async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  const ui = await $.ui.mount({ ...PANE, surface: 'terminal', props: { ...PANE.props, isFocused: false } })
+  expect(await ui.find({ type: 'Text', text: /takes you here/ })).toBeDefined()
+  await ui.unmount()
+})
+
+test('the pane opens when a session starts', async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  const { opened, polled } = startable(on)
+  await $.session.start({ cwd: '/tmp/proj', surface: 'terminal', isInteractive: true })
+  await polled
+  expect(opened).toEqual(['inbox'])
+})
+
+test('with openOnStart off only /inbox opens it', { options: { openOnStart: false } }, async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  const { opened, polled } = startable(on)
+  await $.session.start({ cwd: '/tmp/proj', surface: 'terminal', isInteractive: true })
+  await polled
+  expect(opened).toEqual([])
+})

data/mod/tests/snapshot.fixture.ts

@@ -0,0 +1,47 @@
+// What the gem's Snapshot writes for three sessions, a blocked one, a working one
+// with an open pull request and a hand-settled one. The gem's spec/mod_spec.rb
+// writes the same sessions through Snapshot and compares them to this text, so a
+// key renamed on either side fails a test on both.
+export const SNAPSHOT = `{
+  "version": 1,
+  "written_at": 1789600000,
+  "sections": {
+    "pinned": [],
+    "needs_you": [
+      {
+        "id": "a1",
+        "session": "u-a1",
+        "label": "needs an answer",
+        "state": "blocked",
+        "actionable": true,
+        "cwd": "/tmp/proj"
+      }
+    ],
+    "active": [
+      {
+        "id": "b2",
+        "session": "u-b2",
+        "label": "still going",
+        "state": "working",
+        "actionable": true,
+        "cwd": "/tmp/proj",
+        "pr": {
+          "short": "#7",
+          "state": "open",
+          "url": "https://github.com/o/r/pull/7"
+        }
+      }
+    ],
+    "snoozed": [],
+    "settled": [
+      {
+        "id": "c3",
+        "session": "u-c3",
+        "label": "put away",
+        "state": "done",
+        "actionable": true,
+        "cwd": "/tmp/proj"
+      }
+    ]
+  }
+}`

data/mod/tests/snooze.test.tsx

@@ -0,0 +1,31 @@
+import { expect, mock, test } from 'claude-code/testing'
+
+const PANE = {
+  plugin: 'inbox-pane',
+  component: 'Pane',
+  requestId: 'inbox',
+  props: { title: 'Inbox', isFocused: true, bodyColumns: 48, placement: 'dock', scroll: { offset: 0, bodyRows: 30 }, view: {} },
+  viewport: { columns: 160, rows: 40 },
+} as const
+const ROWS = [{ section: 'needs_you', id: 'a1', label: 'needs an answer', state: 'blocked', actionable: true, line: 'confirm: drop it?' }]
+const seeded = (value: unknown) => ({ value: { value, version: 1 } })
+
+test('s then 1 leaves a fifteen-minute snooze request', async ($, on) => {
+  mock.env(on, { HOME: '/Users/me' })
+  mock.clock(on, { now: 1_700_000_000_000 })
+  on('state.get', ($, e, next) => (e.key === 'rows' ? seeded(ROWS) : e.key === 'writtenAt' ? seeded(1_700_000_000) : next(e)))
+  const written: string[] = []
+  on('fs.write', ($, e) => {
+    written.push(e.text)
+    return { value: undefined }
+  })
+  const ui = await $.ui.mount({ ...PANE, surface: 'terminal' })
+  expect(await ui.find({ type: 'Button', key: '1' })).toBeUndefined()
+  await ui.press({ key: 's' })
+  expect(await ui.find({ type: 'Button', key: '1' })).toBeDefined()
+  expect(await ui.find({ type: 'Text', text: /15 minutes/ })).toBeDefined()
+  await ui.press({ key: '1' })
+  expect(written.length).toBe(1)
+  expect(JSON.parse(written[0] ?? '{}')).toEqual({ action: 'snooze', id: 'a1', choice: 'm15', at: 1_700_000_000_000 })
+  await ui.unmount()
+})

data/mod/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "./.claude-plugin/types/tsconfig.json"
+}

data/mod/types/index.d.ts

@@ -0,0 +1,30 @@
+export type Section = 'pinned' | 'needs_you' | 'active' | 'snoozed' | 'settled'
+
+// One row of the gem's snapshot.json, as its Snapshot class writes it.
+export type InboxRow = {
+  section: Section
+  id?: string
+  // The daemon's sessionId, the name $.session.id() gives the session the pane sits in.
+  session?: string
+  label: string
+  state: string
+  actionable: boolean
+  isWaiting: boolean
+  isTerminal: boolean
+  cwd?: string
+  line?: string
+  wakeAt?: number | 'until_woken'
+  remote?: string
+  pr?: { short: string; state: string; url: string }
+}
+
+export type Folds = { snoozed: boolean; settled: boolean }
+
+// The first key of a chord (g, z, s) waiting for its second; null between chords.
+export type Pending = 'g' | 'z' | 's' | null
+
+declare module 'claude-code' {
+  interface PluginState {
+    'inbox-pane': { rows: InboxRow[]; current: InboxRow | null; writtenAt: number; cursor: number; folds: Folds; pending: Pending }
+  }
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude-inbox
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Jordan Byron
@@ -105,15 +105,18 @@ files:
 - README.md
 - exe/claude-inbox
 - lib/claude_inbox.rb
+- lib/claude_inbox/actions.rb
 - lib/claude_inbox/agents_client.rb
 - lib/claude_inbox/app.rb
 - lib/claude_inbox/config.rb
 - lib/claude_inbox/debug.rb
 - lib/claude_inbox/dialog.rb
+- lib/claude_inbox/headless.rb
 - lib/claude_inbox/images.rb
 - lib/claude_inbox/job_state.rb
 - lib/claude_inbox/keymap.rb
 - lib/claude_inbox/logs.rb
+- lib/claude_inbox/mod.rb
 - lib/claude_inbox/mouse.rb
 - lib/claude_inbox/new_session_form.rb
 - lib/claude_inbox/painter.rb
@@ -140,18 +143,30 @@ files:
 - lib/claude_inbox/sessions.rb
 - lib/claude_inbox/settings.rb
 - lib/claude_inbox/slash_commands.rb
+- lib/claude_inbox/snapshot.rb
 - lib/claude_inbox/store.rb
 - lib/claude_inbox/store/entry.rb
 - lib/claude_inbox/store/row.rb
 - lib/claude_inbox/store/sections.rb
 - lib/claude_inbox/store/selection.rb
 - lib/claude_inbox/subprocess.rb
+- lib/claude_inbox/switch.rb
 - lib/claude_inbox/terminal.rb
 - lib/claude_inbox/text.rb
 - lib/claude_inbox/text_buffer.rb
 - lib/claude_inbox/theme.rb
 - lib/claude_inbox/trust.rb
 - lib/claude_inbox/vt_screen.rb
+- lib/claude_inbox/writer_lock.rb
+- mod/.claude-plugin/plugin.json
+- mod/hooks/hooks.json
+- mod/hooks/register.tsx
+- mod/tests/contract.test.tsx
+- mod/tests/pane.test.tsx
+- mod/tests/snapshot.fixture.ts
+- mod/tests/snooze.test.tsx
+- mod/tsconfig.json
+- mod/types/index.d.ts
 homepage: https://github.com/jordanbyron/claude-inbox
 licenses:
 - MIT