graperoot 3.8.69__tar.gz

graperoot-3.8.69/MANIFEST.in

@@ -0,0 +1,3 @@
+recursive-exclude src/graperoot *.py
+include src/graperoot/__init__.py
+include src/graperoot/mcp_graph_server.py

graperoot-3.8.69/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: graperoot
+Version: 3.8.69
+Summary: GrapeRoot — graph-based context engine for AI coding agents
+Author-email: Kunal <kunal12203@users.noreply.github.com>
+License: Proprietary
+Project-URL: Homepage, https://github.com/kunal12203/Codex-CLI-Compact
+Keywords: claude,mcp,code-graph,context,ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Cython
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.3.0
+Requires-Dist: uvicorn>=0.27.0
+Requires-Dist: anyio>=4.0
+Requires-Dist: starlette>=0.36.0
+
+# Dual-Graph — Compounding Context for Claude Code & Codex CLI
+
+A context engine that makes Claude Code and Codex CLI **30-45% cheaper** without sacrificing quality. It builds a semantic graph of your codebase and pre-loads the right files into every prompt — so Claude spends tokens reasoning, not exploring.
+
+Works on **macOS, Linux, and Windows**. Supports any project size.
+
+**Join the community: [discord.gg/rxgVVgCh](https://discord.gg/rxgVVgCh)**
+
+---
+
+## How It Works
+
+```
+You run: dgc /path/to/project
+         ↓
+1. Project scanned → semantic graph built (files, symbols, imports)
+2. You ask a question
+3. Graph identifies the relevant files → packs them into context
+4. Claude gets your question + the right code already loaded
+5. Fewer turns, fewer tokens, better answers
+```
+
+Token savings **compound** across a session. The graph remembers which files were read, edited, and queried — each turn gets cheaper.
+
+---
+
+## Results
+
+Benchmarked across 80+ prompts (5 complexity levels) on a real-world full-stack app:
+
+| Metric | Without Dual-Graph | With Dual-Graph |
+|--------|-------------------|-----------------|
+| Avg cost per prompt | $0.46 | **$0.27** |
+| Avg turns | 16.8 | **10.3** |
+| Avg response time | 186s | **134s** |
+| Quality (regex scorer) | 82.7/100 | **87.1/100** |
+
+Cost wins on **16 out of 20** prompts. Quality equal or better on all complexity levels.
+
+---
+
+## Install
+
+**macOS / Linux:**
+```bash
+curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bash
+source ~/.zshrc   # or ~/.bashrc / ~/.profile
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.ps1 | iex
+```
+
+**Windows (Scoop):**
+```powershell
+scoop bucket add dual-graph https://github.com/kunal12203/scoop-dual-graph
+scoop install dual-graph
+```
+
+**Prerequisites:** Python 3.10+, Node.js 18+, Claude Code or Codex CLI. The installer detects missing tools and offers to install them via winget (Windows) or homebrew (macOS).
+
+---
+
+## Usage
+
+### Claude Code (`dgc`)
+
+```bash
+dgc                              # scan current directory, launch Claude
+dgc /path/to/project             # scan a specific project
+dgc /path/to/project "fix the login bug"   # start with a prompt
+```
+
+### Codex CLI (`dg`)
+
+```bash
+dg                               # scan current directory, launch Codex
+dg /path/to/project              # scan a specific project
+dg /path/to/project "add tests"  # start with a prompt
+```
+
+### Windows
+
+```powershell
+dgc .                            # from inside the project directory
+dgc "D:\projects\my-app"         # any drive, any path
+dg "C:\work\backend"             # Codex CLI
+```
+
+---
+
+## What It Does Under the Hood
+
+1. **Scans your project** — extracts files, functions, classes, import relationships into a local graph.
+2. **Pre-loads context** — when you ask a question, the graph ranks relevant files and packs them into the prompt before Claude sees it. No extra tool calls needed.
+3. **Remembers across turns** — files you've read or edited are prioritized in future turns. Context compounds.
+4. **MCP tools available** — Claude can still explore the codebase via graph-aware tools (`graph_read`, `graph_retrieve`, `graph_neighbors`, etc.) when it needs to go deeper.
+
+All processing is local. No code leaves your machine.
+
+---
+
+## Data & Files
+
+All data lives in `<project>/.dual-graph/` (gitignored automatically).
+
+| File | Description |
+|---|---|
+| `info_graph.json` | Semantic graph of the project: files, symbols, edges |
+| `chat_action_graph.json` | Session memory: reads, edits, queries, decisions |
+| `context-store.json` | Persistent store for decisions/tasks/facts across sessions |
+| `mcp_server.log` | MCP server logs |
+
+Global files in `~/.dual-graph/`:
+| File | Description |
+|---|---|
+| `dgc.ps1` / `dg.ps1` | Launcher scripts (auto-updated) |
+| `venv/` | Python virtual environment for dependencies |
+| `version.txt` | Current installed version |
+
+---
+
+## Configuration
+
+All optional, via environment variables:
+
+| Variable | Default | Description |
+|---|---|---|
+| `DG_HARD_MAX_READ_CHARS` | `4000` | Max characters per file read |
+| `DG_TURN_READ_BUDGET_CHARS` | `18000` | Total read budget per turn |
+| `DG_FALLBACK_MAX_CALLS_PER_TURN` | `1` | Max fallback grep calls per turn |
+| `DG_RETRIEVE_CACHE_TTL_SEC` | `900` | Retrieval cache TTL (15 min) |
+| `DG_MCP_PORT` | auto (8080-8099) | Force a specific MCP server port |
+
+---
+
+## Context Store
+
+Decisions, tasks, and facts from your sessions are persisted in `.dual-graph/context-store.json` and re-injected at the start of the next session. This gives Claude continuity across conversations.
+
+You can also create a `CONTEXT.md` in your project root for free-form session notes.
+
+---
+
+## Token Tracking
+
+A token-counter dashboard is registered automatically with Claude Code:
+
+```
+http://localhost:8899
+```
+
+Usage from inside a Claude session:
+```
+count_tokens({text: "<content>"})   # estimate tokens before reading
+get_session_stats()                  # running session cost
+```
+
+---
+
+## Self-Update
+
+The launcher checks for updates on every run and auto-updates if a new version is available. No manual intervention needed.
+
+Current version: **3.8.55**
+
+---
+
+## Privacy & Security
+
+- **All project data stays local.** Graphs, session data, and code never leave your machine.
+- The only outbound calls are:
+  - **Version check** — fetches a version string (no project data).
+  - **Heartbeat** — sends `machine_id` and `platform` only. No file names, no code.
+  - **One-time feedback** — optional rating after first day of use.
+- `.dual-graph/` is automatically added to `.gitignore`.
+
+---
+
+## Community
+
+Have a question, found a bug, or want to share feedback?
+
+**Join the Discord: [discord.gg/rxgVVgCh](https://discord.gg/rxgVVgCh)**
+
+- Get help with setup
+- Report bugs
+- Share workflows
+- Follow releases

graperoot-3.8.69/README.md

@@ -0,0 +1,190 @@
+# Dual-Graph — Compounding Context for Claude Code & Codex CLI
+
+A context engine that makes Claude Code and Codex CLI **30-45% cheaper** without sacrificing quality. It builds a semantic graph of your codebase and pre-loads the right files into every prompt — so Claude spends tokens reasoning, not exploring.
+
+Works on **macOS, Linux, and Windows**. Supports any project size.
+
+**Join the community: [discord.gg/rxgVVgCh](https://discord.gg/rxgVVgCh)**
+
+---
+
+## How It Works
+
+```
+You run: dgc /path/to/project
+         ↓
+1. Project scanned → semantic graph built (files, symbols, imports)
+2. You ask a question
+3. Graph identifies the relevant files → packs them into context
+4. Claude gets your question + the right code already loaded
+5. Fewer turns, fewer tokens, better answers
+```
+
+Token savings **compound** across a session. The graph remembers which files were read, edited, and queried — each turn gets cheaper.
+
+---
+
+## Results
+
+Benchmarked across 80+ prompts (5 complexity levels) on a real-world full-stack app:
+
+| Metric | Without Dual-Graph | With Dual-Graph |
+|--------|-------------------|-----------------|
+| Avg cost per prompt | $0.46 | **$0.27** |
+| Avg turns | 16.8 | **10.3** |
+| Avg response time | 186s | **134s** |
+| Quality (regex scorer) | 82.7/100 | **87.1/100** |
+
+Cost wins on **16 out of 20** prompts. Quality equal or better on all complexity levels.
+
+---
+
+## Install
+
+**macOS / Linux:**
+```bash
+curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bash
+source ~/.zshrc   # or ~/.bashrc / ~/.profile
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.ps1 | iex
+```
+
+**Windows (Scoop):**
+```powershell
+scoop bucket add dual-graph https://github.com/kunal12203/scoop-dual-graph
+scoop install dual-graph
+```
+
+**Prerequisites:** Python 3.10+, Node.js 18+, Claude Code or Codex CLI. The installer detects missing tools and offers to install them via winget (Windows) or homebrew (macOS).
+
+---
+
+## Usage
+
+### Claude Code (`dgc`)
+
+```bash
+dgc                              # scan current directory, launch Claude
+dgc /path/to/project             # scan a specific project
+dgc /path/to/project "fix the login bug"   # start with a prompt
+```
+
+### Codex CLI (`dg`)
+
+```bash
+dg                               # scan current directory, launch Codex
+dg /path/to/project              # scan a specific project
+dg /path/to/project "add tests"  # start with a prompt
+```
+
+### Windows
+
+```powershell
+dgc .                            # from inside the project directory
+dgc "D:\projects\my-app"         # any drive, any path
+dg "C:\work\backend"             # Codex CLI
+```
+
+---
+
+## What It Does Under the Hood
+
+1. **Scans your project** — extracts files, functions, classes, import relationships into a local graph.
+2. **Pre-loads context** — when you ask a question, the graph ranks relevant files and packs them into the prompt before Claude sees it. No extra tool calls needed.
+3. **Remembers across turns** — files you've read or edited are prioritized in future turns. Context compounds.
+4. **MCP tools available** — Claude can still explore the codebase via graph-aware tools (`graph_read`, `graph_retrieve`, `graph_neighbors`, etc.) when it needs to go deeper.
+
+All processing is local. No code leaves your machine.
+
+---
+
+## Data & Files
+
+All data lives in `<project>/.dual-graph/` (gitignored automatically).
+
+| File | Description |
+|---|---|
+| `info_graph.json` | Semantic graph of the project: files, symbols, edges |
+| `chat_action_graph.json` | Session memory: reads, edits, queries, decisions |
+| `context-store.json` | Persistent store for decisions/tasks/facts across sessions |
+| `mcp_server.log` | MCP server logs |
+
+Global files in `~/.dual-graph/`:
+| File | Description |
+|---|---|
+| `dgc.ps1` / `dg.ps1` | Launcher scripts (auto-updated) |
+| `venv/` | Python virtual environment for dependencies |
+| `version.txt` | Current installed version |
+
+---
+
+## Configuration
+
+All optional, via environment variables:
+
+| Variable | Default | Description |
+|---|---|---|
+| `DG_HARD_MAX_READ_CHARS` | `4000` | Max characters per file read |
+| `DG_TURN_READ_BUDGET_CHARS` | `18000` | Total read budget per turn |
+| `DG_FALLBACK_MAX_CALLS_PER_TURN` | `1` | Max fallback grep calls per turn |
+| `DG_RETRIEVE_CACHE_TTL_SEC` | `900` | Retrieval cache TTL (15 min) |
+| `DG_MCP_PORT` | auto (8080-8099) | Force a specific MCP server port |
+
+---
+
+## Context Store
+
+Decisions, tasks, and facts from your sessions are persisted in `.dual-graph/context-store.json` and re-injected at the start of the next session. This gives Claude continuity across conversations.
+
+You can also create a `CONTEXT.md` in your project root for free-form session notes.
+
+---
+
+## Token Tracking
+
+A token-counter dashboard is registered automatically with Claude Code:
+
+```
+http://localhost:8899
+```
+
+Usage from inside a Claude session:
+```
+count_tokens({text: "<content>"})   # estimate tokens before reading
+get_session_stats()                  # running session cost
+```
+
+---
+
+## Self-Update
+
+The launcher checks for updates on every run and auto-updates if a new version is available. No manual intervention needed.
+
+Current version: **3.8.55**
+
+---
+
+## Privacy & Security
+
+- **All project data stays local.** Graphs, session data, and code never leave your machine.
+- The only outbound calls are:
+  - **Version check** — fetches a version string (no project data).
+  - **Heartbeat** — sends `machine_id` and `platform` only. No file names, no code.
+  - **One-time feedback** — optional rating after first day of use.
+- `.dual-graph/` is automatically added to `.gitignore`.
+
+---
+
+## Community
+
+Have a question, found a bug, or want to share feedback?
+
+**Join the Discord: [discord.gg/rxgVVgCh](https://discord.gg/rxgVVgCh)**
+
+- Get help with setup
+- Report bugs
+- Share workflows
+- Follow releases

graperoot-3.8.69/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel", "Cython>=3.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "graperoot"
+version = "3.8.69"
+description = "GrapeRoot — graph-based context engine for AI coding agents"
+readme = "README.md"
+license = {text = "Proprietary"}
+requires-python = ">=3.10"
+authors = [
+    {name = "Kunal", email = "kunal12203@users.noreply.github.com"}
+]
+keywords = ["claude", "mcp", "code-graph", "context", "ai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Cython",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    "mcp>=1.3.0",
+    "uvicorn>=0.27.0",
+    "anyio>=4.0",
+    "starlette>=0.36.0",
+]
+
+[project.scripts]
+graph-builder = "graperoot.graph_builder:main"
+dg = "graperoot.dg:main"
+context-packer = "graperoot.context_packer:main"
+dgc-claude = "graperoot.dgc_claude:main"
+mcp-graph-server = "graperoot.mcp_graph_server:main"
+
+[project.urls]
+Homepage = "https://github.com/kunal12203/Codex-CLI-Compact"
+
+[tool.setuptools.packages.find]
+where = ["src"]

graperoot-3.8.69/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

graperoot-3.8.69/setup.py

@@ -0,0 +1,69 @@
+"""Cython build configuration for dual-graph.
+
+Compiles core .py modules to native C extensions (.so / .pyd).
+mcp_graph_server is excluded (async decorators incompatible with Cython).
+Strips .py source and .c intermediates from the wheel.
+"""
+import os
+import shutil
+from setuptools import setup, Extension
+from setuptools.command.build_ext import build_ext as _build_ext
+from Cython.Build import cythonize
+
+# Core modules — no async frameworks, pure stdlib + internal imports
+COMPILED_MODULES = [
+    "graph_builder",
+    "dg",
+    "context_packer",
+    "dgc_claude",
+]
+
+modules = [f"src/graperoot/{m}.py" for m in COMPILED_MODULES]
+
+extensions = [
+    Extension(
+        name=f"graperoot.{mod.split('/')[-1].replace('.py', '')}",
+        sources=[mod],
+    )
+    for mod in modules
+]
+
+
+class build_ext(_build_ext):
+    """After building extensions, remove .py and .c files from build dir."""
+    def run(self):
+        super().run()
+        # Find the build lib directory
+        build_lib = self.build_lib
+        pkg_dir = os.path.join(build_lib, "graperoot")
+        if not os.path.isdir(pkg_dir):
+            return
+        for name in COMPILED_MODULES:
+            # Remove .py source (keep only .so/.pyd)
+            py_file = os.path.join(pkg_dir, f"{name}.py")
+            if os.path.exists(py_file):
+                os.remove(py_file)
+            # Remove .c intermediate
+            c_file = os.path.join(pkg_dir, f"{name}.c")
+            if os.path.exists(c_file):
+                os.remove(c_file)
+        # Also remove .c from src/ so they don't get picked up
+        src_dir = os.path.join(os.path.dirname(__file__), "src", "graperoot")
+        for name in COMPILED_MODULES + ["mcp_graph_server"]:
+            c_file = os.path.join(src_dir, f"{name}.c")
+            if os.path.exists(c_file):
+                os.remove(c_file)
+
+
+setup(
+    ext_modules=cythonize(
+        extensions,
+        compiler_directives={
+            "language_level": "3",
+            "embedsignature": False,
+            "emit_code_comments": False,
+        },
+        nthreads=0,
+    ),
+    cmdclass={"build_ext": build_ext},
+)

graperoot-3.8.69/src/graperoot/__init__.py

@@ -0,0 +1,2 @@
+"""Dual-graph context engine for AI coding agents."""
+__version__ = "3.8.69"