@rch4com/agent-setup 1.18.0 → 1.20.0

package/lib/items/global.ponytail.mjs

@@ -18,27 +18,31 @@ import { msg } from '../i18n/index.mjs'
 //
 // opencode는 프로젝트 항목(plugin.ponytail)이 opencode.jsonc의 plugin 배열로
 // 이미 배선한다 — 전역 판에서 겹치면 같은 플러그인이 두 번 등록된다. claude도
-// 같은 이유로 프로젝트 항목의 자리다. grok은 상류 명령이 있으나 감지·제거
-// 경로를 실측할 CLI가 없어 superpowers 전역 판과 같은 기준으로 제외한다.
+// 같은 이유로 프로젝트 항목의 자리다.
+//   grok    — `grok plugin install DietrichGebert/ponytail --trust`. 2026-09-05
+//             이 머신(grok 1.0.5)에서 설치·감지·제거 왕복을 실측했다. 상류
+//             README는 "기본 꺼짐이라 /plugins에서 켜라"고 적지만 1.0.5는
+//             --trust 설치 직후 config.toml [plugins].enabled에 이름을 넣었다.
 // kiro·vscode는 상류가 룰 파일 수동 배치만 안내하고, kilo·kimi는 경로가 없다.
 //
 // 상류는 플러그인 제거 전에 node scripts/uninstall.js로 ~/.config/ponytail
 // 설정과 statusLine 항목을 정리하라고 안내한다 — 하니스마다 스크립트 위치가
 // 달라 자동화하지 않고 note로 알린다. 이 항목은 플러그인만 제거한다.
-const SUPPORTS = ['codex', 'gemini', 'copilot']
+const SUPPORTS = ['codex', 'gemini', 'copilot', 'grok']
 
 const CONFIG = {
   id: 'global.ponytail', label: 'Ponytail', group: '__token',
   note: 'item.global.ponytail.note',
+  verified: '2026-09-05',
   pluginName: 'ponytail',
   marketplaceRepo: 'DietrichGebert/ponytail',
   installId: 'ponytail@ponytail',
   gemini: 'https://github.com/DietrichGebert/ponytail',
+  grok: 'DietrichGebert/ponytail',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
       c,
       ['claude', 'opencode'].includes(c) ? msg('item.unsupported.globalProjectItem', { item: 'Ponytail' })
-      : c === 'grok' ? msg('item.unsupported.ponytailGlobalGrok')
       : ['kiro', 'vscode'].includes(c) ? msg('item.unsupported.ponytailRules')
       : msg('item.unsupported.upstreamNone'),
     ]),

package/lib/items/global.superpowers.mjs

@@ -14,31 +14,37 @@ import { msg } from '../i18n/index.mjs'
 //   opencode— 상류 .opencode/INSTALL.md가 전역 opencode.json의 plugin 배열에
 //             아래 항목 한 줄을 더하라고 안내한다.
 //
-// grok은 상류 명령(grok plugin install superpowers@xai-official --trust)이
-// 있지만 감지·제거 경로를 실측할 CLI가 없어 아직 배선하지 않고, kimi는 설치가
-// 대화형 /plugins뿐이라 헤드리스 경로가 없다. claude는 프로젝트 스코프 항목
-// (plugin.superpowers)의 자리다.
+//   grok    — 2026-09-05 이 머신(grok 1.0.5)에서 `grok plugin install
+//             superpowers@xai-official --trust`로 설치·감지·제거 왕복을 실측.
+//             기록은 ~/.grok/installed-plugins/registry.json(global-plugin.mjs).
+//
+// kimi는 설치가 대화형 /plugins뿐이라 헤드리스 경로가 없다. claude는 프로젝트
+// 스코프 항목(plugin.superpowers)의 자리다.
 //
 // skill.superpowers(공유 .agents/skills)와 배타로 묶지 않는다 — 저쪽은 이
 // 저장소에만, 이쪽은 머신 전체에 작용해 평면이 다르고, "claude는 프로젝트
 // 플러그인 + 나머지는 전역" 같은 조합이 정당하다. 겹치는 하니스가 같은 스킬을
 // 두 곳에서 본다는 것은 note에 적어 둔다.
