codigest 0.3.1__tar.gz → 0.3.3__tar.gz

{codigest-0.3.1 → codigest-0.3.3}/.github/workflows/publish.yml

@@ -19,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.3/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: codigest
+Version: 0.3.3
+Summary: Human-Centered Codebase Context Manager for LLMs
+Project-URL: Homepage, https://github.com/SJB777/codigest
+Project-URL: Repository, https://github.com/SJB777/codigest
+Project-URL: Issues, https://github.com/SJB777/codigest/issues
+Author-email: Codigest Team <sngd024@google.com>
+License: MIT
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.14
+Requires-Dist: loguru
+Requires-Dist: pathspec
+Requires-Dist: pyperclip
+Requires-Dist: rich
+Requires-Dist: tomli-w
+Requires-Dist: typer
+Description-Content-Type: text/markdown
+
+# Codigest
+
+**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.
+
+> **Note:** You can use the short alias **`cdg`** instead of `codigest` for faster typing.
+
+## 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.
+* **Environment Isolated**: Runs in its own isolated Python 3.14 environment via `uv`, ensuring it never conflicts with your project's dependencies.
+
+## Installation
+
+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](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
+uv tool install codigest
+```
+
+### Step 3: Update Path (Important!)
+
+To run `codigest` (or `cdg`) 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, use the **`cdg`** command anywhere.
+
+### 1. Initialization
+
+Sets up the `.codigest` directory and captures the initial baseline anchor.
+
+```bash
+cdg init
+```
+
+### 2. Full Context Snapshot (`scan`)
+
+Scans the codebase and generates a structured XML snapshot. Includes a **Pre-flight Check** to prevent accidental token overflow.
+
+* **Output:** `.codigest/snapshot.xml`
+* **Features:**
+* **Smart Confirmation:** Automatically skips confirmation for small contexts, but warns you for large ones (>30k tokens).
+* **Dependency Resolution (`-r`):** Automatically finds and includes local files imported by your target files.
+* **Scope Control:** You can specify folders or files to scan.
+
+
+
+```bash
+# Basic scan (Interactive confirmation if large)
+cdg scan
+
+# Scan specific folder with dependency resolution (Smart Context)
+cdg scan src/main.py -r
+
+# Force execution without confirmation (Good for CI/CD)
+cdg scan -y --message "Automated snapshot"
+```
+
+### 3. Incremental Changes (`diff`)
+
+Tracks text-based changes between the last `scan` and the current working tree.
+
+* **Output:** `.codigest/changes.diff`
+* **Use Case:** "I modified 3 files. Here is exactly what changed since the last snapshot."
+* **Note:** Checks against the internal Shadow Git, enabling tracking without committing to the real Git.
+
+```bash
+cdg diff
+```
+
+### 4. Semantic Analysis (`semdiff`)
+
+Analyzes **structural changes** (AST-based) rather than line-by-line text differences.
+
+* **Output:** `.codigest/semdiff.xml`
+* **Use Case:** "I refactored the API. Show me added/removed functions or signature changes."
+* **Benefit:** Reduces token usage by ignoring formatting/comment changes.
+
+```bash
+cdg semdiff
+```
+
+### 5. Project Tree (`tree`)
+
+Visualizes the project structure. Respects `.gitignore`.
+
+* **Style:** Professional, cleaner output without emojis for better readability.
+* **Use Case:** Quickly verifying which files are being tracked.
+
+```bash
+cdg tree
+```
+
+### 6. Architecture Digest (`digest`)
+
+Generates a high-level outline of the project structure (Classes, Functions, Methods only).
+
+* **Output:** `.codigest/digest.xml`
+* **Use Case:** "Don't read the implementation details. Just understand the class hierarchy."
+
+```bash
+cdg digest
+```
+
+---
+
+## Configuration
+
+You can customize behavior in `.codigest/config.toml`.
+
+```toml
+[filter]
+# Target extensions
+extensions = [".py", ".ts", ".rs", ".md", ".json"]
+
+# Exclude patterns (Gitignore syntax)
+exclude_patterns = [
+    "*.lock",
+    "tests/data/",
+    "legacy_code/"
+]
+
+[output]
+format = "xml"
+```
+
+## Architecture Details
+
+**Context Anchor (Shadow Git)**
+Codigest maintains a hidden, lightweight Git repository inside `.codigest/anchor/.shadow_git`.
+
+* It is renamed to `.shadow_git` to prevent VS Code and other IDEs from confusing it with your project's actual repository.
+* When you run `scan`, the current state is committed to this anchor.
+* When you run `diff`, the tool compares your working directory against this anchor.
+
+**Safety Mechanisms**
+
+* **Pre-flight Check:** Calculates estimated token count before processing to prevent context overflow errors.
+* **Structure-Aware Dedent:** Ensures XML tags are perfectly aligned (flush-left) to prevent indentation artifacts in LLM prompts.
+* **XML Injection Protection:** Automatically escapes content within XML tags.
+
+## License
+
+MIT License

codigest-0.3.3/README.md

@@ -0,0 +1,174 @@
+# Codigest
+
+**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.
+
+> **Note:** You can use the short alias **`cdg`** instead of `codigest` for faster typing.
+
+## 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.
+* **Environment Isolated**: Runs in its own isolated Python 3.14 environment via `uv`, ensuring it never conflicts with your project's dependencies.
+
+## Installation
+
+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](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
+uv tool install codigest
+```
+
+### Step 3: Update Path (Important!)
+
+To run `codigest` (or `cdg`) 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, use the **`cdg`** command anywhere.
+
+### 1. Initialization
+
+Sets up the `.codigest` directory and captures the initial baseline anchor.
+
+```bash
+cdg init
+```
+
+### 2. Full Context Snapshot (`scan`)
+
+Scans the codebase and generates a structured XML snapshot. Includes a **Pre-flight Check** to prevent accidental token overflow.
+
+* **Output:** `.codigest/snapshot.xml`
+* **Features:**
+* **Smart Confirmation:** Automatically skips confirmation for small contexts, but warns you for large ones (>30k tokens).
+* **Dependency Resolution (`-r`):** Automatically finds and includes local files imported by your target files.
+* **Scope Control:** You can specify folders or files to scan.
+
+
+
+```bash
+# Basic scan (Interactive confirmation if large)
+cdg scan
+
+# Scan specific folder with dependency resolution (Smart Context)
+cdg scan src/main.py -r
+
+# Force execution without confirmation (Good for CI/CD)
+cdg scan -y --message "Automated snapshot"
+```
+
+### 3. Incremental Changes (`diff`)
+
+Tracks text-based changes between the last `scan` and the current working tree.
+
+* **Output:** `.codigest/changes.diff`
+* **Use Case:** "I modified 3 files. Here is exactly what changed since the last snapshot."
+* **Note:** Checks against the internal Shadow Git, enabling tracking without committing to the real Git.
+
+```bash
+cdg diff
+```
+
+### 4. Semantic Analysis (`semdiff`)
+
+Analyzes **structural changes** (AST-based) rather than line-by-line text differences.
+
+* **Output:** `.codigest/semdiff.xml`
+* **Use Case:** "I refactored the API. Show me added/removed functions or signature changes."
+* **Benefit:** Reduces token usage by ignoring formatting/comment changes.
+
+```bash
+cdg semdiff
+```
+
+### 5. Project Tree (`tree`)
+
+Visualizes the project structure. Respects `.gitignore`.
+
+* **Style:** Professional, cleaner output without emojis for better readability.
+* **Use Case:** Quickly verifying which files are being tracked.
+
+```bash
+cdg tree
+```
+
+### 6. Architecture Digest (`digest`)
+
+Generates a high-level outline of the project structure (Classes, Functions, Methods only).
+
+* **Output:** `.codigest/digest.xml`
+* **Use Case:** "Don't read the implementation details. Just understand the class hierarchy."
+
+```bash
+cdg digest
+```
+
+---
+
+## Configuration
+
+You can customize behavior in `.codigest/config.toml`.
+
+```toml
+[filter]
+# Target extensions
+extensions = [".py", ".ts", ".rs", ".md", ".json"]
+
+# Exclude patterns (Gitignore syntax)
+exclude_patterns = [
+    "*.lock",
+    "tests/data/",
+    "legacy_code/"
+]
+
+[output]
+format = "xml"
+```
+
+## Architecture Details
+
+**Context Anchor (Shadow Git)**
+Codigest maintains a hidden, lightweight Git repository inside `.codigest/anchor/.shadow_git`.
+
+* It is renamed to `.shadow_git` to prevent VS Code and other IDEs from confusing it with your project's actual repository.
+* When you run `scan`, the current state is committed to this anchor.
+* When you run `diff`, the tool compares your working directory against this anchor.
+
+**Safety Mechanisms**
+
+* **Pre-flight Check:** Calculates estimated token count before processing to prevent context overflow errors.
+* **Structure-Aware Dedent:** Ensures XML tags are perfectly aligned (flush-left) to prevent indentation artifacts in LLM prompts.
+* **XML Injection Protection:** Automatically escapes content within XML tags.
+
+## License
+
+MIT License

{codigest-0.3.1 → codigest-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codigest"
-version = "0.3.1"
+version = "0.3.3"
 description = "Human-Centered Codebase Context Manager for LLMs"
 authors = [{name = "Codigest Team", email = "sngd024@google.com"}]
 readme = "README.md"
@@ -32,7 +32,8 @@ Issues = "https://github.com/SJB777/codigest/issues"
 
 [project.scripts]
 codigest = "codigest.main:app"
+cdg = "codigest.main:app"
 
 [build-system]
 requires = ["hatchling"]
-build-backend = "hatchling.build"
+build-backend = "hatchling.build"

codigest-0.3.3/src/codigest/__main__.py

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

{codigest-0.3.1 → codigest-0.3.3}/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,13 +29,13 @@ 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
     last_update = anchor.get_last_update_time()
     if last_update == "Never":
-        console.print("[yellow]⚠️  No scan history found.[/yellow]")
+        console.print("[yellow]No scan history found.[/yellow]")
         console.print("   Run [bold cyan]codigest scan[/bold cyan] first to establish a baseline.")
         raise typer.Exit(1)
 
@@ -75,10 +84,10 @@ def handle(
     
     if copy:
         pyperclip.copy(formatted_diff)
-        console.print("[dim]📋 Copied to clipboard[/dim]")
+        console.print("[dim]Copied to clipboard[/dim]")
 
     if save:
         out_path = root_path / ".codigest" / "changes.diff"
         out_path.parent.mkdir(exist_ok=True)
         out_path.write_text(formatted_diff, encoding="utf-8")
-        console.print(f"[dim]💾 Saved to {out_path}[/dim]")
+        console.print(f"[dim]Saved to {out_path}[/dim]")

{codigest-0.3.1 → codigest-0.3.3}/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
@@ -69,7 +65,7 @@ def handle(
                 instruction=message
             )
         except Exception as e:
-            console.print(f"[red]❌ Rendering Failed:[/red] {e}")
+            console.print(f"[red]Rendering Failed:[/red] {e}")
             raise typer.Exit(1)
             
         progress.update(task, completed=100)
@@ -79,10 +75,10 @@ def handle(
     
     if copy:
         pyperclip.copy(digest_content)
-        console.print("[dim]📋 Copied to clipboard[/dim]")
+        console.print("[dim]Copied to clipboard[/dim]")
     
     if save:
         out_path = root_path / ".codigest" / "digest.xml"
         out_path.parent.mkdir(exist_ok=True)
         out_path.write_text(digest_content, encoding="utf-8")
-        console.print(f"[dim]💾 Saved to {out_path}[/dim]")
+        console.print(f"[dim]Saved to {out_path}[/dim]")

{codigest-0.3.1 → codigest-0.3.3}/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"