zugzbot 1.0.21 → 1.0.23

package/.opencode/oh-my-design/skills/claude-design/scripts/gather_references.py

@@ -1,437 +0,0 @@
-#!/usr/bin/env python3
-"""Gather local brand/visual reference assets (and explicit URL references) for the claude-design skill.
-
-Walks a root directory (default: current working directory) up to a bounded depth, pruning
-noisy/excluded directories in place, and collects files whose extension matches a set of
-VISUAL image asset types. By default DOCUMENT files (.pdf, .hwp/.hwpx, .doc/.docx, .ppt/.pptx,
-.xls/.xlsx) are EXCLUDED — they are document templates, not brand visuals — unless --include-docs
-is passed.
-
-Ranking (v2): brand-likelihood FIRST, then modification time (newest first). Filenames that look
-like real brand assets (logo, wordmark, symbol, icon, brand, og, hero, cover, favicon, app-icon)
-score high and float to the top; everything else falls back to mtime. Results are then size-filtered
-and capped at a maximum count. This fixes the prior bug where large PDF business-plan templates
-outranked the real brand assets (logo.svg / og.png) that Claude Design actually wants.
-
-Explicit URL references can be passed (repeatable) and are echoed back alongside the discovered files.
-
-Designed to be robust: never crashes on a bad/unreadable path (PermissionError, FileNotFoundError,
-OSError are all swallowed gracefully). stdlib only.
-
-CLI:
-    python3 gather_references.py [--root DIR] [--max N] [--max-mb FLOAT] [--url URL ...]
-        [--ext .png,.jpg,...] [--exclude GLOB ...] [--depth N] [--include-docs] [--json]
-
-Output:
-    With --json: a JSON object
-        {"root": ..., "files": [{"path","type","bytes","mtime_iso"}], "urls": [...],
-         "truncated": bool, "ranked_by": ..., "note": ...}
-    Without --json: a short human-readable summary.
-"""
-
-import argparse
-import fnmatch
-import json
-import os
-import re
-import sys
-from datetime import datetime, timezone
-
-# ---------------------------------------------------------------------------
-# Defaults (mirrored in the SKILL.md file contract)
-# ---------------------------------------------------------------------------
-
-DEFAULT_MAX_FILES = 12
-DEFAULT_MAX_MB = 8.0
-DEFAULT_DEPTH = 4
-
-# v2: VISUAL-ONLY by default. Brand visuals, not document templates.
-DEFAULT_EXTENSIONS = [
-    ".png", ".jpg", ".jpeg", ".webp", ".svg", ".avif", ".gif",
-]
-
-# Document extensions are never visual brand assets. Excluded from the default
-# scan; only included when --include-docs is passed (they are then *added* to the
-# active extension set, alongside whatever visual/--ext set is in effect).
-DOC_EXTENSIONS = [
-    ".pdf",
-    ".hwp", ".hwpx",
-    ".doc", ".docx",
-    ".ppt", ".pptx",
-    ".xls", ".xlsx",
-]
-
-DEFAULT_EXCLUDED_DIRS = [
-    "node_modules", ".git", "dist", "build", ".next", ".nuxt", "out",
-    "venv", ".venv", "__pycache__", ".cache", "coverage", "target",
-    "Pods", ".gradle", ".idea", ".DS_Store",
-]
-
-# v2: brand-likelihood ranking. A filename whose basename contains one of these
-# tokens (as a whole token, delimited by start/end of name or any non-alphanumeric
-# separator) is treated as a likely real brand asset and floated to the top of the
-# results, ahead of generic screenshots / incidental images.
-#
-# Token boundaries matter: the short "og" token (Open Graph: og.png / og-image.png)
-# must NOT match as a substring inside ordinary words like dog/frog/blog/logout/
-# progress/recognition/cognac/biography, and "logo" must not match "logout". The
-# leading group consumes one separator (or start-of-string); the trailing boundary
-# is a zero-width lookahead so adjacent tokens (e.g. "icon-logo") both still match.
-BRAND_KEYWORD_PATTERN = re.compile(
-    r"(?:^|[^a-z0-9])"
-    r"(?:logo|wordmark|symbol|icon|brand|hero|cover|favicon|app[-_]?icon|og[-_]?image|og)"
-    r"(?=[^a-z0-9]|$)",
-    re.IGNORECASE,
-)
-
-RANKED_BY = "brand-likelihood, then mtime-desc"
-
-
-# ---------------------------------------------------------------------------
-# Helpers
-# ---------------------------------------------------------------------------
-
-def _normalize_extensions(raw):
-    """Turn a comma-separated extension string into a lowercased set with leading dots.
-
-    Accepts forms like ".png,jpg, .JPEG" and yields {".png", ".jpg", ".jpeg"}.
-    Returns None to signal "fall back to defaults" when nothing usable is parsed.
-    """
-    if raw is None:
-        return None
-    exts = set()
-    for part in str(raw).split(","):
-        part = part.strip().lower()
-        if not part:
-            continue
-        if not part.startswith("."):
-            part = "." + part
-        exts.add(part)
-    return exts or None
-
-
-def _ext_of(path):
-    """Lowercased file extension including the leading dot (e.g. '.png'), or '' if none."""
-    return os.path.splitext(path)[1].lower()
-
-
-def _type_of(path):
-    """Lowercased extension WITHOUT the leading dot (e.g. 'png'), or '' if none."""
-    return _ext_of(path).lstrip(".")
-
-
-def _mtime_iso(epoch):
-    """Convert an epoch float to an ISO-8601 UTC string; never raises."""
-    try:
-        return datetime.fromtimestamp(epoch, tz=timezone.utc).isoformat()
-    except (OverflowError, OSError, ValueError):
-        return ""
-
-
-def _is_excluded_dir(name, exclude_globs):
-    """True if a directory basename matches any exclude glob (or default excluded set)."""
-    for pattern in exclude_globs:
-        if fnmatch.fnmatch(name, pattern):
-            return True
-    return False
-
-
-def _brand_score(path):
-    """Heuristic brand-likelihood score for a file path.
-
-    Higher = more likely to be a real brand asset Claude Design should reference.
-    Scored on the *filename* (the basename), case-insensitively, against
-    BRAND_KEYWORD_PATTERN (which matches brand tokens only at token boundaries, so
-    "og" matches og.png/og-image but never dog/blog/logout). Returns 1 if any brand
-    token is present, else 0.
-
-    This is intentionally a coarse binary signal: brand-likelihood is the PRIMARY
-    sort key, with mtime as the tie-breaker, so we only need to separate "looks
-    like a brand asset" from "everything else". Never raises.
-    """
-    try:
-        name = os.path.basename(path)
-    except Exception:
-        return 0
-    return 1 if BRAND_KEYWORD_PATTERN.search(name) else 0
-
-
-def gather(root, max_files, max_mb, extensions, exclude_globs, depth):
-    """Walk `root` up to `depth` levels, collecting matching files.
-
-    Returns (files, truncated, note) where:
-      - files: list of dicts {path, type, bytes, mtime_iso}, ranked by brand-likelihood
-        first then mtime-desc, size-filtered, and capped.
-      - truncated: True if matching files were dropped because of the cap. A negative
-        `max_files` means "keep everything", so it is never truncated.
-      - note: optional human note (e.g. about an unreadable root); '' otherwise.
-    """
-    note = ""
-    matched = []  # list of (brand_score, mtime, path, size)
-
-    try:
-        abs_root = os.path.abspath(root)
-    except (OSError, ValueError):
-        return [], False, "Could not resolve root path: %r" % (root,)
-
-    if not os.path.exists(abs_root):
-        return [], False, "Root path does not exist: %s" % abs_root
-    if not os.path.isdir(abs_root):
-        return [], False, "Root path is not a directory: %s" % abs_root
-
-    max_bytes = None
-    if max_mb is not None and max_mb >= 0:
-        max_bytes = int(max_mb * 1024 * 1024)
-
-    root_depth = abs_root.rstrip(os.sep).count(os.sep)
-
-    try:
-        # os.walk does NOT follow directory symlinks by default, so symlink loops cannot hang us.
-        walker = os.walk(abs_root, topdown=True, onerror=lambda err: None)
-        for current_dir, dirnames, filenames in walker:
-            # Enforce bounded depth by pruning descent once we exceed the limit.
-            try:
-                current_depth = current_dir.rstrip(os.sep).count(os.sep) - root_depth
-            except Exception:
-                current_depth = 0
-            if current_depth >= depth:
-                # Do not descend any deeper.
-                dirnames[:] = []
-            else:
-                # Prune excluded directories IN PLACE so os.walk skips them entirely.
-                dirnames[:] = [
-                    d for d in dirnames if not _is_excluded_dir(d, exclude_globs)
-                ]
-
-            for fname in filenames:
-                if _ext_of(fname) not in extensions:
-                    continue
-                fpath = os.path.join(current_dir, fname)
-                try:
-                    st = os.stat(fpath)
-                except (PermissionError, FileNotFoundError, OSError):
-                    # Unreadable entry or broken symlink; skip gracefully.
-                    continue
-                # Skip anything that isn't a regular file (e.g. a directory named "foo.png").
-                if not os.path.isfile(fpath):
-                    continue
-                size = st.st_size
-                if max_bytes is not None and size > max_bytes:
-                    continue
-                matched.append((_brand_score(fpath), st.st_mtime, fpath, size))
-    except (PermissionError, FileNotFoundError, OSError) as exc:
-        note = "Walk interrupted: %s" % exc
-
-    # v2 ranking: brand-likelihood FIRST (high score first), then newest first.
-    matched.sort(key=lambda item: (item[0], item[1]), reverse=True)
-
-    if max_files >= 0:
-        truncated = len(matched) > max_files
-        kept = matched[:max_files]
-    else:
-        # Negative cap means "keep everything"; nothing is dropped.
-        truncated = False
-        kept = matched
-
-    files = []
-    for _score, mtime, fpath, size in kept:
-        files.append({
-            "path": fpath,
-            "type": _type_of(fpath),
-            "bytes": size,
-            "mtime_iso": _mtime_iso(mtime),
-        })
-
-    return files, truncated, note
-
-
-# ---------------------------------------------------------------------------
-# CLI
-# ---------------------------------------------------------------------------
-
-def build_parser():
-    parser = argparse.ArgumentParser(
-        prog="gather_references.py",
-        description=(
-            "Scan a directory for brand/visual reference assets and collect explicit URL "
-            "references for the claude-design skill. Visual-only by default; documents "
-            "(.pdf/.hwp/.doc/.ppt/.xls) are excluded unless --include-docs is given. "
-            "Results are ranked by brand-likelihood first, then by modification time."
-        ),
-    )
-    parser.add_argument(
-        "--root",
-        default=os.getcwd(),
-        help="Directory to scan (default: current working directory).",
-    )
-    parser.add_argument(
-        "--max",
-        dest="max_files",
-        type=int,
-        default=DEFAULT_MAX_FILES,
-        help="Maximum number of files to return (default: %d)." % DEFAULT_MAX_FILES,
-    )
-    parser.add_argument(
-        "--max-mb",
-        dest="max_mb",
-        type=float,
-        default=DEFAULT_MAX_MB,
-        help="Skip files larger than this many megabytes (default: %s)." % DEFAULT_MAX_MB,
-    )
-    parser.add_argument(
-        "--url",
-        dest="urls",
-        action="append",
-        default=[],
-        metavar="URL",
-        help="Explicit URL reference (repeatable).",
-    )
-    parser.add_argument(
-        "--ext",
-        dest="ext",
-        default=None,
-        metavar=".png,.jpg,...",
-        help=(
-            "Comma-separated list of extensions to match. Overrides the visual-only "
-            "default (%s). If --include-docs is also passed, document extensions are "
-            "added on top of this set." % ",".join(DEFAULT_EXTENSIONS)
-        ),
-    )
-    parser.add_argument(
-        "--include-docs",
-        dest="include_docs",
-        action="store_true",
-        help=(
-            "Also include document files (%s). These are EXCLUDED by default because "
-            "they are document templates, not brand visuals." % ",".join(DOC_EXTENSIONS)
-        ),
-    )
-    parser.add_argument(
-        "--exclude",
-        dest="exclude",
-        action="append",
-        default=[],
-        metavar="GLOB",
-        help="Additional directory-name glob(s) to exclude (repeatable).",
-    )
-    parser.add_argument(
-        "--depth",
-        type=int,
-        default=DEFAULT_DEPTH,
-        help="Maximum directory depth to descend (default: %d)." % DEFAULT_DEPTH,
-    )
-    parser.add_argument(
-        "--json",
-        action="store_true",
-        help="Emit a JSON object instead of a human-readable summary.",
-    )
-    return parser
-
-
-def _human_size(num_bytes):
-    """Render a byte count as a compact human-readable string."""
-    try:
-        value = float(num_bytes)
-    except (TypeError, ValueError):
-        return "?"
-    for unit in ("B", "KB", "MB", "GB", "TB"):
-        if value < 1024.0 or unit == "TB":
-            if unit == "B":
-                return "%d %s" % (int(value), unit)
-            return "%.1f %s" % (value, unit)
-        value /= 1024.0
-    return "%.1f TB" % value
-
-
-def main(argv=None):
-    parser = build_parser()
-    args = parser.parse_args(argv)
-
-    # Resolve the active extension set:
-    #   - --ext (if given) replaces the visual-only default;
-    #   - otherwise use the visual-only default;
-    #   - --include-docs ADDS document extensions on top of whichever set is active.
-    extensions = _normalize_extensions(args.ext)
-    if extensions is None:
-        extensions = set(DEFAULT_EXTENSIONS)
-    if args.include_docs:
-        extensions = set(extensions) | set(DOC_EXTENSIONS)
-
-    exclude_globs = list(DEFAULT_EXCLUDED_DIRS) + list(args.exclude or [])
-
-    depth = args.depth if args.depth is not None and args.depth >= 0 else DEFAULT_DEPTH
-
-    files, truncated, note = gather(
-        root=args.root,
-        max_files=args.max_files,
-        max_mb=args.max_mb,
-        extensions=extensions,
-        exclude_globs=exclude_globs,
-        depth=depth,
-    )
-
-    urls = list(args.urls or [])
-
-    try:
-        abs_root = os.path.abspath(args.root)
-    except (OSError, ValueError):
-        abs_root = args.root
-
-    if args.json:
-        payload = {
-            "root": abs_root,
-            "files": files,
-            "urls": urls,
-            "truncated": truncated,
-            "ranked_by": RANKED_BY,
-            "note": note,
-        }
-        print(json.dumps(payload, ensure_ascii=False, indent=2))
-        return 0
-
-    # Human-readable summary.
-    lines = []
-    lines.append("Reference scan root: %s" % abs_root)
-    lines.append(
-        "Found %d file(s) (cap=%d, max-mb=%s, depth=%d, docs=%s)%s"
-        % (
-            len(files),
-            args.max_files,
-            args.max_mb,
-            depth,
-            "included" if args.include_docs else "excluded",
-            " [truncated: more matched than shown]" if truncated else "",
-        )
-    )
-    lines.append("Ranked by: %s" % RANKED_BY)
-    if files:
-        lines.append("")
-        for entry in files:
-            lines.append(
-                "  - %s  [%s, %s, %s]"
-                % (
-                    entry["path"],
-                    entry["type"] or "?",
-                    _human_size(entry["bytes"]),
-                    entry["mtime_iso"] or "?",
-                )
-            )
-    else:
-        lines.append("  (no matching brand/visual assets found)")
-
-    if urls:
-        lines.append("")
-        lines.append("URL references (%d):" % len(urls))
-        for url in urls:
-            lines.append("  - %s" % url)
-
-    if note:
-        lines.append("")
-        lines.append("Note: %s" % note)
-
-    print("\n".join(lines))
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

