fail-log

1import { atom, read, update } from 'claude-code'
2import type { EngineInterface, Register } from 'claude-code'
3
4import type { FailEntry } from '../types'
5import { KEEP, RECENT, asCount, asEntries, failLines, failSvg, firstLine, recentHead, summarize, summaryText } from './faillog'
6import { followTheme, mayWrite, readTheme, rememberVersion } from './style'
7
8const PANE = 'fail-log'
9const TITLE = '失敗の記録'
10const DESCRIPTION = 'ツールが失敗した記録と、よく落ちる物を見る'
11
12const ENTRIES = atom({ plugin: 'fail-log', key: 'entries' } as const, [] as FailEntry[])
13const TOTAL = atom({ plugin: 'fail-log', key: 'total' } as const, 0)
14const CONFIRMING = atom({ plugin: 'fail-log', key: 'confirming' } as const, false)
15
16type $ = EngineInterface
17
18/** $.store から読んで $.state に写す。読めなければ今の値のまま */
19async function load($: $) {
20  const entries = asEntries(await $.store.get('entries').catch(() => undefined))
21  const total = asCount(await $.store.get('total').catch(() => undefined))
22  if (entries) await update($, ENTRIES, () => entries.slice(-KEEP))
23  if (total !== undefined) await update($, TOTAL, () => total)
24}
25
26// ponytail: 同じセッションで並んで落ちた失敗の書き込みを 1 本ずつにする鎖 (モジュール変数)。
27// 別のセッションとは、読み直してから書くまでの間に重なった 1 件が消えうる
28let chain: Promise<unknown> = Promise.resolve()
29const serial = (fn: () => Promise<void>) => {
30  const run = chain.then(fn, fn)
31  chain = run.catch(() => {})
32  return run
33}
34
35/** store のキーを読む。キーが無ければ empty、読めない時 (例外・形が違う) は undefined */
36async function readKey<T>($: $, key: string, as: (v: unknown) => T | undefined, empty: T): Promise<T | undefined> {
37  try {
38    const raw = await $.store.get(key)
39    return raw === undefined ? empty : as(raw)
40  } catch {
41    return undefined
42  }
43}
44
45// ponytail: 読めなかった知らせはセッションに 1 回だけ (失敗のたびに出すとうるさい)。リロードでもう 1 回出る
46let toldBroken = false
47
48/**
49 * $.store は他のセッションと共有なので、書く直前に読み直して 1 件だけ足す。
50 * 読めない時 (例外・形が違う) と、古い版のまま動いている時は書かずに、このセッションの画面にだけ足す
51 */
52const record = ($: $, entry: FailEntry) =>
53  serial(async () => {
54    const saved = await readKey($, 'entries', asEntries, [])
55    const total = await readKey($, 'total', asCount, 0)
56    const onlyHere = async () => {
57      await update($, ENTRIES, list => [...list, entry].slice(-KEEP))
58      await update($, TOTAL, n => n + 1)
59    }
60    if (saved === undefined || total === undefined) {
61      if (!toldBroken) $.ui.toast('失敗の記録を読めなかったので、保存していません(上書きしないよう止めています)', { timeoutMs: 8000 })
62      toldBroken = true
63      return onlyHere()
64    }
65    if (!(await mayWrite($, entry.at))) return onlyHere()
66    const next = [...saved, entry].slice(-KEEP)
67    await update($, ENTRIES, () => next)
68    await update($, TOTAL, () => total + 1)
69    await $.store.set('entries', next).catch(() => {})
70    await $.store.set('total', total + 1).catch(() => {})
71  })
72
73const clear = ($: $) =>
74  serial(async () => {
75    if (!(await mayWrite($, await $.clock.now()))) return void (await update($, CONFIRMING, () => false))
76    await update($, ENTRIES, () => [])
77    await update($, TOTAL, () => 0)
78    await update($, CONFIRMING, () => false)
79    await $.store.set('entries', []).catch(() => {})
80    await $.store.set('total', 0).catch(() => {})
81  })
82
83// ponytail: 主の名前を持てたかはモジュール変数。リロードでも session.start が来て決め直す
84let ownsMain = false
85
86const openPane = async ($: $) => {
87  // 別のセッションで増えた分も見えるように、開くたびに読み直す
88  await load($)
89  await $.ui.open({ id: PANE, title: TITLE })
90  return { text: '失敗の記録を開きました。' }
91}
92
93export const register: Register = on => {
94  followTheme(on)
95
96  on('session.start', async ($, e, next) => {
97    const started = await next(e)
98    // /errors が拒まれたら /fail-log にする
99    const got = await $.command.register({ name: 'errors', description: DESCRIPTION }).catch(() => undefined)
100    ownsMain = got?.command === 'errors'
101    if (!ownsMain) await $.command.register({ name: 'fail-log', description: DESCRIPTION }).catch(() => {})
102    await readTheme($)
103    await update($, CONFIRMING, () => false)
104    await rememberVersion($).catch(() => {})
105    await load($)
106    return started
107  })
108
109  // /errors を持てなかった時は、その名前の持ち主に回す
110  on('command.run', { command: 'errors' }, ($, e, next) => (ownsMain ? openPane($) : next(e))).catch(($, e, next) => next(e))
111  // /errors を持てた時は /fail-log を登録していないので、その名前の持ち主に回す
112  on('command.run', { command: 'fail-log' }, ($, e, next) => (ownsMain ? next(e) : openPane($))).catch(($, e, next) => next(e))
113
114  // 見るだけ。ツールが失敗した (isError) 物だけ記録する。断られた物は数えない
115  on('tool.call', async ($, e, next) => {
116    const r = await next(e)
117    if (r.isError === true) {
118      const tool = String(e.tool)
119      const { input, group } = summarize(tool, e as unknown as Record<string, unknown>)
120      const text = typeof r.text === 'string' ? r.text : typeof r.result === 'string' ? r.result : ''
121      const at = await $.clock.now()
122      await record($, { at, tool, input, group, error: firstLine(text), isSub: e.agentId !== undefined })
123    }
124    return r
125  }).catch(($, e, next) => next(e))
126
127  on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
128    const t = $.ui.resolve(e)
129    const { Box, Text, Button } = t
130    // terminal の表にも Svg の名前があるので、画面の種類でも分ける
131    const Svg = e.surface !== 'terminal' && 'Svg' in t ? t.Svg : undefined
132    const now = await $.clock.now()
133    const entries = await read($, ENTRIES)
134    const total = await read($, TOTAL)
135    const confirming = await read($, CONFIRMING)
136    const recent = entries.slice(-RECENT).reverse()
137
138    return (
139      <Box flexDirection="column" gap={1}>
140        {Svg ? (
141          <Svg key="chart" source={failSvg(entries, total, now)} alt={summaryText(entries, total, now)} />
142        ) : (
143          <Box key="lines" flexDirection="column">
144            {failLines(entries, total, now).map((l, i) => (
145              <Text key={`line-${i}`} color={l.color} dimColor={l.isDim} bold={l.isBold}>
146                {l.text}
147              </Text>
148            ))}
149          </Box>
150        )}
151        {recent.length > 0 && (
152          <Box key="recent" flexDirection="column">
153            <Text key="recent-head" bold>{`最近の失敗 ${recent.length} 件`}</Text>
154            {recent.map((x, i) => (
155              <Box key={`recent-${i}`} flexDirection="column">
156                <Text key="head" color={x.isSub ? 'blue' : 'red'}>
157                  {recentHead(x, now)}
158                </Text>
159                <Text key="error" dimColor>
160                  {x.error}
161                </Text>
162              </Box>
163            ))}
164          </Box>
165        )}
166        {(entries.length > 0 || total > 0) &&
167          (confirming ? (
168            <Box key="confirm" flexDirection="row" gap={1}>
169              <Button key="clear" label="もう一度押すと消します" variant="primary" onPress={() => void clear($)} />
170              <Button key="cancel" dimColor label="やめる" onPress={() => void update($, CONFIRMING, () => false)} />
171            </Box>
172          ) : (
173            <Button key="clear" label="記録を消す" dimColor onPress={() => void update($, CONFIRMING, () => true)} />
174          ))}
175      </Box>
176    )
177  })
178}
179

