week-card

1import { atom, read, update } from 'claude-code'
2import type { EngineInterface, Register } from 'claude-code'
3
4import type { WeekSnaps } from '../types'
5import type { WeekRaw } from './card'
6import { asSnaps, baseOf, cardLines, cardSvg, dayKey, isSameSnap, reportMd, snapOf, summaryText, usageOf, withSnap } from './card'
7import { followTheme, mayWrite, readTheme, rememberVersion } from './style'
8
9type $ = EngineInterface
10
11const PANE = 'week-card'
12const TITLE = '今週のカード'
13const DESCRIPTION = '1 週間の使い方と、お題・ガチャ・冒険の書・水槽の増え方を 1 枚のカードで見る'
14
15const SNAPS = atom({ plugin: 'week-card', key: 'snaps' } as const, {} as WeekSnaps)
16
17// 他の mod の state (読むだけ)。plugin と key はソースに文字で書く (validate が読む)
18const USAGE_WEEK = { plugin: 'usage-history', key: 'week' } as const
19const RPG_HERO = { plugin: 'dev-rpg', key: 'hero' } as const
20const GACHA_SAVE = { plugin: 'turn-gacha', key: 'save' } as const
21const GACHA_CARDS = { plugin: 'turn-gacha', key: 'cards' } as const
22const AQUA_TANK = { plugin: 'aqua-pet', key: 'tank' } as const
23const QUEST_STREAK = { plugin: 'daily-quest', key: 'streak' } as const
24const QUEST_DONE = { plugin: 'daily-quest', key: 'totalDone' } as const
25
26/** 1 つ読む。その mod が入っていない・読めない時は undefined */
27const get = async (f: () => Promise<{ value: unknown }>) => {
28  try {
29    return (await f()).value
30  } catch {
31    return undefined
32  }
33}
34
35/** 他の mod の state を読む。描画の中で呼ぶと、どれかが変わった時に描き直る */
36const readRaw = async ($: $): Promise<WeekRaw> => ({
37  week: await get(() => $.state.get(USAGE_WEEK)),
38  hero: await get(() => $.state.get(RPG_HERO)),
39  save: await get(() => $.state.get(GACHA_SAVE)),
40  cards: await get(() => $.state.get(GACHA_CARDS)),
41  tank: await get(() => $.state.get(AQUA_TANK)),
42  streak: await get(() => $.state.get(QUEST_STREAK)),
43  totalDone: await get(() => $.state.get(QUEST_DONE)),
44})
45
46// store への書き込みは 1 本ずつ
47let chain: Promise<unknown> = Promise.resolve()
48const serial = <T,>(f: () => Promise<T>) => {
49  const p = chain.then(f, f)
50  chain = p.catch(() => {})
51  return p
52}
53
54const BROKEN = 'week-card: 記録を読めなかったので、今日の写しは書いていません。次のターンの終わりにもう一度読みます'
55/** 読めない時のトーストを出したか。読めたら戻す (続けて読めない間は 1 回だけ出す) */
56let toldBroken = false
57
58/** 今日の写しを取る。store の今日の分と違う時だけ、書く直前に読み直して今日の分だけ置き換える */
59const record = ($: $) =>
60  serial(async () => {
61    const now = await $.clock.now()
62    const day = dayKey(now)
63    const snap = snapOf(await readRaw($))
64    if (Object.keys(snap).length === 0) return
65    // 読めない時 (reject・形が違う) は書かない。今の state の写しで書くと、ほかの日が丸ごと消える
66    const got = await $.store.get('snaps').then(
67      v => ({ v }),
68      () => undefined,
69    )
70    const saved = got === undefined ? undefined : got.v === undefined ? {} : asSnaps(got.v)
71    if (got === undefined || saved === undefined) {
72      if (!toldBroken) $.ui.toast(BROKEN)
73      toldBroken = true
74      return
75    }
76    toldBroken = false
77    const raw = got.v
78    if (isSameSnap(saved[day], { ...saved[day], ...snap })) {
79      await update($, SNAPS, () => saved)
80      return
81    }
82    // 古い版のまま動いている時は書かない (新しい版の欄を消さないように)
83    if (!(await mayWrite($, now))) return
84    // この版の知らない欄 (新しい版が足した物) は読んだまま残す
85    const next = withSnap(raw, day, snap)
86    await update($, SNAPS, () => asSnaps(next) ?? {})
87    await $.store.set('snaps', next).catch(() => {})
88  })
89
90/** 週報に貼る文を入力欄に入れる (送信はしない) */
91async function paste($: $) {
92  const now = await $.clock.now()
93  const raw = await readRaw($)
94  const text = reportMd(now, usageOf(raw.week, now), snapOf(raw), baseOf(await read($, SNAPS), now))
95  const r = await $.prompt.fill({ text, mode: 'insert' }).catch(() => ({ isFilled: false, refusal: undefined }))
96  const why = r.refusal === 'dialog' ? '(ダイアログが開いています)' : r.refusal === 'no_composer' ? '(この画面には入力欄がありません)' : ''
97  $.ui.toast(r.isFilled ? '週報に貼る文を入力欄に入れました(送信はしていません)' : `入力欄に入れられませんでした${why}`, { timeoutMs: 5000 })
98}
99
100// /week を自分で取れたか (取れなければ /week-card にして、/week は横取りしない)
101let ownsMain = false
102
103async function openPane($: $) {
104  await record($).catch(() => {})
105  await $.ui.open({ id: PANE, title: TITLE })
106  return { text: '今週のカードを開きました。' }
107}
108
109export const register: Register = on => {
110  followTheme(on)
111
112  on('session.start', async ($, e, next) => {
113    const started = await next(e)
114    await rememberVersion($)
115    const got = await $.command.register({ name: 'week', description: DESCRIPTION }).catch(() => undefined)
116    ownsMain = got?.command === 'week'
117    if (!ownsMain) await $.command.register({ name: 'week-card', description: DESCRIPTION }).catch(() => {})
118    await readTheme($)
119    const saved = asSnaps(await $.store.get('snaps').catch(() => undefined))
120    if (saved) await update($, SNAPS, () => saved)
121    await record($).catch(() => {})
122    return started
123  })
124
125  on('command.run', { command: 'week' }, ($, e, next) => (ownsMain ? openPane($) : next(e))).catch(($, e, next) => next(e))
126  on('command.run', { command: 'week-card' }, openPane)
127
128  // メインのターンが答えて終わるたびに写す (他の mod が数を増やした後に拾えるよう、下を先に通す)
129  on('turn.complete', async ($, e, next) => {
130    const done = await next(e)
131    if (e.agentId === undefined && e.reason === 'answer') await record($).catch(() => {})
132    return done
133  }).catch(($, e, next) => next(e))
134
135  on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
136    const t = $.ui.resolve(e)
137    const { Box, Text, Button } = t
138    const Svg = e.surface !== 'terminal' && 'Svg' in t ? t.Svg : undefined
139    const now = await $.clock.now()
140    const raw = await readRaw($)
141    const usage = usageOf(raw.week, now)
142    const snap = snapOf(raw)
143    const base = baseOf(await read($, SNAPS), now)
144
145    return (
146      <Box flexDirection="column" gap={1}>
147        {Svg ? (
148          <Svg key="card" source={cardSvg(now, usage, snap, base)} alt={summaryText(now, usage)} />
149        ) : (
150          <Box key="lines" flexDirection="column">
151            {cardLines(now, usage, snap, base).map((l, i) => (
152              <Text key={`line-${i}`} color={l.color} dimColor={l.isDim} bold={l.isBold}>
153                {l.text}
154              </Text>
155            ))}
156          </Box>
157        )}
158        <Box flexDirection="column">
159          <Button key="paste" label="週報に貼る文を入力欄に入れる" variant="primary" onPress={() => void paste($)} />
160          <Text dimColor>入力欄に入れるだけで、送信はしません。</Text>
161        </Box>
162      </Box>
163    )
164  })
165}
166

