@konnga/dsh-hud 0.7.1 → 0.8.0

package/lib/index.js

@@ -256,7 +256,10 @@ export async function readStatus(cwd) {
     return { repo: null, branch: null, detached: false, oid: null, upstream: null, ahead: 0, behind: 0, dirty: false, counts: emptyCounts(), changes: [], truncated: false }
   }
 
-  const status = await runGit(repoRoot, ['status', '--porcelain=v2', '--branch', '-z', '--untracked-files=normal'])
+  // `--untracked-files=all`：未跟踪**按文件**计，而不是把整个未跟踪目录折成一条。
+  // 不这样写的话，`?n` 会比编辑器（以及 `git status -uall`）报的数小得多 —— 目录里 200 个新文件
+  // 只算 1 条。代价是 git 要走一遍未跟踪树，所以清单仍受 `MAX_CHANGES` 上限保护（超出置 truncated）。
+  const status = await runGit(repoRoot, ['status', '--porcelain=v2', '--branch', '-z', '--untracked-files=all'])
   if (!status.ok) {
     if (status.killed) throw Object.assign(new Error('git status timed out'), { code: 'timeout' })
     throw Object.assign(new Error(status.stderr.trim() || status.message || 'git status failed'), { code: 'git-failed' })
@@ -318,12 +321,29 @@ export async function readSessionOverview() {
       mine: entry === undefined ? 0 : entry.files.size,
       possible: entry === undefined ? 0 : entry.possible.size,
     }
-    if (row.cwd === null) return { ...summary, repo: false, error: null }
+    /**
+     * 「可能相关」里**此刻仍然有差异**的个数（与这份 status 的清单求交）。
+     *
+     * 为什么要两个数：`possible` 是"命令里提到过的路径"（历史，含已经还原/被忽略的），
+     * 面板那一行只数"现在还有差异"的。同一个概念两个口径，界面上必须分别说清，
+     * 否则就会出现"工作区干净 + 14 个可能相关"这种让人以为算错了的组合。
+     */
+    const possibleNow = entry === undefined
+      ? 0
+      : (() => {
+        const status = row.cwd === null ? undefined : byCwd.get(row.cwd)
+        if (status === undefined || status === null || Array.isArray(status.changes) !== true) return 0
+        let count = 0
+        for (const change of status.changes) if (entry.possible.has(change.file)) count += 1
+        return count
+      })()
+    if (row.cwd === null) return { ...summary, possibleNow: 0, repo: false, error: null }
     const status = byCwd.get(row.cwd)
-    if (status === undefined || status === null) return { ...summary, repo: false, error: null, pending: true }
-    if (status.error !== undefined) return { ...summary, repo: false, error: status.error }
+    if (status === undefined || status === null) return { ...summary, possibleNow: 0, repo: false, error: null, pending: true }
+    if (status.error !== undefined) return { ...summary, possibleNow: 0, repo: false, error: status.error }
     return {
       ...summary,
+      possibleNow,
       repo: status.repo !== null,
       branch: status.branch,
       detached: status.detached === true,
@@ -758,6 +778,78 @@ async function resolveCommit(cwd, sha) {
 }
 
 /** 这次提交的改动清单 + 元信息（只读 `git diff` / `git show`）。 */
+/** 标签列表上限（超出的只报 truncated，不硬塞）。 */
+const TAGS_MAX = 100
+
+/**
+ * 读标签列表（`refs/tags`，按 creatordate 倒序 = 最新的在前）。
+ *
+ * 两处容易搞错、这里显式处理：
+ * - **附注 tag**（annotated）的 `%(objectname)` 是 **tag 对象**的 sha，不是它指向的提交；
+ *   要拿提交得用 `%(*objectname)`。轻量 tag 两者相同。列表里显示提交 sha（能对上“最近提交”）。
+ * - 主题用 `%(contents:subject)`：附注 tag 是 tag 说明的首行，轻量 tag 拿到的是提交标题 ——
+ *   两种情况都比只给一个名字有用；它理论上可以是多行，所以最后一个字段按“剩下全部”再取首行。
+ */
+export async function readTags(cwd, count = TAGS_MAX) {
+  const root = await runGit(cwd, ['rev-parse', '--show-toplevel'])
+  if (!root.ok) {
+    if (root.killed) throw Object.assign(new Error('git rev-parse timed out'), { code: 'timeout' })
+    if (root.code === 'ENOENT' && !fs.existsSync(cwd)) throw Object.assign(new Error('cwd does not exist'), { code: 'no-cwd' })
+    if (root.code === 'ENOENT') throw Object.assign(new Error('git executable not found'), { code: 'git-missing' })
+    return { repo: null, tags: [], truncated: false }
+  }
+
+  const repoRoot = root.stdout.split('\n')[0].trim()
+  if (!repoRoot) return { repo: null, tags: [], truncated: false }
+
+  const requested = Number.isFinite(count) ? Math.floor(count) : TAGS_MAX
+  const limit = Math.min(Math.max(1, requested), TAGS_MAX)
+
+  // 多取一条用来判断“还有更多”（比事后猜“正好等于上限”准确）。
+  const result = await runGit(repoRoot, [
+    'for-each-ref',
+    '--sort=-creatordate',
+    `--count=${String(limit + 1)}`,
+    '--format=%(refname:short)%00%(objecttype)%00%(objectname:short)%00%(*objectname:short)%00%(creatordate:short)%00%(creatordate:unix)%00%(contents:subject)',
+    'refs/tags',
+  ])
+  // 没有 tag 时 git 也返回 0（输出为空），不是错误。
+  if (!result.ok) return { repo: repoRoot, tags: [], truncated: false }
+
+  const lines = result.stdout.split('\n').filter(line => line.length > 0)
+  const tags = lines.map((line) => {
+    const parts = line.split('\0')
+    const [name, objecttype, objectname, peeled, date, seconds] = parts
+    // 最后一个字段是主题：附注 tag 的说明可能是多行，这里只取首行。
+    const subject = parts.slice(6).join('\0').split('\n')[0] ?? ''
+    const at = Number(seconds)
+    const annotated = objecttype === 'tag'
+    // 附注 tag 要“剥一层”拿提交 sha；剥不出来（比如 tag 指向 blob/tree）就退回对象自身的 sha。
+    const sha = annotated && peeled ? peeled : objectname
+    return {
+      name: name ?? '',
+      sha: sha ?? '',
+      annotated,
+      date: date ?? '',
+      committedAt: Number.isFinite(at) ? at * 1000 : null,
+      subject,
+    }
+  })
+
+  // creatordate 同一个秒内的先后 git 不保证（测试里三个 tag 常在同一秒建出来），
+  // 再按名字倒序定死 —— 否则界面上同批 tag 每次刷新都可能换位置。
+  //
+  // 顺序：**先排序再截断**。反过来的话截出来的是 git 的任意顺序（t1、t2），排序再好也没用。
+  tags.sort((left, right) => {
+    const diff = (right.committedAt ?? 0) - (left.committedAt ?? 0)
+    if (diff !== 0) return diff
+    return left.name < right.name ? 1 : (left.name > right.name ? -1 : 0)
+  })
+
+  const truncated = tags.length > limit
+  return { repo: repoRoot, tags: tags.slice(0, limit), truncated }
+}
+
 export async function readCommit(cwd, sha) {
   const commit = await resolveCommit(cwd, sha)
   if (!commit.repo) return { repo: null, commit: null, files: [], truncated: false }
@@ -858,6 +950,161 @@ const SESSION_COMMAND_MAX = 20
 const COMMAND_TEXT_MAX = 140
 /** 一条命令里最多抽多少个路径（防御性上限）。 */
 const COMMAND_PATHS_MAX = 20
+/** 每个会话留多少条"最近工具调用"（胶囊悬停里列最近几条）。 */
+const TOOL_RECENT_MAX = 12
+/** 最多同时记多少个会话的工具活动（与归因那份各自独立淘汰）。 */
+const TOOL_SESSIONS_MAX = 32
+/** 每个会话最多记多少个技能（超出的只计数不列名）。 */
+const TOOL_SKILLS_MAX = 20
+/** 参数摘要的显示上限（超长命令/路径截断，别把胶囊撑爆）。 */
+const TOOL_SUMMARY_MAX = 60
+
+/**
+ * sessionId → { active, recent, counts, total }：这个会话**跑到哪些工具**。
+ *
+ * 与归因那份记录分开存：归因关心"改了哪些文件"，这份关心"跑了什么"。
+ */
+const sessionTools = new Map()
+
+/** 取（必要时新建）某个会话的工具活动记录，并做数量上限淘汰。 */
+function sessionToolEntry(sessionId) {
+  let entry = sessionTools.get(sessionId)
+  if (entry === undefined) {
+    entry = { active: null, recent: [], counts: new Map(), status: new Map(), skills: new Map(), total: 0 }
+    sessionTools.set(sessionId, entry)
+    if (sessionTools.size > TOOL_SESSIONS_MAX) {
+      const oldest = sessionTools.keys().next().value
+      if (oldest !== undefined && oldest !== sessionId) sessionTools.delete(oldest)
+    }
+  }
+  return entry
+}
+
+/**
+ * 参数里可以安全拿出来做"一行摘要"的键。
+ *
+ * 只认这些**路径/命令类**的键：工具参数里可能带着整个文件内容（write 的 `content`），
+ * 随便取"第一个字符串"就会把内容贴到界面上 —— 所以认不出来就干脆不写摘要。
+ */
+const TOOL_SUMMARY_KEYS = ['command', 'cmd', 'script', 'filePath', 'path', 'file', 'pattern', 'query', 'url']
+
+/** 「调用技能」那件工具的工具名（`dsh-tool-skill` 注册的名字）。 */
+const SKILL_TOOL_NAME = 'skill'
+
+/**
+ * 技能名：`skill` 工具的入参是 `{ name: '技能名' }`。
+ *
+ * 只对这一个工具认 `name` 键 —— 别的工具用 `name` 表达别的东西，不能被当技能名抓走。
+ */
+function skillNameOf(exec) {
+  if (exec === null || typeof exec !== 'object' || exec.name !== SKILL_TOOL_NAME) return null
+  const args = exec.arguments
+  if (args === null || typeof args !== 'object') return null
+  const value = args.name
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim().slice(0, TOOL_SUMMARY_MAX) : null
+}
+
+/** 从工具调用参数里取一行摘要（认不出来返回 null，不用兜底去猜）。 */
+function toolSummaryOf(exec) {
+  const skill = skillNameOf(exec)
+  if (skill !== null) return skill
+  const args = exec && exec.arguments
+  if (args === null || typeof args !== 'object') return null
+  for (const key of TOOL_SUMMARY_KEYS) {
+    const value = args[key]
+    if (typeof value === 'string' && value.trim().length > 0) {
+      return value.replace(/\s+/g, ' ').trim().slice(0, TOOL_SUMMARY_MAX)
+    }
+  }
+  return null
+}
+
+/** 工具开跑：记下"现在是哪个工具、什么时候开始的"（供胶囊显示实时秒数）。 */
+function noteToolStart(exec) {
+  try {
+    const identity = sessionIdentityOf(exec)
+    if (identity === null) return
+    const entry = sessionToolEntry(identity.sessionId)
+    entry.active = {
+      callId: identity.callId,
+      name: typeof exec.name === 'string' && exec.name.length > 0 ? exec.name : '?',
+      summary: toolSummaryOf(exec),
+      startedAt: Date.now(),
+    }
+    entry.total += 1
+    const name = entry.active.name
+    entry.counts.set(name, (entry.counts.get(name) || 0) + 1)
+    const skill = skillNameOf(exec)
+    if (skill !== null) {
+      const seen = entry.skills.get(skill)
+      entry.skills.set(skill, { count: (seen ? seen.count : 0) + 1, ok: seen ? seen.ok : null })
+    }
+  } catch {
+    // 旁听失败不影响工具本身。
+  }
+}
+
+/** 工具结束：把这一次挪进"最近"，并清掉 active（只有同一个 callId 才清，避免并发调用互相抹掉）。 */
+function noteToolFinish(exec, result) {
+  try {
+    const identity = sessionIdentityOf(exec)
+    if (identity === null) return
+    const entry = sessionToolEntry(identity.sessionId)
+    const active = entry.active
+    const startedAt = active !== null && active.callId === identity.callId ? active.startedAt : null
+    entry.recent.push({
+      name: active !== null && active.callId === identity.callId ? active.name : (typeof exec.name === 'string' ? exec.name : '?'),
+      summary: active !== null && active.callId === identity.callId ? active.summary : toolSummaryOf(exec),
+      ok: !resultFailed(result),
+      at: Date.now(),
+      ms: startedAt === null ? null : Math.max(0, Date.now() - startedAt),
+    })
+    if (entry.recent.length > TOOL_RECENT_MAX) entry.recent.splice(0, entry.recent.length - TOOL_RECENT_MAX)
+    // 每个工具"最近一次调用"的结果：胶囊上每个工具前面那个 ✓/✗ 用它。
+    const finished = entry.recent[entry.recent.length - 1]
+    if (finished !== undefined) entry.status.set(finished.name, finished.ok === true)
+    // 技能自己的最近一次结果（胶囊上可以据此打 ✓/✗）。
+    const skill = skillNameOf(exec)
+    if (skill !== null && entry.skills.has(skill)) {
+      entry.skills.set(skill, { count: entry.skills.get(skill).count, ok: !resultFailed(result) })
+    }
+    if (active !== null && active.callId === identity.callId) entry.active = null
+  } catch {
+    // 同上。
+  }
+}
+
+/**
+ * 读出某个会话的工具活动（端点载荷）。
+ *
+ * `active` 带 `startedAt`：实时秒数由客户端本地计时（否则要为了一个秒数把轮询压到亚秒级 ✗）。
+ */
+export function readSessionTools(sessionId) {
+  const entry = sessionId === null || sessionId === undefined ? undefined : sessionTools.get(sessionId)
+  if (entry === undefined) {
+    return { sessionId: sessionId ?? null, tracking: true, active: null, recent: [], counts: [], skills: [], skillsDropped: 0, total: 0 }
+  }
+  const counts = [...entry.counts].map(([name, count]) => ({
+    name,
+    count,
+    // `null` = 还没看到它结束过（比如正在跑第一次），别替它编一个 ✓。
+    ok: entry.status.has(name) ? entry.status.get(name) : null,
+  }))
+  counts.sort((left, right) => right.count - left.count || (left.name < right.name ? -1 : 1))
+  // 技能按次数排序（用得多在前），超过上限只报前若干个。
+  const skills = [...entry.skills].map(([name, item]) => ({ name, count: item.count, ok: item.ok }))
+  skills.sort((left, right) => right.count - left.count || (left.name < right.name ? -1 : 1))
+  return {
+    sessionId,
+    tracking: true,
+    active: entry.active === null ? null : { ...entry.active },
+    recent: entry.recent.slice(-5).reverse(),
+    counts,
+    skills: skills.slice(0, TOOL_SKILLS_MAX),
+    skillsDropped: Math.max(0, skills.length - TOOL_SKILLS_MAX),
+    total: entry.total,
+  }
+}
 
 /** sessionId → { cwd, since, files: Map<relPath, {...}>, dropped, unconfirmed }。 */
 const sessionChanges = new Map()
@@ -1316,8 +1563,15 @@ function trackSessionChanges(ctx) {
       }),
       // 命令旁听：`tools/post-execute` 是 waterfall，**必须把 next() 的判定原样透传**
       // （兜底是 `{ kind: 'accept' }`，吞掉就等于把工具结果的裁决改掉了）。
+      // 工具开跑：记"现在在跑哪个工具"（胶囊显示实时秒数用）。
+      // `tools/pre-execute` 同样是 waterfall（兜底 `{ kind: 'allow' }`），必须原样透传判定。
+      ctx.on('tools/pre-execute', (exec, next) => {
+        noteToolStart(exec)
+        return next()
+      }),
       ctx.on('tools/post-execute', (exec, result, next) => {
         noteShellCommand(exec, result)
+        noteToolFinish(exec, result)
         return next()
       }),
     ]
@@ -1351,6 +1605,7 @@ function trackSessionChanges(ctx) {
       for (const stop of stops) if (typeof stop === 'function') stop()
       sessionChanges.clear()
       pendingChangeIntents.clear()
+      sessionTools.clear()
       sessionChangeTrackingSince = null
     }
   }, 'dsh-hud: session change tracking')
