laporan-generator 2.6.2 → 2.7.0

package/.agents/skills/laporan-generator/scripts/report-doctor.py

@@ -2,11 +2,19 @@
 """report-doctor.py: Audit komprehensif kesehatan dan integritas proyek laporan."""
 
 import glob
+import json
 import os
 import re
 import shutil
 import sys
 
+if sys.platform == "win32":
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+    except Exception:
+        pass
+
 GREEN = "\033[0;32m"
 BLUE = "\033[0;34m"
 CYAN = "\033[0;36m"
@@ -98,101 +106,166 @@ def check_style_anomalies(markdown_files):
 
 
 def main():
-    root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-    os.chdir(root)
-
-    print(f"{CYAN}{BOLD}")
-    print("  ========================================================")
-    print("             LAPORAN GENERATOR - DOCTOR & AUDIT SUITE     ")
-    print("  ========================================================")
-    print(f"{NC}")
+    json_mode = "--json" in sys.argv
+    pos_args = [a for a in sys.argv[1:] if not a.startswith("-")]
+
+    target_dir = os.getcwd()
+    if pos_args:
+        target_dir = os.path.abspath(pos_args[0])
+    elif not (os.path.isfile(os.path.join(target_dir, "metadata.yml")) or os.path.isdir(os.path.join(target_dir, "chapters"))):
+        pkg_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+        if os.path.isfile(os.path.join(pkg_root, "metadata.yml")):
+            target_dir = pkg_root
+
+    os.chdir(target_dir)
+
+    if not json_mode:
+        print(f"{CYAN}{BOLD}")
+        print("  ========================================================")
+        print("             LAPORAN GENERATOR - DOCTOR & AUDIT SUITE     ")
+        print("  ========================================================")
+        print(f"{NC}")
 
     errors = 0
     warnings = 0
 
     # 1. Dependensi
-    print(f"  {BLUE}{BOLD}[1/4] Audit Toolchain & Dependensi Sistem{NC}")
+    if not json_mode:
+        print(f"  {BLUE}{BOLD}[1/4] Audit Toolchain & Dependensi Sistem{NC}")
     deps, has_im = check_dependencies()
+    dep_list = []
     for cmd, name, req, found in deps:
         if "ImageMagick" in name:
             continue
-        if found:
-            print(f"    {GREEN}[OK]{NC} {name:<26}: Terpasang ({cmd})")
-        else:
-            if req:
-                print(f"    {RED}[FAIL]{NC} {name:<24}: TIDAK DITEMUKAN (Wajib)")
-                errors += 1
+        dep_list.append({"command": cmd, "name": name, "required": req, "found": found})
+        if not json_mode:
+            if found:
+                print(f"    {GREEN}[OK]{NC} {name:<26}: Terpasang ({cmd})")
             else:
-                print(f"    {YELLOW}[INFO]{NC} {name:<24}: Tidak ditemukan (Opsional)")
+                if req:
+                    print(f"    {RED}[FAIL]{NC} {name:<24}: TIDAK DITEMUKAN (Wajib)")
+                else:
+                    print(f"    {YELLOW}[INFO]{NC} {name:<24}: Tidak ditemukan (Opsional)")
+        if not found and req:
+            errors += 1
 
-    if has_im:
-        print(f"    {GREEN}[OK]{NC} {'ImageMagick':<26}: Terpasang")
-    else:
-        print(f"    {YELLOW}[INFO]{NC} {'ImageMagick':<24}: Tidak ditemukan (Opsional untuk kompresi gambar)")
-    print("")
+    dep_list.append({"command": "magick/convert", "name": "ImageMagick", "required": False, "found": has_im})
+    if not json_mode:
+        if has_im:
+            print(f"    {GREEN}[OK]{NC} {'ImageMagick':<26}: Terpasang")
+        else:
+            print(f"    {YELLOW}[INFO]{NC} {'ImageMagick':<24}: Tidak ditemukan (Opsional untuk kompresi gambar)")
+        print("")
 
     # 2. Berkas & Struktur
-    print(f"  {BLUE}{BOLD}[2/4] Audit Struktur Direktori & Berkas Wajib{NC}")
+    if not json_mode:
+        print(f"  {BLUE}{BOLD}[2/4] Audit Struktur Direktori & Berkas Wajib{NC}")
     req_files = [
         "metadata.yml", "template.typ", "reference.docx",
         "references.bib", "docx.lua", "cover.md"
     ]
