moai-adk 0.3.7__py3-none-any.whl → 0.3.10__py3-none-any.whl

{moai_adk-0.3.7.dist-info → moai_adk-0.3.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.3.7
+Version: 0.3.10
 Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent
 Project-URL: Homepage, https://github.com/modu-ai/moai-adk
 Project-URL: Repository, https://github.com/modu-ai/moai-adk
@@ -603,7 +603,6 @@ src/todo/routes.py              # @CODE:TODO-001:API
   "created_at": "2025-10-17T10:00:00Z"
 }
 ```
-```
 
 ---
 
@@ -772,22 +771,6 @@ git pull origin develop
 
 ---
 
-### 시나리오 3: Release 준비
-
-```bash
-# 표준 방식 (권장):
-git checkout develop
-gh pr create --base main --head develop --title "Release v1.0.0"
-
-# 직접 push 방식 (허용):
-git checkout develop
-git push origin main  # ⚠️ Advisory 경고 표시되지만 진행됨
-git tag -a v1.0.0 -m "Release v1.0.0"
-git push origin v1.0.0
-```
-
----
-
 ## ■ AI 모델 선택 가이드
 
 MoAI-ADK는 **Haiku 4.5**와 **Sonnet 4.5** 두 가지 AI 모델을 전략적으로 활용하여 **최적의 성능과 비용 효율**을 제공합니다.

{moai_adk-0.3.7.dist-info → moai_adk-0.3.10.dist-info}/RECORD

@@ -1,11 +1,11 @@
-moai_adk/__init__.py,sha256=vT0ZCxBa_qTqD2oiAZji7pvzfmKXLg_6HC3de1Tkzmo,216
+moai_adk/__init__.py,sha256=zdXpTUQ-OHC67YgbzBHiGqxEvmfizRXENDKBpasoYjE,216
 moai_adk/__main__.py,sha256=FUUtsqo_NkeY3VR35EjPPtkP3vPkUqRraE30TXMGFL4,2502
 moai_adk/cli/__init__.py,sha256=tidIaJnd4Pje_5QYRq7OvRRst4T3kaPlkw5QcPQ3l1Y,135
 moai_adk/cli/main.py,sha256=mHACHi27AP2N7fg7zhzOo1tlF1Jrlw1_AcbxMfpGLVE,306
 moai_adk/cli/commands/__init__.py,sha256=Gq_obgREC-eFpiYB3IEpYywWj0dy4N0eEbw6q7NxrKs,490
 moai_adk/cli/commands/backup.py,sha256=Hzf3zc7NhfChAJu2OTN_0xARtUbNaB32fmPczchbrC4,1652
 moai_adk/cli/commands/doctor.py,sha256=R4Cf9Jqwww1ng36u2SHTh6x0VdmnvaT7G9KVKJRX7N4,6623
-moai_adk/cli/commands/init.py,sha256=LhmmrpQh2Wofe0QfMpuZI-DJvtTNzOM5n11NwO9A-cM,10907
+moai_adk/cli/commands/init.py,sha256=dVdBNuCBuwWu-8JBXW8XLX2Acr_6BVa4VsI2I3PP7nA,10409
 moai_adk/cli/commands/restore.py,sha256=nIhFR9PUQ-XuxZApONVyN77x2lWCjNhn0orL94YD0xs,2691
 moai_adk/cli/commands/status.py,sha256=YJhh7RoKnumxY0_ho7FWTWm5Nxh2jTnH9aSsapdLhyo,2277
 moai_adk/cli/commands/update.py,sha256=aoYSR6Nz70sI-KNnkeD_9nZg4CHo5DJkmstnVfoTbrk,5979
@@ -35,10 +35,11 @@ moai_adk/core/template/backup.py,sha256=R187b3ZGQU5f-vQ-iBSFx0aIqbNHJAHODC4ODc3S
 moai_adk/core/template/config.py,sha256=UbDxqJ-yohwLW3Yzx_6-0RmjCxNRFqzw6bRIC2bS5-w,2712
 moai_adk/core/template/languages.py,sha256=waeyA_MFy217bV9IiILc2gofG9RM9JhD-kdVGRyJzFk,1648
 moai_adk/core/template/merger.py,sha256=dvKobOW4vXz-7GWKJpZFYxCMtR-LszcJZYbYFTL3XY0,4049
