codigest 0.3.5__tar.gz → 0.3.6__tar.gz

{codigest-0.3.5 → codigest-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codigest
-Version: 0.3.5
+Version: 0.3.6
 Summary: Human-Centered Codebase Context Manager for LLMs
 Project-URL: Homepage, https://github.com/SJB777/codigest
 Project-URL: Repository, https://github.com/SJB777/codigest
@@ -92,13 +92,12 @@ cdg init
 
 Scans the codebase and generates a structured XML snapshot. Includes a **Pre-flight Check** to prevent accidental token overflow.
 
-* **Output:** `.codigest/snapshot.xml`
+* **Output:** `.codigest/snapshot.txt` (or stdout with `-s`)
 * **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.
-
-
+* **Terminal Output (`-s` / `--stdout`):** Output directly to stdout instead of saving to file.
 
 ```bash
 # Basic scan (Interactive confirmation if large)
@@ -109,30 +108,39 @@ cdg scan src/main.py -r
 
 # Force execution without confirmation (Good for CI/CD)
 cdg scan -y --message "Automated snapshot"
+
+# Output directly to stdout
+cdg scan -s
 ```
 
 ### 3. Incremental Changes (`diff`)
 
 Tracks text-based changes between the last `scan` and the current working tree.
 
-* **Output:** `.codigest/changes.diff`
+* **Output:** `.codigest/changes.diff` (or stdout with `-s`)
 * **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
+
+# Output directly to stdout
+cdg diff -s
 ```
 
 ### 4. Semantic Analysis (`semdiff`)
 
 Analyzes **structural changes** (AST-based) rather than line-by-line text differences.
 
-* **Output:** `.codigest/semdiff.xml`
+* **Output:** `.codigest/semdiff.txt` (or stdout with `-s`)
 * **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
+
+# Output directly to stdout
+cdg semdiff -s
 ```
 
 ### 5. Project Tree (`tree`)
@@ -150,11 +158,38 @@ cdg tree
 
 Generates a high-level outline of the project structure (Classes, Functions, Methods only).
 
-* **Output:** `.codigest/digest.xml`
+* **Output:** `.codigest/digest.txt` (or stdout with `-s`)
 * **Use Case:** "Don't read the implementation details. Just understand the class hierarchy."
 
 ```bash
 cdg digest
+
+# Output directly to stdout
+cdg digest -s
+```
+
+### 7. Environment Status (`status`)
+
+Displays the health of `.codigest`, anchor snapshot baseline, pending working tree changes, and generated artifacts.
+
+* **Use Case:** "Check what files have changed since my last snapshot and inspect the state of generated context artifacts."
+
+```bash
+cdg status
+```
+
+### 8. Environment Cleanup (`clean`)
+
+Removes the `.codigest/` environment and resets all context anchors and artifacts.
+
+* **Use Case:** "Clean up context files and resets Codigest tracking."
+
+```bash
+# Interactive confirmation
+cdg clean
+
+# Force clean without prompt
+cdg clean -y
 ```
 
 ---

{codigest-0.3.5 → codigest-0.3.6}/README.md

@@ -67,13 +67,12 @@ cdg init
 
 Scans the codebase and generates a structured XML snapshot. Includes a **Pre-flight Check** to prevent accidental token overflow.
 
-* **Output:** `.codigest/snapshot.xml`
+* **Output:** `.codigest/snapshot.txt` (or stdout with `-s`)
 * **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.
-
-
+* **Terminal Output (`-s` / `--stdout`):** Output directly to stdout instead of saving to file.
 
 ```bash
 # Basic scan (Interactive confirmation if large)
@@ -84,30 +83,39 @@ cdg scan src/main.py -r
 
 # Force execution without confirmation (Good for CI/CD)
 cdg scan -y --message "Automated snapshot"
+
+# Output directly to stdout
+cdg scan -s
 ```
 
 ### 3. Incremental Changes (`diff`)
 
 Tracks text-based changes between the last `scan` and the current working tree.
 
-* **Output:** `.codigest/changes.diff`
+* **Output:** `.codigest/changes.diff` (or stdout with `-s`)
 * **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
+
+# Output directly to stdout
+cdg diff -s
 ```
 
 ### 4. Semantic Analysis (`semdiff`)
 
 Analyzes **structural changes** (AST-based) rather than line-by-line text differences.
 
-* **Output:** `.codigest/semdiff.xml`
+* **Output:** `.codigest/semdiff.txt` (or stdout with `-s`)
 * **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
+
+# Output directly to stdout
+cdg semdiff -s
 ```
 
 ### 5. Project Tree (`tree`)
@@ -125,11 +133,38 @@ cdg tree
 
 Generates a high-level outline of the project structure (Classes, Functions, Methods only).
 
-* **Output:** `.codigest/digest.xml`
+* **Output:** `.codigest/digest.txt` (or stdout with `-s`)
 * **Use Case:** "Don't read the implementation details. Just understand the class hierarchy."
 
 ```bash
 cdg digest
+
+# Output directly to stdout
+cdg digest -s
+```
+
+### 7. Environment Status (`status`)
+
+Displays the health of `.codigest`, anchor snapshot baseline, pending working tree changes, and generated artifacts.
+
+* **Use Case:** "Check what files have changed since my last snapshot and inspect the state of generated context artifacts."
+
+```bash
+cdg status
+```
+
+### 8. Environment Cleanup (`clean`)
+
+Removes the `.codigest/` environment and resets all context anchors and artifacts.
+
+* **Use Case:** "Clean up context files and resets Codigest tracking."
+
+```bash
+# Interactive confirmation
+cdg clean
+
+# Force clean without prompt
+cdg clean -y
 ```
 
 ---

{codigest-0.3.5 → codigest-0.3.6}/pyproject.toml

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

codigest-0.3.6/src/codigest/commands/clean.py

@@ -0,0 +1,45 @@
+import typer
+import shutil
+from pathlib import Path
+from rich.console import Console
+
+from ..core import common
+
+app = typer.Typer()
+console = Console()
+
+@app.callback(invoke_without_command=True)
+def handle(
+    target: Path = typer.Argument(
+        Path.cwd(),
+        help="Target directory to clean",
+        exists=True,
+        file_okay=False,
+        dir_okay=True,
+        resolve_path=True
+    ),
+    yes: bool = typer.Option(False, "-y", "--yes", "-f", "--force", help="Skip confirmation prompt"),
+):
+    """
+    [Cleanup] Removes the .codigest environment and clears all context anchors and artifacts.
+    """
+    ctx = common.get_context(target)
+    root_path = ctx.root_path
+    codigest_dir = root_path / ".codigest"
+
+    if not codigest_dir.exists():
+        console.print(f"[yellow]No .codigest directory found in {root_path}[/yellow]")
+        return
+
+    if not yes:
+        console.print(f"[yellow]Warning: This will remove [bold]{codigest_dir}[/bold] and all stored context/anchors.[/yellow]")
+        if not typer.confirm("Are you sure you want to remove .codigest?"):
+            console.print("[red]Aborted.[/red]")
+            raise typer.Exit()
+
+    try:
+        shutil.rmtree(codigest_dir)
+        console.print(f"[bold green]✔ Successfully removed .codigest environment from {root_path}[/bold green]")
+    except Exception as e:
+        console.print(f"[bold red]Error removing .codigest:[/bold red] {e}")
+        raise typer.Exit(1)

{codigest-0.3.5 → codigest-0.3.6}/src/codigest/commands/diff.py

@@ -8,6 +8,7 @@ from ..core import prompts, shadow, tags, common
 
 app = typer.Typer()
 console = Console()
+err_console = Console(stderr=True)
 
 @app.callback(invoke_without_command=True)
 def handle(
@@ -21,6 +22,7 @@ def handle(
     ),
     copy: bool = typer.Option(True, help="Auto-copy to clipboard"),
     save: bool = typer.Option(True, help="Save to .codigest/changes.diff"),
+    stdout: bool = typer.Option(False, "-s", "--stdout", help="Print output to terminal (stdout) instead of file"),
     message: str = typer.Option("", "--message", "-m", help="Add specific instruction context"),
     # [추가] resolve 옵션
     resolve: bool = typer.Option(False, "-r", "--resolve", help="Recursively resolve imports"),
@@ -29,6 +31,8 @@ def handle(
     [Context Update] Shows changes since the last 'codigest scan'.
     Useful for updating LLM context without re-uploading everything.
     """
+    log_console = err_console if stdout else console
+
     # [1] Context Setup
     ctx = common.get_context(target)
     root_path = ctx.root_path
@@ -38,18 +42,18 @@ def handle(
     # Check Baseline
     last_update = anchor.get_last_update_time()
     if last_update == "Never":
-        console.print("[yellow]⚠️  No scan history found.[/yellow]")
-        console.print("   Run [bold cyan]cdg scan[/bold cyan] first to establish a baseline.")
+        log_console.print("[yellow]⚠️  No scan history found.[/yellow]")
+        log_console.print("   Run [bold cyan]cdg scan[/bold cyan] first to establish a baseline.")
         raise typer.Exit(1)
 
-    console.print(f"[dim]Checking changes since last scan ({last_update})...[/dim]")
+    log_console.print(f"[dim]Checking changes since last scan ({last_update})...[/dim]")
 
     # [2] Calculate Diff via Context
     with Progress(
         SpinnerColumn(),
         TextColumn("[bold blue]Analyzing changes...[/bold blue]"),
         transient=True,
-        console=console
+        console=log_console
     ) as progress:
         task = progress.add_task("diff", total=None)
 
@@ -62,7 +66,7 @@ def handle(
         progress.update(task, completed=100)
 
     if not diff_content.strip():
-        console.print("[green]No changes detected since last scan.[/green]")
+        log_console.print("[green]No changes detected since last scan.[/green]")
         return
 
     # [3] Render
@@ -81,14 +85,19 @@ def handle(
         formatted_diff = f"<diff>\n{safe_content}\n</diff>"
 
     # [4] Output
-    console.print(f"[bold green]Changes Detected![/bold green] ({len(formatted_diff)} chars)")
+    log_console.print(f"[bold green]Changes Detected![/bold green] ({len(formatted_diff)} chars)")
     
     if copy:
-        pyperclip.copy(formatted_diff)
-        console.print("[dim]Clipboard copied[/dim]")
+        try:
+            pyperclip.copy(formatted_diff)
+            log_console.print("[dim]Clipboard copied[/dim]")
+        except Exception:
+            log_console.print("[dim]⚠️ Clipboard unavailable (skipped copy)[/dim]")
 
-    if save:
+    if stdout:
+        print(formatted_diff)
+    elif 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]")
+        log_console.print(f"[dim]Saved to {out_path}[/dim]")

{codigest-0.3.5 → codigest-0.3.6}/src/codigest/commands/digest.py

@@ -4,16 +4,18 @@ from pathlib import Path
 from rich.console import Console
 from rich.progress import Progress, SpinnerColumn, TextColumn
 
-from ..core import structure, prompts, semdiff, tags, tokenizer, common
+from ..core import structure, prompts, semdiff, tags, tokenizer, common, cache
 
 app = typer.Typer()
 console = Console()
+err_console = Console(stderr=True)
 
 @app.callback(invoke_without_command=True)
 def handle(
     target: Path = typer.Argument(Path.cwd(), help="Target directory"),
     copy: bool = typer.Option(True, help="Auto-copy to clipboard"),
-    save: bool = typer.Option(True, help="Save to .codigest/digest.xml"),
+    save: bool = typer.Option(True, help="Save to .codigest/digest.txt"),
+    stdout: bool = typer.Option(False, "-s", "--stdout", help="Print output to terminal (stdout) instead of file"),
     message: str = typer.Option("", "--message", "-m", help="Add specific instruction"),
     # [추가]
     resolve: bool = typer.Option(False, "-r", "--resolve", help="Recursively resolve imports"),
@@ -21,6 +23,8 @@ def handle(
     """
     [Architectural View] Summarizes the codebase structure (Classes/Functions only).
     """
+    log_console = err_console if stdout else console
+
     # [1] Context Setup
     ctx = common.get_context(target)
     root_path = ctx.root_path
@@ -31,7 +35,7 @@ def handle(
         SpinnerColumn(),
         TextColumn("[bold blue]Digesting Architecture...[/bold blue]"),
         transient=True,
-        console=console
+        console=log_console
     ) as progress:
         
         task = progress.add_task("digest", total=None)
@@ -41,23 +45,35 @@ def handle(
         
         tree_str = structure.generate_ascii_tree(files, root_path)
 
+        content_cache = cache.ContentCache(root_path)
         summary_blocks = []
+
         for file_path in files:
             if file_path.suffix in (".py", ".pyi"):
                 try:
-                    content = file_path.read_text(encoding="utf-8")
-                    summary = semdiff.summarize(content)
-                    
-                    if summary:
-                        try:
-                            rel_path = file_path.relative_to(root_path).as_posix()
-                        except ValueError:
-                            rel_path = f"[EXTERNAL]/{file_path.name}"
+                    rel_path = file_path.relative_to(root_path).as_posix()
+                except ValueError:
+                    rel_path = f"[EXTERNAL]/{file_path.name}"
+
+                blob_hash = cache.get_file_blob_hash(file_path)
+                summary = None
+                if blob_hash:
+                    summary = content_cache.get_summary(rel_path, blob_hash)
 
-                        block = tags.file(rel_path, summary)
-                        summary_blocks.append(block)
-                except Exception:
-                    continue
+                if summary is None:
+                    try:
+                        content = file_path.read_text(encoding="utf-8")
+                        summary = semdiff.summarize(content)
+                        if summary and blob_hash:
+                            content_cache.set_summary(rel_path, blob_hash, summary)
+                    except Exception:
+                        continue
+
+                if summary:
+                    block = tags.file(rel_path, summary)
+                    summary_blocks.append(block)
+
+        content_cache.save()
 
         summary_blob = "\n".join(summary_blocks)
         
@@ -70,20 +86,25 @@ def handle(
                 instruction=message
             )
         except Exception as e:
-            console.print(f"[red]❌ Rendering Failed:[/red] {e}")
+            log_console.print(f"[red]❌ Rendering Failed:[/red] {e}")
             raise typer.Exit(1)
             
         progress.update(task, completed=100)
 
     token_count = tokenizer.estimate_tokens(digest_content)
-    console.print(f"[bold green]Digest Generated![/bold green] ([bold cyan]~{token_count:,} Tokens[/bold cyan])")
+    log_console.print(f"[bold green]Digest Generated![/bold green] ([bold cyan]~{token_count:,} Tokens[/bold cyan])")
     
     if copy:
-        pyperclip.copy(digest_content)
-        console.print("[dim]📋 Copied to clipboard[/dim]")
+        try:
+            pyperclip.copy(digest_content)
+            log_console.print("[dim]📋 Copied to clipboard[/dim]")
+        except Exception:
+            log_console.print("[dim]⚠️ Clipboard unavailable (skipped copy)[/dim]")
     
-    if save:
-        out_path = root_path / ".codigest" / "digest.xml"
+    if stdout:
+        print(digest_content)
+    elif save:
+        out_path = root_path / ".codigest" / "digest.txt"
         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]")
+        log_console.print(f"[dim]💾 Saved to {out_path}[/dim]")

{codigest-0.3.5 → codigest-0.3.6}/src/codigest/commands/scan.py

@@ -1,3 +1,4 @@
+import sys
 import typer
 from pathlib import Path
 from rich.console import Console
@@ -5,10 +6,11 @@ from rich.progress import Progress, SpinnerColumn, TextColumn
 from rich.panel import Panel
 from rich.filesize import decimal
 
-from ..core import structure, tags, prompts, processor, shadow, tokenizer, common
+from ..core import structure, tags, prompts, processor, shadow, tokenizer, common, cache
 
 app = typer.Typer()
 console = Console()
+err_console = Console(stderr=True)
 
 @app.callback(invoke_without_command=True)
 def handle(
@@ -18,7 +20,8 @@ def handle(
         exists=True,
         resolve_path=True
     ),
-    output: str = typer.Option("snapshot.xml", help="Output filename inside .codigest/"),
+    output: str = typer.Option("snapshot.txt", "-o", "--output", help="Output filename inside .codigest/"),
+    stdout: bool = typer.Option(False, "-s", "--stdout", help="Print output to terminal (stdout) instead of file"),
     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"),
@@ -29,6 +32,8 @@ def handle(
     Scans the codebase. 
     If TARGETS provided, only scans those paths within the project.
     """
+    log_console = err_console if stdout else console
+
     # [1] Context Setup (Centralized)
     ctx = common.get_context(targets)
     root_path = ctx.root_path
@@ -36,11 +41,11 @@ def handle(
     # Init check
     artifact_dir = root_path / ".codigest"
     if not artifact_dir.exists():
-        console.print(f"[yellow][Warning] .codigest directory missing in {root_path.name}. Running init...[/yellow]")
+        log_console.print(f"[yellow][Warning] .codigest directory missing in {root_path.name}. Running init...[/yellow]")
         try:
             artifact_dir.mkdir(exist_ok=True)
         except PermissionError:
-            console.print(f"[red][Error] Cannot create .codigest at {root_path}[/red]")
+            log_console.print(f"[red][Error] Cannot create .codigest at {root_path}[/red]")
             raise typer.Exit(1)
 
     output_path = artifact_dir / output
@@ -52,7 +57,7 @@ def handle(
         SpinnerColumn(),
         TextColumn("[bold blue]Scanning...[/bold blue]"),
         transient=True,
-        console=console
+        console=log_console
     ) as progress:
         task = progress.add_task("scanning", total=None)
         
@@ -70,7 +75,7 @@ def handle(
     total_size = sum(f.stat().st_size for f in files)
     est_tokens = int(total_size / 4) 
 
-    console.print(Panel(f"""[bold]Scan Plan[/bold]
+    log_console.print(Panel(f"""[bold]Scan Plan[/bold]
   Target: [cyan]{root_path}[/cyan]
   Scope: {total_files} files
   Est. Size: {decimal(total_size)}
@@ -83,19 +88,19 @@ def handle(
     if yes:
         pass 
     elif is_large_context:
-        console.print(f"[yellow][Warning] Large context detected (> {TOKEN_THRESHOLD:,} tokens or > {FILE_COUNT_THRESHOLD} files).[/yellow]")
+        log_console.print(f"[yellow][Warning] Large context detected (> {TOKEN_THRESHOLD:,} tokens or > {FILE_COUNT_THRESHOLD} files).[/yellow]")
         if not typer.confirm("Proceed with digestion?"):
-            console.print("[red]Aborted.[/red]")
+            log_console.print("[red]Aborted.[/red]")
             raise typer.Exit()
     else:
-        console.print("[dim]Small context detected. Automatically proceeding...[/dim]")
+        log_console.print("[dim]Small context detected. Automatically proceeding...[/dim]")
 
     # [4] Execution
     with Progress(
         SpinnerColumn(),
         TextColumn("[bold blue]Generating Snapshot...[/bold blue]"),
         transient=True,
-        console=console
+        console=log_console
     ) as progress:
         
         if anchor.has_history():
@@ -109,19 +114,33 @@ def handle(
 
         tree_str = structure.generate_ascii_tree(files, root_path)
 
+        content_cache = cache.ContentCache(root_path)
         file_blocks = []
+
         for file_path in files:
             try:
                 rel_path = file_path.relative_to(root_path).as_posix()
             except ValueError:
                 rel_path = f"[EXTERNAL]/{file_path.name}"
 
-            try:
-                content = processor.read_file_content(file_path, add_line_numbers=line_numbers)
-                block = tags.file(rel_path, content)
-                file_blocks.append(block)
-            except Exception:
-                continue
+            blob_hash = cache.get_file_blob_hash(file_path)
+            cached_block = None
+            if blob_hash:
+                cached_block = content_cache.get_file_block(rel_path, blob_hash, line_numbers)
+
+            if cached_block is not None:
+                file_blocks.append(cached_block)
+            else:
+                try:
+                    content = processor.read_file_content(file_path, add_line_numbers=line_numbers)
+                    block = tags.file(rel_path, content)
+                    file_blocks.append(block)
+                    if blob_hash:
+                        content_cache.set_file_block(rel_path, blob_hash, line_numbers, block)
+                except Exception:
+                    continue
+
+        content_cache.save()
 
         source_code_blob = "\n\n".join(file_blocks)
 
@@ -134,27 +153,30 @@ def handle(
                 instruction=message
             )
         except Exception as e:
-            console.print(f"[red][Error] Template Rendering Failed:[/red] {e}")
+            log_console.print(f"[red][Error] Template Rendering Failed:[/red] {e}")
             raise typer.Exit(1)
 
     try:
         anchor.update(files)
     except Exception as e:
-        console.print(f"[yellow][Warning] Failed to update context anchor: {e}[/yellow]")
-
-    try:
-        output_path.write_text(snapshot_content, encoding="utf-8")
-        final_token_count = tokenizer.estimate_tokens(snapshot_content)
+        log_console.print(f"[yellow][Warning] Failed to update context anchor: {e}[/yellow]")
 
-        console.print("[bold green]Snapshot Saved![/bold green]")
-        console.print(f"  Path: [underline]{output_path}[/underline]")
-        console.print(f"  Final Tokens: [bold cyan]~{final_token_count:,}[/bold cyan]")
-        
-        if anchor.has_history():
-            pre_diff_path = artifact_dir / "previous_changes.diff"
-            if pre_diff_path.exists() and pre_diff_path.stat().st_size > 0:
-                console.print(f"  [dim]Changes before this scan saved to: {pre_diff_path.name}[/dim]")
+    if stdout:
+        print(snapshot_content)
+    else:
+        try:
+            output_path.write_text(snapshot_content, encoding="utf-8")
+            final_token_count = tokenizer.estimate_tokens(snapshot_content)
+
+            log_console.print("[bold green]Snapshot Saved![/bold green]")
+            log_console.print(f"  Path: [underline]{output_path}[/underline]")
+            log_console.print(f"  Final Tokens: [bold cyan]~{final_token_count:,}[/bold cyan]")
+            
+            if anchor.has_history():
+                pre_diff_path = artifact_dir / "previous_changes.diff"
+                if pre_diff_path.exists() and pre_diff_path.stat().st_size > 0:
+                    log_console.print(f"  [dim]Changes before this scan saved to: {pre_diff_path.name}[/dim]")
 
-    except Exception as e:
-        console.print(f"[bold red][Error] Save Failed:[/bold red] {e}")
-        raise typer.Exit(1)
+        except Exception as e:
+            log_console.print(f"[bold red][Error] Save Failed:[/bold red] {e}")
+            raise typer.Exit(1)

{codigest-0.3.5 → codigest-0.3.6}/src/codigest/commands/semdiff.py

@@ -8,12 +8,14 @@ from ..core import prompts, shadow, semdiff, tags, tokenizer, common
 
 app = typer.Typer()
 console = Console()
+err_console = Console(stderr=True)
 
 @app.callback(invoke_without_command=True)
 def handle(
     target: Path = typer.Argument(Path.cwd(), help="Target directory"),
     copy: bool = typer.Option(True, help="Auto-copy to clipboard"),
-    save: bool = typer.Option(True, help="Save to .codigest/semdiff.xml"),
+    save: bool = typer.Option(True, help="Save to .codigest/semdiff.txt"),
+    stdout: bool = typer.Option(False, "-s", "--stdout", help="Print output to terminal (stdout) instead of file"),
     message: str = typer.Option("", "--message", "-m", help="Add specific instruction"),
     # [추가] resolve 옵션
     resolve: bool = typer.Option(False, "-r", "--resolve", help="Recursively resolve imports"),
@@ -22,6 +24,8 @@ def handle(
     [Advanced] Generates a Semantic Diff (AST-based) report.
     Shows ADDED/REMOVED/MODIFIED functions & classes instead of raw text lines.
     """
+    log_console = err_console if stdout else console
+
     # [1] Context Setup
     ctx = common.get_context(target)
     root_path = ctx.root_path
@@ -30,10 +34,10 @@ def handle(
 
     last_update = anchor.get_last_update_time()
     if last_update == "Never":
-        console.print("[yellow]⚠️  No scan history found. Run [bold]cdg scan[/bold] first.[/yellow]")
+        log_console.print("[yellow]⚠️  No scan history found. Run [bold]cdg scan[/bold] first.[/yellow]")
         raise typer.Exit(1)
 
-    console.print(f"[dim]Analyzing structural changes since ({last_update})...[/dim]")
+    log_console.print(f"[dim]Analyzing structural changes since ({last_update})...[/dim]")
 
     reports = []
 
@@ -41,7 +45,7 @@ def handle(
         SpinnerColumn(),
         TextColumn("[bold blue]Parsing AST...[/bold blue]"),
         transient=True,
-        console=console
+        console=log_console
     ) as progress:
         task = progress.add_task("semdiff", total=None)
 
@@ -108,7 +112,7 @@ def handle(
         progress.update(task, completed=100)
 
     if not reports:
-        console.print("[green]No structural (AST) changes detected.[/green]")
+        log_console.print("[green]No structural (AST) changes detected.[/green]")
         return
 
     # [4] Render
@@ -124,18 +128,23 @@ def handle(
             instruction=message
         )
     except Exception as e:
-        console.print(f"[red]Template Error:[/red] {e}")
+        log_console.print(f"[red]Template Error:[/red] {e}")
         raise typer.Exit(1)
 
     token_count = tokenizer.estimate_tokens(final_output)
-    console.print(f"[bold green]SemDiff Generated![/bold green] ([bold cyan]~{token_count:,} Tokens[/bold cyan])")
+    log_console.print(f"[bold green]SemDiff Generated![/bold green] ([bold cyan]~{token_count:,} Tokens[/bold cyan])")
     
     if copy:
-        pyperclip.copy(final_output)
-        console.print("[dim]Clipboard copied[/dim]")
+        try:
+            pyperclip.copy(final_output)
+            log_console.print("[dim]Clipboard copied[/dim]")
+        except Exception:
+            log_console.print("[dim]⚠️ Clipboard unavailable (skipped copy)[/dim]")
     
-    if save:
-        out_path = root_path / ".codigest" / "semdiff.xml"
+    if stdout:
+        print(final_output)
+    elif save:
+        out_path = root_path / ".codigest" / "semdiff.txt"
         out_path.parent.mkdir(exist_ok=True)
         out_path.write_text(final_output, encoding="utf-8")
-        console.print(f"[dim]Saved to {out_path}[/dim]")
+        log_console.print(f"[dim]Saved to {out_path}[/dim]")

codigest-0.3.6/src/codigest/commands/status.py

@@ -0,0 +1,151 @@
+import typer
+from pathlib import Path
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.filesize import decimal
+
+from ..core import common, shadow, tokenizer
+
+app = typer.Typer()
+console = Console()
+
+@app.callback(invoke_without_command=True)
+def handle(
+    target: Path = typer.Argument(
+        Path.cwd(),
+        help="Target directory to check status",
+        exists=True,
+        file_okay=False,
+        dir_okay=True,
+        resolve_path=True
+    ),
+    resolve: bool = typer.Option(False, "-r", "--resolve", help="Recursively resolve imports when checking context files"),
+):
+    """
+    [Environment Status] Displays information about the .codigest setup, anchor baseline, changes, and artifacts.
+    """
+    ctx = common.get_context(target)
+    root_path = ctx.root_path
+    codigest_dir = root_path / ".codigest"
+    
+    is_initialized = codigest_dir.exists() and codigest_dir.is_dir()
+    
+    # Header Panel
+    init_status_str = "[bold green]Initialized[/bold green]" if is_initialized else "[bold yellow]Not Initialized[/bold yellow]"
+    header_content = (
+        f"🦁 [bold cyan]Codigest Environment Status[/bold cyan]\n"
+        f"📂 [bold]Root:[/bold] {root_path}\n"
+        f"⚙️ [bold]Status:[/bold] {init_status_str} "
+        f"({'[dim].codigest/ present[/dim]' if is_initialized else '[dim]run cdg init to set up[/dim]'})"
+    )
+    console.print(Panel(header_content, expand=False))
+
+    if not is_initialized:
+        console.print("\n[yellow]💡 Tip: Run [bold cyan]cdg init[/bold cyan] to initialize context tracking for this repository.[/yellow]")
+        return
+
+    anchor = shadow.ContextAnchor(root_path)
+    has_anchor = anchor.has_history()
+    last_update = anchor.get_last_update_time() if has_anchor else "Never"
+
+    # Fetch target files
+    current_files = ctx.get_target_files(resolve_deps=resolve)
+    total_files = len(current_files)
+
+    # 1. Baseline Section
+    console.print("\n[bold blue]📍 Context Anchor Baseline[/bold blue]")
+    console.print(f"  • [bold]Last Snapshot:[/bold] {last_update}")
+    console.print(f"  • [bold]Tracked Source Files:[/bold] {total_files} files")
+
+    # 2. Pending Working Tree Changes
+    console.print("\n[bold blue]📝 Pending Working Tree Changes[/bold blue] [dim](since last scan)[/dim]")
+    if not has_anchor:
+        console.print("  [yellow]⚠️ No baseline scan found. Run [bold cyan]cdg scan[/bold cyan] to create the initial snapshot.[/yellow]")
+    else:
+        diff_content = anchor.get_changes(current_files)
+        changed_files = anchor.get_changed_files(current_files)
+
+        if not diff_content.strip():
+            console.print("  [green]✔ Working tree clean (No pending changes detected)[/green]")
+        else:
+            diff_tokens = tokenizer.estimate_tokens(diff_content)
+            console.print(f"  • [bold]Changed Files:[/bold] [yellow]{len(changed_files)} files[/yellow]")
+            console.print(f"  • [bold]Est. Diff Size:[/bold] [cyan]~{diff_tokens:,} tokens[/cyan] ({len(diff_content):,} chars)")
+            
+            console.print("  • [bold]Modified / New Files:[/bold]")
+            max_show = 10
+            for idx, p in enumerate(changed_files):
+                if idx >= max_show:
+                    remaining = len(changed_files) - max_show
+                    console.print(f"    [dim]... and {remaining} more file(s)[/dim]")
+                    break
+                try:
+                    rel_p = p.relative_to(root_path).as_posix()
+                except ValueError:
+                    rel_p = str(p)
+                
+                # Check if new file or modified
+                try:
+                    rel_path_obj = p.relative_to(root_path)
+                    anchor_file_content = anchor.read_anchor_file(rel_path_obj)
+                except Exception:
+                    anchor_file_content = ""
+
+                status_label = "[green][NEW]     [/green]" if not anchor_file_content else "[yellow][MODIFIED][/yellow]"
+                console.print(f"    {status_label} {rel_p}")
+
+    # 3. Artifacts Summary Table
+    console.print("\n[bold blue]📦 Context Artifacts[/bold blue] [dim](.codigest/)[/dim]")
+    
+    artifacts = [
+        ("snapshot.txt", "Full Context Snapshot", "cdg scan"),
+        ("changes.diff", "Incremental Diff", "cdg diff"),
+        ("semdiff.txt", "Semantic AST Diff", "cdg semdiff"),
+        ("digest.txt", "Architecture Digest", "cdg digest"),
+    ]
+
+    table = Table(box=None, header_style="bold cyan", padding=(0, 2))
+    table.add_column("Artifact", style="bold white")
+    table.add_column("Description", style="dim")
+    table.add_column("Status")
+    table.add_column("Size", justify="right")
+    table.add_column("Tokens", justify="right", style="cyan")
+
+    for filename, desc, cmd_hint in artifacts:
+        art_path = codigest_dir / filename
+        if art_path.exists() and art_path.is_file():
+            stat = art_path.stat()
+            size_str = decimal(stat.st_size)
+            try:
+                text_content = art_path.read_text(encoding="utf-8", errors="replace")
+                tokens = tokenizer.estimate_tokens(text_content)
+                tokens_str = f"~{tokens:,}"
+            except Exception:
+                tokens_str = "N/A"
+            status_str = "[bold green]Ready[/bold green]"
+        else:
+            size_str = "-"
+            tokens_str = "-"
+            status_str = f"[dim]Missing ({cmd_hint})[/dim]"
+
+        table.add_row(filename, desc, status_str, size_str, tokens_str)
+
+    console.print(table)
+
+    # 4. Configuration Summary
+    console.print("\n[bold blue]⚙️ Configuration[/bold blue] [dim](.codigest/config.toml)[/dim]")
+    config_file = codigest_dir / "config.toml"
+    if config_file.exists():
+        console.print("  • [bold]Config File:[/bold] [green]Found[/green]")
+    else:
+        console.print("  • [bold]Config File:[/bold] [yellow]Default settings (no config.toml)[/yellow]")
+
+    if ctx.config_extensions:
+        exts_str = ", ".join(sorted(ctx.config_extensions))
+        console.print(f"  • [bold]Filter Extensions:[/bold] [cyan]{exts_str}[/cyan]")
+    else:
+        console.print("  • [bold]Filter Extensions:[/bold] [dim]All non-ignored extensions[/dim]")
+
+    if ctx.config_ignores:
+        console.print(f"  • [bold]Extra Ignores:[/bold] {len(ctx.config_ignores)} custom patterns")

codigest-0.3.6/src/codigest/core/cache.py

@@ -0,0 +1,78 @@
+"""
+Git Blob Hash-based Content & AST Cache.
+Provides fast caching for scan snapshot blocks and digest AST summaries.
+"""
+import json
+import hashlib
+from pathlib import Path
+from typing import Optional, Dict, Any
+
+def compute_git_blob_hash(data: bytes) -> str:
+    """Computes Git-compatible SHA-1 blob hash for raw bytes."""
+    header = f"blob {len(data)}\0".encode("utf-8")
+    return hashlib.sha1(header + data).hexdigest()
+
+def get_file_blob_hash(file_path: Path) -> Optional[str]:
+    """Reads file and computes its Git blob hash."""
+    try:
+        data = file_path.read_bytes()
+        return compute_git_blob_hash(data)
+    except Exception:
+        return None
+
+class ContentCache:
+    def __init__(self, root_path: Path):
+        self.root_path = root_path
+        self.cache_file = root_path / ".codigest" / "cache.json"
+        self._data: Dict[str, Any] = {}
+        self.hits = 0
+        self.misses = 0
+        self._load()
+
+    def _load(self):
+        if self.cache_file.exists():
+            try:
+                with open(self.cache_file, "r", encoding="utf-8") as f:
+                    self._data = json.load(f)
+            except Exception:
+                self._data = {}
+        else:
+            self._data = {}
+
+    def save(self):
+        try:
+            self.cache_file.parent.mkdir(parents=True, exist_ok=True)
+            with open(self.cache_file, "w", encoding="utf-8") as f:
+                json.dump(self._data, f, ensure_ascii=False, indent=2)
+        except Exception:
+            pass
+
+    def get_file_block(self, rel_path: str, blob_hash: str, line_numbers: bool) -> Optional[str]:
+        cache_key = f"{rel_path}:{blob_hash}:lines={line_numbers}"
+        val = self._data.get("file_blocks", {}).get(cache_key)
+        if val is not None:
+            self.hits += 1
+        else:
+            self.misses += 1
+        return val
+
+    def set_file_block(self, rel_path: str, blob_hash: str, line_numbers: bool, block: str):
+        if "file_blocks" not in self._data:
+            self._data["file_blocks"] = {}
+        cache_key = f"{rel_path}:{blob_hash}:lines={line_numbers}"
+        self._data["file_blocks"][cache_key] = block
+
+    def get_summary(self, rel_path: str, blob_hash: str) -> Optional[str]:
+        cache_key = f"{rel_path}:{blob_hash}"
+        val = self._data.get("summaries", {}).get(cache_key)
+        if val is not None:
+            self.hits += 1
+        else:
+            self.misses += 1
+        return val
+
+    def set_summary(self, rel_path: str, blob_hash: str, summary: str):
+        if "summaries" not in self._data:
+            self._data["summaries"] = {}
+        cache_key = f"{rel_path}:{blob_hash}"
+        self._data["summaries"][cache_key] = summary

{codigest-0.3.5 → codigest-0.3.6}/src/codigest/core/shadow.py

@@ -10,17 +10,16 @@ from loguru import logger
 
 class ContextAnchor:
     def __init__(self, root_path: Path):
-        self.root = root_path
-        self.anchor_dir = root_path / ".codigest" / "anchor"
-
-        self.git_dir = self.anchor_dir / ".shadow_git"
+        self.root = root_path.resolve()
+        self.anchor_dir = (self.root / ".codigest" / "anchor").resolve()
+        self.git_dir = (self.anchor_dir / ".shadow_git").resolve()
 
     def has_history(self) -> bool:
         """Checks if a valid anchor (git repo with commits) exists."""
         return self.git_dir.exists() and (self.git_dir / "HEAD").exists()
 
     def _run_git(self, args: list[str], cwd: Path | None = None, check=True) -> str:
-
+        self.anchor_dir.mkdir(parents=True, exist_ok=True)
         base_cmd = [
             "git", 
             "--git-dir", str(self.git_dir), 
@@ -42,11 +41,16 @@ class ContextAnchor:
         return (result.stdout or "").strip()
 
     def update(self, source_files: list[Path]):
-        if not self.git_dir.exists():
-            self.anchor_dir.mkdir(parents=True, exist_ok=True)
-            self.git_dir.mkdir(parents=True, exist_ok=True)
-
-            self._run_git(["init"])
+        self.anchor_dir.mkdir(parents=True, exist_ok=True)
+        (self.anchor_dir / ".gitignore").write_text(".shadow_git\n", encoding="utf-8")
+        if not self.git_dir.exists() or not (self.git_dir / "HEAD").exists():
+            if self.git_dir.exists():
+                shutil.rmtree(self.git_dir)
+            subprocess.run(
+                ["git", "init", "--bare", str(self.git_dir)],
+                capture_output=True, check=False
+            )
+            self._run_git(["config", "core.bare", "false"])
             self._run_git(["config", "user.email", "codigest@ai"])
             self._run_git(["config", "user.name", "Context Manager"])
             self._run_git(["config", "core.autocrlf", "false"])
@@ -63,7 +67,7 @@ class ContextAnchor:
         source_rel_paths = set()
 
         for src in source_files:
-            if ".git" in src.parts:
+            if ".git" in src.parts or ".codigest" in src.parts:
                 continue
             try:
                 rel = src.relative_to(self.root)
@@ -80,6 +84,7 @@ class ContextAnchor:
                     if src_stat.st_size == dest_stat.st_size and dest_stat.st_mtime >= src_stat.st_mtime:
                         should_copy = False
                 
+                source_rel_paths.add(rel)
                 if should_copy:
                     shutil.copy2(src, dest)
             except Exception:
@@ -87,7 +92,7 @@ class ContextAnchor:
 
         for anchor_file in self.anchor_dir.rglob("*"):
             if anchor_file.is_file():
-                if ".git" in anchor_file.parts:
+                if ".shadow_git" in anchor_file.parts:
                     continue
 
                 try:
@@ -99,7 +104,10 @@ class ContextAnchor:
                     continue
 
         self._run_git(["add", "."])
-        if self._run_git(["diff-index", "--quiet", "HEAD", "--"], check=False) != "":
+        if not self._run_git(["rev-parse", "--verify", "HEAD"], check=False):
+            self._run_git(["commit", "-m", f"Snapshot: {int(time.time())}"])
+            logger.info("Initial context anchor created.")
+        elif self._run_git(["diff-index", "--quiet", "HEAD", "--"], check=False) != "":
             self._run_git(["commit", "-m", f"Snapshot: {int(time.time())}"])
             logger.info("Context anchor updated.")
 
@@ -118,7 +126,7 @@ class ContextAnchor:
         try:
             current_rel_paths = set()
             for src in current_files:
-                if ".git" in src.parts:
+                if ".git" in src.parts or ".codigest" in src.parts:
                     continue
                 try:
                     rel = src.relative_to(self.root)
@@ -149,7 +157,15 @@ class ContextAnchor:
             
             diff_text = (result.stdout or "")
             diff_text = diff_text.replace("temp_diff_baseline/", "").replace("temp_diff_current/", "")
-            return diff_text
+            
+            clean_lines = []
+            skip = False
+            for line in diff_text.splitlines():
+                if line.startswith("diff --git"):
+                    skip = any(x in line for x in [".shadow_git", ".codigest", ".git"])
+                if not skip:
+                    clean_lines.append(line)
+            return "\n".join(clean_lines)
 
         finally:
             for d in [temp_current, temp_baseline]:
@@ -158,7 +174,7 @@ class ContextAnchor:
 
     def _prune_ignored_files(self, baseline_dir: Path, valid_rel_paths: set[Path]):
         for file_path in baseline_dir.rglob("*"):
-            if file_path.is_file() and ".git" not in file_path.parts:
+            if file_path.is_file() and ".git" not in file_path.parts and ".codigest" not in file_path.parts and ".shadow_git" not in file_path.parts:
                 try:
                     rel_path = file_path.relative_to(baseline_dir)
                     if rel_path in valid_rel_paths:
@@ -209,5 +225,6 @@ class ContextAnchor:
                 if len(parts) >= 4:
                     p = parts[-1]
                     if p.startswith("b/") or p.startswith("a/"): p = p[2:]
-                    paths.add(self.root / p)
-        return sorted(list(paths))
+                    if not any(part in (".codigest", ".git", ".shadow_git") for part in Path(p).parts):
+                        paths.add(self.root / p)
+        return sorted(list(paths))

{codigest-0.3.5 → codigest-0.3.6}/src/codigest/main.py

@@ -6,7 +6,7 @@ import typer
 from rich.console import Console
 from importlib.metadata import version, PackageNotFoundError
 
-from .commands import init, scan, tree, digest, diff, semdiff
+from .commands import init, scan, tree, digest, diff, semdiff, status, clean
 
 console = Console()
 
@@ -18,6 +18,8 @@ app = typer.Typer(
 )
 
 app.add_typer(init.app, name="init")
+app.add_typer(status.app, name="status")
+app.add_typer(clean.app, name="clean")
 app.add_typer(scan.app, name="scan")
 app.add_typer(tree.app, name="tree")
 app.add_typer(digest.app, name="digest")

{codigest-0.3.5 → codigest-0.3.6}/uv.lock

@@ -16,11 +16,7 @@ wheels = [
 
 [[package]]
 name = "codigest"
-<<<<<<< HEAD
-version = "0.3.2"
-=======
-version = "0.3.5"
->>>>>>> 03f5ec5087ff49559e917b3620b915c9ace496c2
+version = "0.3.6"
 source = { editable = "." }
 dependencies = [
     { name = "loguru" },