@uzysjung/agent-harness 26.170.0 → 26.172.0

package/README.ko.md

@@ -156,7 +156,7 @@ your-project/
 
 ## 지원하는 스택과 함께 제공하는 스킬
 
-트랙은 개발 스택이나 업무 종류별로 묶어 둔 시작 구성이다. 표의 위쪽 9개가 개발 트랙, 아래쪽 3개가 업무 트랙이다. 트랙을 고르면 아래 외부 스킬과 도구가 미리 체크된다. 미리 체크되는 것은 모두 공식 저장소이거나, 출처와 인기도, 설치 경로를 확인해 고른 저장소다. 내용의 안전성이나 결과물의 품질까지 보증하지는 않는다([SECURITY.md](SECURITY.md)).
+트랙은 개발 스택이나 업무 종류별로 묶어 둔 시작 구성이다. 표의 위쪽 10개가 개발 트랙, 아래쪽 3개가 업무 트랙이다. 트랙을 고르면 아래 외부 스킬과 도구가 미리 체크된다. 미리 체크되는 것은 모두 공식 저장소이거나, 출처와 인기도, 설치 경로를 확인해 고른 저장소다. 내용의 안전성이나 결과물의 품질까지 보증하지는 않는다([SECURITY.md](SECURITY.md)).
 
 | 트랙 | 스택 | 미리 체크되는 외부 스킬·도구 |
 |---|---|---|
@@ -165,7 +165,8 @@ your-project/
 | `csr-fastify` | Vite + React + Fastify | `frontend-design`, `react-best-practices`, `shadcn-ui` |
 | `csr-fastapi` | Vite + React + FastAPI | `frontend-design`, `react-best-practices`, `shadcn-ui` |
 | `ssr-nextjs` | Next.js (App Router) | `frontend-design`, `react-best-practices`, `shadcn-ui` |
-| `ssr-htmx` | htmx + FastAPI | `frontend-design` |
+| `ssr-htmx` | htmx + FastAPI (Python) + daisyUI | `frontend-design` |
+| `ssr-htmx-fastify` | htmx + Fastify (Node) + daisyUI | `frontend-design` |
 | `data` | Python 데이터 작업 (DuckDB, PySide6) | `anthropic-data-plugin` |
 | `tooling` | 앱 스택 없는 Bash·Markdown 프로젝트 | 없음 |
 | `full` | 개발 트랙 전부와 문서 작업 | 위 항목 전부 + `anthropic-document-skills` |
@@ -173,13 +174,14 @@ your-project/
 | `project-management` | PM 업무 | 없음 |
 | `growth-marketing` | 그로스·콘텐츠 마케팅 | 없음 (`marketingskills` 선택 가능) |
 
-MCP 서버도 함께 들어간다. 모든 트랙에 `context7`(최신 라이브러리 문서)가 들어가고, 웹 트랙(`csr-*`, `ssr-*`, `full`)에는 Google 사용 통계를 끈 `chrome-devtools`가 더해진다. `csr-*`와 `ssr-htmx` 트랙에는 `railway-mcp-server`(Railway 원격 서버 — 처음 쓸 때 로그인한다)가, `csr-supabase`에는 `supabase`(Supabase 원격 서버 — 처음 쓸 때 로그인한다)가 더해진다. `full`은 둘 다 받는다. `ssr-nextjs`에서는 Railway MCP가 기본이 아니고, 직접 고르면 들어간다. Vercel·GitHub 공식 원격 서버(`vercel`, `github-mcp`)는 미리 체크되지 않는다 — `--with`로 더한다. 서버마다 위저드 3단계에 한 줄씩 보이고, 체크를 풀거나 `--without <이름>`(예: `--without context7`)을 주면 `.mcp.json`·Codex·OpenCode 에서 빠진다.
+MCP 서버도 함께 들어간다. 모든 트랙에 `context7`(최신 라이브러리 문서)가 들어가고, 웹 트랙(`csr-*`, `ssr-*`, `full`)에는 Google 사용 통계를 끈 `chrome-devtools`가 더해진다. `csr-*`·`ssr-htmx`·`ssr-htmx-fastify` 트랙에는 `railway-mcp-server`(Railway 원격 서버 — 처음 쓸 때 로그인한다)가, `csr-supabase`에는 `supabase`(Supabase 원격 서버 — 처음 쓸 때 로그인한다)가 더해진다. `full`은 둘 다 받는다. `ssr-nextjs`에서는 Railway MCP가 기본이 아니고, 직접 고르면 들어간다. Vercel·GitHub 공식 원격 서버(`vercel`, `github-mcp`)는 미리 체크되지 않는다 — `--with`로 더한다. 서버마다 위저드 3단계에 한 줄씩 보이고, 체크를 풀거나 `--without <이름>`(예: `--without context7`)을 주면 `.mcp.json`·Codex·OpenCode 에서 빠진다.
 
 미리 체크되지는 않지만 3단계나 `--with <id>`로 더할 수 있는 것도 있다.
 
 - 프론트엔드·디자인: `web-design-guidelines`, `taste-skill`, `jakubkrehel-skills`, `preline`, `scroll-world`
 - 배포: `vercel-cli`, `netlify-cli`, `supabase-cli`, `railway-mcp-server`, `vercel`, `railway-skills`
 - 보안 리뷰: `security-guidance`, `claude-security`
