laporan-generator 2.7.0 → 2.8.0

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

@@ -58,15 +58,25 @@ Identify the document type and target university:
    - `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`:
+### Stage 2: Document Structure Confirmation & Scaffolding
+1. **Confirm Document Structure**:
+   - The universal default structure is minimal: **Cover -> Kata Pengantar -> Daftar Isi -> Batang Tubuh (BAB I..n) -> Daftar Pustaka**.
+   - **MANDATORY INQUIRY**: Ask the user before scaffolding if they want to activate optional components:
+     - Abstrak / Abstract (`abstract_id` / `abstract_en`)
+     - Lembar Pengesahan (`approval`)
+     - Daftar Gambar (`daftar_gambar: true`)
+     - Daftar Tabel (`daftar_tabel: true`)
+     - Lampiran
+2. **Initialize the workspace**:
+   - Call MCP tool `laporan_init` (e.g. `laporan_init({ preset, title, daftar_gambar, daftar_tabel })`) or run `npx laporan-generator init`.
+3. **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`).
+   - `daftar_gambar: false`, `daftar_tabel: false` (set to `true` only if opted-in).
+   - `abstract_id`: Kept empty or commented out unless user requested Abstrak.
    - `institution`, `faculty`, `department`, `year`.
-3. Configure `cover.md`: Set formal title, institutional affiliations, and kata pengantar.
+4. **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**:

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

@@ -22,21 +22,25 @@ Penulis menyadari bahwa laporan ini masih jauh dari sempurna. Oleh karena itu, k
   depth: 3,
 )
 #context {
-  let imgs = query(figure.where(kind: image))
-  if imgs.len() > 0 {
-    pagebreak()
-    outline(
-      title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR GAMBAR]],
-      target: figure.where(kind: image),
-    )
+  if opt-daftar-gambar {
+    let imgs = query(figure.where(kind: image))
+    if imgs.len() > 0 {
+      pagebreak()
+      outline(
+        title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR GAMBAR]],
+        target: figure.where(kind: image),
+      )
+    }
   }
-  let tbls = query(figure.where(kind: table))
-  if tbls.len() > 0 {
-    pagebreak()
-    outline(
-      title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR TABEL]],
-      target: figure.where(kind: table),
-    )
+  if opt-daftar-tabel {
+    let tbls = query(figure.where(kind: table))
+    if tbls.len() > 0 {
+      pagebreak()
+      outline(
+        title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR TABEL]],
+        target: figure.where(kind: table),
+      )
+    }
   }
 }
 #pagebreak()

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

@@ -138,9 +138,24 @@ local function meta_str(meta, key)
   if v == nil then
     return ""
   end
+  if type(v) == "boolean" then
+    return tostring(v)
+  end
   return pandoc.utils.stringify(v)
 end
 
+local function meta_bool(meta, key)
+  local v = meta[key]
+  if v == nil then
+    return false
+  end
+  if type(v) == "boolean" then
+    return v
+  end
+  local s = meta_str(meta, key):lower():gsub("%s+", "")
+  return s == "true" or s == "1" or s == "yes"
+end
+
 local function format_chapter_number(n)
   if chapter_num_fmt == "arabic" then
     return tostring(n)
@@ -280,6 +295,44 @@ local function daftar_isi()
   return out
 end
 
+local function daftar_gambar()
+  local out = pandoc.List{}
+  out[#out + 1] = pagebreak()
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOCHeading"/><w:jc w:val="center"/><w:outlineLvl w:val="9"/></w:pPr>' ..
+      '<w:r><w:rPr><w:b/><w:sz w:val="28"/><w:szCs w:val="28"/></w:rPr><w:t>DAFTAR GAMBAR</w:t></w:r></w:p>'
+  )
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOC1"/></w:pPr>' ..
+      '<w:r><w:fldChar w:fldCharType="begin" w:dirty="true"/></w:r>' ..
+      '<w:r><w:instrText xml:space="preserve"> TOC \\c "Gambar" \\h \\z </w:instrText></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="separate"/></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="end"/></w:r></w:p>'
+  )
+  return out
+end
+
+local function daftar_tabel()
+  local out = pandoc.List{}
+  out[#out + 1] = pagebreak()
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOCHeading"/><w:jc w:val="center"/><w:outlineLvl w:val="9"/></w:pPr>' ..
+      '<w:r><w:rPr><w:b/><w:sz w:val="28"/><w:szCs w:val="28"/></w:rPr><w:t>DAFTAR TABEL</w:t></w:r></w:p>'
+  )
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOC1"/></w:pPr>' ..
+      '<w:r><w:fldChar w:fldCharType="begin" w:dirty="true"/></w:r>' ..
+      '<w:r><w:instrText xml:space="preserve"> TOC \\c "Tabel" \\h \\z </w:instrText></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="separate"/></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="end"/></w:r></w:p>'
+  )
+  return out
+end
+
 function Pandoc(doc)
   if FORMAT ~= "docx" then
     return doc
@@ -292,6 +345,8 @@ function Pandoc(doc)
   local faculty = meta_str(meta, "faculty")
   local institution = meta_str(meta, "institution")
   local year = meta_str(meta, "year")
+  local show_dg = (meta_bool(meta, "daftar_gambar") or meta_bool(meta, "list_of_figures"))
+  local show_dt = (meta_bool(meta, "daftar_tabel") or meta_bool(meta, "list_of_tables"))
 
   local blocks = pandoc.List{}
 
@@ -401,6 +456,16 @@ function Pandoc(doc)
       for _, b in ipairs(daftar_isi()) do
         body[#body + 1] = b
       end
+      if show_dg then
+        for _, b in ipairs(daftar_gambar()) do
+          body[#body + 1] = b
+        end
+      end
+      if show_dt then
+        for _, b in ipairs(daftar_tabel()) do
+          body[#body + 1] = b
+        end
+      end
       inserted = true
     end
     body[#body + 1] = blk

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.7.0             "
+    echo "                 LAPORAN GENERATOR CLI v2.8.0             "
     echo "     Otomatisasi Dokumen Akademik (Typst + DOCX Engine)   "
     echo "  ========================================================"
     echo -e "${NC}"

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

@@ -40,7 +40,7 @@ function Get-PythonCommand {
 
 function Show-Banner {
     Write-Host "  ========================================================" -ForegroundColor Cyan
-    Write-Host "                 LAPORAN GENERATOR CLI v2.7.0             " -ForegroundColor Cyan
+    Write-Host "                 LAPORAN GENERATOR CLI v2.8.0             " -ForegroundColor Cyan
     Write-Host "     Otomatisasi Dokumen Akademik (Typst + DOCX Engine)   " -ForegroundColor Cyan
     Write-Host "  ========================================================" -ForegroundColor Cyan
     Write-Host ""

package/.agents/skills/laporan-generator/resources/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/.agents/skills/laporan-generator/resources/scripts/test_scripts.py

@@ -184,6 +184,103 @@ class TestReportDoctor(unittest.TestCase):
         self.assertIn("citations", data)
 
 
+class TestFrontMatterOptIn(unittest.TestCase):
+    def test_default_metadata_structure(self):
+        meta_path = os.path.join(get_project_root(), "metadata.yml")
+        with open(meta_path, "r", encoding="utf-8") as f:
+            content = f.read()
+        # Verify abstract is commented or empty by default
+        self.assertNotIn("\nabstract_id: |", content, "abstract_id should not be active by default in metadata.yml")
+        self.assertNotIn("\nabstract_en: |", content, "abstract_en should not be active by default in metadata.yml")
+        # Verify opt-in flags for daftar_gambar & daftar_tabel are explicitly false or commented
+        has_dg = "daftar_gambar: false" in content
+        has_dt = "daftar_tabel: false" in content
+        self.assertTrue(has_dg, "metadata.yml must explicitly specify daftar_gambar: false by default")
+        self.assertTrue(has_dt, "metadata.yml must explicitly specify daftar_tabel: false by default")
+
+    def test_cover_md_gated_outlines(self):
+        cover_path = os.path.join(get_project_root(), "cover.md")
+        with open(cover_path, "r", encoding="utf-8") as f:
+            content = f.read()
+        # Unconditional outline queries must not exist
+        self.assertNotIn("let imgs = query(figure.where(kind: image))\n  if imgs.len() > 0", content,
+                         "cover.md must not unconditionally emit DAFTAR GAMBAR outline")
+        self.assertNotIn("let tbls = query(figure.where(kind: table))\n  if tbls.len() > 0", content,
+                         "cover.md must not unconditionally emit DAFTAR TABEL outline")
+        # Must be gated by opt-in check
+        self.assertIn("opt-daftar-gambar", content, "cover.md must gate DAFTAR GAMBAR with opt-daftar-gambar")
+        self.assertIn("opt-daftar-tabel", content, "cover.md must gate DAFTAR TABEL with opt-daftar-tabel")
+
+    def test_lua_meta_bool_coercion(self):
+        """Verify docx.lua handles YAML boolean scalars and string equivalents safely."""
+        lua_code = """
+        local pandoc = {
+          utils = {
+            stringify = function(x)
+              if type(x) ~= 'string' and type(x) ~= 'table' then
+                error('pandoc.utils.stringify expects table or string, got ' .. type(x))
+              end
+              return tostring(x)
+            end
+          }
+        }
+        local function meta_str(meta, key)
+          local v = meta[key]
+          if v == nil then return "" end
+          if type(v) == "boolean" then return tostring(v) end
+          return pandoc.utils.stringify(v)
+        end
+        local function meta_bool(meta, key)
+          local v = meta[key]
+          if v == nil then return false end
+          if type(v) == "boolean" then return v end
+          local s = meta_str(meta, key):lower():gsub("%s+", "")
+          return s == "true" or s == "1" or s == "yes"
+        end
+
+        local meta = {
+          dg_bool_false = false,
+          dg_bool_true = true,
+          dg_str_false = "false",
+          dg_str_true = "true",
+          dg_nil = nil
+        }
+
+        assert(meta_str(meta, "dg_bool_false") == "false")
+        assert(meta_bool(meta, "dg_bool_false") == false)
+        assert(meta_str(meta, "dg_bool_true") == "true")
+        assert(meta_bool(meta, "dg_bool_true") == true)
+        assert(meta_bool(meta, "dg_str_false") == false)
+        assert(meta_bool(meta, "dg_str_true") == true)
+        assert(meta_bool(meta, "dg_nil") == false)
+        print("LUA_OK")
+        """
+        proc = subprocess.run(["lua", "-e", lua_code], capture_output=True, text=True)
+        self.assertEqual(proc.returncode, 0, f"Lua helper test failed: {proc.stderr}")
+        self.assertIn("LUA_OK", proc.stdout)
+
+    def test_init_project_boolean_coercion(self):
+        """Verify lib/init.js does not treat string 'false' as truthy."""
+        import tempfile
+        with tempfile.TemporaryDirectory() as tmpdir:
+            node_code = f"""
+            const path = require('path');
+            const {{ initProject }} = require('{os.path.join(ROOT_DIR, "lib/init.js")}');
+            initProject({{ targetDir: '{tmpdir}/test_f', daftar_gambar: 'false', daftar_tabel: false, silent: true }});
+            initProject({{ targetDir: '{tmpdir}/test_t', daftar_gambar: 'true', daftar_tabel: true, silent: true }});
+            """
+            proc = subprocess.run(["node", "-e", node_code], capture_output=True, text=True)
+            self.assertEqual(proc.returncode, 0, f"Node initProject failed: {proc.stderr}")
+            with open(os.path.join(tmpdir, "test_f", "metadata.yml"), "r", encoding="utf-8") as f:
+                meta_f = f.read()
+            with open(os.path.join(tmpdir, "test_t", "metadata.yml"), "r", encoding="utf-8") as f:
+                meta_t = f.read()
+            self.assertIn("daftar_gambar: false", meta_f)
+            self.assertIn("daftar_tabel: false", meta_f)
+            self.assertIn("daftar_gambar: true", meta_t)
+            self.assertIn("daftar_tabel: true", meta_t)
+
+
 if __name__ == "__main__":
     unittest.main(verbosity=2)
 

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

@@ -391,4 +391,7 @@ $endif$
 #pagebreak()
 $endif$
 
+#let opt-daftar-gambar = $if(daftar_gambar)$$daftar_gambar$$else$$if(list_of_figures)$$list_of_figures$$else$false$endif$$endif$
+#let opt-daftar-tabel = $if(daftar_tabel)$$daftar_tabel$$else$$if(list_of_tables)$$list_of_tables$$else$false$endif$$endif$
+
 $body$

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

@@ -184,6 +184,103 @@ class TestReportDoctor(unittest.TestCase):
         self.assertIn("citations", data)
 
 
+class TestFrontMatterOptIn(unittest.TestCase):
+    def test_default_metadata_structure(self):
+        meta_path = os.path.join(get_project_root(), "metadata.yml")
+        with open(meta_path, "r", encoding="utf-8") as f:
+            content = f.read()
+        # Verify abstract is commented or empty by default
+        self.assertNotIn("\nabstract_id: |", content, "abstract_id should not be active by default in metadata.yml")
+        self.assertNotIn("\nabstract_en: |", content, "abstract_en should not be active by default in metadata.yml")
+        # Verify opt-in flags for daftar_gambar & daftar_tabel are explicitly false or commented
+        has_dg = "daftar_gambar: false" in content
+        has_dt = "daftar_tabel: false" in content
+        self.assertTrue(has_dg, "metadata.yml must explicitly specify daftar_gambar: false by default")
+        self.assertTrue(has_dt, "metadata.yml must explicitly specify daftar_tabel: false by default")
+
+    def test_cover_md_gated_outlines(self):
+        cover_path = os.path.join(get_project_root(), "cover.md")
+        with open(cover_path, "r", encoding="utf-8") as f:
+            content = f.read()
+        # Unconditional outline queries must not exist
+        self.assertNotIn("let imgs = query(figure.where(kind: image))\n  if imgs.len() > 0", content,
+                         "cover.md must not unconditionally emit DAFTAR GAMBAR outline")
+        self.assertNotIn("let tbls = query(figure.where(kind: table))\n  if tbls.len() > 0", content,
+                         "cover.md must not unconditionally emit DAFTAR TABEL outline")
+        # Must be gated by opt-in check
+        self.assertIn("opt-daftar-gambar", content, "cover.md must gate DAFTAR GAMBAR with opt-daftar-gambar")
+        self.assertIn("opt-daftar-tabel", content, "cover.md must gate DAFTAR TABEL with opt-daftar-tabel")
+
+    def test_lua_meta_bool_coercion(self):
+        """Verify docx.lua handles YAML boolean scalars and string equivalents safely."""
+        lua_code = """
+        local pandoc = {
+          utils = {
+            stringify = function(x)
+              if type(x) ~= 'string' and type(x) ~= 'table' then
+                error('pandoc.utils.stringify expects table or string, got ' .. type(x))
+              end
+              return tostring(x)
+            end
+          }
+        }
+        local function meta_str(meta, key)
+          local v = meta[key]
+          if v == nil then return "" end
+          if type(v) == "boolean" then return tostring(v) end
+          return pandoc.utils.stringify(v)
+        end
+        local function meta_bool(meta, key)
+          local v = meta[key]
+          if v == nil then return false end
+          if type(v) == "boolean" then return v end
+          local s = meta_str(meta, key):lower():gsub("%s+", "")
+          return s == "true" or s == "1" or s == "yes"
+        end
+
+        local meta = {
+          dg_bool_false = false,
+          dg_bool_true = true,
+          dg_str_false = "false",
+          dg_str_true = "true",
+          dg_nil = nil
+        }
+
+        assert(meta_str(meta, "dg_bool_false") == "false")
+        assert(meta_bool(meta, "dg_bool_false") == false)
+        assert(meta_str(meta, "dg_bool_true") == "true")
+        assert(meta_bool(meta, "dg_bool_true") == true)
+        assert(meta_bool(meta, "dg_str_false") == false)
+        assert(meta_bool(meta, "dg_str_true") == true)
+        assert(meta_bool(meta, "dg_nil") == false)
+        print("LUA_OK")
+        """
+        proc = subprocess.run(["lua", "-e", lua_code], capture_output=True, text=True)
+        self.assertEqual(proc.returncode, 0, f"Lua helper test failed: {proc.stderr}")
+        self.assertIn("LUA_OK", proc.stdout)
+
+    def test_init_project_boolean_coercion(self):
+        """Verify lib/init.js does not treat string 'false' as truthy."""
+        import tempfile
+        with tempfile.TemporaryDirectory() as tmpdir:
+            node_code = f"""
+            const path = require('path');
+            const {{ initProject }} = require('{os.path.join(ROOT_DIR, "lib/init.js")}');
+            initProject({{ targetDir: '{tmpdir}/test_f', daftar_gambar: 'false', daftar_tabel: false, silent: true }});
+            initProject({{ targetDir: '{tmpdir}/test_t', daftar_gambar: 'true', daftar_tabel: true, silent: true }});
+            """
+            proc = subprocess.run(["node", "-e", node_code], capture_output=True, text=True)
+            self.assertEqual(proc.returncode, 0, f"Node initProject failed: {proc.stderr}")
+            with open(os.path.join(tmpdir, "test_f", "metadata.yml"), "r", encoding="utf-8") as f:
+                meta_f = f.read()
+            with open(os.path.join(tmpdir, "test_t", "metadata.yml"), "r", encoding="utf-8") as f:
+                meta_t = f.read()
+            self.assertIn("daftar_gambar: false", meta_f)
+            self.assertIn("daftar_tabel: false", meta_f)
+            self.assertIn("daftar_gambar: true", meta_t)
+            self.assertIn("daftar_tabel: true", meta_t)
+
+
 if __name__ == "__main__":
     unittest.main(verbosity=2)
 

package/README.md

@@ -113,7 +113,7 @@ 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.
+Laporan Generator v2.8.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:
@@ -293,6 +293,11 @@ title: "Analisis dan Implementasi Sistem Deteksi Intrusi Jaringan Berbasis eBPF"
 document_type: "Skripsi"
 margin_preset: "itb-ta"
 
+# Kontrol Struktur Halaman Depan (Opt-In)
+# Default struktur bersih: Cover -> Kata Pengantar -> Daftar Isi -> Batang Tubuh -> Daftar Pustaka
+daftar_gambar: false   # Ubah true jika dokumen memuat gambar dan membutuhkan DAFTAR GAMBAR
+daftar_tabel: false    # Ubah true jika dokumen memuat tabel dan membutuhkan DAFTAR TABEL
+
 author:
   - name: "Mu'adz Hudzaifah"
     nim: "13522001"

package/bin/laporan-generator.js

@@ -25,7 +25,7 @@ function showHelp() {
   ========================================================
          LAPORAN GENERATOR CLI (Multi-Host AI Engine)     
   ========================================================
-  Versi: 2.7.0
+  Versi: 2.8.0
   
   Penggunaan:
     npx laporan-generator <perintah> [opsi]

package/cover.md

@@ -22,21 +22,25 @@ Penulis menyadari bahwa laporan ini masih jauh dari sempurna. Oleh karena itu, k
   depth: 3,
 )
 #context {
-  let imgs = query(figure.where(kind: image))
-  if imgs.len() > 0 {
-    pagebreak()
-    outline(
-      title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR GAMBAR]],
-      target: figure.where(kind: image),
-    )
+  if opt-daftar-gambar {
+    let imgs = query(figure.where(kind: image))
+    if imgs.len() > 0 {
+      pagebreak()
+      outline(
+        title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR GAMBAR]],
+        target: figure.where(kind: image),
+      )
+    }
   }
-  let tbls = query(figure.where(kind: table))
-  if tbls.len() > 0 {
-    pagebreak()
-    outline(
-      title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR TABEL]],
-      target: figure.where(kind: table),
-    )
+  if opt-daftar-tabel {
+    let tbls = query(figure.where(kind: table))
+    if tbls.len() > 0 {
+      pagebreak()
+      outline(
+        title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR TABEL]],
+        target: figure.where(kind: table),
+      )
+    }
   }
 }
 #pagebreak()

package/docs/metadata-schema.md

@@ -49,6 +49,8 @@ abstract: |
 | `faculty` | String | **Ya** | Nama Fakultas, Departemen, atau Program Studi. |
 | `year` | String | **Ya** | Tahun Ajaran (contoh: `2025/2026`). |
 | `date` | String | Opsional | Bulan dan Tahun pembuatan (contoh: `Juli 2026`). |
+| `daftar_gambar` | Boolean | Opsional | Aktifkan halaman DAFTAR GAMBAR (`true`/`false`, default: `false`). |
+| `daftar_tabel` | Boolean | Opsional | Aktifkan halaman DAFTAR TABEL (`true`/`false`, default: `false`). |
 | `abstract` | Multiline String | Opsional | Ringkasan/Abstrak laporan dalam Bahasa Indonesia. |
 
 ---

package/docx.lua

@@ -138,9 +138,24 @@ local function meta_str(meta, key)
   if v == nil then
     return ""
   end
+  if type(v) == "boolean" then
+    return tostring(v)
+  end
   return pandoc.utils.stringify(v)
 end
 
+local function meta_bool(meta, key)
+  local v = meta[key]
+  if v == nil then
+    return false
+  end
+  if type(v) == "boolean" then
+    return v
+  end
+  local s = meta_str(meta, key):lower():gsub("%s+", "")
+  return s == "true" or s == "1" or s == "yes"
+end
+
 local function format_chapter_number(n)
   if chapter_num_fmt == "arabic" then
     return tostring(n)
@@ -280,6 +295,44 @@ local function daftar_isi()
   return out
 end
 
+local function daftar_gambar()
+  local out = pandoc.List{}
+  out[#out + 1] = pagebreak()
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOCHeading"/><w:jc w:val="center"/><w:outlineLvl w:val="9"/></w:pPr>' ..
+      '<w:r><w:rPr><w:b/><w:sz w:val="28"/><w:szCs w:val="28"/></w:rPr><w:t>DAFTAR GAMBAR</w:t></w:r></w:p>'
+  )
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOC1"/></w:pPr>' ..
+      '<w:r><w:fldChar w:fldCharType="begin" w:dirty="true"/></w:r>' ..
+      '<w:r><w:instrText xml:space="preserve"> TOC \\c "Gambar" \\h \\z </w:instrText></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="separate"/></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="end"/></w:r></w:p>'
+  )
+  return out
+end
+
+local function daftar_tabel()
+  local out = pandoc.List{}
+  out[#out + 1] = pagebreak()
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOCHeading"/><w:jc w:val="center"/><w:outlineLvl w:val="9"/></w:pPr>' ..
+      '<w:r><w:rPr><w:b/><w:sz w:val="28"/><w:szCs w:val="28"/></w:rPr><w:t>DAFTAR TABEL</w:t></w:r></w:p>'
+  )
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOC1"/></w:pPr>' ..
+      '<w:r><w:fldChar w:fldCharType="begin" w:dirty="true"/></w:r>' ..
+      '<w:r><w:instrText xml:space="preserve"> TOC \\c "Tabel" \\h \\z </w:instrText></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="separate"/></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="end"/></w:r></w:p>'
+  )
+  return out
+end
+
 function Pandoc(doc)
   if FORMAT ~= "docx" then
     return doc
@@ -292,6 +345,8 @@ function Pandoc(doc)
   local faculty = meta_str(meta, "faculty")
   local institution = meta_str(meta, "institution")
   local year = meta_str(meta, "year")
+  local show_dg = (meta_bool(meta, "daftar_gambar") or meta_bool(meta, "list_of_figures"))
+  local show_dt = (meta_bool(meta, "daftar_tabel") or meta_bool(meta, "list_of_tables"))
 
   local blocks = pandoc.List{}
 
@@ -401,6 +456,16 @@ function Pandoc(doc)
       for _, b in ipairs(daftar_isi()) do
         body[#body + 1] = b
       end
+      if show_dg then
+        for _, b in ipairs(daftar_gambar()) do
+          body[#body + 1] = b
+        end
+      end
+      if show_dt then
+        for _, b in ipairs(daftar_tabel()) do
+          body[#body + 1] = b
+        end
+      end
       inserted = true
     end
     body[#body + 1] = blk

package/laporan

@@ -27,7 +27,7 @@ export PYTHONUTF8=1
 show_banner() {
     echo -e "${CYAN}${BOLD}"
     echo "  ========================================================"
-    echo "                 LAPORAN GENERATOR CLI v2.7.0             "
+    echo "                 LAPORAN GENERATOR CLI v2.8.0             "
     echo "     Otomatisasi Dokumen Akademik (Typst + DOCX Engine)   "
     echo "  ========================================================"
     echo -e "${NC}"

package/laporan.ps1

@@ -40,7 +40,7 @@ function Get-PythonCommand {
 
 function Show-Banner {
     Write-Host "  ========================================================" -ForegroundColor Cyan
-    Write-Host "                 LAPORAN GENERATOR CLI v2.7.0             " -ForegroundColor Cyan
+    Write-Host "                 LAPORAN GENERATOR CLI v2.8.0             " -ForegroundColor Cyan
     Write-Host "     Otomatisasi Dokumen Akademik (Typst + DOCX Engine)   " -ForegroundColor Cyan
     Write-Host "  ========================================================" -ForegroundColor Cyan
     Write-Host ""

package/lib/init.js

@@ -23,6 +23,7 @@ function copyRecursiveSync(src, dest) {
 function initProject(options = {}) {
   const targetDir = options.targetDir ? path.resolve(options.targetDir) : process.cwd();
   const silent = !!options.silent;
+  const isTruthy = (val) => val === true || val === 'true';
 
   if (!fs.existsSync(targetDir)) {
     fs.mkdirSync(targetDir, { recursive: true });
@@ -103,6 +104,8 @@ faculty: "${options.faculty || 'Fakultas Teknik'}"
 department: "${options.department || 'Program Studi Informatika'}"
 year: "${options.year || '2026'}"
 preset: "${options.preset || 'skripsi-4433'}"
+daftar_gambar: ${isTruthy(options.daftar_gambar) ? 'true' : 'false'}
+daftar_tabel: ${isTruthy(options.daftar_tabel) ? 'true' : 'false'}
 ...
 `;
     fs.writeFileSync(metaPath, defaultMeta, 'utf8');
