laporan-generator 2.6.2 → 2.8.0

package/lib/sync-hosts.js

@@ -1,9 +1,9 @@
-'use strict';
+"use strict";
 
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { removeRecursiveSync, parseJsonc } = require('./uninstall');
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const { removeRecursiveSync, parseJsonc } = require("./uninstall");
 
 function copyRecursiveSync(src, dest) {
   if (!fs.existsSync(src)) return;
@@ -20,28 +20,154 @@ function copyRecursiveSync(src, dest) {
   }
 }
 
+function syncInternalResources(packageRoot) {
+  const skillRoot = path.join(packageRoot, ".agents/skills/laporan-generator");
+  const resDir = path.join(skillRoot, "resources");
+  const skillScriptsDir = path.join(skillRoot, "scripts");
+  const resScriptsDir = path.join(resDir, "scripts");
+  const resPresetsDir = path.join(resDir, "presets");
+
+  fs.mkdirSync(resDir, { recursive: true });
+  fs.mkdirSync(skillScriptsDir, { recursive: true });
+  fs.mkdirSync(resScriptsDir, { recursive: true });
+  fs.mkdirSync(resPresetsDir, { recursive: true });
+
+  // 1. Sync scripts from root scripts/
+  const srcScripts = path.join(packageRoot, "scripts");
+  if (fs.existsSync(srcScripts)) {
+    for (const f of fs.readdirSync(srcScripts)) {
+      if (f.startsWith("__pycache__") || f.endsWith(".pyc")) continue;
+      const srcFile = path.join(srcScripts, f);
+      copyRecursiveSync(srcFile, path.join(skillScriptsDir, f));
+      copyRecursiveSync(srcFile, path.join(resScriptsDir, f));
+    }
+  }
+
+  // 2. Sync presets from root presets/
+  const srcPresets = path.join(packageRoot, "presets");
+  if (fs.existsSync(srcPresets)) {
+    copyRecursiveSync(srcPresets, resPresetsDir);
+  }
+
+  // 3. Sync template files
+  const templateFiles = [
+    "template.typ",
+    "reference.docx",
+    "docx.lua",
+    "references.bib",
+    "apa.csl",
+    "metadata.yml",
+    "cover.md",
+    "logo.jpg",
+    "Makefile",
+    "build.sh",
+    "build-docx.sh",
+    "laporan",
+    "laporan.ps1"
+  ];
+
+  for (const tf of templateFiles) {
+    const src = path.join(packageRoot, tf);
+    if (fs.existsSync(src)) {
+      fs.copyFileSync(src, path.join(resDir, tf));
+    }
+  }
+}
+
+function registerMcpServers(packageRoot, home) {
+  const mcpBin = path.join(packageRoot, "bin/mcp-server.js");
+
+  // 1. Antigravity MCP (~/.gemini/config/mcp_config.json)
+  const agyMcpPath = path.join(home, ".gemini/config/mcp_config.json");
+  try {
+    let agyConfig = { mcpServers: {} };
+    if (fs.existsSync(agyMcpPath)) {
+      try {
+        agyConfig = JSON.parse(fs.readFileSync(agyMcpPath, "utf8"));
+      } catch (_) {
+        agyConfig = { mcpServers: {} };
+      }
+    }
+    if (!agyConfig.mcpServers) agyConfig.mcpServers = {};
+    agyConfig.mcpServers["laporan"] = {
+      command: "node",
+      args: [mcpBin],
+      disabled: false
+    };
+    fs.mkdirSync(path.dirname(agyMcpPath), { recursive: true });
+    fs.writeFileSync(agyMcpPath, JSON.stringify(agyConfig, null, 2), "utf8");
+    console.log("  ✔ [ANTIGRAVITY MCP] Registered server \"laporan\" -> ~/.gemini/config/mcp_config.json");
+  } catch (err) {
+    console.log("  ✖ [ANTIGRAVITY MCP SKIP] " + err.message);
+  }
+
+  // 2. Claude Desktop & Claude Code (~/.config/Claude/claude_desktop_config.json, ~/.claude.json)
+  const claudePaths = [
+    path.join(home, ".config/Claude/claude_desktop_config.json"),
+    path.join(home, ".claude.json")
+  ];
+  for (const cPath of claudePaths) {
+    try {
+      let conf = { mcpServers: {} };
+      if (fs.existsSync(cPath)) {
+        try {
+          conf = JSON.parse(fs.readFileSync(cPath, "utf8"));
+        } catch (_) {}
+      }
+      if (!conf.mcpServers) conf.mcpServers = {};
+      conf.mcpServers["laporan"] = {
+        command: "node",
+        args: [mcpBin]
+      };
+      fs.mkdirSync(path.dirname(cPath), { recursive: true });
+      fs.writeFileSync(cPath, JSON.stringify(conf, null, 2), "utf8");
+      console.log("  ✔ [CLAUDE MCP] Registered server \"laporan\" -> " + cPath);
+    } catch (_) {}
+  }
+
+  // 3. OpenCode (~/.config/opencode/opencode.jsonc)
+  const opencodeConfigPath = path.join(home, ".config/opencode/opencode.jsonc");
+  if (fs.existsSync(opencodeConfigPath)) {
+    try {
+      const raw = fs.readFileSync(opencodeConfigPath, "utf8");
+      const opencodeConfig = parseJsonc(raw);
+      if (!opencodeConfig.mcpServers) opencodeConfig.mcpServers = {};
+      opencodeConfig.mcpServers["laporan"] = {
+        command: "node",
+        args: [mcpBin]
+      };
+      fs.writeFileSync(opencodeConfigPath, JSON.stringify(opencodeConfig, null, 2), "utf8");
+      console.log("  ✔ [OPENCODE MCP] Registered MCP server \"laporan\" -> ~/.config/opencode/opencode.jsonc");
+    } catch (_) {}
+  }
+}
+
 function run(argv = []) {
   const home = os.homedir();
-  const packageRoot = path.join(__dirname, '..');
-  const skillGeneratorSource = path.join(packageRoot, '.agents/skills/laporan-generator');
-  const workflowSource = path.join(packageRoot, '.agents/workflows/laporan-generator.md');
+  const packageRoot = path.join(__dirname, "..");
+  const skillGeneratorSource = path.join(packageRoot, ".agents/skills/laporan-generator");
+  const workflowSource = path.join(packageRoot, ".agents/workflows/laporan-generator.md");
 
-  console.log('\n==========================================================');
-  console.log('   LAPORAN GENERATOR - AI AGENT SKILLS SYNCHRONIZER       ');
-  console.log('==========================================================\n');
+  console.log("\n==========================================================");
+  console.log("   LAPORAN GENERATOR - AI AGENT SKILLS & MCP SYNC         ");
+  console.log("==========================================================\n");
 
-  // Bersihkan alias lama/duplikat 'laporan' agar tidak dobel dengan 'laporan-generator'
+  // Step 0: Sinkronisasi berkas internal sebelum distribusi
+  syncInternalResources(packageRoot);
+  console.log("  ✔ [INTERNAL SYNC] Root scripts & templates synced to .agents/skills/laporan-generator");
+
+  // Bersihkan alias lama/duplikat laporan agar tidak dobel dengan laporan-generator
   const legacyDuplicates = [
-    path.join(home, '.agents/skills/laporan'),
-    path.join(home, '.gemini/config/skills/laporan'),
-    path.join(home, '.claude/skills/laporan'),
-    path.join(home, '.grok/skills/laporan'),
-    path.join(home, '.config/opencode/skills/laporan'),
-    path.join(process.cwd(), '.agents/skills/laporan'),
-    path.join(home, '.kiro/agents/laporan.json'),
-    path.join(home, '.agents/workflows/laporan.md'),
-    path.join(process.cwd(), '.agents/workflows/laporan.md'),
-    path.join(home, '.claude/commands/laporan.md')
+    path.join(home, ".agents/skills/laporan"),
+    path.join(home, ".gemini/config/skills/laporan"),
+    path.join(home, ".claude/skills/laporan"),
+    path.join(home, ".grok/skills/laporan"),
+    path.join(home, ".config/opencode/skills/laporan"),
+    path.join(process.cwd(), ".agents/skills/laporan"),
+    path.join(home, ".kiro/agents/laporan.json"),
+    path.join(home, ".agents/workflows/laporan.md"),
+    path.join(process.cwd(), ".agents/workflows/laporan.md"),
+    path.join(home, ".claude/commands/laporan.md")
   ];
   for (const legacy of legacyDuplicates) {
     if (fs.existsSync(legacy)) {
@@ -51,28 +177,28 @@ function run(argv = []) {
 
   const targets = [
     {
-      name: 'Global Agents (~/.agents/skills/)',
-      skillsDir: path.join(home, '.agents/skills')
+      name: "Global Agents (~/.agents/skills/)",
+      skillsDir: path.join(home, ".agents/skills")
     },
     {
-      name: 'Antigravity CLI (~/.gemini/config/skills/)',
-      skillsDir: path.join(home, '.gemini/config/skills')
+      name: "Antigravity CLI (~/.gemini/config/skills/)",
+      skillsDir: path.join(home, ".gemini/config/skills")
     },
     {
-      name: 'Claude Code (~/.claude/skills/)',
-      skillsDir: path.join(home, '.claude/skills')
+      name: "Claude Code (~/.claude/skills/)",
+      skillsDir: path.join(home, ".claude/skills")
     },
     {
-      name: 'Grok CLI (~/.grok/skills/)',
-      skillsDir: path.join(home, '.grok/skills')
+      name: "Grok CLI (~/.grok/skills/)",
+      skillsDir: path.join(home, ".grok/skills")
     },
     {
-      name: 'OpenCode (~/.config/opencode/skills/)',
-      skillsDir: path.join(home, '.config/opencode/skills')
+      name: "OpenCode (~/.config/opencode/skills/)",
+      skillsDir: path.join(home, ".config/opencode/skills")
     },
     {
-      name: 'Local Project Workspace (.agents/skills/)',
-      skillsDir: path.join(process.cwd(), '.agents/skills')
+      name: "Local Project Workspace (.agents/skills/)",
+      skillsDir: path.join(process.cwd(), ".agents/skills")
     }
   ];
 
@@ -80,7 +206,7 @@ function run(argv = []) {
 
   for (const target of targets) {
     try {
-      const destGen = path.join(target.skillsDir, 'laporan-generator');
+      const destGen = path.join(target.skillsDir, "laporan-generator");
       copyRecursiveSync(skillGeneratorSource, destGen);
       console.log(`  ✔ [INSTALLED] ${target.name} (with full templates & resources)`);
       installedCount++;
@@ -90,25 +216,24 @@ function run(argv = []) {
   }
 
   // Daftarkan Slash Command ke OpenCode (~/.config/opencode/opencode.jsonc)
-  const opencodeConfigPath = path.join(home, '.config/opencode/opencode.jsonc');
+  const opencodeConfigPath = path.join(home, ".config/opencode/opencode.jsonc");
   try {
     let opencodeConfig = {};
     if (fs.existsSync(opencodeConfigPath)) {
-      const raw = fs.readFileSync(opencodeConfigPath, 'utf8');
+      const raw = fs.readFileSync(opencodeConfigPath, "utf8");
       try {
         opencodeConfig = parseJsonc(raw);
       } catch (_) {
         opencodeConfig = {};
       }
     }
-    opencodeConfig['$schema'] = 'https://opencode.ai/config.json';
+    opencodeConfig["$schema"] = "https://opencode.ai/config.json";
     if (!opencodeConfig.command) {
       opencodeConfig.command = {};
     }
-    // Hapus command 'laporan' jika ada duplikat sebelumnya
-    delete opencodeConfig.command['laporan'];
+    delete opencodeConfig.command["laporan"];
 
-    opencodeConfig.command['laporan-generator'] = {
+    opencodeConfig.command["laporan-generator"] = {
       description: "Universal Academic Report & Thesis Generator",
       template: "Gunakan skill laporan-generator untuk membuat atau mengompilasi dokumen laporan/skripsi akademik: $ARGUMENTS"
     };
@@ -117,62 +242,62 @@ function run(argv = []) {
       opencodeConfig.skills = {};
     }
     const skillPaths = new Set(opencodeConfig.skills.paths || []);
-    skillPaths.add(path.join(home, '.agents/skills'));
-    skillPaths.add(path.join(home, '.config/opencode/skills'));
+    skillPaths.add(path.join(home, ".agents/skills"));
+    skillPaths.add(path.join(home, ".config/opencode/skills"));
     opencodeConfig.skills.paths = Array.from(skillPaths);
 
     const opencodeDir = path.dirname(opencodeConfigPath);
     if (!fs.existsSync(opencodeDir)) {
       fs.mkdirSync(opencodeDir, { recursive: true });
     }
-    fs.writeFileSync(opencodeConfigPath, JSON.stringify(opencodeConfig, null, 2), 'utf8');
-    console.log(`  ✔ [OPENCODE] Registered /laporan-generator command -> ~/.config/opencode/opencode.jsonc`);
+    fs.writeFileSync(opencodeConfigPath, JSON.stringify(opencodeConfig, null, 2), "utf8");
+    console.log("  ✔ [OPENCODE] Registered /laporan-generator command -> ~/.config/opencode/opencode.jsonc");
   } catch (err) {
-    console.log(`  ✖ [OPENCODE SKIP] ${err.message}`);
+    console.log("  ✖ [OPENCODE SKIP] " + err.message);
   }
 
   // Daftarkan Custom Agent ke Kiro CLI (~/.kiro/agents/laporan-generator.json)
-  const kiroAgentsDir = path.join(home, '.kiro/agents');
+  const kiroAgentsDir = path.join(home, ".kiro/agents");
   try {
     if (!fs.existsSync(kiroAgentsDir)) {
       fs.mkdirSync(kiroAgentsDir, { recursive: true });
     }
     const kiroPrompt = [
-      "You are an expert academic writing assistant powered by Laporan Generator.",
+      "You are an expert academic writing assistant powered by Laporan Generator and Native MCP Tools.",
       "",
       "CRITICAL INSTRUCTION: DO NOT write raw Typst code from scratch or create standalone .typ files (such as laporan.typ). DO NOT import @preview/ieee or external packages.",
       "",
       "Always follow the Modular Markdown Architecture:",
-      "1. Scaffolding: If the workspace lacks templates, copy all files from ~/.agents/skills/laporan-generator/resources/* into the project directory (or run: npx laporan-generator init).",
-      "2. Metadata: Edit metadata.yml to set title, author, institution, faculty, department, year, and campus preset (standard, skripsi-4433, itb-ta, ui-skripsi, ugm-skripsi, its-skripsi).",
+      "1. Scaffolding: Use MCP tool laporan_init or run npx laporan-generator init.",
+      "2. Metadata: Edit metadata.yml to set title, author, institution, faculty, department, year, and campus preset (standard, skripsi-4433, itb-ta, ui-skripsi, ugm-skripsi, its-skripsi, unpad-skripsi).",
       "3. Content: Write chapters in pure standard Markdown inside chapters/ (bab1-pendahuluan.md, bab2-tinjauan-pustaka.md, bab3-metodologi.md, bab4-hasil-dan-pembahasan.md, bab5-penutup.md).",
-      "4. Citations: Add BibTeX entries to references.bib and cite in Markdown using [@citekey].",
-      "5. Compilation: Run './laporan build' (or 'bash build.sh && make docx') to compile both PDF and Word DOCX simultaneously.",
-      "6. Audit: Run './laporan doctor' to audit document health."
+      "4. Citations: Use MCP tool laporan_citations to search DOIs on Crossref, add BibTeX entries to references.bib, and cite in Markdown using [@citekey].",
+      "5. Audit: Use MCP tool laporan_doctor to audit document health.",
+      "6. Compilation: Use MCP tool laporan_build or run ./laporan build to compile both PDF and Word DOCX simultaneously."
     ].join("\n");
 
     const kiroConfig = {
       name: "laporan-generator",
-      description: "Universal Academic Report & Thesis Generator using bundled Typst & DOCX templates",
+      description: "Universal Academic Report & Thesis Generator with Native MCP Tools",
       prompt: kiroPrompt,
       tools: ["read", "write", "shell", "grep", "glob"],
       allowedTools: ["read", "write", "shell", "grep", "glob"]
     };
     fs.writeFileSync(
-      path.join(kiroAgentsDir, 'laporan-generator.json'),
+      path.join(kiroAgentsDir, "laporan-generator.json"),
       JSON.stringify(kiroConfig, null, 2),
-      'utf8'
+      "utf8"
     );
-    console.log(`  ✔ [KIRO AGENT] Registered agent: "laporan-generator" -> ~/.kiro/agents/`);
+    console.log("  ✔ [KIRO AGENT] Registered agent: \"laporan-generator\" -> ~/.kiro/agents/");
   } catch (err) {
-    console.log(`  ✖ [KIRO SKIP] ${err.message}`);
+    console.log("  ✖ [KIRO SKIP] " + err.message);
   }
 
-  // Daftarkan Slash Commands / Workflows (Hanya satu /laporan-generator)
+  // Daftarkan Slash Commands / Workflows
   const workflowDestinations = [
-    path.join(home, '.agents/workflows'),
-    path.join(process.cwd(), '.agents/workflows'),
-    path.join(home, '.claude/commands')
+    path.join(home, ".agents/workflows"),
+    path.join(process.cwd(), ".agents/workflows"),
+    path.join(home, ".claude/commands")
   ];
 
   for (const wDir of workflowDestinations) {
@@ -180,15 +305,18 @@ function run(argv = []) {
       if (!fs.existsSync(wDir)) {
         fs.mkdirSync(wDir, { recursive: true });
       }
-      fs.copyFileSync(workflowSource, path.join(wDir, 'laporan-generator.md'));
+      fs.copyFileSync(workflowSource, path.join(wDir, "laporan-generator.md"));
       console.log(`  ✔ [SLASH COMMAND] /laporan-generator -> ${wDir}`);
     } catch (_) {}
   }
 
-  console.log('\n==========================================================');
-  console.log(`✨ Sukses! Skill dan template /laporan-generator berhasil disinkronkan.`);
-  console.log('Seluruh AI Agent (OpenCode, Kiro, Antigravity, Claude) kini siap digunakan!');
-  console.log('==========================================================\n');
+  // Registrasi Native MCP Server
+  registerMcpServers(packageRoot, home);
+
+  console.log("\n==========================================================");
+  console.log("✨ Sukses! Skill dan MCP server /laporan-generator berhasil disinkronkan.");
+  console.log("Seluruh AI Agent (Antigravity, Claude, OpenCode, Kiro) kini siap digunakan!");
+  console.log("==========================================================\n");
 }
 
-module.exports = { run };
+module.exports = { run, syncInternalResources };

package/lib/uninstall.js

@@ -115,6 +115,27 @@ function run(argv = []) {
     }
   }
 
+  // 5. Bersihkan registrasi MCP Server
+  const mcpConfigs = [
+    path.join(home, '.gemini/config/mcp_config.json'),
+    path.join(home, '.claude.json'),
+    path.join(home, '.config/Claude/claude_desktop_config.json')
+  ];
+  for (const mcpFile of mcpConfigs) {
+    if (fs.existsSync(mcpFile)) {
+      try {
+        const raw = fs.readFileSync(mcpFile, 'utf8');
+        const data = JSON.parse(raw);
+        if (data.mcpServers && (data.mcpServers['laporan'] || data.mcpServers['laporan-generator'])) {
+          delete data.mcpServers['laporan'];
+          delete data.mcpServers['laporan-generator'];
+          fs.writeFileSync(mcpFile, JSON.stringify(data, null, 2), 'utf8');
+          console.log(`  ✔ [CLEANED MCP] Removed laporan server from: ${mcpFile}`);
+        }
+      } catch (_) {}
+    }
+  }
+
   console.log('\n==========================================================');
   console.log('✨ Uninstall selesai! Seluruh integrasi AI agent telah dibersihkan.');
   console.log('==========================================================\n');

package/metadata.yml

@@ -15,21 +15,18 @@ institution: "Universitas Example"
 faculty: "Program Studi Informatika"
 year: "2026/2027"
 date: "Agustus 2026"
-abstract_id: |
-  Laporan ini membahas perancangan dan implementasi pipeline otomatisasi pembuatan dokumen akademik modern menggunakan Markdown, Pandoc, Typst, Lua Filter, dan multi-pass DOCX engine. Pipeline ini memungkinkan penulisan konten laporan dalam format Markdown yang secara otomatis dikonversi menjadi dokumen PDF berkualitas percetakan berbasis Typst serta dokumen Microsoft Word (.docx) berstruktur formal lengkap dengan penomoran bab, tabel, gambar, dan halaman otomatis yang mematuhi standar karya ilmiah perguruan tinggi di Indonesia.
-keywords_id:
-  - Otomatisasi Dokumen
-  - Pandoc
-  - Typst
-  - OpenXML
-  - Rekayasa Perangkat Lunak
-abstract_en: |
-  This report presents the design and implementation of a modern academic document automation pipeline utilizing Markdown, Pandoc, Typst, Lua Filters, and a multi-pass DOCX engine. This pipeline facilitates authoring scholarly reports in plain Markdown, seamlessly generating both print-quality Typst-based PDF documents and formally structured Microsoft Word (.docx) files. The generated outputs feature automated chapter, table, figure, and dual-pagination numbering compliant with standardized higher education guidelines.
-keywords_en:
-  - Document Automation
-  - Pandoc
-  - Typst
-  - OpenXML
-  - Software Engineering
+daftar_gambar: false
+daftar_tabel: false
+# Komponen halaman depan opsional (aktifkan jika diperlukan):
+# abstract_id: |
+#   Ringkasan atau abstrak laporan dalam Bahasa Indonesia...
+# keywords_id:
+#   - Kata Kunci 1
+#   - Kata Kunci 2
+# abstract_en: |
+#   Summary or abstract of the report in English...
+# keywords_en:
+#   - Keyword 1
+#   - Keyword 2
 preset: "standard"
 ...

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "laporan-generator",
-  "version": "2.6.2",
-  "description": "Universal Academic Report & Thesis Generator with Multi-Host AI Agent Skills (Antigravity, Claude, Grok)",
+  "version": "2.8.0",
+  "description": "Universal Academic Report & Thesis Generator with Multi-Host AI Agent Skills & Native MCP Server",
   "main": "bin/laporan-generator.js",
   "bin": {
     "laporan-generator": "bin/laporan-generator.js",
-    "laporan": "bin/laporan-generator.js"
+    "laporan": "bin/laporan-generator.js",
+    "laporan-mcp": "bin/mcp-server.js"
   },
   "files": [
     "bin/",
@@ -35,7 +36,10 @@
   ],
   "scripts": {
     "test": "./test.sh",
+    "test:mcp": "node tests/test_mcp.js",
+    "mcp": "node bin/mcp-server.js",
     "doctor": "node bin/laporan-generator.js doctor",
+    "stats": "node bin/laporan-generator.js stats",
     "sync-hosts": "node bin/laporan-generator.js sync-hosts",
     "setup": "node bin/laporan-generator.js setup"
   },
@@ -46,6 +50,8 @@
     "thesis-generator",
     "skripsi",
     "ai-agents",
+    "mcp",
+    "model-context-protocol",
     "antigravity",
     "antigravity-cli",
     "claude-code",

package/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("  ========================================================")