Perintah: catalog:stamp

Perintah catalog:stamp adalah instrumen penguatan integritas data dan sinyal Google E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) yang membubuhkan stempel kepengarangan (authorship provenance audit block) ke seluruh berkas ulasan produk di website afiliasi Anda. Fitur ini membuktikan bahwa katalog produk Anda dirakit dan diverifikasi melalui rantai perkakas editorial resmi CuanAff, bukan hasil scraping anonim tanpa pertanggungjawaban.

---

⚡ Fungsi Cepat

• Penguatan Sinyal Google E-E-A-T: Menyematkan blok jejak audit kepengarangan resmi (written_by: cuanaff-writer) pada frontmatter produk guna meningkatkan reputasi situs di mata algoritma mesin pencari Google.
• Audit Tanpa Merusak Data (Non-Destructive & Idempotent): Hanya memeriksa dan menandai berkas yang belum memiliki stempel; berkas yang telah memiliki stempel kepengarangan dilewati secara aman tanpa merusak metadata ulasan, foto, atau harga yang sudah tersimpan.
• Mode Simulasi Aman (Dry-Run Gate): Opsi --dry-run memungkinkan Anda meninjau daftar berkas produk yang akan ditandai sebelum perubahan fisik dituliskan ke berkas disk.
• Pelaporan Transparan & Bebas Kompromi: Berkas yang rusak atau gagal diurai oleh parser tidak disahkan secara sembarangan, melainkan dilaporkan secara terbuka (no stamp) agar Anda dapat meneliti dan memperbaikinya.
• Cakupan Fleksibel (Spesifik Situs atau Seluruh Jaringan): Dapat dijalankan untuk 1 situs target tertentu (--site) atau memindai seluruh direktori data kanonik sekaligus.

---

🏛️ Mengapa Stempel Kepengarangan E-E-A-T Sangat Krusial?

Algoritma Google Search terus memperketat pengawasan terhadap situs-situs ulasan produk (product review updates). Situs afiliasi yang memajang teks hasil salin-tempel anonim tanpa kejelasan pengarang sering kali diklasifikasikan sebagai spam atau konten dangkal (thin content).

Di CuanAff, setiap produk dirancang untuk memiliki rantai bukti kepengarangan yang nyata (provenance chain):

---
schema_version: 2
slug: baller-all-aluminium-20-inch
site_slug: tas
name: 'Baller All Aluminium 20 Inch'
brand: Baller
category: koper-kabin
price_range:
  min: 3890000
  max: 3890000
  formatted: 'Rp 3.890.000'
audit:
  written_by: cuanaff-writer
---

Dengan adanya blok audit.written_by:

