dsh-plugin 0.1.1 → 1.1.0

package/src/client/lib/catalog.ts

@@ -0,0 +1,240 @@
+/**
+ * Catalog constants and normalizers: site URLs, category metadata, sort keys
+ * and the mapping from the online API's short-key payloads to HubPlugin.
+ */
+import type { EnvInfo, HubPlugin, LocaleId } from '../types.ts'
+import { MAX_CORE_CHARS, classifyFailure, coreErrorCode, summarizeError } from './failures.ts'
+
+/** 插件中心官网地址。 */
+export const SITE_URL = 'https://dsh-plugin.org/'
+
+/** 插件中心源码仓库：头部右上角 GitHub 图标的跳转地址 */
+export const GITHUB_URL = 'https://github.com/dshplugin/dsh-plugin-hub'
+
+/** 构建时由 tsdown 从 package.json 注入的插件版本号（见 tsdown.config.ts define）。 */
+declare const __PLUGIN_VERSION__: string
+
+/**
+ * 插件当前版本号，供头部标题展示「DSH-Plugin Hub v0.1.1」。
+ * tsdown 构建时用 define 把 __PLUGIN_VERSION__ 替换成 package.json 的版本号；
+ * node --test 直接 import 本模块时该标识符不存在，typeof 守卫兜底为空串。
+ */
+export const PLUGIN_VERSION: string =
+  typeof __PLUGIN_VERSION__ === 'string' ? __PLUGIN_VERSION__ : ''
+
+/** dsh-plugin.org 中文页挂在 /zh/ 前缀下，英文在根路径。 */
+export function langPathOf(lang: LocaleId): string {
+  return lang === 'zh' ? 'zh/' : ''
+}
+
+/**
+ * 官网详情页两级路径：/plugins/{ownerSlug}/{slug}；
+ * 旧数据缺 ownerSlug 时从 repo 推导（卡片详情按钮与弹窗来源行共用）。
+ */
+export function pluginDetailUrl(plugin: HubPlugin, langPath: string): string {
+  const repo = plugin.source?.repo ?? ''
+  return `${SITE_URL}${langPath}plugins/${plugin.ownerSlug ?? repo.split('/')[0]?.toLowerCase() ?? ''}/${plugin.slug}`
+}
+
+/**
+ * 失败弹窗里仓库地址的跳转目标：官网详情页（含插件收录信息），
+ * 与 issue 正文的 Catalog 链接同一形式（单级 /plugins/{repo}）。
+ */
+export function pluginSiteUrl(repo: string): string {
+  return `${SITE_URL}plugins/${repo}`
+}
+
+/**
+ * 一键反馈 GitHub Issue 的预填链接：标题带「来自 dsh-plugin.org」标识，正文只带
+ * 核心信息 —— 原因判定 + 关键错误代码 + 尝试过的安装方式 + 宿主机器环境快照 +
+ * 错误核心摘要（完整日志太长，塞进 URL 会被 GitHub 以「request URL too long」拒绝，
+ * 故只收集重点）。错误弹窗、失败记录共用此逻辑。
+ * env 取不到时为 null，链接照常生成、只是少环境段。
+ * attempts（尝试过的安装方式，npm 反查 + 实际执行命令）：作者看到我们查过/试过的命令，
+ * 组织 scope 与 GitHub 用户名不一致时也能直接指认正确的 npm 包名。
+ */
+export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | null, command?: string, attempts?: string[]): string {
+  const title = `[dsh-plugin.org | dsh-plugin-hub] Install/Remove failed: ${repo}`
+  // 原因判定：让作者一眼知道这是不是自己插件的问题。
+  // [packaging]（预检/装后校验拦截）单独列：无论走 npm 还是 git 通道，都是分发物不完整
+  // （package.json 声明的入口文件在发布物里缺失），作者照此补齐即可。
+  const kind = classifyFailure(message)
+  const reason = /\[packaging\]/i.test(message)
+    ? 'plugin distribution is incomplete — the entry file declared in package.json is missing from the published package (github tarball or npm package); please commit build output or publish a complete package'
+      : kind === 'pluginPrepare'
+        ? 'plugin prepare/build script failed during install (packaging/distribution issue)'
+        : kind === 'pnpmIgnoredBuild'
+          ? 'plugin depends on a native module whose build script pnpm blocks by default (use a prebuilt variant)'
+          : 'plugin-side install failure'
+  const code = coreErrorCode(message)
+  // 按给定核心摘要预算构建完整预填 URL（含 URL 编码）；预算可调，供超长时逐档缩小
+  const build = (coreChars: number): string => {
+    const body = [
+      '## Summary',
+      `- Cause: ${reason}`,
+      ...(code ? [`- Key error: \`${code}\``] : []),
+      '',
+      // 来源说明：标题（链官网）+ 一句来源（链仓库）+ 实际执行的安装命令（含 --profile）与执行结果，链接由常量动态拼接
+      `## [DSH-Plugin 插件中心](${SITE_URL}) · 安装 Plugin 失败错误信息`,
+      `本错误信息由 [dsh-plugin-hub](${GITHUB_URL}) 插件中心的安装程序自动生成，随本次安装失败一并提交。`,
+      `- 实际执行的安装命令：\`${command ?? `dsh plugin${env?.profile ? ` --profile ${env.profile}` : ''} add github:${repo}`}\``,
+      `- 执行结果：安装失败，未能安装该插件。`,
+      // 尝试过的安装方式（npm 反查 + 实际执行命令，按先后顺序）：作者据此反推正确的
+      // npm 包名 —— 组织 scope 与 GitHub 用户名不一致时仅凭仓库名猜不到，作者看到我们
+      // 查过/试过的命令就能直接指认
+      ...(attempts && attempts.length > 0
+        ? ['', '## Attempted install channels（已尝试的安装方式）', ...attempts.map((a) => `- ${a}`)]
+        : []),
+      // [packaging] 场景：说明两种官方安装通道（npm 包 / git 直装），当前插件在对应通道下分发不完整
+      ...(/\[packaging\]/i.test(message)
+        ? [
+          '',
+          '## 安装方式说明',
+          'DSH 插件支持两种官方安装通道：`dsh plugin add <npm-package>`（npm 分发，需发布完整构建产物）与 `dsh plugin add github:owner/repo`（git 直装，仓库需提交构建产物或在 package.json 提供 `prepare` 脚本）。当前插件的分发物缺少 package.json 声明的入口文件，请按所用通道补齐后重新发布。',
+        ]
+        : []),
+      '',
+      '## Environment',
+      `- Plugin: \`${repo}\``,
+      // 宿主机器环境快照：便于作者本地复现；某字段缺失时如实写 unknown，不编造
+      ...(env
+        ? [
+          `- DSH: ${env.dshVersion ? `v${env.dshVersion}` : 'unknown'}`,
+          `- Plugin Hub: v${PLUGIN_VERSION}`,
+          `- Node: ${env.nodeVersion}`,
+          `- OS: ${env.platform} ${env.arch} (${env.release})`,
+          `- Profile: \`${env.profile}\``,
+          `- DSH Home: \`${env.dshHome}\``,
+        ]
+        : []),
+      // 该插件在插件中心的收录位置（详情页链接）
+      `- Catalog: [${pluginSiteUrl(repo)}](${pluginSiteUrl(repo)})`,
+      '',
+      '## Error (core)',
+      '',
+      '```',
+      // 核心错误收集器：只挑关键行（错误代码/构建失败/退出信息），去重截断，URL 才不至于超长
+      summarizeError(message, coreChars),
+      '```',
+      '',
+      '---',
+      // 底部署名：报错来自内置在 DeepSeek Harness 里的 dsh-plugin-hub 安装程序
+      `This error was produced by the [dsh-plugin-hub](${GITHUB_URL}) installer bundled with DeepSeek Harness.`,
+    ].join('\n')
+    return `https://github.com/${repo}/issues/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}`
+  }
+  // GitHub 请求行上限 8192 字节：先用宽松预算（最多 ~5K 核心错误）构建，超长再逐档缩小，保证最终 URL 不超限
+  const MAX_URL_CHARS = 7600
+  let url = build(MAX_CORE_CHARS)
+  if (url.length > MAX_URL_CHARS) {
+    for (const budget of [4000, 2500, 1400, 800, 400]) {
+      url = build(budget)
+      if (url.length <= MAX_URL_CHARS) break
+    }
+  }
+  return url
+}
+
+export const CATEGORY_ORDER = [
+  'interface', 'session', 'memory', 'tools', 'agent', 'workflow',
+  'integration', 'model', 'dev', 'knowledge', 'fun',
+]
+
+/** 分类标签按界面语言取词；未知 key 原样返回。 */
+export function categoryLabel(
+  map: Record<string, { zh: string; en: string }>,
+  key: string,
+  lang: LocaleId,
+): string {
+  return map[key]?.[lang] ?? key
+}
+
+/**
+ * 归一化在线 API（dsh-plugin.org/api/plugins.{lang}.json）返回的短 key 结构
+ * （s/o/n/vr/c/t/f/d/r/v/u/a/sg/fk），统一为 HubPlugin，保证渲染逻辑只认一种结构。
+ */
+export function normalize(raw: Record<string, unknown>): HubPlugin {
+  if (typeof raw.s === 'string') {
+    return {
+      slug: raw.s,
+      ownerSlug: typeof raw.o === 'string' ? raw.o : undefined,
+      displayName: typeof raw.n === 'string' ? raw.n : undefined,
+      version: typeof raw.vr === 'string' ? raw.vr : undefined,
+      category: typeof raw.c === 'string' ? raw.c : undefined,
+      topics: Array.isArray(raw.t) ? (raw.t as string[]) : undefined,
+      features: Array.isArray(raw.f) ? (raw.f as string[]) : undefined,
+      description: typeof raw.d === 'string' ? raw.d : undefined,
+      // 投影输出两种形态：老数据 source 是 repo 字符串；新数据是 { repo, npmPackage }
+      source: typeof raw.r === 'string'
+        ? { repo: raw.r }
+        : raw.r !== null && typeof raw.r === 'object'
+          ? {
+            repo: typeof (raw.r as { repo?: unknown }).repo === 'string' ? (raw.r as { repo: string }).repo : undefined,
+            npmPackage: typeof (raw.r as { npmPackage?: unknown }).npmPackage === 'string' ? (raw.r as { npmPackage: string }).npmPackage : undefined,
+          }
+          : undefined,
+      compatibility: typeof raw.v === 'string' ? { status: raw.v } : undefined,
+      dates: {
+        repoUpdatedAt: typeof raw.u === 'string' ? raw.u : undefined,
+        addedAt: typeof raw.a === 'string' ? raw.a : undefined,
+      },
+      stats: {
+        stargazers_count: typeof raw.sg === 'number' ? raw.sg : undefined,
+        forks_count: typeof raw.fk === 'number' ? raw.fk : undefined,
+      },
+    }
+  }
+  return raw as unknown as HubPlugin
+}
+
+/**
+ * 安装通道决策（用户无感知）：目录探测到 npm 包名 → 用 npm 包名安装
+ * （走 npm registry tarball，更快、与 GitHub 网络无关）；无 npm 包名 → git 直装。
+ * 返回值 target 即传给后端 /install 的安装目标（npm 包名 或 owner/repo）。
+ */
+export function installTargetOf(p: HubPlugin): { target: string; via: 'npm' | 'github' } {
+  const pkg = (p.source?.npmPackage ?? '').trim()
+  const repo = (p.source?.repo ?? '').trim()
+  if (pkg && repo) return { target: pkg, via: 'npm' }
+  return { target: repo, via: 'github' }
+}
+
+/** 展示用安装命令（复制/弹窗）：npm 通道显示包名，git 通道显示 github: 源。 */
+export function installCommandOf(p: HubPlugin, withProfile = false): string {
+  const { target, via } = installTargetOf(p)
+  return via === 'npm'
+    ? `dsh plugin${withProfile ? ' --profile web' : ''} add ${target}`
+    : `dsh plugin${withProfile ? ' --profile web' : ''} add github:${target}`
+}
+
+export const CATEGORY_LABELS: Record<string, { zh: string; en: string }> = {
+  interface: { zh: '界面与体验', en: 'UI & Experience' },
+  session: { zh: '会话与消息', en: 'Sessions & Messages' },
+  memory: { zh: '记忆与上下文', en: 'Memory & Context' },
+  tools: { zh: '工具与能力', en: 'Tools & Capabilities' },
+  agent: { zh: '技能与智能体', en: 'Skills & Agents' },
+  workflow: { zh: '工作流与自动化', en: 'Workflow & Automation' },
+  integration: { zh: '集成与连接', en: 'Integrations & Connections' },
+  model: { zh: '模型与推理', en: 'Models & Reasoning' },
+  dev: { zh: '开发与运维', en: 'Development & Operations' },
+  knowledge: { zh: '数据与知识', en: 'Data & Knowledge' },
+  fun: { zh: '娱乐', en: 'Entertainment' },
+}
+
+/** 分类 Tab 的紧凑标签（英文模式空间受限时使用）。 */
+export const CATEGORY_SHORT_LABELS: Record<string, { zh: string; en: string }> = {
+  interface: { zh: '界面体验', en: 'UI Exp' },
+  session: { zh: '会话消息', en: 'Sessions' },
+  memory: { zh: '记忆上下文', en: 'Memory' },
+  tools: { zh: '工具能力', en: 'Tools' },
+  agent: { zh: '技能智能体', en: 'Agents' },
+  workflow: { zh: '工作流', en: 'Workflow' },
+  integration: { zh: '集成连接', en: 'Integrations' },
+  model: { zh: '模型推理', en: 'Models' },
+  dev: { zh: '开发运维', en: 'Dev' },
+  knowledge: { zh: '数据知识', en: 'Knowledge' },
+  fun: { zh: '娱乐', en: 'Fun' },
+}
+
+export const SORTS = ['sortStars', 'sortForks', 'sortUpdated', 'sortNewest'] as const
+export type SortKey = (typeof SORTS)[number]

