udsdoc 0.66.0__tar.gz

udsdoc-0.66.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 udsdoc contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

udsdoc-0.66.0/PKG-INFO

@@ -0,0 +1,347 @@
+Metadata-Version: 2.4
+Name: udsdoc
+Version: 0.66.0
+Summary: Generate UDS (ISO 14229 / 15765) specification documents and ISO 22901-1 ODX/PDX from AUTOSAR DCM/CanTp/DEM ARXML (formerly udsxml2tex)
+Author: udsdoc contributors
+License: MIT
+Project-URL: Homepage, https://github.com/YutaroNakagama/udsdoc
+Project-URL: Repository, https://github.com/YutaroNakagama/udsdoc
+Project-URL: Changelog, https://github.com/YutaroNakagama/udsdoc/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/YutaroNakagama/udsdoc/issues
+Keywords: autosar,arxml,uds,dcm,dem,cantp,iso14229,iso15765,iso22901,odx,pdx,latex,tex,diagnostics,udsxml2tex
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Manufacturing
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Embedded Systems
+Classifier: Topic :: Text Processing :: Markup :: LaTeX
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lxml>=4.9.0
+Requires-Dist: Jinja2>=3.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Provides-Extra: web
+Requires-Dist: fastapi>=0.100.0; extra == "web"
+Requires-Dist: uvicorn>=0.22.0; extra == "web"
+Requires-Dist: python-multipart>=0.0.6; extra == "web"
+Requires-Dist: PyYAML>=6.0; extra == "web"
+Requires-Dist: python-dotenv>=1.0; extra == "web"
+Requires-Dist: pymupdf>=1.24; extra == "web"
+Provides-Extra: yaml
+Requires-Dist: PyYAML>=6.0; extra == "yaml"
+Provides-Extra: svg
+Requires-Dist: pymupdf>=1.24; extra == "svg"
+Provides-Extra: watch
+Requires-Dist: watchdog>=3.0; extra == "watch"
+Provides-Extra: docx
+Requires-Dist: python-docx>=1.0; extra == "docx"
+Provides-Extra: lsp
+Requires-Dist: pygls>=1.2; extra == "lsp"
+Provides-Extra: progress
+Requires-Dist: tqdm>=4.65; extra == "progress"
+Provides-Extra: rich
+Requires-Dist: rich>=13.0; extra == "rich"
+Provides-Extra: viz
+Requires-Dist: matplotlib>=3.5; extra == "viz"
+Requires-Dist: numpy>=1.20; extra == "viz"
+Provides-Extra: llm
+Requires-Dist: anthropic>=0.40.0; extra == "llm"
+Requires-Dist: openai>=1.0.0; extra == "llm"
+Provides-Extra: ecu-test
+Requires-Dist: python-can>=4.3.0; extra == "ecu-test"
+Requires-Dist: python-isotp>=2.0.0; extra == "ecu-test"
+Provides-Extra: all
+Requires-Dist: fastapi>=0.100.0; extra == "all"
+Requires-Dist: uvicorn>=0.22.0; extra == "all"
+Requires-Dist: python-multipart>=0.0.6; extra == "all"
+Requires-Dist: PyYAML>=6.0; extra == "all"
+Requires-Dist: python-dotenv>=1.0; extra == "all"
+Requires-Dist: pymupdf>=1.24; extra == "all"
+Requires-Dist: watchdog>=3.0; extra == "all"
+Requires-Dist: python-docx>=1.0; extra == "all"
+Requires-Dist: pygls>=1.2; extra == "all"
+Requires-Dist: tqdm>=4.65; extra == "all"
+Requires-Dist: rich>=13.0; extra == "all"
+Requires-Dist: matplotlib>=3.5; extra == "all"
+Requires-Dist: numpy>=1.20; extra == "all"
+Requires-Dist: anthropic>=0.40.0; extra == "all"
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: python-can>=4.3.0; extra == "all"
+Requires-Dist: python-isotp>=2.0.0; extra == "all"
+Provides-Extra: ci-test
+Requires-Dist: fastapi>=0.100.0; extra == "ci-test"
+Requires-Dist: uvicorn>=0.22.0; extra == "ci-test"
+Requires-Dist: python-multipart>=0.0.6; extra == "ci-test"
+Requires-Dist: PyYAML>=6.0; extra == "ci-test"
+Requires-Dist: python-dotenv>=1.0; extra == "ci-test"
+Requires-Dist: pymupdf>=1.24; extra == "ci-test"
+Requires-Dist: watchdog>=3.0; extra == "ci-test"
+Requires-Dist: python-docx>=1.0; extra == "ci-test"
+Requires-Dist: pygls>=1.2; extra == "ci-test"
+Requires-Dist: tqdm>=4.65; extra == "ci-test"
+Requires-Dist: rich>=13.0; extra == "ci-test"
+Requires-Dist: matplotlib>=3.5; extra == "ci-test"
+Requires-Dist: numpy>=1.20; extra == "ci-test"
+Requires-Dist: anthropic>=0.40.0; extra == "ci-test"
+Requires-Dist: openai>=1.0.0; extra == "ci-test"
+Dynamic: license-file
+
+# udsdoc
+
+**AUTOSAR DCM/CanTp/DEM ARXML → ISO 14229 (UDS) / ISO 15765 / ISO 22901-1 (ODX/PDX) specification documents.**
+
+[![PyPI version](https://badge.fury.io/py/udsdoc.svg)](https://badge.fury.io/py/udsdoc)
+[![Python](https://img.shields.io/pypi/pyversions/udsdoc.svg)](https://pypi.org/project/udsdoc/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> **Renamed from `udsxml2tex` (v0.66.0).** The old PyPI package now installs
+> this one; the `udsxml2tex` CLI command, `UDSXML2TEX_*` environment
+> variables, `~/.udsxml2tex/` config directory and `udsxml2tex-*` pre-commit
+> hook ids keep working as deprecated aliases until v1.0.
+> Migration: `pip install udsdoc`, command `udsdoc`, `import udsdoc`.
+
+`udsdoc` parses AUTOSAR diagnostic ARXML (DCM, CanTp, DEM, DoIP, COM, AP)
+and renders a complete UDS specification in **LaTeX / PDF / HTML / Markdown
+/ RST / CSV / YAML / JSON / DOCX**, plus **ASAM ODX 2.2.0 / PDX**
+(ISO 22901-1) for industry diagnostic tooling.
+
+It also ships a local **browser UI** (`--serve`) that one-clicks an entire
+BSW software repository through the pipeline, auto-detecting single-ECU
+vs multi-ECU layouts.
+
+---
+
+## Install
+
+```bash
+pip install udsdoc                  # core (LaTeX / Markdown / JSON / YAML)
+pip install udsdoc[web]             # browser UI (--serve) + inline TikZ-UML SVG figures
+pip install udsdoc[llm]             # LLM analysis (Anthropic + OpenAI / Ollama)
+pip install udsdoc[ecu-test]        # CAN/ISO-TP hardware testing
+pip install udsdoc[all]             # everything
+```
+
+Other extras: `yaml`, `svg`, `watch`, `docx`, `lsp`, `progress`, `rich`, `viz`.
+
+A LaTeX distribution (TeX Live / MiKTeX with `xelatex` for CJK) is required
+to compile generated `.tex` to PDF. The HTML output renders standalone.
+TikZ-UML diagrams in the HTML output (SID 0x10 session FSM, SID 0x27
+SecurityAccess FSM and sequence) are compiled to inline SVG when `xelatex`
+plus a PDF→SVG tool are present — the `[web]` / `[svg]` extras pull in
+`pymupdf`, which provides an in-process PDF→SVG converter so no system
+binary (`pdftocairo` / `dvisvgm` / `pdf2svg` / `inkscape`) is required.
+Without the toolchain the HTML output silently falls back to Mermaid.
+
+---
+
+## Quick start
+
+```bash
+# Single ARXML → LaTeX
+udsdoc dcm.arxml -o spec.tex
+
+# Merge DCM + CanTp + DEM
+udsdoc dcm.arxml cantp.arxml --dem dem.arxml -o spec.tex
+
+# Auto-discover everything under a BSW repo (CLI mirror of the browser UI)
+udsdoc --repo /path/to/bsw-project -o spec.tex
+udsdoc --repo /path/to/bsw-project --repo-dry-run     # show classification
+
+# Application + Bootloader ARXMLs owned by separate teams — placed in
+# parallel subtrees (app/, boot/) under the repo root. The scanner
+# detects boot-domain files by path tokens (boot/, bootloader/, bl/,
+# fbl/, pbl/, sbl/, *_boot*, *_bl*) and merges them into ONE spec with
+# the Drive vs Boot domain tagged per session / service / DID / RID.
+udsdoc --repo /path/to/bsw-project -o spec.tex
+#   → "INFO: …merged bootloader spec (1 sessions, 1 dids, 1 routines)"
+
+# Hand-off helper: OEM team has only a requirement-analysis CSV (Compliance Matrix
+# format from `udsdoc --compliance-matrix-csv …`) and needs a Dcm ARXML skeleton
+# to give the external bootloader supplier as the contract. Generate one
+# without parsing any ARXML at all:
+udsdoc --gen-arxml-from-csv oem_boot_requirements.csv \
+           --gen-arxml-output   boot_skeleton.arxml \
+           --gen-arxml-ecu-name BootMcuA \
+           --gen-arxml-domain   boot          # boot|drive|both|all
+
+# Output formats
+udsdoc dcm.arxml --format html  -o spec.html
+udsdoc dcm.arxml --format md    -o spec.md
+udsdoc dcm.arxml --format pdx   -o ecu.pdx            # ISO 22901-1 PDX
+udsdoc dcm.arxml --pdf                                 # compile to PDF
+
+# Multi-language output:
+#   --lang en+ja+de   → ONE document with stacked translations (browser UI default)
+#   --langs en,ja,de  → one document per language (legacy multi-file mode)
+udsdoc dcm.arxml --lang en+ja+de  -o spec.tex
+udsdoc dcm.arxml --langs en,ja,de -o spec.md --format md
+
+# Validation, diff, multi-ECU systems
+udsdoc dcm.arxml --validate
+udsdoc new.arxml --diff old.arxml
+udsdoc --system system.yaml --system-output-dir out/   # 1+1 / gateway
+
+# Browser UI
+udsdoc --serve                                         # http://127.0.0.1:8765
+```
+
+### Python API
+
+```python
+from udsdoc import ArxmlParser, TexGenerator, validate, diff_specs
+
+spec = ArxmlParser().parse_multi(["dcm.arxml", "cantp.arxml"])
+TexGenerator().generate(spec, "spec.tex")
+TexGenerator().compile_pdf("spec.tex")
+
+print(validate(spec).summary())                # ISO 14229-1 consistency
+print(diff_specs(spec_a, spec_b).to_markdown())
+```
+
+---
+
+## Features
+
+**Coverage**
+
+- DCM (ISO 14229-1) — sessions, security, all 26 standard services, DIDs,
+  routines, DTCs, memory ranges, IO control / periodic / dynamic DIDs,
+  Authentication, ResponseOnEvent, LinkControl, multi-client.
+- CanTp (ISO 15765-2) — channels, BS/STmin, N_As/Bs/Cs/Ar/Br/Cr, addressing.
+- DEM (ISO 14229-1 §11) — DTC config, OBD/WWH-OBD, freeze frames, extended
+  data, operation cycles, indicators, combined DTCs.
+- DoIP (ISO 13400), Communication ARXML, Adaptive Platform service interfaces.
+- C/C++ source scanning — DID/RID global variables (transitive depth ≤3).
+- Bootloader overlay — single document covering Drive + Boot domains via YAML.
+
+**Output**
+
+- `tex` (Jinja2 + structured ZIP), `pdf` (xelatex/latexmk), `html` (multi-page
+  ZIP with offline Mermaid + NRC ladders), `md`, `rst`, `csv`, `yaml`,
+  `json`, `docx`, `odx`, `pdx`.
+- Visualizations: heatmaps, timing diagrams, UML sequences, byte-level
+  DID maps, session/security FSMs.
+
+**Requirements Compliance (ASPICE SYS.2.BP4 / ISO 26262-8 §6.4.5)**
+
+- `--compliance-matrix CSV [CSV ...]` + `--compliance-matrix-sources YAML` — append a Requirements
+  Compliance Matrix chapter to the LaTeX/PDF output that joins each
+  upstream requirement against the parsed ARXML (SID / DID / RID / DTC /
+  session / security level). Resolved coverage % is computed and shown;
+  unresolved rows are flagged with an asterisk.
+
+**Quality**
+
+- `--validate` — 17 ISO 14229-1 consistency checks.
+- `--diff` — semantic spec diff (ARXML or JSON).
+- `--iso-version {2006,2013,2020}` — drop features outside the chosen revision.
+- `--autosar-compat-report` — flag features postdating the detected AUTOSAR release.
+- Schema export: JSON Schema (draft-07), Pydantic v2 model source.
+
+**LLM analysis** (`[llm]` extra)
+
+- `--llm-summarize`, `--llm-query`, `--llm-nrc-descriptions`, `--llm-translate`.
+- Backends: Anthropic Claude API or any OpenAI-compatible server (Ollama,
+  llama.cpp, vLLM, OpenRouter, Azure). One-shot setup:
+  `udsdoc --bootstrap-ollama` (Linux/macOS).
+
+**ECU hardware testing** (`[ecu-test]` extra)
+
+- Auto-generates UDS test cases from the parsed spec, executes over CAN /
+  ISO-TP via python-can. Heuristic generator or formal `--ecu-formal`
+  state-machine explorer (all-transitions coverage). HTML / JUnit XML /
+  CSV / coverage reports.
+
+**Multi-ECU systems**
+
+- Declarative YAML config (`--system`) for redundant / gateway-with-forwarder
+  topologies, per-ECU spec + integration document, ARXML coverage-gap
+  routing inference, cross-ECU validator.
+
+**Browser UI** (`--serve`, `[web]` extra)
+
+- Local FastAPI server with five sidebar tabs:
+  - **Generate** — pick a BSW repository folder; the server uploads
+    UDS-relevant files (`.arxml`, `.c`, `.h`, `.yaml`, `.json`),
+    classifies each ARXML by AUTOSAR module, **auto-detects single vs
+    multi-ECU**, and generates the chosen format. `format=tex` ZIPs
+    include a compiled `spec.pdf` when `xelatex` is on PATH; otherwise
+    the UI flags the failure (and the ZIP carries a
+    `PDF_NOT_COMPILED.txt` with the underlying reason). Optional
+    **Compliance Matrix (Compliance Matrix)** CSV upload (ASPICE
+    SYS.2.BP4 / ISO 26262-8 §6.4.5 — DOORS-style) appends a per-row
+    compliance chapter with LaTeX `\cite{}` references; a
+    *Load sample bundle* button materialises a complete demo repo +
+    two Compliance Matrix CSVs server-side for a one-click pipeline preview.
+  - **Spec** — parsed SID / NRC / DID / RID / DTC tables shown
+    after a successful Parse & Preview.
+  - **Chat** — multi-turn LLM Q&A with streaming responses
+    (Anthropic Claude API / Ollama / OpenAI-compatible). Installed
+    Ollama / OpenAI models are auto-detected, and host RAM is read
+    server-side to recommend a model size class.
+  - **UDS Workbench** — interactive UDS request simulator (no
+    hardware required), CAN trace log analyzer (ASC / BLF), one-click
+    ODX / PDX export for CANalyzer & CANoe, and a collapsible
+    hardware-in-the-loop test runner for CAN / ISO-TP campaigns.
+  - **About** — version, links, feature list.
+
+**Tooling**
+
+- Interactive wizard (`-I`), config files (`--config`), file watching
+  (`--watch`), parallel parse, incremental cache, XSD validation,
+  pytest plugin (`uds_spec` fixture), LSP server, shell completion,
+  plugin system (`ParserPlugin` / `GeneratorPlugin`), i18n (en / de / ja
+  with bilingual `--lang ja+en` mode + multi-language `--langs en,ja,de`).
+
+**Distribution**
+
+- Docker image (TeX Live + `udsdoc[all]`).
+- GitHub Action (Marketplace-ready).
+- pre-commit hooks (validate / regen PDF / regen TeX ZIP).
+- VS Code extension (right-click `.arxml` → generate / validate / diff / LLM).
+
+---
+
+## Documentation
+
+- **Full feature reference & Python API**:
+  [`docs/README_full.md`](docs/README_full.md)
+- **Standards coverage matrices** (ISO ↔ AUTOSAR ECUC ↔ udsdoc,
+  with `file:line` source citations):
+  [`docs/standards/`](docs/standards/)
+  — ISO 15765-2 (CanTp), ISO 14229-2 (session/timing),
+  ISO 14229-1 (services, DTC/Dem), required-ARXMLs note.
+- **App + Boot ARXML split & CSV → ARXML hand-off**:
+  [`docs/app-boot-arxml.md`](docs/app-boot-arxml.md)
+- **Changelog**: [`CHANGELOG.md`](CHANGELOG.md)
+- **Contributing**: [`CONTRIBUTING.md`](CONTRIBUTING.md)
+
+---
+
+## Requirements
+
+- Python ≥ 3.9
+- `lxml` ≥ 4.9, `Jinja2` ≥ 3.1
+- LaTeX with `xelatex` (TeX Live / MiKTeX) for PDF output
+
+---
+
+## License
+
+MIT

udsdoc-0.66.0/README.md

@@ -0,0 +1,243 @@
+# udsdoc
+
+**AUTOSAR DCM/CanTp/DEM ARXML → ISO 14229 (UDS) / ISO 15765 / ISO 22901-1 (ODX/PDX) specification documents.**
+
+[![PyPI version](https://badge.fury.io/py/udsdoc.svg)](https://badge.fury.io/py/udsdoc)
+[![Python](https://img.shields.io/pypi/pyversions/udsdoc.svg)](https://pypi.org/project/udsdoc/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> **Renamed from `udsxml2tex` (v0.66.0).** The old PyPI package now installs
+> this one; the `udsxml2tex` CLI command, `UDSXML2TEX_*` environment
+> variables, `~/.udsxml2tex/` config directory and `udsxml2tex-*` pre-commit
+> hook ids keep working as deprecated aliases until v1.0.
+> Migration: `pip install udsdoc`, command `udsdoc`, `import udsdoc`.
+
+`udsdoc` parses AUTOSAR diagnostic ARXML (DCM, CanTp, DEM, DoIP, COM, AP)
+and renders a complete UDS specification in **LaTeX / PDF / HTML / Markdown
+/ RST / CSV / YAML / JSON / DOCX**, plus **ASAM ODX 2.2.0 / PDX**
+(ISO 22901-1) for industry diagnostic tooling.
+
+It also ships a local **browser UI** (`--serve`) that one-clicks an entire
+BSW software repository through the pipeline, auto-detecting single-ECU
+vs multi-ECU layouts.
+
+---
+
+## Install
+
+```bash
+pip install udsdoc                  # core (LaTeX / Markdown / JSON / YAML)
+pip install udsdoc[web]             # browser UI (--serve) + inline TikZ-UML SVG figures
+pip install udsdoc[llm]             # LLM analysis (Anthropic + OpenAI / Ollama)
+pip install udsdoc[ecu-test]        # CAN/ISO-TP hardware testing
+pip install udsdoc[all]             # everything
+```
+
+Other extras: `yaml`, `svg`, `watch`, `docx`, `lsp`, `progress`, `rich`, `viz`.
+
+A LaTeX distribution (TeX Live / MiKTeX with `xelatex` for CJK) is required
+to compile generated `.tex` to PDF. The HTML output renders standalone.
+TikZ-UML diagrams in the HTML output (SID 0x10 session FSM, SID 0x27
+SecurityAccess FSM and sequence) are compiled to inline SVG when `xelatex`
+plus a PDF→SVG tool are present — the `[web]` / `[svg]` extras pull in
+`pymupdf`, which provides an in-process PDF→SVG converter so no system
+binary (`pdftocairo` / `dvisvgm` / `pdf2svg` / `inkscape`) is required.
+Without the toolchain the HTML output silently falls back to Mermaid.
+
+---
+
+## Quick start
+
+```bash
+# Single ARXML → LaTeX
+udsdoc dcm.arxml -o spec.tex
+
+# Merge DCM + CanTp + DEM
+udsdoc dcm.arxml cantp.arxml --dem dem.arxml -o spec.tex
+
+# Auto-discover everything under a BSW repo (CLI mirror of the browser UI)
+udsdoc --repo /path/to/bsw-project -o spec.tex
+udsdoc --repo /path/to/bsw-project --repo-dry-run     # show classification
+
+# Application + Bootloader ARXMLs owned by separate teams — placed in
+# parallel subtrees (app/, boot/) under the repo root. The scanner
+# detects boot-domain files by path tokens (boot/, bootloader/, bl/,
+# fbl/, pbl/, sbl/, *_boot*, *_bl*) and merges them into ONE spec with
+# the Drive vs Boot domain tagged per session / service / DID / RID.
+udsdoc --repo /path/to/bsw-project -o spec.tex
+#   → "INFO: …merged bootloader spec (1 sessions, 1 dids, 1 routines)"
+
+# Hand-off helper: OEM team has only a requirement-analysis CSV (Compliance Matrix
+# format from `udsdoc --compliance-matrix-csv …`) and needs a Dcm ARXML skeleton
+# to give the external bootloader supplier as the contract. Generate one
+# without parsing any ARXML at all:
+udsdoc --gen-arxml-from-csv oem_boot_requirements.csv \
+           --gen-arxml-output   boot_skeleton.arxml \
+           --gen-arxml-ecu-name BootMcuA \
+           --gen-arxml-domain   boot          # boot|drive|both|all
+
+# Output formats
+udsdoc dcm.arxml --format html  -o spec.html
+udsdoc dcm.arxml --format md    -o spec.md
+udsdoc dcm.arxml --format pdx   -o ecu.pdx            # ISO 22901-1 PDX
+udsdoc dcm.arxml --pdf                                 # compile to PDF
+
+# Multi-language output:
+#   --lang en+ja+de   → ONE document with stacked translations (browser UI default)
+#   --langs en,ja,de  → one document per language (legacy multi-file mode)
+udsdoc dcm.arxml --lang en+ja+de  -o spec.tex
+udsdoc dcm.arxml --langs en,ja,de -o spec.md --format md
+
+# Validation, diff, multi-ECU systems
+udsdoc dcm.arxml --validate
+udsdoc new.arxml --diff old.arxml
+udsdoc --system system.yaml --system-output-dir out/   # 1+1 / gateway
+
+# Browser UI
+udsdoc --serve                                         # http://127.0.0.1:8765
+```
+
+### Python API
+
+```python
+from udsdoc import ArxmlParser, TexGenerator, validate, diff_specs
+
+spec = ArxmlParser().parse_multi(["dcm.arxml", "cantp.arxml"])
+TexGenerator().generate(spec, "spec.tex")
+TexGenerator().compile_pdf("spec.tex")
+
+print(validate(spec).summary())                # ISO 14229-1 consistency
+print(diff_specs(spec_a, spec_b).to_markdown())
+```
+
+---
+
+## Features
+
+**Coverage**
+
+- DCM (ISO 14229-1) — sessions, security, all 26 standard services, DIDs,
+  routines, DTCs, memory ranges, IO control / periodic / dynamic DIDs,
+  Authentication, ResponseOnEvent, LinkControl, multi-client.
+- CanTp (ISO 15765-2) — channels, BS/STmin, N_As/Bs/Cs/Ar/Br/Cr, addressing.
+- DEM (ISO 14229-1 §11) — DTC config, OBD/WWH-OBD, freeze frames, extended
+  data, operation cycles, indicators, combined DTCs.
+- DoIP (ISO 13400), Communication ARXML, Adaptive Platform service interfaces.
+- C/C++ source scanning — DID/RID global variables (transitive depth ≤3).
+- Bootloader overlay — single document covering Drive + Boot domains via YAML.
+
+**Output**
+
+- `tex` (Jinja2 + structured ZIP), `pdf` (xelatex/latexmk), `html` (multi-page
+  ZIP with offline Mermaid + NRC ladders), `md`, `rst`, `csv`, `yaml`,
+  `json`, `docx`, `odx`, `pdx`.
+- Visualizations: heatmaps, timing diagrams, UML sequences, byte-level
+  DID maps, session/security FSMs.
+
+**Requirements Compliance (ASPICE SYS.2.BP4 / ISO 26262-8 §6.4.5)**
+
+- `--compliance-matrix CSV [CSV ...]` + `--compliance-matrix-sources YAML` — append a Requirements
+  Compliance Matrix chapter to the LaTeX/PDF output that joins each
+  upstream requirement against the parsed ARXML (SID / DID / RID / DTC /
+  session / security level). Resolved coverage % is computed and shown;
+  unresolved rows are flagged with an asterisk.
+
+**Quality**
+
+- `--validate` — 17 ISO 14229-1 consistency checks.
+- `--diff` — semantic spec diff (ARXML or JSON).
+- `--iso-version {2006,2013,2020}` — drop features outside the chosen revision.
+- `--autosar-compat-report` — flag features postdating the detected AUTOSAR release.
+- Schema export: JSON Schema (draft-07), Pydantic v2 model source.
+
+**LLM analysis** (`[llm]` extra)
+
+- `--llm-summarize`, `--llm-query`, `--llm-nrc-descriptions`, `--llm-translate`.
+- Backends: Anthropic Claude API or any OpenAI-compatible server (Ollama,
+  llama.cpp, vLLM, OpenRouter, Azure). One-shot setup:
+  `udsdoc --bootstrap-ollama` (Linux/macOS).
+
+**ECU hardware testing** (`[ecu-test]` extra)
+
+- Auto-generates UDS test cases from the parsed spec, executes over CAN /
+  ISO-TP via python-can. Heuristic generator or formal `--ecu-formal`
+  state-machine explorer (all-transitions coverage). HTML / JUnit XML /
+  CSV / coverage reports.
+
+**Multi-ECU systems**
+
+- Declarative YAML config (`--system`) for redundant / gateway-with-forwarder
+  topologies, per-ECU spec + integration document, ARXML coverage-gap
+  routing inference, cross-ECU validator.
+
+**Browser UI** (`--serve`, `[web]` extra)
+
+- Local FastAPI server with five sidebar tabs:
+  - **Generate** — pick a BSW repository folder; the server uploads
+    UDS-relevant files (`.arxml`, `.c`, `.h`, `.yaml`, `.json`),
+    classifies each ARXML by AUTOSAR module, **auto-detects single vs
+    multi-ECU**, and generates the chosen format. `format=tex` ZIPs
+    include a compiled `spec.pdf` when `xelatex` is on PATH; otherwise
+    the UI flags the failure (and the ZIP carries a
+    `PDF_NOT_COMPILED.txt` with the underlying reason). Optional
+    **Compliance Matrix (Compliance Matrix)** CSV upload (ASPICE
+    SYS.2.BP4 / ISO 26262-8 §6.4.5 — DOORS-style) appends a per-row
+    compliance chapter with LaTeX `\cite{}` references; a
+    *Load sample bundle* button materialises a complete demo repo +
+    two Compliance Matrix CSVs server-side for a one-click pipeline preview.
+  - **Spec** — parsed SID / NRC / DID / RID / DTC tables shown
+    after a successful Parse & Preview.
+  - **Chat** — multi-turn LLM Q&A with streaming responses
+    (Anthropic Claude API / Ollama / OpenAI-compatible). Installed
+    Ollama / OpenAI models are auto-detected, and host RAM is read
+    server-side to recommend a model size class.
+  - **UDS Workbench** — interactive UDS request simulator (no
+    hardware required), CAN trace log analyzer (ASC / BLF), one-click
+    ODX / PDX export for CANalyzer & CANoe, and a collapsible
+    hardware-in-the-loop test runner for CAN / ISO-TP campaigns.
+  - **About** — version, links, feature list.
+
+**Tooling**
+
+- Interactive wizard (`-I`), config files (`--config`), file watching
+  (`--watch`), parallel parse, incremental cache, XSD validation,
+  pytest plugin (`uds_spec` fixture), LSP server, shell completion,
+  plugin system (`ParserPlugin` / `GeneratorPlugin`), i18n (en / de / ja
+  with bilingual `--lang ja+en` mode + multi-language `--langs en,ja,de`).
+
+**Distribution**
+
+- Docker image (TeX Live + `udsdoc[all]`).
+- GitHub Action (Marketplace-ready).
+- pre-commit hooks (validate / regen PDF / regen TeX ZIP).
+- VS Code extension (right-click `.arxml` → generate / validate / diff / LLM).
+
+---
+
+## Documentation
+
+- **Full feature reference & Python API**:
+  [`docs/README_full.md`](docs/README_full.md)
+- **Standards coverage matrices** (ISO ↔ AUTOSAR ECUC ↔ udsdoc,
+  with `file:line` source citations):
+  [`docs/standards/`](docs/standards/)
+  — ISO 15765-2 (CanTp), ISO 14229-2 (session/timing),
+  ISO 14229-1 (services, DTC/Dem), required-ARXMLs note.
+- **App + Boot ARXML split & CSV → ARXML hand-off**:
+  [`docs/app-boot-arxml.md`](docs/app-boot-arxml.md)
+- **Changelog**: [`CHANGELOG.md`](CHANGELOG.md)
+- **Contributing**: [`CONTRIBUTING.md`](CONTRIBUTING.md)
+
+---
+
+## Requirements
+
+- Python ≥ 3.9
+- `lxml` ≥ 4.9, `Jinja2` ≥ 3.1
+- LaTeX with `xelatex` (TeX Live / MiKTeX) for PDF output
+
+---
+
+## License
+
+MIT