Metadata-Version: 2.1
Name: sodonetwork
Version: 3.4.7
Summary: Deterministic AI Coding Guardrails, 85% Token Optimizer & MCP Bridge for AI Agents
Home-page: https://sodonetwork.com
Author: Soner DONMEZ
Author-email: sonerdonmez@hotmail.com.tr
License: Proprietary - Registration No: 2026/21386
Project-URL: Homepage, https://sodonetwork.com
Project-URL: LinkedIn, https://www.linkedin.com/in/soner-donmez-9a45255b
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# ⚡ SodoNetwork (`sodonetwork`) — Deterministic AI Coding Guardrails & Token Optimization

[![PyPI version](https://img.shields.io/pypi/v/sodonetwork.svg)](https://pypi.org/project/sodonetwork/)
[![Python versions](https://img.shields.io/pypi/pyversions/sodonetwork.svg)](https://pypi.org/project/sodonetwork/)
[![License](https://img.shields.io/badge/License-Proprietary%20%7C%20Reg%202026%2F21386-blue.svg)](https://sodonetwork.com)

**Author & Copyright Owner:** [Soner DÖNMEZ](https://www.linkedin.com/in/soner-donmez-9a45255b)  
**Official Registration:** Republic of Türkiye Ministry of Culture and Tourism (No: `2026/21386`)  
**Official Portal:** [https://sodonetwork.com](https://sodonetwork.com)  
**LinkedIn Profile:** [https://www.linkedin.com/in/soner-donmez-9a45255b](https://www.linkedin.com/in/soner-donmez-9a45255b)

---

## 🌍 Stop Letting AI Coding Agents Burn Your Budget & Break Production

If you use **Cursor, Claude, VS Code GitHub Copilot, Windsurf, or Google Antigravity**, you know the two biggest headaches in autonomous software development:
1. **Context Drift & Code Damage:** You ask the agent to fix a simple UI element, and it silently edits core files, introduces breaking dependencies, or hallucinates unwanted code.
2. **Exploding Token Bills:** Top-tier large models are being invoked for routine syntax checks, repetitive CRUD tasks, and simple boilerplate.

**SodoNetwork** introduces a deterministic control plane that eliminates hallucinations, locks file scopes, and cuts API token costs by **up to 85%** — without altering your IDE workflow.

---

### ✨ Key Features

- 🛡️ **Deterministic Scope Lock:** AI agents physically cannot touch files outside their approved task boundary. Critical directories (`core/data`, `infra`, `.git`) are strictly protected.
- 📉 **Intelligent Workload Delegation:** High-level architecture stays intact while routine coding workloads are routed to fast, economical submodels, saving up to 85% in token expenditure.
- 🔒 **Automated Verification & Forensic Ledger:** Every generated file is syntax-verified and sealed on an immutable cloud ledger with a cryptographic SHA-256 fingerprint.
- 🔌 **Native Zero-Config MCP:** Fully compliant with the **Model Context Protocol (MCP)** for Cursor, Claude Desktop, Antigravity, and VS Code.

---

## 📦 Quick Start (30 Seconds)

### 1. Installation

```bash
pip install --upgrade sodonetwork
```

### 2. Workspace Initialization

Run the interactive wizard in your project root:

```bash
sodo --wizard
```

Or initialize directly with your Subscriber Connection ID (`CID`):

```bash
sodo --init --cid <YOUR_SUBSCRIBER_CID>
```

This automatically configures your workspace rule files and `.vscode/mcp.json` for seamless autonomous coding.

---

## 🛠️ CLI Reference

| Command | Description |
| :--- | :--- |
| `sodo --wizard` | Interactive workspace onboarding and quota verification wizard. |
| `sodo --init --cid <CID>` | Bootstraps workspace IDE rule files and MCP configuration. |
| `sodo --status` | Displays subscriber account, plan (`STARTER`, `PRO`, `ENTERPRISE`), and remaining quota. |
| `sodo --fetch` | Acquires an authorized task session from SodoNetwork Cloud. |
| `sodo --verify <FILE>` | Runs automated exit tests, computes SHA-256 hash, and seals the task. |
| `sodo-mcp` | Starts the native JSON-RPC Stdio Model Context Protocol (MCP) server. |

---

## 🇹🇷 Türkçe Özet

**SodoNetwork**, Cursor, GitHub Copilot, Claude ve Antigravity gibi otonom yapay zeka ajanlarının çalışan kodları bozmasını engelleyen ve token maliyetlerini **%85 oranında düşüren** deterministik yönetim ve doğrulama köprüsüdür.

- 🔒 **Kapsam Kilidi:** Ajanın yalnızca izin verilen hedef dosya üzerinde çalışmasını sağlar.
- 💰 **%85 Kota Tasarrufu:** Kodlama yükünü optimize ederek bütçenizi korur.
- 📑 **Kriptografik SHA-256 Mühürleme:** Üretilen her kod parçası doğrulanır ve bulut defterine işlenir.

---

## 🔗 Official Links & Contact

- **Website:** [https://sodonetwork.com](https://sodonetwork.com)
- **LinkedIn:** [https://www.linkedin.com/in/soner-donmez-9a45255b](https://www.linkedin.com/in/soner-donmez-9a45255b)
- **Contact:** `sonerdonmez@hotmail.com.tr`

---

## ⚖️ License & Intellectual Property

Copyright © 2026 **Soner DÖNMEZ**. All Rights Reserved.  
Registered under the Republic of Türkiye Ministry of Culture and Tourism Directorate General for Copyright (**Registration No: `2026/21386`**). Unauthorized reproduction or reverse engineering is strictly prohibited under Law No. 5846 (FSEK).


