OpenSIN

OpenSIN ist der freie, selbst hostbare Agenten-Kern. Er bildet die Basis für unbegrenzt viele eigene Agenten-Teams und offene Deployments. SIN Solver ist unser proprietärer Vollausbau: die gemanagte Operator-Layer für Teams, die diese Architektur als betriebssicheres Gesamtsystem mit Security-Lanes, Execution-Playbooks und garantierter Ausführung nutzen wollen.

Status & Architektur

• Root governance documents are now tracked through the Top 20 registry in CONSTITUTION.md.
• Platform metadata and allowlisting are governed by config/platforms-registry.json.
• Das System ist nicht ein einzelner Agent, sondern als A2A-Netzwerk (Agent-to-Agent) mit parallelen Fach-Teams (Infrastructure, Coding, Shop, Google-Apps, Apple-Apps) strukturiert.
• Security-Lanes wie SIN-Authenticator (Auth-Broker) und SIN-Passwordmanager (Secret-Authority) ersetzen den riskanten Blindflug isolierter Agenten.
• Für gemanagte Runtimes, Premium-Kerne und Money-Maker-Abteilungen siehe die SIN Solver Pläne.

Zeus Control Plane Flow

• SIN-Zeus plans work and creates GitHub Projects V2, issues, labels, and linked branches.
• scripts/zeus/bootstrap-github-project.mjs is the canonical bootstrap entrypoint.
• scripts/zeus/hermes-dispatch.mjs converts Zeus work items into capability-routed executor jobs.
• scripts/zeus/hermes-intake.mjs resolves the remote branch SHA, builds task.create payloads, and can submit them to Room-13.
• Resulting artifacts live in Docs/operations/ and are the operator-visible evidence bundle for the Zeus lane.

Runtime Topology

• Room-13 is the task-ingress coordinator. It accepts runtime tasks; it is not the GitHub planning layer.
• SIN-Supabase is the projection/auth-memory metadata plane and targets an OCI A1.Flex VM running self-hosted Supabase OSS.
• SIN-Server is a bootstrap/readiness/handoff agent. It is not the Room-13 queue runtime.
• SIN-OracleCloud-MCP is the dedicated OCI execution plane for direct Oracle Cloud operations.
• dashboard-enterprise now publishes the live A2A dashboard lane only through Vercel (a2a.delqhi.com); the previous Cloudflare/OpenNext dashboard path is retired and no longer used.
• PR/CI validation is moving to the repo self-hosted runner lane sin-solver-macos-arm64 because GitHub-hosted Actions minutes are exhausted too quickly for the current A2A workload.
• For pilot mutations, Room-13 requires an authoritative Redis-backed route store plus bearer-token auth.

🚀 Simone MCP: The Ultimate Coder Agent Backend (2026)

Simone MCP is our enterprise-grade evolution of the open-source Serena MCP (Oraios AI). It provides the same brilliant LSP-powered semantic code operations (symbol search, structural edits, 40+ languages), but fixes all of Serena's architectural flaws for an autonomous Agent-to-Agent (A2A) ecosystem.

Feature	Serena MCP (Status Quo)	Simone MCP (Our Design)
A2A Discovery	❌ None	✅ A2A-Native (agent-card.json)
Dashboard	⚠️ Basic CLI	✅ Enterprise UI (via activate_simone / a2a.delqhi.com/agents/simone-mcp)
Communication	⚠️ Synchronous (blocks agents)	✅ Async-First (Supabase Event Bus)
Memory	⚠️ Local files (breaks at scale)	✅ Cloud Semantic Memory (pgvector)
Deployment	⚠️ Manual	✅ Live HF Space (https://delqhi-simone-mcp.hf.space) + keep-alive

Live surfaces:

• Public A2A landing: https://a2a.delqhi.com/agents/simone-mcp
• HF runtime: https://delqhi-simone-mcp.hf.space

All internal Coder Agents MUST use Simone MCP instead of generic regex/text search for any codebase modifications. Read the Adoption Guide and Simone MCP README for details.

Tech Stack

• Python 3.11+, FastAPI, SQLAlchemy, Redis clients, SQLite telemetry
• Node.js, Express, better-sqlite3, Redis, Playwright-adjacent worker tooling
• Next.js (dashboard-enterprise), React, TypeScript, and Vercel deployment tooling for the public dashboard lane
• Repo-level gates and artifact generation in scripts/architecture

Quickstart

python3 -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt
npm install && npm --prefix dashboard-enterprise install && npm --prefix services/solver-18-survey-worker install
npm run test:docs:root

Verified Zeus Operator Commands

# Real GitHub bootstrap
node scripts/zeus/bootstrap-github-project.mjs \
  --owner Delqhi \
  --repo SIN-Solver/OpenSIN \
  --title "SIN-Zeus Alpha Bootstrap" \
  --plan-file scripts/zeus/ultra-plan.example.json

# Capability routing artifact
node scripts/zeus/hermes-dispatch.mjs \
  --repo SIN-Solver/OpenSIN \
  --repo-path . \
  --bootstrap Docs/operations/sin-zeus-bootstrap.json

# Local executor registration + safe claim proof for Zeus tasks
python3 scripts/zeus/run-room13-executor.py \
  --worker-name sin-backend \
  --platform team-coding \
  --room13-url http://92.5.60.87:8014 \
  --bearer-token "$ROOM13_BEARER_TOKEN" \
  --claim-next \
  --accepted-type zeus_github_branch \
  --min-priority critical \
  --complete-probe-task \
  --once

# Real Room-13 submit (requires bearer token + authoritative Redis-backed Room-13)
ROOM13_BEARER_TOKEN=... node scripts/zeus/hermes-intake.mjs \
  --repo SIN-Solver/OpenSIN \
  --bootstrap Docs/operations/sin-zeus-bootstrap.json \
  --dispatch Docs/operations/sin-hermes-dispatch.json \
  --room13-url http://127.0.0.1:8014 \
  --submit

Primary Components

• services/room-13-fastapi-coordinator: coordinator API for health, task, worker, credential, service, and gateway contracts
• services/solver-18-survey-worker: Node.js runtime with health, metrics, runtime status, and telemetry routes
• services/workers: Python launcher/runtime layer for personas, leases, heartbeats, and coordinator integration
• dashboard-enterprise: active dashboard/frontend surface
• scripts/architecture: repo-wide gates, artifact checks, scorecards, and release controls

Core Documents

• BLUEPRINT.md: logical system design
• ARCHITECTURE.md: file-system and runtime deep dive
• API.md: service contract overview
• DATABASE.md: storage topology and schema notes
• ENVIRONMENT.md: required environment variables by subsystem
• TESTING.md: validation strategy and recommended command order