tia-love/docs/rea

REA — Reverse Engineering & Analysis (Playbook)

Skill kerja untuk menganalisis logika backend proyek referensi, lalu mem-porting perilakunya ke Go di dalam tia. Definisi lengkap: docs/PRD.md §12.

Aturan (wajib, tidak bisa dinegosiasi)

1. Cek lisensi dulu — langsung dari repo sumber, sebelum membaca kode serius. Hanya proyek open source (MIT/Apache/BSD dsb). Jangan pernah menganalisis proyek closed-source.
2. Tulis ulang, jangan salin. Pelajari perilaku → implementasi sendiri dalam Go. Tidak ada copy-paste verbatim.
3. Jika terpaksa dekat dengan aslinya (mis. tabel pemetaan flag): catat di laporan sebagai "diadaptasi", sertakan atribusi di THIRD_PARTY_NOTICES.md.
4. Jangan ambil nama, logo, aset visual, atau branding proyek referensi.
5. Repo referensi di-clone ke reference/ (git-ignored). Tidak pernah ikut ter-commit.

Alur kerja

1 Scope → 2 Map → 3 Trace → 4 Spec → 5 Port → 6 Verify
                                  ↑                │
                                  └── beda perilaku ┘

Langkah	Aktivitas	Output
1. Scope	Modul & batasnya, verifikasi lisensi	Catatan scope + lisensi di laporan
2. Map	Petakan file/fungsi/struktur data relevan	Peta modul
3. Trace	Telusuri alur input → output, edge case & error path	Diagram alur + daftar edge case
4. Spec	Spesifikasi netral: input, output, aturan, tabel pemetaan, perintah Docker	docs/rea/<modul>.md + test vectors
5. Port	Implementasi ulang dalam Go (di internal/core, tanpa UI)	Kode Go + unit test
6. Verify	Uji paritas: input sama → output setara (golden/differential test)	Laporan paritas (lolos/gagal per kasus)

Definition of Done per modul

• Lisensi sumber diverifikasi & dicatat (repo, commit, lisensi)
• Laporan docs/rea/<modul>.md selesai (pakai docs/rea/TEMPLATE.md)
• Test vectors tersedia
• Implementasi Go terpisah dari UI (dipakai TUI dan CLI)
• Uji paritas lolos sesuai target (≥ 95% flag umum untuk converter)
• THIRD_PARTY_NOTICES.md diperbarui bila perlu

Indeks modul (PRD §12.6)

#	Modul	Repo	Fase	Status
1	Parser docker run → compose	composerize/composerize	3	✅ composerize.md
2	Scan stack & rekonsiliasi status	louislam/dockge	3	⬜ belum
3	Arsitektur primary ↔ agent (ide multi-host)	louislam/dockge	6	⬜ belum
4	Pola pemanggilan Docker SDK	jesseduffield/lazydocker	2, 4	⬜ belum
5	Manajemen stream/task background	jesseduffield/lazydocker	2	⬜ belum
6	Custom commands (template placeholder)	jesseduffield/lazydocker	5	⬜ belum
7	Format output docker compose ls/ps/config	docker/compose (CLI lokal)	3	⬜ belum

Repos referensi (commit yang dianalisis):

Repo	Commit	Lisensi
composerize	3e39eb7	MIT
dockge	f809ae1	MIT
lazydocker	7e7aadc	MIT

Cara memanggil modul baru

Prompt singkat: REA: analisis modul <nama> dari <repo> — agent mengikuti alur 1–6 di atas, selalu mulai dari verifikasi lisensi dan membaca docs/rea/TEMPLATE.md.