+- 구조 기반 코드 검색·린트 규칙: `ast-grep` (ast-grep CLI 별도 설치 필요)
 - 마케팅·재무: `marketingskills`, `finance-skills`
 - 발표·영상: `frontend-slides`, `marp-slide`, `hyperframes`, `remotion`, `gsap-skills` 등
 - 정해진 개발 절차가 필요한 팀: `openspec`, `bmad-method` ([WORKFLOWS.md](docs/WORKFLOWS.md)에서 비교)

package/README.md

@@ -149,7 +149,7 @@ Plugins are a Claude Code feature, so only Claude Code gets them. Rules and skil
 
 ## Supported stacks and the skills that come with them
 
-A track is a starting setup for a dev stack or a kind of work: the top nine rows are dev tracks, the bottom three are work tracks. Picking a track pre-checks the external skills and tools below. Everything pre-checked comes from an official repository, or from one picked after checking its source, popularity, and install path. That does not vouch for the safety of its contents or the quality of what it produces ([SECURITY.md](SECURITY.md)).
+A track is a starting setup for a dev stack or a kind of work: the top ten rows are dev tracks, the bottom three are work tracks. Picking a track pre-checks the external skills and tools below. Everything pre-checked comes from an official repository, or from one picked after checking its source, popularity, and install path. That does not vouch for the safety of its contents or the quality of what it produces ([SECURITY.md](SECURITY.md)).
 
 | Track | Stack | Pre-checked external skills and tools |
 |---|---|---|
@@ -158,7 +158,8 @@ A track is a starting setup for a dev stack or a kind of work: the top nine rows
 | `csr-fastify` | Vite + React + Fastify | `frontend-design`, `react-best-practices`, `shadcn-ui` |
 | `csr-fastapi` | Vite + React + FastAPI | `frontend-design`, `react-best-practices`, `shadcn-ui` |
 | `ssr-nextjs` | Next.js (App Router) | `frontend-design`, `react-best-practices`, `shadcn-ui` |
-| `ssr-htmx` | htmx + FastAPI | `frontend-design` |
+| `ssr-htmx` | htmx + FastAPI (Python) + daisyUI | `frontend-design` |
+| `ssr-htmx-fastify` | htmx + Fastify (Node) + daisyUI | `frontend-design` |
 | `data` | Python data work (DuckDB, PySide6) | `anthropic-data-plugin` |
 | `tooling` | Bash and Markdown projects with no app stack | None |
 | `full` | Every dev track, plus documents | All of the above, plus `anthropic-document-skills` |
@@ -166,13 +167,14 @@ A track is a starting setup for a dev stack or a kind of work: the top nine rows
 | `project-management` | PM work | None |
 | `growth-marketing` | Growth and content marketing | None (`marketingskills` available) |
 