1// 失敗の要約・まとめ方・SVG と terminal 用の行。どれも純関数(shots.mts が node で直に読む)
2import type { FailEntry } from '../types'
3import { C, W, clean, countUp, esc, fadeIn, frame, growBar, header, panel, short } from './style'
4
5/** 覚えておく数 ($.store) */
6export const KEEP = 200
7/** 棒グラフに出す数 */
8export const TOP = 6
9/** 一覧に出す数 */
10export const RECENT = 10
11
12const JST = 9 * 3_600_000
13/** JST の YYYY-MM-DD */
14export const jstDay = (ms: number) => new Date(ms + JST).toISOString().slice(0, 10)
15/** JST の時刻。今日でなければ月日も付ける */
16export const when = (ms: number, now: number) => {
17  const iso = new Date(ms + JST).toISOString()
18  return jstDay(ms) === jstDay(now) ? iso.slice(11, 16) : `${iso.slice(5, 10)} ${iso.slice(11, 16)}`
19}
20
21/** mcp__server__tool は最後の名前だけにする */
22export const shortTool = (tool: string) => (tool.startsWith('mcp__') ? (tool.split('__').pop() ?? tool) : tool)
23
24const str = (v: unknown) => (typeof v === 'string' ? v : '')
25const baseName = (p: string) => p.replace(/[\\/]+$/, '').split(/[\\/]/).pop() ?? p
26
27const SHELLS = new Set(['Bash', 'PowerShell'])
28const FILE_TOOLS: Record<string, string> = { Read: 'file_path', Edit: 'file_path', Write: 'file_path', MultiEdit: 'file_path', NotebookEdit: 'notebook_path' }
29
30/**
31 * コマンドの頭を正規化する。`cd x &&` などの移動と、頭の `A=1` の環境変数を飛ばし、
32 * 実行する物の名前 (パスと .exe を落として小文字) と、それに続くサブコマンド 1 語。
33 * 例: `cd app && NODE_ENV=test npx vitest run a.ts` は `npx vitest`
34 */
35export function commandHead(cmd: string): string {
36  // ponytail: 引用符の中の && や | でも切れる。まとめる鍵がずれるだけ
37  const segs = cmd
38    .split(/&&|\|\||[;|\r\n]/)
39    .map(s => clean(s))
40    .filter(Boolean)
41  const seg = segs.find(s => !/^(?:cd|pushd|popd|set-location|sl)(?:\s|$)/i.test(s)) ?? segs[0] ?? ''
42  const words = seg.split(/\s+/).filter(Boolean)
43  while (words.length > 1 && /^[A-Za-z_][A-Za-z0-9_]*=/.test(words[0] ?? '')) words.shift()
44  const exe = baseName((words[0] ?? '').replace(/^["'&]+|["']+$/g, ''))
45    .replace(/\.(?:exe|cmd|bat|ps1)$/i, '')
46    .toLowerCase()
47  const sub = words[1] ?? ''
48  // サブコマンドらしい語だけ (フラグ・パス・数字・引用符は外す)
49  return /^[A-Za-z][\w:-]*$/.test(sub) ? `${exe} ${sub}` : exe
50}
51
52// ponytail: 形で見分けられる秘密だけを伏せる。`-p 値` のような位置で決まる物は見分けられない
53const SECRETS: [RegExp, string][] = [
54  // トークンの形 (頭は残す)
55  [/\b(sk-ant-|sk-|ghp_|gho_|ghu_|ghs_|ghr_|github_pat_|xoxb-|xoxp-)[A-Za-z0-9_-]{6,}/g, '$1***'],
56  [/\bAKIA[0-9A-Z]{16}\b/g, 'AKIA***'],
57  // Authorization: Bearer xxx
58  [/\b(Bearer)\s+\S+/gi, '$1 ***'],
59  // GITHUB_TOKEN=xxx・api_key=xxx・--password=xxx (名前の後ろが合えば頭に何が付いていても)
60  [/(TOKEN|SECRET|PASSWORD|PASSWD|API_?KEY|KEY)=\S+/gi, '$1=***'],
61  // URL の userinfo (https://user:pass@host)
62  [/\b([a-z][a-z0-9+.-]*:\/\/)[^\s/?#@]+@/gi, '$1***@'],
63]
64
65/** 秘密らしい文字列を伏せ字にする。store に残す前に、切る前の文字列に当てる (切った後だと頭だけ残って漏れる) */
66export const redact = (s: string) => SECRETS.reduce((t, [re, to]) => t.replace(re, to), s)
67
68/** ツールの入力から、一覧に出す要約とまとめる鍵 */
69export function summarize(tool: string, input: Record<string, unknown>): { input: string; group: string } {
70  const name = shortTool(tool)
71  if (SHELLS.has(tool)) {
72    const cmd = redact(str(input.command))
73    const head = commandHead(cmd)
74    return { input: short(clean(cmd.split(/\r?\n/)[0] ?? ''), 60), group: head ? `${name} ${head}` : name }
75  }
76  const key = FILE_TOOLS[tool]
77  if (key) {
78    const file = clean(redact(baseName(str(input[key]))))
79    return { input: file, group: file ? `${name} ${file}` : name }
80  }
81  // Grep・Glob は探した形、WebFetch は宛先の名前 (userinfo は落とす)
82  if (tool === 'Grep' || tool === 'Glob') return { input: short(clean(redact(str(input.pattern))), 40), group: name }
83  if (tool === 'WebFetch') {
84    const host = (/^[a-z]+:\/\/([^/?#]+)/i.exec(str(input.url))?.[1] ?? '').replace(/^.*@/, '')
85    const h = clean(host)
86    return { input: h, group: h ? `${name} ${h}` : name }
87  }
88  return { input: '', group: name }
89}
90
91/**
92 * エラーの 1 行目。<tool_use_error> の札は外す。`Exit code 1` だけの行なら次の行も付ける。秘密らしい文字列は伏せる
93 */
94export function firstLine(text: string): string {
95  const lines = redact(text)
96    .replace(/<\/?tool_use_error>/g, '')
97    .split(/\r?\n/)
98    .map(l => clean(l))
99    .filter(Boolean)
100  let s = lines[0] ?? '(エラーの文がありません)'
101  if (/^Exit code -?\d+$/i.test(s) && lines[1]) s = `${s}: ${lines[1]}`
102  return short(s, 160)
103}
104
105/**
106 * $.store の値を確かめて読む。形の違う物は捨てる。知らない欄 (新しい版が足した欄) は残す。
107 * 前の版が平文で残した秘密も、読む時に伏せる (次に書く時に store からも消える)。件数で切るのは足す時だけ
108 */
109export function asEntries(v: unknown): FailEntry[] | undefined {
110  if (!Array.isArray(v)) return undefined
111  return v
112    .filter((x): x is Record<string, unknown> => typeof x === 'object' && x !== null && typeof x.at === 'number' && typeof x.tool === 'string')
113    .map(x => ({
114      ...x,
115      at: x.at as number,
116      tool: clean(x.tool as string),
117      input: clean(redact(str(x.input))),
118      error: clean(redact(str(x.error))),
119      group: clean(redact(str(x.group))) || clean(x.tool as string),
120      isSub: x.isSub === true,
121    }))
122}
123
124export const asCount = (v: unknown) => (typeof v === 'number' && Number.isFinite(v) && v >= 0 ? Math.floor(v) : undefined)
125
126export type Group = { group: string; count: number; subs: number; last: number; error: string }
127
128/** まとめた数の多い順。同じなら最近落ちた順 */
129export function topGroups(entries: readonly FailEntry[]): Group[] {
130  const by = new Map<string, Group>()
131  for (const e of entries) {
132    const g = by.get(e.group) ?? { group: e.group, count: 0, subs: 0, last: 0, error: '' }
133    g.count++
134    if (e.isSub) g.subs++
135    if (e.at >= g.last) {
136      g.last = e.at
137      g.error = e.error
138    }
139    by.set(e.group, g)
140  }
141  return [...by.values()].sort((a, b) => b.count - a.count || b.last - a.last)
142}
143
144// ponytail: 今日の数は残している 200 件から数える。1 日に 200 回より多く落ちると少なく出る
145export const todayCount = (entries: readonly FailEntry[], now: number) => entries.filter(e => jstDay(e.at) === jstDay(now)).length
146
147export const summaryText = (entries: readonly FailEntry[], total: number, now: number) =>
148  `今日 ${todayCount(entries, now)} 件 通算 ${total} 件 種類 ${topGroups(entries).length}`
149
150// 12px の文字のおおよその幅: 全角 12、半角 7
151const wide = (ch: string) => /[⺀-꓏가-힣豈-﫿︰-﹏＀-｠￠-￦]/.test(ch)
152const widthOf = (s: string) => [...s].reduce((n, ch) => n + (wide(ch) ? 12 : 7), 0)
153/** px に収まるように後ろを切る */
154export function fit(s: string, px: number) {
155  if (widthOf(s) <= px) return s
156  let out = ''
157  for (const ch of s) {
158    if (widthOf(`${out}${ch}…`) > px) break
159    out += ch
160  }
161  return `${out}…`
162}
163
164const txt = (x: number, y: number, s: string, size: number, fill: string, extra = '') =>
165  `<text x="${x}" y="${y}" font-size="${size}" fill="${fill}"${extra ? ` ${extra}` : ''}>${esc(s)}</text>`
166
167export function failSvg(entries: readonly FailEntry[], total: number, now: number): string {
168  const today = todayCount(entries, now)
169  const subs = entries.filter(e => e.isSub).length
170  const groups = topGroups(entries)
171  let body = header('失敗の記録', groups.length ? `${groups.length} 種類` : '', C.red)
172
173  // 今日・通算・サブの 3 枚
174  const tiles: [string, number, string][] = [
175    ['今日', today, today ? C.red : C.dim],
176    ['通算', total, C.text],
177    ['うちサブ (直近)', subs, subs ? C.purple : C.dim],
178  ]
179  tiles.forEach(([label, n, color], i) => {
180    const x = 14 + i * 120
181    body +=
182      panel(x, 54, 112, 60) +
183      txt(x + 10, 74, label, 12, C.dim) +
184      countUp(n, `x="${x + 10}" y="104" font-size="24" font-weight="bold" fill="${color}"`, String, i * 0.08)
185  })
186
187  let y = 140
188  if (groups.length === 0) {
189    body += txt(16, y, 'まだ失敗はありません', 12, C.green)
190    return frame(y + 16, body)
191  }
192  const shown = groups.slice(0, TOP)
193  body += txt(16, y, 'よく落ちる物', 13, C.text, 'font-weight="bold"')
194  body += txt(W - 16, y, `上位 ${shown.length} / ${groups.length}`, 12, C.dim, 'text-anchor="end"')
195  y += 12
196  const max = Math.max(1, ...shown.map(g => g.count))
197  const BAR = W - 32
198  shown.forEach((g, i) => {
199    const w = (BAR * g.count) / max
200    const subW = (BAR * g.subs) / max
201    let row =
202      txt(16, y + 14, fit(g.group, BAR - 60), 12, C.text) +
203      txt(W - 16, y + 14, `${g.count}回`, 12, C.text, 'font-weight="bold" text-anchor="end"') +
204      `<rect x="16" y="${y + 20}" width="${BAR}" height="8" rx="4" fill="${C.face}"/>` +
205      growBar(16, y + 20, Number(w.toFixed(1)), 8, C.red, i * 0.06)
206    if (g.subs > 0) row += growBar(16, y + 20, Number(subW.toFixed(1)), 8, C.purple, i * 0.06)
207    body += fadeIn(row, i * 0.06)
208    y += 34
209  })
210  // 凡例
211  y += 6
212  body +=
213    `<rect x="16" y="${y}" width="11" height="11" rx="2" fill="${C.red}"/>` +
214    txt(32, y + 10, 'メイン', 12, C.dim) +
215    `<rect x="84" y="${y}" width="11" height="11" rx="2" fill="${C.purple}"/>` +
216    txt(100, y + 10, 'サブエージェント', 12, C.dim) +
217    txt(W - 16, y + 10, `直近 ${entries.length} 件から`, 12, C.dim, 'text-anchor="end"')
218  return frame(y + 22, body)
219}
220
221export type Line = { text: string; color?: string; isDim?: boolean; isBold?: boolean }
222
223/** terminal 用: 数と、よく落ちる物 */
224export function failLines(entries: readonly FailEntry[], total: number, now: number): Line[] {
225  const out: Line[] = [{ text: summaryText(entries, total, now), isBold: true }]
226  const groups = topGroups(entries)
227  if (groups.length === 0) return [...out, { text: 'まだ失敗はありません', color: 'green' }]
228  out.push({ text: 'よく落ちる物', isBold: true })
229  for (const g of groups.slice(0, TOP)) out.push({ text: `${String(g.count).padStart(3)}回 ${g.group}${g.subs ? ` (サブ ${g.subs})` : ''}`, color: 'red' })
230  return out
231}
232
233/** 一覧の 1 件の見出し */
234export const recentHead = (e: FailEntry, now: number) =>
235  `${when(e.at, now)} ${shortTool(e.tool)}${e.input ? ` ${e.input}` : ''}${e.isSub ? ' (サブ)' : ''}`
236

1// 全 mod で共通の見た目(色・見出し・動き)と小物。
2// 正本は shared/style.ts。各 mod の hooks/style.ts はその写しなので、直すのは正本だけにして
3// `node tools/copy_shared.mts` で写す(`--check` で写しのずれを見つける)。
4import type { EngineInterface, On } from 'claude-code'
5
6export type Palette = {
7  bg: string
8  face: string
9  line: string
10  text: string
11  dim: string
12  weak: string
13  blue: string
14  green: string
15  yellow: string
16  red: string
17  purple: string
18  orange: string
19}
20
21/** GitHub Dark 系(docs/mod-guide.md の 7 節) */
22export const DARK: Palette = {
23  bg: '#0d1117',
24  face: '#161b22',
25  line: '#30363d',
26  text: '#c9d1d9',
27  dim: '#8b949e',
28  weak: '#8b949e',
29  blue: '#58a6ff',
30  green: '#3fb950',
31  yellow: '#d29922',
32  red: '#f85149',
33  purple: '#bc8cff',
34  orange: '#f78166',
35}
36
37/** GitHub Light 系 */
38export const LIGHT: Palette = {
39  bg: '#ffffff',
40  face: '#f6f8fa',
41  line: '#d0d7de',
42  text: '#1f2328',
43  dim: '#656d76',
44  weak: '#656d76',
45  blue: '#0969da',
46  green: '#1a7f37',
47  yellow: '#9a6700',
48  red: '#cf222e',
49  purple: '#8250df',
50  orange: '#bc4c00',
51}
52
53// ponytail: 今の色はモジュールの変数 1 個(この mod の中だけ)。SVG を作る関数は C.bg などを呼ぶたびに読むので、
54// 引数を増やさずにテーマが変わる。描く途中で切り替わることは無い(JS は 1 本で走る)
55/** 今の色。setTheme で中身が入れ替わる(同じ物を指し続けるので、import した C のままでよい) */
56export const C: Palette = { ...DARK }
57let isLightNow = false
58
59export const isLight = () => isLightNow
60
61/** /config の theme の値が明るい系か('light'・'light-daltonized'・'light-ansi' など) */
62export const isLightTheme = (value: unknown) => typeof value === 'string' && value.startsWith('light')
63
64export function setTheme(light: boolean) {
65  isLightNow = light
66  Object.assign(C, light ? LIGHT : DARK)
67}
68
69/**
70 * 今の /config の theme を読んで色を合わせる。mod 自身の session.start の中で呼ぶ
71 * (同じイベントに matcher 無しのフックを 2 つ置くと読み込みを拒まれるので、ここでは on しない)。
72 * VS Code の配色は mod から読めないので、Claude Code の theme が light 系の時だけ明るくなる
73 */
74export async function readTheme($: EngineInterface) {
75  const rows = await $.config.list().catch(() => [])
76  setTheme(isLightTheme(rows.find(r => r.key === 'theme')?.value))
77}
78
79/** /config で theme が変わったら色を替えて描き直す。register の中で 1 回呼ぶ */
80export function followTheme(on: On) {
81  on('config.set', { key: 'theme' }, async ($, e, next) => {
82    const r = await next(e)
83    if (r.deny === undefined) {
84      setTheme(isLightTheme(r.value))
85      $.ui.invalidate('ui.render')
86    }
87    return r
88  })
89}
90
91// ---- 小物 ----
92
93/** 外から来る文字列の制御文字を落とす。エンジンは制御文字を含む Text の子や alt を拒み、ペインが閉じる */
94export const clean = (s: string) => s.replace(/[\t\n\r]+/g, ' ').replace(/[\x00-\x1f\x7f-\x9f]/g, '').trim()
95
96/** SVG の文字に入れる前のエスケープ(制御文字も落とす) */
97export const esc = (s: string) =>
98  clean(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;')
99
100// ---- 時間帯と季節 (日本時間 JST = UTC+9 固定。動いている環境のタイムゾーンには頼らない) ----
101
102export type DayPart = '朝' | '昼' | '夕' | '夜'
103export type Season = '春' | '夏' | '秋' | '冬'
104
105const jstDate = (now: number) => new Date(now + 9 * 3_600_000)
106
107/** 時間帯。朝 5-10 時 / 昼 10-16 時 / 夕 16-19 時 / 夜 19-5 時 */
108export const dayPart = (now: number): DayPart => {
109  const h = jstDate(now).getUTCHours()
110  return h >= 5 && h < 10 ? '朝' : h >= 10 && h < 16 ? '昼' : h >= 16 && h < 19 ? '夕' : '夜'
111}
112
113/** 季節。春 3-5 月 / 夏 6-8 月 / 秋 9-11 月 / 冬 12-2 月 */
114export const season = (now: number): Season => {
115  const m = jstDate(now).getUTCMonth() + 1
116  return m >= 3 && m <= 5 ? '春' : m >= 6 && m <= 8 ? '夏' : m >= 9 && m <= 11 ? '秋' : '冬'
117}
118
119/** n 文字を超えたら … で切る */
120export const short = (s: string, n: number) => (s.length > n ? `${s.slice(0, Math.max(0, n - 1))}…` : s)
121
122// ---- 記録を守る(docs/mod-guide.md の 9 節) ----
123
124/** JST の YYYY-MM-DD */
125export const jstDay = (now: number) => jstDate(now).toISOString().slice(0, 10)
126
127export type Backup = { day: string; value: unknown }
128
129// ponytail: $.fs に消す手が無いので、曜日ごとの 7 つの枠を上書きして 7 日分だけ残す。もっと残すなら枠を日付にして process で消す
130const backupPath = (dir: string, plugin: string, key: string, wd: number) => `${dir.replace(/[\\/]+$/, '')}/${plugin}/${key}-${wd}.json`
131
132/**
133 * $.store の key の値を、その日はじめて呼ばれた時だけ dir に控える(曜日ごとの枠で 7 日分)。
134 * dir が空なら何もしない(公開の既定は空。入れた人が backupDir を設定する)。書いたら true
135 */
136export async function backupDaily($: EngineInterface, dir: string, key: string, value: unknown, now: number): Promise<boolean> {
137  if (!dir.trim() || value === undefined) return false
138  const day = jstDay(now)
139  const path = backupPath(dir, $.plugin.name, key, jstDate(now).getUTCDay())
140  // 壊れた枠(途中まで・null)は無いのと同じに扱って上書きする
141  const old = await $.fs.read(path).then(t => parseBackup(t)?.day ?? '', () => '')
142  if (old === day) return false
143  await $.fs.write(path, JSON.stringify({ day, value } satisfies Backup))
144  return true
145}
146
147/** 控えの 1 枠を読む。壊れていれば undefined */
148export function parseBackup(text: string): Backup | undefined {
149  try {
150    const b = JSON.parse(text) as Partial<Backup> | null
151    return b && typeof b.day === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(b.day) && b.value !== undefined ? (b as Backup) : undefined
152  } catch {
153    return undefined
154  }
155}
156
157/** 控えの一覧。新しい日から順。読めない枠・壊れた枠は飛ばす */
158export async function listBackups($: EngineInterface, dir: string, key: string): Promise<Backup[]> {
159  if (!dir.trim()) return []
160  const all = await Promise.all(
161    [0, 1, 2, 3, 4, 5, 6].map(wd =>
162      $.fs.read(backupPath(dir, $.plugin.name, key, wd)).then(parseBackup, () => undefined),
163    ),
164  )
165  return all.filter((b): b is Backup => b !== undefined).sort((a, b) => b.day.localeCompare(a.day))
166}
167
168let loadedPrint: string | undefined
169let staleAt = 0
170let isStaleNow = false
171let toldStale = false
172
173const normPath = (p: string) => p.replace(/[\\/]+/g, '/').replace(/\/$/, '').toLowerCase()
174
175/** FNV-1a 32bit。中身が変わったかを見るだけ */
176function fnv(s: string) {
177  let h = 0x811c9dc5
178  for (let i = 0; i < s.length; i++) h = Math.imul(h ^ s.charCodeAt(i), 0x01000193)
179  return (h >>> 0).toString(16)
180}
181
182/**
183 * 今ディスクにある、この mod の指紋。plugin.json と hooks の .ts / .tsx の中身から作る
184 * (版の数字を上げずに中身だけ変えた時も変わる)。plugin.json が読めなければ undefined
185 */
186async function diskPrint($: EngineInterface): Promise<string | undefined> {
187  const root = $.plugin.root
188  let manifest: string | undefined
189  for (const p of [`${root}/.claude-plugin/plugin.json`, `${root}/plugin.json`]) {
190    manifest = await $.fs.read(p).then(t => t, () => undefined)
191    if (manifest !== undefined) break
192  }
193  if (manifest === undefined) return undefined
194  const names = await $.fs.list(`${root}/hooks`).then(
195    es => es.filter(e => e.kind === 'file' && /\.tsx?$/.test(e.name)).map(e => e.name).sort(),
196    () => [] as string[],
197  )
198  const parts = await Promise.all(names.map(n => $.fs.read(`${root}/hooks/${n}`).then(t => `${n}\n${t}`, () => n)))
199  return fnv([manifest, ...parts].join('\0'))
200}
201
202/**
203 * マーケットプレイスから入れた形(<plugins>/cache/<market>/<name>/<版>)なら、installed_plugins.json に
204 * 今入っている場所が自分と違うか。違えば新しい版が入っている。分からなければ false
205 */
206async function replacedInCache($: EngineInterface): Promise<boolean> {
207  const root = normPath($.plugin.root)
208  const at = root.lastIndexOf('/plugins/cache/')
209  if (at < 0) return false
210  const raw = await $.fs.read(`${$.plugin.root.slice(0, at + '/plugins'.length)}/installed_plugins.json`).then(t => t, () => '')
211  try {
212    const plugins = (JSON.parse(raw) as { plugins?: Record<string, { installPath?: unknown }[]> }).plugins ?? {}
213    const mine = Object.entries(plugins)
214      .filter(([k]) => k.startsWith(`${$.plugin.name}@`))
215      .flatMap(([, v]) => (Array.isArray(v) ? v : []))
216      .map(e => (typeof e.installPath === 'string' ? normPath(e.installPath) : ''))
217    return mine.length > 0 && !mine.includes(root)
218  } catch {
219    return false
220  }
221}
222
223/** 読み込んだ時の指紋を覚える。mod の session.start で 1 回呼ぶ */
224export async function rememberVersion($: EngineInterface) {
225  loadedPrint ??= await diskPrint($)
226}
227
228/**
229 * 新しい版が入ったのに、このセッションはまだ古い版で動いているか。
230 * フォルダから読ませている時は中身の指紋が読み込んだ時と違えば、マーケットプレイスから入れた時は
231 * 入っている場所が自分でなくなれば true。読み直すのは 60 秒に 1 回まで。分からない時は false
232 */
233export async function isStale($: EngineInterface, now: number): Promise<boolean> {
234  if (isStaleNow || now - staleAt < 60_000) return isStaleNow
235  staleAt = now
236  if (await replacedInCache($)) return (isStaleNow = true)
237  if (loadedPrint === undefined) return false
238  const p = await diskPrint($)
239  isStaleNow = p !== undefined && p !== loadedPrint
240  return isStaleNow
241}
242
243/**
244 * $.store に書いてよいか。古い版のままなら書かず、1 回だけトーストで開き直しを頼む
245 * (古い版は新しい版の欄を知らないので、書くと消してしまう)
246 */
247export async function mayWrite($: EngineInterface, now: number): Promise<boolean> {
248  if (!(await isStale($, now))) return true
249  if (!toldStale) {
250    toldStale = true
251    $.ui.toast(`${$.plugin.name}: 新しい版が入りました。VS Code を開き直すまで記録は書きません`)
252  }
253  return false
254}
255
256// ---- SVG の部品 ----
257
258export const W = 380
259export const HEADER_H = 44
260
261/** SVG 全体の枠。地を塗って body を入れる。幅は W にそろえる */
262export const frame = (h: number, body: string, w = W) =>
263  `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${w} ${h}" font-family="sans-serif">` +
264  `<rect width="${w}" height="${h}" rx="10" fill="${C.bg}"/>${body}</svg>`
265
266/** 面(カード)。角丸 8、線 1 */
267export const panel = (x: number, y: number, w: number, h: number, fill = C.face) =>
268  `<rect x="${x}" y="${y}" width="${w}" height="${h}" rx="8" fill="${fill}" stroke="${C.line}"/>`
269
270/**
271 * 共通の見出し帯(高さ HEADER_H)。左に色の縦線、左に題、右に添え書き。
272 * 下の細い線が左から伸びる
273 */
274export function header(title: string, sub = '', accent = C.blue, y = 0, w = W) {
275  const pad = 14
276  return [
277    `<rect x="0" y="${y}" width="${w}" height="${HEADER_H}" rx="10" fill="${C.face}"/>`,
278    `<rect x="0" y="${y + 8}" width="4" height="${HEADER_H - 16}" rx="2" fill="${accent}"/>`,
279    `<text x="${pad}" y="${y + 28}" font-size="16" font-weight="bold" fill="${C.text}">${esc(title)}</text>`,
280    sub === '' ? '' : `<text x="${w - pad}" y="${y + 28}" font-size="12" fill="${C.dim}" text-anchor="end">${esc(sub)}</text>`,
281    growBar(pad, y + HEADER_H - 3, w - pad * 2, 2, accent, 0, 0.35),
282  ].join('')
283}
284
285/** 横に伸びる棒。幅 0 から w まで伸びて止まる(shots.mts は終わりの値で撮る) */
286export const growBar = (x: number, y: number, w: number, h: number, fill: string, delay = 0, opacity = 1) =>
287  `<rect x="${x}" y="${y}" width="${Math.max(0, w)}" height="${h}" rx="${Math.min(3, h / 2)}" fill="${fill}"${opacity === 1 ? '' : ` opacity="${opacity}"`}>` +
288  `<animate attributeName="width" from="0" to="${Math.max(0, w)}" begin="${delay}s" dur="0.6s" fill="freeze"/></rect>`
289
290/** 下から伸びる縦の棒(下端 bottom・高さ h) */
291export const growColumn = (x: number, bottom: number, w: number, h: number, fill: string, delay = 0) =>
292  `<rect x="${x}" y="${bottom - h}" width="${w}" height="${Math.max(0, h)}" rx="${Math.min(3, w / 2)}" fill="${fill}">` +
293  `<animate attributeName="y" from="${bottom}" to="${bottom - h}" begin="${delay}s" dur="0.6s" fill="freeze"/>` +
294  `<animate attributeName="height" from="0" to="${Math.max(0, h)}" begin="${delay}s" dur="0.6s" fill="freeze"/></rect>`
295
296/** ふわっと出る。中身は SVG の断片 */
297export const fadeIn = (body: string, delay = 0) =>
298  `<g opacity="1"><animate attributeName="opacity" from="0" to="1" begin="${delay}s" dur="0.4s" fill="freeze"/>${body}</g>`
299
300/**
301 * 0 から value まで数字が増えて止まる。コマ送りの文字を重ね、最後のコマだけが残る。
302 * attrs は <text> に付ける属性(x・y・font-size・fill など)。format で桁区切りや単位を付ける
303 */
304export function countUp(value: number, attrs: string, format: (n: number) => string = n => String(n), delay = 0) {
305  const STEPS = 8
306  const d = 0.08
307  const last = `<text ${attrs} opacity="0">${esc(format(value))}<animate attributeName="opacity" from="0" to="1" begin="${(delay + (STEPS - 1) * d).toFixed(2)}s" dur="0.01s" fill="freeze"/></text>`
308  if (!Number.isFinite(value) || value === 0) return `<text ${attrs}>${esc(format(value))}</text>`
309  const frames = Array.from({ length: STEPS - 1 }, (_, k) => {
310    const n = Number.isInteger(value) ? Math.round((value * k) / (STEPS - 1)) : (value * k) / (STEPS - 1)
311    return `<text ${attrs} opacity="0">${esc(format(n))}<animate attributeName="opacity" values="1;1" begin="${(delay + k * d).toFixed(2)}s" dur="${d}s"/></text>`
312  })
313  return frames.join('') + last
314}
315

1/** 失敗 1 回分 */
2export type FailEntry = {
3  /** 時刻 (ms) */
4  at: number
5  /** ツールの名前 */
6  tool: string
7  /** 入力の短い要約。Bash ならコマンドの頭、Edit などならファイル名。無ければ空 */
8  input: string
9  /** エラーの 1 行目 */
10  error: string
11  /** 似た失敗をまとめる鍵 (ツール + 正規化したコマンドの頭、ファイルの道具ならファイル名) */
12  group: string
13  /** サブエージェントの呼び出し */
14  isSub: boolean
15}
16
17declare module 'claude-code' {
18  interface PluginState {
19    'fail-log': {
20      /** 古い順。新しい 200 件 ($.store の写し) */
21      entries: FailEntry[]
22      /** 通算の数 (消すまで) */
23      total: number
24      /** 「消す」を 1 回押して、もう 1 回を待っている */
25      confirming: boolean
26    }
27  }
28}
29