hermes-pilot 0.0.0-stage → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/LICENSE +21 -0
  2. package/README.ja.md +419 -0
  3. package/README.md +428 -2
  4. package/__init__.py +15 -0
  5. package/apps/bridge/src/api-errors.js +165 -0
  6. package/apps/bridge/src/architect.js +1298 -0
  7. package/apps/bridge/src/auth.js +202 -0
  8. package/apps/bridge/src/capabilities.js +256 -0
  9. package/apps/bridge/src/capture.js +145 -0
  10. package/apps/bridge/src/chat-profile.js +95 -0
  11. package/apps/bridge/src/config.js +73 -0
  12. package/apps/bridge/src/discord.js +89 -0
  13. package/apps/bridge/src/gitinfo.js +211 -0
  14. package/apps/bridge/src/hermes.js +97 -0
  15. package/apps/bridge/src/inbox.js +347 -0
  16. package/apps/bridge/src/kanban.js +361 -0
  17. package/apps/bridge/src/lang.js +60 -0
  18. package/apps/bridge/src/live.js +285 -0
  19. package/apps/bridge/src/memos.js +150 -0
  20. package/apps/bridge/src/ops.js +201 -0
  21. package/apps/bridge/src/pair-codes.js +125 -0
  22. package/apps/bridge/src/pipeline-optimizer.js +513 -0
  23. package/apps/bridge/src/pipeline-watcher.js +1022 -0
  24. package/apps/bridge/src/qr.js +808 -0
  25. package/apps/bridge/src/repos.js +544 -0
  26. package/apps/bridge/src/review-watcher.js +271 -0
  27. package/apps/bridge/src/review.js +1749 -0
  28. package/apps/bridge/src/search.js +162 -0
  29. package/apps/bridge/src/server.js +1745 -0
  30. package/apps/bridge/src/snippets.js +373 -0
  31. package/apps/bridge/src/specs.js +806 -0
  32. package/apps/bridge/src/tail.js +28 -0
  33. package/apps/bridge/src/telemetry.js +667 -0
  34. package/apps/bridge/src/term-snippets.js +228 -0
  35. package/apps/bridge/src/transcript.js +231 -0
  36. package/apps/bridge/src/usage.js +294 -0
  37. package/apps/bridge/src/workerFeed.js +72 -0
  38. package/apps/dashboard/index.js +2014 -0
  39. package/apps/dashboard/manifest.json +14 -0
  40. package/apps/dashboard/pilot_dashboard.py +1466 -0
  41. package/apps/dashboard/plugin_api.py +237 -0
  42. package/apps/dashboard/plugin_init.py +15 -0
  43. package/apps/dashboard/style.css +928 -0
  44. package/apps/web/dist/assets/TermPane-DYP7pi_n.css +32 -0
  45. package/apps/web/dist/assets/TermPane-q4f5Zu0I.js +12 -0
  46. package/apps/web/dist/assets/index-BzUof8lw.js +94 -0
  47. package/apps/web/dist/assets/index-DwZdbPU7.css +1 -0
  48. package/apps/web/dist/favicon.ico +0 -0
  49. package/apps/web/dist/icon-180-v6.png +0 -0
  50. package/apps/web/dist/icon-192-v6.png +0 -0
  51. package/apps/web/dist/icon-512-v6.png +0 -0
  52. package/apps/web/dist/icon-maskable-192-v6.png +0 -0
  53. package/apps/web/dist/icon-maskable-512-v6.png +0 -0
  54. package/apps/web/dist/icon-v6.svg +15 -0
  55. package/apps/web/dist/index.html +21 -0
  56. package/apps/web/dist/manifest.webmanifest +49 -0
  57. package/apps/web/dist/sw.js +69 -0
  58. package/bin/hermes-pilot.mjs +964 -0
  59. package/dashboard/dist/index.js +2014 -0
  60. package/dashboard/dist/style.css +928 -0
  61. package/dashboard/manifest.json +14 -0
  62. package/dashboard/pilot_dashboard.py +1466 -0
  63. package/dashboard/plugin_api.py +237 -0
  64. package/package.json +75 -4
  65. package/plugin.json +70 -0
  66. package/plugin.yaml +4 -0
  67. package/scripts/deploy.mjs +58 -0
  68. package/scripts/migrate-to-hermes-pilot.mjs +472 -0
  69. package/scripts/postinstall.mjs +32 -0
  70. package/scripts/sync-dashboard.mjs +98 -0
  71. package/skills/annotation/SKILL.md +138 -0
  72. package/skills/quick-review/SKILL.md +200 -0
  73. package/skills/quick-review/assets/sheet-template.html +175 -0
  74. package/skills/spec-architect/SKILL.md +226 -0
