# Raport sesji: moduł marketingowy (noc 2026-05-30)

**Projekt GEMA-0:** 10.0.0  
**Zakres:** misja Oraculum + analiza awarii + naprawa backendu + API  
**Commit naprawczy (main):** `4970cdb` — `fix(core): PhantomVM bypass for new ESM modules and marketing API`

---

## 1. Co użytkownik zlecił

Prompt (Oraculum, ~05:47 czasu lokalnego / 03:47 UTC):

> Stwórz moduł marketingowy do systemu SaaS enterprise — API do systemów zewnętrznych, AI do generowania postów, integracja Facebook/Instagram.

---

## 2. Co system zrobił (kolejność zdarzeń)

| Czas (UTC) | Zdarzenie |
|------------|-----------|
| 03:47:05 | Oraculum wygenerowało **4 misje** z `projectId: "1"` |
| 03:47:05–03:49:24 | Misja 1: `aiContentGenerator.js` — **MISSION_FAILED** (3× rój, PhantomVM) |
| 03:47:22 | Utworzono pusty projekt `modul-marketingowy` (UI — osobna akcja) |
| 03:49:24–03:49:43 | Misja 2: `socialMediaGateway.js` — **SUCCESS** |
| 03:49:43–03:50:07 | Misja 3: `CampaignDashboard.jsx` — **SUCCESS** |
| 03:50:07–03:50:21 | Misja 4: `AiPostCreator.jsx` — **SUCCESS** |
| 03:50:10 | Utworzono pusty projekt `marketing` (UI — w trakcie misji) |

**Wniosek:** kod trafił do `workspaces/1/`, bo w Sequencerze był wybrany projekt **`1`**. Nowe foldery `marketing` / `modul-marketingowy` powstały później i **nie dostały misji**.

---

## 3. Dlaczego pierwsza misja padła

**Plik:** `src/server/modules/marketing/services/aiContentGenerator.js`  
**Profil:** `NODE_ESM`, tryb `CREATE_NEW_FILE`, `functionName: generateMarketingContent`

Sędzia (PhantomVM) uruchamiał kod w `node:vm`. LLM generował typowy ESM (`export`, `import.meta`, `process.env`) — VM odrzucał wszystkich agentów:

- `Unexpected token 'export'`
- `Cannot use 'import.meta' outside a module`
- `process is not defined`

Dodatkowo setki logów `[aiGateway] ... aborted` to **efekt uboczny roju** (18 agentów równolegle, abort po wygranej) — nie osobna awaria API.

Przy `MISSION_FAILED` orchestrator **nie zapisuje** pliku na dysk (flush RAM → dysk tylko po sukcesie).

---

## 4. Pliki — stan końcowy

### 4.1. Zapisane przez Rój (projekt `workspaces/1`)

| Ścieżka | ~linii | Status |
|---------|--------|--------|
| `src/server/modules/marketing/connectors/socialMediaGateway.js` | 180 | ✅ zapisany |
| `src/app/marketing/components/CampaignDashboard.jsx` | 179 | ✅ zapisany |
| `src/app/marketing/components/AiPostCreator.jsx` | 207 | ✅ zapisany |
| `src/server/modules/marketing/services/aiContentGenerator.js` | 69 | ❌ misja padła → odtworzony ręcznie |

**Opis plików:**

- **socialMediaGateway.js** — klasa `SocialMediaGateway`, strategie Facebook/Instagram, tokeny OAuth (mock), `executePost`, `executeGetAnalytics`.
- **CampaignDashboard.jsx** — dashboard KPI, wykres wydatków (recharts), lista kampanii (mock API).
- **AiPostCreator.jsx** — formularz (opis, cel, ton, platformy), generowanie treści, publikacja.
- **aiContentGenerator.js** — `generateMarketingContent(data)` → `{ main, suggestions }` lub `{ error }`.

### 4.2. Istniejące wcześniej w `workspaces/1`

- `index.html`, `src/main.jsx`, `src/index.css`
- `src/components/Header.jsx`, `Showcase.jsx`, `Footer.jsx`
- `plik.html`, `raport.html`, `instrukcje.txt`

### 4.3. Dodane w sesji naprawczej (lokalnie, gitignore `workspaces/*`)