-const SUPPORTS = ['codex', 'gemini', 'opencode', 'copilot']
+const SUPPORTS = ['codex', 'gemini', 'opencode', 'copilot', 'grok']
 
 const CONFIG = {
   id: 'global.superpowers', label: 'superpowers', group: '__flow',
   note: 'item.global.superpowers.note',
+  verified: '2026-09-05',
   pluginName: 'superpowers',
   marketplaceRepo: 'obra/superpowers-marketplace',
   installId: 'superpowers@superpowers-marketplace',
   gemini: 'https://github.com/obra/superpowers',
   opencode: 'superpowers@git+https://github.com/obra/superpowers.git',
+  grok: 'superpowers@xai-official',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
       c,
       c === 'claude' ? msg('item.unsupported.superpowersGlobalClaude')
-      : c === 'grok' ? msg('item.unsupported.superpowersGlobalGrok')
       : c === 'kimi' ? msg('item.unsupported.superpowersGlobalKimi')
+      // 상류 README가 Antigravity 설치를 안내하지만 감지·제거 경로를 실측할
+      // CLI가 없다 — grok과 같은 기준으로 아직 배선하지 않는다.
+      : c === 'antigravity' ? msg('item.unsupported.unmeasuredUpstream')
       : msg('item.unsupported.upstreamNone'),
     ]),
   ),

package/lib/items/plugin.ecc.mjs

