laporan-generator 2.6.1 → 2.7.0

package/.agents/skills/laporan-generator/SKILL.md

@@ -1,132 +1,122 @@
 ---
 name: laporan-generator
 description: >-
-  Universal Academic Report & Thesis Generator for AI Agents. Use when the user wants
-  to create, draft, format, or compile academic reports, thesis (skripsi/TA), internship reports (PKL),
-  or scientific papers adhering to Indonesian & international campus standards.
+  Universal Academic Report & Thesis Generator with native MCP Tools for AI Agents.
+  Use when the user wants to scaffold, draft, write, format, audit, or compile academic documents:
+  skripsi, tesis, tugas akhir (TA), laporan PKL / magang, makalah kuliah, scientific papers,
+  research proposals, or graduation reports adhering to Indonesian university standards
+  (UI, ITB, UGM, ITS, Unpad, standard 4-4-3-3).
 ---
 
-# Laporan Generator AI Agent Skill
+# Laporan Generator: World-Class Academic Document Engine for AI Agents
 
-This skill empowers AI coding agents to autonomously scaffold, draft, format, audit, and compile publication-grade academic documents using the bundled Typst and Pandoc engines.
+This skill empowers AI agents (Antigravity, Claude Code, Cursor, OpenCode, Kiro) to autonomously scaffold, author, audit, and compile publication-grade academic documents and theses using the bundled **Typst (PDF)** and **Pandoc + OpenXML (Word DOCX)** dual engines with **Native Model Context Protocol (MCP)** tools.
 
 > [!CRITICAL]
-> **DO NOT WRITE RAW TYPST FILES FROM SCRATCH (e.g. `laporan.typ` or importing `@preview/ieee`).**
-> Never attempt to craft a monolithic `.typ` file or manually configure Typst margins and headers.
-> The engine uses a battle-tested **Modular Markdown Architecture**:
-> 1. Document metadata is defined in `metadata.yml`.
-> 2. Cover, preface, and outline are in `cover.md`.
-> 3. Document body is written in **pure standard Markdown** inside `chapters/bab*.md`.
-> 4. Bibliography is stored in BibTeX format in `references.bib`.
-> 5. Compilation to PDF (via Typst) and Word DOCX (via OpenXML) is handled automatically by `./laporan build` or `bash build.sh && make docx`.
+> **MODULAR MARKDOWN ARCHITECTURE MANDATE**:
+> - **DO NOT write raw Typst code from scratch (e.g. `laporan.typ` or importing `@preview/ieee`).**
+> - **DO NOT create monolithic single-file documents.**
+> The engine is strictly designed around clean modular components:
+> 1. `metadata.yml`: Academic metadata (title, author, institution, faculty, year, campus preset).
+> 2. `cover.md`: Cover page text, approval sheet, preface (kata pengantar), and abstract.
+> 3. `chapters/`: Modular chapter files in standard Markdown (`bab1-pendahuluan.md`, `bab2-tinjauan-pustaka.md`, etc.).
+> 4. `references.bib`: Standard BibTeX citation database.
+> 5. `template.typ` & `docx.lua`: Bundled dual compilation engines.
 
 --------------------------------------------------------------------------------
 
