codedd-cli 0.1.0__tar.gz

codedd_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CodeDD Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codedd_cli-0.1.0/PKG-INFO

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: codedd-cli
+Version: 0.1.0
+Summary: CLI tool for CodeDD — run code audits from your terminal
+License: MIT
+License-File: LICENSE
+Keywords: code-audit,security,cli,codedd
+Author: CodeDD
+Author-email: support@codedd.ai
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Dist: httpx (>=0.27.0)
+Requires-Dist: keyring (>=25.0.0)
+Requires-Dist: lizard (>=1.17.0)
+Requires-Dist: radon (>=6.0.0)
+Requires-Dist: rich (>=13.0.0)
+Requires-Dist: tomli (>=2.0.0) ; python_version < "3.11"
+Requires-Dist: tomli-w (>=1.0.0)
+Requires-Dist: typer[all] (>=0.9.0)
+Project-URL: Homepage, https://codedd.ai
+Project-URL: Repository, https://github.com/codedd/codedd-cli
+Description-Content-Type: text/markdown
+
+# CodeDD CLI
+
+**Run code audits from your terminal.** The CodeDD CLI lets you define scope locally, run file-level and complexity analysis on your machine (using your own LLM API keys), and sync results to [CodeDD](https://codedd.ai) for consolidation, recommendations, and dashboards.
+
+---
+
+## What is CodeDD CLI?
+
+CodeDD CLI is the official command-line interface for the CodeDD platform. You:
+
+- **Define scope** — Add one or more local Git repository roots to an audit.
+- **Run analysis locally** — File audits (LLM-based) and complexity metrics run on your machine; only metadata and results are sent to CodeDD.
+- **Sync to CodeDD** — Scope metadata, audit results, complexity data, dependencies, and architecture are submitted to CodeDD, where consolidation, dependency enrichment, security scoring, and recommendations run on the server.
+
+Ideal for teams who want to keep source code local while still using CodeDD’s analytics, recommendations, and reporting.
+
+---
+
+## Features
+
+- **Scope management** — Add/remove local directories, sync with CodeDD, detect changes and re-confirm scope (delta updates).
+- **Local file auditing** — LLM-based file analysis using your Anthropic or OpenAI API keys; supports batching and progress feedback.
+- **Complexity analysis** — Cyclomatic complexity and Halstead metrics (Radon/Lizard) run locally and are submitted to CodeDD.
+- **Dependency scanning** — Local lockfile/manifest and import parsing; dependency data is sent to CodeDD for vulnerability and license analysis.
+- **Architecture analysis** — Local component/relationship extraction with optional LLM enhancement; Phase 3 synthesis and storage on CodeDD.
+- **Payment and budget** — Pre-flight checks, LoC budget deduction, or Stripe checkout when additional payment is required.
+- **Secure auth** — CLI tokens stored in the OS credential store (Windows Credential Locker, macOS Keychain, Linux Secret Service).
+
+---
+
+## Installation
+
+### Requirements
+
+- **Python 3.10+**
+- A [CodeDD](https://codedd.ai) account and a CLI token (Account → CLI Access → Generate Token)
+
+### From source (development)
+
+```bash
+git clone https://github.com/codedd/codedd-cli.git
+cd codedd-cli
+pip install -e .
+```
+
+### From PyPI (when available)
+
+```bash
+pip install codedd-cli
+```
+
+Verify:
+
+```bash
+codedd --version
+```
+
+---
+
+## Quick start
+
+### 1. Authenticate
+
+Generate a CLI token at [codedd.ai](https://codedd.ai) (Account → CLI Access), then:
+
+```bash
+codedd auth login --token <your_token>
+```
+
+Or run `codedd auth login` and paste the token when prompted.
+
+### 2. Select an audit
+
+```bash
+codedd audits list
+codedd audits select
+```
+
+Choose a **group audit** (multiple repos) or a **single audit** (one repo). The selected audit becomes the active context for scope and audit commands.
+
+### 3. Define scope
+
+Add the local paths that correspond to the audit’s repositories (each must be a Git repo root):
+
+```bash
+codedd scope add /path/to/my-repo
+codedd scope list
+codedd scope confirm
+```
+
+`scope confirm` scans the directories, shows a preview (files, LoC), and registers scope with CodeDD. If you change files later, run `codedd audit start` — it will offer to re-sync scope (delta update) before starting.
+
+### 4. Run an audit
+
+Configure at least one LLM API key (used for file-level auditing):
+
+```bash
+codedd config set-key anthropic
+# or: codedd config set-key openai
+```
+
+Then start the audit:
+
+```bash
+codedd audit start
+```
+
+The CLI will:
+
+- Sync scope with CodeDD (and prompt to re-confirm if local files changed).
+- Run pre-flight checks (payment, LoC budget).
+- Optionally open payment in the browser or deduct from budget.
+- Fetch the audit plan, run file auditing and complexity analysis locally, submit results, submit dependencies, submit architecture, and trigger server-side post-processing (consolidation, recommendations, completion email).
+
+Results and recommendations are available in the CodeDD dashboard; you can also run `codedd audits list` to see status.
+
+---
+
+## Workflow overview
+
+High-level flow:
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  LOCAL                                                                       │
+│  1. codedd audits select     → Pick audit (group or single)                 │
+│  2. codedd scope add <path>  → Add repo root(s)                              │
+│  3. codedd scope confirm      → Scan & register scope with CodeDD            │
+│  4. codedd audit start        → Sync (if needed) → Pre-flight → Pay/budget   │
+│     └─ File audit (LLM)       → Local                                        │
+│     └─ Complexity            → Local                                        │
+│     └─ Submit results        → CodeDD                                       │
+│     └─ Dependencies          → Local scan → Submit → CodeDD                │
+│     └─ Architecture          → Local phases → Submit → CodeDD               │
+│     └─ Complete              → CodeDD runs consolidation & recommendations   │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+| Step              | Where it runs | What happens |
+|-------------------|---------------|--------------|
+| Scope add/confirm | Local         | Scan dirs, count files/LoC; register or delta-update scope on CodeDD. |
+| Pre-flight        | CodeDD        | Check payment, budget, status. |
+| File audit        | Local         | LLM (Anthropic/OpenAI) analyses each file; results sent to CodeDD. |
+| Complexity        | Local         | Radon/Lizard; metrics sent to CodeDD. |
+| Dependencies      | Local + CodeDD| Lockfiles/imports sent; CodeDD does metadata, vulns, licenses. |
+| Architecture     | Local + CodeDD| Components/relations sent; CodeDD does Phase 3 and storage. |
+| Recommendations   | CodeDD        | Consolidation, technical debt, security, licenses, etc. |
+
+---
+
+## Commands reference
+
+### Authentication
+
+| Command | Description |
+|--------|-------------|
+| `codedd auth login` | Log in with a CLI token (prompt or `--token`) |
+| `codedd auth logout` | Clear stored credentials |
+| `codedd auth status` | Show current account and token state |
+
+### Audits
+
+| Command | Description |
+|--------|-------------|
+| `codedd audits list` | List audits (`--type single\|group`, `--limit`, `--page`) |
+| `codedd audits select [uuid]` | Set active audit (interactive if UUID omitted) |
+
+### Scope
+
+| Command | Description |
+|--------|-------------|
+| `codedd scope add <path> [path ...]` | Add Git repository root(s) to the active audit’s scope |
+| `codedd scope remove <n>` | Remove directory by list number |
+| `codedd scope list` | List directories in scope |
+| `codedd scope clear` | Remove all directories from scope |
+| `codedd scope status` | Show scope and sync state per directory |
+| `codedd scope confirm` | Scan, preview, and register scope with CodeDD |
+| `codedd scope sync` | Compare local vs CodeDD and show changes |
+
+### Audit execution
+
+| Command | Description |
+|--------|-------------|
+| `codedd audit start` | Sync scope (if needed), pre-flight, pay/budget, then run full local audit and submit to CodeDD. Use `--skip-sync` to skip scope sync; `--yes` to auto-confirm; `--debug-llm` for LLM debug output. |
+
+### Configuration
+
+| Command | Description |
+|--------|-------------|
+| `codedd config show` | Show current config (API URL, active audit, scope, etc.) |
+| `codedd config set <key> <value>` | Set a config value |
+| `codedd config set-key [anthropic\|openai]` | Store an LLM API key in the OS keychain |
+| `codedd config show-keys` | List which providers have keys configured (not the keys themselves) |
+| `codedd config provider [anthropic\|openai\|both]` | Set preferred LLM provider |
+| `codedd config concurrency <n>` | Set max concurrent LLM requests (default 6) |
+
+---
+
+## Configuration
+
+- **Config file:** `~/.codedd/config.toml` (TOML). Stores API URL, active audit, scope directories, LLM provider, concurrency. Permissions are restricted to the owner (Unix).
+- **Secrets:** The CLI token and LLM API keys are stored in the system keychain (Windows Credential Locker, macOS Keychain, Linux Secret Service), not in the config file.
+
+### Environment variables
+
+| Variable | Purpose |
+|---------|---------|
+| `CODEDD_API_TOKEN` | Override the stored CLI token (e.g. for CI) |
+| `CODEDD_API_URL`   | Override API base URL (default from config) |
+
+---
+
+## Security
+
+- CLI tokens and LLM keys are stored in the OS credential store, not in plaintext on disk.
+- TLS certificate verification is always enabled for API requests.
+- Config file and `~/.codedd` directory use owner-only permissions where supported.
+- Tokens expire after 90 days (server-configurable); re-generate from the CodeDD dashboard when needed.
+
+---
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+ruff check .
+```
+
+---
+
+## License
+
+MIT License — see [LICENSE](LICENSE).
+
+---
+
+## Support
+
+- **Issues:** [GitHub Issues](https://github.com/codedd/codedd-cli/issues)
+- **Product:** [CodeDD](https://codedd.ai)
+

codedd_cli-0.1.0/README.md

@@ -0,0 +1,241 @@
+# CodeDD CLI
+
+**Run code audits from your terminal.** The CodeDD CLI lets you define scope locally, run file-level and complexity analysis on your machine (using your own LLM API keys), and sync results to [CodeDD](https://codedd.ai) for consolidation, recommendations, and dashboards.
+
+---
+
+## What is CodeDD CLI?
+
+CodeDD CLI is the official command-line interface for the CodeDD platform. You:
+
+- **Define scope** — Add one or more local Git repository roots to an audit.
+- **Run analysis locally** — File audits (LLM-based) and complexity metrics run on your machine; only metadata and results are sent to CodeDD.
+- **Sync to CodeDD** — Scope metadata, audit results, complexity data, dependencies, and architecture are submitted to CodeDD, where consolidation, dependency enrichment, security scoring, and recommendations run on the server.
+
+Ideal for teams who want to keep source code local while still using CodeDD’s analytics, recommendations, and reporting.
+
+---
+
+## Features
+
+- **Scope management** — Add/remove local directories, sync with CodeDD, detect changes and re-confirm scope (delta updates).
+- **Local file auditing** — LLM-based file analysis using your Anthropic or OpenAI API keys; supports batching and progress feedback.
+- **Complexity analysis** — Cyclomatic complexity and Halstead metrics (Radon/Lizard) run locally and are submitted to CodeDD.
+- **Dependency scanning** — Local lockfile/manifest and import parsing; dependency data is sent to CodeDD for vulnerability and license analysis.
+- **Architecture analysis** — Local component/relationship extraction with optional LLM enhancement; Phase 3 synthesis and storage on CodeDD.
+- **Payment and budget** — Pre-flight checks, LoC budget deduction, or Stripe checkout when additional payment is required.
+- **Secure auth** — CLI tokens stored in the OS credential store (Windows Credential Locker, macOS Keychain, Linux Secret Service).
+
+---
+
+## Installation
+
+### Requirements
+
+- **Python 3.10+**
+- A [CodeDD](https://codedd.ai) account and a CLI token (Account → CLI Access → Generate Token)
+
+### From source (development)
+
+```bash
+git clone https://github.com/codedd/codedd-cli.git
+cd codedd-cli
+pip install -e .
+```
+
+### From PyPI (when available)
+
+```bash
+pip install codedd-cli
+```
+
+Verify:
+
+```bash
+codedd --version
+```
+
+---
+
+## Quick start
+
+### 1. Authenticate
+
+Generate a CLI token at [codedd.ai](https://codedd.ai) (Account → CLI Access), then:
+
+```bash
+codedd auth login --token <your_token>
+```
+
+Or run `codedd auth login` and paste the token when prompted.
+
+### 2. Select an audit
+
+```bash
+codedd audits list
+codedd audits select
+```
+
+Choose a **group audit** (multiple repos) or a **single audit** (one repo). The selected audit becomes the active context for scope and audit commands.
+
+### 3. Define scope
+
+Add the local paths that correspond to the audit’s repositories (each must be a Git repo root):
+
+```bash
+codedd scope add /path/to/my-repo
+codedd scope list
+codedd scope confirm
+```
+
+`scope confirm` scans the directories, shows a preview (files, LoC), and registers scope with CodeDD. If you change files later, run `codedd audit start` — it will offer to re-sync scope (delta update) before starting.
+
+### 4. Run an audit
+
+Configure at least one LLM API key (used for file-level auditing):
+
+```bash
+codedd config set-key anthropic
+# or: codedd config set-key openai
+```
+
+Then start the audit:
+
+```bash
+codedd audit start
+```
+
+The CLI will:
+
+- Sync scope with CodeDD (and prompt to re-confirm if local files changed).
+- Run pre-flight checks (payment, LoC budget).
+- Optionally open payment in the browser or deduct from budget.
+- Fetch the audit plan, run file auditing and complexity analysis locally, submit results, submit dependencies, submit architecture, and trigger server-side post-processing (consolidation, recommendations, completion email).
+
+Results and recommendations are available in the CodeDD dashboard; you can also run `codedd audits list` to see status.
+
+---
+
+## Workflow overview
+
+High-level flow:
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  LOCAL                                                                       │
+│  1. codedd audits select     → Pick audit (group or single)                 │
+│  2. codedd scope add <path>  → Add repo root(s)                              │
+│  3. codedd scope confirm      → Scan & register scope with CodeDD            │
+│  4. codedd audit start        → Sync (if needed) → Pre-flight → Pay/budget   │
+│     └─ File audit (LLM)       → Local                                        │
+│     └─ Complexity            → Local                                        │
+│     └─ Submit results        → CodeDD                                       │
+│     └─ Dependencies          → Local scan → Submit → CodeDD                │
+│     └─ Architecture          → Local phases → Submit → CodeDD               │
+│     └─ Complete              → CodeDD runs consolidation & recommendations   │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+| Step              | Where it runs | What happens |
+|-------------------|---------------|--------------|
+| Scope add/confirm | Local         | Scan dirs, count files/LoC; register or delta-update scope on CodeDD. |
+| Pre-flight        | CodeDD        | Check payment, budget, status. |
+| File audit        | Local         | LLM (Anthropic/OpenAI) analyses each file; results sent to CodeDD. |
+| Complexity        | Local         | Radon/Lizard; metrics sent to CodeDD. |
+| Dependencies      | Local + CodeDD| Lockfiles/imports sent; CodeDD does metadata, vulns, licenses. |
+| Architecture     | Local + CodeDD| Components/relations sent; CodeDD does Phase 3 and storage. |
+| Recommendations   | CodeDD        | Consolidation, technical debt, security, licenses, etc. |
+
+---
+
+## Commands reference
+
+### Authentication
+
+| Command | Description |
+|--------|-------------|
+| `codedd auth login` | Log in with a CLI token (prompt or `--token`) |
+| `codedd auth logout` | Clear stored credentials |
+| `codedd auth status` | Show current account and token state |
+
+### Audits
+
+| Command | Description |
+|--------|-------------|
+| `codedd audits list` | List audits (`--type single\|group`, `--limit`, `--page`) |
+| `codedd audits select [uuid]` | Set active audit (interactive if UUID omitted) |
+
+### Scope
+
+| Command | Description |
+|--------|-------------|
+| `codedd scope add <path> [path ...]` | Add Git repository root(s) to the active audit’s scope |
+| `codedd scope remove <n>` | Remove directory by list number |
+| `codedd scope list` | List directories in scope |
+| `codedd scope clear` | Remove all directories from scope |
+| `codedd scope status` | Show scope and sync state per directory |
+| `codedd scope confirm` | Scan, preview, and register scope with CodeDD |
+| `codedd scope sync` | Compare local vs CodeDD and show changes |
+
+### Audit execution
+
+| Command | Description |
+|--------|-------------|
+| `codedd audit start` | Sync scope (if needed), pre-flight, pay/budget, then run full local audit and submit to CodeDD. Use `--skip-sync` to skip scope sync; `--yes` to auto-confirm; `--debug-llm` for LLM debug output. |
+
+### Configuration
+
+| Command | Description |
+|--------|-------------|
+| `codedd config show` | Show current config (API URL, active audit, scope, etc.) |
+| `codedd config set <key> <value>` | Set a config value |
+| `codedd config set-key [anthropic\|openai]` | Store an LLM API key in the OS keychain |
+| `codedd config show-keys` | List which providers have keys configured (not the keys themselves) |
+| `codedd config provider [anthropic\|openai\|both]` | Set preferred LLM provider |
+| `codedd config concurrency <n>` | Set max concurrent LLM requests (default 6) |
+
+---
+
+## Configuration
+
+- **Config file:** `~/.codedd/config.toml` (TOML). Stores API URL, active audit, scope directories, LLM provider, concurrency. Permissions are restricted to the owner (Unix).
+- **Secrets:** The CLI token and LLM API keys are stored in the system keychain (Windows Credential Locker, macOS Keychain, Linux Secret Service), not in the config file.
+
+### Environment variables
+
+| Variable | Purpose |
+|---------|---------|
+| `CODEDD_API_TOKEN` | Override the stored CLI token (e.g. for CI) |
+| `CODEDD_API_URL`   | Override API base URL (default from config) |
+
+---
+
+## Security
+
+- CLI tokens and LLM keys are stored in the OS credential store, not in plaintext on disk.
+- TLS certificate verification is always enabled for API requests.
+- Config file and `~/.codedd` directory use owner-only permissions where supported.
+- Tokens expire after 90 days (server-configurable); re-generate from the CodeDD dashboard when needed.
+
+---
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+ruff check .
+```
+
+---
+
+## License
+
+MIT License — see [LICENSE](LICENSE).
+
+---
+
+## Support
+
+- **Issues:** [GitHub Issues](https://github.com/codedd/codedd-cli/issues)
+- **Product:** [CodeDD](https://codedd.ai)

codedd_cli-0.1.0/codedd_cli/__init__.py

@@ -0,0 +1,3 @@
+"""CodeDD CLI — run code audits from your terminal."""
+
+__version__ = "0.1.0"

codedd_cli-0.1.0/codedd_cli/__main__.py

@@ -0,0 +1,19 @@
+"""Allow running via ``python -m codedd_cli``."""
+
+import sys
+
+from codedd_cli.api.exceptions import CodeDDConnectionError
+from codedd_cli.cli import app
+from codedd_cli.utils.display import print_error
+
+
+def main() -> None:
+    try:
+        app()
+    except CodeDDConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

codedd_cli-0.1.0/codedd_cli/api/__init__.py

@@ -0,0 +1,4 @@
+from codedd_cli.api.client import CodeDDClient
+from codedd_cli.api.endpoints import Endpoints
+
+__all__ = ["CodeDDClient", "Endpoints"]

codedd_cli-0.1.0/codedd_cli/api/client.py

@@ -0,0 +1,118 @@
+"""
+HTTP client for communicating with the CodeDD API.
+
+Wraps ``httpx`` with:
+    - Automatic ``X-CLI-Token`` header injection
+    - Configurable base URL from ``~/.codedd/config.toml``
+    - Retry logic with exponential back-off
+    - TLS certificate verification (enforced)
+    - Descriptive User-Agent header
+"""
+
+import time
+from typing import Any, Optional
+
+import httpx
+
+from codedd_cli import __version__
+from codedd_cli.api.exceptions import CodeDDConnectionError
+from codedd_cli.auth.token_manager import TokenManager
+from codedd_cli.config.constants import (
+    MAX_RETRIES,
+    REQUEST_TIMEOUT_SECONDS,
+    USER_AGENT_PREFIX,
+)
+from codedd_cli.config.settings import ConfigManager
+
+
+class CodeDDClient:
+    """
+    Thin HTTP client that authenticates via the ``X-CLI-Token`` header.
+
+    Usage::
+
+        client = CodeDDClient()
+        resp = client.get("/api/cli/audits/", params={"limit": 20})
+        data = resp.json()
+    """
+
+    def __init__(self, config: Optional[ConfigManager] = None) -> None:
+        self._config = config or ConfigManager()
+        self._base_url = self._config.api_url.rstrip("/")
+        self._token = TokenManager.retrieve()
+        
+        # For localhost HTTP, disable TLS verification (not applicable anyway)
+        # For HTTPS, always verify certificates
+        verify_tls = not self._base_url.startswith("http://localhost") and not self._base_url.startswith("http://127.0.0.1")
+        
+        self._client = httpx.Client(
+            base_url=self._base_url,
+            headers=self._build_headers(),
+            timeout=REQUEST_TIMEOUT_SECONDS,
+            verify=verify_tls,
+            follow_redirects=True,
+        )
+
+    def _build_headers(self) -> dict[str, str]:
+        headers: dict[str, str] = {
+            "User-Agent": f"{USER_AGENT_PREFIX}/{__version__}",
+            "Accept": "application/json",
+        }
+        if self._token:
+            headers["X-CLI-Token"] = self._token
+        return headers
+
+    # ---- HTTP verbs with retry ----
+
+    def get(self, path: str, **kwargs: Any) -> httpx.Response:
+        return self._request("GET", path, **kwargs)
+
+    def post(self, path: str, **kwargs: Any) -> httpx.Response:
+        return self._request("POST", path, **kwargs)
+
+    # ---- internal ----
+
+    def _request(self, method: str, path: str, **kwargs: Any) -> httpx.Response:
+        """
+        Execute an HTTP request with automatic retries on transient errors.
+
+        Retries on 5xx responses and connection errors using exponential
+        back-off (1s, 2s, 4s …).
+        """
+        last_exc: Optional[Exception] = None
+
+        for attempt in range(1, MAX_RETRIES + 1):
+            try:
+                resp = self._client.request(method, path, **kwargs)
+
+                # Don't retry client errors (4xx)
+                if resp.status_code < 500:
+                    return resp
+
+                # Retry on server errors
+                if attempt < MAX_RETRIES:
+                    time.sleep(2 ** (attempt - 1))
+                    continue
+
+                return resp
+
+            except httpx.RequestError as exc:
+                last_exc = exc
+                if attempt < MAX_RETRIES:
+                    time.sleep(2 ** (attempt - 1))
+                    continue
+                raise CodeDDConnectionError() from None
+
+        # Should not normally reach here, but satisfy the type checker
+        if last_exc:
+            raise CodeDDConnectionError() from None
+        raise RuntimeError("Request failed after retries")  # pragma: no cover
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()