1// 週のカードの純関数(他の mod の state を確かめる・日ごとの写しの足し方・増えた数・SVG・terminal の行・週報の文)
2import type { WeekSnap, WeekSnaps, WeekUsageDay } from '../types'
3import { C, HEADER_H, W, countUp, esc, fadeIn, frame, growColumn, header, panel } from './style'
4
5const DAY = 86_400_000
6/** store に残す日数 */
7export const KEEP_DAYS = 30
8const DATE_RE = /^\d{4}-\d{2}-\d{2}$/
9const WEEK = ['日', '月', '火', '水', '木', '金', '土']
10
11const isObj = (v: unknown): v is Record<string, unknown> => typeof v === 'object' && v !== null && !Array.isArray(v)
12const num = (v: unknown) => (typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : 0)
13
14/** 日本時間の 'YYYY-MM-DD' */
15export const dayKey = (ms: number) => new Date(ms + 9 * 3_600_000).toISOString().slice(0, 10)
16
17/** 'YYYY-MM-DD' → '10/18(土)' */
18export function dayLabel(key: string, withWeek = true) {
19  const d = new Date(`${key}T00:00:00Z`)
20  return `${d.getUTCMonth() + 1}/${d.getUTCDate()}${withWeek ? `(${WEEK[d.getUTCDay()]})` : ''}`
21}
22
23/** 1 万を超えたら「万」、1 億を超えたら「億」で 1 桁 */
24export function fmtNum(n: number) {
25  if (n >= 1e8) return `${(n / 1e8).toFixed(1)}億`
26  if (n >= 1e4) return `${(n / 1e4).toFixed(1)}万`
27  return Number.isInteger(n) || n >= 100 ? String(Math.round(n)) : n.toFixed(1)
28}
29
30/** 分 → '5 時間 12 分' / '45 分' */
31export const fmtMinutes = (m: number) => (m >= 60 ? `${Math.floor(m / 60)} 時間 ${Math.round(m % 60)} 分` : `${Math.round(m)} 分`)
32
33// dev-rpg の hooks/rpg.ts の xpToReach と MAX_LEVEL の写し。dev-rpg が式を変えたら合わせる
34const MAX_LEVEL = 99
35const xpToReach = (level: number) => 40 * (level - 1) + 10 * level * (level - 1)
36export function levelOf(xp: number) {
37  let level = 1
38  while (level < MAX_LEVEL && xp >= xpToReach(level + 1)) level++
39  return level
40}
41
42// ---------------------------------------------------------------- 他の mod の state を確かめる
43
44/** 他の mod から読んだ生の値。読めなかった物は undefined */
45export type WeekRaw = {
46  week?: unknown
47  hero?: unknown
48  save?: unknown
49  cards?: unknown
50  tank?: unknown
51  streak?: unknown
52  totalDone?: unknown
53}
54
55/** 生の値から今の累計の数を作る。形の合わない mod は「入っていない」と同じに扱い、欄を作らない */
56export function snapOf(raw: WeekRaw): WeekSnap {
57  const s: WeekSnap = {}
58  const hero = raw.hero
59  if (isObj(hero) && typeof hero.xp === 'number') {
60    s.level = levelOf(num(hero.xp))
61    // 一番深い階は dev-rpg 0.6.0 から。無い版では読まない
62    if (typeof hero.deepest === 'number') s.deepest = num(hero.deepest)
63  }
64  const save = raw.save
65  if (isObj(save) && isObj(save.book)) {
66    const book = Object.entries(save.book).filter(([, o]) => isObj(o) && num(o.count) > 0).map(([id]) => id)
67    // カードの表が読めれば表にある物だけを数える(消えたカードは数えない)
68    const ids = Array.isArray(raw.cards) ? new Set(raw.cards.filter(isObj).map(c => String(c.id))) : undefined
69    s.cards = ids && ids.size > 0 ? book.filter(id => ids.has(id)).length : book.length
70  }
71  const tank = raw.tank
72  if (isObj(tank) && Array.isArray(tank.fish)) s.fish = tank.fish.filter(isObj).length
73  if (typeof raw.totalDone === 'number') s.quests = num(raw.totalDone)
74  if (typeof raw.streak === 'number') s.streak = num(raw.streak)
75  return s
76}
77
78/**
79 * usage-history の week から、今日で終わる 7 日 (古い順) を作る。日付で合わせるので、week が昨日のままでも今日は 0。
80 * usage-history が入っていない (week が配列でない) 時は undefined
81 */
82export function usageOf(week: unknown, now: number): WeekUsageDay[] | undefined {
83  if (!Array.isArray(week)) return undefined
84  const byDay = new Map(week.filter(isObj).filter(d => typeof d.day === 'string' && DATE_RE.test(d.day)).map(d => [d.day as string, d]))
85  return Array.from({ length: 7 }, (_, k) => {
86    const day = dayKey(now - (6 - k) * DAY)
87    const d = byDay.get(day) ?? {}
88    return { day, turns: num(d.turns), tools: num(d.tools), inputTokens: num(d.inputTokens), outputTokens: num(d.outputTokens), minutes: num(d.minutes) }
89  })
90}
91
92// ---------------------------------------------------------------- 日ごとの写し
93
94const SNAP_KEYS = ['level', 'deepest', 'cards', 'fish', 'quests', 'streak'] as const
95
96function snapFrom(v: unknown): WeekSnap {
97  const out: WeekSnap = {}
98  if (!isObj(v)) return out
99  for (const k of SNAP_KEYS) if (typeof v[k] === 'number' && Number.isFinite(v[k])) out[k] = v[k] as number
100  return out
101}
102
103/** store から読んだ値を確かめる。日付のキーだけ。オブジェクトでなければ undefined */
104export function asSnaps(v: unknown): WeekSnaps | undefined {
105  if (!isObj(v)) return undefined
106  return Object.fromEntries(
107    Object.entries(v)
108      .filter(([k]) => DATE_RE.test(k))
109      .map(([k, s]) => [k, snapFrom(s)]),
110  )
111}
112
113/** 今日の写しが store の物と同じか (同じなら書かない) */
114export const isSameSnap = (a: WeekSnap | undefined, b: WeekSnap) => SNAP_KEYS.every(k => a?.[k] === b[k])
115
116/**
117 * store に書く形。書く直前に読んだ raw に今日の写しを重ねる。
118 * この版の知らない欄 (日付でないキー・日の中の知らない数) はそのまま残し、新しい KEEP_DAYS 日だけ残す (刈り込んだ古い日は戻さない)。
119 * 入っていない mod の欄は今日の写しに無いので、別のセッションが書いた値が残る
120 */
121export function withSnap(raw: unknown, day: string, snap: WeekSnap): Record<string, unknown> {
122  const o = isObj(raw) ? raw : {}
123  const out: Record<string, unknown> = Object.fromEntries(Object.entries(o).filter(([k]) => !DATE_RE.test(k)))
124  const days = [...new Set([...Object.keys(o).filter(k => DATE_RE.test(k)), day])].sort().slice(-KEEP_DAYS)
125  for (const k of days) out[k] = k === day ? { ...(isObj(o[k]) ? o[k] : {}), ...snap } : o[k]
126  return out
127}
128
129/**
130 * 増えた数の比べる元。7 日前の写し (その日の終わり = この 1 週間の始まり)。
131 * 無ければ、それより後で今日より前の一番古い写し。それも無ければ undefined
132 */
133export function baseOf(snaps: WeekSnaps, now: number): { day: string; snap: WeekSnap } | undefined {
134  const from = dayKey(now - 7 * DAY)
135  const today = dayKey(now)
136  const day = Object.keys(snaps)
137    .filter(k => k >= from && k < today)
138    .sort()[0]
139  return day === undefined ? undefined : { day, snap: snaps[day] ?? {} }
140}
141
142// ---------------------------------------------------------------- 増えた物の行
143
144export type GrowthRow = { key: (typeof SNAP_KEYS)[number]; label: string; value: string; delta: number | undefined; color: string }
145
146const ROWS: { key: (typeof SNAP_KEYS)[number]; label: string; unit: (n: number) => string; color: () => string; hasDelta: boolean }[] = [
147  { key: 'level', label: '冒険の書', unit: n => `Lv ${n}`, color: () => C.purple, hasDelta: true },
148  { key: 'deepest', label: 'ダンジョン', unit: n => `${n} 階`, color: () => C.orange, hasDelta: true },
149  { key: 'cards', label: 'ガチャの図鑑', unit: n => `${n} 種`, color: () => C.yellow, hasDelta: true },
150  { key: 'fish', label: '水槽の魚', unit: n => `${n} 匹`, color: () => C.blue, hasDelta: true },
151  { key: 'quests', label: 'こなしたお題', unit: n => `${n} 個`, color: () => C.green, hasDelta: true },
152  // 連続日数は途切れると 0 に戻るので、増えた数は出さない
153  { key: 'streak', label: 'お題の連続', unit: n => `${n} 日`, color: () => C.green, hasDelta: false },
154]
155
156/** 今の写しにある物だけ、行にする。base が無ければ増えた数は出さない (元の写しに無い欄は 0 から) */
157export function growthRows(now: WeekSnap, base: WeekSnap | undefined): GrowthRow[] {
158  return ROWS.flatMap(r => {
159    const v = now[r.key]
160    if (v === undefined) return []
161    return [{ key: r.key, label: r.label, value: r.unit(v), delta: r.hasDelta && base ? v - (base[r.key] ?? 0) : undefined, color: r.color() }]
162  })
163}
164
165const deltaText = (d: number) => (d > 0 ? `+${d}` : d < 0 ? `${d}` : '±0')
166
167// ---------------------------------------------------------------- 1 週間の使い方のまとめ
168
169export function usageSummary(days: readonly WeekUsageDay[]) {
170  const sum = (f: (d: WeekUsageDay) => number) => days.reduce((a, d) => a + f(d), 0)
171  let top: WeekUsageDay | undefined
172  for (const d of days) if (d.turns > 0 && (top === undefined || d.turns >= top.turns)) top = d
173  return {
174    turns: sum(d => d.turns),
175    tools: sum(d => d.tools),
176    inputTokens: sum(d => d.inputTokens),
177    outputTokens: sum(d => d.outputTokens),
178    minutes: sum(d => d.minutes),
179    activeDays: days.filter(d => d.turns > 0).length,
180    top,
181  }
182}
183
184/** '10/16〜10/22' */
185export const rangeText = (now: number) => `${dayLabel(dayKey(now - 6 * DAY), false)}〜${dayLabel(dayKey(now), false)}`
186
187/** カードの見出しの下の一文 (Svg の alt・terminal の 1 行目) */
188export function summaryText(now: number, usage: WeekUsageDay[] | undefined) {
189  if (!usage) return `今週のカード ${rangeText(now)}`
190  const u = usageSummary(usage)
191  return `今週のカード ${rangeText(now)} ターン ${fmtNum(u.turns)} / 作業 ${fmtMinutes(u.minutes)}`
192}
193
194const NO_USAGE = 'usage-history を入れると 1 週間の使い方が出ます'
195const NO_GROWTH = 'daily-quest・turn-gacha・dev-rpg・aqua-pet を入れると、増えた物が出ます'
196const baseText = (base: { day: string } | undefined) =>
197  base ? `${dayLabel(base.day)} の終わりから` : '増えた数は、明日から出ます (写しは今日から)'
198
199// ---------------------------------------------------------------- SVG
200
201/** 1 枚のカード。上に 1 週間の使い方 (3 つの数と日ごとの縦棒)、下にこの 1 週間で増えた物 */
202export function cardSvg(now: number, usage: WeekUsageDay[] | undefined, snap: WeekSnap, base: { day: string; snap: WeekSnap } | undefined) {
203  const parts: string[] = [header('今週のカード', rangeText(now), C.blue)]
204  let y = HEADER_H + 10
205
206  if (usage) {
207    const u = usageSummary(usage)
208    const tileW = (W - 14 * 2 - 10 * 2) / 3
209    const tiles: [string, number, (n: number) => string][] = [
210      ['ターン', u.turns, fmtNum],
211      ['作業時間', u.minutes, fmtMinutes],
212      ['ツール', u.tools, fmtNum],
213    ]
214    tiles.forEach(([label, n, f], k) => {
215      const x = 14 + k * (tileW + 10)
216      parts.push(panel(x, y, tileW, 54))
217      parts.push(`<text x="${(x + 10).toFixed(1)}" y="${y + 19}" font-size="12" fill="${C.dim}">${esc(label)}</text>`)
218      parts.push(countUp(n, `x="${(x + 10).toFixed(1)}" y="${y + 42}" font-size="${k === 1 ? 14 : 20}" font-weight="bold" fill="${C.text}"`, f, k * 0.1))
219    })
220    y += 54 + 22
221    parts.push(`<text x="14" y="${y}" font-size="12" fill="${C.dim}">${esc(`使った日 ${u.activeDays} / 7 日・出力 ${fmtNum(u.outputTokens)} トークン`)}</text>`)
222
223    // 日ごとのターン数。いちばん多かった日は黄色、今日は青、ほかは緑
224    const chartH = 64
225    const bottom = y + 18 + chartH
226    const gap = 8
227    const colW = (W - 14 * 2 - gap * 6) / 7
228    const max = Math.max(1, ...usage.map(d => d.turns))
229    parts.push(`<line x1="14" y1="${bottom}" x2="${W - 14}" y2="${bottom}" stroke="${C.line}"/>`)
230    usage.forEach((d, k) => {
231      const x = 14 + k * (colW + gap)
232      const h = d.turns === 0 ? 0 : Math.max(2, ((chartH - 16) * d.turns) / max)
233      const fill = u.top?.day === d.day ? C.yellow : k === usage.length - 1 ? C.blue : C.green
234      parts.push(growColumn(x, bottom, colW, h, fill, k * 0.05))
235      if (d.turns > 0) parts.push(fadeIn(`<text x="${(x + colW / 2).toFixed(1)}" y="${bottom - h - 4}" font-size="12" fill="${C.text}" text-anchor="middle">${esc(fmtNum(d.turns))}</text>`, 0.5))
236      parts.push(`<text x="${(x + colW / 2).toFixed(1)}" y="${bottom + 16}" font-size="12" fill="${C.dim}" text-anchor="middle">${esc(dayLabel(d.day, false))}</text>`)
237    })
238    y = bottom + 16 + 14
239  } else {
240    y += 14
241    parts.push(`<text x="14" y="${y}" font-size="12" fill="${C.dim}">${esc(NO_USAGE)}</text>`)
242    y += 12
243  }
244
245  // この 1 週間で増えた物
246  const rows = growthRows(snap, base?.snap)
247  y += 16
248  parts.push(`<text x="14" y="${y}" font-size="13" font-weight="bold" fill="${C.text}">この 1 週間で増えた物</text>`)
249  y += 8
250  if (rows.length === 0) {
251    // 1 行では幅 380 に収まらないので 2 行に分ける
252    for (const s of ['daily-quest・turn-gacha・dev-rpg・aqua-pet', 'を入れると、増えた物が出ます']) {
253      y += 18
254      parts.push(`<text x="14" y="${y}" font-size="12" fill="${C.dim}">${esc(s)}</text>`)
255    }
256    return frame(y + 16, parts.join(''))
257  }
258  const rowH = 28
259  parts.push(panel(14, y, W - 28, rows.length * rowH + 8))
260  rows.forEach((r, k) => {
261    const ry = y + 4 + k * rowH
262    const body = [
263      `<rect x="24" y="${ry + 8}" width="4" height="${rowH - 16}" rx="2" fill="${r.color}"/>`,
264      `<text x="36" y="${ry + 19}" font-size="12" fill="${C.dim}">${esc(r.label)}</text>`,
265      `<text x="250" y="${ry + 19}" font-size="14" font-weight="bold" fill="${C.text}" text-anchor="end">${esc(r.value)}</text>`,
266      r.delta === undefined
267        ? ''
268        : `<text x="${W - 26}" y="${ry + 19}" font-size="13" font-weight="bold" fill="${r.delta > 0 ? C.green : r.delta < 0 ? C.red : C.dim}" text-anchor="end">${esc(deltaText(r.delta))}</text>`,
269    ].join('')
270    parts.push(fadeIn(body, 0.3 + k * 0.06))
271  })
272  y += rows.length * rowH + 8 + 18
273  parts.push(`<text x="14" y="${y}" font-size="12" fill="${C.dim}">${esc(baseText(base))}</text>`)
274  return frame(y + 14, parts.join(''))
275}
276
277// ---------------------------------------------------------------- terminal の行
278
279export type CardLine = { text: string; color?: string; isDim?: boolean; isBold?: boolean }
280
281export function cardLines(now: number, usage: WeekUsageDay[] | undefined, snap: WeekSnap, base: { day: string; snap: WeekSnap } | undefined): CardLine[] {
282  const out: CardLine[] = [{ text: `今週のカード ${rangeText(now)}`, isBold: true }]
283  if (usage) {
284    const u = usageSummary(usage)
285    out.push({ text: `ターン ${fmtNum(u.turns)} / 作業 ${fmtMinutes(u.minutes)} / ツール ${fmtNum(u.tools)}` })
286    out.push({ text: `使った日 ${u.activeDays} / 7 日・出力 ${fmtNum(u.outputTokens)} トークン`, isDim: true })
287    if (u.top) out.push({ text: `いちばん多かった日 ${dayLabel(u.top.day)} ${fmtNum(u.top.turns)} ターン`, isDim: true })
288  } else {
289    out.push({ text: NO_USAGE, isDim: true })
290  }
291  out.push({ text: 'この 1 週間で増えた物', isBold: true })
292  const rows = growthRows(snap, base?.snap)
293  if (rows.length === 0) out.push({ text: NO_GROWTH, isDim: true })
294  for (const r of rows) out.push({ text: `${r.label} ${r.value}${r.delta === undefined ? '' : ` (${deltaText(r.delta)})`}` })
295  if (rows.length > 0) out.push({ text: baseText(base), isDim: true })
296  return out
297}
298
299// ---------------------------------------------------------------- 週報に貼る文
300
301/** 週報に貼る Markdown。入っていない mod の行は出さない */
302export function reportMd(now: number, usage: WeekUsageDay[] | undefined, snap: WeekSnap, base: { day: string; snap: WeekSnap } | undefined) {
303  const lines = [`## 今週の Claude Code (${rangeText(now)})`, '']
304  if (usage) {
305    const u = usageSummary(usage)
306    const top = u.top ? `、いちばん多かった日 ${dayLabel(u.top.day)} ${fmtNum(u.top.turns)} ターン` : ''
307    lines.push(`- ターン ${fmtNum(u.turns)} 回 (1 日平均 ${fmtNum(u.turns / 7)}${top})`)
308    lines.push(`- 作業時間 ${fmtMinutes(u.minutes)} / ツール ${fmtNum(u.tools)} 回 / 使った日 ${u.activeDays} 日`)
309    lines.push(`- トークン 入力 ${fmtNum(u.inputTokens)} / 出力 ${fmtNum(u.outputTokens)}`)
310  }
311  const rows = growthRows(snap, base?.snap)
312  for (const r of rows) lines.push(`- ${r.label} ${r.value}${r.delta === undefined ? '' : ` (${deltaText(r.delta)})`}`)
313  if (rows.length > 0 && base) lines.push('', `増えた数は ${dayLabel(base.day)} の終わりとの比べです。`)
314  return lines.join('\n')
315}
316

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// week-card の $.state の契約と、読むだけの他の mod の state の写し。
2// 他の mod の型は dependencies を使わず、要る欄だけをここに写す(見本: mods/trophy-shelf/types/index.d.ts)。
3// 読んだ値は hooks/card.ts の snapOf・usageOf で形を確かめてから使う(その mod が入っていない時は undefined)
4
5/** その日の終わりの累計の数。入っていない mod の欄は無い */
6export type WeekSnap = {
7  /** dev-rpg のレベル */
8  level?: number
9  /** dev-rpg のダンジョンの一番深い階 (dev-rpg 0.6.0 から) */
10  deepest?: number
11  /** turn-gacha の図鑑の種類の数 */
12  cards?: number
13  /** aqua-pet の魚の数 */
14  fish?: number
15  /** daily-quest の通算でこなしたお題の数 */
16  quests?: number
17  /** daily-quest の 3 つ全部こなした日の連続 */
18  streak?: number
19}
20
21/** 'YYYY-MM-DD'(日本時間) → その日の写し。$.store の 'snaps' にも残す (直近 30 日) */
22export type WeekSnaps = Record<string, WeekSnap>
23
24/** usage-history の week の 1 日分 (usage-history の HistoryWeekDay の写し) */
25export type WeekUsageDay = {
26  day: string
27  turns: number
28  tools: number
29  inputTokens: number
30  outputTokens: number
31  minutes: number
32}
33
34declare module 'claude-code' {
35  interface PluginState {
36    'week-card': {
37      /** $.store の 'snaps' の写し。書く直前に store を読み直し、今日の分だけを置き換える */
38      snaps: WeekSnaps
39    }
40    /** ここから下は他の mod の state の、week-card が読む欄だけ(書くのは各 mod) */
41    'usage-history': {
42      /** 今日で終わる直近 7 日 (usage-history 0.2.0 から) */
43      week: WeekUsageDay[]
44    }
45    'daily-quest': {
46      streak: number
47      totalDone: number
48    }
49    'turn-gacha': {
50      save: { book: Record<string, { count: number; firstAt: number }> }
51      cards: { id: string }[]
52    }
53    'dev-rpg': {
54      hero: { xp: number; deepest?: number }
55    }
56    'aqua-pet': {
57      tank: { fish: { kind: string }[] }
58    }
59  }
60}
61