+    file_status = []
     for rf in req_files:
-        if os.path.isfile(rf):
-            print(f"    {GREEN}[OK]{NC} Berkas {rf}")
-        else:
-            print(f"    {RED}[FAIL]{NC} Berkas {rf} TIDAK DITEMUKAN")
+        exists = os.path.isfile(rf)
+        file_status.append({"file": rf, "found": exists})
+        if not json_mode:
+            if exists:
+                print(f"    {GREEN}[OK]{NC} Berkas {rf}")
+            else:
+                print(f"    {RED}[FAIL]{NC} Berkas {rf} TIDAK DITEMUKAN")
+        if not exists:
             errors += 1
 
     chapter_files = sorted(glob.glob("chapters/*.md"))
-    if chapter_files:
-        print(f"    {GREEN}[OK]{NC} Direktori chapters/ ({len(chapter_files)} bab ditemukan)")
-    else:
-        print(f"    {RED}[FAIL]{NC} Tidak ada berkas markdown di chapters/")
+    if not json_mode:
+        if chapter_files:
+            print(f"    {GREEN}[OK]{NC} Direktori chapters/ ({len(chapter_files)} bab ditemukan)")
+        else:
+            print(f"    {RED}[FAIL]{NC} Tidak ada berkas markdown di chapters/")
+    if not chapter_files:
         errors += 1
-    print("")
+    if not json_mode:
+        print("")
 
     # 3. Sitasi & Referensi
-    print(f"  {BLUE}{BOLD}[3/4] Audit Sitasi & Integritas Bibliografi{NC}")
+    if not json_mode:
+        print(f"  {BLUE}{BOLD}[3/4] Audit Sitasi & Integritas Bibliografi{NC}")
     bib_keys, cited_keys, missing_keys, orphan_keys = check_citations("references.bib", chapter_files)
-    print(f"    * Total entri .bib     : {len(bib_keys)}")
-    print(f"    * Total sitasi di teks : {len(cited_keys)}")
+    if not json_mode:
+        print(f"    * Total entri .bib     : {len(bib_keys)}")
+        print(f"    * Total sitasi di teks : {len(cited_keys)}")
 
     if missing_keys:
         for k, locs in missing_keys.items():
             loc_str = ", ".join([f"{f}:{l}" for f, l in locs])
-            print(f"    {RED}[ERROR]{NC} Sitasi '@{k}' TIDAK DITEMUKAN di references.bib ({loc_str})")
+            if not json_mode:
+                print(f"    {RED}[ERROR]{NC} Sitasi '@{k}' TIDAK DITEMUKAN di references.bib ({loc_str})")
             errors += 1
-    else:
+    elif not json_mode:
         print(f"    {GREEN}[OK]{NC} Semua sitasi dalam teks valid terdaftar di references.bib")
 
     if orphan_keys:
-        print(f"    {YELLOW}[WARN]{NC} {len(orphan_keys)} entri di references.bib belum disitir dalam teks:")
-        for ok in list(orphan_keys)[:5]:
-            print(f"      - @{ok}")
-        if len(orphan_keys) > 5:
-            print(f"      - ... dan {len(orphan_keys) - 5} lainnya")
+        if not json_mode:
+            print(f"    {YELLOW}[WARN]{NC} {len(orphan_keys)} entri di references.bib belum disitir dalam teks:")
+            for ok in list(orphan_keys)[:5]:
+                print(f"      - @{ok}")
+            if len(orphan_keys) > 5:
+                print(f"      - ... dan {len(orphan_keys) - 5} lainnya")
         warnings += 1
-    print("")
+    if not json_mode:
+        print("")
 
     # 4. Gambar & Format Teks
-    print(f"  {BLUE}{BOLD}[4/4] Audit Media Citra & Anomali Tipografi{NC}")
+    if not json_mode:
+        print(f"  {BLUE}{BOLD}[4/4] Audit Media Citra & Anomali Tipografi{NC}")
     total_imgs, broken_imgs = check_images(chapter_files)
     if broken_imgs:
         for p, f, l in broken_imgs:
-            print(f"    {RED}[ERROR]{NC} Berkas gambar tidak ditemukan: '{p}' (di {f}:{l})")
+            if not json_mode:
+                print(f"    {RED}[ERROR]{NC} Berkas gambar tidak ditemukan: '{p}' (di {f}:{l})")
             errors += 1