@@ -124,7 +127,7 @@ preset: "${options.preset || 'skripsi-4433'}"
   }
 
   // Update metadata.yml if custom options were provided
-  if (fs.existsSync(metaPath) && (options.title || options.preset || options.authorName || options.institution)) {
+  if (fs.existsSync(metaPath) && (options.title || options.preset || options.authorName || options.institution || options.daftar_gambar !== undefined || options.daftar_tabel !== undefined)) {
     try {
       let metaContent = fs.readFileSync(metaPath, 'utf8');
       if (options.title) {
@@ -151,8 +154,26 @@ preset: "${options.preset || 'skripsi-4433'}"
           metaContent = metaContent.replace(/nim:\s*".*?"/, `nim: "${options.authorId}"`);
         }
       }
+      if (options.daftar_gambar !== undefined) {
+        const val = isTruthy(options.daftar_gambar) ? 'true' : 'false';
+        if (/^daftar_gambar:\s*(true|false)/m.test(metaContent)) {
+          metaContent = metaContent.replace(/^daftar_gambar:\s*(true|false)/m, `daftar_gambar: ${val}`);
+        } else {
+          metaContent = metaContent.replace(/preset:\s*".*?"/m, `daftar_gambar: ${val}\n$&`);
+        }
+      }
+      if (options.daftar_tabel !== undefined) {
+        const val = isTruthy(options.daftar_tabel) ? 'true' : 'false';
+        if (/^daftar_tabel:\s*(true|false)/m.test(metaContent)) {
+          metaContent = metaContent.replace(/^daftar_tabel:\s*(true|false)/m, `daftar_tabel: ${val}`);
+        } else {
+          metaContent = metaContent.replace(/preset:\s*".*?"/m, `daftar_tabel: ${val}\n$&`);
+        }
+      }
       fs.writeFileSync(metaPath, metaContent, 'utf8');
-    } catch (_) {}
+    } catch (err) {
+      console.warn(`[init] Failed to customize metadata.yml: ${err.message}`);
+    }
   }
 
   // Ensure scripts are executable on Unix