-## 1. Resource Locations & Scaffolding
-
-The full engine and templates are bundled in `resources/` inside this skill:
-- Location: `<skill_dir>/resources/` or `~/.agents/skills/laporan-generator/resources/`
-
-### Starter & Template Files Included:
-- `metadata.yml`: Official academic metadata (title, author, institution, faculty, department, year, preset, fonts).
-- `cover.md`: Official academic cover page & abstract/kata pengantar.
-- `references.bib`: Standard academic citation database (BibTeX APA 7th).
-- `apa.csl`: APA 7th edition citation style file for Pandoc citeproc.
-- `logo.jpg`: Institution logo placeholder.
-- `chapters/`: Modular chapter templates:
-  - `chapters/bab1-pendahuluan.md`: Background, problem formulation, objectives, scope.
-  - `chapters/bab2-tinjauan-pustaka.md`: Theoretical framework, literature review.
-  - `chapters/bab3-metodologi.md`: Research design, workflow, data collection.
-  - `chapters/bab4-hasil-dan-pembahasan.md`: Implementation, experimental results, discussion.
-  - `chapters/bab5-penutup.md`: Conclusions and future work recommendations.
-- `presets/`: Campus presets:
-  - `standard.yml`: Standard university margins (2.5/2.5/2/3 cm)
-  - `skripsi-4433.yml`: National standard skripsi/thesis (4/4/3/3 cm)
-  - `ui-skripsi.yml`: Universitas Indonesia
-  - `itb-ta.yml`: Institut Teknologi Bandung
-  - `ugm-skripsi.yml`: Universitas Gadjah Mada
-  - `its-skripsi.yml`: Institut Teknologi Sepuluh Nopember
-- `template.typ`: Typst typesetting engine (dual roman/arabic pagination, inverted pyramid title).
-- `reference.docx` & `docx.lua`: Pandoc OpenXML Word engine with page breaks & table formatting.
-- `build.sh`, `laporan`, `laporan.ps1`, `Makefile`: One-click compilation scripts.
-
-### How to Scaffold a Project in Current Directory:
-If the workspace does not yet have `metadata.yml` or `chapters/`, run:
-```bash
-# Copy all templates directly from bundled resources:
-cp -r ~/.agents/skills/laporan-generator/resources/* .
-# Or if npx is available:
-npx laporan-generator init
-```
+## 1. Native MCP Tools & CLI Commands
 
---------------------------------------------------------------------------------
+When available in your environment, **always prefer calling the native MCP tools** for structured, deterministic execution:
 
-## 2. Multi-Stage Interactive Protocol (Wajib)
-
-When the user requests an academic report or thesis, execute these 3 stages:
-
-### Stage 1: Identification & Genre Selection
-Identify document type & campus target:
-1. **Laporan Proyek / Praktikum / Tugas Besar**: Standard 5 chapters (`bab1` to `bab5`).
-2. **Laporan Magang / PKL / KKN**: Executive summary, company profile, activity log, system analysis.
-3. **Tugas Akhir / Skripsi**: Formal approval sheet, bilingual abstract, TOC, list of figures/tables, standard academic bibliography.
-4. **Makalah Kuliah / Paper Akademik**: Makalah tugas kuliah di Indonesia tetap menggunakan format penomoran bab standar kampus (`BAB I`, `BAB II`, dst.) dengan angka Romawi secara default. HANYA gunakan `heading_chapter_prefix: ""` jika pengguna secara eksplisit meminta format artikel jurnal ilmiah internasional/manuskrip tanpa bab.
-
-### Stage 2: Workspace Setup & Metadata Configuration
-1. Scaffold workspace using `cp -r ~/.agents/skills/laporan-generator/resources/* .`
-2. Edit `metadata.yml` with the user's specific details:
-   - `title`: Inverted pyramid title
-   - `author`: Array of authors with name and NIM/ID
-   - `institution`, `faculty`, `department`, `year`
-   - `preset`: Select appropriate campus preset (e.g. `skripsi-4433`, `itb-ta`, `ui-skripsi`, etc.)
-3. Edit `cover.md` with appropriate preface, acknowledgments, or abstract.
-
-### Stage 3: Drafting Chapters in Pure Markdown
-Write high quality content into separate files in `chapters/`:
-- `chapters/bab1-pendahuluan.md`
-- `chapters/bab2-tinjauan-pustaka.md`
-- `chapters/bab3-metodologi.md`
-- `chapters/bab4-hasil-dan-pembahasan.md`
-- `chapters/bab5-penutup.md`
-
-#### Formatting Rules for Chapters:
-- **Headings**: Use `# Judul Bab` for chapter level (e.g. `# Pendahuluan`), `## Sub-bab` for section level.
-- **Citations**: Use Pandoc syntax `[@citekey]` matching keys in `references.bib`.
-- **Formulas**: Inline `$E = m c^2$`, block `$$\sum_{i=1}^n x_i$$`.
-- **Currencies & Special Symbols**: Escape dollar signs in body text as `\$100` or write `100 USD` so Pandoc does not parse it as LaTeX math.
-- **Images**: Store images in `gambar/` and reference them as `![Caption](gambar/file.png)`. Never reference non-existent images.
+| Action | Native MCP Tool | CLI Fallback |
+| :--- | :--- | :--- |
+| **Initialize Project** | `laporan_init({ preset, title, author_name, institution })` | `npx laporan-generator init` |
+| **Audit & Health Check** | `laporan_doctor({ target_dir })` | `./laporan doctor` or `npx laporan-generator doctor --json` |
+| **Document Stats & Metrics** | `laporan_stats({ target_dir })` | `./laporan stats` or `npx laporan-generator stats --json` |
+| **Inspect Campus Presets** | `laporan_presets({ action: "list" \| "get", preset_name })` | `./laporan preset list` |
+| **Search & Add Citations** | `laporan_citations({ action: "search_doi" \| "add_citation", query, doi })` | Manual edit `references.bib` |
+| **Compile PDF & DOCX** | `laporan_build({ format: "all" \| "pdf" \| "docx" })` | `./laporan build` or `bash build.sh && make docx` |
 
 --------------------------------------------------------------------------------
 