-    else:
+    elif not json_mode:
         print(f"    {GREEN}[OK]{NC} Semua tautan gambar ({total_imgs} gambar) valid dan ada di disk")
 
     anomalies = check_style_anomalies(chapter_files)
     if anomalies:
         for f, l, msg in anomalies:
-            print(f"    {YELLOW}[WARN]{NC} {f}:{l} - {msg}")
+            if not json_mode:
+                print(f"    {YELLOW}[WARN]{NC} {f}:{l} - {msg}")
             warnings += 1
-    else:
+    elif not json_mode:
         print(f"    {GREEN}[OK]{NC} Bebas dari manual heading numbering dan box-drawing characters")
-    print("")
+    if not json_mode:
+        print("")
+
+    score = 100 if (errors == 0 and warnings == 0) else (95 if errors == 0 else max(0, 90 - errors * 15 - warnings * 5))
+    status_label = "HEALTHY" if errors == 0 and warnings == 0 else ("WARNING" if errors == 0 else "ERROR")
+
+    if json_mode:
+        result = {
+            "status": status_label,
+            "score": score,
+            "errors_count": errors,
+            "warnings_count": warnings,
+            "target_dir": os.getcwd(),
+            "dependencies": dep_list,
+            "required_files": file_status,
+            "chapters_count": len(chapter_files),
+            "chapters": [os.path.basename(c) for c in chapter_files],
+            "citations": {
+                "bib_count": len(bib_keys),
+                "cited_count": len(cited_keys),
+                "missing_keys": {k: [f"{f}:{l}" for f, l in locs] for k, locs in missing_keys.items()},
+                "orphan_keys": list(orphan_keys),
+            },
+            "images": {
+                "total": total_imgs,
+                "broken": [{"path": p, "file": f, "line": l} for p, f, l in broken_imgs],
+            },
+            "anomalies": [{"file": f, "line": l, "message": msg} for f, l, msg in anomalies],
+        }
+        print(json.dumps(result, indent=2))
+        return 1 if errors > 0 else 0
 
     # Skor Kesehatan
     print("  ========================================================")

package/.agents/skills/laporan-generator/scripts/report-stats.py

@@ -2,10 +2,18 @@
 """report-stats.py: Menghitung statistik komprehensif dokumen laporan akademik."""
 
 import glob
+import json
 import os
 import re
 import sys
 
+if sys.platform == "win32":
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+    except Exception:
+        pass
+
 GREEN = "\033[0;32m"
 BLUE = "\033[0;34m"
 CYAN = "\033[0;36m"
@@ -48,8 +56,18 @@ def count_file_stats(filepath):
 
 
 def main():
-    root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-    os.chdir(root)
+    json_mode = "--json" in sys.argv
+    pos_args = [a for a in sys.argv[1:] if not a.startswith("-")]
+
+    target_dir = os.getcwd()
+    if pos_args:
+        target_dir = os.path.abspath(pos_args[0])
+    elif not (os.path.isfile(os.path.join(target_dir, "metadata.yml")) or os.path.isdir(os.path.join(target_dir, "chapters"))):
+        pkg_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+        if os.path.isfile(os.path.join(pkg_root, "metadata.yml")):
+            target_dir = pkg_root
+
+    os.chdir(target_dir)
 
     title = "Laporan Akademik"
     preset = "standard"
@@ -109,6 +127,39 @@ def main():
         sz = os.path.getsize("Laporan.docx")
         docx_size = f"{sz / 1024:.1f} KB"
 
+    if json_mode:
+        result = {
+            "title": title,
+            "preset": preset,
+            "target_dir": os.getcwd(),
+            "chapters_count": len(chapter_files),
+            "total_words": total_words,
+            "total_chars": total_chars,
+            "est_pages": est_pages,
+            "read_mins": read_mins,
+            "headings": {
+                "h1": total_h1,
+                "h2": total_h2,
+                "h3": total_h3,
+            },
+            "elements": {
+                "images": total_images,
+                "tables": total_tables,
+                "equations": total_equations,
+            },
+            "citations": {
+                "unique_cited": len(all_citations),
+                "bib_entries": bib_count,
+            },
+            "compiled_files": {
+                "pdf": pdf_size,
+                "docx": docx_size,
+            },
+            "file_breakdown": [{"filename": f, "words": c} for f, c in file_breakdown],
+        }
+        print(json.dumps(result, indent=2))
+        return
+
     print(f"{CYAN}{BOLD}")
     print("  ========================================================")
     print("                 LAPORAN GENERATOR - STATISTIK DOKUMEN    ")

