SpaceOS Terminál — Kommunikációs Protokoll

1. Inbox olvasás — "olvasd le az üzeneteidet"

# UNREAD üzenetek keresése
grep -rl "status: UNREAD" ./mailbox/inbox/ 2>/dev/null

# Ha üres: legfrissebb fájl
ls -lt ./mailbox/inbox/ | grep "^-" | head -3

A legfrissebb UNREAD fájlt olvasd el, majd módosítsd:

status: UNREAD  →  status: READ

Ha több UNREAD van: a legalacsonyabb sorszámút dolgozd fel először.

2. Feladat végrehajtás — kötelező gate

Minden feladatnál, kivétel nélkül:

INBOX READ → IMPLEMENTÁLÁS → BUILD → TEST → OUTBOX

Build + test gate

A terminál típusától függ — a saját CLAUDE.md-ben van definiálva:

Terminál	Build	Test
Kernel	dotnet build → 0 error	dotnet test → minden zöld
Orchestrator	npm run build → 0 TS error	npm test → minden zöld
E2E	—	npm test → meglévők zöldek maradnak
Infra	—	health check: curl /bff/health vagy /healthz
Joinery / Abstractions	dotnet build → 0 error	dotnet test → minden zöld

Ha a build vagy test nem zöld: NE írj DONE-t. Javítsd, aztán futtasd újra.

3. DONE üzenet írása

Amikor a feladat kész és a build+test gate átment:

Fájlnév: YYYY-MM-DD_NNN_<slug>-done.md → ./mailbox/outbox/

NNN = az inbox üzenet sorszáma (pl. MSG-KERNEL-067 → 067).

---
id: MSG-<TERMINAL>-<NNN>-DONE
from: <terminál>
to: conductor
type: done
priority: <az inbox üzenet prioritása>
status: UNREAD
ref: MSG-<TERMINAL>-<NNN>
created: YYYY-MM-DD
---

⚠️ type mező szabályai — kötelező betartani:

Állapot	type értéke
Feladat sikeresen teljesítve	done
Feladat nem teljesíthető, segítség kell	blocked
Döntést kér a root-tól	question

type: response TILOS — nem hordoz státusz információt, a root nem tudja kezelni.

Kötelező szekciók — részletes sablonok: references/outbox-templates.md

## Összefoglaló
Mit implementáltál, mely fájlok változtak, commit hash.

## Tesztek
Hány teszt futott, mind zöld? Új tesztek száma?
(Utolsó sor a test output-ból másolva)

## Security review
Ellenőrzött pontok: input validation, auth, RLS/RBAC, nincs secret a logban.

## Kockázatok / kérdések
Ha van → status: BLOCKED és leírás. Ha nincs → "Nincsenek."

4. BLOCKED üzenet — ha elakadsz

Ha a feladatot nem tudod befejezni önállóan (hiányzó info, függőség, infrastruktúra):

Fájlnév: YYYY-MM-DD_NNN_<slug>-blocked.md → ./mailbox/outbox/

---
id: MSG-<TERMINAL>-<NNN>-BLOCKED
from: <terminál>
to: conductor
type: blocked
priority: high
status: UNREAD
ref: MSG-<TERMINAL>-<NNN>
created: YYYY-MM-DD
---

## Mi blokkol
Konkrét technikai leírás — mi hiányzik, mi nem működik.

## Mit próbáltam
Legalább egy diagnózis kísérlet.

## Kérés a root-tól
Mit kell dönteni / kiadni ahhoz, hogy folytatni tudjam.

Soha ne folytasd találgatással. Ha 2 próbálkozás után sem megy: BLOCKED.

5. Mailbox elérési utak

Terminál	Inbox	Outbox
Kernel	/opt/spaceos/docs/mailbox/kernel/inbox/	.../kernel/outbox/
Orchestrator	/opt/spaceos/docs/mailbox/orchestrator/inbox/	.../orchestrator/outbox/
E2E	/opt/spaceos/docs/mailbox/e2e/inbox/	.../e2e/outbox/
Infra	/opt/spaceos/docs/mailbox/infra/inbox/	.../infra/outbox/
Joinery	/opt/spaceos/docs/mailbox/joinery/inbox/	.../joinery/outbox/
Abstractions	/opt/spaceos/docs/mailbox/abstractions/inbox/	.../abstractions/outbox/
Portal	/opt/spaceos/docs/mailbox/portal/inbox/	.../portal/outbox/

6. Amit soha nem szabad

• DONE outbox írása build/test failure mellett
• Találgatással folytatni, ha elakadtál (→ BLOCKED)
• Kódot módosítani a DONE után, outbox nélkül
• Más terminál kódjába nyúlni (csak a saját repo-d)
• TODO / FIXME kommentet commitolni