EJAAN BAHASA INDONESIA YANG DISEMPURNAKAN (EYD V)

Universal AI Agent Skill, Domain-Specific Writing Engine, Dataset Terstruktur & Linter Ekosistem Berbasis EYD Edisi Kelima

📢 Pernyataan Keterbukaan Informasi & Penafian (Disclaimer)

[!NOTE]
Status Repositori:
Repositori ini merupakan proyek independen komunitas sumber terbuka (open source) dan BUKAN repositori resmi yang dikelola langsung oleh Badan Pengembangan dan Pembinaan Bahasa maupun Kementerian Pendidikan Dasar dan Menengah Republik Indonesia (Kemendikdasmen RI).

Sumber Data & Keterbukaan Informasi:
Seluruh kaidah kebahasaan, teks pasal, butir aturan, serta contoh kalimat yang ada di repositori ini disarikan langsung dari sumber publik resmi pemerintah:

1. Laman Resmi Pedoman Ejaan Bahasa Indonesia: https://ejaan.kemendikdasmen.go.id/
2. Keputusan Kepala Badan Pengembangan dan Pembinaan Bahasa Kemendikbudristek RI Nomor 0424/I/BS.00.01/2022 tentang Pedoman Umum Ejaan Bahasa Indonesia yang Disempurnakan (EYD Edisi Kelima).
3. Kamus Besar Bahasa Indonesia (KBBI VI Daring) untuk rujukan kosakata dan leksikon baku.

Tujuan Proyek:
Repositori ini dikembangkan untuk kepentingan edukasi, keterbukaan informasi publik, standardisasi kecerdasan buatan (AI Agents), dan kemudahan akses masyarakat terhadap pedoman berbahasa Indonesia yang baik dan benar. Logo Tut Wuri Handayani disertakan sebagai bentuk atribusi identitas sumber pedoman pendidikan Republik Indonesia.

📑 Daftar Isi

• 📢 Pernyataan Keterbukaan Informasi & Penafian
• 🌟 Keunggulan Utama
• 🎯 Domain Penulisan Profesional & Sub-Skill
• 📖 Glosarium Istilah Teknologi, AI & Komputasi Awan
• Penggunaan Instan via NPX
  • 1. Memeriksa Teks atau Berkas Dokumen (Linter)
  • 2. Cek Cepat Kata Baku & Padanan Istilah
  • 3. Mode Pemantau Berkas Otomatis (Watch Mode)
  • 4. Pemasang Git Pre-Commit Hook Otomatis
  • 5. Server REST API Bawaan
  • 6. Mode Playground Interaktif di Terminal (REPL)
  • 7. Salin System Prompt Otomatis ke Clipboard
  • 8. Memasang Aturan ke AI IDE & Coding Agents
  • 9. Mencari Kaidah & Pasal Resmi
  • 10. Menjalankan MCP Server (Model Context Protocol)
• ☁️ Deployment Enterprise, Kontainer & Cloud Native
  • 1. Docker & Docker Compose
  • 2. Cloudflare Workers
  • 3. GitHub Composite Action (CI/CD)
  • 4. Konfigurasi Proyek (.eydvrc.json)
• 🌐 Progressive Web App (PWA) & Web Playground
• 💻 Penggunaan Programmatic (Node.js & TypeScript SDK)
• 🧠 AI Learning, Fine-Tuning & RAG Hub
• 🏅 Lencana Kepatuhan EYD V (Compliance Badge)
• 📂 Struktur Repositori & Pengetahuan
• 🧪 Evaluasi & Pengujian
• 💖 Dukungan & Donasi
• 🤝 Komunitas, Kontribusi & Tata Kelola
• 📄 Lisensi & Hak Cipta

🌟 Keunggulan Utama