@@ -0,0 +1,294 @@
1
+ import fs from 'node:fs'
2
+ import path from 'node:path'
3
+ import { DatabaseSync } from 'node:sqlite'
4
+
5
+ /**
6
+ * 使用量(コスト・トークン)の集計。
7
+ *
8
+ * `~/.hermes/state.db` を **読み取り専用** で開き、`sessions` と
9
+ * `session_model_usage` を集計するだけ。本文は一切読まない。
10
+ * リアルタイム性は不要なので、結果を 30 秒キャッシュする。
11
+ */
12
+
13
+ const CACHE_MS = 30_000
14
+
15
+ export function createUsage(cfg = {}) {
16
+ const dbPath = cfg.stateDb ?? path.join(cfg.home ?? '', '.hermes', 'state.db')
17
+ let cache = { at: 0, key: null, data: null }
18
+
19
+ /**
20
+ * 1つの DB から期間内の使用量を読む。
21
+ * @param {{profile: string, path: string}} target DB情報
22
+ * @param {number} since 開始秒
23
+ * @returns {{totals: object, models: Array<object>, topSessions: Array<object>}} 部分集計
24
+ */
25
+ function summarizeOne(target, since) {
26
+ let db
27
+ try {
28
+ db = new DatabaseSync(target.path, { readOnly: true })
29
+ const t = db
30
+ .prepare(
31
+ `SELECT COUNT(*) AS sessions,
32
+ COALESCE(SUM(input_tokens), 0) AS input,
33
+ COALESCE(SUM(output_tokens), 0) AS output,
34
+ COALESCE(SUM(cache_read_tokens), 0) AS cacheRead,
35
+ COALESCE(SUM(cache_write_tokens), 0) AS cacheWrite,
36
+ COALESCE(SUM(reasoning_tokens), 0) AS reasoning,
37
+ COALESCE(SUM(estimated_cost_usd), 0) AS cost,
38
+ COALESCE(SUM(api_call_count), 0) AS calls,
39
+ COALESCE(SUM(message_count), 0) AS messages,
40
+ COALESCE(SUM(tool_call_count), 0) AS tools
41
+ FROM sessions
42
+ WHERE last_activity_at > ?`,
43
+ )
44
+ .get(since)
45
+
46
+ const models = db
47
+ .prepare(
48
+ `SELECT u.model,
49
+ COALESCE(SUM(u.input_tokens), 0) AS input,
50
+ COALESCE(SUM(u.output_tokens), 0) AS output,
51
+ COALESCE(SUM(u.cache_read_tokens), 0) AS cacheRead,
52
+ COALESCE(SUM(u.estimated_cost_usd), 0) AS cost,
53
+ COALESCE(SUM(u.api_call_count), 0) AS calls
54
+ FROM session_model_usage u
55
+ JOIN sessions s ON s.id = u.session_id
56
+ WHERE s.last_activity_at > ?
57
+ GROUP BY u.model
58
+ ORDER BY cost DESC`,
59
+ )
60
+ .all(since)
61
+
62
+ const top = db
63
+ .prepare(
64
+ `SELECT id, title, source, estimated_cost_usd AS cost, input_tokens AS input,
65
+ output_tokens AS output, last_activity_at AS at
66
+ FROM sessions
67
+ WHERE last_activity_at > ?
68
+ ORDER BY estimated_cost_usd DESC
69
+ LIMIT 5`,
70
+ )
71
+ .all(since)
72
+
73
+ return {
74
+ totals: {
75
+ sessions: Number(t?.sessions ?? 0),
76
+ input: Number(t?.input ?? 0),
77
+ output: Number(t?.output ?? 0),
78
+ cacheRead: Number(t?.cacheRead ?? 0),
79
+ cacheWrite: Number(t?.cacheWrite ?? 0),
80
+ reasoning: Number(t?.reasoning ?? 0),
81
+ cost: Number(t?.cost ?? 0),
82
+ calls: Number(t?.calls ?? 0),
83
+ messages: Number(t?.messages ?? 0),
84
+ tools: Number(t?.tools ?? 0),
85
+ },
86
+ models: models.map((m) => ({
87
+ model: m.model ?? '(不明)',
88
+ input: Number(m.input ?? 0),
89
+ output: Number(m.output ?? 0),
90
+ cacheRead: Number(m.cacheRead ?? 0),
91
+ cost: Number(m.cost ?? 0),
92
+ calls: Number(m.calls ?? 0),
93
+ })),
94
+ topSessions: top.map((s) => ({
95
+ profile: target.profile || 'default',
96
+ id: s.id,
97
+ title: s.title || s.id,
98
+ source: s.source ?? '',
99
+ cost: Number(s.cost ?? 0),
100
+ input: Number(s.input ?? 0),
101
+ output: Number(s.output ?? 0),
102
+ at: Math.round(Number(s.at ?? 0) * 1000),
103
+ })),
104
+ }
105
+ } finally {
106
+ try {
107
+ db?.close()
108
+ } catch {
109
+ /* noop */
110
+ }
111
+ }
112
+ }
113
+
114
+ /**
115
+ * 期間内の合計と内訳を返す。
116
+ * @param {{hours?: number, dbs?: Array<{profile: string, path: string}>}} [opts] 条件(既定24時間)
117
+ * @returns {object} 集計
118
+ */
119
+ function summary(opts = {}) {
120
+ const hours = Math.min(Math.max(Number(opts.hours ?? 24) || 24, 1), 24 * 30)
121
+ const rawDbs = Array.isArray(opts.dbs) && opts.dbs.length ? opts.dbs : [{ profile: 'default', path: dbPath }]
122
+ const targets = rawDbs.filter((d) => d?.path && fs.existsSync(d.path))
123
+ if (!targets.length) return { ok: false, reason: 'state.db が見つかりません' }
124
+
125
+ const cacheKey = `${hours}:${targets.map((d) => d.path).join('|')}`
126
+ if (cache.data && cache.key === cacheKey && Date.now() - cache.at < CACHE_MS) return cache.data
127
+
128
+ const since = Date.now() / 1000 - hours * 3600
129
+ const totals = {
130
+ sessions: 0,
131
+ input: 0,
132
+ output: 0,
133
+ cacheRead: 0,
134
+ cacheWrite: 0,
135
+ reasoning: 0,
136
+ cost: 0,
137
+ calls: 0,
138
+ messages: 0,
139
+ tools: 0,
140
+ }
141
+ const modelMap = new Map()
142
+ const topSessions = []
143
+ let firstErr = null
144
+ let succeeded = 0
145
+
146
+ for (const target of targets) {
147
+ try {
148
+ const part = summarizeOne(target, since)
149
+ succeeded++
150
+ for (const k of Object.keys(totals)) totals[k] += part.totals[k]
151
+ for (const m of part.models) {
152
+ const prev = modelMap.get(m.model) ?? { model: m.model, input: 0, output: 0, cacheRead: 0, cost: 0, calls: 0 }
153
+ prev.input += m.input
154
+ prev.output += m.output
155
+ prev.cacheRead += m.cacheRead
156
+ prev.cost += m.cost
157
+ prev.calls += m.calls
158
+ modelMap.set(m.model, prev)
159
+ }
160
+ topSessions.push(...part.topSessions)
161
+ } catch (e) {
162
+ if (!firstErr) firstErr = e
163
+ }
164
+ }
165
+
166
+ if (!succeeded && firstErr) {
167
+ return { ok: false, reason: `集計に失敗しました: ${firstErr.message}` }
168
+ }
169
+
170
+ const denom = totals.input + totals.cacheRead
171
+ const data = {
172
+ ok: true,
173
+ hours,
174
+ since: Math.round(since * 1000),
175
+ totals,
176
+ cacheHitRate: denom > 0 ? totals.cacheRead / denom : null,
177
+ models: [...modelMap.values()].sort((a, b) => b.cost - a.cost),
178
+ topSessions: topSessions.sort((a, b) => b.cost - a.cost).slice(0, 5),
179
+ }
180
+ cache = { at: Date.now(), key: cacheKey, data }
181
+ return data
182
+ }
183
+
184
+ /**
185
+ * スコープ(セッション ID 群 or 時間範囲)に限定した使用量を返す(SPEC-PILOT-V7 §3.2 ②)。
186
+ *
187
+ * 完了レシート・完了報告の `apiCalls` / `totalTokens` は「その Spec / Run の分だけ」で
188
+ * なければ意味がないため、全期間合算の `summary()` とは別に用意する。
189
+ *
190
+ * 絞り込み規則:
191
+ * - `sessionIds` があれば **そのセッション群のみ**
192
+ * - 無ければ `sinceMs`〜`untilMs`(Run の実区間)で時間窓フォールバック(`scope.fallback: true`)
193
+ * - どちらも無ければ `ok: false`(誤って全体を混ぜない)
194
+ *
195
+ * @param {{sessionIds?: Array<string>, sinceMs?: number, untilMs?: number, dbs?: Array<{profile: string, path: string}>}} [opts] スコープ
196
+ * @returns {{
197
+ * ok: boolean, reason?: string, apiCalls?: number, totalTokens?: number,
198
+ * cacheHitRate?: number|null, scope?: object, totals?: object
199
+ * }} スコープ集計
200
+ */
201
+ function scoped(opts = {}) {
202
+ const ids = [
203
+ ...new Set(
204
+ (Array.isArray(opts.sessionIds) ? opts.sessionIds : [])
205
+ .map((v) => String(v ?? '').trim())
206
+ .filter(Boolean),
207
+ ),
208
+ ].slice(0, 500)
209
+ const sinceMs = Number(opts.sinceMs) || 0
210
+ const untilMs = Number(opts.untilMs) || 0
211
+ const rawDbs = Array.isArray(opts.dbs) && opts.dbs.length ? opts.dbs : [{ profile: 'default', path: dbPath }]
212
+ const targets = rawDbs.filter((d) => d?.path && fs.existsSync(d.path))
213
+ if (!targets.length) return { ok: false, reason: 'state.db が見つかりません' }
214
+ if (!ids.length && !sinceMs) return { ok: false, reason: 'スコープが指定されていません' }
215
+
216
+ const totals = { sessions: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, calls: 0 }
217
+ let succeeded = 0
218
+ let firstErr = null
219
+ for (const target of targets) {
220
+ let db
221
+ try {
222
+ db = new DatabaseSync(target.path, { readOnly: true })
223
+ const where = []
224
+ const params = []
225
+ if (ids.length) {
226
+ // セッション ID が特定できたらその群のみ(時間窓は使わない)
227
+ where.push(`id IN (${ids.map(() => '?').join(',')})`)
228
+ params.push(...ids)
229
+ } else {
230
+ // 特定できなければ Run の有効時間範囲でフォールバック
231
+ where.push(
232
+ `COALESCE(last_activity_at, started_at) >= ?${untilMs > 0 ? ' AND COALESCE(last_activity_at, started_at) <= ?' : ''}`,
233
+ )
234
+ params.push(sinceMs / 1000)
235
+ if (untilMs > 0) params.push(untilMs / 1000)
236
+ }
237
+ const rowSql = (whereSql) =>
238
+ `SELECT COUNT(*) AS sessions,
239
+ COALESCE(SUM(input_tokens), 0) AS input,
240
+ COALESCE(SUM(output_tokens), 0) AS output,
241
+ COALESCE(SUM(cache_read_tokens), 0) AS cacheRead,
242
+ COALESCE(SUM(cache_write_tokens), 0) AS cacheWrite,
243
+ COALESCE(SUM(estimated_cost_usd), 0) AS cost,
244
+ COALESCE(SUM(api_call_count), 0) AS calls
245
+ FROM sessions
246
+ WHERE ${whereSql}`
247
+ let row
248
+ try {
249
+ row = db.prepare(rowSql(where.join(' OR '))).get(...params)
250
+ } catch {
251
+ // `started_at` が無い古いスキーマ・テスト用 DB は last_activity_at だけで絞る
252
+ const simple = where
253
+ .map((w) => w.replaceAll('COALESCE(last_activity_at, started_at)', 'last_activity_at'))
254
+ .join(' OR ')
255
+ row = db.prepare(rowSql(simple)).get(...params)
256
+ }
257
+ succeeded += 1
258
+ totals.sessions += Number(row?.sessions ?? 0)
259
+ totals.input += Number(row?.input ?? 0)
260
+ totals.output += Number(row?.output ?? 0)
261
+ totals.cacheRead += Number(row?.cacheRead ?? 0)
262
+ totals.cacheWrite += Number(row?.cacheWrite ?? 0)
263
+ totals.cost += Number(row?.cost ?? 0)
264
+ totals.calls += Number(row?.calls ?? 0)
265
+ } catch (e) {
266
+ if (!firstErr) firstErr = e
267
+ } finally {
268
+ try {
269
+ db?.close()
270
+ } catch {
271
+ /* noop */
272
+ }
273
+ }
274
+ }
275
+ if (!succeeded && firstErr) return { ok: false, reason: `スコープ集計に失敗しました: ${firstErr.message}` }
276
+
277
+ const denom = totals.input + totals.cacheRead
278
+ return {
279
+ ok: true,
280
+ scope: {
281
+ sessionIds: ids.length,
282
+ sinceMs: sinceMs || null,
283
+ untilMs: untilMs || null,
284
+ fallback: ids.length === 0,
285
+ },
286
+ apiCalls: totals.calls,
287
+ totalTokens: totals.input + totals.output + totals.cacheRead + totals.cacheWrite,
288
+ cacheHitRate: denom > 0 ? totals.cacheRead / denom : null,
289
+ totals,
290
+ }
291
+ }
292
+
293
+ return { summary, scoped }
294
+ }
@@ -0,0 +1,72 @@
1
+ /**
2
+ * 実行ワーカーのトランスクリプト(`<WorkerFeed>`)を読むための DB 選択。
3
+ *
4
+ * 1 つのセッションの会話は、その worker が動いたプロファイルの `state.db` にしか無い。
5
+ * カンバンのタスク行(`tasks.session_id`)には DB のパスが残らないので、
6
+ * `task_events` の `owner_admitted` payload にある `db` を最優先し、無ければ
7
+ * 全プロファイルの `state.db` を横断して **messages が 1 件以上あった DB** を採用する。
8
+ *
9
+ * ここは純粋な選択ロジックだけを持つ(`node:fs` も `node:sqlite` も触らない)ので、
10
+ * ブリッジを起動せずにテストできる。
11
+ */
12
+
13
+ /**
14
+ * 候補 DB の並び(`info.db` 優先 → `stateDbs` の順、重複除去)。
15
+ * @param {{db?: string|null}} [info] イベント由来の情報
16
+ * @param {Array<{profile: string, path: string}>} [stateDbs] `listStateDbs()` の結果
17
+ * @returns {Array<{profile: string, path: string}>} 候補
18
+ */
19
+ export function feedCandidates(info = {}, stateDbs = []) {
20
+ const out = []
21
+ const seen = new Set()
22
+ const push = (profile, path) => {
23
+ const p = String(path ?? '')
24
+ if (!p || seen.has(p)) return
25
+ seen.add(p)
26
+ out.push({ profile: String(profile ?? ''), path: p })
27
+ }
28
+ if (info?.db) push('event', info.db)
29
+ for (const d of stateDbs ?? []) push(d?.profile, d?.path)
30
+ return out
31
+ }
32
+
33
+ /**
34
+ * 読み取り結果から採用する 1 件を選ぶ(messages が 1 件以上あった最初のもの)。
35
+ * どれも空なら先頭(DB のパスは分かったので、UI 側で「まだ出力がありません」を出す)。
36
+ * @param {Array<{feed: object|null, db: string, profile: string}>} [results] 読み取り結果
37
+ * @returns {{feed: object|null, db: string|null, profile: string|null}} 採用する結果
38
+ */
39
+ export function pickFeed(results = []) {
40
+ let first = null
41
+ for (const r of results ?? []) {
42
+ if (!r?.feed) continue
43
+ if ((r.feed.messages ?? []).length > 0) return r
44
+ if (!first) first = r
45
+ }
46
+ return first ?? { feed: null, db: null, profile: null }
47
+ }
48
+
49
+ /**
50
+ * 候補を順に読む `readWorkerFeed` を作る。
51
+ * @param {{listStateDbs: () => Promise<Array<{profile: string, path: string}>>, read: (sessionId: string, opts: object) => object}} deps 依存
52
+ * @returns {(sessionId: string, info?: object, limit?: number) => Promise<{feed: object|null, db: string|null, profile: string|null}>} 読み取り関数
53
+ */
54
+ export function createWorkerFeed({ listStateDbs, read }) {
55
+ return async function readWorkerFeed(sessionId, info = {}, limit = 40) {
56
+ const sid = String(sessionId ?? '')
57
+ if (!sid) return { feed: null, db: null, profile: null }
58
+ const candidates = feedCandidates(info, await listStateDbs())
59
+ const results = []
60
+ for (const c of candidates) {
61
+ let feed = null
62
+ try {
63
+ feed = read(sid, { dbPath: c.path, limit, includeTools: true })
64
+ } catch {
65
+ feed = null
66
+ }
67
+ if (!feed) continue
68
+ results.push({ feed, db: c.path, profile: c.profile })
69
+ }
70
+ return pickFeed(results)
71
+ }
72
+ }