bansosdev

CLI untuk menambahkan entri bansos ke repo bansos.dev.

Lihat bantuan CLI:

npx bansosdev --help

Mode contributor

Default mode adalah issue. Issue yang valid akan diproses GitHub Actions menjadi Pull Request otomatis.

npx bansosdev add \
  --id contoh-bansos \
  --title "Contoh Bansos Developer" \
  --provider "Provider" \
  --description "Deskripsi singkat" \
  --benefits "Benefit 1|Benefit 2" \
  --validity-type fixed \
  --validity-date 2026-06-30 \
  --validity-desc "Berlaku khusus akun baru" \
  --published-at 2026-06-13 \
  --requirements "Daftar akun|Klaim program" \
  --cta-link "https://example.com" \
  --contributor-name "Nama Kamu" \
  --contributor-url "https://example.com" \
  --tags "Cloud,Gratisan"

Parameter Masa Berlaku (Validity)

Data validity menggunakan format terstruktur untuk mempermudah filter dan tampilan UI:

• --validity-type: (Wajib) Enum: fixed | uncertain | forever.
• --validity-date: (Wajib jika type=fixed) Format ISO YYYY-MM-DD. Sistem akan otomatis men-set status menjadi expired jika waktu lokal server melebihi tanggal ini.
• --validity-desc: (Opsional) Deskripsi/catatan tambahan yang akan di-render sebagai tooltip pada UI.
• --source: (Opsional) Sumber verifikasi; bisa berupa URL atau teks biasa.

Contoh input forever (tanpa date):

npx bansosdev add ... --validity-type forever --validity-desc "Berlaku selamanya"

Mode ini akan mencetak URL issue GitHub dengan payload JSON. Setelah issue dibuat, workflow repo akan mencoba membuat Pull Request otomatis dari payload tersebut.

Maintainer mode

BANSOSDEV_GITHUB_TOKEN=ghp_xxx npx bansosdev add ... --mode direct

Mode direct membuat Pull Request otomatis dan memerlukan token dengan permission minimal:

• contents: write
• pull-requests: write
• workflows: write

Optional

Perlu cek payload dulu sebelum submit:

npx bansosdev add ... --mode json

Catatan status

Gunakan --status active untuk entry yang masih berlaku, dan --status expired untuk yang sudah berakhir.