• 🏛️ 100% Selaras Pedoman Resmi: Mencakup 38 menu tampilan dan 4 Bab utama EYD V (Penggunaan Huruf, Penulisan Kata, Penggunaan Tanda Baca, Penulisan Unsur Serapan), SK Penetapan resmi, serta Kata Pengantar Kepala Badan Bahasa.
• 🎯 6 Domain Penulisan Profesional: Modul khusus untuk UX Writing produk digital, Copywriting/Pemasaran (EPI), Penulisan SEO Organik, Karya Ilmiah/Akademik, Hukum & Regulasi, serta Bisnis & Finansial.
• 📖 Glosarium Istilah Teknologi, AI, Hukum, & Finansial (200+ Entri): Padanan baku resmi istilah komputasi awan, AI, perundang-undangan, dan pasar modal beserta contoh kalimat.
• 🎬 Dukungan Berkas Subtitle (.srt & .vtt): Pemeriksaan dialog video/film tanpa merusak struktur nomor dan stempel waktu (timestamp), serta pemulihan in-place dengan --fix.
• 💻 Ekstensi Resmi VS Code & Cursor IDE: Diagnostik real-time garis bawah bergelombang dan Quick Fix satu klik langsung di editor kode.
• 🤖 Universal Agent Skill (SKILL.md) & Sub-Skills: Siap dipasang ke Google Antigravity, Claude Code, Cursor IDE, Windsurf, Copilot, Cline, dan agen AI lainnya.
• ⚡ Model Context Protocol (MCP Server): Dilengkapi server MCP bawaan (npx eyd-v mcp) dengan tool check_spelling, search_rules, lookup_word, dan lookup_tech_term.
• Server REST API & Cloud Native: REST API mandiri tanpa dependensi luar (npx eyd-v serve), Dockerfile multi-stage, docker-compose, Cloudflare Workers endpoint, dan GitHub Actions runner.
• 📊 Indeks Keterbacaan & DevEx: Fitur skor kemudahan membaca (--score), linting git staged (--staged), format SARIF & GitHub PR Review, pemantau berkas (watch), dan pre-commit hook (hook).
• ✍️ Panduan Penulisan Alami & Anti-Slop AI: Mengeliminasi klise robotik ("di era modern ini", "sangat krusial", "menyelami") serta koma subordinatif liar sebelum kata karena/sehingga.
• 🧠 AI Fine-Tuning & Alignment Ready: Dilengkapi dataset SFT (ChatML, Alpaca), DPO (Direct Preference Optimization), UX microcopy, marketing copy, dan evaluasi penulisan ilmiah.

🎯 Domain Penulisan Profesional & Sub-Skill

Modul penulisan domain khusus yang dapat diaktifkan melalui opsi CLI --mode=<domain> atau dipasang sebagai sub-skill independen:

📖 Glosarium Istilah Teknologi, AI & Komputasi Awan

Koleksi 115+ padanan baku resmi untuk istilah teknologi modern tersedia di data/glosarium-istilah-teknologi.json dan panduan komprehensif di docs/profesional/05-glosarium-istilah-teknologi-dan-ai.md.

Beberapa contoh padanan umum:

• prompt engineering ➔ rekayasa prompt
• machine learning ➔ pembelajaran mesin
• cloud computing ➔ komputasi awan
• database ➔ basis data
• cache ➔ tembolok
• screenshot ➔ tangkapan layar
• download / upload ➔ unduh / unggah

Penggunaan Instan via NPX

Tidak memerlukan instalasi global, cukup jalankan perintah berikut di terminal:

1. Memeriksa Teks atau Berkas Dokumen (Linter)

# Periksa kalimat langsung
npx eyd-v check "Dimana kamu kuliah pasca sarjana?"

# Periksa berkas teks/markdown dan perbaiki langsung di tempat (--fix)
npx eyd-v check artikel.md --fix

# Periksa berkas dengan analisis skor keterbacaan (--score)
npx eyd-v check artikel.md --score

# Periksa berkas dengan mode domain tertentu
npx eyd-v check panduan-aplikasi.md --mode=ux
npx eyd-v check landing-page.md --mode=marketing
npx eyd-v check artikel-blog.md --mode=seo
npx eyd-v check skripsi.md --mode=academic

# Periksa perubahan file yang sudah di-stage di git (--staged)
npx eyd-v check --staged

# Periksa berkas lokalisasi i18n JSON (hanya memeriksa nilai teks)
npx eyd-v check locales/id.json

# Format anotasi bawaan GitHub Actions (--format=github)
npx eyd-v check docs/ --format=github

