codigest 0.4.0__tar.gz → 0.4.2__tar.gz

codigest-0.4.2/.github/workflows/tests.yml

@@ -0,0 +1,15 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv python install 3.15
+      - run: uv run --with pytest pytest -q

{codigest-0.4.0 → codigest-0.4.2}/CITATION.cff

@@ -14,7 +14,7 @@ authors:
 repository-code: "https://github.com/NaNIsaac/codigest"
 url: "https://pypi.org/project/codigest/"
 license: MIT
-version: 0.4.0
+version: 0.4.2
 date-released: "2026-10-15"
 keywords:
   - LLM

{codigest-0.4.0 → codigest-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codigest
-Version: 0.4.0
+Version: 0.4.2
 Summary: Human-Centered Codebase Context Manager for LLMs
 Project-URL: Homepage, https://github.com/NaNIsaac/codigest
 Project-URL: Repository, https://github.com/NaNIsaac/codigest
@@ -26,6 +26,12 @@ Description-Content-Type: text/markdown
 
 # Codigest
 
+[![PyPI](https://img.shields.io/pypi/v/codigest)](https://pypi.org/project/codigest/)
+[![Downloads](https://static.pepy.tech/badge/codigest)](https://pepy.tech/project/codigest)
+[![Tests](https://github.com/NaNIsaac/codigest/actions/workflows/tests.yml/badge.svg)](https://github.com/NaNIsaac/codigest/actions/workflows/tests.yml)
+
+<!-- mcp-name: io.github.NaNIsaac/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.
@@ -35,7 +41,8 @@ Unlike simple copy-paste tools, Codigest employs a **Context Anchor** system (Sh
 ## Quickstart
 
 ```bash
-uv tool install codigest
+uvx codigest scan          # try it without installing
+uv tool install codigest  # or install the `cdg` command
 
 cdg scan                  # whole project as LLM-ready XML (copied to clipboard)
 cdg init && cdg diff      # set an anchor, later get only what changed

{codigest-0.4.0 → codigest-0.4.2}/README.md

@@ -1,5 +1,11 @@
 # Codigest
 
+[![PyPI](https://img.shields.io/pypi/v/codigest)](https://pypi.org/project/codigest/)
+[![Downloads](https://static.pepy.tech/badge/codigest)](https://pepy.tech/project/codigest)
+[![Tests](https://github.com/NaNIsaac/codigest/actions/workflows/tests.yml/badge.svg)](https://github.com/NaNIsaac/codigest/actions/workflows/tests.yml)
+
+<!-- mcp-name: io.github.NaNIsaac/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.
@@ -9,7 +15,8 @@ Unlike simple copy-paste tools, Codigest employs a **Context Anchor** system (Sh
 ## Quickstart
 
 ```bash
-uv tool install codigest
+uvx codigest scan          # try it without installing
+uv tool install codigest  # or install the `cdg` command
 
 cdg scan                  # whole project as LLM-ready XML (copied to clipboard)
 cdg init && cdg diff      # set an anchor, later get only what changed

{codigest-0.4.0 → codigest-0.4.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codigest"
-version = "0.4.0"
+version = "0.4.2"
 description = "Human-Centered Codebase Context Manager for LLMs"
 authors = [{ name = "Isaac Yong", email = "isaacyong@naver.com" }]
 readme = "README.md"

codigest-0.4.2/server.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.NaNIsaac/codigest",
+  "title": "Codigest",
+  "description": "Terminal output, project snapshots and semantic diffs as LLM-ready context",
+  "repository": {
+    "url": "https://github.com/NaNIsaac/codigest",
+    "source": "github"
+  },
+  "version": "0.4.2",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "codigest",
+      "version": "0.4.2",
+      "runtimeHint": "uvx",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ]
+    }
+  ]
+}

{codigest-0.4.0 → codigest-0.4.2}/src/codigest/commands/mcp.py

@@ -97,7 +97,6 @@ def _cli(command: str, args: JSON) -> str:
         argv.append("-r")
     if message := args.get("message"):
         argv += ["-m", message]
-    # Options before positionals: Typer group callbacks require that order.
     match command:
         case "scan":
             argv += [str(t) for t in args.get("targets") or []] or ([args["path"]] if "path" in args else [])

{codigest-0.4.0 → codigest-0.4.2}/src/codigest/commands/term.py

@@ -1,7 +1,9 @@
 """
 `cdg term` -- recall recent terminal commands (and their output) as LLM context.
 """
+import os
 import sys
+import traceback
 from pathlib import Path
 from typing import Annotated
 
@@ -99,13 +101,10 @@ def handle(
                 f"[yellow][Warning][/yellow] No Codigest captures found; "
                 f"falling back to {shell} history [dim](commands only, no output)[/dim]"
             )
-            log.print(
-                "[dim]Capture output with `cdg term install` (PowerShell) "
-                "or `cdg cap -- <command>`.[/dim]"
-            )
+            _diagnose(log)
         else:
             log.print("[yellow]No terminal history available.[/yellow]")
-            log.print("[dim]Try: cdg term install, or cdg cap -- <command>[/dim]")
+            _diagnose(log)
             raise typer.Exit(code=1)
 
     if failed:
@@ -138,6 +137,7 @@ def clear() -> None:
     """Delete all stored terminal captures."""
     console = Console()
     removed = termstore.clear()
+    (termstore.get_term_dir() / "ingest-errors.log").unlink(missing_ok=True)
     console.print(f"[green]Cleared[/green] {removed} captured entries.")
 
 
@@ -151,8 +151,31 @@ def path() -> None:
 @app.command("ingest", hidden=True)
 def ingest() -> None:
     """Store one JSON entry from stdin (called by the shell hook)."""
-    data = json.loads(sys.stdin.buffer.read().decode("utf-8-sig"))
-    termstore.append_entry(termstore.Entry.from_dict(data))
+    try:
+        data = json.loads(sys.stdin.buffer.read().decode("utf-8-sig"))
+        termstore.append_entry(termstore.Entry.from_dict(data))
+    except Exception:
+        # The hook discards our stderr; leave a trail `cdg term` can surface.
+        with _ingest_log().open("a", encoding="utf-8") as f:
+            f.write(f"--- {termstore.now_iso()}\n{traceback.format_exc()}")
+        raise typer.Exit(code=1)
+
+
+def _ingest_log() -> Path:
+    termstore.get_term_dir().mkdir(parents=True, exist_ok=True)
+    return termstore.get_term_dir() / "ingest-errors.log"
+
+
+def _diagnose(log) -> None:
+    """Explains why nothing was captured instead of failing silently."""
+    if not os.environ.get("CODIGEST_HOOK"):
+        log.print(
+            "[dim]Capture hook is not active in this shell. Run `cdg term install` "
+            "and open a new window, or enable it now with:[/dim]"
+        )
+        log.print(f"[dim]  . '{HOOK_PATH}'[/dim]", highlight=False)
+    if (errors := termstore.get_term_dir() / "ingest-errors.log").exists():
+        log.print(f"[red]Capture errors were logged:[/red] {errors}", highlight=False)
 
 
 # --------------------------------------------------------------------------

{codigest-0.4.0 → codigest-0.4.2}/src/codigest/main.py

@@ -19,14 +19,14 @@ app = typer.Typer(
     no_args_is_help=True
 )
 
-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")
-app.add_typer(diff.app, name="diff")
-app.add_typer(semdiff.app, name="semdiff")
+app.command(name="init")(init.handle)
+app.command(name="status")(status.handle)
+app.command(name="clean")(clean.handle)
+app.command(name="scan")(scan.handle)
+app.command(name="tree")(tree.handle)
+app.command(name="digest")(digest.handle)
+app.command(name="diff")(diff.handle)
+app.command(name="semdiff")(semdiff.handle)
 app.add_typer(term.app, name="term")
 
 # `cap` is a plain command, not a group: its first argument is the wrapped

{codigest-0.4.0 → codigest-0.4.2}/src/codigest/shell/hook.ps1

@@ -76,7 +76,8 @@ if (-not (Get-Module PSReadLine)) { return }
 
 # ponytail: denylist heuristic for programs that need a real TTY (editors, pagers,
 # REPLs, ssh). Extend with $env:CODIGEST_CAP_SKIP (a regex) when one slips through.
-$global:__cdgSkip = '^\s*(vim?|nvim|nano|emacs|less|more|ssh|htop|btop|top|fzf|lazygit|claude|codex|wsl|cdg|codigest|exit)(\.exe)?\b' +
+$global:__cdgSkip = '^\s*(vim?|nvim|nano|emacs|less|more|ssh|htop|btop|top|fzf|lazygit|claude|codex|wsl|exit)(\.exe)?\b' +
+    '|^\s*(cdg|codigest)(\.exe)?\s+(term|mcp)\b' +
     '|^\s*(python3?|py|ipython|node|pwsh|powershell|bash|cmd)(\.exe)?\s*$' +
     '|^\s*git\s+(commit(?!.*\s-\w*[mF])|rebase\s+-i|add\s+-[pi]|mergetool)'
 
@@ -114,3 +115,6 @@ Set-PSReadLineOption -AddToHistoryHandler {
     if ($global:__cdgPrevHistHandler) { return $global:__cdgPrevHistHandler.Invoke($l) }
     return $true
 }
+
+# Lets `cdg term` tell whether this shell is hooked.
+$env:CODIGEST_HOOK = '1'

{codigest-0.4.0 → codigest-0.4.2}/uv.lock

@@ -16,7 +16,7 @@ wheels = [
 
 [[package]]
 name = "codigest"
-version = "0.4.0"
+version = "0.4.2"
 source = { editable = "." }
 dependencies = [
     { name = "loguru" },