← Back

Menambahkan Self-Update & Blog Export Tanpa AI ke DevTrace CLI

cli devtools feature python

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 upgrade harus 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 update tidak 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 install menulis ulang dist-info; git pull di 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 (bukan read -p)
  • Export template-based tanpa AI: parse data terstruktur -> blog markdown (frontmatter, overview, errors, work log, stats)
  • Session tanpa error -> tag feature + section Work Log
  • devtrace log tanpa -s -> masuk section Work 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

Last updated 31 Jul 2026 17:08

Comments