# Dukungan Stdin / Pipeline Unix
cat naskah.txt | npx eyd-v check
git diff | npx eyd-v check

# Keluaran JSON terstruktur untuk bot / pipeline CI/CD
npx eyd-v check "Sistem analisa ini penting, karena baru." --json

2. Cek Cepat Kata Baku & Padanan Istilah

# Cek apakah kata baku atau nonbaku menurut KBBI/EYD V
npx eyd-v kata antri
# Keluaran: Kata "antri" NONBAKU. Bentuk baku yang benar: "antre".

# Cari padanan istilah teknologi resmi
npx eyd-v istilah cache
# Keluaran: Istilah: "cache" | Padanan: "tembolok" | Kategori: Komputasi

3. Mode Pemantau Berkas Otomatis (Watch Mode)

# Pantau berkas atau direktori secara otomatis saat disimpan
npx eyd-v watch docs/
npx eyd-v watch artikel.md --fix

4. Pemasang Git Pre-Commit Hook Otomatis

# Pasang git hook pre-commit otomatis di repositori Anda
npx eyd-v hook

5. Server REST API Bawaan

# Jalankan server REST API lokal (default port 3000)
npx eyd-v serve
PORT=8080 npx eyd-v serve

6. Mode Playground Interaktif di Terminal (REPL)

npx eyd-v repl

7. Salin System Prompt Otomatis ke Clipboard

npx eyd-v prompt --copy

8. Memasang Aturan ke AI IDE & Coding Agents

# Menu interaktif pemilihan IDE:
npx eyd-v install

# Pasang ke SEMUA platform sekaligus:
npx eyd-v install --all

# Pasang ke platform spesifik:
npx eyd-v install --antigravity   # Google Antigravity (~/.gemini/config/skills/eyd-v/)
npx eyd-v install --cursor        # Cursor IDE (.cursor/rules/ & .cursorrules)
npx eyd-v install --windsurf      # Windsurf / Cascade (.windsurfrules)
npx eyd-v install --claude        # Claude Code CLI (.claude/skills/eyd-v/ & CLAUDE.md)
npx eyd-v install --copilot       # GitHub Copilot (.github/copilot-instructions.md)
npx eyd-v install --cline         # Cline / Roo Code (.clinerules)

9. Mencari Kaidah & Pasal Resmi

npx eyd-v search "tanda koma konjungsi"
npx eyd-v search "huruf kapital jabatan"
npx eyd-v search "bentuk terikat"

10. Menjalankan MCP Server (Model Context Protocol)

npx eyd-v mcp

Konfigurasi claude_desktop_config.json atau Cursor MCP:

{
  "mcpServers": {
    "eyd-v": {
      "command": "npx",
      "args": ["-y", "eyd-v", "mcp"]
    }
  }
}

☁️ Deployment Enterprise, Kontainer & Cloud Native

1. Docker & Docker Compose

Menjalankan REST API server EYD V dalam kontainer Docker:

# Menjalankan kontainer mandiri
docker build -t eyd-v .
docker run -d -p 3000:3000 --name eyd-v-api eyd-v

# Atau menggunakan Docker Compose
docker-compose up -d

Uji endpoint API:

curl -X POST http://localhost:3000/api/check   -H "Content-Type: application/json"   -d '{"text": "Dimana kamu membeli pasca sarjana?", "mode": "ux"}'

2. Cloudflare Workers

Deploy REST API serverless berkecepatan tinggi ke edge network Cloudflare:

# Masuk ke folder workers dan deploy via Wrangler
cd workers
npx wrangler deploy

3. GitHub Composite Action (CI/CD)

Tambahkan langkah pemeriksaan EYD V otomatis pada berkas .github/workflows/ci.yml:

name: Lint EYD V
on: [push, pull_request]

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Jalankan EYD V Linter
        uses: ardianryan/[email protected]
        with:
          target: "docs/"
          mode: "all"
          score: "true"

4. Konfigurasi Proyek (.eydvrc.json)

Buat berkas .eydvrc.json di akar direktori proyek Anda:

{
  "mode": "all",
  "score": true,
  "ignoreWords": ["webhook", "frontend", "backend"],
  "preferredPronoun": "Anda"
}