package/.opencode/oh-my-design/skills/omd-apply/SKILL.md

@@ -1,107 +0,0 @@
----
-name: omd:apply
-description: "프로젝트 DESIGN.md를 UI/시각 작업의 brand context로 적용. 컴포넌트·색상·폰트·레이아웃 수정 같은 구체적 요청과 톤·분위기 표현 — KR '좀 더 따뜻하게', EN 'make it warmer/cooler', 日本語「もう少し暖かく」, 繁體中文「更溫暖一點」 — 모두에 트리거. DESIGN.md 부재 시 omd:init 우선. 화면 전체 신규 디자인은 omd:harness, 교정 기록은 omd:remember."
----
-
-# omd:apply — Brand Context Injection + Dispatch Router
-
-DESIGN.md를 모든 UI/디자인 작업의 권위 있는 컨텍스트로 사용한다. 단일 책임은 두 가지:
-
-1. **인라인 처리** — 작은 단일 변경 (1 component, 1 token, 1 카피 라인)은 직접 Edit 툴로 처리
-2. **Dispatch** — 복합 작업은 적합한 서브에이전트로 즉시 라우팅 (master 거치지 않음)
-
-복합 작업을 인라인으로 처리하면 안 된다. 이 스킬의 가장 중요한 책임은 *언제 dispatch할지 정확히 판단하는 것*.
-
-## 트리거 조건
-
-다음 중 하나가 감지되면 SKILL 전체를 로드한다.
-
-- 컴포넌트 생성 / 수정 (button, card, dialog, nav, form 등)
-- 스타일 변경 (Tailwind 클래스, CSS, 토큰 값)
-- 마이크로카피 작성 / 수정 (버튼 라벨, empty state, 에러, tooltip)
-- 모션 / 트랜지션 추가
-- 색상 · 타이포그래피 · 스페이싱 조정
-- 에셋 (아이콘, 차트, 일러스트, 3D 렌더) 요청
-- 디자인 시스템 관련 질문
-
-## Phase 0 — Dispatch decision tree (가장 먼저)
-
-작업 시작 전에 어떤 처리 경로인지 결정한다. 다음 표를 위에서부터 순차 매칭, 첫 번째 매칭 행으로 진행:
-
-| 사용자 요청 패턴 | 처리 경로 | 이유 |
-|---|---|---|
-| "에셋 / 아이콘 / 일러스트 / 차트 / 사진 / 로고 / 그래프 / SVG 만들어" | dispatch `omd-asset-curator` | 매체 선택 + 스택 매칭이 전문 영역 |
-| "메인 화면 / landing / 전체 디자인 / 처음부터 / 와이어프레임" | 사용자에게 `/omd-harness` 추천 | 10-phase 파이프라인이 적합 |
-| "접근성 / a11y / 색약 / 키보드 네비" 감사 | dispatch `omd-a11y-auditor` | 전문 감사 |
-| "마이크로카피만 다듬어 / 카피 톤 정리 / empty state 문구 전부" 복수 | dispatch `omd-microcopy` | voice 일관성 |
-| "사용자 시나리오 / 페르소나 walk through / 4명 입장에서 검토" | dispatch `omd-persona-tester` | adversarial 4-페르소나 |
-| "이 카피 좋은지 / hero 카피 약점 / 섹션별 카피 전문가 의견 / A/B 후보" | dispatch `omd-ux-writer` | UX writing 분석 + 대안 + 근거 |
-| "이 인터랙션 / 모션 / 포커스 / 모바일 / 지각 성능 / 섹션별 UX 약점" | dispatch `omd-ux-engineer` | 코드 레벨 인터랙션 감사 + fix |
-| "랜딩 / 메인 화면 / 페이지 *전체*를 전문가 의견으로 개선" | dispatch `omd-ux-writer` + `omd-ux-engineer` (병렬) | 두 트랙 동시 — writing + engineering |
-| "이게 왜 안 좋은지 critique / postmortem / root cause" | dispatch `omd-critic` | 비판적 분석 |
-| "DESIGN.md 만들어 / reference 골라 / 카탈로그에서 추천" | dispatch `omd-init` skill (또는 omd-add-reference) | reference 매칭 |
-| "preference 정리 / 누적된 교정 반영 / DESIGN.md 업데이트" | dispatch `omd-learn` skill | fold-in 로직 |
-| "이 한 줄 / 이 컬러 / 이 spacing 좀" 단발 명확 | **인라인 처리** | 분명한 단일 변경 |
-| 위 어디에도 안 맞는 자유로운 디자인 작업 | 인라인 처리 후 Phase 3 (교정 캡처) | 일반 케이스 |
-
-dispatch가 정해지면 즉시 Agent 툴 호출 (master 경유 X — 우리가 omd-apply로 트리거됐다는 건 master 컨텍스트 밖이라는 의미). 그 후 인라인 처리는 하지 않고, 서브에이전트가 반환한 결과를 사용자에게 정리만 해서 전달.
-
-## Phase 1 — DESIGN.md 로드 (인라인 처리 분기 한정)
-
-dispatch가 아니라 인라인 처리로 분기됐을 때만 진행:
-
-1. 프로젝트 루트의 `DESIGN.md`를 **전체 읽는다**. 요약 금지, Read 툴로 직접 로드.
-2. `.omd/preferences.md`가 있으면 같이 읽는다. `status: pending` 엔트리는 아직 DESIGN.md에 반영 안 된 교정 — DESIGN.md보다 **우선** 적용.
-3. **reference-capture 자료가 있으면 함께 로드**: `DESIGN.md` frontmatter의 `bootstrapped_from` 또는 `.omd/init-context.json`의 `reference_id`로 brand id를 얻고, `assets/_reference/<id>/`가 존재하면:
-   - `tokens.json` — `live_overrides` 블록 우선
-   - `structure.json` — composition cues (hero/cta/nav idiom)
-   - `fonts.json` — `live_observed: true` 항목은 출력 HTML `<head>`에 `html_link` 그대로 박을 것. 미로드 시 시스템 fallback으로 둥근 폰트 mismatch.
-   - `screenshots/hero-desktop.png` — UI 작업이 hero/landing 류면 Read 툴로 **이미지로 직접 읽고** 시각 grounding
-   - **mode 분기** (`.omd/init-context.json`의 `mode` 필드):
-     - `clone` → 헤더 logo는 `assets/_reference/<id>/logo.<ext>` 직접 사용. project root에 `CLONE-MODE.md` + `replace-checklist.md`가 있어야 함.
-     - `inspired` (또는 미지정) → 헤더 logo는 `[YOUR LOGO]` placeholder. captured 자산은 product DOM 미사용.
-4. 우선순위:
-   ```
-   .omd/preferences.md (pending)
-     > assets/_reference/<id>/tokens.json#live_overrides  (visual surface tokens만)
-     > DESIGN.md                                          (essence: voice/principles/motion 철학·canonical token)
-     > framework defaults
-   ```
-   essence (voice/principles/motion philosophy)는 항상 DESIGN.md가 권위. visual surface 토큰만 live_overrides가 우위.
-
-DESIGN.md 없으면 사용자에게 알리고 omd:init 스킬 트리거. 임의 생성 금지.
-
-## Phase 2 — Brand Context 적용
-
-- 토큰 값은 DESIGN.md에서만 인용. 임의 hex / spacing / radius 금지.
-- Voice 섹션을 마이크로카피에 적용. 문장 길이, 어휘 register, 은유 밀도 일치.
-- Component 섹션 명시된 규칙 따름 (variant / state / sizes).
-- 없는 토큰 지어내지 않음. 필요 시 사용자에게 "이건 DESIGN.md에 없는데, 어떻게 할까요?" 묻기.
-
-## Phase 3 — 교정 캡처
-
-턴 종료 전에 다음 중 하나가 있었는지 확인:
-
-1. 사용자가 디자인 선택을 명시적 교정 ("no, use X", "actually, Y", "don't use Z", "we never do W")
-2. 사용자가 토큰/값을 revert 또는 교체
-3. 사용자가 "우리는 ~한다/하지 않는다" 형태 원칙 언급
-
-감지되면 **omd:remember 스킬을 트리거**한다 (CLI 호출 X — `.omd/preferences.md`에 직접 append). 트리거 메서드: omd-remember SKILL.md의 Step 1-6 절차를 따라 Edit 툴로 파일 수정.
-
-## Phase 4 — 확인 메시지
-
-교정 기록 시 턴 끝에 한 줄:
-
-```
-Logged to .omd/preferences.md — say "preference 정리해줘" later to fold into DESIGN.md.
-```
-
-일반 작업에는 불필요. 과한 알림 금지.
-
-## 금지
-
-- DESIGN.md 없는데 임의 생성 금지 (사용자에게 omd:init 제안)
-- 복합 작업을 인라인으로 처리 금지 (Phase 0 dispatch table 따라 라우팅)
-- 교정 감지 시 "기록할까요?" 묻지 말 것 — 자동 기록 + 한 줄 알림
-- 같은 턴 내 같은 교정 중복 기록 금지
-- CLI 호출 (`omd remember`, `omd learn` 등) 금지 — 1.0.0부터 모두 스킬 prose