-## 3. Compilation & Verification Commands
+## 2. Multi-Stage Interactive Protocol (The 5-Stage Academic Production Protocol)
+
+Always guide the user through these 5 structured stages:
+
+### Stage 1: Context Discovery & Genre Selection
+Identify the document type and target university:
+1. **Tugas Akhir / Skripsi / Tesis**: Formal 5-chapter structure (BAB I - BAB V), bilingual abstract, approval sheet, standard university margins.
+2. **Laporan Magang / PKL / KKN**: Company profile, department scope, implemented system/project, troubleshooting analysis, recommendations.
+3. **Makalah Kuliah / Paper Ilmiah**: Focus on research problem, methodology, findings, and discussion. (In Indonesia, course papers use standard Roman Bab headings: `BAB I`, `BAB II`, etc.).
+4. **Target University Preset**:
+   - `skripsi-4433`: National Standard (Top 4cm, Left 4cm, Bottom 3cm, Right 3cm).
+   - `ui-skripsi`: Universitas Indonesia (Buku Panduan UI).
+   - `itb-ta`: Institut Teknologi Bandung (Pedoman TA ITB).
+   - `ugm-skripsi`: Universitas Gadjah Mada (Format Skripsi UGM).
+   - `its-skripsi`: Institut Teknologi Sepuluh Nopember.
+   - `unpad-skripsi`: Universitas Padjadjaran.
+   - `standard`: General University (2.5cm / 2cm).
+
+### Stage 2: Scaffolding & Metadata Configuration
+1. Initialize the workspace:
+   - Call MCP tool `laporan_init` or run `npx laporan-generator init`.
+2. Configure `metadata.yml`:
+   - `title`: Clear, concise, capitalized (rendered as inverted pyramid).
+   - `author`: Author array with `name` and `nim` (Student ID).
+   - `preset`: Selected university preset (e.g. `skripsi-4433`, `itb-ta`).
+   - `institution`, `faculty`, `department`, `year`.
+3. Configure `cover.md`: Set formal title, institutional affiliations, and kata pengantar.
+
+### Stage 3: Rigorous Academic Writing Standard
+When authoring content into `chapters/bab*.md`, strictly enforce **Indonesian Standard Academic Tone**:
+- **Objective & Impersonal**: Use passive constructions (*"Penelitian ini merancang sistem..."* instead of *"Saya merancang sistem..."*; *"Data diperoleh melalui pengujian..."* instead of *"Kami mengambil data..."*).
+- **Zero AI Buzzwords / Clichés**:
+  - ❌ NEVER use: *"Dalam era globalisasi dan revolusi industri 4.0 yang serba cepat...", "Hal ini tentu sangat penting dan krusial...", "Tak dapat dipungkiri bahwa..."*
+  - ✔ INSTEAD: State facts, empirical evidence, concrete problem statements, and causal relationships immediately.
+- **Heading Hygiene**:
+  - `# Judul Bab` for chapter level (e.g. `# Pendahuluan`, `# Tinjauan Pustaka`).
+  - `## Sub-bab` for section level (e.g. `## Latar Belakang Masalah`).
+  - ❌ NEVER write manual numbers in headings (e.g. NEVER `## 1.1 Latar Belakang` or `### 2.1.3 Analisis`). The engine automatically computes chapter and sub-chapter numbering based on the active university preset!
+
+### Stage 4: Citation Hygiene & Anti-Hallucination
+- **NO FAKE CITATIONS**: Never invent fake paper titles, authors, or DOIs.
+- Use MCP tool `laporan_citations` with `action: "search_doi"` to search real papers on Crossref.
+- Add verified BibTeX to `references.bib` via `laporan_citations` (`action: "add_citation"`).
+- Reference citations in markdown body using Pandoc syntax:
+  - Single citation: `[@citekey]`
+  - Narrative citation: `@citekey menyatakan bahwa...`
+  - Multiple citations: `[@citekey1; @citekey2]`
+
+### Stage 5: Pre-Flight Audit & Dual-Compilation
+1. Run pre-flight health audit:
+   - Call MCP tool `laporan_doctor` or run `./laporan doctor`.
+   - Ensure `missing_keys` is 0 and `broken_images` is 0.
+2. Compile both outputs:
+   - Call MCP tool `laporan_build` or run `./laporan build`.
+   - Produces:
+     - `Laporan.pdf`: Pixel-perfect publication PDF rendered by Typst.
+     - `Laporan.docx`: Fully formatted Word document with dual page numbering (Roman `i, ii, iii` for front-matter, Arabic `1, 2, 3` for chapters) and native Word Table of Contents.
 
