laporan-generator 2.6.1

package/.agents/skills/laporan-generator/resources/presets/standard.yml

@@ -0,0 +1,26 @@
+# Preset: Standar Modern
+preset_id: "standard"
+name: "Standar Modern"
+description: "Format standar modern untuk laporan proyek, tugas kuliah, praktikum, dan makalah."
+
+# Margin halaman
+margin_top: 2cm
+margin_bottom: 3cm
+margin_left: 2.5cm
+margin_right: 2.5cm
+
+# Tipografi
+font_family: "Libertinus Serif"
+font_size: 12pt
+line_spacing: 0.75em
+first_line_indent: 1.25cm
+
+# Penomoran Heading
+heading_chapter_prefix: "BAB "
+heading_chapter_num_format: "roman"
+heading_sub_dot: true
+heading_subsub_dot: false
+
+# Pengaturan Cover
+cover_show_lecturer: true
+cover_logo_width: 4cm

package/.agents/skills/laporan-generator/resources/presets/ugm-skripsi.yml

@@ -0,0 +1,26 @@
+# Preset: Universitas Gadjah Mada (UGM)
+preset_id: "ugm-skripsi"
+name: "Universitas Gadjah Mada (UGM)"
+description: "Format Skripsi / Laporan Tugas Akhir Universitas Gadjah Mada (Margin 4-4-3-3, Full Academic Cover)."
+
+# Margin halaman (Standar UGM: Kiri 4cm, Atas 4cm, Bawah 3cm, Kanan 3cm)
+margin_top: 4cm
+margin_bottom: 3cm
+margin_left: 4cm
+margin_right: 3cm
+
+# Tipografi
+font_family: "Libertinus Serif"
+font_size: 12pt
+line_spacing: 0.75em
+first_line_indent: 1.25cm
+
+# Penomoran Heading
+heading_chapter_prefix: "BAB "
+heading_chapter_num_format: "roman"
+heading_sub_dot: true
+heading_subsub_dot: false
+
+# Pengaturan Cover
+cover_show_lecturer: true
+cover_logo_width: 4cm

package/.agents/skills/laporan-generator/resources/presets/ui-skripsi.yml

@@ -0,0 +1,26 @@
+# Preset: Universitas Indonesia (UI)
+preset_id: "ui-skripsi"
+name: "Universitas Indonesia (UI)"
+description: "Format Tugas Akhir & Skripsi sesuai Pedoman Penulisan Karya Ilmiah Universitas Indonesia."
+
+# Margin halaman (Standar UI: Top 2.5cm / 2cm, Left 2.5cm, Bottom 2.5cm / 3cm, Right 2.5cm)
+margin_top: 2.5cm
+margin_bottom: 2.5cm
+margin_left: 2.5cm
+margin_right: 2.5cm
+
+# Tipografi
+font_family: "Libertinus Serif"
+font_size: 12pt
+line_spacing: 0.75em
+first_line_indent: 1.25cm
+
+# Penomoran Heading
+heading_chapter_prefix: "BAB "
+heading_chapter_num_format: "roman"
+heading_sub_dot: true
+heading_subsub_dot: false
+
+# Pengaturan Cover
+cover_show_lecturer: true
+cover_logo_width: 4cm

package/.agents/skills/laporan-generator/resources/presets/unpad-skripsi.yml

@@ -0,0 +1,27 @@
+# Preset: UNIVERSITAS PADJADJARAN
+# Dihasilkan secara otomatis oleh scan-preset.py
+preset_id: "unpad-skripsi"
+name: "UNIVERSITAS PADJADJARAN"
+description: "Format otomatis hasil pemindaian pedoman akademik UNIVERSITAS PADJADJARAN."
+
+# 1. Geometri & Margin Halaman
+margin_top: 4cm
+margin_bottom: 3cm
+margin_left: 4cm
+margin_right: 3cm
+
+# 2. Tipografi & Spasi
+font_family: "Libertinus Serif"
+font_size: 12pt
+line_spacing: 0.75em
+first_line_indent: 1.25cm
+
+# 3. Penomoran Heading
+heading_chapter_prefix: "BAB "
+heading_chapter_num_format: "roman"
+heading_sub_dot: true
+heading_subsub_dot: false
+
+# 4. Pengaturan Halaman Sampul
+cover_show_lecturer: true
+cover_logo_width: 4cm

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