1. Transparansi Sumber Produksi: Terbukti secara struktural bahwa berkas ulasan disusun melalui standar tata kelola data CuanAff yang mematuhi batas kewajaran harga dan kutipan spesifikasi resmi.
2. Kekebalan dari Penalti Mesin Pencari: Konten Anda memiliki identitas yang dapat dipertanggungjawabkan, menjadikannya aset digital jangka panjang yang stabil di halaman hasil pencarian.
3. Pemisahan Tegas Produk vs Halaman Panduan: Hanya berkas ulasan produk (data/<site>/products/*.md) yang dibubuhi stempel. Halaman panduan statis (pages) yang memiliki skema kaku sengaja tidak disentuh agar tidak memicu galat skema.

---

🛠️ Jalur A: Perintah CLI

Jalankan perintah pembubuhan stempel kepengarangan di terminal komputer Anda:

php cuanaff catalog:stamp [--site="<slug-situs>"] [--data="<path>"] [--dry-run] [--json]

Opsi Lingkup: Spesifik Situs vs Seluruh Jaringan

• Spesifik 1 Situs Target: Sertakan opsi --site="<slug>" untuk membatasi audit stempel hanya pada folder produk situs tersebut.
• Seluruh Situs Sekaligus: Jalankan perintah tanpa opsi --site, sistem CuanAff otomatis memindai seluruh folder produk di bawah direktori data kanonik.

Contoh Praktis Penggunaan:

# 1. Menjalankan simulasi aman untuk melihat produk yang belum berstempel di situs 'tas'
php cuanaff catalog:stamp --site=tas --dry-run

# 2. Membubuhkan stempel kepengarangan resmi ke seluruh produk di situs 'tas'
php cuanaff catalog:stamp --site=tas

# 3. Membubuhkan stempel kepengarangan ke seluruh situs dalam direktori data kanonik
php cuanaff catalog:stamp

# 4. Menentukan lokasi folder data kanonik kustom
php cuanaff catalog:stamp --data="data" --site=aman

# 5. Menghasilkan laporan mesin dalam format JSON terstruktur
php cuanaff catalog:stamp --site=tas --dry-run --json

Pratinjau Output Terminal (Mode Simulasi --dry-run):

  would mark 3 records
    tas/products/baller-all-aluminium-20-inch.md
    tas/products/lojel-cubo-small-21-inch.md
    tas/products/american-tourister-curio-spinner.md
3 records marked as written by the tooling.

Pratinjau Output Terminal (Eksekusi Nyata Berhasil):

  marked 3 records
    tas/products/baller-all-aluminium-20-inch.md
    tas/products/lojel-cubo-small-21-inch.md
    tas/products/american-tourister-curio-spinner.md
3 records marked as written by the tooling.

Pratinjau Output Terminal (Jika Seluruh Produk Sudah Berstempel):

  marked 0 records
0 records marked as written by the tooling.

Pratinjau Output Format JSON (--json):

{
  "schema_version": "1",
  "status": "ok",
  "command": "catalog:stamp",
  "operation_id": "5fde0d7a5a919e4f",
  "dry_run": false,
  "exit_code": 0,
  "message": "3 records marked as written by the tooling.",
  "data": {
    "marked": [
      "tas/products/baller-all-aluminium-20-inch.md",
      "tas/products/lojel-cubo-small-21-inch.md",
      "tas/products/american-tourister-curio-spinner.md"
    ],
    "unmarked": [],
    "dry_run": false
  },
  "warnings": [],
  "errors": [],
  "artifacts": []
}

---

🤖 Jalur B: Prompt AI Siap Salin

Anda dapat memanfaatkan asisten coding pintar (Antigravity, CommandCode, Cursor) atau web chat AI (ChatGPT, Claude) untuk mengaudit kepatuhan stempel kepengarangan pada katalog Anda, melakukan simulasi dry-run, dan menyematkan stempel secara otomatis.

Eksekusi Aman: Selalu Awali dengan Dry-Run

Saat bekerja bersama asisten AI, selalu mintalah AI untuk menjalankan simulasi --dry-run terlebih dahulu guna memastikan hanya berkas yang tepat yang akan dibubuhi stempel audit.

Template Prompt AI Audit Stempel Kepengarangan E-E-A-T:

Template Prompt AI (Tinggal Salin & Sesuaikan Nama Situs)

Halo AI, tolong bantu saya melakukan audit kepatuhan stempel kepengarangan (Google E-E-A-T provenance) untuk katalog produk CuanAff.

Target Audit:
- Situs Target: tas (atau ganti dengan situs aktif Anda)

Langkah-langkah yang harus dilakukan:
1. Jalankan simulasi pemeriksaan aman terlebih dahulu dengan mode dry-run dan output JSON:
   php cuanaff catalog:stamp --site=tas --dry-run --json

2. Analisis output JSON yang dihasilkan:
   - Berapa berkas produk yang masuk daftar `marked` (belum memiliki stempel kepengarangan)?
   - Apakah terdapat berkas di daftar `unmarked` (gagal dibubuhi stempel karena kesalahan parser)?

3. Jika ada berkas di daftar `marked`, sebutkan nama-nama produk tersebut, lalu minta persetujuan saya untuk menjalankan stempel resmi tanpa `--dry-run`:
   php cuanaff catalog:stamp --site=tas

4. Jika ditemukan berkas di daftar `unmarked`, periksa berkas produk bersangkutan untuk memperbaiki format YAML frontmatter-nya agar kembali valid.

Kemampuan Auto-Fix Coding Agent

Asisten coding seperti Antigravity dan CommandCode dapat membaca daftar unmarked secara otomatis, mendiagnosis baris syntax error pada file markdown yang rusak, lalu menjalankannya ulang hingga seluruh ulasan produk Anda 100% terlindungi stempel kepengarangan resmi.

---

⚙️ Parameter & Opsi Kunci

Berikut adalah seluruh opsi yang didukung oleh perintah catalog:stamp:

Parameter / Opsi	Wajib?	Bawaan	Keterangan & Fungsi	Contoh Nilai
--site="<slug>"	Opsional	Seluruh situs	Membatasi pemeriksaan dan pembubuhan stempel hanya pada situs yang disebutkan. Jika dikosongkan, seluruh situs dipindai.	--site="tas"
--data="<path>"	Opsional	data/	Menentukan direktori data kanonik yang memuat folder-folder situs ulasan.	--data="data"
--dry-run	Opsional	false	Menampilkan simulasi pratinjau daftar berkas yang akan ditandai tanpa menulis perubahan fisik ke disk.	--dry-run
--json	Opsional	false	Mengeluarkan hasil laporan audit dalam format objek JSON terstruktur (marked, unmarked, dry_run).	--json

---

🛡️ Prinsip Keamanan & Integritas Data

Perintah catalog:stamp dirancang dengan prinsip kehati-hatian tingkat tinggi (defensive data management):

1. Idempotent (Aman Dijalankan Berkali-kali):
   • Menjalankan perintah ini berulang kali tidak akan menduplikasi blok audit atau merusak struktur file yang sudah memiliki written_by.
2. Tidak Pernah Mengarang Data Baru:
   • Perintah ini hanya mencatat fakta yang sudah terbukti: bahwa berkas ulasan tersebut berada di repositori dan diproduksi oleh ekosistem CuanAff.
3. Gagal Jujur (Fail Honestly):
   • Berkas produk yang gagal diparsing atau tidak memiliki stempel setelah pemindaian tidak disahkan secara sembunyi-sembunyi, melainkan dimunculkan di log no stamp: <path> agar operator manusia mengetahuinya.

---

📱 Hasil Nyata & Langkah Selanjutnya

Setelah seluruh produk pada website afiliasi Anda dibubuhi stempel kepengarangan:

1. Kredibilitas E-E-A-T Sempurna:
   • Setiap ulasan produk kini mengantongi metadata kepengarangan resmi yang diakui oleh mesin pencari Google dan pembaca ulasan.
2. Struktur Frontmatter Rapi:
   • Blok audit tertata konsisten di bagian bawah frontmatter setiap berkas markdown produk.
3. Langkah Berikutnya dalam Alur Kerja CuanAff:
   • Verifikasi Kualitas Ulasan: Jalankan audit ulasan lengkap dengan product:validate:

     php cuanaff product:validate --site=tas

   • Audit Kesehatan SEO: Pastikan tidak ada tautan rusak sebelum rilis dengan site:audit:

     php cuanaff site:audit tas

   • Publikasikan ke Internet: Publikasikan ulasan Anda ke Cloudflare Pages dengan site:publish.