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,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,513 @@
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
+ // D60 / D61 / D63: 抽象ロール・ネイティブ委譲・外部 CLI 禁止(SOUL を太らせないため 3 行に抑える)
44
+ '- 抽象ロール(`role:planner` / `role:builder` / `role:visual-reviewer` / `role:decision-framer`)で捉え、',
45
+ ' ロールごとの実モデル割当とフォールバック順はプロファイルメモリの表に従い `delegate_task` で委譲する。',
46
+ ' 委譲の失敗・レート制限・タイムアウト・未対応では止めずフォールバックへ回し、外部 AI CLI のサブプロセス起動はしない。',
47
+ '- タスク本文に `Mode: zero-stop` / `fast-track-review` / `visual-gate` があればその契約に従う。',
48
+ ' `zero-stop` は `npm run verify` が通るまで自律修復し、通過後に `done` にする。',
49
+ '- 完了報告は「何をしたか / 検証コマンドと exit code / 未検証 / 次の一手」の 4 点に絞る。',
50
+ ].join('\n')
51
+
52
+ /** マーカー付きのルールブロック全体。 */
53
+ export const A2B_RULE_BLOCK = `${A2B_START}\n${A2B_RULES}\n${A2B_END}`
54
+
55
+ /**
56
+ * バックアップ用のタイムスタンプ(`20261115T101500Z`)。
57
+ * @param {number} ms epoch ms
58
+ * @returns {string} スタンプ
59
+ */
60
+ export function backupStamp(ms = Date.now()) {
61
+ return new Date(Number(ms) || Date.now()).toISOString().replace(/[-:]/g, '').replace(/\.\d+Z$/, 'Z')
62
+ }
63
+
64
+ /**
65
+ * `SOUL.md` の本文にルールブロックを 1 つだけ埋め込んだ結果を返す(純関数)。
66
+ *
67
+ * - マーカーが両方ある → **その間だけ**置換(前後の文章は 1 文字も変えない)
68
+ * - start だけで end が無い(壊れた状態)→ start 以降を捨ててブロックを置き直す
69
+ * - マーカーが無い → 末尾に空行を挟んで追記
70
+ * - 空文字 → ブロックだけの新しい `SOUL.md`
71
+ *
72
+ * @param {string} current 現在の `SOUL.md`(無ければ空文字)
73
+ * @param {string} [block] 埋め込むブロック(既定 `A2B_RULE_BLOCK`)
74
+ * @returns {{text: string, mode: 'created'|'replaced'|'appended'|'unchanged', changed: boolean}} 結果
75
+ */
76
+ export function mergeSoul(current, block = A2B_RULE_BLOCK) {
77
+ const src = String(current ?? '')
78
+ const hasStart = src.includes(A2B_START)
79
+ const hasEnd = src.includes(A2B_END)
80
+
81
+ if (!src.trim()) return { text: `${block}\n`, mode: 'created', changed: true }
82
+
83
+ if (hasStart && hasEnd) {
84
+ const at = src.indexOf(A2B_START)
85
+ const endAt = src.indexOf(A2B_END, at)
86
+ if (endAt > at) {
87
+ const next = `${src.slice(0, at)}${block}${src.slice(endAt + A2B_END.length)}`
88
+ return { text: next, mode: next === src ? 'unchanged' : 'replaced', changed: next !== src }
89
+ }
90
+ }
91
+ if (hasStart && !hasEnd) {
92
+ // 途中で切れたブロック。start 以降はこちらの管理下なので置き直す。
93
+ const at = src.indexOf(A2B_START)
94
+ const next = `${src.slice(0, at)}${block}\n`
95
+ return { text: next, mode: 'replaced', changed: next !== src }
96
+ }
97
+ // 追記(既存の末尾改行数に合わせて 1 つの空行を挟む)
98
+ const head = src.replace(/\s*$/, '')
99
+ const next = `${head}\n\n${block}\n`
100
+ return { text: next, mode: 'appended', changed: true }
101
+ }
102
+
103
+ /**
104
+ * 空いているバックアップ名を決める(`SOUL.md.bak-<stamp>`、衝突時は `-2`, `-3` …)。
105
+ *
106
+ * @param {string} soulPath `SOUL.md` の絶対パス
107
+ * @param {string} stamp スタンプ
108
+ * @param {(p: string) => boolean} exists 存在判定(テスト差し替え用)
109
+ * @returns {string} バックアップの絶対パス
110
+ */
111
+ export function nextBackupPath(soulPath, stamp, exists = (p) => fs.existsSync(p)) {
112
+ const base = `${soulPath}.bak-${stamp}`
113
+ if (!exists(base)) return base
114
+ for (let i = 2; i < 100; i += 1) {
115
+ const candidate = `${base}-${i}`
116
+ if (!exists(candidate)) return candidate
117
+ }
118
+ return `${base}-${Date.now()}`
119
+ }
120
+
121
+ /**
122
+ * `SOUL.md` 1 枚へ A2B 行動規範を冪等に適用する(本体。`optimizeHermesSoul` とプロファイル同期の共通処理)。
123
+ *
124
+ * 2 回目以降はブロックが同一なので**書き込みもバックアップもしない**(1 タップボタンの連打で
125
+ * `SOUL.md.bak-*` が増えない)。内容が変わるときだけバックアップを 1 枚作ってから書く。
126
+ *
127
+ * @param {string} soulPath 対象ファイルの絶対パス
128
+ * @param {{now?: number, block?: string, create?: boolean}} [opts] 入力(`create:false` はファイルが無ければ作らない)
129
+ * @returns {{ok: boolean, path: string, mode: string, changed: boolean, backupPath: string|null, exists: boolean, applied: boolean, error?: string}} 結果
130
+ */
131
+ function applySoulFile(soulPath, { now = Date.now(), block = A2B_RULE_BLOCK, create = true } = {}) {
132
+ let current = ''
133
+ let exists = false
134
+ try {
135
+ current = fs.readFileSync(soulPath, 'utf8')
136
+ exists = true
137
+ } catch (err) {
138
+ if (err?.code !== 'ENOENT') {
139
+ return {
140
+ ok: false,
141
+ path: soulPath,
142
+ mode: 'error',
143
+ changed: false,
144
+ backupPath: null,
145
+ exists: false,
146
+ applied: false,
147
+ error: String(err?.message ?? err),
148
+ }
149
+ }
150
+ // `create:false` は既存 SOUL.md だけを対象にする(人の環境に勝手に作らない)。
151
+ if (!create) return { ok: true, path: soulPath, mode: 'skipped', changed: false, backupPath: null, exists: false, applied: false }
152
+ }
153
+
154
+ const merged = mergeSoul(current, block)
155
+ const applied = merged.text.includes(A2B_START) && merged.text.includes(A2B_END)
156
+ if (!merged.changed) {
157
+ return { ok: true, path: soulPath, mode: 'unchanged', changed: false, backupPath: null, exists, applied }
158
+ }
159
+
160
+ let backupPath = null
161
+ try {
162
+ fs.mkdirSync(path.dirname(soulPath), { recursive: true })
163
+ // 既存の SOUL.md があるときだけ、書く前に 1 枚控える(非破壊の担保)。
164
+ if (fs.existsSync(soulPath)) {
165
+ backupPath = nextBackupPath(soulPath, backupStamp(now))
166
+ fs.copyFileSync(soulPath, backupPath)
167
+ }
168
+ const tmp = `${soulPath}.tmp-${process.pid}`
169
+ fs.writeFileSync(tmp, merged.text, { encoding: 'utf8', mode: 0o600 })
170
+ fs.renameSync(tmp, soulPath)
171
+ } catch (err) {
172
+ return { ok: false, path: soulPath, mode: 'error', changed: false, backupPath, exists, applied, error: String(err?.message ?? err) }
173
+ }
174
+ return { ok: true, path: soulPath, mode: merged.mode, changed: true, backupPath, exists: true, applied: true }
175
+ }
176
+
177
+ /**
178
+ * `<hermesHome>/SOUL.md` へ A2B 行動規範を冪等に適用する。
179
+ *
180
+ * 引数・戻り値は従来どおり(`{ ok, path, mode, changed, backupPath }`)。プロファイル配下の同期は
181
+ * `optimizeProfileSouls` が担う(D64)。
182
+ *
183
+ * @param {{hermesHome?: string, now?: number, block?: string}} [opts] 入力
184
+ * @returns {{ok: boolean, path: string, mode: string, changed: boolean, backupPath: string|null, error?: string}} 結果
185
+ */
186
+ export function optimizeHermesSoul({ hermesHome, now = Date.now(), block = A2B_RULE_BLOCK } = {}) {
187
+ const home = String(hermesHome ?? process.env.HERMES_HOME ?? path.join(os.homedir(), '.hermes'))
188
+ const soulPath = path.join(home, 'SOUL.md')
189
+ const applied = applySoulFile(soulPath, { now, block, create: true })
190
+ // `exists` / `applied` は内部用の追加情報。従来の戻り値の形は変えない。
191
+ const { exists: _exists, applied: _applied, ...result } = applied
192
+ return result
193
+ }
194
+
195
+ /**
196
+ * プロファイル配下で `SOUL.md` を**新規作成してよい**名前(D64)。
197
+ *
198
+ * ディレクトリが既にある場合だけ、そして `mobile` だけ(実運用で毎ターン読ませたいプロファイル)。
199
+ * それ以外のプロファイルは既存 `SOUL.md` があるときだけ更新する=人の環境を勝手に増やさない。
200
+ */
201
+ export const PROFILE_SOUL_CREATE_IF_MISSING = ['mobile']
202
+
203
+ /**
204
+ * `<hermesHome>/profiles` 配下のプロファイル名(ディレクトリのみ・隠しディレクトリ除外)。
205
+ *
206
+ * @param {string} hermesHome Hermes のホーム
207
+ * @returns {string[]} 昇順のプロファイル名
208
+ */
209
+ export function listProfileNames(hermesHome) {
210
+ let entries = []
211
+ try {
212
+ entries = fs.readdirSync(path.join(String(hermesHome), 'profiles'), { withFileTypes: true })
213
+ } catch {
214
+ return []
215
+ }
216
+ return entries
217
+ .filter((e) => e.isDirectory() && !e.name.startsWith('.'))
218
+ .map((e) => e.name)
219
+ .sort()
220
+ }
221
+
222
+ /**
223
+ * プロファイル 1 つ分の `SOUL.md` 適用状況(**中身は返さない**)。
224
+ *
225
+ * @param {string} hermesHome Hermes のホーム
226
+ * @param {string} name プロファイル名
227
+ * @returns {{name: string, path: string, exists: boolean, applied: boolean, backups: number}} 状態
228
+ */
229
+ function profileSoulState(hermesHome, name) {
230
+ const soulPath = path.join(String(hermesHome), 'profiles', name, 'SOUL.md')
231
+ let exists = false
232
+ let applied = false
233
+ try {
234
+ const text = fs.readFileSync(soulPath, 'utf8')
235
+ exists = true
236
+ applied = text.includes(A2B_START) && text.includes(A2B_END)
237
+ } catch {
238
+ exists = false
239
+ }
240
+ let backups = 0
241
+ try {
242
+ backups = fs.readdirSync(path.dirname(soulPath)).filter((n) => n.startsWith('SOUL.md.bak-')).length
243
+ } catch {
244
+ backups = 0
245
+ }
246
+ return { name, path: soulPath, exists, applied, backups }
247
+ }
248
+
249
+ /**
250
+ * `~/.hermes/profiles/<name>/SOUL.md` へ A2B 行動規範を**非破壊・冪等**に同期する(D64)。
251
+ *
252
+ * - 対象は `profiles` を渡せばその名前だけ、省略時は `<hermesHome>/profiles/*` を自動検出。
253
+ * - `SOUL.md` が既にある → マーカー間だけ置換し、内容が変わるときだけ `.bak-<stamp>` を 1 枚作る。
254
+ * - `SOUL.md` が無い → `PROFILE_SOUL_CREATE_IF_MISSING`(`mobile`)だけ最小構成で新規作成、
255
+ * それ以外は `mode: 'skipped'`(ディレクトリを勝手に作らない)。
256
+ * - 内容(テキスト)は戻り値に載せない。`changed` / `mode` / `backupPath` / 件数だけ。
257
+ *
258
+ * @param {{hermesHome?: string, now?: number, block?: string, profiles?: string[]}} [opts] 入力
259
+ * @returns {{ok: boolean, profiles: Array<{name: string, path: string, exists: boolean, applied: boolean, changed: boolean, mode: string, backupPath: string|null, backups: number, error?: string}>}} 結果
260
+ */
261
+ export function optimizeProfileSouls({ hermesHome, now = Date.now(), block = A2B_RULE_BLOCK, profiles } = {}) {
262
+ const home = String(hermesHome ?? process.env.HERMES_HOME ?? path.join(os.homedir(), '.hermes'))
263
+ const names = Array.isArray(profiles) && profiles.length
264
+ ? profiles.map((n) => String(n ?? '').trim()).filter(Boolean)
265
+ : listProfileNames(home)
266
+
267
+ const out = []
268
+ for (const name of names) {
269
+ // パス連結に使う名前だけを受け付ける(`../` 等の脱出を許さない)。
270
+ if (!/^[A-Za-z0-9._-]+$/.test(name) || name === '.' || name === '..') continue
271
+ const dir = path.join(home, 'profiles', name)
272
+ let dirExists = false
273
+ try {
274
+ dirExists = fs.statSync(dir).isDirectory()
275
+ } catch {
276
+ dirExists = false
277
+ }
278
+ if (!dirExists) {
279
+ out.push({
280
+ name,
281
+ path: path.join(dir, 'SOUL.md'),
282
+ exists: false,
283
+ applied: false,
284
+ changed: false,
285
+ mode: 'skipped',
286
+ backupPath: null,
287
+ backups: 0,
288
+ })
289
+ continue
290
+ }
291
+
292
+ const r = applySoulFile(path.join(dir, 'SOUL.md'), {
293
+ now,
294
+ block,
295
+ create: PROFILE_SOUL_CREATE_IF_MISSING.includes(name),
296
+ })
297
+ const state = profileSoulState(home, name)
298
+ out.push({
299
+ name,
300
+ path: r.path,
301
+ exists: r.exists,
302
+ applied: Boolean(r.applied),
303
+ changed: Boolean(r.changed),
304
+ mode: r.mode,
305
+ backupPath: r.backupPath ?? null,
306
+ backups: state.backups,
307
+ ...(r.error ? { error: r.error } : {}),
308
+ })
309
+ }
310
+ return { ok: out.every((p) => p.mode !== 'error'), profiles: out }
311
+ }
312
+
313
+ /**
314
+ * Antigravity / 汎用エージェントのスキル置き場の候補。
315
+ * `~/.gemini` や `~/.agents` が**無い**環境では配置しない(勝手にディレクトリを作らない)。
316
+ */
317
+ export const SKILL_TARGET_CANDIDATES = [
318
+ {
319
+ id: 'antigravity',
320
+ /** Antigravity のプラグイン・スキル置き場 */
321
+ dir: (home) => path.join(home, '.gemini', 'config', 'plugins', 'hermes-pilot-architect', 'skills'),
322
+ /** このディレクトリの親(`~/.gemini`)が存在するときだけ候補にする */
323
+ guard: (home) => path.join(home, '.gemini'),
324
+ },
325
+ {
326
+ id: 'agents',
327
+ dir: (home) => path.join(home, '.agents', 'skills'),
328
+ guard: (home) => path.join(home, '.agents'),
329
+ },
330
+ ]
331
+
332
+ /**
333
+ * 1 スキルを 1 つの置き場へ配置する(リンク優先、失敗時はコピー)。
334
+ *
335
+ * 既存の**実ディレクトリ / 実ファイル**は触らない(人のスキルを壊さない)。
336
+ * 既存の symlink は、この供給元(`skillsSrcDir`)を指しているときだけ貼り替える。
337
+ *
338
+ * @param {{name: string, srcDir: string, destDir: string}} input 入力
339
+ * @returns {{name: string, status: 'linked'|'copied'|'skipped', reason?: string}} 結果
340
+ */
341
+ export function installSkill({ name, srcDir, destDir }) {
342
+ const src = path.join(srcDir, name)
343
+ const dest = path.join(destDir, name)
344
+ try {
345
+ if (!fs.existsSync(src)) return { name, status: 'skipped', reason: 'source-missing' }
346
+ } catch {
347
+ return { name, status: 'skipped', reason: 'source-missing' }
348
+ }
349
+
350
+ let stat = null
351
+ try {
352
+ stat = fs.lstatSync(dest)
353
+ } catch {
354
+ stat = null
355
+ }
356
+
357
+ if (stat) {
358
+ // 既存の配置は原則さわらない。自分のリンク(=同じ供給元を指す)だけは「配置済み」とみなす。
359
+ if (stat.isSymbolicLink()) {
360
+ let target = ''
361
+ try {
362
+ target = fs.readlinkSync(dest)
363
+ } catch {
364
+ target = ''
365
+ }
366
+ const resolved = target ? path.resolve(path.dirname(dest), target) : ''
367
+ if (resolved === path.resolve(src)) return { name, status: 'skipped', reason: 'exists' }
368
+ return { name, status: 'skipped', reason: 'foreign-link' }
369
+ }
370
+ return { name, status: 'skipped', reason: 'exists' }
371
+ }
372
+
373
+ try {
374
+ fs.mkdirSync(destDir, { recursive: true })
375
+ fs.symlinkSync(src, dest, 'dir')
376
+ return { name, status: 'linked' }
377
+ } catch {
378
+ try {
379
+ fs.cpSync(src, dest, { recursive: true, force: false, errorOnExist: true })
380
+ return { name, status: 'copied' }
381
+ } catch (err) {
382
+ return { name, status: 'skipped', reason: String(err?.code ?? 'copy-failed') }
383
+ }
384
+ }
385
+ }
386
+
387
+ /**
388
+ * 汎用エージェントのスキル置き場へ同梱スキルを配置する(冪等)。
389
+ *
390
+ * **プロセスは起動しない**(`fs.linkSync` / `fs.cpSync` だけ)。外部 AI CLI を
391
+ * ラップ起動しないという SPEC V11 D50 の境界はここでも守る。
392
+ *
393
+ * @param {{home?: string, skillsSrcDir?: string, targets?: string[], names?: string[]}} [opts] 入力
394
+ * @returns {{ok: boolean, targets: Array<{id: string, path: string, installed: string[], skipped: Array<object>, error?: string}>}} 結果
395
+ */
396
+ export function optimizeAntigravitySkills({
397
+ home = os.homedir(),
398
+ skillsSrcDir = DEFAULT_SKILLS_SRC,
399
+ targets = null,
400
+ names = BUNDLED_SKILLS,
401
+ } = {}) {
402
+ const base = String(home || os.homedir())
403
+ let list
404
+ if (Array.isArray(targets) && targets.length) {
405
+ // 明示指定(テスト・上級者向け)。`~` は展開する。
406
+ list = targets.map((t, i) => ({ id: `custom-${i + 1}`, dir: () => String(t).replace(/^~(?=$|\/)/, base) }))
407
+ } else {
408
+ list = SKILL_TARGET_CANDIDATES.filter((c) => {
409
+ try {
410
+ return fs.existsSync(c.guard(base))
411
+ } catch {
412
+ return false
413
+ }
414
+ })
415
+ }
416
+
417
+ const out = []
418
+ for (const target of list) {
419
+ const dir = target.dir(base)
420
+ const entry = { id: target.id, path: dir, installed: [], skipped: [] }
421
+ for (const name of names) {
422
+ const r = installSkill({ name, srcDir: skillsSrcDir, destDir: dir })
423
+ if (r.status === 'linked' || r.status === 'copied') entry.installed.push(`${name}:${r.status}`)
424
+ else entry.skipped.push({ name, reason: r.reason })
425
+ }
426
+ out.push(entry)
427
+ }
428
+ return { ok: out.every((t) => !t.error), targets: out }
429
+ }
430
+
431
+ /**
432
+ * `optimizeAntigravitySkills` の現行名(サーバー側はこちらを使う)。
433
+ *
434
+ * 名前から外部ツール連携を想像させないための別名で、実体は同じ関数。
435
+ * 繰り返しになるが**プロセスは起動しない**(リンク/コピーだけ)。
436
+ */
437
+ export const optimizeAgentSkills = optimizeAntigravitySkills
438
+
439
+ /**
440
+ * 適用状況を返す(**中身は返さない**。真偽値・件数・ファイル名だけ)。
441
+ *
442
+ * @param {{hermesHome?: string, home?: string, skillsSrcDir?: string}} [opts] 入力
443
+ * @returns {object} 状態
444
+ */
445
+ export function getOptimizeStatus({
446
+ hermesHome = process.env.HERMES_HOME ?? path.join(os.homedir(), '.hermes'),
447
+ home = os.homedir(),
448
+ skillsSrcDir = DEFAULT_SKILLS_SRC,
449
+ } = {}) {
450
+ const hh = String(hermesHome)
451
+ const base = String(home || os.homedir())
452
+ const soulPath = path.join(hh, 'SOUL.md')
453
+
454
+ let soulExists = false
455
+ let soulApplied = false
456
+ let backups = []
457
+ try {
458
+ const text = fs.readFileSync(soulPath, 'utf8')
459
+ soulExists = true
460
+ soulApplied = text.includes(A2B_START) && text.includes(A2B_END)
461
+ } catch {
462
+ soulExists = false
463
+ }
464
+ try {
465
+ backups = fs
466
+ .readdirSync(hh)
467
+ .filter((n) => n.startsWith('SOUL.md.bak-'))
468
+ .sort()
469
+ } catch {
470
+ backups = []
471
+ }
472
+
473
+ const skillState = (dir) => {
474
+ const present = []
475
+ const missing = []
476
+ for (const name of BUNDLED_SKILLS) {
477
+ try {
478
+ fs.lstatSync(path.join(dir, name))
479
+ present.push(name)
480
+ } catch {
481
+ missing.push(name)
482
+ }
483
+ }
484
+ return { path: dir, present, missing }
485
+ }
486
+
487
+ const antigravity = SKILL_TARGET_CANDIDATES.map((c) => {
488
+ const dir = c.dir(base)
489
+ let available = false
490
+ try {
491
+ available = fs.existsSync(c.guard(base))
492
+ } catch {
493
+ available = false
494
+ }
495
+ return { id: c.id, available, ...skillState(dir) }
496
+ })
497
+
498
+ return {
499
+ ok: true,
500
+ soul: {
501
+ path: soulPath,
502
+ exists: soulExists,
503
+ applied: soulApplied,
504
+ backups: backups.length,
505
+ latestBackup: backups.length ? backups[backups.length - 1] : null,
506
+ },
507
+ // プロファイル配下(`profiles/<name>/SOUL.md`)も「適用済みか」だけを返す(中身は返さない)。
508
+ profiles: listProfileNames(hh).map((name) => profileSoulState(hh, name)),
509
+ hermes: skillState(path.join(hh, 'skills')),
510
+ bundled: { source: skillsSrcDir, names: BUNDLED_SKILLS },
511
+ antigravity,
512
+ }
513
+ }