codigest 0.3.0__tar.gz → 0.3.1__tar.gz

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

@@ -4,8 +4,6 @@ on:
   push:
     tags:
       - 'v*'  # v0.3.0 태그 푸시 시 배포 실행
-    # branches:
-    #   - main  # main 브랜치 푸시 시 문서 배포 실행 (옵션)
 
 jobs:
   build-n-publish:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codigest
-Version: 0.3.0
+Version: 0.3.1
 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.1}/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.1}/pyproject.toml

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

codigest-0.3.1/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.1}/uv.lock

@@ -16,7 +16,7 @@ wheels = [
 
 [[package]]
 name = "codigest"
-version = "0.2.0"
+version = "0.3.0"
 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/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()