codigest 0.3.0__tar.gz → 0.3.2__tar.gz

{codigest-0.3.0 → codigest-0.3.2}/.github/workflows/publish.yml

@@ -4,8 +4,6 @@ on:
   push:
     tags:
       - 'v*'  # v0.3.0 태그 푸시 시 배포 실행
-    # branches:
-    #   - main  # main 브랜치 푸시 시 문서 배포 실행 (옵션)
 
 jobs:
   build-n-publish:
@@ -21,15 +19,15 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     
-    # [변경] uv 설치 (가장 빠르고 확실한 방법)
+    # uv 설치 (가장 빠르고 확실한 방법)
     - name: Install uv
       uses: astral-sh/setup-uv@v5
     
-    # [변경] Python 3.14 설정 (uv 이용)
+    # Python 3.14 설정 (uv 이용)
     - name: Set up Python
       run: uv python install 3.14
     
-    # [변경] 의존성 설치 및 빌드 (uv build 하나로 해결)
+    # 의존성 설치 및 빌드 (uv build 하나로 해결)
     - name: Build package
       run: uv build
     

{codigest-0.3.0 → codigest-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codigest
-Version: 0.3.0
+Version: 0.3.2
 Summary: Human-Centered Codebase Context Manager for LLMs
 Project-URL: Homepage, https://github.com/SJB777/codigest
 Project-URL: Repository, https://github.com/SJB777/codigest
@@ -25,33 +25,61 @@ Description-Content-Type: text/markdown
 
 # Codigest
 
-Codigest is a CLI tool designed to extract, structure, and track the context of your codebase for Large Language Models (LLMs).
+Codigest is a standalone CLI tool designed to extract, structure, and track the context of your codebase for Large Language Models (LLMs).
 
 Unlike simple copy-paste tools, Codigest employs a **Context Anchor** system (Shadow Git) to track changes locally without polluting your main version control history. It also features **Semantic Analysis** to detect structural changes in your code.
 
 ## Core Philosophy
 
-* **Read-Only & Safe**: Codigest never modifies your source code. It only reads, analyzes, and formats context.
-* **Context-Aware**: Instead of dumping raw text, it structures code into XML snapshots designed for LLM comprehension.
-* **Session-Based Tracking**: It maintains an internal anchor to track "work-in-progress" changes independently of your Git commits.
-* **Python 3.14 Native**: Built using modern Python features including PEP 750 Tag Strings for safe XML generation.
+  * **Read-Only & Safe**: Codigest never modifies your source code. It only reads, analyzes, and formats context.
+  * **Context-Aware**: Instead of dumping raw text, it structures code into XML snapshots designed for LLM comprehension.
+  * **Session-Based Tracking**: It maintains an internal anchor to track "work-in-progress" changes independently of your Git commits.
+  * **Environment Isolated**: Runs in its own isolated Python 3.14 environment via `uv`, ensuring it never conflicts with your project's dependencies.
 
 ## Installation
 
-Requires **Python 3.14+**.
+Codigest runs as a global tool. You don't need to add it to your project's `requirements.txt`.
+We strongly recommend using **uv** for the best experience.
+
+### Step 1: Install `uv`
+
+If you don't have `uv` installed, use **Winget** (Windows) or curl (macOS/Linux).
+
+```powershell
+# Windows (via Winget)
+winget install --id astral-sh.uv
+
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+### Step 2: Install `codigest`
+
+Install Codigest globally. `uv` will automatically manage the required Python 3.14 environment for you.
 
 ```bash
-# Install via uv
-git clone https://github.com/SJB7777/codigest.git
-cd codigest
-uv tool install .
-````
+uv tool install codigest
+```
+
+### Step 3: Update Path (Important\!)
+
+To run `codigest` from any terminal, ensure your tools directory is in your PATH.
+
+```bash
+uv tool update-shell
+```
+
+*\> **Note:** Restart your terminal (or VS Code) after this step to apply changes.*
+
+-----
 
 ## Workflow & Commands
 
+Once installed, you can use `codigest` command anywhere.
+
 ### 1\. Initialization
 
-Sets up the `.codigest` directory and captures the initial baseline anchor.
+Sets up the `.codigest` directory and captures the initial baseline anchor. 
 
 ```bash
 codigest init
@@ -66,7 +94,7 @@ Scans the entire codebase and generates a structured XML snapshot.
   * **Side Effect:** Updates the internal Context Anchor to the current state.
 
 ```bash
-codigest scan --m " Python 3.14 project. Do NOT use typing. List/Dict."
+codigest scan --message "Initial project context"
 ```
 
 ### 3\. Incremental Changes (`diff`)
@@ -77,6 +105,7 @@ Tracks text-based changes between the last `scan` and the current working tree.
   * **Use Case:** "I modified 3 files. Here is exactly what changed since the last snapshot."
   * **Note:** This is based on the internal Shadow Git, not your project's Git history.
 
+
 ```bash
 codigest diff
 ```
@@ -89,6 +118,7 @@ Analyzes **structural changes** (AST-based) rather than line-by-line text differ
   * **Use Case:** "I refactored the API. Show me which functions were added, removed, or had their signatures changed."
   * **Benefit:** Significantly reduces token usage compared to raw diffs by ignoring formatting/comment changes.
 
+
 ```bash
 codigest semdiff
 ```
@@ -100,12 +130,13 @@ Generates a high-level outline of the project structure (Classes, Functions, Met
   * **Output:** `.codigest/digest.xml`
   * **Use Case:** "Don't read the implementation details. Just understand the class hierarchy and available methods."
 
-<!-- end list -->
 
 ```bash
 codigest digest
 ```
 
+-----
+
 ## Configuration
 
 You can customize behavior in `.codigest/config.toml`.

{codigest-0.3.0 → codigest-0.3.2}/README.md

@@ -1,32 +1,60 @@
 # Codigest
 
-Codigest is a CLI tool designed to extract, structure, and track the context of your codebase for Large Language Models (LLMs).
+Codigest is a standalone CLI tool designed to extract, structure, and track the context of your codebase for Large Language Models (LLMs).
 
 Unlike simple copy-paste tools, Codigest employs a **Context Anchor** system (Shadow Git) to track changes locally without polluting your main version control history. It also features **Semantic Analysis** to detect structural changes in your code.
 
 ## Core Philosophy
 
-* **Read-Only & Safe**: Codigest never modifies your source code. It only reads, analyzes, and formats context.
-* **Context-Aware**: Instead of dumping raw text, it structures code into XML snapshots designed for LLM comprehension.
-* **Session-Based Tracking**: It maintains an internal anchor to track "work-in-progress" changes independently of your Git commits.
-* **Python 3.14 Native**: Built using modern Python features including PEP 750 Tag Strings for safe XML generation.
+  * **Read-Only & Safe**: Codigest never modifies your source code. It only reads, analyzes, and formats context.
+  * **Context-Aware**: Instead of dumping raw text, it structures code into XML snapshots designed for LLM comprehension.
+  * **Session-Based Tracking**: It maintains an internal anchor to track "work-in-progress" changes independently of your Git commits.
+  * **Environment Isolated**: Runs in its own isolated Python 3.14 environment via `uv`, ensuring it never conflicts with your project's dependencies.
 
 ## Installation
 
-Requires **Python 3.14+**.
+Codigest runs as a global tool. You don't need to add it to your project's `requirements.txt`.
+We strongly recommend using **uv** for the best experience.
+
+### Step 1: Install `uv`
+
+If you don't have `uv` installed, use **Winget** (Windows) or curl (macOS/Linux).
+
+```powershell
+# Windows (via Winget)
+winget install --id astral-sh.uv
+
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+### Step 2: Install `codigest`
+
+Install Codigest globally. `uv` will automatically manage the required Python 3.14 environment for you.
 
 ```bash
-# Install via uv
-git clone https://github.com/SJB7777/codigest.git
-cd codigest
-uv tool install .
-````
+uv tool install codigest
+```
+
+### Step 3: Update Path (Important\!)
+
+To run `codigest` from any terminal, ensure your tools directory is in your PATH.
+
+```bash
+uv tool update-shell
+```
+
+*\> **Note:** Restart your terminal (or VS Code) after this step to apply changes.*
+
+-----
 
 ## Workflow & Commands
 
+Once installed, you can use `codigest` command anywhere.
+
 ### 1\. Initialization
 
-Sets up the `.codigest` directory and captures the initial baseline anchor.
+Sets up the `.codigest` directory and captures the initial baseline anchor. 
 
 ```bash
 codigest init
@@ -41,7 +69,7 @@ Scans the entire codebase and generates a structured XML snapshot.
   * **Side Effect:** Updates the internal Context Anchor to the current state.
 
 ```bash
-codigest scan --m " Python 3.14 project. Do NOT use typing. List/Dict."
+codigest scan --message "Initial project context"
 ```
 
 ### 3\. Incremental Changes (`diff`)
@@ -52,6 +80,7 @@ Tracks text-based changes between the last `scan` and the current working tree.
   * **Use Case:** "I modified 3 files. Here is exactly what changed since the last snapshot."
   * **Note:** This is based on the internal Shadow Git, not your project's Git history.
 
+
 ```bash
 codigest diff
 ```
@@ -64,6 +93,7 @@ Analyzes **structural changes** (AST-based) rather than line-by-line text differ
   * **Use Case:** "I refactored the API. Show me which functions were added, removed, or had their signatures changed."
   * **Benefit:** Significantly reduces token usage compared to raw diffs by ignoring formatting/comment changes.
 
+
 ```bash
 codigest semdiff
 ```
@@ -75,12 +105,13 @@ Generates a high-level outline of the project structure (Classes, Functions, Met
   * **Output:** `.codigest/digest.xml`
   * **Use Case:** "Don't read the implementation details. Just understand the class hierarchy and available methods."
 
-<!-- end list -->
 
 ```bash
 codigest digest
 ```
 
+-----
+
 ## Configuration
 
 You can customize behavior in `.codigest/config.toml`.

{codigest-0.3.0 → codigest-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codigest"
-version = "0.3.0"
+version = "0.3.2"
 description = "Human-Centered Codebase Context Manager for LLMs"
 authors = [{name = "Codigest Team", email = "sngd024@google.com"}]
 readme = "README.md"

codigest-0.3.2/src/codigest/__main__.py

@@ -0,0 +1,4 @@
+from .main import main
+
+if __name__ == "__main__":
+    main()

{codigest-0.3.0 → codigest-0.3.2}/src/codigest/commands/diff.py

@@ -12,6 +12,15 @@ console = Console()
 
 @app.callback(invoke_without_command=True)
 def handle(
+    # target 인자 추가
+    target: Path = typer.Argument(
+        Path.cwd(), 
+        help="Target directory to check diff",
+        exists=True,
+        file_okay=False,
+        dir_okay=True,
+        resolve_path=True
+    ),
     copy: bool = typer.Option(True, help="Auto-copy to clipboard"),
     save: bool = typer.Option(True, help="Save to .codigest/changes.diff"),
     message: str = typer.Option("", "--message", "-m", help="Add specific instruction context"),
@@ -20,7 +29,7 @@ def handle(
     [Context Update] Shows changes since the last 'codigest scan'.
     Useful for updating LLM context without re-uploading everything.
     """
-    root_path = Path.cwd()
+    root_path = target
     anchor = shadow.ContextAnchor(root_path)
     
     # 1. Check Baseline Existence

{codigest-0.3.0 → codigest-0.3.2}/src/codigest/commands/digest.py

@@ -49,11 +49,7 @@ def handle(
                     
                     if summary:
                         rel_path = file_path.relative_to(root_path).as_posix()
-                        block = tags.xml(t"""
-                        <file path="{rel_path}">
-                        {summary}
-                        </file>
-                        """)
+                        block = tags.file(rel_path, summary)
                         summary_blocks.append(block)
                 except Exception:
                     continue

{codigest-0.3.0 → codigest-0.3.2}/src/codigest/commands/init.py

@@ -35,12 +35,22 @@ structure = "toon"
 
 @app.callback(invoke_without_command=True)
 def handle(
+    # target 인자 추가 (기본값: 현재 위치)
+    target: Path = typer.Argument(
+        Path.cwd(), 
+        help="Target directory to initialize",
+        exists=True,
+        file_okay=False,
+        dir_okay=True,
+        resolve_path=True
+    ),
     force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing config"),
 ):
     """
     Initialize the .codigest environment and capture the initial state.
     """
-    root_path = Path.cwd()
+    root_path = target  # Typer가 이미 resolve_path=True로 절대경로 변환해줌
+    
     config_dir = root_path / ".codigest"
     config_file = config_dir / "config.toml"
     gitignore_file = root_path / ".gitignore"

{codigest-0.3.0 → codigest-0.3.2}/src/codigest/commands/scan.py

@@ -28,22 +28,52 @@ def _load_config_filters(root_path: Path):
             
     return extensions, exclude_patterns
 
+def _find_project_root(start_path: Path) -> Path:
+    """
+    .codigest 폴더나 .git 폴더가 있는 상위 디렉토리를 찾습니다.
+    못 찾으면 start_path를 반환합니다.
+    """
+    current = start_path.resolve()
+    for parent in [current] + list(current.parents):
+        if (parent / ".codigest").exists() or (parent / ".git").exists():
+            return parent
+    return start_path
+
 @app.callback(invoke_without_command=True)
 def handle(
-    target: Path = typer.Argument(Path.cwd(), help="Target directory"),
+    # targets를 리스트로 받음 (여러 폴더 지정 가능)
+    targets: list[Path] = typer.Argument(
+        None, 
+        help="Specific files or directories to scan (Scope)",
+        exists=True,
+        resolve_path=True
+    ),
     output: str = typer.Option("snapshot.xml", help="Output filename inside .codigest/"),
     all: bool = typer.Option(False, "--all", "-a", help="Ignore config filters"),
     message: str = typer.Option("", "--message", "-m", help="Add specific instruction"),
     line_numbers: bool = typer.Option(False, "--lines", "-l", help="Add line numbers to code blocks"),
 ):
     """
-    [Legacy Mode] Scans the codebase using the PromptEngine.
+    Scans the codebase. 
+    If TARGETS provided, only scans those paths within the project.
     """
-    root_path = target.resolve()
+    # 1. 프로젝트 루트 결정 (현재 위치 기준 상위 탐색)
+    root_path = _find_project_root(Path.cwd())
+
+    # 2. Scope 설정
+    # 입력된 targets가 있으면 사용, 없으면 [root_path] 전체
+    scan_scope = targets if targets else None
+
+    # 검증: targets가 root_path 밖에 있으면 경고 (옵션)
+    if scan_scope:
+        for p in scan_scope:
+            if not p.is_relative_to(root_path):
+                console.print(f"[yellow]⚠️  Warning: {p.name} is outside project root {root_path.name}[/yellow]")
+
     artifact_dir = root_path / ".codigest"
 
     if not artifact_dir.exists():
-        console.print("[yellow]⚠️  .codigest directory missing. Running init...[/yellow]")
+        console.print(f"[yellow]⚠️  .codigest directory missing in {root_path.name}. Running init...[/yellow]")
         try:
             artifact_dir.mkdir(exist_ok=True)
         except PermissionError:
@@ -68,7 +98,12 @@ def handle(
     ):
 
         # File Discovery
-        files = scanner.scan_project(root_path, extensions, extra_ignores)
+        files = scanner.scan_project(
+            root_path, 
+            extensions, 
+            extra_ignores, 
+            include_paths=scan_scope
+        )
 
         # Pre-scan Diff Report
         if anchor.has_history():
@@ -89,11 +124,9 @@ def handle(
             rel_path = file_path.relative_to(root_path).as_posix()
             try:
                 content = processor.read_file_content(file_path, add_line_numbers=line_numbers)
-                block = tags.xml(t"""
-                    <file path="{rel_path}">
-                    {content}
-                    </file>
-                """)
+                
+
+                block = tags.file(rel_path, content)
                 file_blocks.append(block)
             except Exception:
                 continue

{codigest-0.3.0 → codigest-0.3.2}/src/codigest/commands/semdiff.py

@@ -61,38 +61,42 @@ def handle(
             # Read Content (Handle Missing Files for Deletion)
             try:
                 new_code = file_path.read_text(encoding="utf-8") if file_path.exists() else ""
-            except: new_code = ""
+            except:
+                new_code = ""
                 
             old_code = anchor.read_anchor_file(rel_path)
             
             # Case: File Added (No old code) -> All symbols ADDED
             # Case: File Deleted (No new code) -> All symbols REMOVED
             # Case: Modified -> Semantic Compare
-            
+
             changes = semdiff.compare(old_code, new_code)
-            
+
             if changes:
                 change_lines = []
                 for ch in changes:
-                    if ch.change_type == "ADDED": icon = "➕ [ADDED]   "
-                    elif ch.change_type == "REMOVED": icon = "➖ [REMOVED] "
-                    elif ch.change_type == "MODIFIED": icon = "⚠️ [SIGNATURE]" # 중요: 시그니처 변경
-                    else: icon = "✏️ [LOGIC]   " # 내부 로직 변경
+                    if ch.change_type == "ADDED":
+                        icon = "➕ [ADDED]   "
+                    elif ch.change_type == "REMOVED":
+                        icon = "➖ [REMOVED] "
+                    elif ch.change_type == "MODIFIED":
+                        icon = "⚠️ [SIGNATURE]" # 중요: 시그니처 변경
+                    else:
+                        icon = "✏️ [LOGIC]   "
                         
                     detail = f" :: {ch.details}" if ch.details else ""
                     line = f"{icon} {ch.symbol.type} {ch.symbol.name}{ch.symbol.signature}{detail}"
                     change_lines.append(line)
-                
+
                 # File Deleted Tagging
                 file_status = ""
-                if not new_code: file_status = " (DELETED)"
-                elif not old_code: file_status = " (NEW)"
-
-                block = tags.xml(t"""
-                <file path="{rel_path.as_posix()}{file_status}">
-                {chr(10).join(change_lines)}
-                </file>
-                """)
+                if not new_code:
+                    file_status = " (DELETED)"
+                elif not old_code:
+                    file_status = " (NEW)"
+
+                raw_body = chr(10).join(change_lines)
+                block = tags.file(rel_path.as_posix(), raw_body, status=file_status)
                 reports.append(block)
 
         progress.update(task, completed=100)

{codigest-0.3.0 → codigest-0.3.2}/src/codigest/core/prompts.py

@@ -1,6 +1,6 @@
 """
 Prompt Management Module.
-Philosophy: Defaults are Code (t-strings), Overrides are Data (TOML).
+Templates are aligned flush-left to prevent indentation issues when injecting large code blocks.
 """
 import tomllib
 from pathlib import Path
@@ -14,102 +14,111 @@ RenderFunc = Callable[..., str]
 def _default_snapshot(project_name: str, tree_structure: str, source_code: str, instruction: str = "") -> str:
     instruction_block = ""
     if instruction:
+        safe_instruction = tags.escape_xml_value(instruction)
         instruction_block = tags.dedent(f"""
-        <user_instruction>
-        {instruction}
-        </user_instruction>
-        """)
-
-    return tags.dedent(t"""
-        [SYSTEM: CODIGEST - INITIAL CONTEXT]
-        You are an expert AI developer. I am providing the full context of a project named "{project_name}".
-        Please digest this structure and code to build your internal mental model.
-        {instruction_block}
-
-        <project_root>
-        {project_name}
-        </project_root>
-
-        <project_structure>
-        {tree_structure}
-        </project_structure>
-
-        <source_code>
-        {source_code}
-        </source_code>
-    """)
+<user_instruction>
+{safe_instruction}
+</user_instruction>
+""")
+
+    # Note: source_code is assumed to be already formatted via tags.file()
+    return tags.dedent(f"""
+[SYSTEM: CODIGEST - INITIAL CONTEXT]
+You are an expert AI developer. I am providing the full context of a project named "{project_name}".
+Please digest this structure and code to build your internal mental model.
+{instruction_block}
+
+<project_root>
+{project_name}
+</project_root>
+
+<project_structure>
+{tree_structure}
+</project_structure>
+
+<source_code>
+{source_code}
+</source_code>
+""")
 
 # 2. Diff Template (codigest diff)
 def _default_diff(project_name: str, context_message: str, diff_content: str, instruction: str = "") -> str:
     instruction_block = ""
     if instruction:
+        safe_instruction = tags.escape_xml_value(instruction)
         instruction_block = tags.dedent(f"""
-        <user_instruction>
-        {instruction}
-        </user_instruction>
-        """)
+<user_instruction>
+{safe_instruction}
+</user_instruction>
+""")
 
-    return tags.dedent(t"""
-        [SYSTEM: CODIGEST - INCREMENTAL UPDATE]
-        Here are the latest changes for the project "{project_name}".
-        {context_message}.
-        {instruction_block}
+    # Escape raw diff content to prevent XML injection
+    safe_diff = tags.escape_xml_value(diff_content)
 
-        Focus on these modifications to update your context.
+    return tags.dedent(f"""
+[SYSTEM: CODIGEST - INCREMENTAL UPDATE]
+Here are the latest changes for the project "{project_name}".
+{context_message}.
+{instruction_block}
 
-        <git_diff>
-        {diff_content}
-        </git_diff>
-    """)
+Focus on these modifications to update your context.
+
+<git_diff>
+{safe_diff}
+</git_diff>
+""")
 
 # 3. SemDiff Template (codigest semdiff)
 def _default_semdiff(project_name: str, context_message: str, semdiff_content: str, instruction: str = "") -> str:
     instruction_block = ""
     if instruction:
+        safe_instruction = tags.escape_xml_value(instruction)
         instruction_block = tags.dedent(f"""
-        <user_instruction>
-        {instruction}
-        </user_instruction>
-        """)
-
-    return tags.dedent(t"""
-        [SYSTEM: CODIGEST - SEMANTIC ANALYSIS]
-        Structural changes detected in "{project_name}".
-        {context_message}.
-        {instruction_block}
-
-        This report focuses on High-Level Architecture changes (Classes, Functions, Signatures).
-        
-        <semantic_diff>
-        {semdiff_content}
-        </semantic_diff>
-    """)
+<user_instruction>
+{safe_instruction}
+</user_instruction>
+""")
+
+    return tags.dedent(f"""
+[SYSTEM: CODIGEST - SEMANTIC ANALYSIS]
+Structural changes detected in "{project_name}".
+{context_message}.
+{instruction_block}
+
+This report focuses on High-Level Architecture changes (Classes, Functions, Signatures).
+
+<semantic_diff>
+{semdiff_content}
+</semantic_diff>
+""")
 
-# 4. Digest Template (codigest digest) - [Missing Part Fix]
+# 4. Digest Template (codigest digest)
 def _default_digest(project_name: str, tree_structure: str, digest_content: str, instruction: str = "") -> str:
     instruction_block = ""
     if instruction:
+        safe_instruction = tags.escape_xml_value(instruction)
         instruction_block = tags.dedent(f"""
-        <user_instruction>
-        {instruction}
-        </user_instruction>
-        """)
-
-    return tags.dedent(t"""
-        [SYSTEM: CODIGEST - ARCHITECTURE DIGEST]
-        Here is the high-level architecture of "{project_name}".
-        This contains ONLY definitions (Classes, Functions), no implementation details.
-        Use this to understand the project structure and relationships.
-        {instruction_block}
-
-        <project_structure>
-        {tree_structure}
-        </project_structure>
-
-        <code_digest>
-        {digest_content}
-        </code_digest>
-    """)
+<user_instruction>
+{safe_instruction}
+</user_instruction>
+""")
+
+    return tags.dedent(f"""
+[SYSTEM: CODIGEST - ARCHITECTURE DIGEST]
+Here is the high-level architecture of "{project_name}".
+This contains ONLY definitions (Classes, Functions), no implementation details.
+Use this to understand the project structure and relationships.
+{instruction_block}
+
+<project_structure>
+{tree_structure}
+</project_structure>
+
+<code_digest>
+{digest_content}
+</code_digest>
+""")
+
 
 # Registry of default implementations
 # Ensure ALL keys correspond to prompt_engine.render calls
@@ -117,7 +126,7 @@ DEFAULT_RENDERERS: Dict[str, RenderFunc] = {
     "snapshot": _default_snapshot,
     "diff": _default_diff,
     "semdiff": _default_semdiff,
-    "digest": _default_digest,  # <--- 이 부분이 누락되었을 수 있습니다.
+    "digest": _default_digest,
 }
 
 class PromptEngine:
@@ -146,6 +155,7 @@ class PromptEngine:
         # 1. Check for TOML Override (String-based)
         if key in self.overrides:
             raw_template = self.overrides[key]
+            # Safety: Automatically escape values when using user-defined templates
             safe_kwargs = {
                 k: tags.escape_xml_value(v) for k, v in kwargs.items()
             }
@@ -156,9 +166,10 @@ class PromptEngine:
 
         # 2. Use Default (Code-based t-string)
         if key in DEFAULT_RENDERERS:
+            # Default functions handle their own escaping logic internally where needed
             return DEFAULT_RENDERERS[key](**kwargs)
 
         return f"Error: Prompt template '{key}' not found."
 
 def get_engine(root_path: Path) -> PromptEngine:
-    return PromptEngine(root_path)
+    return PromptEngine(root_path)

{codigest-0.3.0 → codigest-0.3.2}/src/codigest/core/scanner.py

@@ -16,11 +16,18 @@ ALWAYS_IGNORE = [
 ]
 
 class ProjectScanner:
-    def __init__(self, root_path: Path, extensions: Optional[set[str]] = None, extra_ignores: Optional[list[str]] = None):
+    def __init__(
+            self,
+            root_path: Path,
+            extensions: Optional[set[str]] = None,
+            extra_ignores: Optional[list[str]] = None,
+            include_paths: Optional[list[Path]] = None
+            ):
         self.root_path = root_path
         self.extensions = extensions
         self.extra_ignores = extra_ignores or []
         self.ignore_spec = self._load_gitignore()
+        self.include_paths = include_paths
 
     def _load_gitignore(self) -> pathspec.PathSpec:
         """Loads .gitignore and combines with ALWAYS_IGNORE and extra_ignores."""
@@ -56,17 +63,36 @@ class ProjectScanner:
             
         return self.ignore_spec.match_file(rel_path)
 
+    def _is_included(self, entry: Path) -> bool:
+        """파일이 지정된 include_paths 범위 안에 있는지 확인"""
+        if not self.include_paths:
+            return True
+            
+        for path in self.include_paths:
+            try:
+                entry.relative_to(path)
+                return True
+            except ValueError:
+                continue
+        return False
+
     def scan(self) -> list[Path]:
         """
         Walks the directory tree and returns valid files.
         (Modernized from old core.py's stack-based approach)
         """
         valid_files = []
-        
+        start_dirs = self.include_paths if self.include_paths else [self.root_path]
         # Use rglob for simplicity, but we must manually filter dirs to respect gitignore
         # For better performance on large repos, we use a manual walk similar to the old code
-        dirs_stack = [self.root_path]
-        
+        dirs_stack = []
+        for p in start_dirs:
+            if p.is_file():
+                if not self.is_ignored(p):
+                    valid_files.append(p)
+            elif p.is_dir():
+                dirs_stack.append(p)
+
         while dirs_stack:
             current = dirs_stack.pop()
             
@@ -83,6 +109,7 @@ class ProjectScanner:
                 
                 if entry.is_dir():
                     dirs_stack.append(entry)
+
                 elif entry.is_file():
                     # Extension Filter Check
                     if self.extensions and entry.suffix.lower() not in self.extensions:
@@ -91,9 +118,14 @@ class ProjectScanner:
                             continue
                             
                     valid_files.append(entry)
-                    
-        return sorted(valid_files)
 
-def scan_project(root_path: Path, extensions: set[str] = None, extra_ignores: list[str] = None) -> list[Path]:
-    scanner = ProjectScanner(root_path, extensions, extra_ignores)
+        return sorted(list(set(valid_files)))
+
+def scan_project(
+    root_path: Path, 
+    extensions: set[str] = None, 
+    extra_ignores: list[str] = None, 
+    include_paths: list[Path] = None
+) -> list[Path]:
+    scanner = ProjectScanner(root_path, extensions, extra_ignores, include_paths)
     return scanner.scan()

codigest-0.3.2/src/codigest/core/tags.py

@@ -0,0 +1,38 @@
+"""
+Core Template Engine & XML Factory.
+Centralizes XML escaping and block generation logic.
+"""
+import html
+import textwrap
+from typing import Any
+
+def escape_xml_value(value: Any) -> str:
+    """[XML] Escapes characters for XML safety."""
+    raw_value = str(value)
+    safe_value = html.escape(raw_value, quote=False)
+    if "</" in safe_value:
+        safe_value = safe_value.replace("</", "&lt;/")
+    return safe_value
+
+def dedent(template: str) -> str:
+    """[Plain] Removes common leading whitespace."""
+    if not isinstance(template, str):
+        template = str(template)
+    return textwrap.dedent(template.expandtabs(4)).strip()
+
+def xml(template: str) -> str:
+    """[XML] Wrapper for dedent (legacy support)."""
+    return dedent(template)
+
+# 파일 블록 생성기 (이스케이프 자동화)
+def file(path: str, content: str, status: str = "") -> str:
+    """
+    Generates a safe <file> block.
+    Automatically escapes the content to prevent XML injection.
+    """
+    safe_content = escape_xml_value(content)
+    
+    # f-string을 왼쪽 벽에 붙여 들여쓰기 문제 원천 차단
+    return f"""<file path="{path}{status}">
+{safe_content}
+</file>"""

codigest-0.3.2/src/codigest/main.py

@@ -0,0 +1,65 @@
+"""
+Entry Point with Global Error Handling & Version Check
+"""
+import sys
+import typer
+from rich.console import Console
+from importlib.metadata import version, PackageNotFoundError
+
+from .commands import init, scan, tree, digest, diff, semdiff
+
+console = Console()
+
+app = typer.Typer(
+    name="codigest",
+    help="Semantic Context Manager for LLM-assisted Development",
+    add_completion=False,
+    no_args_is_help=True
+)
+
+app.add_typer(init.app, name="init")
+app.add_typer(scan.app, name="scan")
+app.add_typer(tree.app, name="tree")
+app.add_typer(digest.app, name="digest")
+app.add_typer(diff.app, name="diff")
+app.add_typer(semdiff.app, name="semdiff")
+
+def version_callback(value: bool):
+    """
+    Callback function to handle --version flag.
+    """
+    if value:
+        try:
+            pkg_version = version("codigest")
+        except PackageNotFoundError:
+            pkg_version = "0.3.0 (dev)"
+        
+        console.print(f"🦁 [bold cyan]Codigest[/bold cyan] version [bold green]{pkg_version}[/bold green]")
+        raise typer.Exit()
+
+@app.callback()
+def common(
+    ctx: typer.Context,
+    version: bool = typer.Option(
+        None, 
+        "--version", "-v", 
+        help="Show the application version and exit.",
+        callback=version_callback, 
+        is_eager=True
+    )
+):
+    pass
+
+def main():
+    try:
+        app()
+    except Exception as e:
+        if isinstance(e, typer.Exit):
+            raise e
+        
+        error_msg = str(e)
+        console.print(f"[bold red]❌ Error:[/bold red] {error_msg}")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

{codigest-0.3.0 → codigest-0.3.2}/uv.lock

@@ -16,7 +16,7 @@ wheels = [
 
 [[package]]
 name = "codigest"
-version = "0.2.0"
+version = "0.3.1"
 source = { editable = "." }
 dependencies = [
     { name = "loguru" },
@@ -27,11 +27,6 @@ dependencies = [
     { name = "typer" },
 ]
 
-[package.dev-dependencies]
-dev = [
-    { name = "ruff" },
-]
-
 [package.metadata]
 requires-dist = [
     { name = "loguru" },
@@ -42,9 +37,6 @@ requires-dist = [
     { name = "typer" },
 ]
 
-[package.metadata.requires-dev]
-dev = [{ name = "ruff" }]
-
 [[package]]
 name = "colorama"
 version = "0.4.6"
@@ -128,32 +120,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/25/7a/b0178788f8dc6cafce37a212c99565fa1fe7872c70c6c9c1e1a372d9d88f/rich-14.2.0-py3-none-any.whl", hash = "sha256:76bc51fe2e57d2b1be1f96c524b890b816e334ab4c1e45888799bfaab0021edd", size = 243393, upload-time = "2025-10-09T14:16:51.245Z" },
 ]
 
-[[package]]
-name = "ruff"
-version = "0.14.8"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/ed/d9/f7a0c4b3a2bf2556cd5d99b05372c29980249ef71e8e32669ba77428c82c/ruff-0.14.8.tar.gz", hash = "sha256:774ed0dd87d6ce925e3b8496feb3a00ac564bea52b9feb551ecd17e0a23d1eed", size = 5765385, upload-time = "2025-12-04T15:06:17.669Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/48/b8/9537b52010134b1d2b72870cc3f92d5fb759394094741b09ceccae183fbe/ruff-0.14.8-py3-none-linux_armv6l.whl", hash = "sha256:ec071e9c82eca417f6111fd39f7043acb53cd3fde9b1f95bbed745962e345afb", size = 13441540, upload-time = "2025-12-04T15:06:14.896Z" },
-    { url = "https://files.pythonhosted.org/packages/24/00/99031684efb025829713682012b6dd37279b1f695ed1b01725f85fd94b38/ruff-0.14.8-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:8cdb162a7159f4ca36ce980a18c43d8f036966e7f73f866ac8f493b75e0c27e9", size = 13669384, upload-time = "2025-12-04T15:06:51.809Z" },
-    { url = "https://files.pythonhosted.org/packages/72/64/3eb5949169fc19c50c04f28ece2c189d3b6edd57e5b533649dae6ca484fe/ruff-0.14.8-py3-none-macosx_11_0_arm64.whl", hash = "sha256:2e2fcbefe91f9fad0916850edf0854530c15bd1926b6b779de47e9ab619ea38f", size = 12806917, upload-time = "2025-12-04T15:06:08.925Z" },
-    { url = "https://files.pythonhosted.org/packages/c4/08/5250babb0b1b11910f470370ec0cbc67470231f7cdc033cee57d4976f941/ruff-0.14.8-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a9d70721066a296f45786ec31916dc287b44040f553da21564de0ab4d45a869b", size = 13256112, upload-time = "2025-12-04T15:06:23.498Z" },
-    { url = "https://files.pythonhosted.org/packages/78/4c/6c588e97a8e8c2d4b522c31a579e1df2b4d003eddfbe23d1f262b1a431ff/ruff-0.14.8-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2c87e09b3cd9d126fc67a9ecd3b5b1d3ded2b9c7fce3f16e315346b9d05cfb52", size = 13227559, upload-time = "2025-12-04T15:06:33.432Z" },
-    { url = "https://files.pythonhosted.org/packages/23/ce/5f78cea13eda8eceac71b5f6fa6e9223df9b87bb2c1891c166d1f0dce9f1/ruff-0.14.8-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1d62cb310c4fbcb9ee4ac023fe17f984ae1e12b8a4a02e3d21489f9a2a5f730c", size = 13896379, upload-time = "2025-12-04T15:06:02.687Z" },
-    { url = "https://files.pythonhosted.org/packages/cf/79/13de4517c4dadce9218a20035b21212a4c180e009507731f0d3b3f5df85a/ruff-0.14.8-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:1af35c2d62633d4da0521178e8a2641c636d2a7153da0bac1b30cfd4ccd91344", size = 15372786, upload-time = "2025-12-04T15:06:29.828Z" },
-    { url = "https://files.pythonhosted.org/packages/00/06/33df72b3bb42be8a1c3815fd4fae83fa2945fc725a25d87ba3e42d1cc108/ruff-0.14.8-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:25add4575ffecc53d60eed3f24b1e934493631b48ebbc6ebaf9d8517924aca4b", size = 14990029, upload-time = "2025-12-04T15:06:36.812Z" },
-    { url = "https://files.pythonhosted.org/packages/64/61/0f34927bd90925880394de0e081ce1afab66d7b3525336f5771dcf0cb46c/ruff-0.14.8-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4c943d847b7f02f7db4201a0600ea7d244d8a404fbb639b439e987edcf2baf9a", size = 14407037, upload-time = "2025-12-04T15:06:39.979Z" },
-    { url = "https://files.pythonhosted.org/packages/96/bc/058fe0aefc0fbf0d19614cb6d1a3e2c048f7dc77ca64957f33b12cfdc5ef/ruff-0.14.8-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cb6e8bf7b4f627548daa1b69283dac5a296bfe9ce856703b03130732e20ddfe2", size = 14102390, upload-time = "2025-12-04T15:06:46.372Z" },
-    { url = "https://files.pythonhosted.org/packages/af/a4/e4f77b02b804546f4c17e8b37a524c27012dd6ff05855d2243b49a7d3cb9/ruff-0.14.8-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:7aaf2974f378e6b01d1e257c6948207aec6a9b5ba53fab23d0182efb887a0e4a", size = 14230793, upload-time = "2025-12-04T15:06:20.497Z" },
-    { url = "https://files.pythonhosted.org/packages/3f/52/bb8c02373f79552e8d087cedaffad76b8892033d2876c2498a2582f09dcf/ruff-0.14.8-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:e5758ca513c43ad8a4ef13f0f081f80f08008f410790f3611a21a92421ab045b", size = 13160039, upload-time = "2025-12-04T15:06:49.06Z" },
-    { url = "https://files.pythonhosted.org/packages/1f/ad/b69d6962e477842e25c0b11622548df746290cc6d76f9e0f4ed7456c2c31/ruff-0.14.8-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:f74f7ba163b6e85a8d81a590363bf71618847e5078d90827749bfda1d88c9cdf", size = 13205158, upload-time = "2025-12-04T15:06:54.574Z" },
-    { url = "https://files.pythonhosted.org/packages/06/63/54f23da1315c0b3dfc1bc03fbc34e10378918a20c0b0f086418734e57e74/ruff-0.14.8-py3-none-musllinux_1_2_i686.whl", hash = "sha256:eed28f6fafcc9591994c42254f5a5c5ca40e69a30721d2ab18bb0bb3baac3ab6", size = 13469550, upload-time = "2025-12-04T15:05:59.209Z" },
-    { url = "https://files.pythonhosted.org/packages/70/7d/a4d7b1961e4903bc37fffb7ddcfaa7beb250f67d97cfd1ee1d5cddb1ec90/ruff-0.14.8-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:21d48fa744c9d1cb8d71eb0a740c4dd02751a5de9db9a730a8ef75ca34cf138e", size = 14211332, upload-time = "2025-12-04T15:06:06.027Z" },
-    { url = "https://files.pythonhosted.org/packages/5d/93/2a5063341fa17054e5c86582136e9895db773e3c2ffb770dde50a09f35f0/ruff-0.14.8-py3-none-win32.whl", hash = "sha256:15f04cb45c051159baebb0f0037f404f1dc2f15a927418f29730f411a79bc4e7", size = 13151890, upload-time = "2025-12-04T15:06:11.668Z" },
-    { url = "https://files.pythonhosted.org/packages/02/1c/65c61a0859c0add13a3e1cbb6024b42de587456a43006ca2d4fd3d1618fe/ruff-0.14.8-py3-none-win_amd64.whl", hash = "sha256:9eeb0b24242b5bbff3011409a739929f497f3fb5fe3b5698aba5e77e8c833097", size = 14537826, upload-time = "2025-12-04T15:06:26.409Z" },
-    { url = "https://files.pythonhosted.org/packages/6d/63/8b41cea3afd7f58eb64ac9251668ee0073789a3bc9ac6f816c8c6fef986d/ruff-0.14.8-py3-none-win_arm64.whl", hash = "sha256:965a582c93c63fe715fd3e3f8aa37c4b776777203d8e1d8aa3cc0c14424a4b99", size = 13634522, upload-time = "2025-12-04T15:06:43.212Z" },
-]
-
 [[package]]
 name = "shellingham"
 version = "1.5.4"

codigest-0.3.0/.github/workflows/main.yml

@@ -1,30 +0,0 @@
-name: Publish to PyPI
-
-on:
-  push:
-    tags:
-      - 'v*'
-  workflow_dispatch:
-jobs:
-  pypi-publish:
-    name: Build and publish Python distribution to PyPI
-    runs-on: ubuntu-latest
-    environment: github
-    permissions:
-      id-token: write
-      contents: read
-
-    steps:
-    - uses: actions/checkout@v4
-
-    - name: Install uv
-      uses: astral-sh/setup-uv@v5
-
-    - name: Set up Python
-      run: uv python install 3.14
-
-    - name: Build package
-      run: uv build
-
-    - name: Publish package distributions to PyPI
-      uses: pypa/gh-action-pypi-publish@release/v1

codigest-0.3.0/src/codigest/core/tags.py

@@ -1,75 +0,0 @@
-"""
-Core Template Engine using Python Tag Strings.
-Advanced Logic: Structure-Aware Dedent & XML Safety.
-"""
-import html
-import textwrap
-from typing import Any, Callable
-
-def _get_common_indent(parts: list[str]) -> int:
-    """Calculates minimum indentation from static template parts."""
-    min_indent = None
-    for part in parts:
-        for line in part.splitlines():
-            if not line.strip():
-                continue
-            indent = len(line) - len(line.lstrip())
-            if min_indent is None or indent < min_indent:
-                min_indent = indent
-    return min_indent or 0
-
-def _dedent_line(line: str, indent: int) -> str:
-    """
-    Safely removes indentation from a single line.
-    """
-    if not line.strip():
-        return "\n" if line.endswith("\n") else ""
-
-    if line.startswith(" " * indent):
-        return line[indent:]
-
-    return line.lstrip(" ")
-
-def escape_xml_value(value: Any) -> str:
-    """[XML] Escapes characters for XML safety."""
-    raw_value = str(value)
-    safe_value = html.escape(raw_value, quote=False)
-    if "</" in safe_value:
-        safe_value = safe_value.replace("</", "&lt;/")
-    return safe_value
-
-def no_escape(value: Any) -> str:
-    """[Plain] Returns string as-is (for dedent)."""
-    return str(value)
-
-def _render_structure_aware(template: Any, escape_fn: Callable[[Any], str]) -> str:
-    """
-    Core Logic: Dedents based on static structure, then injects processed values.
-    """
-    if isinstance(template, str):
-        return textwrap.dedent(template).strip()
-
-    static_parts = [p for p in template if isinstance(p, str)]
-    common_indent = _get_common_indent(static_parts)
-    
-    result = []
-    
-    for part in template:
-        if isinstance(part, str):
-            # Dedent static parts
-            lines = part.splitlines(keepends=True)
-            dedented_lines = [_dedent_line(line, common_indent) for line in lines]
-            result.append("".join(dedented_lines))
-        else:
-            # Inject dynamic value
-            result.append(escape_fn(part.value))
-
-    return "".join(result).lstrip()
-
-def xml(template: Any) -> str:
-    """[Python 3.14 Native Tag] XML Generator."""
-    return _render_structure_aware(template, escape_xml_value)
-
-def dedent(template: Any) -> str:
-    """[Python 3.14 Native Tag] Plain Text Generator."""
-    return _render_structure_aware(template, no_escape)

codigest-0.3.0/src/codigest/main.py

@@ -1,34 +0,0 @@
-"""
-Entry Point with Global Error Handling
-"""
-import sys
-import typer
-from rich.console import Console
-from .commands import init, scan, tree, digest, diff, semdiff
-
-console = Console()
-
-app = typer.Typer(
-    name="codigest",
-    help="Semantic Context Manager for LLM-assisted Development",
-    add_completion=False,
-    no_args_is_help=True
-)
-
-app.add_typer(init.app, name="init")
-app.add_typer(scan.app, name="scan")
-app.add_typer(tree.app, name="tree")
-app.add_typer(digest.app, name="digest")
-app.add_typer(diff.app, name="diff")
-app.add_typer(semdiff.app, name="semdiff")
-
-def main():
-    try:
-        app()
-    except Exception as e:
-        error_msg = str(e)
-        console.print(f"[bold red]❌ Error:[/bold red] {error_msg}")
-        sys.exit(1)
-
-if __name__ == "__main__":
-    main()