package/.agents/skills/laporan-generator/scripts/test_scripts.py

@@ -1,7 +1,9 @@
 #!/usr/bin/env python3
 """test_scripts.py: Automated unit tests for Laporan Generator Python helper scripts."""
 
+import json
 import os
+import subprocess
 import sys
 import unittest
 
@@ -36,16 +38,39 @@ class TestScanPreset(unittest.TestCase):
         self.assertIn("UNIVERSITAS INDONESIA", inst)
 
 
+def get_presets_dir():
+    for c in [
+        os.path.join(ROOT_DIR, "presets"),
+        os.path.join(ROOT_DIR, "resources", "presets"),
+        os.path.join(ROOT_DIR, "..", "..", "..", "presets"),
+    ]:
+        if os.path.isdir(c):
+            return os.path.abspath(c)
+    return os.path.join(ROOT_DIR, "presets")
+
+
+def get_project_root():
+    for c in [
+        ROOT_DIR,
+        os.path.join(ROOT_DIR, "resources"),
+        os.path.join(ROOT_DIR, "..", "..", ".."),
+    ]:
+        if os.path.isfile(os.path.join(c, "metadata.yml")):
+            return os.path.abspath(c)
+    return ROOT_DIR
+
+
 class TestValidatePreset(unittest.TestCase):
     def test_parse_simple_yaml(self):
-        test_yaml = os.path.join(ROOT_DIR, "presets", "standard.yml")
+        presets_dir = get_presets_dir()
+        test_yaml = os.path.join(presets_dir, "standard.yml")
         self.assertTrue(os.path.exists(test_yaml))
         data = validate_preset.parse_simple_yaml(test_yaml)
         self.assertEqual(data.get("preset_id"), "standard")
         self.assertEqual(data.get("margin_top"), "2cm")
 
     def test_validate_all_presets(self):
-        presets_dir = os.path.join(ROOT_DIR, "presets")
+        presets_dir = get_presets_dir()
         for f in os.listdir(presets_dir):
             if f.endswith(".yml"):
                 path = os.path.join(presets_dir, f)
@@ -98,6 +123,67 @@ class TestFinalizeDocx(unittest.TestCase):
         self.assertEqual(finalize_docx.classify("BAB 2 PEMBAHASAN"), "decimal-start")
         self.assertEqual(finalize_docx.classify("BAB 3 PENUTUP"), "body")
 
+    def test_get_tab_pos(self):
+        sample_standard = '<w:sectPr><w:pgSz w:w="11906"/><w:pgMar w:left="1417" w:right="1417"/></w:sectPr>'
+        self.assertEqual(finalize_docx.get_tab_pos(sample_standard), 9072)
+        sample_4433 = '<w:sectPr><w:pgSz w:w="11906"/><w:pgMar w:left="2268" w:right="1701"/></w:sectPr>'
+        self.assertEqual(finalize_docx.get_tab_pos(sample_4433), 7937)
+        self.assertEqual(finalize_docx.get_tab_pos(""), 9072)
+
+    def test_fix_daftar_isi_title(self):
+        raw = '<w:p><w:pPr><w:pStyle w:val="Heading1"/><w:outlineLvl w:val="-1"/></w:pPr><w:r><w:t>DAFTAR ISI</w:t></w:r></w:p>'
+        fixed = finalize_docx.fix_daftar_isi_title(raw)
+        self.assertIn('w:val="TOCHeading"', fixed)
+        self.assertNotIn('w:val="Heading1"', fixed)
+
+    def test_fix_toc_styles(self):
+        styles = '<w:styles></w:styles>'
+        res = finalize_docx.fix_toc_styles(styles, 7937)
+        self.assertIn('w:styleId="TOCHeading"', res)
+        self.assertIn('w:styleId="TOC1"', res)
+        self.assertIn('w:styleId="TOC2"', res)
+        self.assertIn('w:styleId="TOC3"', res)
+        self.assertIn('w:pos="7937"', res)
+        self.assertIn('w:left="360"', res)
+        self.assertIn('w:left="720"', res)
+
+
+report_stats = __import__("report-stats")
+
+
+class TestReportStats(unittest.TestCase):
+    def test_count_file_stats_structure(self):
+        sample_md = os.path.join(get_project_root(), "cover.md")
+        if os.path.exists(sample_md):
+            stats = report_stats.count_file_stats(sample_md)
+            self.assertIsInstance(stats, dict)
+            self.assertIsInstance(stats["words"], int)
+            self.assertIsInstance(stats["chars"], int)
+            self.assertGreaterEqual(stats["words"], 0)
+
+    def test_json_stats_execution(self):
+        proj_root = get_project_root()
+        cmd = [sys.executable, os.path.join(SCRIPTS_DIR, "report-stats.py"), proj_root, "--json"]
+        proc = subprocess.run(cmd, capture_output=True, text=True, cwd=proj_root)
+        self.assertEqual(proc.returncode, 0)
+        data = json.loads(proc.stdout)
+        self.assertIn("total_words", data)
+        self.assertIn("preset", data)
+        self.assertIn("target_dir", data)
+
+
+class TestReportDoctor(unittest.TestCase):
+    def test_json_doctor_execution(self):
+        proj_root = get_project_root()
+        cmd = [sys.executable, os.path.join(SCRIPTS_DIR, "report-doctor.py"), proj_root, "--json"]
+        proc = subprocess.run(cmd, capture_output=True, text=True, cwd=proj_root)
+        data = json.loads(proc.stdout)
+        self.assertIn("status", data)
+        self.assertIn("dependencies", data)
+        self.assertIn("required_files", data)
+        self.assertIn("citations", data)
+
 
 if __name__ == "__main__":
     unittest.main(verbosity=2)