package/src/client/lib/env.ts

@@ -0,0 +1,16 @@
+/**
+ * One-shot host environment snapshot for bug reports. Fetched lazily and
+ * cached at module level: issue URLs embed this info, and the environment
+ * does not change during a session. A failed fetch degrades to null so the
+ * issue links still work — they just ship without the environment block.
+ */
+import type { EnvInfo } from '../types.ts'
+
+let envPromise: Promise<EnvInfo | null> | null = null
+
+export function getEnv(): Promise<EnvInfo | null> {
+  envPromise ??= fetch('/dsh-plugin-hub/env', { cache: 'no-store' })
+    .then((res) => (res.ok ? (res.json() as Promise<EnvInfo>) : null))
+    .catch(() => null)
+  return envPromise
+}

package/src/client/lib/failures.ts

@@ -0,0 +1,165 @@
+/**
+ * Persistent install/remove notifications.
+ *
+ * Every settled task — success or failure — is appended to localStorage the
+ * moment the backend reports it, so a result is never lost even when the
+ * dialog was dismissed or nobody was watching the progress strip. Newest
+ * first, capped at MAX entries. Failures keep their full output for the
+ * issue-filing flow; successes are lightweight (no log).
+ */
+export interface NotificationRecord {
+  id: number
+  kind: 'install' | 'uninstall'
+  /** true = 成功（轻量记录）；false = 失败（message 携带完整错误日志） */
+  ok: boolean
+  /** owner/repo（可能为空：请求层失败但拿不到仓库时） */
+  repo: string
+  /** 失败时的完整错误日志；成功记录为空串 */
+  message: string
+  /** 实际执行的安装/卸载命令（issue 预填时如实展示）；历史记录可能缺失 */
+  command?: string
+  /** 尝试过的安装方式（npm registry 反查 + 实际执行命令，按先后顺序）：失败提 Issue 时贴给作者，便于反推正确的 npm 包名 */
+  attempts?: string[]
+  /** 结束时间（epoch ms） */
+  at: number
+}
+
+const KEY = 'gro.ngilp-hsd.failure-records'
+const MAX = 50
+
+export type FailureKind = 'pnpmIgnoredBuild' | 'pluginPrepare' | 'repo'
+
+/**
+ * 失败归类，三态。无论底层机制如何（pnpm 白名单拦截 / 构建脚本被忽略 / prepare 失败），
+ * 对用户而言结果都一样 —— 当前安装通道（npm 或 git）装不上，就是插件分发/依赖的问题，
+ * 一律引导提 Issue：
+ * - pnpmIgnoredBuild：插件依赖里的原生模块构建脚本被 pnpm 默认拦截（如 node-pty，
+ *   `ERR_PNPM_IGNORED_BUILDS`）。只影响带原生模块的插件，其他插件不受影响 —— 差异在
+ *   插件的依赖选择，属插件依赖/打包问题 → 引导去仓库提 Issue（建议改用预编译版本）
+ * - pluginPrepare：插件的 prepare/构建脚本实际执行失败（git tarball 常因缺失子模块或
+ *   构建产物导致）—— 属插件打包/分发问题，应引导去仓库提 Issue
+ * - repo：其余失败（含 git prepare 被 pnpm 白名单拦截等），默认按插件仓库问题引导提 Issue
+ */
+export function classifyFailure(message: string): FailureKind {
+  // 装后校验拦截（服务端 verifyInstalledEntry 标记）：入口文件缺失 = git 分发缺构建产物，
+  // 与 pluginPrepare 同类（插件打包/分发问题），引导去仓库提 Issue
+  if (/\[packaging\]|entry file missing/i.test(message)) return 'pluginPrepare'
+  // 原生模块构建被忽略（IGNORED_BUILDS）要在 prepare 判定之前：dsh 尾部固定提示语带
+  // allowBuilds/pnpm-workspace.yaml，不能据此把插件自身问题误判成通用失败
+  if (/ERR_PNPM_IGNORED_BUILDS|Ignored build scripts:/i.test(message)) return 'pnpmIgnoredBuild'
+  // 再判 prepare 实际执行失败：只有构建脚本真的跑挂了才是插件问题
+  if (/ERR_PNPM_PREPARE_PACKAGE|ELIFECYCLE|Command failed|prepare-guard/i.test(message)) return 'pluginPrepare'
+  // 其余失败（含 git prepare 被 pnpm 白名单拦截）：当前通道装不上 = 插件分发/依赖的问题，一律提 Issue
+  return 'repo'
+}
+
+/** 核心行特征：错误代码 / 生命周期脚本失败 / prepare 失败 / 描述性报错（子模块缺失、找不到等）/ 退出与宿主提示信息。 */
+const CORE_LINE_RE = /ERR_[A-Z_]+|ELIFECYCLE|Command failed|prepare-guard|Failed to prepare|exit code|\bprepare\b|pnpm failed in profile|git-hosted plugins build|submodule|not found|cannot find|no such|unable to|fatal|missing|error/i
+/** 提交 issue 时正文里错误摘要的上限字符数。GitHub 请求行上限 8192 字节，
+ * 固定模板与 URL 编码开销约 1~2K，核心错误（以 ASCII 日志为主）可安全带到 ~5K；
+ * 仍超长时 pluginIssueUrl 会逐档缩小核心预算，最终 URL 不会超限。 */
+export const MAX_CORE_CHARS = 5000
+/** 摘要里单行上限：允许构建 key 等长行也被截短。 */
+const MAX_LINE_CHARS = 400
+
+/**
+ * 核心错误收集器：从完整安装输出里挑出真正说明问题的行（错误代码、构建脚本失败、
+ * 退出与宿主提示），去重后拼接，单行与总量都截断 —— 只把「重点 + 原因」带进 issue 正文，
+ * 避免完整日志塞进 URL 导致请求过长。无关键行时退化为「头部 + 尾部」快照。
+ * maxChars 可由调用方按最终 URL 长度收紧（pluginIssueUrl 超限时逐档缩小）。
+ */
+export function summarizeError(message: string, maxChars: number = MAX_CORE_CHARS): string {
+  const seen = new Set<string>()
+  const core: string[] = []
+  for (const raw of message.split(/\r?\n/)) {
+    const line = raw.trim()
+    if (!line || !CORE_LINE_RE.test(line)) continue
+    const short = line.length > MAX_LINE_CHARS ? `${line.slice(0, MAX_LINE_CHARS)}…` : line
+    if (!seen.has(short)) {
+      seen.add(short)
+      core.push(short)
+    }
+  }
+  let out: string
+  if (core.length === 0) {
+    // 无关键行时退化为「头部 + 尾部」快照：优先保尾部完整，头部按预算压缩，总长不超上限
+    const tail = message.trimEnd().slice(-1000)
+    const sep = '\n…\n'
+    const headBudget = Math.max(maxChars - tail.length - sep.length, 0)
+    const head = message.slice(0, 500).trim()
+    out = `${head.length > headBudget ? head.slice(0, headBudget) : head}${sep}${tail}`
+  } else {
+    out = core.join('\n')
+  }
+  return out.length > maxChars ? `${out.slice(0, maxChars)}\n… (truncated)` : out
+}
+
+/** 提取首个错误代码（如 ERR_PNPM_PREPARE_PACKAGE），无则 null。 */
+export function coreErrorCode(message: string): string | null {
+  const m = message.match(/\[?ERR_[A-Z_]+\]?/)
+  return m ? m[0].replace(/^\[|\]$/g, '') : null
+}
+
+/** 运行时 localStorage 访问：类型上不依赖 DOM lib（Node 测试环境也能编译），浏览器里取 window。 */
+const storage = (): Storage | undefined =>
+  (globalThis as { localStorage?: Storage }).localStorage
+
+/** 读取本地通知记录（损坏/不可用时返回空列表，不抛错）。列表最新在前，全部保留，只由「清空」按钮手动移除。 */
+export function loadNotifications(): NotificationRecord[] {
+  try {
+    const raw = storage()?.getItem(KEY)
+    if (!raw) return []
+    const list = JSON.parse(raw) as unknown
+    if (!Array.isArray(list)) return []
+    return list
+      .filter((r): r is NotificationRecord =>
+        !!r && typeof r === 'object' && typeof (r as { message?: unknown }).message === 'string')
+      // 历史失败记录没有 ok 字段：缺省按失败渲染，保证旧数据照常可查
+      .map((r) => ({ ...r, ok: r.ok === true }))
+  } catch {
+    return []
+  }
+}
+
+function save(list: NotificationRecord[]): void {
+  try {
+    storage()?.setItem(KEY, JSON.stringify(list))
+  } catch {
+    /* storage full / unavailable：仅保留内存态，界面仍可查看 */
+  }
+}
+
+/** 追加一条通知记录并持久化，返回更新后的完整列表（最新在前，超上限裁剪）。
+ *  每次成功/失败都各自留痕：同一插件的安装/卸载记录都完整保留、只由「清空」按钮手动移除，
+ *  不会因后续操作被自动覆盖清除。 */
+export function addNotification(record: Omit<NotificationRecord, 'id' | 'at'>): NotificationRecord[] {
+  const prev = loadNotifications()
+  let id = Date.now()
+  while (prev.some((r) => r.id === id)) id += 1
+  const next = [{ ...record, id, at: id }, ...prev].slice(0, MAX)
+  save(next)
+  return next
+}
+
+/** 记录一次失败：携带完整错误日志，供通知中心查看/复制/提 Issue。 */
+export function addFailure(record: Omit<NotificationRecord, 'id' | 'at' | 'ok'>): NotificationRecord[] {
+  return addNotification({ ...record, ok: false })
+}
+
+/** 记录一次成功：轻量记录，不带日志。 */
+export function addSuccess(record: Omit<NotificationRecord, 'id' | 'at' | 'ok' | 'message'>): NotificationRecord[] {
+  return addNotification({ ...record, ok: true, message: '' })
+}
+
+/** 清空全部通知记录，返回空列表。 */
+export function clearNotifications(): NotificationRecord[] {
+  save([])
+  return []
+}
+
+/** 按 id 删除单条通知记录，返回更新后的列表（仅移除该条，不影响其余记录）。 */
+export function removeNotification(id: number): NotificationRecord[] {
+  const next = loadNotifications().filter((r) => r.id !== id)
+  save(next)
+  return next
+}

package/src/client/lib/format.ts

@@ -0,0 +1,22 @@
+/**
+ * Presentation formatters shared across the catalog list and the cards.
+ */
+import type { Translate } from '../types.ts'
+
+/** 星数/分支数的紧凑展示：<1k 原样；千级 1.2k；十万级取整。 */
+export function fmtStars(count?: number): string {
+  if (!count || count <= 0) return '0'
+  if (count < 1000) return String(count)
+  const k = count / 1000
+  return `${k >= 100 ? Math.round(k) : k.toFixed(1).replace(/\.0$/, '')}k`
+}
+
+/** 相对时间：今天 / N 天前 / N 个月前 / N 年前。 */
+export function relTime(iso: string | undefined, t: Translate): string {
+  if (!iso) return ''
+  const days = Math.floor((Date.now() - new Date(iso).getTime()) / 86400000)
+  if (days <= 0) return t('today')
+  if (days < 30) return t('daysAgo', { days })
+  if (days < 365) return t('monthsAgo', { months: Math.floor(days / 30) })
+  return t('yearsAgo', { years: Math.floor(days / 365) })
+}