Menambahkan Self-Update & Blog Export Tanpa AI ke DevTrace CLI
DevTrace adalah CLI untuk mencatat aktivitas debugging dan mengubahnya menjadi blog markdown yang siap di-upload. Sesi kali ini fokus pada dua hal:
(1) membuat devtrace update dan devtrace upgrade benar-benar meng-update package di semua cara instalasi (venv, pipx, atau pip system), dan
(2) membuat session — termasuk session fitur yang selama ini menghasilkan blog kosong — tetap bisa jadi blog yang berguna tanpa bantuan AI.
Work Log
- [14:53:17] Implement 2-step force-reinstall to bypass pip's equal-version skip
- [14:53:17] Add devtrace update/upgrade commands
- [14:53:18] Auto-detect install mode (venv/pipx/system)
- [14:53:22] Add devtrace export command (blog tanpa AI) + picker a=all
- [14:53:23] Fix installer confirmation prompt (read -p vs /dev/tty)
- [14:53:24] Work Log section + timeline kronologis + tag feature untuk session tanpa error
- [14:53:25] Template feature-aware (--type) + routing error ke session debug terpisah
Context
- Proyek: DevTrace CLI - tool tracking aktivitas debugging berbasis markdown (session -> blog tanpa AI)
- Masalah awal: self-update belum ada;
devtrace update/devtrace upgradeharus bisa jalan di semua cara instalasi (venv, pipx, pip system) - Skema versioning baru: 0..
- Kebutuhan lanjutan: session (terutama yang tanpa error) harus tetap bisa jadi blog yang berguna
Problem
devtrace updatetidak benar-benar meng-update package - pip skip install saat versi sama ("Requirement already satisfied")- Versi di metadata install (importlib.metadata) = 0.1.1 tidak sinkron dengan source (0.16.x) - update kode tapi versi laporan tidak berubah
- Installer tidak sadar mode venv - bisa menginstall ke lokasi yang salah atau bentrok dengan PATH sistem
- Pilih skema versioning: git-hash di versi vs manual minor + force-reinstall
- Sulit menulis blog post - butuh AI padahal belum ada
- Session tanpa error (fitur) menghasilkan blog kosong - padahal justru itu sesi yang paling sering terjadi
Investigation
- pip membandingkan versi requirement; versi sama -> dianggap sudah terinstall (skip install walaupun kode berubah)
- pipx tidak bisa upgrade VCS dengan versi sama (issue #662)
- importlib.metadata hanya ter-update saat
pip installmenulis ulang dist-info;git pulldi source tidak menyentuh metadata - parse_session hanya membaca Errors + section terisi; timeline di luar section terbuang
- read -p pada install.sh menulis prompt ke stderr, lalu dibuang
2>/dev/null-> prompt konfirmasi tak terlihat
Root Cause
- pip skip install karena versi requirement tidak berubah meski kode berubah
- metadata install tidak ikut update saat source berubah
- export tidak membaca timeline kerja (devtrace log tanpa -s ditulis di akhir file, jatuh ke section terakhir)
- Prompt konfirmasi installer tidak muncul karena stderr di-redirect
Solution
- 2-step update:
pip install(sync deps) +pip install --force-reinstall --no-deps - pipx:
install --force --pip-args=--force-reinstall - Installer venv-aware: deteksi
$VIRTUAL_ENV/.venv/proyek, fallback venv terpisah di~/.devtrace/venv/ - Prompt konfirmasi pakai
printf+ baca/dev/tty(bukanread -p) - Export template-based tanpa AI: parse data terstruktur -> blog markdown (frontmatter, overview, errors, work log, stats)
- Session tanpa error -> tag
feature+ sectionWork Log - devtrace log tanpa
-s-> masuk sectionWork Log, bukan akhir file
Insight
- Force-reinstall lebih reliable daripada versi unik per commit (jebakan urutan PEP 440)
- Skema versioning: 0..
- Data debugging terstruktur cukup untuk jadi blog tanpa perlu ngarang
- Self-update yang benar = update kode + metadata install + hooks, bukan sekadar git pull
Gotchas
- Dev venv perlu
pip install -e .agar metadata sinkron dengan source - Timeline di file disimpan newest-first; blog harus diurutkan kronologis
- read -p menulis ke stderr; jangan redirect stderr saat butuh prompt
- pipx VCS install tidak bisa upgrade versi sama tanpa
--force
Kesimpulan
Self-update yang benar ternyata bukan sekadar git pull. Package yang sudah terinstall perlu di-paksa reinstall (--force-reinstall) supaya metadata versi ikut ter-update, dan installer harus sadar lokasi instalasinya (venv aktif, .venv/ proyek, pipx, atau pip system) agar tidak meng-install ke tempat yang salah.
Di sisi blog, pelajaran terbesarnya: data terstruktur yang sudah dicatat saat debugging cukup untuk jadi blog yang layak, tanpa perlu ngarang. Cukup parse section + timeline, urutkan kronologis, dan tambahkan tag yang sesuai (feature atau kategori error). Hasilnya, session fitur yang dulu selalu terbuang kini menghasilkan blog yang sama berharganya dengan session debugging — dan setiap error yang muncul di tengah session fitur otomatis diarahkan ke session debug terpisah (debug-<nama>), supaya cerita fitur tetap murni.
Stats
- Total errors: 0
- Langkah aktivitas: 7
- Rentang waktu: 12:53:17 -> 16:53:25
Comments