Skip to content

Commit ffeea56

Browse files
DelqhiOpenSIN-AI
andauthored
fix: resolve merge conflicts for SSOT alignment PR #73 (#93)
- Hub & Spoke topology added to architecture/a2a.md - Naming conventions guide added to docs/guide/ - Technology sovereignty mandate added to best-practices/security.md - Manual conflict resolution for security.md (appended mandate section) Co-authored-by: OpenSIN-AI <bot@opensin.ai>
1 parent 64030a7 commit ffeea56

3 files changed

Lines changed: 52 additions & 0 deletions

File tree

docs/architecture/a2a.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -175,3 +175,24 @@ gh repo create OpenSIN-AI/A2A-SIN-MyAgent \
175175
--template OpenSIN-AI/Template-A2A-SIN-Agent \
176176
--public
177177
```
178+
179+
## 🔄 The New Fleet Topology (Hub & Spoke)
180+
181+
As defined in the `OpenSIN-overview` SSOT, the OpenSIN A2A fleet uses a strict **Hub & Spoke** model to prevent N^2 communication chaos.
182+
183+
```mermaid
184+
graph TD;
185+
User[Operator / Telegram] -->|Task| TeamManager[Team-SIN-* Orchestrator];
186+
Hermes[SIN-Hermes Global Router] -->|Payload| TeamManager;
187+
188+
TeamManager -->|Consults| Lexicon[(Team Lexicon / RAG)];
189+
TeamManager -->|Delegate| Workers[A2A-SIN-* Worker Agents];
190+
Workers -->|Result| TeamManager;
191+
192+
TeamManager -->|Aggregate & Respond| Hermes;
193+
TeamManager -->|Aggregate & Respond| User;
194+
```
195+
196+
**Key Rules:**
197+
1. **Workers are Silent:** `A2A-SIN-*` worker agents NEVER communicate with workers from other teams. They only accept tasks from their designated `Team-SIN-*` manager.
198+
2. **Team Managers Orchestrate:** Only `Team-SIN-*` agents possess the `TELEGRAM_BOT_TOKEN` to communicate with humans.
Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
diff a/docs/best-practices/security.md b/docs/best-practices/security.md (rejected hunks)
2+
@@ -198,3 +198,13 @@ Before deploying an agent to production:
3+
- [ ] Log redaction enabled for sensitive patterns
4+
- [ ] Token rotation configured for all long-lived credentials
5+
- [ ] `npm audit` passing with no critical vulnerabilities
6+
+
7+
+## 🚫 Technology Sovereignty Mandate (Browser Automation)
8+
+
9+
+**STRICTLY ENFORCED:**
10+
+- **Playwright**, **Puppeteer**, **Selenium**, and **Camoufox** are **PERMANENTLY BANNED** across the entire OpenSIN-AI organization.
11+
+- They are easily detected by Cloudflare, trigger massive bot-detection red flags, and lack true native stealth.
12+
+
13+
+**THE OPENSIN STANDARD:**
14+
+All A2A Agents MUST use the **OpenSIN-Bridge Chrome Extension** via the MCP WebSocket Server.
15+
+Alternatively, if OS-level isolation is absolutely necessary, use `webauto-nodriver-mcp` (which wraps `nodriver`).

docs/guide/naming-conventions.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# 🏷️ Naming Conventions & SSOT
2+
3+
## The Ultimate SSOT
4+
Before modifying any code or reading further, you must be aware of the **[OpenSIN-overview](https://github.com/OpenSIN-AI/OpenSIN-overview)** repository. It is the Single Source of Truth for the entire organization.
5+
6+
## Strict Naming Schema
7+
To prevent architectural chaos, every repository in the OpenSIN-AI organization **MUST** follow this strict naming schema:
8+
9+
`[Type]-SIN-[Name]`
10+
11+
### Valid Types:
12+
- `Team-SIN-*` (Orchestrators, Hubs, Managers. E.g., `Team-SIN-Legal`)
13+
- `A2A-SIN-*` (Worker Agents that execute tasks. E.g., `A2A-SIN-ClaimWriter`)
14+
- `MCP-SIN-*` (Model Context Protocol Servers / Tools. E.g., `MCP-SIN-Browser`)
15+
- `CLI-SIN-*` (Command Line Interfaces / Terminals. E.g., `CLI-SIN-Code`)
16+
- `Template-SIN-*` (Blueprints for the forge scripts)

0 commit comments

Comments
 (0)