v0.3.9

OMCIPcap v0.3.9

This release introduces the first AI-native diagnosis framework for OMCIPcap while preserving the existing semantic OMCI analysis workflow.

✨ Highlights

• Add multi-provider AI adapter framework (OpenAI, Claude, Gemini, OpenRouter, Ollama)
• Add ai diag for AI-assisted diagnosis of a single OMCI capture
• Add ai diag-diff for Target vs. Golden semantic diagnosis
• Support configurable OLLAMA_BASE_URL
• Add version / --version CLI commands
• Split AI Diagnosis and AI/RAG user guides
• Improve documentation and CLI usability

Thanks for using OMCIPcap! Bug reports, feature requests, and anonymized OMCI interoperability cases are always welcome.

Full Changelog: v0.3.8...v0.3.9

v0.3.8

omcipcap v0.3.8

Highlights

🤖 Local AI/RAG workflow

• Added local RAG workspace initialization, ingestion, querying, status, profiles, and case management.
• Build a private OMCI troubleshooting knowledge base from your own captures.
• Persist generated Markdown reports and filtered OMCI-only PCAPs.
• Added example issue cases and reproducible PCAP generators.

📝 New overview command

• Replaced overview-json with overview.
• Markdown is now the default output.
• JSON output is available with -j.
• Generates a unified report including ONU capability, validation, MIB summary, VLAN rules, T-CONT/GEM flows, and topology.

📚 Documentation

• Added a comprehensive AI/RAG user guide.
• Updated README and CLI documentation.
• Improved examples and test coverage.

🔧 Improvements

• RAG commands are now optional (pip install "omcipcap[rag]").
• Improved semantic retrieval and Markdown rendering.
• Various bug fixes and internal refactoring.

Breaking change

overview-json has been replaced by:

omcipcap overview capture.pcap -j

Full Changelog: v0.3.7...v0.3.8

v0.3.7

v0.3.7

Highlights

• Add Markdown (--md) output support for major analysis commands
• Add Markdown export for topology nodes and edges
• Fix bridge port topology parsing
• Improve semantic decoding for administrative and operational state

Changes

• Added --md output for:
  • check
  • mibdb
  • mibdb-diff / diff
  • vlan-tbl
  • tcont-flow
  • topology
• Added omcimd.py for Markdown rendering
• Fixed topology parsing to use Bridge ID pointer consistently
• Fixed TP pointer resolution by checking TP type
• Updated README feature table
• Added Markdown output tests

Notes

This release improves Markdown-friendly export for documentation, issue tracking, and future AI/RAG workflows.

Full Changelog: v0.3.6...v0.3.7

v0.3.6

v0.3.6

Changes

Bug Fixes

• Expand Python version support to 3.10 and 3.11
  • Change requires-python from >=3.12 to >=3.10
  • Add CI matrix to test Python 3.10, 3.11, 3.12
  • Enables deployment on enterprise Linux (RHEL 8, Ubuntu 20.04, etc.)

Improvements

• Verify scapy and rich dependencies are compatible with Python 3.10+

Installation

pip install omcipcap==0.3.6

Full Changelog: v0.3.5...v0.3.6

v0.3.5

v0.3.5 (2026-06-29)

New Features

• overview-json subcommand — Combines all sub-command JSON outputs
  (check, mibdb, vlan-tbl, tcont-flow, topology) into a single
  overview.json file, designed for AI-assisted OMCI diagnostics
• overview-json supports --mib-json and --semantic-dir — Vendor-specific
  ME definitions and semantic extensions are now applied to the full overview output

Improvements

• mibdb-diff now supports --semantic-dir — Previously only --mib-json
  was handled; semantic extensions are now consistently applied across all
  relevant subcommands
• Refactored JSON/semantic loading — Consolidated --mib-json and
  --semantic-dir error handling into a shared helper, with proper error
  messages and early exit on failure

Bug Fixes

• Fixed load_external_semantics() not returning a value on directory error,
  causing silent failures when an invalid --semantic-dir was provided

Full Changelog: v0.3.4...v0.3.5

