codigest 0.4.1__tar.gz → 0.4.3__tar.gz

codigest-0.4.3/.github/workflows/publish.yml

@@ -0,0 +1,51 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  pypi:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write  # PyPI Trusted Publishing
+      contents: read
+    steps:
+    - uses: actions/checkout@v7
+    - uses: astral-sh/setup-uv@v10.3.0
+    - run: uv python install 3.15
+    - run: uv build
+    - uses: pypa/gh-action-pypi-publish@release/v1
+
+  mcp:
+    name: Publish to the MCP registry
+    needs: pypi
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # GitHub OIDC login for io.github.NaNIsaac/*
+      contents: read
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set server.json version from the tag
+      run: |
+        VERSION="${GITHUB_REF_NAME#v}"
+        jq --arg v "$VERSION" '.version = $v | .packages[0].version = $v' server.json > server.tmp
+        mv server.tmp server.json
+        # The registry verifies the package on PyPI; wait until the release is visible.
+        for i in $(seq 30); do
+          curl -sf "https://pypi.org/pypi/codigest/$VERSION/json" > /dev/null && exit 0
+          sleep 10
+        done
+        echo "codigest $VERSION not visible on PyPI" && exit 1
+
+    - name: Install mcp-publisher
+      run: curl -sL https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_linux_amd64.tar.gz | tar xz mcp-publisher
+
+    - name: Publish
+      run: |
+        ./mcp-publisher login github-oidc
+        ./mcp-publisher publish

codigest-0.4.3/.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@v7
+      - uses: astral-sh/setup-uv@v10.3.0
+      - run: uv python install 3.15
+      - run: uv run --with pytest pytest -q

{codigest-0.4.1 → codigest-0.4.3}/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.1
+version: 0.4.3
 date-released: "2026-10-15"
 keywords:
   - LLM

{codigest-0.4.1 → codigest-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codigest
-Version: 0.4.1
+Version: 0.4.3
 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
@@ -231,6 +238,7 @@ cdg term            # last command
 cdg term -n 3       # last 3 commands
 cdg term -i 2       # only the command from 2 runs ago
 cdg term -f         # last failed command
+cdg term --here -n 3  # last 3 commands run in this project
 
 cdg term path       # where captures are stored (override with CODIGEST_HOME)
 cdg term clear      # delete all captures
@@ -242,7 +250,7 @@ cdg term clear      # delete all captures
 
 | Tool | Returns |
 | --- | --- |
-| `terminal_history` | Recent commands with output and exit code (`count`, `failed`) |
+| `terminal_history` | Recent commands with output and exit code (`count`, `failed`, `here`: only this project, default on) |
 | `scan` | Project snapshot (`targets`, `resolve`, `message`) |
 | `diff` / `semdiff` | Text / structural changes since the anchor |
 | `digest` | Signatures and docstrings only |

{codigest-0.4.1 → codigest-0.4.3}/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
@@ -205,6 +212,7 @@ cdg term            # last command
 cdg term -n 3       # last 3 commands
 cdg term -i 2       # only the command from 2 runs ago
 cdg term -f         # last failed command
+cdg term --here -n 3  # last 3 commands run in this project
 
 cdg term path       # where captures are stored (override with CODIGEST_HOME)
 cdg term clear      # delete all captures
@@ -216,7 +224,7 @@ cdg term clear      # delete all captures
 
 | Tool | Returns |
 | --- | --- |
-| `terminal_history` | Recent commands with output and exit code (`count`, `failed`) |
+| `terminal_history` | Recent commands with output and exit code (`count`, `failed`, `here`: only this project, default on) |
 | `scan` | Project snapshot (`targets`, `resolve`, `message`) |
 | `diff` / `semdiff` | Text / structural changes since the anchor |
 | `digest` | Signatures and docstrings only |

{codigest-0.4.1 → codigest-0.4.3}/pyproject.toml

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

codigest-0.4.3/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.3",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "codigest",
+      "version": "0.4.3",
+      "runtimeHint": "uvx",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ]
+    }
+  ]
+}

{codigest-0.4.1 → codigest-0.4.3}/src/codigest/commands/mcp.py

@@ -15,6 +15,7 @@ exactly what a human would paste, and stdout stays clean for the protocol.
 import json
 import subprocess
 import sys