@@ -17,6 +17,7 @@ export default definePlugin({
   detectIds: ['ecc@ecc'],
   marketplace: { name: 'ecc', repo: 'affaan-m/ECC' },
   note: 'item.plugin.ecc.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [
       c,

package/lib/items/plugin.impeccable.mjs

@@ -15,13 +15,14 @@ import { msg } from '../i18n/index.mjs'
 // 상류 공식 프로바이더는 3.6.0 기준 16개(.agent=antigravity·.hermes가 새로
 // 들어옴 — README는 아직 수동 복사만 안내해 코드가 앞선다). 이 저장소의 CLI와
 // 겹치는 것은 아래 UPSTREAM 그대로다.
-const UPSTREAM = ['codex', 'gemini', 'opencode', 'kiro', 'grok', 'copilot']
+const UPSTREAM = ['codex', 'gemini', 'opencode', 'kiro', 'grok', 'copilot', 'antigravity']
 export default definePlugin({
   id: 'plugin.impeccable', label: 'impeccable', group: '__style',
   installId: 'impeccable@impeccable',
   detectIds: ['impeccable@impeccable'],
   marketplace: { name: 'impeccable', repo: 'pbakaus/impeccable' },
   note: 'item.plugin.impeccable.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [
       c,

package/lib/items/plugin.mattpocock-skills.mjs

@@ -13,6 +13,7 @@ export default definePlugin({
   detectIds: ['mattpocock-skills@mattpocock'],
   marketplace: { name: 'mattpocock', repo: 'mattpocock/skills' },
   note: 'item.plugin.mattpocock-skills.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg('item.unsupported.mattpocockRegistry')]),
   ),

package/lib/items/plugin.ponytail.mjs

@@ -50,6 +50,7 @@ export default {
     ]),
   ),
   note: 'item.plugin.ponytail.note',
+  verified: '2026-08-15',
 
   async detect({ root }) {
     const present = []

package/lib/items/plugin.superpowers.mjs

@@ -10,7 +10,7 @@ import { msg } from '../i18n/index.mjs'
 // Grok은 6.2.0에는 없다가 6.3.0에서 들어왔다 — `### Grok Build CLI`의
 // `grok plugin install superpowers@xai-official --trust`다. Devin·Hermes도 같이
 // 늘었지만 둘 다 이 저장소가 다루는 CLI가 아니다.
-const SEPARATE = ['codex', 'gemini', 'opencode', 'kimi', 'copilot', 'grok']
+const SEPARATE = ['codex', 'gemini', 'opencode', 'kimi', 'copilot', 'grok', 'antigravity']
 
 export default definePlugin({
   id: 'plugin.superpowers', label: 'superpowers', group: '__flow',
@@ -18,6 +18,7 @@ export default definePlugin({
   installId: 'superpowers@claude-plugins-official',
   detectIds: ['superpowers@claude-plugins-official', 'superpowers@superpowers-marketplace'],
   note: 'item.plugin.superpowers.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [
       c,

package/lib/items/plugin.understand-anything.mjs

@@ -15,6 +15,7 @@ export default definePlugin({
   detectIds: ['understand-anything@understand-anything'],
   marketplace: { name: 'understand-anything', repo: 'Egonex-AI/Understand-Anything' },
   note: 'item.plugin.understand-anything.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg('item.unsupported.uaUser')]),
   ),

package/lib/items/skill.agent-browser.mjs

@@ -13,4 +13,5 @@ export default defineRegistrySkill({
   source: 'https://github.com/vercel-labs/agent-browser',
   skill: 'agent-browser',
   note: 'item.skill.agent-browser.note',
+  verified: '2026-08-15',
 })

package/lib/items/skill.find-skills.mjs

@@ -9,4 +9,5 @@ export default defineRegistrySkill({
   source: 'https://github.com/vercel-labs/skills',
   skill: 'find-skills',
   note: 'item.skill.find-skills.note',
+  verified: '2026-08-15',
 })

package/lib/items/skill.gsd.mjs

@@ -26,6 +26,7 @@ import { LocalizedError, msg } from '../i18n/index.mjs'
 //   kimi    `--kimi --local`이 "Project-level Kimi install semantics remain
 //           deferred"를 찍고 거부한다 — 전역 설치만 가능하다.
 //   kiro·grok·vscode  상류 런타임 목록에 없다.
+//   antigravity  --antigravity 플래그가 있지만 설치 경로를 실측하지 못했다.
 const RUNTIMES = [
   { cli: 'claude', dirs: ['.claude/commands', '.claude/skills'] },
   { cli: 'codex', dirs: ['.codex/skills'] },
@@ -56,11 +57,15 @@ export default defineSkill({
   id: 'skill.gsd', label: 'GSD (Get Shit Done)', group: '__flow', scope: 'project',
   note: 'item.skill.gsd.note',
   supports: SUPPORTS,
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
       c,
       c === 'gemini' ? msg('item.unsupported.gsdGemini')
         : c === 'kimi' ? msg('item.unsupported.gsdKimiLocal')
+          // --antigravity 플래그가 있지만 어느 경로에 무엇을 쓰는지 실측하지
+          // 못했다 — 실측 전에는 배선하지 않는다.
+          : c === 'antigravity' ? msg('item.unsupported.unmeasuredUpstream')
           : msg('item.unsupported.upstreamNone'),
     ]),
   ),

package/lib/items/skill.gstack.mjs

@@ -29,6 +29,7 @@ const SHARED_RECURSIVE = ['codex', 'opencode']
 export default defineSkill({
   id: 'skill.gstack', label: 'gstack', group: '__flow', scope: 'project',
   note: 'item.skill.gstack.note',
+  verified: '2026-08-15',
   unsupported: Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [
       c,

package/lib/items/skill.hallmark.mjs

@@ -7,4 +7,5 @@ export default defineRegistrySkill({
   source: 'https://github.com/nutlope/hallmark',
   skill: 'hallmark',
   note: 'item.skill.hallmark.note',
+  verified: '2026-08-10',
 })

package/lib/items/skill.mcp-builder.mjs

@@ -10,4 +10,5 @@ export default defineRegistrySkill({
   source: 'https://github.com/anthropics/skills',
   skill: 'mcp-builder',
   note: 'item.skill.mcp-builder.note',
+  verified: '2026-08-15',
 })

package/lib/items/skill.strix.mjs

@@ -9,4 +9,5 @@ export default defineRegistrySkill({
   skill: '*',
   anchor: 'penetration-testing-with-strix',
   note: 'item.skill.strix.note',
+  verified: '2026-09-02',
 })

package/lib/jsonfile.mjs

@@ -1,22 +1,41 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
 import { dirname } from 'node:path'
-import { parse, modify, applyEdits } from 'jsonc-parser'
+import { parse, modify, applyEdits, printParseErrorCode } from 'jsonc-parser'
+import { LocalizedError } from './i18n/index.mjs'
 
 const FORMAT = { formattingOptions: { insertSpaces: true, tabSize: 2 } }
+// 이 파일들은 도구가 읽는 JSONC다 — 주석과 후행 콤마는 정상이다.
+const PARSE = { allowTrailingComma: true }
 
 function readText(file) {
   return existsSync(file) ? readFileSync(file, 'utf8') : ''
 }
 
+// jsonc-parser의 parse는 던지지 않는다 — 닫는 괄호가 빠진 파일도 "복구한"
+// 값을 돌려준다. 그대로 두면 깨진 파일에 키를 끼워 넣고 has()는 설치됨으로
+// 읽어, 사용자는 파일이 깨진 것을 끝까지 모른다. 오류 목록을 받아 하나라도
+// 있으면 record.mjs의 readRecord처럼 어느 파일이 왜 깨졌는지 말하며 던진다.
+function parseStrict(text, file) {
+  const errors = []
+  const data = parse(text, errors, PARSE)
+  if (errors.length > 0) {
+    const [first] = errors
+    const line = text.slice(0, first.offset).split('\n').length
+    throw new LocalizedError('error.jsonInvalid', { path: file, message: `${printParseErrorCode(first.error)} (line ${line})` })
+  }
+  return data
+}
+
 export function readJson(file) {
   const text = readText(file)
   if (!text.trim()) return undefined
-  return parse(text)
+  return parseStrict(text, file)
 }
 
 export function setKey(file, path, value) {
   let text = readText(file)
   if (!text.trim()) text = '{}\n'
+  else parseStrict(text, file)
   const edits = modify(text, path, value, FORMAT)
   mkdirSync(dirname(file), { recursive: true })
   writeFileSync(file, applyEdits(text, edits))
@@ -25,7 +44,7 @@ export function setKey(file, path, value) {
 export function removeKey(file, path) {
   const text = readText(file)
   if (!text.trim()) return
-  if (getIn(parse(text), path) === undefined) return
+  if (getIn(parseStrict(text, file), path) === undefined) return
   const edits = modify(text, path, undefined, FORMAT)
   writeFileSync(file, applyEdits(text, edits))
 }

package/lib/status.mjs

@@ -8,7 +8,17 @@ import { updateBlocks, updateFiles } from './bootstrap/apply.mjs'
 import { readRecord, toolVersion } from './bootstrap/record.mjs'
 import { createT } from './i18n/index.mjs'
 
-export async function collectStatus(root, { manifest = MANIFEST, items = [], latest } = {}) {
+// 미배선 사유는 상류를 실측한 날의 사실이다. 그 날짜(item.verified)가 이보다
+// 오래되면 status가 알린다 — 사유 문장이 화면에 낡은 채 남는 것을 막는 유일한
+// 장치다. 90일은 상류 하니스들의 릴리스 간격을 넉넉히 덮는 값이다.
+export const STALE_DAYS = 90
+
+function daysSince(iso, now) {
+  const ms = now - Date.parse(`${iso}T00:00:00Z`)
+  return Number.isFinite(ms) ? Math.floor(ms / 86_400_000) : 0
+}
+
+export async function collectStatus(root, { manifest = MANIFEST, items = [], latest, now = Date.now() } = {}) {
   const record = readRecord(root)
 
   // dry-run으로 갱신 판정만 얻는다 — 판정 로직을 두 벌 두면 status와 update가
@@ -35,6 +45,9 @@ export async function collectStatus(root, { manifest = MANIFEST, items = [], lat
   }
   const installed = states.filter((s) => s.status !== 'absent').map((s) => s.id)
   const intended = new Set(record?.items ?? [])
+  const stale = items
+    .filter((i) => i.verified && daysSince(i.verified, now) > STALE_DAYS)
+    .map((i) => ({ id: i.id, verified: i.verified }))
 
   return {
     hasRecord: Boolean(record),
@@ -53,6 +66,7 @@ export async function collectStatus(root, { manifest = MANIFEST, items = [], lat
       installed,
       recordOnly: [...intended].filter((id) => !installed.includes(id)),
       repoOnly: installed.filter((id) => !intended.has(id)),
+      stale,
     },
   }
 }
@@ -81,13 +95,35 @@ export function formatStatus(report, t = createT('en')) {
   lines.push(t('status.row.items', { list: items.installed.join(', ') || t('status.none') }))
   if (items.recordOnly.length) lines.push(t('status.row.recordOnly', { list: items.recordOnly.join(', ') }))
   if (items.repoOnly.length) lines.push(t('status.row.repoOnly', { list: items.repoOnly.join(', ') }))
+  if (items.stale?.length) {
+    lines.push(t('status.row.stale', { list: items.stale.map((s) => `${s.id} (${s.verified})`).join(', ') }))
+    lines.push(t('status.hint.stale', { days: STALE_DAYS }))
+  }
 
   return lines.join('\n')
 }
 
-export async function runStatus(root, { json = false, log = console.log, t = createT('en') } = {}) {
+// 레지스트리의 최신 발행 버전. status는 진단 명령이라 네트워크가 없거나
+// 느려도 죽으면 안 된다 — 어떤 실패든 null로 떨어뜨리고 화면은 "최신"
+// 자리만 비운다. 시간 제한은 짧게 둔다: 이 한 줄 때문에 status가 20초를
+// 기다리면 진단 도구가 아니다.
+export const LATEST_TIMEOUT_MS = 5000
+const LATEST_URL = 'https://registry.npmjs.org/@rch4com%2Fagent-setup/latest'
+
+export async function fetchLatestVersion(fetchImpl = fetch) {
+  try {
+    const res = await fetchImpl(LATEST_URL, { signal: AbortSignal.timeout(LATEST_TIMEOUT_MS) })
+    if (!res.ok) return null
+    const version = (await res.json())?.version
+    return typeof version === 'string' && version ? version : null
+  } catch {
+    return null
+  }
+}
+
+export async function runStatus(root, { json = false, log = console.log, fetchImpl = fetch, t = createT('en') } = {}) {
   const { loadItems } = await import('./catalog.mjs')
-  const report = await collectStatus(root, { items: await loadItems() })
+  const report = await collectStatus(root, { items: await loadItems(), latest: await fetchLatestVersion(fetchImpl) })
   log(json ? JSON.stringify(report, null, 2) : formatStatus(report, t))
   return report
 }

package/lib/tui/detail.mjs

@@ -47,27 +47,60 @@ function headLine(row, w, t) {
   return cut(`${item.label}   ${bits.filter(Boolean).join(' · ')}`, w)
 }
 
+// CLI 이름 나열(a·b·c)을 이름 경계에서만 접는다. width.wrap은 공백에서만
+// 끊어, 공백 없는 나열은 낱말 중간(`ant` / `igravity`)에서 갈라졌다.
+function wrapNames(names, limit) {
+  const lines = []
+  let cur = ''
+  for (const name of names) {
+    const next = cur ? `${cur}·${name}` : name
+    if (cur && width(next) > limit) {
+      lines.push(cur)
+      cur = name
+    } else {
+      cur = next
+    }
+  }
+  if (cur) lines.push(cur)
+  return lines
+}
+
 function wiredLines(item, w, lead, t) {
   const supports = item.supports ?? []
   if (supports.length === 0) return []
   // 경로는 MCP에서만 붙인다. 그때만 clis.mjs 어댑터가 경로의 유일한 진실이다 —
   // plugin·skill은 설치 자리가 항목마다 달라 어댑터가 알지 못한다.
   const showFile = item.category === 'mcp'
-  const nameWidth = Math.max(...supports.map((c) => width(c)))
-  return supports.map((cli, i) => {
-    const head = i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)
-    const file = showFile && CLIS[cli]?.file ? `  ${CLIS[cli].file}` : ''
-    // 이름 뒤에 열이 없으면 맞출 대상도 없다 — 경로가 붙는 mcp에서만 이름을 편다.
-    const name = showFile ? pad(cli, nameWidth) : cli
-    return cut(`${head}✔ ${name}${file}`, w)
-  })
+  // 경로가 없으면 세로로 늘어놓을 이유가 없다 — CLI 열한 개를 한 줄에 하나씩
+  // 놓으면 80×24에서 `배선 ✔ claude` 뒤가 `…외 9줄`로 잘려 정작 "어디에
+  // 되나"를 펼쳐야만 읽을 수 있었다. 이름을 ·로 이어 접는다(미배선과 같은 꼴).
+  if (!showFile) {
+    return wrapNames(supports, Math.max(1, w - lead - 2)).map((line, i) =>
+      cut(`${i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)}${i === 0 ? '✔ ' : '  '}${line}`, w))
+  }
+  // MCP는 "CLI 경로" 쌍을 한 줄에 들어가는 만큼 채운다. 한 줄에 하나씩 놓으면
+  // 열 개가 열 줄이라 80×24 패널에서 절반이 `…외 N줄`로 접혔다. 폭이 좁으면
+  // 한 줄에 하나로 자연히 돌아간다.
+  const pairs = supports.map((cli) => (CLIS[cli]?.file ? `${cli} ${CLIS[cli].file}` : cli))
+  const colW = Math.max(...pairs.map((p) => width(p))) + 3
+  const room = Math.max(1, w - lead - 2)
+  const perLine = Math.max(1, Math.floor(room / colW))
+  const rows = []
+  for (let i = 0; i < pairs.length; i += perLine) {
+    const chunk = pairs.slice(i, i + perLine)
+    rows.push(chunk.map((p, j) => (j < chunk.length - 1 ? pad(p, colW) : p)).join(''))
+  }
+  return rows.map((line, i) => cut(`${i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)}${i === 0 ? '✔ ' : '  '}${line}`, w))
 }
 
 function unwiredLines(item, w, lead, t) {
   const out = []
   unsupportedGroups(item, t).forEach((group, i) => {
     const head = i === 0 ? pad(t('detail.unwired'), lead) : ' '.repeat(lead)
-    out.push(cut(`${head}✖ ${group.clis.join('·')}`, w))
+    // 미배선 CLI 이름도 같은 규칙으로 접는다 — 11개를 한 줄에 두면 뒤가 잘린다.
+    wrapNames(group.clis, Math.max(1, w - lead - 2)).forEach((line, j) => {
+      out.push(cut(`${j === 0 ? head : ' '.repeat(lead)}${j === 0 ? '✖ ' : '  '}${line}`, w))
+    })
     // 사유는 한 칸 더 들여 이어 붙인다. 첫 줄만 └를 달아 어느 CLI 묶음의
     // 사유인지 눈으로 잇는다.
     wrap(group.why, Math.max(1, w - lead - 3)).forEach((line, j) => {