+

package/README.md

@@ -12,6 +12,7 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/laporan-generator"><img src="https://img.shields.io/npm/v/laporan-generator?style=for-the-badge&color=cb3837&logo=npm" alt="npm version"></a>
+  <a href="#dukungan-model-context-protocol-mcp"><img src="https://img.shields.io/badge/MCP-Native%20Server-8A2BE2?style=for-the-badge&logo=anthropic" alt="MCP Server"></a>
   <a href="https://github.com/muadzhdz/laporan-generator/actions/workflows/build.yml"><img src="https://github.com/muadzhdz/laporan-generator/actions/workflows/build.yml/badge.svg" alt="Status Build"></a>
   <a href="#"><img src="https://img.shields.io/badge/Typst-0.13+-239DAD?style=for-the-badge&logo=typst&logoColor=white" alt="Typst"></a>
   <a href="#"><img src="https://img.shields.io/badge/Pandoc-3.0+-blue?style=for-the-badge&logo=markdown" alt="Pandoc"></a>
@@ -110,6 +111,48 @@ npx laporan-generator sync-hosts
 
 ---
 
+## Dukungan Model Context Protocol (MCP)
+
+Laporan Generator v2.7.0 dilengkapi dengan **Native MCP Server** resmi yang berjalan melalui `stdio` berbasis protokol JSON-RPC 2.0 (spesifikasi 2024-11-05). Server ini memungkinkan AI Agent otonom (seperti Google Antigravity, Claude Desktop, Claude Code, dan OpenCode) untuk berinteraksi langsung dengan dokumen akademik melalui tools deterministik.
+
+### Konfigurasi Otomatis (Direkomendasikan)
+Cukup jalankan satu perintah berikut untuk mendaftarkan skill sekaligus konfigurasi MCP Server ke seluruh agent di mesin Anda:
+```bash
+npx laporan-generator sync-hosts
+```
+
+Perintah di atas secara aman mendaftarkan server `laporan` tanpa merusak konfigurasi server lain yang sudah ada:
+* **Antigravity CLI**: `~/.gemini/config/mcp_config.json`
+* **Claude Desktop**: `~/.config/Claude/claude_desktop_config.json`
+* **Claude Code**: `~/.claude.json`
+* **OpenCode**: `~/.config/opencode/opencode.jsonc`
+
+### Konfigurasi Manual
+Jika ingin mendaftarkan server secara manual pada klien MCP apa pun:
+```json
+{
+  "mcpServers": {
+    "laporan": {
+      "command": "npx",
+      "args": ["-y", "laporan-generator", "mcp"]
+    }
+  }
+}
+```
+
+### 6 Native Tools MCP yang Disediakan
+
+| Tool Name | Deskripsi Fungsi | Parameter Utama |
+|---|---|---|
+| `laporan_init` | Menginisialisasi dokumen baru (skripsi/makalah) secara terprogram | `target_dir`, `title`, `author`, `nim`, `institution`, `preset` |
+| `laporan_doctor` | Mengaudit integritas dependensi, berkas wajib, sitasi, dan broken media | `target_dir`, `fix` (opsional) |
+| `laporan_stats` | Menghitung statistik kata, bab, karakter, dan estimasi halaman | `target_dir` |
+| `laporan_presets` | Memeriksa daftar dan detail konfigurasi preset kampus resmi | `action` (`list` / `get`), `preset_id` |
+| `laporan_citations` | Memvalidasi integritas BibTeX dan pencarian sitasi langsung ke Crossref API | `action` (`validate` / `search`), `query`, `bib_path` |
+| `laporan_build` | Mengompilasi dokumen ke PDF (Typst) dan/atau DOCX (Word) | `format` (`all` / `pdf` / `docx`), `preset` |
+
+---
+
 ## Alur Penggunaan Cepat
 
 ### Opsi A: Alur Otonom AI Agent via NPX (Direkomendasikan)