@@ -1373,6 +1628,12 @@ const ENDPOINTS = {
     return status
   },
 
+  async 'session-tools'(args) {
+    const input = args && typeof args === 'object' ? args : {}
+    const sessionId = typeof input.sessionId === 'string' && input.sessionId.length > 0 ? input.sessionId : null
+    return readSessionTools(sessionId)
+  },
+
   async 'session-statuses'() {
     return readSessionOverview()
   },
@@ -1401,6 +1662,13 @@ const ENDPOINTS = {
     return readLog(cwd.value, input.count)
   },
 
+  /** 标签列表（只读）。点一个 tag 复用 `commit` 那条管道去看它指向的提交。 */
+  async tags(args) {
+    const input = args && typeof args === 'object' ? args : {}
+    const cwd = validateCwd(input.cwd)
+    if (!cwd.ok) throw Object.assign(new Error(cwd.message), { code: cwd.code })
+    return readTags(cwd.value, input.count)
+  },
   async commit(args) {
     const input = args && typeof args === 'object' ? args : {}
     const cwd = validateCwd(input.cwd)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@konnga/dsh-hud",
-  "version": "0.7.1",
-  "description": "DeepSeek Harness 的当前项目 Git 悬浮面板：分支、ahead/behind、脏状态与改动清单（只读），并告诉你这个会话改过哪些文件（按会话归因：确定改过 / 命令旁听的「可能相关」/ 与本会话无关，精确到第几轮）、审阅到哪了（已审 x/y），以及侧栏会话行的状态标记。A read-only Git HUD floating panel for DeepSeek Harness — branch, ahead/behind, dirty state, changed files — plus per-session change attribution (confirmed / command-inferred / per turn), review progress, and sidebar session status.",
+  "version": "0.8.0",
+  "description": "DeepSeek Harness 的只读工作区 Git 面板：分支、ahead/behind、改动清单与差异，外加「这个会话改过哪些文件、审到哪了、跑了什么工具」。A read-only workspace Git panel for DeepSeek Harness — branch, changed files, diffs, plus per-session change attribution, review progress, and tool activity.",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -13,11 +13,13 @@
     "lib",
     "cordis.patch.yml",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "docs/images"
   ],
   "scripts": {
     "test": "node --test test/*.test.mjs",
-    "prepublishOnly": "npm test"
+    "prepublishOnly": "npm test && node scripts/check-release.mjs",
+    "tag": "node scripts/check-release.mjs --create"
   },
   "keywords": [
     "dsh",
@@ -35,6 +37,14 @@
   ],
   "license": "MIT",
   "author": "konnga",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/konnga/dsh-hud.git"
+  },
+  "homepage": "https://github.com/konnga/dsh-hud#readme",
+  "bugs": {
+    "url": "https://github.com/konnga/dsh-hud/issues"
+  },
   "publishConfig": {
     "access": "public"
   },