# CHORUS Project - Context & Operating Procedures

**Project Root:** `/home/tony/rust/projects/reset/CHORUS`
**Primary Model Provider:** `resetdata/openai/gpt-oss-120b`

---

## 🛑 CRITICAL OPERATIONAL LIMITS

### 1. The "Context Wall" (65k Tokens)
The `resetdata/openai/gpt-oss-120b` model exhibits a **hard reliability threshold** for tool execution between **65,000 and 75,000 tokens**.
- **Safe Zone:** < 65k tokens. Tool use is reliable and fast (~17s latency).
- **Danger Zone:** > 75k tokens. The model will reason correctly about tool usage but **FAIL to emit the tool call** (Reasoning-Execution Divergence).
- **Mandate:** ALL agents must monitor their session context. If approaching 60k tokens, **summarize findings and start a fresh session.** DO NOT attempt complex multi-step tool chains in a bloated context.

### 2. ResetData First Strategy
- **Primary Intelligence:** Use `opencode` with `resetdata/openai/gpt-oss-120b`.
- **API Rate Limit:** ResetData is limited to **40 calls per minute**.
- **Graceful Backoff:** Agents MUST implement jittered exponential backoff. If an API call fails due to rate limits, wait 2^n + jitter seconds before retrying.
- **Global Throttling:** Before initiating an LLM call, agents should check the shared `api_call_log` in the Dolt graph to estimate current cluster-wide load.

---

## 🏗 Project Architecture (Rust-Centric)

This is a **fresh implementation** of the CHORUS vision, discarding legacy prototypes.
- **Language:** Rust (primary), Python (scripting/glue if needed).
- **Core Modules:**
  - **UCXL:** Unified Context Exchange Linking (The File System/Metadata Bridge).
  - **SWOOSH:** State Coordination (The Deterministic State Machine).
  - **BZZZ:** P2P Networking (The LibP2P Layer).
  - **SLURP:** Context Intelligence (The Agentic Reasoning Layer).

## 📜 Documentation Source of Truth
- `docs/CHORUS.md`: The High-Level Vision.
- `docs/distos/PROJECT-CONSTITUTION.md`: The Governance Rules.
- `docs/distos/councils/`: The Architectural Decisions.
- `docs/Modules/`: The Component Specifications.

---

## 🌐 Source Control (Gitea)
- **Host:** Locally in Docker (typically http://localhost:3000 or similar)
- **Credentials:** 
  - **User:** `tony`
  - **Password:** `silverfrond[1392]`
- **Mandate:** All major architectural changes must be committed and pushed to the Gitea repository. Use submodules for external components.

---

## 🚀 Agent Directives
1. **Read-Modify-Write-Verify (RMWV):** All file operations must be verified. If you write a file, you MUST read it back or list it to confirm success.
2. **Log Everything:** Since we are using ephemeral sessions to manage context, persistent logs are crucial. Write major decisions and progress to `docs/decisions/` or `progress/`.
3. **Submodules:** If external components are needed, prefer `git submodule` over vendoring code, but verify the license compatibility first.

---
*Created by Gemini CLI Coordinator - March 2, 2026*