-moai_adk/core/template/processor.py,sha256=uhSEBvAbZtdWyeLJ7I2IuDpla0MUNI0eM04yTV1ktd0,16687
+moai_adk/core/template/processor.py,sha256=_EklBt3jFay235vREsYPNMoDHEM5xAgW3JIGM52jPc8,16179
 moai_adk/templates/.gitignore,sha256=6VNKResdDpyaii3cmJA4pOLwK2PhYARIWkUODYtKyxg,310
+moai_adk/templates/CLAUDE.md,sha256=xANecTF739Bh2aJX7nExWQcS2Yc_G8jk2HEVZKlmJOo,27286
 moai_adk/templates/__init__.py,sha256=9YY0tDkKbDFCdUB7rJFtGq0CZbF2ftVSKF573iw0KJc,99
-moai_adk/templates/.claude/settings.json,sha256=NvNbDQrbiN806Vv1i8msca9VcIGQBTvzTiiwPhYQpMY,2873
+moai_adk/templates/.claude/settings.json,sha256=-wa_uzvkUc2nE91VJhCAMv5Xrw-gwEW4-f61yhC-olk,2518
 moai_adk/templates/.claude/agents/alfred/cc-manager.md,sha256=xP3V7QAI-08ga6hhF3J4fXbgiHUM08bJbT2nfE52Bq4,13883
 moai_adk/templates/.claude/agents/alfred/debug-helper.md,sha256=1Sxz6tBHa-oCoTmwjEZ8ix2OMbjTsOpWUOekQKftlF8,5249
 moai_adk/templates/.claude/agents/alfred/doc-syncer.md,sha256=kLwLvI-5oRjEG6fSlq8CwwsH3TbqrAY-OWZDcS_3IMo,6223
@@ -51,16 +52,15 @@ moai_adk/templates/.claude/agents/alfred/tag-agent.md,sha256=FGa-BuOl64XEp0fJbQJ
 moai_adk/templates/.claude/agents/alfred/tdd-implementer.md,sha256=oeJimFgfRuJqBpBT8DE6-n7StIgPFjopYbxxavJSqPM,8544
 moai_adk/templates/.claude/agents/alfred/trust-checker.md,sha256=eIwFumcJfr66jWdAuWJ5LITHfzzsRBaITGD7iz8EYH4,11647
 moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=6a19UVvi6BV6mX0312WbQJyN4nsKB7pggTlLgtxwcFM,17831
-moai_adk/templates/.claude/commands/alfred/1-spec.md,sha256=b972C0B7VU6P8eQZxKdn72ikwJ_f7HZZPi-IMtnKky4,20268
-moai_adk/templates/.claude/commands/alfred/2-build.md,sha256=iATuR8W3taOe83QY2E4SmHxKCvE790WOIgF765mlr4w,17322
-moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=hkL33VXE_e-2xD2R35LFBi_fcCmulkMgFBIPgNLmVgk,19493
+moai_adk/templates/.claude/commands/alfred/1-spec.md,sha256=dpaOJWxK2zjU2wI7uvVfY16SDyGzN-HsUcIepPO8sCM,20365
+moai_adk/templates/.claude/commands/alfred/2-build.md,sha256=cEvXk9gadL2twrkDf3p2w8lzrCt3JkMUx-T0MtnLN7U,17429
+moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=5rYopDYzJHKEG400CuHoSWP5xBppcZNTFCu2GlFNVs0,19610
 moai_adk/templates/.claude/hooks/alfred/README.md,sha256=1E_nUaFj_50UTXIfFnkNLTy4qZHCs_R3gzhBoekf4Pk,6823
 moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py,sha256=vffNW0u2RXZ_jG3EzIggxEv23fDuh2qtU7oF7PZIW6A,6943
-moai_adk/templates/.claude/hooks/alfred/core/__init__.py,sha256=No6VZOruX83zHq48SGcOJiza6HIut9VtsVkevaaFT88,2490
+moai_adk/templates/.claude/hooks/alfred/core/__init__.py,sha256=5sHy-OPaGxBXizSRaEBeydm8U3MW1ANWxSB_36m0hz4,2775
 moai_adk/templates/.claude/hooks/alfred/core/checkpoint.py,sha256=vAm5hEqXUT2frkXFSrJf2W6uOd24Bi7O0Qr51ll51Jw,8543
