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

moai_adk/cli/commands/init.py

@@ -134,45 +134,20 @@ def init(
 
             console.print("\n[cyan]🚀 Starting installation...[/cyan]\n")
 
-        # 4. Check for reinitialization (SPEC-INIT-003 v0.3.0)
+        # 4. Check for reinitialization (SPEC-INIT-003 v0.3.0) - DEFAULT TO FORCE MODE
         initializer = ProjectInitializer(project_path)
 
         if initializer.is_initialized():
-            if non_interactive and not force:
-                # Non-interactive mode (without force): Reject reinitialization
-                console.print("\n[yellow]⚠ Project already initialized[/yellow]")
-                console.print(f"[dim]  Location: {project_path}/.moai/[/dim]")
-                console.print("[dim]  Use --force to reinitialize or interactive mode[/dim]\n")
-                raise click.Abort()
-
-            if force:
-                # Force mode: Reinitialize without confirmation
-                console.print("\n[green]🔄 Force reinitializing project...[/green]\n")
+            # Always reinitialize without confirmation (force mode by default)
+            if non_interactive:
+                console.print("\n[green]🔄 Reinitializing project (force mode)...[/green]\n")
             else:
-                # Interactive mode: Reinitialization prompt
-                console.print("\n⚠️  [yellow]Project already initialized[/yellow]")
-                console.print(f"   Location: {project_path}/.moai/\n")
-
-                console.print("[cyan]This will:[/cyan]")
-                console.print("  ✓ Backup existing files to .moai-backups/{timestamp}/")
-                console.print("    • CLAUDE.md")
-                console.print("    • .claude/ (settings, commands, hooks)")
-                console.print("    • .moai/ (all configurations and specs)")
-                console.print("  ✓ Update template files from moai-adk v0.3.0")
-                console.print("    • .claude/ → Latest Alfred commands")
-                console.print("    • .moai/memory/ → Latest development guides")
-                console.print("    • CLAUDE.md → Latest project documentation")
-                console.print("  ✓ Preserve your content")
-                console.print("    • .moai/project/ (product/structure/tech.md)")
-                console.print("    • .moai/specs/ (all SPEC documents)\n")
-
-                if not Confirm.ask("Would you like to update the project templates?", default=True):
-                    console.print("\n[yellow]Reinit cancelled.[/yellow]\n")
-                    raise click.Abort()
-
-                console.print("\n[green]🔄 Starting reinit process...[/green]\n")
+                # Interactive mode: Simple notification
+                console.print("\n[cyan]🔄 Reinitializing project...[/cyan]")
+                console.print("   Backup will be created at .moai-backups/{timestamp}/\n")
 
         # 5. Initialize project (Progress Bar with 5 phases)
+        # Always allow reinit (force mode by default)
         is_reinit = initializer.is_initialized()
 
         # Reinit mode: set config.json optimized to false (v0.3.1+)
@@ -220,7 +195,7 @@ def init(
                 language=language,
                 backup_enabled=True,
                 progress_callback=callback,
-                reinit=is_reinit,  # SPEC-INIT-003 v0.3.0
+                reinit=True,  # Always allow reinit (force mode by default)
             )
 
         # 6. Output results
@@ -241,7 +216,25 @@ def init(
                 f"  [dim]📄 Files:[/dim]     {len(result.created_files)} created"
             )
             console.print(f"  [dim]⏱️  Duration:[/dim]  {result.duration}ms")
+
+            # Show backup info if reinitialized
+            if is_reinit:
+                backup_dir = project_path / ".moai-backups"
+                if backup_dir.exists():
+                    latest_backup = max(backup_dir.iterdir(), key=lambda p: p.stat().st_mtime)
+                    console.print(f"  [dim]💾 Backup:[/dim]    {latest_backup.name}/")
+
             console.print(f"\n{separator}")
+
+            # Show config merge notice if reinitialized
+            if is_reinit:
+                console.print("\n[yellow]⚠️  Configuration Notice:[/yellow]")
+                console.print("  All template files have been [bold]force overwritten[/bold]")
+                console.print("  Previous files are backed up in [cyan].moai-backups/{timestamp}/[/cyan]")
+                console.print("\n  [cyan]To merge your previous config:[/cyan]")
+                console.print("  Run [bold]/alfred:0-project[/bold] command in Claude Code")
+                console.print("  It will merge backup config when [dim]optimized=false[/dim]\n")
+
             console.print("\n[cyan]🚀 Next Steps:[/cyan]")
             if not is_current_dir:
                 console.print(

moai_adk/core/template/processor.py

@@ -23,7 +23,8 @@ class TemplateProcessor:
         ".moai/specs/",  # User SPEC documents
         ".moai/reports/",  # User reports
         ".moai/project/",  # User project documents (product/structure/tech.md)
-        ".moai/config.json",  # User configuration (merged via /alfred:9-update flow)
+        # config.json is now FORCE OVERWRITTEN (backup in .moai-backups/)
+        # Merge via /alfred:0-project when optimized=false
     ]
 
     # Paths excluded from backups
@@ -277,7 +278,7 @@ class TemplateProcessor:
                 if not silent:
                     console.print(f"   ✅ .claude/{folder}/ overwritten")
 
-        # 2. Copy other files/folders individually (preserve existing, with substitution)
+        # 2. Copy other files/folders individually (FORCE OVERWRITE all files)
         all_warnings = []
         for item in src.iterdir():
             rel_path = item.relative_to(src)
@@ -288,16 +289,12 @@ class TemplateProcessor:
                 continue
 
             if item.is_file():
-                # Copy file, skip if exists (preserve user modifications)
-                if not dst_item.exists():
-                    # Copy with variable substitution for text files
-                    warnings = self._copy_file_with_substitution(item, dst_item)
-                    all_warnings.extend(warnings)
+                # FORCE OVERWRITE: Always copy files (no skip)
+                warnings = self._copy_file_with_substitution(item, dst_item)
+                all_warnings.extend(warnings)
             elif item.is_dir():
-                # Copy directory recursively (preserve existing files)
-                if not dst_item.exists():
-                    # Recursively copy directory with substitution
-                    self._copy_dir_with_substitution(item, dst_item)
+                # FORCE OVERWRITE: Always copy directories (no skip)
+                self._copy_dir_with_substitution(item, dst_item)
 
         # Print warnings if any
         if all_warnings and not silent:
@@ -362,9 +359,7 @@ class TemplateProcessor:
 
             dst_item = dst / rel_path
             if item.is_file():
-                # Skip existing files to preserve user content (v0.3.0)
-                if dst_item.exists():
-                    continue
+                # FORCE OVERWRITE: Always copy files (no skip)
                 dst_item.parent.mkdir(parents=True, exist_ok=True)
                 # Copy with variable substitution
                 warnings = self._copy_file_with_substitution(item, dst_item)
@@ -382,7 +377,7 @@ class TemplateProcessor:
             console.print("   ✅ .moai/ copy complete (variables substituted)")
 
     def _copy_claude_md(self, silent: bool = False) -> None:
-        """Copy CLAUDE.md with smart merging and variable substitution."""
+        """Copy CLAUDE.md with FORCE OVERWRITE."""
         src = self.template_root / "CLAUDE.md"
         dst = self.target_path / "CLAUDE.md"
 
@@ -391,16 +386,10 @@ class TemplateProcessor:
                 console.print("⚠️ CLAUDE.md template not found")
             return
 
-        # Preserve project information when the file exists
-        if dst.exists():
-            self._merge_claude_md(src, dst)
-            if not silent:
-                console.print("   🔄 CLAUDE.md merged (project information preserved)")
-        else:
-            # Copy with variable substitution
-            self._copy_file_with_substitution(src, dst)
-            if not silent:
-                console.print("   ✅ CLAUDE.md copy complete")
+        # FORCE OVERWRITE: Always copy template (backup already created in Phase 1)
+        self._copy_file_with_substitution(src, dst)
+        if not silent:
+            console.print("   ✅ CLAUDE.md overwritten (backup available in .moai-backups/)")
 
     def _merge_claude_md(self, src: Path, dst: Path) -> None:
         """Delegate the smart merge for CLAUDE.md.

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

@@ -77,3 +77,9 @@ class HookResult:
 
 
 __all__ = ["HookPayload", "HookResult"]
+
+# Note: core module exports:
+# - HookPayload, HookResult (type definitions)
+# - project.py: detect_language, get_git_info, count_specs, get_project_language
+# - context.py: get_jit_context
+# - checkpoint.py: detect_risky_operation, create_checkpoint, log_checkpoint, list_checkpoints

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

@@ -1,15 +1,10 @@
 #!/usr/bin/env python3
 """Context Engineering utilities
 
-JIT (Just-in-Time) Retrieval 및 워크플로우 컨텍스트 관리
+JIT (Just-in-Time) Retrieval
 """
 
-import time
 from pathlib import Path
-from typing import Any
-
-# Workflow context shared across phases
-_workflow_context: dict[str, Any] = {}
 
 
 def get_jit_context(prompt: str, cwd: str) -> list[str]:
@@ -69,42 +64,4 @@ def get_jit_context(prompt: str, cwd: str) -> list[str]:
     return context_files
 
 
-def save_phase_context(phase: str, data: dict):
-    """Store per-phase workflow context data.
-
-    Args:
-        phase: ``"analysis"``, ``"implementation"`` or ``"verification"``.
-        data: Payload to share with later phases.
-
-    Notes:
-        - Enables reuse of expensive analysis across phases.
-        - Entries expire after 10 minutes to avoid stale data.
-    """
-    _workflow_context[phase] = {"data": data, "timestamp": time.time()}
-
-
-def load_phase_context(phase: str) -> dict | None:
-    """Load previously stored workflow context for a phase.
-
-    Returns:
-        Stored context data or ``None`` when expired or missing.
-    """
-    if phase in _workflow_context:
-        ctx = _workflow_context[phase]
-        # Only accept entries that are younger than 10 minutes
-        if time.time() - ctx["timestamp"] < 600:
-            return ctx["data"]
-    return None
-
-
-def clear_workflow_context():
-    """Clear all cached workflow context (call at workflow end)."""
-    _workflow_context.clear()
-
-
-__all__ = [
-    "get_jit_context",
-    "save_phase_context",
-    "load_phase_context",
-    "clear_workflow_context",
-]
+__all__ = ["get_jit_context"]

moai_adk/templates/.claude/settings.json

@@ -86,7 +86,9 @@
       "Bash(uv remove:*)",
       "Bash(pip install:*)",
       "Bash(pip3 install:*)",
-      "Bash(rm:*)"
+      "Bash(rm:*)",
+      "Bash(sudo:*)",
+      "Bash(rm -rf:*)"
     ],
     "deny": [
       "Read(./.env)",
@@ -95,8 +97,13 @@
       "Read(~/.ssh/**)",
       "Read(~/.aws/**)",
       "Read(~/.config/gcloud/**)",
-      "Bash(sudo:*)",
-      "Bash(rm -rf:*)",
+      "Bash(rm -rf /:*)",
+      "Bash(rm -rf /*:*)",
+      "Bash(rm -rf C\\:/:*)",
+      "Bash(rm -rf C\\:/*:*)",
+      "Bash(del /S /Q C\\:/:*)",
+      "Bash(rmdir /S /Q C\\:/:*)",
+      "Bash(format:*)",
       "Bash(chmod -R 777:*)",
       "Bash(dd:*)",
       "Bash(mkfs:*)",

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.3.9
+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

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

@@ -5,7 +5,7 @@ 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,11 +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=7Cujh2ZtqZmNfNTwndBAbNpTA4RZh1qYSpDEeu-LM7s,2312
+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
@@ -57,11 +57,10 @@ moai_adk/templates/.claude/commands/alfred/2-build.md,sha256=cEvXk9gadL2twrkDf3p
 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
@@ -83,8 +82,8 @@ moai_adk/templates/.moai/project/tech.md,sha256=1BgkApeFqQCq6TPriGiev02G9niVx23c
 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.9.dist-info/METADATA,sha256=-ayTp2OE0jlXLrIf6WFN-a6O339alF9LdaOqEre1l10,49932
-moai_adk-0.3.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-moai_adk-0.3.9.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
-moai_adk-0.3.9.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
-moai_adk-0.3.9.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",
-]