🌐 Progressive Web App (PWA) & Web Playground

Repositori ini menyertakan aplikasi web mandiri yang dapat digunakan secara luring (offline) berkat dukungan Progressive Web App (PWA):

• 🖥️ Buka Langsung: Buka berkas demo/index.html di browser apa pun.
• 📱 PWA Offline: Dapat diinstal ke perangkat (Chrome/Edge/Safari) dan bekerja sepenuhnya tanpa sambungan internet.
• 🎯 Selektor Domain & Skor Keterbacaan: Memilih mode UX, Marketing, SEO, atau Akademik dan menghitung indeks keterbacaan secara visual.
• ☁️ GitHub Pages: Siap diakses langsung di https://ardianryan.github.io/eyd-v/.

💻 Penggunaan Programmatic (Node.js & TypeScript SDK)

npm install eyd-v

const {
  checkEyd,
  checkSingleWord,
  lookupTechTerm,
  searchRules,
  getRuleById
} = require("eyd-v");

// 1. Memeriksa Teks
const result = checkEyd("Kita harus merubah sistem analisa ini.", {
  mode: "marketing",
  score: true
});
console.log(result.valid); // false
console.log(result.correctedText); // "Kita harus mengubah sistem analisis ini."
console.log(result.readability.readingEase); // Skor keterbacaan

// 2. Cek Cepat Kata Baku
const wordCheck = checkSingleWord("antri");
console.log(wordCheck.isBaku); // false
console.log(wordCheck.suggestion); // "antre"

// 3. Pencarian Padanan Istilah Teknologi
const term = lookupTechTerm("cache");
console.log(term.indonesian); // "tembolok"
console.log(term.category); // "Komputasi"

// 4. Mencari Kaidah EYD V
const rules = searchRules("tanda titik dua", { limit: 3 });
console.log(rules[0].title);

🧠 AI Learning, Fine-Tuning & RAG Hub

Dataset terkurasi untuk pelatihan dan evaluasi model AI tersedia di direktori data/ai-learning/:

• instruction-tuning-chatml.jsonl (321 dialog): SFT ChatML kaidah ortografi & morfologi.
• alpaca-instructions.json (271 entri): Format Alpaca standar.
• dpo-preference.jsonl (75 pasang): Preferensi DPO kaidah dasar EYD V.
• ux-microcopy-chatml.jsonl (50 dialog): SFT ChatML nada mikro-kopi UX produk digital.
• marketing-copy-dpo.jsonl (50 pasang): DPO iklan etis vs bombastis sesuai EPI.
• academic-writing-eval.jsonl (50 pengujian): Evaluasi register ilmiah baku.
• qa-evaluation.jsonl (246 pasang): Ground-truth retrieval RAG.
• eyd-v-chunks.jsonl (246 semantic chunks): Potongan semantis siap indeks ke Vector DB (Pinecone, Chroma, Qdrant, Vectorize).

Jalankan model lokal menggunakan Ollama:

ollama create eyd-v -f prompts/Modelfile
ollama run eyd-v "Sunting naskah ini: Dimana anda pasca sarjana?"

🏅 Lencana Kepatuhan EYD V (Compliance Badge)

Sematkan lencana resmi pada README.md dokumentasi proyek Anda:

