# SindByte Distribution Documentation Changelog

## 2026-04-21 — Public Documentation Release

### Summary
Released two comprehensive public-facing technical documents for the SindByte + Paperclip integration package. These documents replace scattered internal notes with structured, reusable guides suitable for external distribution.

### New Documents

#### `SindByte-Paperclip-Setup-Guide.md`
- Complete technical setup guide from installation to verification
- Covers: prerequisites, step-by-step installation, SindByte config, Paperclip agent config, LM-Studio setup
- Tool categories reference with permission levels
- JSON-RPC protocol details and known workaround for ToolCatalog.CallTool parameter mangling
- Verification scripts and troubleshooting matrix
- All ports, paths, and internal names replaced with placeholders (`<MCP_PORT>`, `<Project_Root>`, etc.)

#### `Trading-Firm-Technical-Guide.md`
- Architecture guide for building AI-governed trading firms
- Covers: agent roles (CEO, CTO, Traders), data flow diagrams, paper vs live trading, state management
- Risk management infrastructure: hard limits, circuit breakers, stop-loss execution
- Evolution engine for strategy improvement
- Monitoring, health checks, and operational playbook
- Trading tips kept marginal per design requirement
- All private operational details removed

### Updated Files

**`README.txt`**
- Added references to new guide documents
- Removed specific port numbers and internal paths
- Updated file listing

### Security & Privacy Changes
- All literal localhost ports replaced with placeholders (`<MCP_PORT>`, `<API_PROVIDER_PORT>`, etc.)
- All absolute file paths replaced with generic placeholders
- Internal project names and company identifiers removed
- Specific model versions and exchange account references generalized
- Process IDs, backup paths, and internal log locations removed

### Verified Working Configuration (Reference Only)

| Component | Role | Status |
|-----------|------|--------|
| Paperclip Server | Orchestration | Local-only, trusted |
| SindByte MCP | Tool execution | Hundreds of tools, JSON-RPC POST |
| SindByte API Provider | AI proxy | Forwards to local LLM |
| LM-Studio | Local inference | Model-loaded, CORS-enabled |

### Key Discoveries Documented
1. **JSON-RPC POST is the working format** — Tool calls use `method: "tools/call"` with `params.name` and `params.arguments`
2. **GET /mcp returns NullReferenceException** — Known minor issue, harmless. Do not use for diagnostics.
3. **LM-Studio auth can be disabled for localhost** — Set `tokenMode` to `none` in permissions store for local-only setups.
4. **Paperclip worktree isolation** — `.mcp.json` must be committed to git or `worktreeIsolation` set to `false`.
5. **SindByte auto-starts its MCP server** — No separate MCP startup needed; it's built into the main executable.
6. **ToolCatalog.CallTool mangles certain params** — Direct tool calls bypass this issue.

---

*Maintained by SindByte Distribution Team*
