# 03. Stan Projektu, Problemy i Zadania

**Zaktualizowano:** 2026-06-26 (audyt docs — PR #20–#22)  
**Start agenta:** [00_START_TUTAJ.md](00_START_TUTAJ.md) → [HANDOFF_AKTUALNY.md](HANDOFF_AKTUALNY.md) → ten plik.

---

## ⚠️ ŹRÓDŁO PRAWDY

Architektura i kierunek: **[11_OPUS_ARCHITECTURE_PROPOSAL.md](11_OPUS_ARCHITECTURE_PROPOSAL.md) + realny kod.**
Reszta `docs/` (w tym sekcje niżej w tym pliku, `05_EPISODE_PIPELINE`, `07_DEV_AGENT_PLAN`) ma **sprzeczne/legacy** wersje — traktuj jako historię, nie jako rozkaz.

- **Aktywny UI = Director's Desk** (`/desk`). Stary flow **EpisodePlan = legacy**.
- **Odrzucone:** Programista `/dev` (F4 / `07_DEV_AGENT_PLAN`), Cursor Cloud Agents jako tor naprawy, merge `gema-0`.

---

## OBECNY STATUS (jedno zdanie)

**Kod:** FAZY A + B + C(bez GPU) + D(częściowo) + E wdrożone. Ciągłość: Snapshot SSOT + Take validation + Picker (PR #17 + **#20–#22**; antywzorzec Domino usunięty). AI-Inżynier MVP (sesja #21). Shared utils, security, error handling (PR #13–#16). Testy **237 pass**.  
**Bloker:** część C-GPU (IP-Adapter, realny klip, AI-gen klatki) odłożona — brak **lekkiego deploymentu ComfyUI-Minimal** (panel RunComfy, nie API).  
**Następne:** zbudować lekki deployment (`docs/RUNCOMFY_DEPLOYMENT.md`), potem TOR KOD C-GPU, smoke e2e Fazy D (3 sceny + resume na GPU) lub Faza F. Szczegóły w `11_OPUS_ARCHITECTURE_PROPOSAL.md` + `SNAPSHOT_CONTINUITY_AUDIT.md`.

> Sekcje poniżej są **archiwalne** (sesje #12–#16) — zostawione dla kontekstu historycznego.

---

## Faza 5 — checklist generatora

| Krok | Stan | Uwagi |
|------|------|-------|
| Integracja RunComfy API (submit/poll/download) | ✅ | cancel, stale, sonda `/result` |
| Klatka startowa I2V (composite → node 59) | ✅ | `compositeStartFrame.js` |
| `workflow_api_json` bez node 51 | ✅ | node 52 SaveWEBM |
| `WAN_LENGTH` konfigurowalny (domyślnie 33) | ✅ | `wanConfig.js` + `.env` |
| AI Director + kinematyka multi-beat | ✅ | `kinematicsFromPrompt.js` |
| Testy Jest (runComfy + kinematics) | ✅ | focused pass |
| Żywy render na GPU | ⚠️ | 1× WEBM OK; kolejne stale 10 min |
| Output WEBM (node 52) | ⚠️ | `45686cf6.webm` — brak powtarzalności |
| Lżejszy deployment RunComfy | ❌ | **PRIORYTET** |
| FFmpeg compositing | ❌ | po stabilnym WEBM |

---

## JAK URUCHOMIĆ

```bash
cd kebabkiller_studio2/kebabkiller
npm run dev
npm run status:dev
```

- Frontend: http://localhost:5174  
- Backend: http://localhost:4005 (`PORT` + `FRONTEND_PORT` w `backend/.env`)  
- Health: http://localhost:4005/api/health  
- Macius/Symbiont (osobno): :8787 / :4001 / :5173  

```bash
npm test --prefix backend
```

**`.env` — minimum:**
- `GROQ_API_KEY`, `VIDEO_ENGINE=runcomfy`
- `RUNCOMFY_API_KEY` + `RUNCOMFY_ENDPOINT` (V2 inference URL)
- `WAN_LENGTH=33` (smoke test)

---

## OTWARTE PROBLEMY (blokery)

1. **GPU freeze / stale po WAN21** — deployment `b36cb944…` za ciężki (~30+ custom nodes). Fix: ComfyUI-Minimal / nowy deployment.
2. **Brak powtarzalnego WEBM** — jeden sukces, potem timeout 10 min przy `WAN_LENGTH=81` (naprawione na 33).
3. **Vite LAN** — ✅ `host: true` w `frontend/vite.config.js` (telefon: IP:**5174**, ten sam Wi‑Fi).

## ROZWIĄZANE (sesja #14)

- Frontend plan odcinka: kolejność sekcji, StepGuide, auto-zapis scen, edycja tytułu, fix `canAccept`
- Mobile: karty scen, sticky Akceptuj, pasek kroków, dolna nawigacja, panel dzień/noc/rano
- `wanConfig`: WAN_LENGTH dla I2V_PRODUCTION; `.env` bez sprzeczności
- `productionQueue`: partial/failed → status planu do retry
- `audit-runcomfy.sh`: curl Windows (Git Bash)
- Backend testy: 64/64

## ROZWIĄZANE (sesja #13)

- Panel Seriale `/projects` — CRUD projektów, Style Bible, odcinki
- Polski Style Bible w `positive_prompt` → `style_tags_en` (EN) w `director.js`
- Zombie joby w Dashboard (badge „Utknięte”, próg 15 min)
- `WAN_LENGTH` 81 → 33 w `.env`
- Walidacja API projektów/odcinków (PL error messages)
- Select odcinka w Studio (`episode_id`)

## ROZWIĄZANE (sesja #12)

- Fałszywy progress 96,93% → uczciwy cap ~85%
- Polling ignorował `canceled` (US spelling)
- Sprzeczna kinematyka LLM (sitting + jump)
- `length: 144` → `WAN_LENGTH=33` domyślnie
- Regex infinite loop w `extractMotionBeatsFromPolish`

## PO GENERATORZE (później)

- FFmpeg compositing / opcjonalny stitch podglądu
- `host: true` w vite na stałe
- Wake cluster API (stub)

---

## Faza 1 serialu — checklist

| Krok | Stan | Uwagi |
|------|------|-------|
| Backend projects/episodes CRUD | ✅ | |
| Panel `/projects` UI | ✅ | ProjectEditor, EpisodeList |
| Kanon + pamięć serialowa UI | ✅ | Dashboard + SeriesMemoryPanel |
| Select odcinka w Studio | ✅ | `episode_id` w preview/render |
| Synopsis / director_notes odcinka w UI | ❌ | backlog |

---

## MAPA DROGOWA (wizja 2026-06 — szczegóły w `05_EPISODE_PIPELINE.md`)

### F1 — Plan odcinka + Scenarzysta + katalog (PRIORYTET produktowy)
- [ ] Model danych: `assets`, `asset_images`, `episode_plans`, `plan_scenes`
- [ ] UI: Plan odcinka jako pierwszy ekran
- [ ] Scenarzysta (LLM + CAPABILITIES.md)
- [ ] Sekcja „Do dostarczenia” + wrzutka do katalogu
- [ ] Walidacja planu przed akceptacją

### F0 — Silnik klipu I2V (fundament techniczny)
- [ ] Profil `I2V_PRODUCTION` (static camera, 1 beat)
- [ ] `wanConfig`: denoise, mapowanie czas → klatek per scena
- [ ] Lżejszy deployment RunComfy + smoke WEBM

### F2 — Reżyser produkcji
- [x] Plan `zaakceptowany` → kolejka renderu scen (`productionQueue.js`)
- [x] Jeden profil wizualny na odcinek (`productionDirector.js`)
- [x] `E01_manifest.json` + nazewnictwo klipów (`output/export/E01/`)

### F4 — Programista w panelu (Cursor Cloud Agents)
- [x] Plan wdrożenia v2 — `docs/07_DEV_AGENT_PLAN.md` (weryfikacja API + MCP)
- [ ] Backend proxy `/api/dev-agent/*` + SQLite wątki
- [ ] Frontend `/dev` (chat + SSE + PR link)
- [ ] Faza 2b: Kebabkiller MCP (agent → dane Studia)

### Backlog (po F2)
- [ ] **Doprecyzowanie Scenarzysty** — lepsze prompty, pętla doprecyzowania z twórcą, walidacja multi-beat w opisach scen

### F3 — Recenzja i poprawki
- [ ] Podgląd klipów, re-render pojedynczej sceny

### Faza 5 (legacy) — W TRAKCIE technicznie
- [x] Kod RunComfyEngine + workflow_api_json
- [x] AI Director kinematyka + prompt diet
- [x] Polling cancel/stale/honest progress
- [ ] **Lżejszy deployment RunComfy**
- [ ] Pierwszy stabilny `.webm` w `backend/output/`