@@ -192,6 +235,7 @@ Seluruh perintah didukung secara konsisten di NPX, Linux/macOS Bash (`./laporan`
 
 | Perintah | NPX (`npx laporan-generator`) | Bash (`./laporan`) | PowerShell (`.\laporan.ps1`) | Keterangan Fungsi |
 |---|---|---|---|---|
+| `mcp` | Didukung | Didukung | Didukung | Menjalankan Model Context Protocol (MCP) Server untuk AI Agent |
 | `init` | Didukung | Didukung | Didukung | Menyalin template berkas, metadata, dan draf bab awal |
 | `sync-hosts` | Didukung | Didukung | Didukung | Memasang skill ke seluruh direktori agen AI yang terdeteksi |
 | `setup` | Didukung | Didukung | Didukung | Memasang paket sistem Typst, Pandoc, ImageMagick, dan Python |

package/bin/laporan-generator.js

@@ -25,23 +25,29 @@ function showHelp() {
   ========================================================
          LAPORAN GENERATOR CLI (Multi-Host AI Engine)     
   ========================================================
-  Versi: 2.6.2
+  Versi: 2.7.0
   
   Penggunaan:
     npx laporan-generator <perintah> [opsi]
 
   Perintah Utama:
-    sync-hosts        Pasang/sinkronkan AI agent skills ke Antigravity, Claude, Grok
+    mcp               Jalankan Model Context Protocol (MCP) Server untuk AI Agent
+    sync-hosts        Pasang/sinkronkan AI agent skills & MCP ke Antigravity, Claude, OpenCode
     uninstall         Hapus/bersihkan skill dan perintah dari seluruh AI agent host
     setup             Jalankan installer dependensi otomatis multi-OS (Typst, Pandoc, ImageMagick)
     init              Inisialisasi template dokumen laporan/skripsi di direktori saat ini
     doctor            Audit kesehatan lingkungan dan dependensi dokumen
+    stats             Hitung statistik komprehensif dokumen (kata, bab, estimasi halaman)
     build             Kompilasi dokumen ke PDF dan DOCX
     help              Tampilkan panduan ini
   `);
 }
 
 switch (command) {
+  case 'mcp':
+  case 'server':
+    require('../lib/mcp').start();
+    break;
   case 'uninstall':
   case 'clean-skills':
     require('../lib/uninstall').run(args.slice(1));
@@ -57,11 +63,17 @@ switch (command) {
   case 'init':
     require('../lib/init').run(args.slice(1));
     break;
+  case 'stats':
+    const statsScript = path.join(__dirname, '../scripts/report-stats.py');
+    const pyStatsCmd = getPythonCommand();
+    const statsProc = spawnSync(pyStatsCmd, [statsScript, ...args.slice(1)], { stdio: 'inherit' });
+    process.exit(statsProc.status || 0);
+    break;
   case 'doctor':
   case 'check':
     const doctorScript = path.join(__dirname, '../scripts/report-doctor.py');
     const pyCmd = getPythonCommand();
-    const proc = spawnSync(pyCmd, [doctorScript], { stdio: 'inherit' });
+    const proc = spawnSync(pyCmd, [doctorScript, ...args.slice(1)], { stdio: 'inherit' });
     process.exit(proc.status || 0);
     break;
   case 'build':

package/bin/mcp-server.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+"use strict";
+
+require("../lib/mcp").start();

package/laporan

@@ -27,7 +27,7 @@ export PYTHONUTF8=1
 show_banner() {
     echo -e "${CYAN}${BOLD}"
     echo "  ========================================================"
-    echo "                 LAPORAN GENERATOR CLI v2.6.2             "
+    echo "                 LAPORAN GENERATOR CLI v2.7.0             "
     echo "     Otomatisasi Dokumen Akademik (Typst + DOCX Engine)   "
     echo "  ========================================================"
     echo -e "${NC}"
@@ -38,6 +38,7 @@ show_help() {
     echo -e "${BOLD}Penggunaan:${NC} ./laporan <perintah>"
     echo ""
     echo -e "${BOLD}Perintah yang Tersedia:${NC}"
+    echo -e "  ${GREEN}mcp${NC}          Jalankan Model Context Protocol (MCP) Server untuk AI Agent"
     echo -e "  ${GREEN}build${NC}        Kompilasi PDF dan DOCX sekaligus"
     echo -e "  ${GREEN}pdf${NC}          Kompilasi dokumen PDF (via Typst)"
     echo -e "  ${GREEN}docx${NC}         Kompilasi dokumen Microsoft Word (.docx)"
@@ -47,7 +48,7 @@ show_help() {
     echo -e "  ${GREEN}doctor${NC}       Audit kesehatan proyek (broken images, sitasi hilang, dll.)"
     echo -e "  ${GREEN}bundle${NC}       Kemas seluruh laporan (PDF, DOCX, MD) menjadi arsip zip"
     echo -e "  ${GREEN}setup${NC}        Pasang dependensi sistem otomatis (Linux, macOS, Nix, Docker)"
-    echo -e "  ${GREEN}sync-skills${NC}  Sinkronkan skill AI agent ke Antigravity, Claude, Grok"
+    echo -e "  ${GREEN}sync-skills${NC}  Sinkronkan skill AI agent & MCP ke Antigravity, Claude, OpenCode"
     echo -e "  ${GREEN}uninstall${NC}    Hapus integrasi skill dan perintah AI agent dari seluruh sistem"
     echo -e "  ${GREEN}check${NC}        Audit dependensi sistem dan struktur proyek"
     echo -e "  ${GREEN}test${NC}         Jalankan suite pengujian otomatis (test.sh)"
@@ -424,16 +425,48 @@ case "${1:-help}" in
     setup)
         bash scripts/setup-deps.sh
         ;;
+    mcp|server)
+        shift
+        if command -v node >/dev/null 2>&1; then
+            if [ -f "bin/mcp-server.js" ]; then
+                node bin/mcp-server.js "$@"
+            elif command -v npx >/dev/null 2>&1; then
+                npx -y laporan-generator mcp "$@"
+            else
+                echo "Berkas bin/mcp-server.js tidak ditemukan dan npx tidak tersedia."
+                exit 1
+            fi
+        else
+            echo "Node.js diperlukan untuk menjalankan MCP Server."
+            exit 1
+        fi
+        ;;
     sync-skills|sync-hosts)
+        shift
         if command -v node >/dev/null 2>&1; then
-            node bin/laporan-generator.js sync-hosts
+            if [ -f "bin/laporan-generator.js" ]; then
+                node bin/laporan-generator.js sync-hosts "$@"
+            elif command -v npx >/dev/null 2>&1; then
+                npx -y laporan-generator sync-hosts "$@"
+            else
+                echo "Berkas bin/laporan-generator.js tidak ditemukan dan npx tidak tersedia."
+                exit 1
+            fi
         else
             echo "Node.js diperlukan untuk sinkronisasi multi-host AI agent."
         fi
         ;;
     uninstall|clean-skills)
+        shift
         if command -v node >/dev/null 2>&1; then
-            node bin/laporan-generator.js uninstall
+            if [ -f "bin/laporan-generator.js" ]; then
+                node bin/laporan-generator.js uninstall "$@"
+            elif command -v npx >/dev/null 2>&1; then
+                npx -y laporan-generator uninstall "$@"
+            else
+                echo "Berkas bin/laporan-generator.js tidak ditemukan dan npx tidak tersedia."
+                exit 1
+            fi
         else
             echo "Node.js diperlukan untuk membersihkan integrasi AI agent."
         fi