-MCP servers come too. Every track gets `context7` (current library docs). Web tracks (`csr-*`, `ssr-*`, `full`) add `chrome-devtools`, with Google's usage statistics turned off. The `csr-*` and `ssr-htmx` tracks add `railway-mcp-server` (Railway's remote server — you sign in on first use), and `csr-supabase` adds `supabase` (Supabase's remote server — you sign in on first use). `full` gets both. On `ssr-nextjs`, Railway MCP is not a default; pick it if you want it. Vercel's and GitHub's official remote servers (`vercel`, `github-mcp`) are never pre-checked — add them with `--with`. Each server is a row in step 3 of the wizard: uncheck it or pass `--without <name>` (e.g. `--without context7`) to leave it out of `.mcp.json`, Codex and OpenCode.
+MCP servers come too. Every track gets `context7` (current library docs). Web tracks (`csr-*`, `ssr-*`, `full`) add `chrome-devtools`, with Google's usage statistics turned off. The `csr-*`, `ssr-htmx` and `ssr-htmx-fastify` tracks add `railway-mcp-server` (Railway's remote server — you sign in on first use), and `csr-supabase` adds `supabase` (Supabase's remote server — you sign in on first use). `full` gets both. On `ssr-nextjs`, Railway MCP is not a default; pick it if you want it. Vercel's and GitHub's official remote servers (`vercel`, `github-mcp`) are never pre-checked — add them with `--with`. Each server is a row in step 3 of the wizard: uncheck it or pass `--without <name>` (e.g. `--without context7`) to leave it out of `.mcp.json`, Codex and OpenCode.
 
 More external assets are never pre-checked but can be added at step 3 or with `--with <id>`:
 
 - Frontend and design: `web-design-guidelines`, `taste-skill`, `jakubkrehel-skills`, `preline`, `scroll-world`
 - Deployment: `vercel-cli`, `netlify-cli`, `supabase-cli`, `railway-mcp-server`, `vercel`, `railway-skills`
 - Security review: `security-guidance`, `claude-security`
+- Structural code search and lint rules: `ast-grep` (needs the ast-grep CLI installed)
 - Marketing and finance: `marketingskills`, `finance-skills`
 - Slides and video: `frontend-slides`, `marp-slide`, `hyperframes`, `remotion`, `gsap-skills`, and more
 - Teams that want a fixed development process: `openspec`, `bmad-method` (compared in [WORKFLOWS.md](docs/WORKFLOWS.md))

package/dist/{chunk-MGFWOWF4.js → chunk-T2HBTG32.js}

@@ -47,6 +47,8 @@ var TRACKS = [
   "csr-fastify",
   "csr-fastapi",
   "ssr-htmx",
+  // #820 — htmx 의 Node 백엔드. `ssr-htmx`(FastAPI) 의 id 는 설치 기록이 갖고 있어 그대로 두고 옆에 더했다.
+  "ssr-htmx-fastify",
   "ssr-nextjs",
   "data",
   "executive",
@@ -448,7 +450,7 @@ var EXTERNAL_ASSETS = [
     }
   },
   // #709 (ADR-101) — Railway MCP 서버의 **선택** 경로. 서버 정의는 트랙 표(`templates/track-mcp-map.tsv`)의 같은 이름
-  //   행 하나다(key === 행 이름). 그 행의 패턴이 기본 트랙(csr-* · ssr-htmx · full)을 정하고, 이 항목은 그 밖의 트랙
+  //   행 하나다(key === 행 이름). 그 행의 패턴이 기본 트랙(csr-* · ssr-htmx · ssr-htmx-fastify · full)을 정하고, 이 항목은 그 밖의 트랙
   //   (ssr-nextjs 등)에서 위저드 체크 · `--with` 로 고르게 한다. experimental 이라 조건으로는 미리 체크되지 않는다.
   //   #712 (ADR-106) — 행이 Railway 공식 원격 서버(`https://mcp.railway.com`, OAuth)로 바뀌었다. 이름 · 키 id 는 그대로라 기록이
   //   이어져 update 가 같은 키를 갈아 끼운다.
@@ -456,7 +458,7 @@ var EXTERNAL_ASSETS = [
     id: "railway-mcp-server",
     tier: "experimental",
     // railwayapp/cli 621★ (원격 서버에 공개 저장소가 따로 없다 — 같은 벤더의 CLI 를 감시, REPO_OVERRIDE)
-    description: "Railway's official remote MCP (https://mcp.railway.com, signs in with OAuth on first use) in .mcp.json, Codex and OpenCode \u2014 default on csr-* \xB7 ssr-htmx \xB7 full; check it to add it on any other track",
+    description: "Railway's official remote MCP (https://mcp.railway.com, signs in with OAuth on first use) in .mcp.json, Codex and OpenCode \u2014 default on csr-* \xB7 ssr-htmx \xB7 ssr-htmx-fastify \xB7 full; check it to add it on any other track",
     category: "backend",
     source: "railwayapp",
     condition: { kind: "opt-in" },
@@ -658,6 +660,20 @@ var EXTERNAL_ASSETS = [
       skill: "preline-theme-generator"
     }
   },
+  // #822 (사용자 결정 2026-10-14) — ast-grep 공식 스킬. 언어에 매이지 않아 트랙에 묶지 않고 opt-in.
+  //   벤더 README 가 "설치하면 발견될 뿐 선호되지 않는다"고 적고, 기본으로 쓰게 하려면 상주 지시를 권한다 — 관측 없는
+  //   상주는 넣지 않으므로 원하는 사람이 고르는 자리에만 둔다. 스킬 파일에 CLI 설치 안내가 없어 description 에 적는다.
+  //   리포에 스킬이 2종(ast-grep · ast-grep-outline)이라 하나만 받는다. #820 의 htmx-fastapi-ui 룰은 이 스킬 없이 동작한다.
+  {
+    id: "ast-grep",
+    tier: "experimental",
+    // ast-grep/agent-skill 893★ (license none — README "follows ast-grep's MIT"; 본체 ast-grep/ast-grep 16k MIT, 2026-10-14)
+    description: "ast-grep \u2014 write and test structural (AST) search and lint rules across languages (ast-grep official). Needs the ast-grep CLI installed separately; fires reliably only when you ask for ast-grep",
+    category: "dev-tools",
+    source: "ast-grep",
+    condition: { kind: "opt-in" },
+    method: { kind: "skill", source: "ast-grep/agent-skill", skill: "ast-grep" }
+  },
   // === dev tools (has_dev_track) ===
   // v26.110.0 (ADR-039) — security-guidance: 매 편집 패턴 경고 + LLM diff 리뷰 (훅 12파일,
   //   Python + Agent SDK 의존). 상시 훅 = 매 편집 비용 + 폭발 반경 — 실측 전 기본설치 금지
@@ -1123,7 +1139,7 @@ import { dirname as dirname3, join as join4 } from "path";
 // package.json
 var package_default = {
   name: "@uzysjung/agent-harness",
-  version: "26.170.0",
+  version: "26.172.0",
   description: "Curate vetted AI-coding skills & plugins by your tech stack \u2014 install only what you need, across Claude Code, Codex, OpenCode & Antigravity",
   type: "module",
   publishConfig: {
@@ -1368,22 +1384,6 @@ function copyFile(source, target) {
   mkdirSync(dirname2(target), { recursive: true });
   copyFileSync(source, target);
 }
-function copyDir(source, target, foreignOf) {
-  if (!existsSync(source)) {
-    throw new Error(`Source dir not found: ${source}`);
-  }
-  mkdirSync(target, { recursive: true });
-  const skipped = [];
-  for (const rel of listFilesRecursive(source)) {
-    const foreign = foreignOf(rel);
-    if (foreign !== null) {
-      skipped.push(foreign);
-      continue;
-    }
-    copyFile(join2(source, rel), join2(target, rel));
-  }
-  return skipped;
-}
 var MAX_BACKUP_CLAIMS = 100;
 function claimBackupPath(base, claim) {
   for (let n = 1; n <= MAX_BACKUP_CLAIMS; n++) {
@@ -1665,38 +1665,11 @@ function mergeAssets(previous, current) {
 function hashContent(content) {
   return createHash("sha256").update(content, "utf8").digest("hex");
 }
-function isHarnessOwned(baseline, key, current) {
-  const recorded = baseline.get(key);
-  return recorded !== void 0 && recorded === hashContent(current);
-}
 function mergeExternalFiles(previous, current) {
   const byPath = /* @__PURE__ */ new Map();
   for (const file of [...previous ?? [], ...current]) byPath.set(file.path, file);
   return [...byPath.values()];
 }
-function collectSkillHashes(projectDir, templatesDir) {
-  const skillsDir = join4(projectDir, ".claude/skills");
-  return listFilesRecursive(skillsDir).filter((rel) => existsSync2(join4(templatesDir, "skills", rel))).map((rel) => ({
-    path: rel,
-    sha256: hashContent(readFileSync3(join4(skillsDir, rel), "utf8"))
-  }));
-}
-function collectPolicyHashes(projectDir, templatesDir) {
-  const out = [];
-  for (const { dir, ext } of POLICY_DIRS) {
-    const targetDir = join4(projectDir, ".claude", dir);
-    const sourceDir = join4(templatesDir, dir);
-    for (const rel of listFilesRecursive(targetDir)) {
-      if (!rel.endsWith(ext)) continue;
-      if (!existsSync2(join4(sourceDir, rel))) continue;
-      out.push({
-        path: `${dir}/${rel}`,
-        sha256: hashContent(readFileSync3(join4(targetDir, rel), "utf8"))
-      });
-    }
-  }
-  return out;
-}
 function writeInstallLog(projectDir, log) {
   const path2 = installLogPath(projectDir);
   mkdirSync2(dirname3(path2), { recursive: true });
@@ -1909,7 +1882,8 @@ var TRACK_DISPLAY_NAMES = {
   "csr-supabase": "CSR Supabase",
   "csr-fastify": "CSR Fastify",
   "csr-fastapi": "CSR FastAPI",
-  "ssr-htmx": "SSR HTMX",
+  "ssr-htmx": "SSR htmx + FastAPI",
+  "ssr-htmx-fastify": "SSR htmx + Fastify",
   "ssr-nextjs": "SSR Next.js",
   data: "Data",
   executive: "Executive",
@@ -2136,17 +2110,23 @@ var onTracks = (pattern) => (s) => anyTrack(s.tracks, pattern);
 var COMMON_RULES = ["git-policy", "change-management", "doc-governance"];
 var DEV_RULES = ["test-policy", "ship-checklist"];
 var UI_RULES = ["ui-components"];
+var REACT_UI_TRACKS = "csr-*|ssr-nextjs|full";
 var TRACK_RULES = {
   base: [],
   // #456 — 공통 룰만. cli-development 는 tooling·full 전용
   "csr-supabase": [],
   "csr-fastify": [],
   "csr-fastapi": [],
-  "ssr-htmx": [],
+  // #820 — htmx 화면 기술(Tailwind v4 + daisyUI)과 그 스택에서 실제로 도는 린트. 백엔드마다 템플릿 형식이
+  //   달라 린트가 갈린다(Jinja = ast-grep · 서버 JSX = @shadcn/lint) — 실측 = `docs/plans/820-spike/`. `full` 은 아래.
+  "ssr-htmx": ["htmx-fastapi-ui"],
+  "ssr-htmx-fastify": ["htmx-fastify-ui"],
   "ssr-nextjs": [],
   data: [],
   executive: [],
   tooling: ["cli-development"],
+  // #820 — htmx 룰 둘은 `full` 에 넣지 않는다. OpenCode 가 섞인 설치는 룰을 AGENTS.md 본문에 인라인하는데, full 의 렌더가
+  //   Antigravity 상한(24,000 B)을 넘는다(22,322 → 24,455 B, `agents-md-size-budget`). htmx 를 쓰면 그 트랙을 함께 고른다.
   full: ["cli-development"],
   // v0.5.0 — executive-style baselines (no dev rules; common rules only).
   "project-management": [],
@@ -2159,7 +2139,7 @@ function resolveRules(spec) {
       set.add(r);
     }
   }
-  if (hasUiTrack(spec.tracks)) {
+  if (anyTrack(spec.tracks, REACT_UI_TRACKS)) {
     for (const r of UI_RULES) {
       set.add(r);
     }
@@ -2634,7 +2614,6 @@ export {
   mergeOutside,
   ensureDir,
   copyFile,
-  copyDir,
   backupFile,
   backupFromCopy,
   claimBackupDir,
@@ -2676,10 +2655,7 @@ export {
   buildInstallLog,
   mergeRootFiles,
   hashContent,
-  isHarnessOwned,
   mergeExternalFiles,
-  collectSkillHashes,
-  collectPolicyHashes,
   writeInstallLog,
   readInstallLog,
   readInstallLogStatus,
@@ -2703,4 +2679,4 @@ export {
   CATEGORIES,
   CATEGORY_TITLES
 };
-//# sourceMappingURL=chunk-MGFWOWF4.js.map
+//# sourceMappingURL=chunk-T2HBTG32.js.map