Semua perubahan penting pada proyek ini akan didokumentasikan di file ini.
Format mengikuti Keep a Changelog, dan proyek ini menggunakan Semantic Versioning.
- Write operations (
tools/config_write.py): toolrun_command_writeuntuk eksekusi perintah destruktif di router — selalu memerlukan approval operator via interrupt gate; hard-blocked untukformat,factory-reset,reset-configuration agents/metrics.py:TokenMetricsCallback— catat stats Ollama (prompt/eval tokens, duration) kedata/metrics.jsonlsebagai JSONL append-only;get_token_metrics()di public API- 6 skill baru:
skills/config/config-change.md— prosedur ubah konfigurasi spesifik dengan backup-firstskills/dhcp/static-lease-management.md— kelola DHCP static leaseskills/interface/link-diagnostics.md— diagnosa interface error dan flappingskills/maintenance/router-maintenance.md— upgrade dan reboot terjadwalskills/routing/static-route-management.md— tambah/hapus static routeskills/security/brute-force-response.md— blokir IP penyerang (response dari deteksi)skills/security/firewall-management.md— kelola firewall rules MikroTik
- 2 template laporan baru:
skills/documents/templates/network-status.mdskills/documents/templates/routing-bgp-ospf.md
- Routing tools baru (
tools/routing.py):get_bgp_sessions,get_ospf_neighbors,get_interface_stats— SSH ke router, parse output, format sebagai tabel ringkas - Sistem evaluasi (
tests/):tests/eval.py— evaluator script: patch TOOL_MAP dengan mock, jalankan agent, verifikasi expected_agents/expected_tools/acceptance_criteria; support--labuntuk koneksi nyatatests/mocks/fixtures.py— mock data realistis kampus UB per tool (17 router)tests/scenarios/*.yaml— 5 skenario evaluasi:bgp-ospf-report,health-check,brute-force-detect,dhcp-exhaustion,interface-flapping
docs/teaching-log.md— log institutional memory: apa yang gagal, root cause, perubahan, hasil; 7 entri dari sesi pengembangan (gemma4 num_predict bug, max_iters, forced summary, dll)tui.pyheadless + debug mode:--headless "pesan"untuk non-interactive,--debuguntuk tampilkan raw supervisor response dan token metadata
supervisor.md:chat_promptdibaca dari definition file (bukan hardcode di nodes.py); tabel routing diperbarui untuk mencakup skill write operationsconfig_agent.md: ditambah 7 skill write-capable + tabel quick-reference skill → toolsdocument_agent.md: skillskill-authoringdiperbarui denganfetch_urluntuk referensi URLskills/documents/skill-authoring.md: tambah section Prinsip untuk Model Kecil (tabel what-works vs what-doesn't, 5 aturan utama) dan Checklist Review Sebelum Commit (9 item)skills/routing/bgp-diagnostics.mddanospf-diagnostics.md: diperbarui signifikan dengan contoh output tool dan interpretasi eksplisitskills/security/security-audit.md: diperbarui dengan prosedur brute force detectiontools/base.py: refactor SSH helpers; tambahget_unique_router_entries()tui.py: refactor UI layer, pemisahan concern TUI vs agent logic
config_agentsystem prompt sekarang punya skill quick-reference table — agent tidak bingung saat supervisor menginjeksi skill tertentu dari 7 pilihan
- Agent Definition System (Ultralight Orchestration): 6 file
agents/definitions/*.mdsebagai single source of truth untuk tiap agent — tools, skills, LLM params, dan system prompt semuanya ada di satu file agents/loader.py(AgentLoader+AgentDefinition): memuat dan memvalidasi definition files saat startup; mengecekagent.tools ⊆ TOOL_MAP,agent.skills ⊆ SkillLibrary, danskill.tools ⊆ agent.tools- Per-agent LLM parameters di frontmatter definition:
num_ctx,num_predict,context_window,timeout— supervisor pakai 4096/256/6/60, document_agent pakai 24576/4096/20/600 - Skill baru:
skills/monitoring/network-traffic-analysis.md(analisis bandwidth dan top talkers) document_agentditambahkan ke graph topology dan tool matrix
agents/tools.py: hapus per-agent tool lists (MONITOR_TOOLS,DIAGNOSE_TOOLS, dll); ganti denganTOOL_MAPflat dari semua 34 toolsagents/nodes.py: semua hardcoded data (tool lists, role descriptions, alias map, LLM params) dihapus dan dibaca dariAgentLoader;_make_llm()menerimanum_ctx,num_predict,timeoutsebagai parameter- 7 skill direname ke konvensi
[domain]-[capability-noun]:config-backup-procedure→config-backupdiagnose-dhcp-client→dhcp-client-diagnosticsutbk-client-monitor→utbk-session-monitoringwrite-report→document-writingrouter-unreachable→network-reachabilitynetwork-report→network-status-reportospf-neighbor-down→ospf-diagnostics
- 4 skill tool lists diperbarui untuk menutup gap coverage:
network-health-check(+get_interface_stats),config-backup(+backup_router_config),document-writing(+write_skill,get_report_section,get_report_toc),monitor_agent(+network-traffic-analysis)
- 3 tool mismatch di
agents/tools.py:search_devicedanrun_commandditambahkan ke monitor;get_router_configditambahkan ke diagnose - Supervisor body tidak lagi hardcode daftar agent (kini dinamis dari
AgentLoader) defn.modelkini benar-benar digunakan di setiap node (sebelumnya semua pakaiOLLAMA_MODELenv var)
docs/ARCHITECTURE.mdv2.0: tambah Section 6 (Agent Definition System), perbarui directory structure, tool matrix, dan skill listingdocs/SKILL_AUTHORING_GUIDE.mdv1.1: tambah konvensi penamaan skill, perbarui contoh dan file listingdocs/RESEARCH_SKILL_TOOL_ARCHITECTURE.md: riset referensi framework (Evonic, OpenAI Agents SDK, GStack, Ultralight Orchestration, GetStream)
- Document Agent ("budi"): specialist ke-5 untuk menulis laporan ke file, mengelola template, dan mengkurasi hasil agent lain menjadi dokumen terstruktur
- 4 document tools di
tools/document.py:list_templates,read_template,write_document,create_template - Skill
write-reportdiskills/documents/: prosedur lengkap menulis laporan kelaporan/menggunakan template - Template
security-assessment.md: blank template penilaian keamanan web dengan{{PLACEHOLDER}}diskills/documents/templates/ AGENT_ALIASdict: display names untuk semua agent (bambang/eko/agus/joko/satria/budi); log agent kini menampilkan nama aliascontext_windowparameter di_make_specialist_node(): document_agent pakai window 20 messages (specialist lain default 10)- Skip subdirektori
templates/diSkillLibrary._load_all()— file template tidak dimuat sebagai skill - Dokumentasi LangGraph:
docs/LANGGRAPH_FUNDAMENTALS.md,docs/AGENT_COMMUNICATION_PATTERNS.md,docs/PERSISTENCE_AND_MEMORY.md
- Total tool atomic: 28 → 32
- Total skill contoh: 9 → 10
- Supervisor prompt diperbarui: tambah
document_agentke routing options dan penjelasan alur multi-domain ke dokumentasi
Rilis major pertama NetOps AI — platform operasional jaringan kampus berbasis multi-agent LangGraph. Transformasi dari tool monitoring DHCP monolitik menjadi sistem multi-agent yang dapat dikonfigurasi operator.
- Multi-agent LangGraph: Supervisor + 4 specialist agents (monitor, diagnose, config, security) via
agents/nodes.pydanagents/graph.py - Skill System:
SkillLibrarydiskills/library.pydengan hot reload viawatchfiles; 9 skill contoh tersedia diskills/ - 28 tool atomic di
tools/(dipecah dariagent.pymonolitik):tools/traffic.py:get_interface_traffic,get_traffic_summary,get_top_talkers,get_queue_stats,get_traffic_alltools/config_backup.py:backup_router_config,list_backups,diff_configtools/base.py: SSH helper terpusat untuk semua tool
- Human-in-the-loop approval:
interrupt()gate diconfig_nodeuntukbackup_router_config; TUI menampilkan approval modal Y/N AgentActivityScreen(menu 7): monitoring komunikasi antar agent real-time (routing, tool calls, tool results, approval)- Public API di
agent.py:create_agent(),stream_agent_response(),submit_approval(),get_available_skills(),get_agent_status() - Dokumentasi lengkap:
docs/PRD.md,docs/ARCHITECTURE.md,docs/IMPLEMENTATION_PLAN.md,docs/SKILL_AUTHORING_GUIDE.md
agent.pyditulis ulang dari ~2600 baris monolitik menjadi 178 baris public API + orchestration murnitui.pydirefactor: semua LLM/agent logic dipindah keagent.py; tui.py menjadi zero LLM (1592 baris, -229 dari sebelumnya)- Title TUI: "NetOps AI — Campus Network Operations"
- Default model:
qwen3:32b(sebelumnyaqwen3.6:35b-a3b-q8_0) - Nama tool distandarisasi:
read_report→get_report,audit_all_routers→audit_dhcp,get_all_leases_for_router→get_router_leases,run_command_all_routers→run_command_all
- StructuredTool unhashable: deduplication tool map menggunakan
dict.setdefault()bukanset() - LangGraph routing function:
route_from_supervisor(state: dict)— type hintdictbukan forward ref"NetworkOpsState"untuk menghindariNameErrorsaatget_type_hints()dipanggil
- Credentials SSH tidak pernah masuk ke agent log atau output
backup_router_configmemerlukan persetujuan eksplisit operator sebelum dieksekusi- File backup di
backups/dikecualikan dari git
- Menambahkan tool
run_diagnostic()untuktraceroute,ping, danflood-pingdengan timeout 60 detik. - Menambahkan adaptasi otomatis command untuk RouterOS v6 dan v7 pada jalur diagnostik.
- Memperbarui system prompt dengan panduan penggunaan
run_diagnosticdibandingrun_commanduntuk kasus troubleshooting jaringan.
- Memperbaiki masalah timeout traceroute (sebelumnya 15 detik tidak cukup pada beberapa lintasan jaringan).
- Tidak ada perubahan security spesifik pada versi ini.
- Menambahkan tool
run_command()untuk eksekusi command MikroTik read-only secara fleksibel. - Menambahkan tool
run_command_all_routers()untuk eksekusi command paralel ke semua router.
- Menaikkan
recursion_limitagent dari 15 menjadi 50 untuk mendukung audit paralel 17 router. - Memperbarui instruksi agent agar menggunakan konteks
routing-staticalih-alihip-routepada analisis tertentu.
- Tidak ada perbaikan bug mayor yang didokumentasikan terpisah pada versi ini.
- Menambahkan blocklist kata/perintah destruktif pada jalur
run_command.
- Menambahkan tool
get_router_log()untuk membaca log sistem router. - Menambahkan tool
get_router_config()untuk mengambil 20+ section konfigurasi MikroTik. - Menambahkan tool
get_routing_full()untuk inspeksi protokol routing secara terpadu. - Menambahkan section inspeksi
ip-neighbor,ip-arp, danip-neighbor-detail.
- Klarifikasi istilah "neighbor" pada system prompt agar membedakan konteks LLDP/CDP vs OSPF.
- Tidak ada perbaikan bug mayor yang didokumentasikan terpisah pada versi ini.
- Tidak ada perubahan security spesifik pada versi ini.
- Menambahkan tools pembacaan laporan:
list_reports,get_report_toc,read_report, danread_report_section.
- Menaikkan batas truncation laporan di
tui.pydari 4000 menjadi 12000 karakter.
- Memperbaiki error
INVALIDCHATHISTORYditui.pydengan mekanisme auto-reset dan retry. - Memperbaiki validasi nama router agar case-insensitive di
_validate_router().
- Tidak ada perubahan security spesifik pada versi ini.
- Menambahkan dukungan
.envuntukOLLAMA_BASE_URLdanOLLAMA_MODELpadaagent.pydangenerate_reports.py. - Menambahkan
_load_dotenv()manual tanpa dependencypython-dotenv. - Menambahkan tool
get_current_time()dengan zona waktu WIB (UTC+7). - Menambahkan system prompt dinamis dengan injeksi waktu saat agent dibuat.
- Memindahkan konfigurasi endpoint/model Ollama dari nilai statis menjadi konfigurasi eksternal berbasis
.env.
- Tidak ada perbaikan bug mayor yang didokumentasikan terpisah pada versi ini.
- Mengurangi risiko hardcoded konfigurasi AI dengan pemisahan konfigurasi ke file environment lokal.
- Menambahkan
agent.pyberbasis LangGraph ReAct. - Menambahkan tool awal agent:
list_routers,check_reachability,get_system_info,get_dhcp_leases,get_all_leases_for_router,audit_all_routers,search_device. - Menambahkan
generate_reports.pyuntuk pembuatan laporan markdown harian dengan analisis AI.
- Memperluas alur operasional dari koleksi data mentah menjadi analisis berbasis agent dan laporan otomatis.
- Tidak ada perbaikan bug mayor yang didokumentasikan terpisah pada versi ini.
- Tidak ada perubahan security spesifik pada versi ini.
- Menambahkan
tui.pyberbasis curses. - Menambahkan 6 layar operasional: Dashboard, Jadwal, Collect, Laporan, Log, AI Chat.
- Menambahkan auto-refresh dashboard.
- Menambahkan integrasi Ollama HTTP sebagai fallback AI Chat.
- Mengubah mode operasi dari CLI-only menjadi kombinasi CLI + terminal UI.
- Tidak ada perbaikan bug mayor yang didokumentasikan terpisah pada versi ini.
- Tidak ada perubahan security spesifik pada versi ini.
- Rilis awal proyek monitoring DHCP lease.
- Menambahkan
mikrotik_agent.pysebagai SSH collector dan parser DHCP. - Menambahkan dukungan RouterOS v6 dan v7.
- Menambahkan output file ke
output/*.txt. - Menambahkan CLI flags:
--config,--dry-run,--detail,--no-save.
- Tidak ada perubahan pada versi awal.
- Tidak ada perbaikan pada versi awal.
- Menetapkan praktik non-commit untuk konfigurasi sensitif (
config.yaml) sebagai baseline operasional.