@@ -163,7 +184,9 @@ preset: "${options.preset || 'skripsi-4433'}"
       if (fs.existsSync(laporanBin)) fs.chmodSync(laporanBin, '755');
       if (fs.existsSync(buildSh)) fs.chmodSync(buildSh, '755');
     }
-  } catch (_) {}
+  } catch (err) {
+    console.warn(`[init] Failed to set executable permissions: ${err.message}`);
+  }
 
   return {
     success: true,

package/lib/mcp.js

@@ -7,7 +7,7 @@ const https = require("https");
 const { spawnSync } = require("child_process");
 const { initProject } = require("./init");
 
-const VERSION = "2.7.0";
+const VERSION = "2.8.0";
 const PACKAGE_ROOT = path.join(__dirname, "..");
 
 function getPythonCommand() {
@@ -92,6 +92,14 @@ const TOOLS = [
           type: "string",
           description: "Academic year (e.g. 2026)."
         },
+        daftar_gambar: {
+          type: "boolean",
+          description: "Whether to include Daftar Gambar (List of Figures). Default is false."
+        },
+        daftar_tabel: {
+          type: "boolean",
+          description: "Whether to include Daftar Tabel (List of Tables). Default is false."
+        },
         force: {
           type: "boolean",
           description: "Whether to overwrite existing files if already present."
@@ -211,6 +219,8 @@ async function handleToolCall(name, args = {}) {
         faculty: args.faculty,
         department: args.department,
         year: args.year,
+        daftar_gambar: args.daftar_gambar,
+        daftar_tabel: args.daftar_tabel,
         force: args.force,
         silent: true
       });

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,6 +1,6 @@
 {
   "name": "laporan-generator",
-  "version": "2.7.0",
+  "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": {

package/scripts/test_scripts.py

@@ -184,6 +184,103 @@ class TestReportDoctor(unittest.TestCase):
         self.assertIn("citations", data)
 
 
+class TestFrontMatterOptIn(unittest.TestCase):
+    def test_default_metadata_structure(self):
+        meta_path = os.path.join(get_project_root(), "metadata.yml")
+        with open(meta_path, "r", encoding="utf-8") as f:
+            content = f.read()
+        # Verify abstract is commented or empty by default
+        self.assertNotIn("\nabstract_id: |", content, "abstract_id should not be active by default in metadata.yml")
+        self.assertNotIn("\nabstract_en: |", content, "abstract_en should not be active by default in metadata.yml")
+        # Verify opt-in flags for daftar_gambar & daftar_tabel are explicitly false or commented
+        has_dg = "daftar_gambar: false" in content
+        has_dt = "daftar_tabel: false" in content
+        self.assertTrue(has_dg, "metadata.yml must explicitly specify daftar_gambar: false by default")
+        self.assertTrue(has_dt, "metadata.yml must explicitly specify daftar_tabel: false by default")
+
+    def test_cover_md_gated_outlines(self):
+        cover_path = os.path.join(get_project_root(), "cover.md")
+        with open(cover_path, "r", encoding="utf-8") as f:
+            content = f.read()
+        # Unconditional outline queries must not exist
+        self.assertNotIn("let imgs = query(figure.where(kind: image))\n  if imgs.len() > 0", content,
+                         "cover.md must not unconditionally emit DAFTAR GAMBAR outline")
+        self.assertNotIn("let tbls = query(figure.where(kind: table))\n  if tbls.len() > 0", content,
+                         "cover.md must not unconditionally emit DAFTAR TABEL outline")
+        # Must be gated by opt-in check
+        self.assertIn("opt-daftar-gambar", content, "cover.md must gate DAFTAR GAMBAR with opt-daftar-gambar")
+        self.assertIn("opt-daftar-tabel", content, "cover.md must gate DAFTAR TABEL with opt-daftar-tabel")
+
+    def test_lua_meta_bool_coercion(self):
+        """Verify docx.lua handles YAML boolean scalars and string equivalents safely."""
+        lua_code = """
+        local pandoc = {
+          utils = {
+            stringify = function(x)
+              if type(x) ~= 'string' and type(x) ~= 'table' then
+                error('pandoc.utils.stringify expects table or string, got ' .. type(x))
+              end
+              return tostring(x)
+            end
+          }
+        }
+        local function meta_str(meta, key)
+          local v = meta[key]
+          if v == nil then return "" end
+          if type(v) == "boolean" then return tostring(v) end
+          return pandoc.utils.stringify(v)
+        end
+        local function meta_bool(meta, key)
+          local v = meta[key]
+          if v == nil then return false end
+          if type(v) == "boolean" then return v end
+          local s = meta_str(meta, key):lower():gsub("%s+", "")
+          return s == "true" or s == "1" or s == "yes"
+        end
+
+        local meta = {
+          dg_bool_false = false,
+          dg_bool_true = true,
+          dg_str_false = "false",
+          dg_str_true = "true",
+          dg_nil = nil
+        }
+
+        assert(meta_str(meta, "dg_bool_false") == "false")
+        assert(meta_bool(meta, "dg_bool_false") == false)
+        assert(meta_str(meta, "dg_bool_true") == "true")
+        assert(meta_bool(meta, "dg_bool_true") == true)
+        assert(meta_bool(meta, "dg_str_false") == false)
+        assert(meta_bool(meta, "dg_str_true") == true)
+        assert(meta_bool(meta, "dg_nil") == false)
+        print("LUA_OK")
+        """
+        proc = subprocess.run(["lua", "-e", lua_code], capture_output=True, text=True)
+        self.assertEqual(proc.returncode, 0, f"Lua helper test failed: {proc.stderr}")
+        self.assertIn("LUA_OK", proc.stdout)
+
+    def test_init_project_boolean_coercion(self):
+        """Verify lib/init.js does not treat string 'false' as truthy."""
+        import tempfile
+        with tempfile.TemporaryDirectory() as tmpdir:
+            node_code = f"""
+            const path = require('path');
+            const {{ initProject }} = require('{os.path.join(ROOT_DIR, "lib/init.js")}');
+            initProject({{ targetDir: '{tmpdir}/test_f', daftar_gambar: 'false', daftar_tabel: false, silent: true }});
+            initProject({{ targetDir: '{tmpdir}/test_t', daftar_gambar: 'true', daftar_tabel: true, silent: true }});
+            """
+            proc = subprocess.run(["node", "-e", node_code], capture_output=True, text=True)
+            self.assertEqual(proc.returncode, 0, f"Node initProject failed: {proc.stderr}")
+            with open(os.path.join(tmpdir, "test_f", "metadata.yml"), "r", encoding="utf-8") as f:
+                meta_f = f.read()
+            with open(os.path.join(tmpdir, "test_t", "metadata.yml"), "r", encoding="utf-8") as f:
+                meta_t = f.read()
+            self.assertIn("daftar_gambar: false", meta_f)
+            self.assertIn("daftar_tabel: false", meta_f)
+            self.assertIn("daftar_gambar: true", meta_t)
+            self.assertIn("daftar_tabel: true", meta_t)
+
+
 if __name__ == "__main__":
     unittest.main(verbosity=2)
 

package/template.typ

@@ -391,4 +391,7 @@ $endif$
 #pagebreak()
 $endif$
 
+#let opt-daftar-gambar = $if(daftar_gambar)$$daftar_gambar$$else$$if(list_of_figures)$$list_of_figures$$else$false$endif$$endif$
+#let opt-daftar-tabel = $if(daftar_tabel)$$daftar_tabel$$else$$if(list_of_tables)$$list_of_tables$$else$false$endif$$endif$
+
 $body$