-Compile both PDF & Word DOCX:
-```bash
-./laporan build
-# Atau manual:
-bash build.sh && make docx
-```
+--------------------------------------------------------------------------------
 
-Audit document health & check for broken images or missing citation keys:
-```bash
-./laporan doctor
-# Atau:
-python3 scripts/report-doctor.py
-```
+## 3. Formatting Rules & Syntax Guardrails
 
-Analyze word count, statistics & distribution:
-```bash
-./laporan stats
-```
+| Element | Correct Syntax | Common Pitfall to Avoid |
+| :--- | :--- | :--- |
+| **Currencies & Special Symbols** | `\$100` or `100 USD` | Unescaped `$100` triggers math mode parsing failure |
+| **Mathematical Formulas** | Inline: `$E = m c^2$`<br/>Block: `$$\\sum_{i=1}^n x_i$$` | Multiple unescaped `$` on the same page |
+| **Images & Figures** | `![Diagram Arsitektur](gambar/arsitektur.png)` | Referencing non-existent files or absolute paths |
+| **Tables** | Standard Markdown pipe tables with headers | Box-drawing characters (┌, ─, └, │) in markdown |
+| **Code Blocks** | Standard triple backticks with language specifier | Monolithic raw typst code |
 
 --------------------------------------------------------------------------------
 
-## 4. Common AI Pitfalls to Avoid
+## 4. Troubleshooting & Self-Correction Runbook
 