-moai_adk/templates/.claude/hooks/alfred/core/context.py,sha256=0FBagGq9cvYFqmjl8eZvDL9g5KAh1KvTvHpQMvtR6v4,3410
+moai_adk/templates/.claude/hooks/alfred/core/context.py,sha256=-PHNNktkULYL9jpIjDqpBgTNYqFo7O1QdrPbgbe52rk,2155
 moai_adk/templates/.claude/hooks/alfred/core/project.py,sha256=h7s2D0e5zn0BKu3GReMVH93ojKOTkF6yyLWNnoJI6-0,9103
-moai_adk/templates/.claude/hooks/alfred/core/tags.py,sha256=QAT7Oh8eupawGiZnaYDEcPhdlm1LGyzVF-Hv6SKZ_5g,7711
 moai_adk/templates/.claude/hooks/alfred/handlers/__init__.py,sha256=mk1FQFj5V3rxyV1BQbd8bZE9R-IK4nanj61oO7jhbdw,577
 moai_adk/templates/.claude/hooks/alfred/handlers/notification.py,sha256=MjwaCRSbK4f-YvRC9CG4Rg8dhQir1gzPqF02x9O_4Gc,655
 moai_adk/templates/.claude/hooks/alfred/handlers/session.py,sha256=6zz0uJ3cYtnY8gXtoP0cRf6LmmQUfggLWIJduokd-Jw,2783
@@ -76,14 +76,14 @@ moai_adk/templates/.moai/hooks/pre-push.sample,sha256=zpQOWHxpV_XjTAnyp1dTrM39Iz
 moai_adk/templates/.moai/memory/development-guide.md,sha256=YMepw_MT0-YDK6rQlKvWOULAMGtPDH-WJA6wIYiSMwU,14717
 moai_adk/templates/.moai/memory/gitflow-protection-policy.md,sha256=xmRXA9erdH4EgpRdd0inKGat6HEZ8HP-4BQthjLyoZ4,6529
 moai_adk/templates/.moai/memory/spec-metadata.md,sha256=EZ_GMCG-yRwvvCotD6oSGR350hg090fodQkxPuWNYso,7350
-moai_adk/templates/.moai/project/product.md,sha256=Aglyj5iaasCW9nNB3gqFPoBslnzS5hXg_1n_QZQa15U,3661
-moai_adk/templates/.moai/project/structure.md,sha256=bAImWQG01zH1EOd7F94rd87b_P6JlOCH-MGmCuS-Lxs,4985
-moai_adk/templates/.moai/project/tech.md,sha256=devxbvmgTG3_1x3dYNPHtje2gU1aJ403luztHK0DRhI,5854
+moai_adk/templates/.moai/project/product.md,sha256=ClDlG1q7P8aX4cjroXLUZIQGd2wBZt6xD-w9RXMOYfk,5731
+moai_adk/templates/.moai/project/structure.md,sha256=jesU7Om-fZANmj0NdgiU_oY0aT7102QWwuYy7Q-drKA,5180
+moai_adk/templates/.moai/project/tech.md,sha256=1BgkApeFqQCq6TPriGiev02G9niVx23cEA2RH-28dtw,6049
 moai_adk/utils/__init__.py,sha256=fv-UwHv8r4-eedwRnDA9hFjo5QSZYXjctKDyE7XF10g,220
 moai_adk/utils/banner.py,sha256=TmZyJKXOnJpdbdn6NZDJC6a4hm051QudEvOfiKQhvI8,1873
 moai_adk/utils/logger.py,sha256=jYCWKvcN-tX17hZ-e2IPuHATwkQBFc_I1dd5fUTWxmY,5059
-moai_adk-0.3.7.dist-info/METADATA,sha256=yojcfUIOeuNslQh-HSPEvIdTW_XWDi2cL8cATt-FjD8,50289
-moai_adk-0.3.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-moai_adk-0.3.7.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
-moai_adk-0.3.7.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
-moai_adk-0.3.7.dist-info/RECORD,,
+moai_adk-0.3.10.dist-info/METADATA,sha256=xJtnrnXZna5oSyjS0kZa4SRTbf-H0APs7cSYXvhoHdk,49933
+moai_adk-0.3.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.3.10.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.3.10.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.3.10.dist-info/RECORD,,