v0.3.4

🏷️ v0.3.4 Release Notes
This release brings major architecture decoupling for downstream AI logic integration, comprehensive G.988 hardware capability matrix support, and a highly requested standalone modular execution pipeline.

🛠️ Added

• Advanced TPID/DEI Semantic UI Matrix: Added the --tpid-dei CLI flag to vlan-tbl. It bypasses raw bit-fields to dynamically display localized ITU-T G.988 semantic translations (e.g., TPID:Input, TPID:Out,DEI:Inn).
• Lossless Hardware Capability Profiler: Implemented get_onu_capability() to parse and map hardware capability configurations based on ITU-T G.988 Table 9.1.5-1 (Plug-in Unit Types).
• Vendor ME Profile Splitting: Segregated proprietary Vendor ME metrics into two distinct profiles: ONU Upload and OLT Provision for higher granular analysis.
• Standalone AI Pipeline Entry Point: Fully supports global module execution after pip install. Users can now generate AI-ready JSON fact packages directly from anywhere via:

python3 -m omci.overview <path_to_pcap>

Full Changelog: v0.3.3...v0.3.4

v0.3.3

Full Changelog: v0.3.2...v0.3.3

v0.3.2

Full Changelog: v0.3.1...v0.3.2

v0.2.5

Full Changelog: v0.2.4...v0.2.5

v0.3.1

🚀 v0.3.1 - The Semantic Framework Update

This major release marks the transformation of omcipcap from a basic packet parser into a comprehensive GPON/XGS-PON OMCI Semantic Analysis Framework. It introduces a pluggable semantic registry, enhanced JSON IR for AI-driven analysis, and critical stability fixes for standalone binaries.

🌟 Major Highlights

1. Dynamic Semantic Framework

• Pluggable Translators: Introduced the OMCISemantic registry to decouple G.988 logic from the core protocol parser.
• Runtime Extensions: Added the --semantic-dir argument, allowing users to dynamically load external Python scripts (e.g., extensions/add_me134_option.py) to override or extend ME attribute decoding logic without modifying the core source code.
• Intelligent Decoding: Native support for human-readable IPv4 addresses, MAC addresses, and VLAN filter lists (ME 84/171) instead of raw hexadecimal strings.

2. AI-Ready Topology & JSON IR

• Topology Command: Rebranded the graphic command to topology with enhanced data depth.
• Machine-Readable Relations: The Topology JSON now includes explicit semantic relations (pointers) between MEs, specifically optimized for path analysis by LLMs (e.g., GPT-4, Claude).
• Standardized JSON Output: Added -j/--json-output support across all sub-commands (mibdb, diff, check, vlan-tbl, tcont-flow).

3. Advanced MIB Management

• mibdb Command: A powerful new command to snapshot and analyze the entire ONU MIB state from PCAP files.
• Semantic diff: Implemented semantic-aware MIB comparisons. You can now see logical changes like VID: 100 -> VID: 200 instead of binary/hex differences.
• Custom MIB Definitions: Support for --mib-json to load vendor-specific Managed Entity (ME) definitions.

4. CLI & UI Revamp

• Kebab-case Standardization: Standardized all sub-commands to POSIX/GNU style (e.g., vlan-tbl, tcont-flow).
• Rich UI: Integrated the rich library for beautiful, color-coded terminal tables and hierarchical trees.

---

🔧 Fixes & Maintenance (v0.3.1 Hotfix)

• Absolute Import Enforcement: Resolved ImportError issues on Windows and Linux standalone binaries by migrating from relative to absolute imports in cli.py.
• CI/CD Integration: Implemented a GitHub Actions workflow for automated testing on Ubuntu 24.04.
• Code Quality: Standardized copyright headers and performed a comprehensive cleanup of unused imports.

📖 Example Usage

# Analyze MIB state with custom vendor extensions
omcipcap mibdb --class-id=134 --semantic-dir ./extensions sample.pcapng

# Compare two MIB states with semantic-aware output
omcipcap diff base.pcap target.pcap

Full Changelog: v0.2.4...v0.3.1