+from pathlib import Path
 from importlib.metadata import PackageNotFoundError, version
 from typing import Any
 
@@ -40,6 +41,11 @@ TOOLS: list[JSON] = [
             "properties": {
                 "count": {"type": "integer", "minimum": 1, "default": 1, "description": "How many recent commands"},
                 "failed": {"type": "boolean", "default": False, "description": "Only commands that exited non-zero"},
+                "here": {
+                    "type": "boolean",
+                    "default": True,
+                    "description": "Only commands run in the server's working directory (the project) or below",
+                },
             },
         },
     },
@@ -81,12 +87,12 @@ TOOLS: list[JSON] = [
 
 def _terminal_history(args: JSON) -> str:
     count = int(args.get("count", 1))
-    entries = termstore.load_entries()
-    if args.get("failed"):
-        entries = [e for e in entries if e.exit_code not in (None, 0)]
-    if not entries:
+    if not (entries := termstore.load_entries()):
+        # Nothing captured at all: native shell history still names the commands.
         entries, _ = shellhist.read_recent(count)
-    return termstore.render(entries[-count:])
+        return termstore.render(entries)
+    under = Path.cwd() if args.get("here", True) else None
+    return termstore.render(termstore.select(entries, failed=bool(args.get("failed")), under=under)[-count:])
 
 
 def _cli(command: str, args: JSON) -> str:

{codigest-0.4.1 → codigest-0.4.3}/src/codigest/commands/term.py

@@ -40,6 +40,11 @@ FailedOption = Annotated[
     typer.Option("-f", "--failed", help="Only commands that exited non-zero"),
 ]
 
+HereOption = Annotated[
+    bool,
+    typer.Option("--here", help="Only commands run in the current directory or below"),
+]
+
 HistoryOnlyOption = Annotated[
     bool,
     typer.Option(
@@ -68,6 +73,7 @@ def handle(
     count: CountOption = 1,
     index: IndexOption = None,
     failed: FailedOption = False,
+    here: HereOption = False,
     history_only: HistoryOnlyOption = False,
     copy: CopyOption = True,
     stdout: StdoutOption = False,
@@ -80,6 +86,7 @@ def handle(
         cdg term -n 3       # the last 3 commands
         cdg term -i 3       # only the command from 3 runs ago
         cdg term -f         # the last failed command
+        cdg term --here -n 3  # the last 3 commands run in this project
     """
     if ctx.invoked_subcommand:
         return
@@ -107,10 +114,11 @@ def handle(
             _diagnose(log)
             raise typer.Exit(code=1)
 
-    if failed:
-        entries = [e for e in entries if e.exit_code not in (None, 0)]
+    if failed or here:
+        entries = termstore.select(entries, failed=failed, under=Path.cwd() if here else None)
         if not entries:
-            log.print("[yellow]No failed commands captured.[/yellow]")
+            what = " and ".join(w for w, on in (("failed", failed), ("in this directory", here)) if on)
+            log.print(f"[yellow]No captured commands match ({what}).[/yellow]")
             raise typer.Exit(code=1)
 
     if index:

{codigest-0.4.1 → codigest-0.4.3}/src/codigest/core/termstore.py

@@ -131,6 +131,20 @@ def _truncate(text: str) -> tuple[str, bool]:
 # Read / write
 # --------------------------------------------------------------------------
 
+def _inside(path: str, root: Path) -> bool:
+    path, base = (os.path.normcase(os.path.abspath(p)) for p in (path, root))
+    return path == base or path.startswith(base.rstrip(os.sep) + os.sep)
+
+
+def select(entries: list[Entry], *, failed: bool = False, under: Path | None = None) -> list[Entry]:
+    """Keeps entries that exited non-zero (`failed`) and/or ran inside `under` or below it."""
+    if failed:
+        entries = [e for e in entries if e.exit_code not in (None, 0)]
+    if under is not None:
+        entries = [e for e in entries if e.cwd and _inside(e.cwd, under)]
+    return entries
+
+
 def load_entries() -> list[Entry]:
     """Loads all stored entries, oldest first. Corrupt lines are skipped."""
     path = get_history_path()
@@ -183,7 +197,7 @@ def _trim(path: Path) -> None:
     """Rewrites the log keeping only the most recent MAX_ENTRIES lines."""
     with open(path, "r", encoding="utf-8", errors="replace") as f:
         lines = f.readlines()
-    # ponytail: no file lock. Concurrent hook ingests can drop an entry appended
+    # No file lock: Concurrent hook ingests can drop an entry appended
     # between read and replace; the slack makes rewrites (and that window) rare.
     if len(lines) <= MAX_ENTRIES + _TRIM_SLACK:
         return

{codigest-0.4.1 → codigest-0.4.3}/src/codigest/shell/hook.ps1

@@ -74,7 +74,7 @@ if (-not (Get-Module PSReadLine) -and $Host.Name -eq 'ConsoleHost') {
 }
 if (-not (Get-Module PSReadLine)) { return }
 
-# ponytail: denylist heuristic for programs that need a real TTY (editors, pagers,
+# 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|exit)(\.exe)?\b' +
     '|^\s*(cdg|codigest)(\.exe)?\s+(term|mcp)\b' +

{codigest-0.4.1 → codigest-0.4.3}/tests/test_termstore.py

@@ -32,6 +32,20 @@ def test_mcp_lists_tools_and_ignores_notifications():
     assert mcp.handle_message({"jsonrpc": "2.0", "id": 2, "method": "nope"})["error"]["code"] == -32601
 
 
+
+def test_select_filters_failed_and_directory(tmp_path):
+    project, other = tmp_path / "proj", tmp_path / "proj-other"
+    entries = [
+        Entry(command="a", exit_code=1, cwd=str(project / "sub")),
+        Entry(command="b", exit_code=0, cwd=str(project)),
+        Entry(command="c", exit_code=2, cwd=str(other)),  # shares the prefix, not the directory
+        Entry(command="d", exit_code=None, cwd=""),
+    ]
+    assert [e.command for e in termstore.select(entries, under=project)] == ["a", "b"]
+    assert [e.command for e in termstore.select(entries, failed=True)] == ["a", "c"]
+    assert [e.command for e in termstore.select(entries, failed=True, under=project)] == ["a"]
+
+
 if __name__ == "__main__":
     test_crlf_output_survives_normalization()
     test_progress_redraw_keeps_last_frame()

{codigest-0.4.1 → codigest-0.4.3}/uv.lock

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

codigest-0.4.1/.github/workflows/publish.yml

@@ -1,73 +0,0 @@
-name: Publish Python distributions to PyPI and GitHub Pages
-
-on:
-  push:
-    tags:
-      - 'v*'  # v0.3.0 태그 푸시 시 배포 실행
-
-jobs:
-  build-n-publish:
-    name: Build and publish Python distributions to PyPI
-    runs-on: ubuntu-latest
-    # v* 태그일 때만 실행
-    if: startsWith(github.ref, 'refs/tags/v')
-    environment: release
-    permissions:
-      id-token: write  # Trusted Publishing을 위한 필수 권한
-      contents: read
-    
-    steps:
-    - uses: actions/checkout@v4
-    
-    # uv 설치 (가장 빠르고 확실한 방법)
-    - name: Install uv
-      uses: astral-sh/setup-uv@v5
-    
-    # Python 3.14 설정 (uv 이용)
-    - name: Set up Python
-      run: uv python install 3.15
-    
-    # 의존성 설치 및 빌드 (uv build 하나로 해결)
-    - name: Build package
-      run: uv build
-    
-    # PyPI 배포 (기존 형식 유지)
-    - name: Publish package distributions to PyPI
-      uses: pypa/gh-action-pypi-publish@release/v1
-
-  deploy-docs:
-    name: Build and deploy Sphinx docs to GitHub Pages
-    runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/main'
-    permissions:
-      contents: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
-
-      - name: Set up Python
-        run: uv python install 3.15
-
-      - name: Install Python and Sphinx dependencies
-        run: |
-          uv pip install --system --upgrade pip
-          if [ -f docs/requirements.txt ]; then uv pip install --system -r docs/requirements.txt; fi
-
-      - name: Build HTML docs with Sphinx
-        run: |
-          if [ -d "docs" ]; then
-            sphinx-build -b html docs/source docs/html
-            touch docs/html/.nojekyll
-          else
-            echo "No docs folder found, skipping build."
-            mkdir -p docs/html
-            touch docs/html/.nojekyll
-          fi
-
-      - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: docs/html