- `src/App.jsx` — nawigacja: Strona główna / Marketing Dashboard / Kreator AI
- `vite.config.js` — proxy `/api` → `127.0.0.1:7878`
- `package.json` + `node_modules` (Vite/React, recharts dla dashboardu)

### 4.4. Puste projekty (bez kodu aplikacji)

- `workspaces/marketing/.gema0/...`
- `workspaces/modul-marketingowy/.gema0/...`

---

## 5. Naprawy wdrożone po sesji (commit `4970cdb`, na `main`)

| Zmiana | Plik | Efekt |
|--------|------|-------|
| `CREATE_NEW_FILE` → zawsze `FULL_FILE` w Roju | `orchestrator.mjs` | Sędzia nie wywołuje pojedynczej funkcji w VM przy nowym pliku |
| Bypass AST dla NODE_ESM bez mechanical gate | `phantomVM.mjs` | Nowe moduły `.js` nie padają na ESM w VM |
| API marketing | `backend/api/marketingRoutes.mjs` | `POST .../marketing/generate`, `POST .../marketing/publish` |
| Podgląd React | `workspace:dev`, scaffold Vite | `npm run workspace:dev -- 1` |
| Test regresji | `phantomVM.test.mjs` | Nowy przypadek FULL_FILE + import.meta |

---

## 6. Jak uruchomić podgląd

```bash
# Terminal 1 — backend (wymaga restartu po pullu)
npm run start

# Terminal 2 — podgląd React projektu 1
npm run workspace:dev -- 1
```

Otwórz adres z terminala Vite (np. `http://localhost:5199`). Zakładki: **Marketing — Dashboard**, **Marketing — Kreator AI**.

Backend musi być na `:7878` — Kreator woła `/api/projects/1/marketing/...` (proxy Vite).

---

## 7. Otwarte / rekomendacje

1. **Workspaces w `.gitignore`** — pliki w `workspaces/1/` nie trafiają do GitHub; tylko backend jest w repo.
2. **Nowa misja pod `marketing`** — jeśli kod ma być w osobnym projekcie, w Sequencerze wybierz `marketing` przed wysłaniem promptu (lub skopiuj foldery ręcznie).
3. **Restart `npm run start`** — stara instancja nie ma endpointów marketing API.

---

## 8. Powiązane wpisy

- `_docs/AGENT_LOG.md` — wpisy 2026-05-30 (PhantomVM, API, Vite scaffold)
- `events.ndjson` — pełna ścieżka zdarzeń (`MISSION_5d6d10b2`, `MISSION_5194df06`, …)

---

## 9. Szacunek kosztów API (Gemini) — noc 2026-05-30

**Uwaga:** GEMA-0 **nie loguje** `usageMetadata` z Gemini. Poniżej **szacunek** z `events.ndjson` + cennik [Gemini API](https://ai.google.dev/gemini-api/docs/pricing) (Flash $0.30/1M in, $2.50/1M out; Pro $1.25/1M in, $10/1M out).

### Moduł marketingowy (03:47–03:50 UTC)

| Pozycja | Wartość |
|---------|---------|
| Oraculum (1× `gemini-2.5-pro`) | 1 wywołanie |
| Rój Flash (`gemini-2.5-flash`) | **92 sloty agentów** (3×18 + 20 + 8 + 10) |
| AGENT_FAILED (marketing) | 55 |
| AGENT_WON / SUCCESS | 3 misje zapisane |

**Szacunek tokenów (marketing):** ~110k input + ~140k output (Flash) + ~5k input + ~1k output (Pro)  
**Szacunek kosztu:** **~0,35–0,45 USD** (~1,50–2,00 PLN)

### Cała noc na projekcie `1` (03:01–03:50 UTC)

| Pozycja | Wartość |
|---------|---------|
| Wszystkie roje Flash | **134 sloty agentów** (8 misji React + 4 marketing) |
| Oraculum Pro | 1–2 wywołania (React + marketing — osobne prompty) |

**Szacunek kosztu:** **~0,55–0,70 USD** (~2,30–3,00 PLN)

Dokładny rachunek: [Google AI Studio → Usage](https://aistudio.google.com/) lub rozliczenia GCP.