-| Pitfall | Why It Fails | Correct Solution |
-| :--- | :--- | :--- |
-| **Writing `.typ` files manually** | Creates syntax errors, breaks DOCX export, loses presets | Always write Markdown in `chapters/bab*.md` and let the engine compile. |
-| **`#import "@preview/ieee"`** | Offline environments fail with package not found | Use the bundled self-contained `template.typ`. |
-| **Unescaped `$` in text** | Treated as math mode delimiter causing syntax errors | Use `\$10,000` or text `10,000 USD`. |
-| **Missing images** | Referenced images not present cause build failure | Ensure images exist in `gambar/` before referencing. |
-| **Monolithic single file** | Incompatible with multi-pass DOCX and chapter numbering | Keep chapters strictly split into `chapters/bab*.md`. |
+- **Missing Pandoc or Typst**:
+  - Run `npx laporan-generator setup` to automatically install dependencies for Ubuntu/Debian, Arch Linux, macOS, Nix, or Windows.
+- **Citation "@key" not found**:
+  - Call `laporan_citations({ action: "validate" })` to check all existing keys in `references.bib`.
+- **Word DOCX Table of Contents alignment**:
+  - Built-in `finalize-docx.py` automatically computes page width and right-aligns tab leader dots for Heading 1, Heading 2, and Heading 3.

package/.agents/skills/laporan-generator/resources/build.sh

@@ -85,7 +85,7 @@ if ! pandoc \
   --metadata=reference-section-title="DAFTAR PUSTAKA" \
   --top-level-division=chapter \
   --pdf-engine=typst \
-  --syntax-highlighting=none \
+  --no-highlight \
   -o "$REPORT" 2>&1; then
   echo ""
   echo "[ERROR] BUILD GAGAL: Terjadi kesalahan saat kompilasi Pandoc/Typst."

package/.agents/skills/laporan-generator/resources/laporan