[![EYD V Compliant](https://img.shields.io/badge/Bahasa%20Indonesia-EYD%20V%20Baku-28a745.svg?style=flat-square&logo=readme)](https://github.com/ardianryan/eyd-v)

📂 Struktur Repositori & Pengetahuan

eyd-v/
├── Dockerfile                        # Kontainer Node Alpine siap produksi
├── docker-compose.yml                # Orkestrasi Docker lokal
├── action.yml                        # GitHub Composite Action
├── .eydvrc.json                      # Berkas konfigurasi linter proyek
├── SKILL.md                          # Definisi Universal Agent Skill
├── package.json                      # Konfigurasi package & bin CLI
├── bin/
│   └── cli.js                        # CLI executable (check, serve, watch, hook, dll)
├── src/
│   ├── index.js                      # Programmatic SDK Library
│   ├── index.d.ts                    # Definisi TypeScript lengkap
│   ├── linter.js                     # Mesin validasi ejaan, domain & keterbacaan
│   ├── server.js                     # Peladen HTTP REST API bawaan
│   └── mcp-server.js                 # Server Model Context Protocol (stdio)
├── skills/                           # Sub-skill domain profesional
│   ├── eyd-v-ux/                     # Sub-skill UX writing
│   ├── eyd-v-marketing/              # Sub-skill Copywriting & EPI
│   ├── eyd-v-seo/                    # Sub-skill SEO organik
│   └── eyd-v-academic/               # Sub-skill karya ilmiah
├── data/
│   ├── eyd-v-all-rules.json          # Dataset lengkap seluruh pasal EYD V
│   ├── eyd-v-chunks.jsonl            # 246 semantic chunks siap RAG
│   ├── leksikon-kata-baku.json       # Kamus leksikon kata baku & aturan KTSP
│   ├── glosarium-istilah-teknologi.json # 115+ istilah teknologi & AI
│   └── ai-learning/                  # 7 dataset SFT, DPO, dan evaluasi
├── docs/
│   ├── profesional/                  # Panduan kepenulisan profesional
│   ├── 00-pendahuluan/               # SK & Kata Pengantar resmi
│   ├── 01-penggunaan-huruf/          # 8 subbab penggunaan huruf
│   ├── 02-penulisan-kata/            # 9 subbab penulisan kata
│   ├── 03-penggunaan-tanda-baca/     # 15 subbab tanda baca
│   └── 04-penulisan-unsur-serapan/   # Kaidah serapan umum & khusus
├── prompts/                          # System prompts siap pakai
├── templates/                        # Konfigurasi Cursor, Windsurf, Copilot, Cline
├── workers/                          # Endpoint Cloudflare Workers
├── tests/                            # Pengujian benchmark & fitur lanjutan
└── demo/                             # Web Playground interaktif & PWA luring

🧪 Evaluasi & Pengujian

Pengujian mencakup seluruh kasus benchmark ortografi dan fitur lanjutan v5.2.0:

npm test

Hasil pengujian:

========================================
Hasil Uji Benchmark: 33 Lulus, 0 Gagal (100% Sukses)
========================================
Seluruh 48 Pengujian Linter & Fitur Lanjutan Lulus 100%!

💖 Dukungan & Donasi

Ekosistem EYD V dikembangkan dan dipelihara secara mandiri sebagai proyek sumber terbuka (open source) demi memajukan teknologi kecerdasan buatan dan pemrosesan bahasa alami (NLP) Indonesia yang tertib, bernalar, dan berstandar ilmiah.

Jika repositori, dataset, pustaka, atau perkakas ini bermanfaat bagi pekerjaan atau riset Anda, Anda dapat mendukung keberlanjutan proyek ini melalui:

☕ Tautan Donasi: https://donate.ppti.me/

🤝 Komunitas, Kontribusi & Tata Kelola

Proyek ini menjunjung tinggi standar tata kelola proyek sumber terbuka yang transparan dan tertib:

• 📖 Panduan Kontribusi: Alur kerja fork, standar pengujian, dan tata cara pengajuan PR.
• 🛡️ Kode Etik (Code of Conduct): Standar perilaku komunitas yang inklusif dan profesional.
• 🔒 Kebijakan Keamanan (Security): Prosedur pelaporan kerentanan secara bertanggung jawab ke [email protected].
• 📜 Catatan Rilis (Changelog): Riwayat pembaruan versi mengacu pada Keep a Changelog.
• 💬 Bantuan & Dukungan: Panduan mencari solusi, berdiskusi, dan kontak pengelola.
• 📚 Panduan Sitasi (Citation): Format BibTeX dan APA untuk publikasi riset dan paper akademis.

📄 Lisensi & Hak Cipta

• Seluruh konten teks pedoman ejaan merupakan dokumen publik resmi milik Badan Pengembangan dan Pembinaan Bahasa, Kementerian Pendidikan Dasar dan Menengah Republik Indonesia.
• Perangkat lunak, skrip parsing, SDK, CLI, dan server MCP dilisensikan di bawah lisensi MIT.
• Pengelola: Ardian Ryan ([email protected]).