@@ -0,0 +1,115 @@
+@manual{typst2024,
+  author       = {M{\"a}dje, Laurenz and Haug, Martin},
+  title        = {Typst: A Programmable Markup-Based Typesetting System},
+  year         = {2024},
+  organization = {Typst GmbH},
+  url          = {https://typst.app/docs}
+}
+
+@manual{pandoc2024,
+  author       = {MacFarlane, John},
+  title        = {Pandoc: A Universal Document Converter},
+  year         = {2024},
+  url          = {https://pandoc.org/MANUAL.html}
+}
+
+@article{krewinkel2020pandoc,
+  author       = {Krewinkel, Albert and MacFarlane, John},
+  title        = {Pandoc Lua Filters: Extensible Document Processing},
+  year         = {2020},
+  journal      = {Journal of Open Source Software},
+  url          = {https://pandoc.org/lua-filters.html}
+}
+
+@misc{gruber2004markdown,
+  author       = {Gruber, John},
+  title        = {Markdown: A Text-to-HTML Conversion Tool for Web Writers},
+  year         = {2004},
+  url          = {https://daringfireball.net/projects/markdown/}
+}
+
+@manual{commonmark2021,
+  author       = {MacFarlane, John and Lehmann, David and Krewinkel, Albert and others},
+  title        = {CommonMark Spec (Version 0.30)},
+  year         = {2021},
+  url          = {https://spec.commonmark.org/0.30/}
+}
+
+@manual{imagemagick2024,
+  author       = {{ImageMagick Studio LLC}},
+  title        = {ImageMagick: Master Software Suite for Image Processing},
+  year         = {2024},
+  url          = {https://imagemagick.org/}
+}
+
+@manual{gnu2024bash,
+  author       = {Fox, Brian and Ramey, Chet},
+  title        = {GNU Bash Reference Manual (Version 5.2)},
+  year         = {2024},
+  organization = {Free Software Foundation},
+  url          = {https://www.gnu.org/software/bash/manual/}
+}
+
+@inproceedings{dolstra2004nix,
+  author       = {Dolstra, Eelco and de Jonge, Merijn and Visser, Eelco},
+  title        = {Nix: A Safe and Policy-Free System for Software Deployment},
+  booktitle    = {Proceedings of the 18th Large Installation System Administration Conference (LISA '04)},
+  pages        = {23--35},
+  year         = {2004},
+  organization = {USENIX Association}
+}
+
+@article{merkel2014docker,
+  author       = {Merkel, Dirk},
+  title        = {Docker: Lightweight Linux Containers for Consistent Development and Deployment},
+  journal      = {Linux Journal},
+  volume       = {2014},
+  number       = {239},
+  pages        = {2},
+  year         = {2014}
+}
+
+@book{apa2020manual,
+  author       = {{American Psychological Association}},
+  title        = {Publication Manual of the American Psychological Association},
+  edition      = {7th},
+  year         = {2020},
+  publisher    = {American Psychological Association},
+  address      = {Washington, DC},
+  isbn         = {978-1-4338-3216-1},
+  doi          = {10.1037/0000165-000}
+}
+
+@standard{iso2021openxml,
+  author       = {{International Organization for Standardization}},
+  title        = {ISO/IEC 29500:2021 Information technology -- Document description and processing languages -- Office Open XML File Formats},
+  year         = {2021},
+  organization = {ISO/IEC}
+}
+
+@book{knuth1984texbook,
+  author       = {Knuth, Donald E.},
+  title        = {The TeXbook},
+  year         = {1984},
+  publisher    = {Addison-Wesley},
+  address      = {Reading, Massachusetts},
+  isbn         = {0-201-13448-9}
+}
+
+@book{lamport1994latex,
+  author       = {Lamport, Leslie},
+  title        = {LaTeX: A Document Preparation System},
+  year         = {1994},
+  edition      = {2nd},
+  publisher    = {Addison-Wesley},
+  isbn         = {0-201-52983-1}
+}
+
+@book{love2010kernel,
+  author       = {Love, Robert},
+  title        = {Linux Kernel Development},
+  year         = {2010},
+  edition      = {3rd},
+  publisher    = {Addison-Wesley Professional},
+  isbn         = {978-0-672-32946-3}
+}

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

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+"""bundle.py: Mengemas hasil laporan PDF, DOCX, dan sumber Markdown menjadi arsip rilis zip."""
+
+import glob
+import os
+import shutil
+import sys
+import zipfile
+
+GREEN = "\033[0;32m"
+BLUE = "\033[0;34m"
+CYAN = "\033[0;36m"
+BOLD = "\033[1m"
+NC = "\033[0m"
+
+
+def main():
+    root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+    os.chdir(root)
+
+    print(f"{CYAN}{BOLD}")
+    print("  ========================================================")
+    print("             LAPORAN GENERATOR - BUNDLE PACKAGER          ")
+    print("  ========================================================")
+    print(f"{NC}")
+
+    # Cek apakah PDF & DOCX sudah ada
+    if not os.path.isfile("Laporan.pdf") or not os.path.isfile("Laporan.docx"):
+        print(f"  {BLUE}[1/3] Menjalankan build PDF dan DOCX...{NC}")
+        ret = os.system("./build.sh && make docx")
+        if ret != 0:
+            print("Gagal mengompilasi dokumen untuk bundling.")
+            return 1
+    else:
+        print(f"  {GREEN}[OK]{NC} Berkas Laporan.pdf dan Laporan.docx siap dikemas.")
+
+    out_dir = "dist"
+    os.makedirs(out_dir, exist_ok=True)
+    zip_path = os.path.join(out_dir, "Laporan-Akademik-Lengkap.zip")
+
+    files_to_pack = [
+        "Laporan.pdf",
+        "Laporan.docx",
+        "metadata.yml",
+        "references.bib",
+        "cover.md",
+    ]
+
+    for f in glob.glob("chapters/*.md"):
+        files_to_pack.append(f)
+
+    if os.path.isdir("gambar"):
+        for f in glob.glob("gambar/**/*", recursive=True):
+            if os.path.isfile(f):
+                files_to_pack.append(f)
+
+    print(f"  {BLUE}[2/3] Mengompresi berkas ke dalam {zip_path}...{NC}")
+    with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zf:
+        for f in files_to_pack:
+            if os.path.isfile(f):
+                zf.write(f, arcname=f)
+                sz = os.path.getsize(f) / 1024
+                print(f"    + {f:<30} ({sz:.1f} KB)")
+
+    total_sz = os.path.getsize(zip_path) / 1024
+    print("")
+    print(f"  {GREEN}{BOLD}[3/3] BUNDLE SELESAI DIBUAT!{NC}")
+    print(f"  * Lokasi Arsip : {CYAN}{BOLD}{os.path.abspath(zip_path)}{NC}")
+    print(f"  * Ukuran Arsip : {total_sz:.1f} KB ({len(files_to_pack)} berkas)")
+    print("  ========================================================")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/.agents/skills/laporan-generator/resources/scripts/docx-pagenum.py

@@ -0,0 +1,192 @@
+#!/usr/bin/env python3
+"""Isi nilai halaman asli ke field PAGEREF di daftar isi DOCX.
+
+Dua-pass:
+  1. Render DOCX (yang sudah di-finalize section-nya) via LibreOffice
+     (soffice --headless) menjadi PDF.
+  2. Baca nomor halaman setiap heading dari teks PDF (footer per halaman),
+     lalu tulis sebagai nilai cache PAGEREF di daftar isi.
+
+Hasil: daftar isi menampilkan nomor halaman asli di aplikasi manapun
+(Word, LibreOffice, Google Docs) tanpa perlu update field manual.
+
+Kalau soffice/pdftotext tidak tersedia, output = input (Word tetap
+memperbarui field saat dibuka karena updateFields=true).
+
+Usage:
+  python3 scripts/docx-pagenum.py input.docx output.docx
+"""
+
+import os
+import re
+import shutil
+import subprocess
+import sys
+import tempfile
+import zipfile
+
+ROMAN = re.compile(r"^[ivxlcdm]+$", re.I)
+DECIMAL = re.compile(r"^\d+$")
+
+
+def page_count(pdf):
+    out = subprocess.check_output(["pdfinfo", pdf], text=True, timeout=15)
+    m = re.search(r"^Pages:\s+(\d+)", out, re.M)
+    return int(m.group(1)) if m else 0
+
+
+def page_texts(pdf):
+    n = page_count(pdf)
+    pages = {}
+    for p in range(1, n + 1):
+        out = subprocess.check_output(
+            ["pdftotext", "-f", str(p), "-l", str(p), "-layout", pdf, "-"],
+            text=True,
+            timeout=15,
+        )
+        lines = [l.strip() for l in out.splitlines() if l.strip()]
+        pages[p] = lines
+    return pages
+
+
+def footer_of(lines):
+    if not lines:
+        return ""
+    return lines[-1]
+
+
+def find_toc_start(pages):
+    for p, lines in sorted(pages.items()):
+        for l in lines:
+            if l == "DAFTAR ISI":
+                return p
+    return None
+
+
+def first_decimal_page(pages, start):
+    for p, lines in sorted(pages.items()):
+        if p <= start:
+            continue
+        if DECIMAL.match(footer_of(lines)):
+            return p
+    return None
+
+
+def find_page(pages, needle, start, end):
+    for p in range(start, end + 1):
+        text = "\n".join(pages.get(p, []))
+        if needle in text:
+            return p
+    return None
+
+
+def parse_entries(doc):
+    entries = []
+    par_pat = re.compile(r"<w:p>(?:(?!</w:p>).)*?</w:p>", re.S)
+    for pm in par_pat.finditer(doc):
+        p = pm.group(0)
+        m = re.search(
+            r'<w:hyperlink w:anchor="([^"]+)"[^>]*>.*?<w:t[^>]*>([^<]*)</w:t>', p, re.S
+        )
+        r = re.search(
+            r"<w:instrText[^>]*>\s*PAGEREF\s+(\S+)\s+\\h\s*</w:instrText>", p
+        )
+        if m and r and m.group(1) == r.group(1):
+            entries.append((p, m.group(1), m.group(2)))
+    return entries
+
+
+def needle_of(entry_text):
+    if entry_text.startswith("BAB "):
+        parts = entry_text.split(" ", 2)
+        return parts[2] if len(parts) == 3 else parts[1]
+    return entry_text
+
+
+def render_pdf(docx):
+    tmp = tempfile.mkdtemp(prefix="lo_pagenum_")
+    profile = os.path.join(tmp, "profile")
+    subprocess.run(
+        [
+            "soffice", "--headless", "--norestore",
+            "-env:UserInstallation=file://" + profile,
+            "--convert-to", "pdf", "--outdir", tmp, docx,
+        ],
+        check=True,
+        capture_output=True,
+        timeout=45,
+    )
+    base = os.path.basename(docx).rsplit(".", 1)[0] + ".pdf"
+    return os.path.join(tmp, base)
+
+
+def main():
+    src, dst = sys.argv[1], sys.argv[2]
+    shutil.copy(src, dst)
+
+    if not shutil.which("soffice") or not shutil.which("pdftotext"):
+        print("[warn] docx-pagenum: soffice/pdftotext tidak ada, nomor halaman "
+              "daftar isi memakai nilai cache (Word tetap update saat dibuka)")
+        return
+
+    with zipfile.ZipFile(src, "r") as zin:
+        names = zin.namelist()
+        items = {n: zin.read(n) for n in names}
+    doc = items["word/document.xml"].decode("utf-8")
+
+    try:
+        pdf = render_pdf(src)
+    except (subprocess.TimeoutExpired, subprocess.SubprocessError) as err:
+        print(f"[warn] docx-pagenum: render LibreOffice gagal/timeout ({err}), nomor halaman memakai nilai cache default.")
+        return
+
+    try:
+        pages = page_texts(pdf)
+    except (subprocess.TimeoutExpired, subprocess.SubprocessError) as err:
+        print(f"[warn] docx-pagenum: ekstraksi teks PDF gagal/timeout ({err}), nomor halaman memakai nilai cache default.")
+        return
+    finally:
+        shutil.rmtree(os.path.dirname(pdf), ignore_errors=True)
+
+    toc_start = find_toc_start(pages)
+    if not toc_start:
+        print("[warn] docx-pagenum: halaman DAFTAR ISI tidak ditemukan di render")
+        return
+    first_dec = first_decimal_page(pages, toc_start)
+    if not first_dec:
+        print("[warn] docx-pagenum: halaman body (decimal) tidak ditemukan")
+        return
+
+    entries = parse_entries(doc)
+    injected = 0
+    for para, pid, text in entries:
+        if pid == "kata-pengantar":
+            page = find_page(pages, "KATA PENGANTAR", 1, toc_start - 1)
+        else:
+            page = find_page(pages, needle_of(text), first_dec, max(pages))
+        if not page:
+            print(f"[warn] docx-pagenum: heading '{text}' tidak ditemukan di render")
+            continue
+        value = footer_of(pages[page])
+        if not (ROMAN.match(value) or DECIMAL.match(value)):
+            print(f"[warn] docx-pagenum: footer halaman {page} tidak valid: {value!r}")
+            continue
+        new_para = re.sub(
+            r'(<w:fldChar w:fldCharType="separate"/></w:r><w:r><w:t[^>]*>)[^<]*(</w:t>)',
+            r"\g<1>" + value + r"\g<2>",
+            para,
+            count=1,
+        )
+        doc = doc.replace(para, new_para)
+        injected += 1
+        print(f"[OK] {text} -> halaman {page} (nomor {value})")
+
+    items["word/document.xml"] = doc.encode("utf-8")
+    with zipfile.ZipFile(dst, "w", zipfile.ZIP_DEFLATED) as zout:
+        for n, content in items.items():
+            zout.writestr(n, content)
+    print(f"[OK] docx-pagenum: {injected} nomor halaman diisi -> {dst}")
+
+
+if __name__ == "__main__":
+    main()