pinboard

1import { atom, update } from 'claude-code'
2import type { EngineInterface, Register } from 'claude-code'
3
4import type { Pin } from '../types'
5
6// plan-board 패널이 .claude/pinboard.md 를 읽어 핀을 보여준다. 프롬프트 위 영역은 usage-hud 가 쓴다.
7const pins = atom({ plugin: 'pinboard', key: 'pins' } as const, [])
8const LINE = /^- \[(결정|할일)\] (\d{4}-\d{2}-\d{2}) (.+)$/
9const HEAD = '# Pinboard\n\n/pin, /unpin 으로 관리한다. 한 줄에 핀 하나.\n\n'
10
11const RULES = `# Pinboard
12- 아래 핀은 사용자가 고정한 결정 사항과 진행 중인 할 일이다. 요청이 핀의 결정과 충돌하면 진행하기 전에 해당 핀을 인용해 알린다.
13- 사용자가 무언가를 확정하면("이걸로 가자", "결정" 등) \`/pin <내용>\`으로 기록할지 한 줄로 제안한다. 핀 파일을 직접 고치지 않는다.`
14
15export const parse = (text: string): Pin[] =>
16  text.split('\n').flatMap(line => {
17    const found = LINE.exec(line.trim())
18
19    return found === null
20      ? []
21      : [{ kind: found[1] as Pin['kind'], date: found[2] ?? '', text: found[3] ?? '' }]
22  })
23
24export const format = (list: readonly Pin[]): string =>
25  HEAD + list.map(pin => `- [${pin.kind}] ${pin.date} ${pin.text}`).join('\n') + '\n'
26
27const file = async ($: EngineInterface) => `${await $.session.root()}/.claude/pinboard.md`
28
29const load = async ($: EngineInterface): Promise<Pin[]> => {
30  try {
31    return parse(await $.fs.read(await file($)))
32  } catch {
33    return []
34  }
35}
36
37const save = async ($: EngineInterface, list: Pin[]) => {
38  await $.fs.write(await file($), format(list))
39  await update($, pins, () => list)
40}
41
42// 한국 시간 기준 날짜
43const today = async ($: EngineInterface) =>
44  new Date((await $.clock.now()) + 9 * 3_600_000).toISOString().slice(0, 10)
45
46const listing = (list: readonly Pin[]) =>
47  list.map((pin, i) => `${i + 1}. [${pin.kind}] ${pin.text} (${pin.date})`).join('\n')
48
49export const register: Register = on => {
50  on('session.start', async ($, e, next) => {
51    await $.command.register({
52      name: 'pin',
53      description: '결정 사항을 고정한다. "할일:"로 시작하면 진행 중 할 일로 고정',
54      argumentHint: '[할일:] <내용>',
55    })
56    await $.command.register({
57      name: 'unpin',
58      description: '번호의 핀을 내린다 (끝난 할 일, 바뀐 결정)',
59      argumentHint: '<번호>',
60    })
61    await $.command.register({ name: 'pins', description: '고정된 핀 목록 보기' })
62    await update($, pins, await load($).then(list => () => list))
63
64    return next(e)
65  })
66
67  on('command.run', { command: 'pin' }, async ($, e) => {
68    const raw = e.args.trim()
69    const isTodo = /^(할일|todo)\s*[:：]/i.test(raw)
70    const text = raw.replace(/^(할일|todo|결정)\s*[:：]\s*/i, '').replace(/\s+/g, ' ')
71
72    if (text === '') {
73      return { text: '사용법: /pin <결정 내용>  또는  /pin 할일: <내용>' }
74    }
75
76    const list = [...(await load($)), { kind: isTodo ? '할일' : '결정', date: await today($), text } as Pin]
77    await save($, list)
78
79    return { text: `고정했습니다.\n${listing(list)}` }
80  })
81
82  on('command.run', { command: 'unpin' }, async ($, e) => {
83    const list = await load($)
84    const at = Number(e.args.trim()) - 1
85    const gone = list[at]
86
87    if (gone === undefined) {
88      return { text: `사용법: /unpin <번호>\n${listing(list) || '고정된 핀이 없습니다.'}` }
89    }
90
91    await save($, list.filter((_, i) => i !== at))
92
93    return { text: `내렸습니다: [${gone.kind}] ${gone.text}` }
94  })
95
96  on('command.run', { command: 'pins' }, async $ => {
97    const list = await load($)
98    await update($, pins, () => list)
99
100    return { text: listing(list) || '고정된 핀이 없습니다. /pin <내용>으로 추가하세요.' }
101  })
102
103  on('prompt.compose', async ($, e, next) => {
104    const composed = await next(e)
105    const list = await load($)
106    const text = `${RULES}\n\n현재 핀:\n${listing(list) || '(없음)'}`
107
108    return {
109      sections: [...composed.sections, { id: 'pinboard:pins', text, scope: 'session' }],
110    }
111  })
112}
113

1export type Pin = { kind: '결정' | '할일'; date: string; text: string }
2
3declare module 'claude-code' {
4  interface PluginState {
5    pinboard: { pins: Pin[] }
6  }
7}
8