@rch4com/agent-setup 1.21.1 → 1.23.0

package/lib/design-md/providers/oppadu.mjs

@@ -0,0 +1,128 @@
+// 오빠두엑셀 "디자인 시스템 갤러리" 프로바이더.
+//   https://www.oppadu.com/tools/design-systems-site/
+//
+// ⚠️ 아직 PROVIDERS(providers/index.mjs)에 등록하지 않는다. 사이트는 마크다운
+// 다운로드·복사·원본 보기를 로그인 회원 전용으로 두고 바닥글이 "All rights
+// reserved"다 — 재배포 허가(info@oppadu.com)가 오기 전에는 번들도, 카탈로그
+// 항목도, 등록도 하지 않는다. design-md.oppadu.test.mjs가 이 상태를 못박는다.
+// 허가가 오면: index.mjs에 등록 → `design --sync=catalog` → `npm run refresh-bundle`
+// → cache/oppadu/LICENSE.md 고지 → README의 design.md 절 갱신 → 발행.
+//
+// 사이트 구조(2026-09-06 실측, schema_version 3):
+//   카탈로그  data/brands-index.json — 브랜드 242개의 slug·이름·지역·한 줄 설명.
+//             갤러리 그리드가 그대로 읽는 공개 파일이다.
+//   파일      data/detail/<slug>.json — raw_markdown(라이트)·raw_markdown_dark.
+//             사이트의 "가이드 다운로드"는 라이트 모드에서 raw_markdown의
+//             `[data-theme="dark"]` 규칙을 걷어낸 것을 <slug>-light.md로 저장한다
+//             (app.js currentDownloadMd·stripDarkBlock) — DESIGN.md도 그 판을 쓴다.
+//   미리보기  brand/<slug>.html — 로그인 없이 보이는 공개 페이지.
+import { existsSync, readFileSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { LocalizedError } from '../../i18n/index.mjs'
+import { isSafeSegment } from '../../untrusted.mjs'
+
+const BUNDLE_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', 'cache')
+
+const BASE = 'https://www.oppadu.com/tools/design-systems-site'
+const INDEX_URL = `${BASE}/data/brands-index.json`
+
+// 카테고리는 사이트의 전체 목록 페이지(brand/)가 쓰는 지역 묶음과 같다 —
+// 한국 48·아시아 14·해외 180. 색인의 `western`을 그 페이지는 "해외"로 적는다.
+export const REGION_LABELS = { korea: '한국', asia: '아시아', western: '해외' }
+
+// 사이트의 displayName과 같은 규칙 — 한국 브랜드만 괄호에 한글 이름을 붙인다.
+function displayName(b) {
+  return b.region === 'korea' && b.brand_ko ? `${b.brand} (${b.brand_ko})` : String(b.brand ?? b.slug)
+}
+
+// brands-index.json → 카탈로그 엔트리. slug가 곧 이름이자 설치 경로 세그먼트다.
+export function parseIndex(index) {
+  const brands = Array.isArray(index?.brands) ? index.brands : []
+  return brands
+    .filter((b) => typeof b?.slug === 'string' && isSafeSegment(b.slug))
+    .map((b) => ({
+      name: b.slug,
+      label: displayName(b),
+      category: REGION_LABELS[b.region] ?? String(b.region ?? ''),
+      description: String(b.signature_keyword ?? ''),
+    }))
+    .sort((a, b) => a.name.localeCompare(b.name))
+}
+
+// app.js의 stripDarkBlock을 그대로 옮겼다 — 사이트의 라이트 다운로드와 글자
+// 단위로 같은 결과를 내야 한다. `[data-theme="dark"] { … }` 규칙을 중괄호
+// 짝으로 찾아 제 줄까지 통째로 지운다(CSS 규칙 안에 중첩 중괄호는 없다).
+export function stripDarkBlock(md) {
+  if (!md) return md
+  let out = md
+  let idx
+  while ((idx = out.indexOf('[data-theme="dark"]')) !== -1) {
+    const open = out.indexOf('{', idx)
+    if (open === -1) break
+    let depth = 1
+    let i = open + 1
+    for (; i < out.length && depth > 0; i++) {
+      if (out[i] === '{') depth++
+      else if (out[i] === '}') depth--
+    }
+    let start = idx
+    while (start > 0 && (out[start - 1] === ' ' || out[start - 1] === '\t')) start--
+    if (start > 0 && out[start - 1] === '\n') start--
+    out = out.slice(0, start) + out.slice(i)
+  }
+  return out
+}
+
+// app.js의 currentDownloadMd(mode='light')와 같다. 라이트·다크 겸용 브랜드는
+// 다크 규칙을 걷어낸 라이트 판, 단일 모드 브랜드는 원문 그대로.
+export function toDesignMd(detail) {
+  const md = detail?.raw_markdown
+  if (typeof md !== 'string' || md.length === 0) return null
+  const modes = Array.isArray(detail.theme_modes) ? detail.theme_modes : []
+  const dual = modes.includes('light') && modes.includes('dark')
+  const hasDark = dual && typeof detail.raw_markdown_dark === 'string' && detail.raw_markdown_dark.length > 0
+  return hasDark ? stripDarkBlock(md) : md
+}
+
+export const oppadu = {
+  id: 'oppadu',
+  label: 'Design Systems Gallery (오빠두엑셀)',
+  files: ['DESIGN.md'],
+  // 재배포 허가 전이다 — refresh-bundle과 번들 검사가 이 값을 보고 건너뛴다.
+  redistributable: false,
+
+  fileUrl(name) {
+    return `${BASE}/data/detail/${encodeURIComponent(name)}.json`
+  },
+
+  webUrl(name) {
+    return `${BASE}/brand/${encodeURIComponent(name)}.html`
+  },
+
+  bundlePath(name, file = 'DESIGN.md') {
+    return join(BUNDLE_DIR, this.id, name, file)
+  },
+
+  bundledText(name, file = 'DESIGN.md') {
+    if (/[\\/]/.test(name)) return null
+    const p = this.bundlePath(name, file)
+    return existsSync(p) ? readFileSync(p, 'utf8') : null
+  },
+
+  // 상세 JSON 하나가 곧 파일이다. 응답이 없거나 원문 필드가 비면 null —
+  // defineDesignMd가 그것을 "내려받지 못했다"로 보고한다.
+  async fetchFile(fetchImpl, name) {
+    const res = await fetchImpl(this.fileUrl(name))
+    if (!res.ok) return null
+    return toDesignMd(await res.json())
+  },
+
+  async fetchCatalog(fetchImpl) {
+    const res = await fetchImpl(INDEX_URL)
+    if (!res.ok) throw new LocalizedError('error.indexFetch', { url: INDEX_URL, status: res.status })
+    return parseIndex(await res.json())
+  },
+}
+
+export default oppadu

package/lib/i18n/catalog/en.mjs

@@ -267,6 +267,7 @@ export default {
   'item.mcp.vercel.note': 'auth: OAuth on first use (only approved clients can connect)',
   'item.mcp.supabase.note': 'auth: OAuth dynamic registration. Add ?project_ref=<id> to the URL to pin a project',
   'item.mcp.codebase-memory.note': 'needs the codebase-memory-mcp binary on PATH. Install: https://github.com/DeusData/codebase-memory-mcp (install.sh / install.ps1)',
+  'item.mcp.graft.note': 'serves a codebase knowledge graph as six MCP tools (find_code, trace_calls, file_api and more). Runs as npx -y @nanonets/graft mcp, so nothing to install, but build the graph (graft/) first with graft build (the structural graph needs no LLM key). On Windows the tree-sitter-kotlin dependency needs a C++ toolchain to compile and Node 24 cannot compile it at all (upstream #400) — use Node 22 plus the VS C++ workload. The upstream graft init edits AGENTS.md, GEMINI.md and hooks directly, so it is not used',
   'item.mcp.graphify.note': 'needs the graphify-mcp binary on PATH. Install: uv tool install "graphifyy[mcp]". Reads graphify-out/graph.json — build it first with /graphify .',
   'item.mcp.headroom.note': 'needs the headroom binary on PATH. Install: uv tool install --python 3.13 "headroom-ai[proxy,mcp]". The proxy (headroom wrap) is a way of launching, not repo config',
   'item.plugin.superpowers.note': 'official marketplace plugin. Upstream supports 14 harnesses (Codex, Grok Build, …) via per-harness installs',
@@ -277,6 +278,7 @@ export default {
   'item.plugin.ecc.note': 'skills, instincts, memory and security for agent harnesses. Installed as a plugin — its skills/ holds 284 entries, too many to copy into the shared skills directory',
   'item.plugin.impeccable.note': 'design language for AI harnesses. Plugin route on purpose: npx impeccable install replaces .claude/skills and breaks the shared .agents/skills link',
   'item.plugin.understand-anything.note': 'turns the codebase into an explorable knowledge graph. The script for other CLIs clones into ~/.understand-anything (user scope), so only the plugin is wired',
+  'item.skill.i-have-adhd.note': 'output shaping for an ADHD reader — next action first, numbered steps, no tangents, restated progress, no preamble or closers. Turn on with /i-have-adhd, off with "stop adhd mode". Always-on is what the upstream Claude plugin edition adds through its hook; this item instead installs the shared skill that all 11 CLIs see',
   'item.skill.caveman.note': 'cuts output tokens by answering in caveman-speak; code and errors stay byte-exact. Toggle with /caveman',
   'item.skill.taste.note': 'anti-slop frontend skill for landing pages, portfolios and redesigns (skill name: design-taste-frontend)',
   'item.skill.hallmark.note': 'anti-AI-slop design skill with four verbs (build, audit, redesign, study). 21 themes and 57 slop-test gates. Upstream also documents Cursor and Codex paths; the shared skills directory covers all 11 CLIs at once',
@@ -289,6 +291,7 @@ export default {
   'item.skill.karpathy.note': 'behavioral guidelines that curb overbuilding and vague success criteria',
   'item.skill.prompt-master.note': 'a skill that writes and refines prompts for AI tools. Activates only when explicitly asked to write or fix a prompt. Harness-neutral body shared by all 11 CLIs',
   'item.skill.strix.note': 'copies 9 security-testing skills (pentesting, OWASP Top 10, vulnerability discovery and fix flows) into the shared .agents/skills. The skills drive the Strix agent, so the strix binary is required on PATH — self-hosted needs pipx install strix-agent plus Docker and STRIX_LLM/LLM_API_KEY, managed needs strix cloud login. Use only against targets you are authorized to test',
+  'item.skill.officecli.note': 'copies a skill for reading, editing and creating Word, Excel and PowerPoint documents (.docx, .xlsx, .pptx) into the shared .agents/skills. The skill drives the officecli binary, so officecli is required on PATH — npm install -g @officecli/officecli or the upstream install.sh/install.ps1. No Office installation needed',
   'item.skill.gstack.note': 'repo-local clone + setup (needs bash; Git Bash on Windows). Runtime state (~/.gstack) may be created globally. In a bootstrapped repository .claude/skills is a junction, so the files land in the shared .agents/skills — codex and opencode scan recursively and see the individual skills too',
   'item.skill.gsd.note': 'npx @opengsd/gsd-core, installed per project — wires five runtimes in one run: claude, codex, opencode, copilot, kilo (.claude/commands, .codex/skills, .opencode/skills, .github/skills, .kilo/skills). Each runtime writes roughly 700 files. gemini was dropped upstream and kimi still blocks project installs',
   // 커밋 템플릿은 CLI 배선이 아니라 저장소 규약이다 — note가 "무엇이 놓이고
@@ -489,4 +492,5 @@ export default {
   'error.ambiguousDesignId': 'ambiguous name \'{token}\' — pick a provider: {options}',
   'error.designDownload': '{provider}/{name}: DESIGN.md download failed',
   'error.readmeFetch': 'README fetch failed: HTTP {status}',
+  'error.indexFetch': 'index fetch failed: HTTP {status} ({url})',
 }

package/lib/i18n/catalog/ko.mjs

@@ -260,6 +260,7 @@ export default {
   'item.mcp.vercel.note': '인증: 첫 사용 시 OAuth (승인된 클라이언트만 연결 가능)',
   'item.mcp.supabase.note': '인증: OAuth 동적 등록. 프로젝트 고정이 필요하면 URL에 ?project_ref=<id> 추가',
   'item.mcp.codebase-memory.note': 'PATH에 codebase-memory-mcp 바이너리 필요. 설치: https://github.com/DeusData/codebase-memory-mcp (install.sh / install.ps1)',
+  'item.mcp.graft.note': '코드베이스 지식 그래프를 MCP 도구 6종(find_code·trace_calls·file_api 등)으로 냅니다. npx -y @nanonets/graft mcp로 실행하므로 별도 설치는 없지만, graft build로 그래프(graft/)를 먼저 만드세요(구조 그래프는 LLM 키 불필요). Windows는 의존성 tree-sitter-kotlin이 C++ 툴체인 컴파일을 요구하고 Node 24는 컴파일이 안 됩니다(상류 #400) — Node 22 + VS C++ 워크로드가 필요합니다. 상류 graft init은 AGENTS.md·GEMINI.md·훅을 직접 고치므로 쓰지 않습니다',
   'item.mcp.graphify.note': 'PATH에 graphify-mcp 바이너리 필요. 설치: uv tool install "graphifyy[mcp]". graphify-out/graph.json을 읽으므로 /graphify .로 그래프를 먼저 만드세요',
   'item.mcp.headroom.note': 'PATH에 headroom 바이너리 필요. 설치: uv tool install --python 3.13 "headroom-ai[proxy,mcp]". 프록시(headroom wrap)는 실행 방식이라 저장소 설정 대상이 아닙니다',
   'item.plugin.superpowers.note': '공식 마켓플레이스 플러그인. 상류는 Codex·Grok Build 등 14개 하니스를 하니스별 설치로 지원합니다',
@@ -270,6 +271,7 @@ export default {
   'item.plugin.ecc.note': '에이전트 하네스용 스킬·본능·메모리·보안 묶음. skills/에 284개가 들어 있어 공유 스킬 디렉터리에 복사하지 않고 플러그인으로 설치합니다',
   'item.plugin.impeccable.note': 'AI 하네스용 디자인 언어. 플러그인 경로를 쓰는 이유는 npx impeccable install이 .claude/skills를 갈아치워 공유 .agents/skills 연결을 끊기 때문입니다',
   'item.plugin.understand-anything.note': '코드베이스를 탐색 가능한 지식 그래프로 만듭니다. 다른 CLI용 스크립트는 ~/.understand-anything에 클론하는 사용자 스코프라 플러그인만 배선합니다',
+  'item.skill.i-have-adhd.note': 'ADHD 독자를 위한 출력 형식 — 다음 행동부터, 단계는 번호로, 곁길 억제, 진행 상태 재진술, 서두·맺음말 없음. /i-have-adhd로 켜고 "stop adhd mode"로 끕니다. 상시 적용은 상류 Claude 플러그인 판의 훅이 담당하는데, 이 항목은 그 대신 11개 CLI가 함께 보는 공유 스킬로 넣습니다',
   'item.skill.caveman.note': '원시인 말투로 답해 출력 토큰을 줄입니다. 코드와 오류는 그대로 둡니다. /caveman으로 켜고 끕니다',
   'item.skill.taste.note': '랜딩 페이지·포트폴리오·리디자인용 안티슬롭 프런트엔드 스킬 (스킬 이름: design-taste-frontend)',
   'item.skill.hallmark.note': '네 가지 동사(신규 제작·audit·redesign·study)를 갖춘 안티 AI슬롭 디자인 스킬. 테마 21종과 슬롭 테스트 57종. 상류는 Cursor·Codex 경로도 안내하지만 공유 스킬 디렉터리 하나로 11개 CLI가 함께 봅니다',
@@ -282,6 +284,7 @@ export default {
   'item.skill.karpathy.note': '과설계와 모호한 완료 기준을 줄이는 행동 지침',
   'item.skill.prompt-master.note': 'AI 도구용 프롬프트를 만들고 다듬는 스킬. 프롬프트 작성·수정을 명시적으로 요청할 때만 활성화됩니다. 본문이 하네스 중립이라 11개 CLI가 함께 씁니다',
   'item.skill.strix.note': '보안 테스트 스킬 9종(침투 테스트·OWASP Top 10·취약점 탐지와 수정 흐름)을 공유 .agents/skills에 복사합니다. 스킬이 Strix 에이전트를 구동하므로 PATH에 strix 바이너리가 필요합니다 — 자체 호스팅은 pipx install strix-agent에 Docker와 STRIX_LLM·LLM_API_KEY, 관리형은 strix cloud login. 승인된 대상에만 쓰세요',
+  'item.skill.officecli.note': 'Word·Excel·PowerPoint(.docx·.xlsx·.pptx) 문서를 읽고 고치고 만드는 스킬을 공유 .agents/skills에 복사합니다. 스킬이 officecli 바이너리를 구동하므로 PATH에 officecli가 필요합니다 — npm install -g @officecli/officecli 또는 상류 install.sh·install.ps1. Office 설치는 필요 없습니다',
   'item.skill.gstack.note': '저장소 로컬 clone + setup (bash 필요, Windows는 Git Bash). 런타임 상태(~/.gstack)는 전역에 생길 수 있음. 부트스트랩 저장소에서는 .claude/skills가 Junction이라 실물이 공유 .agents/skills에 앉습니다 — codex·opencode는 재귀 스캔이라 개별 스킬까지 함께 봅니다',
   'item.skill.gsd.note': 'npx @opengsd/gsd-core 프로젝트 로컬 설치 — claude·codex·opencode·copilot·kilo 다섯 런타임을 한 번에 배선합니다(.claude/commands, .codex/skills, .opencode/skills, .github/skills, .kilo/skills). 런타임마다 700개 안팎의 파일이 생깁니다. gemini는 상류가 제거했고 kimi는 프로젝트 설치를 아직 막습니다',
   // 커밋 템플릿은 CLI 배선이 아니라 저장소 규약이다 — en.mjs 쪽 주석 참고.
@@ -474,4 +477,5 @@ export default {
   'error.ambiguousDesignId': '중복된 이름 \'{token}\' — 제공자를 지정하세요: {options}',
   'error.designDownload': '{provider}/{name}: DESIGN.md 다운로드 실패',
   'error.readmeFetch': 'README 가져오기 실패: HTTP {status}',
+  'error.indexFetch': '색인 가져오기 실패: HTTP {status} ({url})',
 }

package/lib/items/mcp.graft.mjs

@@ -0,0 +1,21 @@
+import { defineMcp } from '../catalog.mjs'
+// 상류 README가 "직접 등록할 때"의 계약으로 적은 명령 그대로다: npx -y
+// @nanonets/graft mcp (stdio). `graft mcp [dir]`은 dir 기본값이 실행 디렉터리라
+// 그래프(graft/, 상류가 .gitignore에 넣는 로컬 캐시)도 저장소 안에 있고,
+// 등록은 프로젝트 설정만으로 충분하다.
+//
+// 상류의 `graft init` 깊은 연동은 쓰지 않는다 — AGENTS.md·GEMINI.md·
+// .github/copilot-instructions.md에 마커 구간을 끼워 넣고 .claude/settings의
+// 훅·statusline과 ~/.codex 전역 설정까지 고치는데, 그 파일들은 이 저장소의
+// 부트스트랩이 관리한다. MCP 하나면 상류 도구 6종이 그대로 닿는다.
+//
+// 2026-09-17 실측 한계: Windows에서 의존성 tree-sitter-kotlin 0.3.8이 어느
+// 플랫폼용 prebuild도 없이 node-gyp 컴파일을 요구하고(다른 문법 패키지는
+// win32-x64 prebuild가 있다), Node 24는 헤더가 C++20을 요구해 컴파일 자체가
+// 안 된다(상류 #400). C++ 워크로드가 없는 이 머신에서는 서버를 띄우지
+// 못했으므로 배선(설정 파일 쓰기)만 왕복 검증했다 — note가 알린다.
+export default defineMcp({
+  id: 'mcp.graft', label: 'Graft MCP', group: '__context',
+  server: { kind: 'stdio', command: 'npx', args: ['-y', '@nanonets/graft', 'mcp'] },
+  note: 'item.mcp.graft.note',
+})

package/lib/items/skill.i-have-adhd.mjs

@@ -0,0 +1,16 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+// 상류는 skills/i-have-adhd/에 SKILL.md와 agents/(gemini.toml·openai.yaml)를
+// 두고 루트에는 SKILL.md가 없다 — 레지스트리가 그 폴더만 복사한다(3파일,
+// 13K, 2026-09-17 실측). Claude 마켓플레이스 플러그인 판(ayghri/i-have-adhd)도
+// 있지만 그쪽이 더 주는 것은 SessionStart 훅 하나이고, 그 훅은
+// ~/.claude/.i-have-adhd-always 플래그가 있을 때만 규칙을 상시 주입한다.
+// 스킬의 기본 자세는 /i-have-adhd로 켜는 opt-in이라 공유 스킬 판으로 11개
+// CLI를 함께 덮는 쪽을 택했다 — 상시 적용을 원하면 note가 안내하는 대로
+// 규칙 블록을 각 CLI의 지침 파일에 손으로 넣는다(상류 INSTALL.md).
+export default defineRegistrySkill({
+  id: 'skill.i-have-adhd', label: 'I Have ADHD', group: '__style',
+  source: 'https://github.com/ayghri/i-have-adhd',
+  skill: 'i-have-adhd',
+  note: 'item.skill.i-have-adhd.note',
+  verified: '2026-09-17',
+})

package/lib/items/skill.officecli.mjs

@@ -0,0 +1,21 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+// 상류는 루트 SKILL.md(공개 URL이 서빙하는 판)와 skills/officecli/SKILL.md
+// (레지스트리가 발견하는 spec 준수 판)를 바이트 동일하게 유지한다(상류
+// skill-parity 워크플로). 저장소 루트를 source로 주면 레지스트리가 루트
+// SKILL.md를 스킬로 보고 **저장소 전체**(src·assets·워크플로, 94MB·1,208
+// 파일)를 .agents/skills/officecli에 복사한다 — 2026-09-15 실측. 그래서
+// skills/officecli 하위 경로를 준다: SKILL.md 하나(28K)만 들어온다.
+// 잠금 파일의 source는 하위 경로 없이 iOfficeAI/OfficeCLI로 기록되는데,
+// 단일 스킬 항목은 잠금이 아니라 이름으로 지우므로 영향이 없다.
+//
+// 스킬 본문은 officecli 바이너리를 구동하는 지침이라 바이너리가 사실상
+// 전제다 — note가 알린다. 같은 폴더의 전문 스킬 10종(officecli-docx·pptx·
+// xlsx, pitch-deck, morph-ppt 등)은 넣지 않는다 — 상류가 에이전트에 안내하는
+// 공식 경로는 이 하나다(README "For AI Agents").
+export default defineRegistrySkill({
+  id: 'skill.officecli', label: 'OfficeCLI', group: '__service',
+  source: 'https://github.com/iOfficeAI/OfficeCLI/tree/main/skills/officecli',
+  skill: 'officecli',
+  note: 'item.skill.officecli.note',
+  verified: '2026-09-15',
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rch4com/agent-setup",
-  "version": "1.21.1",
+  "version": "1.23.0",
   "description": "Repository-scoped bootstrap and optional-item installer for using multiple coding-agent CLIs in one repository | 여러 코딩 에이전트 CLI를 한 저장소에서 함께 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기",
   "keywords": [
     "agents-md",