moai_adk/templates/.claude/hooks/alfred/core/tags.py

@@ -1,244 +0,0 @@
-#!/usr/bin/env python3
-"""TAG search and verification system
-
-TAG 검색, 체인 검증, 라이브러리 버전 캐싱
-"""
-
-import json
-import subprocess
-import time
-from pathlib import Path
-
-# TAG search cache: {pattern: (results, mtime_hash, cached_at)}
-_tag_cache: dict[str, tuple[list[dict], float, float]] = {}
-
-# Library version cache: {lib_name: (version, timestamp)}
-_lib_version_cache: dict[str, tuple[str, float]] = {}
-
-
-def _get_dir_mtime_hash(paths: list[str]) -> float:
-    """Calculate a directory-wide mtime hash used for cache invalidation.
-
-    Args:
-        paths: List of directory paths to inspect.
-
-    Returns:
-        Highest modification timestamp (float) across all files.
-
-    Notes:
-        - Any file change bumps the hash and invalidates the cache.
-        - Missing or inaccessible directories are ignored.
-    """
-    max_mtime = 0.0
-    for path in paths:
-        path_obj = Path(path)
-        if not path_obj.exists():
-            continue
-
-        try:
-            for file_path in path_obj.rglob("*"):
-                if file_path.is_file():
-                    max_mtime = max(max_mtime, file_path.stat().st_mtime)
-        except (OSError, PermissionError):
-            # Skip directories we cannot read
-            continue
-
-    return max_mtime
-
-
-def search_tags(pattern: str, scope: list[str] | None = None, cache_ttl: int = 60) -> list[dict]:
-    """Search TAG markers using an in-memory cache.
-
-    Args:
-        pattern: Regex pattern (for example ``'@SPEC:AUTH-.*'``).
-        scope: List of directories to scan. Defaults to specs/src/tests.
-        cache_ttl: Cache time-to-live in seconds (default 60).
-
-    Returns:
-        List of matches such as ``{"file": "path", "line": 10, "tag": "...", "content": "..."}``.
-
-    Notes:
-        - Cache integrity relies on directory mtimes plus TTL.
-        - Cache hits avoid spawning ``rg`` while misses shell out (≈13ms).
-        - Uses ``rg --json`` output for structured parsing.
-    """
-    if scope is None:
-        scope = [".moai/specs/", "src/", "tests/"]
-
-    cache_key = f"{pattern}:{':'.join(scope)}"
-
-    current_mtime = _get_dir_mtime_hash(scope)
-    cache_entry = _tag_cache.get(cache_key)
-
-    # Serve cached results when still valid
-    if cache_entry:
-        cached_results, cached_mtime, cached_at = cache_entry
-        ttl_valid = time.time() - cached_at < cache_ttl
-
-        # Matching mtime and a fresh TTL means we can reuse the cache
-        if current_mtime == cached_mtime and ttl_valid:
-            return cached_results
-
-    # Cache miss → invoke ripgrep
-    cmd = ["rg", pattern, "--json"] + scope
-
-    try:
-        result = subprocess.run(cmd, capture_output=True, text=True, timeout=5, check=False)
-    except (subprocess.TimeoutExpired, FileNotFoundError):
-        # Missing rg or a timeout returns an empty list
-        return []
-
-    matches = []
-    for line in result.stdout.strip().split("\n"):
-        if not line:
-            continue
-        try:
-            data = json.loads(line)
-            if data.get("type") == "match":
-                matches.append(
-                    {
-                        "file": data["data"]["path"]["text"],
-                        "line": data["data"]["line_number"],
-                        "tag": data["data"]["lines"]["text"].strip(),
-                        "content": data["data"]["lines"]["text"],
-                    }
-                )
-        except (json.JSONDecodeError, KeyError):
-            # Ignore malformed JSON lines
-            continue
-
-    # Persist results with the current mtime snapshot
-    _tag_cache[cache_key] = (matches, _get_dir_mtime_hash(scope), time.time())
-
-    return matches
-
-
-def verify_tag_chain(spec_id: str) -> dict:
-    """Verify a TAG chain across ``@SPEC`` → ``@TEST`` → ``@CODE``.
-
-    Args:
-        spec_id: SPEC identifier (for example ``"AUTH-001"``).
-
-    Returns:
-        Dictionary with keys ``complete``, ``spec``, ``test``, ``code`` and ``orphans``.
-
-    Notes:
-        - Orphans capture TAGs found in code/tests without a SPEC.
-        - A chain is complete only when all three categories contain matches.
-        - Relies on ``search_tags`` so cached scans remain inexpensive.
-    """
-    chain = {
-        "spec": search_tags(f"@SPEC:{spec_id}", [".moai/specs/"]),
-        "test": search_tags(f"@TEST:{spec_id}", ["tests/"]),
-        "code": search_tags(f"@CODE:{spec_id}", ["src/"]),
-    }
-
-    orphans = []
-    if chain["code"] and not chain["spec"]:
-        orphans.extend(chain["code"])
-    if chain["test"] and not chain["spec"]:
-        orphans.extend(chain["test"])
-
-    return {
-        "complete": bool(chain["spec"] and chain["test"] and chain["code"]),
-        **chain,
-        "orphans": orphans,
-    }
-
-
-def find_all_tags_by_type(tag_type: str = "SPEC") -> dict:
-    """Return TAG IDs grouped by domain for the requested type.
-
-    Args:
-        tag_type: TAG category (``SPEC``, ``TEST``, ``CODE`` or ``DOC``).
-
-    Returns:
-        Dictionary like ``{"AUTH": ["AUTH-001", "AUTH-002"], ...}``.
-
-    Notes:
-        - Domain is derived from the ``FOO-123`` prefix.
-        - Deduplicates repeated matches within the same domain.
-        - Fetches data via ``search_tags`` so caching still applies.
-    """
-    tags = search_tags(f"@{tag_type}:([A-Z]+-[0-9]{{3}})")
-
-    by_domain = {}
-    for tag in tags:
-        # @SPEC:AUTH-001 → AUTH
-        try:
-            tag_id = tag["tag"].split(":")[1]
-            domain = "-".join(tag_id.split("-")[:-1])
-
-            if domain not in by_domain:
-                by_domain[domain] = []
-            if tag_id not in by_domain[domain]:
-                by_domain[domain].append(tag_id)
-        except IndexError:
-            # 파싱 실패 무시
-            continue
-
-    return by_domain
-
-
-def suggest_tag_reuse(keyword: str, tag_type: str = "SPEC") -> list[str]:
-    """Suggest existing TAG IDs that match the supplied keyword.
-
-    Args:
-        keyword: Keyword used to match domain names (case-insensitive).
-        tag_type: TAG category (defaults to ``SPEC``).
-
-    Returns:
-        A list of up to five suggested TAG IDs.
-
-    Notes:
-        - Encourages reuse to avoid creating duplicate TAGs.
-        - Performs a simple substring match against domain names.
-    """
-    all_tags = find_all_tags_by_type(tag_type)
-    suggestions = []
-
-    keyword_lower = keyword.lower()
-    for domain, tag_ids in all_tags.items():
-        if keyword_lower in domain.lower():
-            suggestions.extend(tag_ids)
-
-    return suggestions[:5]  # Cap results at five
-
-
-def get_library_version(lib_name: str, cache_ttl: int = 86400) -> str | None:
-    """Get the cached latest stable version for a library.
-
-    Args:
-        lib_name: Package name (for example ``"fastapi"``).
-        cache_ttl: Cache TTL in seconds (defaults to 24 hours).
-
-    Returns:
-        Cached version string or ``None`` when the cache is cold.
-
-    Notes:
-        - Cache hits skip costly web searches (saves 3–5 seconds).
-        - Agents should call ``set_library_version`` after fetching live data.
-    """
-    # Serve cached value when still within TTL
-    if lib_name in _lib_version_cache:
-        cached_version, cached_time = _lib_version_cache[lib_name]
-        if time.time() - cached_time < cache_ttl:
-            return cached_version
-
-    # Cache miss → agent needs to perform the web search
-    return None
-
-
-def set_library_version(lib_name: str, version: str):
-    """Persist a library version in the cache."""
-    _lib_version_cache[lib_name] = (version, time.time())
-
-
-__all__ = [
-    "search_tags",
-    "verify_tag_chain",
-    "find_all_tags_by_type",
-    "suggest_tag_reuse",
-    "get_library_version",
-    "set_library_version",
-]