@@ -27,7 +27,7 @@ export PYTHONUTF8=1
 show_banner() {
     echo -e "${CYAN}${BOLD}"
     echo "  ========================================================"
-    echo "                 LAPORAN GENERATOR CLI v2.6.0             "
+    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, Gemini, 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

package/.agents/skills/laporan-generator/resources/laporan.ps1

@@ -9,7 +9,9 @@ param (
     [Parameter(Position=2)]
     [string]$Arg1 = "",
     [Parameter(Position=3)]
-    [string]$Arg2 = ""
+    [string]$Arg2 = "",
+    [Parameter(ValueFromRemainingArguments=$true)]
+    [string[]]$RemainingArgs
 )
 
 $ErrorActionPreference = "Stop"
@@ -38,7 +40,7 @@ function Get-PythonCommand {
 
 function Show-Banner {
     Write-Host "  ========================================================" -ForegroundColor Cyan
-    Write-Host "                 LAPORAN GENERATOR CLI v2.6.0             " -ForegroundColor Cyan
+    Write-Host "                 LAPORAN GENERATOR CLI v2.7.0             " -ForegroundColor Cyan
     Write-Host "     Otomatisasi Dokumen Akademik (Typst + DOCX Engine)   " -ForegroundColor Cyan
     Write-Host "  ========================================================" -ForegroundColor Cyan
     Write-Host ""
@@ -58,7 +60,7 @@ function Show-Help {
     Write-Host "  doctor       Audit kesehatan proyek (broken images, sitasi hilang, dll.)" -ForegroundColor Green
     Write-Host "  bundle       Kemas seluruh laporan (PDF, DOCX, MD) menjadi arsip zip" -ForegroundColor Green
     Write-Host "  setup        Pasang dependensi sistem otomatis Windows (Typst, Pandoc, Magick)" -ForegroundColor Green
-    Write-Host "  sync-skills  Sinkronkan skill AI agent ke Antigravity, Claude, Gemini, Grok" -ForegroundColor Green
+    Write-Host "  sync-skills  Sinkronkan skill AI agent ke Antigravity, Claude, Grok" -ForegroundColor Green
     Write-Host "  check        Audit dependensi sistem dan struktur proyek" -ForegroundColor Green
     Write-Host "  test         Jalankan suite pengujian otomatis" -ForegroundColor Green
     Write-Host "  view         Buka dokumen Laporan.pdf di PDF viewer" -ForegroundColor Green
@@ -164,7 +166,7 @@ function Cmd-Build-PDF {
     $pandocArgs += "--metadata=reference-section-title=DAFTAR PUSTAKA"
     $pandocArgs += "--top-level-division=chapter"
     $pandocArgs += "--pdf-engine=typst"
-    $pandocArgs += "--syntax-highlighting=none"
+    $pandocArgs += "--no-highlight"
     $pandocArgs += @("-o", "Laporan.pdf")
 
     & pandoc $pandocArgs
@@ -334,22 +336,29 @@ preset: "$escPreset"
     Write-Host "Jalankan '.\laporan.ps1 build' untuk mulai menghasilkan laporan." -ForegroundColor Cyan
 }
 
-function Cmd-Test {
-    Show-Banner
-    Write-Host "Menjalankan Test Suite..." -ForegroundColor Blue
-    $gitBash = "C:\Program Files\Git\bin\bash.exe"
-    $bashCmd = if (Test-Path $gitBash) { $gitBash } elseif ((Get-Command "bash" -ErrorAction SilentlyContinue) -and (Get-Command "bash").Source -notmatch "system32\\bash\.exe") { "bash" } else { "" }
-    if ($bashCmd) {
-        & $bashCmd test.sh
-    } else {
-        $pyCmd = Get-PythonCommand
-        if ($pyCmd) {
-            Write-Host "Menjalankan validasi skema preset..." -ForegroundColor Blue
-            & $pyCmd scripts/validate-preset.py --all
-        } else {
-            Write-Host "Test suite membutuhkan bash atau python3." -ForegroundColor Yellow
-        }
-    }
+function Cmd-Test {
+    Show-Banner
+    Write-Host "Menjalankan Test Suite..." -ForegroundColor Blue
+    $gitBash = "C:\Program Files\Git\bin\bash.exe"
+    $bashCmd = if (Test-Path $gitBash) { $gitBash } elseif ((Get-Command "bash" -ErrorAction SilentlyContinue) -and (Get-Command "bash").Source -notmatch "system32\\bash\.exe") { "bash" } else { "" }
+    if ($bashCmd -and (Test-Path "test.sh")) {
+        & $bashCmd test.sh
+    } else {
+        $pyCmd = Get-PythonCommand
+        if ($pyCmd) {
+            Write-Host "Menjalankan validasi skema preset..." -ForegroundColor Blue
+            if (Test-Path "scripts/validate-preset.py") {
+                & $pyCmd scripts/validate-preset.py --all
+            }
+            if (Test-Path "scripts/test_scripts.py") {
+                Write-Host ""
+                Write-Host "Menjalankan unit test skrip Python..." -ForegroundColor Blue
+                & $pyCmd scripts/test_scripts.py
+            }
+        } else {
+            Write-Host "Test suite membutuhkan bash atau python3." -ForegroundColor Yellow
+        }
+    }
 }
 
 function Cmd-Preset {
@@ -446,27 +455,30 @@ function Cmd-Clean {
 }
 
 function Cmd-Stats {
+    param([string[]]$ArgsList)
     $pyCmd = Get-PythonCommand
     if ($pyCmd) {
-        & $pyCmd scripts/report-stats.py
+        & $pyCmd scripts/report-stats.py @ArgsList
     } else {
         Write-Host "Error: Python 3 tidak ditemukan." -ForegroundColor Red
     }
 }
 
 function Cmd-Doctor {
+    param([string[]]$ArgsList)
     $pyCmd = Get-PythonCommand
     if ($pyCmd) {
-        & $pyCmd scripts/report-doctor.py
+        & $pyCmd scripts/report-doctor.py @ArgsList
     } else {
         Write-Host "Error: Python 3 tidak ditemukan." -ForegroundColor Red
     }
 }
 
 function Cmd-Bundle {
+    param([string[]]$ArgsList)
     $pyCmd = Get-PythonCommand
     if ($pyCmd) {
-        & $pyCmd scripts/bundle.py
+        & $pyCmd scripts/bundle.py @ArgsList
     } else {
         Write-Host "Error: Python 3 tidak ditemukan." -ForegroundColor Red
     }
@@ -518,25 +530,59 @@ function Cmd-Watch {
     }
 }
 
+$extraArgs = @()
+if ($SubCommand) { $extraArgs += $SubCommand }
+if ($Arg1) { $extraArgs += $Arg1 }
+if ($Arg2) { $extraArgs += $Arg2 }
+if ($RemainingArgs) { $extraArgs += $RemainingArgs }
+
 switch ($Command.ToLower()) {
     "build"  { Cmd-Build }
     "pdf"    { Cmd-Build-PDF }
     "docx"   { Cmd-Build-DOCX }
     "init"   { Cmd-Init }
-    "stats"  { Cmd-Stats }
-    "doctor" { Cmd-Doctor }
-    "bundle"      { Cmd-Bundle }
-    "setup"       { & powershell -ExecutionPolicy Bypass -File (Join-Path $PSScriptRoot "scripts\setup-deps.ps1") }
+    "stats"  { Cmd-Stats $extraArgs }
+    "doctor" { Cmd-Doctor $extraArgs }
+    "bundle" { Cmd-Bundle $extraArgs }
+    "setup"  { & powershell -ExecutionPolicy Bypass -File (Join-Path $PSScriptRoot "scripts\setup-deps.ps1") }
+    "mcp"    {
+        if (Get-Command "node" -ErrorAction SilentlyContinue) {
+            $mcpPath = Join-Path $PSScriptRoot "bin\mcp-server.js"
+            if (Test-Path $mcpPath) {
+                node $mcpPath @extraArgs
+            } elseif (Get-Command "npx" -ErrorAction SilentlyContinue) {
+                npx -y laporan-generator mcp @extraArgs
+            } else {
+                Write-Host "bin\mcp-server.js tidak ditemukan dan npx tidak tersedia." -ForegroundColor Red
+            }
+        } else {
+            Write-Host "Node.js diperlukan untuk menjalankan MCP Server." -ForegroundColor Yellow
+        }
+    }
     "sync-skills" { 
         if (Get-Command "node" -ErrorAction SilentlyContinue) {
-            node (Join-Path $PSScriptRoot "bin\laporan-generator.js") sync-hosts
+            $genPath = Join-Path $PSScriptRoot "bin\laporan-generator.js"
+            if (Test-Path $genPath) {
+                node $genPath sync-hosts @extraArgs
+            } elseif (Get-Command "npx" -ErrorAction SilentlyContinue) {
+                npx -y laporan-generator sync-hosts @extraArgs
+            } else {
+                Write-Host "bin\laporan-generator.js tidak ditemukan dan npx tidak tersedia." -ForegroundColor Red
+            }
         } else {
             Write-Host "Node.js diperlukan untuk sinkronisasi multi-host AI agent." -ForegroundColor Yellow
         }
     }
     "sync-hosts"  {
         if (Get-Command "node" -ErrorAction SilentlyContinue) {
-            node (Join-Path $PSScriptRoot "bin\laporan-generator.js") sync-hosts
+            $genPath = Join-Path $PSScriptRoot "bin\laporan-generator.js"
+            if (Test-Path $genPath) {
+                node $genPath sync-hosts @extraArgs
+            } elseif (Get-Command "npx" -ErrorAction SilentlyContinue) {
+                npx -y laporan-generator sync-hosts @extraArgs
+            } else {
+                Write-Host "bin\laporan-generator.js tidak ditemukan dan npx tidak tersedia." -ForegroundColor Red
+            }
         } else {
             Write-Host "Node.js diperlukan untuk sinkronisasi multi-host AI agent." -ForegroundColor Yellow
         }

package/.agents/skills/laporan-generator/resources/scripts/bundle.py

@@ -15,8 +15,17 @@ NC = "\033[0m"
 
 
 def main():
-    root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-    os.chdir(root)
+    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)
 
     print(f"{CYAN}{BOLD}")
     print("  ========================================================")