hermes-pilot 0.0.0-stage → 0.2.0

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 +390 -0
  3. package/README.md +398 -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 +358 -0
  23. package/apps/bridge/src/pipeline-watcher.js +1018 -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 +1738 -0
  30. package/apps/bridge/src/snippets.js +373 -0
  31. package/apps/bridge/src/specs.js +734 -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-U500JD2P.js +12 -0
  46. package/apps/web/dist/assets/index-6iFDsB0G.css +1 -0
  47. package/apps/web/dist/assets/index-X4Bi2FWB.js +94 -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 +103 -0
  72. package/skills/quick-review/SKILL.md +170 -0
  73. package/skills/quick-review/assets/sheet-template.html +175 -0
  74. package/skills/spec-architect/SKILL.md +175 -0
@@ -0,0 +1,125 @@
1
+ import crypto from 'node:crypto'
2
+ import fs from 'node:fs'
3
+ import path from 'node:path'
4
+
5
+ /**
6
+ * ワンタイム・ペアリングコード(SPEC §8.2 の `?pair=<one-time token>`)。
7
+ *
8
+ * アプリトークン(256-bit hex = 64 文字)をそのまま URL に載せると
9
+ * QR が高密度になり、端末(80x24)に出すと行が溢れてカメラが読めない。
10
+ * ここでは短い使い捨てコード(既定 8 文字)を発行し、認証は
11
+ * 「コード → セッション Cookie」の交換として扱う(1 回使ったら失効)。
12
+ *
13
+ * 保存はハッシュのみ(`pair-codes.json`, 0600)。平文コードは発行時にしか存在しない。
14
+ *
15
+ * @param {object} cfg 設定(`dataDir` を使う)
16
+ * @param {object} [opts] 差し替え
17
+ * @param {number} [opts.ttlMs] 有効期間(既定 10 分)
18
+ * @param {number} [opts.max] 同時に保持する最大件数(既定 20)
19
+ * @param {() => number} [opts.now] 時刻(テスト用)
20
+ * @returns {object} 発行・消費
21
+ */
22
+ export function createPairCodes(cfg, { ttlMs = 10 * 60 * 1000, max = 20, now = Date.now } = {}) {
23
+ const file = path.join(cfg.dataDir, 'pair-codes.json')
24
+ // 0/O/1/I/l/o など紛らわしい文字を除く(手入力の取り違え防止)
25
+ const ALPHABET = 'ABCDEFGHJKMNPQRSTUVWXYZ23456789'
26
+
27
+ const hash = (v) => crypto.createHash('sha256').update(String(v)).digest('hex')
28
+
29
+ /** @returns {Record<string, {expires: number, created: number}>} */
30
+ const load = () => {
31
+ try {
32
+ const j = JSON.parse(fs.readFileSync(file, 'utf8'))
33
+ return j?.codes && typeof j.codes === 'object' ? j.codes : {}
34
+ } catch {
35
+ return {}
36
+ }
37
+ }
38
+
39
+ const save = (codes) => {
40
+ try {
41
+ fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 })
42
+ const tmp = `${file}.tmp`
43
+ fs.writeFileSync(tmp, `${JSON.stringify({ version: 1, codes })}\n`, { mode: 0o600 })
44
+ fs.renameSync(tmp, file)
45
+ } catch {
46
+ /* 保存に失敗しても発行済みのコードはこのプロセス内有効(認証は止めない) */
47
+ }
48
+ }
49
+
50
+ /** 期限切れを落とす。 */
51
+ const prune = (codes, at) => {
52
+ let changed = false
53
+ for (const [k, v] of Object.entries(codes)) {
54
+ if (!v || !(Number(v.expires) > at)) {
55
+ delete codes[k]
56
+ changed = true
57
+ }
58
+ }
59
+ return changed
60
+ }
61
+
62
+ return {
63
+ /**
64
+ * 短いコードを発行する。
65
+ * @param {number} [length] 文字数(既定 8)
66
+ * @returns {{code: string, expiresAt: number}} コードと失効時刻
67
+ */
68
+ mint(length = 8) {
69
+ const at = now()
70
+ const codes = load()
71
+ prune(codes, at)
72
+ // 溢れたら古いものから捨てる
73
+ const keys = Object.keys(codes)
74
+ if (keys.length >= max) {
75
+ keys
76
+ .sort((a, b) => Number(codes[a]?.created ?? 0) - Number(codes[b]?.created ?? 0))
77
+ .slice(0, keys.length - max + 1)
78
+ .forEach((k) => delete codes[k])
79
+ }
80
+ let code = ''
81
+ do {
82
+ code = Array.from(crypto.randomBytes(length))
83
+ .map((b) => ALPHABET[b % ALPHABET.length])
84
+ .join('')
85
+ } while (codes[hash(code)])
86
+ const expiresAt = at + ttlMs
87
+ codes[hash(code)] = { created: at, expires: expiresAt }
88
+ save(codes)
89
+ return { code, expiresAt }
90
+ },
91
+
92
+ /**
93
+ * コードを使う(1 回限り)。成功したら true。
94
+ * @param {string} given 入力コード(大文字小文字は問わない)
95
+ * @returns {boolean} 有効だったか
96
+ */
97
+ consume(given) {
98
+ const code = String(given ?? '').trim().toUpperCase()
99
+ if (code.length < 6 || code.length > 16) return false
100
+ if (!/^[A-Z0-9]+$/.test(code)) return false
101
+ const at = now()
102
+ const codes = load()
103
+ const key = hash(code)
104
+ const rec = codes[key]
105
+ if (!rec || !(Number(rec.expires) > at)) {
106
+ if (rec) {
107
+ delete codes[key]
108
+ save(codes)
109
+ }
110
+ return false
111
+ }
112
+ delete codes[key]
113
+ save(codes)
114
+ return true
115
+ },
116
+
117
+ /** 未使用コードの件数(診断用。値は返さない)。 */
118
+ pending() {
119
+ const at = now()
120
+ const codes = load()
121
+ const live = Object.values(codes).filter((v) => v && Number(v.expires) > at).length
122
+ return live
123
+ },
124
+ }
125
+ }
@@ -0,0 +1,358 @@
1
+ /**
2
+ * A2B パイプラインの第 3 段 — 1 タップ環境最適化(SPEC §3.2 / D25③)。
3
+ *
4
+ * 「インストールしただけで自走する」ための**非破壊・冪等**な環境最適化だけを行う。
5
+ * - `optimizeHermesSoul` … `~/.hermes/SOUL.md` へ行動規範ブロックを 1 つだけ埋め込む
6
+ * (事前バックアップ+マーカー間の置換。何度押してもブロックは 1 つ)。
7
+ * - `optimizeAgentSkills`(旧名 `optimizeAntigravitySkills`)… 汎用エージェントのスキル置き場へ
8
+ * `quick-review` / `annotation` / `spec-architect` をリンク(無理ならコピー)する。
9
+ * **ファイル配置だけ**を行い、外部 AI CLI のサブプロセスは一切起動しない(SPEC V11 D50)。
10
+ * - `getOptimizeStatus` … 適用済みかどうかを**真偽値と件数だけ**で返す(内容は返さない)。
11
+ *
12
+ * 禁止事項(この関数群が絶対にやらないこと):
13
+ * - 既存の `SOUL.md` の**マーカー外**の文章を書き換える
14
+ * - 人の手で置いたスキル(実ディレクトリ・別ソースを指すリンク)を上書きする
15
+ * - SOUL / スキルの**中身を API 応答に載せる**(秘密情報の露出経路を作らない)
16
+ */
17
+
18
+ import fs from 'node:fs'
19
+ import path from 'node:path'
20
+ import os from 'node:os'
21
+
22
+ /** リポジトリのルート(このファイルは `apps/bridge/src/` の下)。 */
23
+ export const REPO_ROOT = path.resolve(import.meta.dirname, '../../..')
24
+
25
+ /** 同梱スキルの置き場(`hermes-pilot init` と同じ 3 つ)。 */
26
+ export const BUNDLED_SKILLS = ['quick-review', 'annotation', 'spec-architect']
27
+
28
+ /** 既定のスキル供給元。 */
29
+ export const DEFAULT_SKILLS_SRC = path.join(REPO_ROOT, 'skills')
30
+
31
+ /** 冪等更新のマーカー(この 2 行の間だけを書き換える)。 */
32
+ export const A2B_START = '<!-- hermes-pilot:a2b:start -->'
33
+ export const A2B_END = '<!-- hermes-pilot:a2b:end -->'
34
+
35
+ /** マーカー内に入れる行動規範(短く保つ。SOUL は毎ターン読まれる)。 */
36
+ export const A2B_RULES = [
37
+ '## Hermes Pilot A2B pipeline',
38
+ '',
39
+ '- 仕様化の依頼は `spec-architect` スキルの 2 ラウンド手順に従う(設問シート → SPEC)。',
40
+ '- 判断が必要になったら**長文の質問をチャットへ並べない**。`quick-review` シートを作り、',
41
+ ' `[review] label=... round=...` 行付きのタスクを起票して `needs_input` で止める。',
42
+ '- 見た目の検収は `annotation`(スクリーンショット+赤)で受ける。文章で聞き返さない。',
43
+ '- タスク本文に `Mode: zero-stop` / `fast-track-review` / `visual-gate` があればその契約に従う。',
44
+ ' `zero-stop` は `npm run verify` が通るまで自律修復し、通過後に `done` にする。',
45
+ '- 完了報告は「何をしたか / 検証コマンドと exit code / 未検証 / 次の一手」の 4 点に絞る。',
46
+ ].join('\n')
47
+
48
+ /** マーカー付きのルールブロック全体。 */
49
+ export const A2B_RULE_BLOCK = `${A2B_START}\n${A2B_RULES}\n${A2B_END}`
50
+
51
+ /**
52
+ * バックアップ用のタイムスタンプ(`20261115T101500Z`)。
53
+ * @param {number} ms epoch ms
54
+ * @returns {string} スタンプ
55
+ */
56
+ export function backupStamp(ms = Date.now()) {
57
+ return new Date(Number(ms) || Date.now()).toISOString().replace(/[-:]/g, '').replace(/\.\d+Z$/, 'Z')
58
+ }
59
+
60
+ /**
61
+ * `SOUL.md` の本文にルールブロックを 1 つだけ埋め込んだ結果を返す(純関数)。
62
+ *
63
+ * - マーカーが両方ある → **その間だけ**置換(前後の文章は 1 文字も変えない)
64
+ * - start だけで end が無い(壊れた状態)→ start 以降を捨ててブロックを置き直す
65
+ * - マーカーが無い → 末尾に空行を挟んで追記
66
+ * - 空文字 → ブロックだけの新しい `SOUL.md`
67
+ *
68
+ * @param {string} current 現在の `SOUL.md`(無ければ空文字)
69
+ * @param {string} [block] 埋め込むブロック(既定 `A2B_RULE_BLOCK`)
70
+ * @returns {{text: string, mode: 'created'|'replaced'|'appended'|'unchanged', changed: boolean}} 結果
71
+ */
72
+ export function mergeSoul(current, block = A2B_RULE_BLOCK) {
73
+ const src = String(current ?? '')
74
+ const hasStart = src.includes(A2B_START)
75
+ const hasEnd = src.includes(A2B_END)
76
+
77
+ if (!src.trim()) return { text: `${block}\n`, mode: 'created', changed: true }
78
+
79
+ if (hasStart && hasEnd) {
80
+ const at = src.indexOf(A2B_START)
81
+ const endAt = src.indexOf(A2B_END, at)
82
+ if (endAt > at) {
83
+ const next = `${src.slice(0, at)}${block}${src.slice(endAt + A2B_END.length)}`
84
+ return { text: next, mode: next === src ? 'unchanged' : 'replaced', changed: next !== src }
85
+ }
86
+ }
87
+ if (hasStart && !hasEnd) {
88
+ // 途中で切れたブロック。start 以降はこちらの管理下なので置き直す。
89
+ const at = src.indexOf(A2B_START)
90
+ const next = `${src.slice(0, at)}${block}\n`
91
+ return { text: next, mode: 'replaced', changed: next !== src }
92
+ }
93
+ // 追記(既存の末尾改行数に合わせて 1 つの空行を挟む)
94
+ const head = src.replace(/\s*$/, '')
95
+ const next = `${head}\n\n${block}\n`
96
+ return { text: next, mode: 'appended', changed: true }
97
+ }
98
+
99
+ /**
100
+ * 空いているバックアップ名を決める(`SOUL.md.bak-<stamp>`、衝突時は `-2`, `-3` …)。
101
+ *
102
+ * @param {string} soulPath `SOUL.md` の絶対パス
103
+ * @param {string} stamp スタンプ
104
+ * @param {(p: string) => boolean} exists 存在判定(テスト差し替え用)
105
+ * @returns {string} バックアップの絶対パス
106
+ */
107
+ export function nextBackupPath(soulPath, stamp, exists = (p) => fs.existsSync(p)) {
108
+ const base = `${soulPath}.bak-${stamp}`
109
+ if (!exists(base)) return base
110
+ for (let i = 2; i < 100; i += 1) {
111
+ const candidate = `${base}-${i}`
112
+ if (!exists(candidate)) return candidate
113
+ }
114
+ return `${base}-${Date.now()}`
115
+ }
116
+
117
+ /**
118
+ * `<hermesHome>/SOUL.md` へ A2B 行動規範を冪等に適用する。
119
+ *
120
+ * 2 回目以降はブロックが同一なので**書き込みもバックアップもしない**(1 タップボタンの連打で
121
+ * `SOUL.md.bak-*` が増えない)。内容が変わるときだけバックアップを 1 枚作ってから書く。
122
+ *
123
+ * @param {{hermesHome?: string, now?: number, block?: string}} [opts] 入力
124
+ * @returns {{ok: boolean, path: string, mode: string, changed: boolean, backupPath: string|null, error?: string}} 結果
125
+ */
126
+ export function optimizeHermesSoul({ hermesHome, now = Date.now(), block = A2B_RULE_BLOCK } = {}) {
127
+ const home = String(hermesHome ?? process.env.HERMES_HOME ?? path.join(os.homedir(), '.hermes'))
128
+ const soulPath = path.join(home, 'SOUL.md')
129
+ let current = ''
130
+ try {
131
+ current = fs.readFileSync(soulPath, 'utf8')
132
+ } catch (err) {
133
+ if (err?.code !== 'ENOENT') {
134
+ return { ok: false, path: soulPath, mode: 'error', changed: false, backupPath: null, error: String(err?.message ?? err) }
135
+ }
136
+ }
137
+
138
+ const merged = mergeSoul(current, block)
139
+ if (!merged.changed) {
140
+ return { ok: true, path: soulPath, mode: 'unchanged', changed: false, backupPath: null }
141
+ }
142
+
143
+ let backupPath = null
144
+ try {
145
+ fs.mkdirSync(path.dirname(soulPath), { recursive: true })
146
+ // 既存の SOUL.md があるときだけ、書く前に 1 枚控える(非破壊の担保)。
147
+ if (fs.existsSync(soulPath)) {
148
+ backupPath = nextBackupPath(soulPath, backupStamp(now))
149
+ fs.copyFileSync(soulPath, backupPath)
150
+ }
151
+ const tmp = `${soulPath}.tmp-${process.pid}`
152
+ fs.writeFileSync(tmp, merged.text, { encoding: 'utf8', mode: 0o600 })
153
+ fs.renameSync(tmp, soulPath)
154
+ } catch (err) {
155
+ return { ok: false, path: soulPath, mode: 'error', changed: false, backupPath, error: String(err?.message ?? err) }
156
+ }
157
+ return { ok: true, path: soulPath, mode: merged.mode, changed: true, backupPath }
158
+ }
159
+
160
+ /**
161
+ * Antigravity / 汎用エージェントのスキル置き場の候補。
162
+ * `~/.gemini` や `~/.agents` が**無い**環境では配置しない(勝手にディレクトリを作らない)。
163
+ */
164
+ export const SKILL_TARGET_CANDIDATES = [
165
+ {
166
+ id: 'antigravity',
167
+ /** Antigravity のプラグイン・スキル置き場 */
168
+ dir: (home) => path.join(home, '.gemini', 'config', 'plugins', 'hermes-pilot-architect', 'skills'),
169
+ /** このディレクトリの親(`~/.gemini`)が存在するときだけ候補にする */
170
+ guard: (home) => path.join(home, '.gemini'),
171
+ },
172
+ {
173
+ id: 'agents',
174
+ dir: (home) => path.join(home, '.agents', 'skills'),
175
+ guard: (home) => path.join(home, '.agents'),
176
+ },
177
+ ]
178
+
179
+ /**
180
+ * 1 スキルを 1 つの置き場へ配置する(リンク優先、失敗時はコピー)。
181
+ *
182
+ * 既存の**実ディレクトリ / 実ファイル**は触らない(人のスキルを壊さない)。
183
+ * 既存の symlink は、この供給元(`skillsSrcDir`)を指しているときだけ貼り替える。
184
+ *
185
+ * @param {{name: string, srcDir: string, destDir: string}} input 入力
186
+ * @returns {{name: string, status: 'linked'|'copied'|'skipped', reason?: string}} 結果
187
+ */
188
+ export function installSkill({ name, srcDir, destDir }) {
189
+ const src = path.join(srcDir, name)
190
+ const dest = path.join(destDir, name)
191
+ try {
192
+ if (!fs.existsSync(src)) return { name, status: 'skipped', reason: 'source-missing' }
193
+ } catch {
194
+ return { name, status: 'skipped', reason: 'source-missing' }
195
+ }
196
+
197
+ let stat = null
198
+ try {
199
+ stat = fs.lstatSync(dest)
200
+ } catch {
201
+ stat = null
202
+ }
203
+
204
+ if (stat) {
205
+ // 既存の配置は原則さわらない。自分のリンク(=同じ供給元を指す)だけは「配置済み」とみなす。
206
+ if (stat.isSymbolicLink()) {
207
+ let target = ''
208
+ try {
209
+ target = fs.readlinkSync(dest)
210
+ } catch {
211
+ target = ''
212
+ }
213
+ const resolved = target ? path.resolve(path.dirname(dest), target) : ''
214
+ if (resolved === path.resolve(src)) return { name, status: 'skipped', reason: 'exists' }
215
+ return { name, status: 'skipped', reason: 'foreign-link' }
216
+ }
217
+ return { name, status: 'skipped', reason: 'exists' }
218
+ }
219
+
220
+ try {
221
+ fs.mkdirSync(destDir, { recursive: true })
222
+ fs.symlinkSync(src, dest, 'dir')
223
+ return { name, status: 'linked' }
224
+ } catch {
225
+ try {
226
+ fs.cpSync(src, dest, { recursive: true, force: false, errorOnExist: true })
227
+ return { name, status: 'copied' }
228
+ } catch (err) {
229
+ return { name, status: 'skipped', reason: String(err?.code ?? 'copy-failed') }
230
+ }
231
+ }
232
+ }
233
+
234
+ /**
235
+ * 汎用エージェントのスキル置き場へ同梱スキルを配置する(冪等)。
236
+ *
237
+ * **プロセスは起動しない**(`fs.linkSync` / `fs.cpSync` だけ)。外部 AI CLI を
238
+ * ラップ起動しないという SPEC V11 D50 の境界はここでも守る。
239
+ *
240
+ * @param {{home?: string, skillsSrcDir?: string, targets?: string[], names?: string[]}} [opts] 入力
241
+ * @returns {{ok: boolean, targets: Array<{id: string, path: string, installed: string[], skipped: Array<object>, error?: string}>}} 結果
242
+ */
243
+ export function optimizeAntigravitySkills({
244
+ home = os.homedir(),
245
+ skillsSrcDir = DEFAULT_SKILLS_SRC,
246
+ targets = null,
247
+ names = BUNDLED_SKILLS,
248
+ } = {}) {
249
+ const base = String(home || os.homedir())
250
+ let list
251
+ if (Array.isArray(targets) && targets.length) {
252
+ // 明示指定(テスト・上級者向け)。`~` は展開する。
253
+ list = targets.map((t, i) => ({ id: `custom-${i + 1}`, dir: () => String(t).replace(/^~(?=$|\/)/, base) }))
254
+ } else {
255
+ list = SKILL_TARGET_CANDIDATES.filter((c) => {
256
+ try {
257
+ return fs.existsSync(c.guard(base))
258
+ } catch {
259
+ return false
260
+ }
261
+ })
262
+ }
263
+
264
+ const out = []
265
+ for (const target of list) {
266
+ const dir = target.dir(base)
267
+ const entry = { id: target.id, path: dir, installed: [], skipped: [] }
268
+ for (const name of names) {
269
+ const r = installSkill({ name, srcDir: skillsSrcDir, destDir: dir })
270
+ if (r.status === 'linked' || r.status === 'copied') entry.installed.push(`${name}:${r.status}`)
271
+ else entry.skipped.push({ name, reason: r.reason })
272
+ }
273
+ out.push(entry)
274
+ }
275
+ return { ok: out.every((t) => !t.error), targets: out }
276
+ }
277
+
278
+ /**
279
+ * `optimizeAntigravitySkills` の現行名(サーバー側はこちらを使う)。
280
+ *
281
+ * 名前から外部ツール連携を想像させないための別名で、実体は同じ関数。
282
+ * 繰り返しになるが**プロセスは起動しない**(リンク/コピーだけ)。
283
+ */
284
+ export const optimizeAgentSkills = optimizeAntigravitySkills
285
+
286
+ /**
287
+ * 適用状況を返す(**中身は返さない**。真偽値・件数・ファイル名だけ)。
288
+ *
289
+ * @param {{hermesHome?: string, home?: string, skillsSrcDir?: string}} [opts] 入力
290
+ * @returns {object} 状態
291
+ */
292
+ export function getOptimizeStatus({
293
+ hermesHome = process.env.HERMES_HOME ?? path.join(os.homedir(), '.hermes'),
294
+ home = os.homedir(),
295
+ skillsSrcDir = DEFAULT_SKILLS_SRC,
296
+ } = {}) {
297
+ const hh = String(hermesHome)
298
+ const base = String(home || os.homedir())
299
+ const soulPath = path.join(hh, 'SOUL.md')
300
+
301
+ let soulExists = false
302
+ let soulApplied = false
303
+ let backups = []
304
+ try {
305
+ const text = fs.readFileSync(soulPath, 'utf8')
306
+ soulExists = true
307
+ soulApplied = text.includes(A2B_START) && text.includes(A2B_END)
308
+ } catch {
309
+ soulExists = false
310
+ }
311
+ try {
312
+ backups = fs
313
+ .readdirSync(hh)
314
+ .filter((n) => n.startsWith('SOUL.md.bak-'))
315
+ .sort()
316
+ } catch {
317
+ backups = []
318
+ }
319
+
320
+ const skillState = (dir) => {
321
+ const present = []
322
+ const missing = []
323
+ for (const name of BUNDLED_SKILLS) {
324
+ try {
325
+ fs.lstatSync(path.join(dir, name))
326
+ present.push(name)
327
+ } catch {
328
+ missing.push(name)
329
+ }
330
+ }
331
+ return { path: dir, present, missing }
332
+ }
333
+
334
+ const antigravity = SKILL_TARGET_CANDIDATES.map((c) => {
335
+ const dir = c.dir(base)
336
+ let available = false
337
+ try {
338
+ available = fs.existsSync(c.guard(base))
339
+ } catch {
340
+ available = false
341
+ }
342
+ return { id: c.id, available, ...skillState(dir) }
343
+ })
344
+
345
+ return {
346
+ ok: true,
347
+ soul: {
348
+ path: soulPath,
349
+ exists: soulExists,
350
+ applied: soulApplied,
351
+ backups: backups.length,
352
+ latestBackup: backups.length ? backups[backups.length - 1] : null,
353
+ },
354
+ hermes: skillState(path.join(hh, 'skills')),
355
+ bundled: { source: skillsSrcDir, names: BUNDLED_SKILLS },
356
+ antigravity,
357
+ }
358
+ }