archi-cli 0.2.2__tar.gz → 0.3.0__tar.gz

archi_cli-0.3.0/.gitignore

@@ -0,0 +1,19 @@
+# Archi-backups en afgeleide artefacten
+*.bak
+output/
+*.xml
+*.svg
+*.png
+# behalve de schermafbeeldingen voor de README
+!docs/img/*.png
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+.pytest_cache/
+.ruff_cache/
+dist/
+
+# macOS
+.DS_Store

archi_cli-0.3.0/NOTICE

@@ -0,0 +1,24 @@
+archi-cli
+Copyright (c) 2026 Nederlandse Digitale Dienst
+Licensed under the EUPL-1.2 (see LICENSE).
+
+This tool downloads and drives the Archi engine for its `normalize` command.
+Archi is a separate work and is not distributed as part of this package; it is
+fetched at runtime from the official release on first use.
+
+  Archi, the ArchiMate modelling tool
+  Copyright (c) Phillip Beauvoir, Jean-Baptiste Sarrodie and contributors
+  Licensed under the MIT License
+  https://github.com/archimatetool/archi
+
+The Archi distribution bundles an OpenJDK runtime; its own licensing applies to
+that runtime.
+
+The HTML views and slide decks load the NLDD Design System
+(@nldd/design-system) from a CDN at view time. Its fonts (RijksSans) are
+intended for publications by and on behalf of the Dutch central government;
+see the design system's NOTICES.md for the conditions.
+
+ArchiMate is a registered trademark of The Open Group. archi-cli is an
+independent project and is not affiliated with or endorsed by The Open Group
+or the Archi project.

archi_cli-0.3.0/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.5
+Name: archi-cli
+Version: 0.3.0
+Summary: Deterministische command line tool om native Archi-modellen (.archimate) te inspecteren, muteren, valideren en renderen
+Project-URL: Homepage, https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting
+Project-URL: Repository, https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting
+Project-URL: Issues, https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/issues
+Project-URL: Changelog, https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/CHANGELOG.md
+Author: Nederlandse Digitale Dienst
+License-Expression: EUPL-1.2
+License-File: LICENSE
+Keywords: archi,archimate,architecture-as-code,cli,enterprise-architecture,modeling
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Natural Language :: Dutch
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.12
+Requires-Dist: lxml>=6.1.3
+Requires-Dist: typer>=0.26
+Description-Content-Type: text/markdown
+
+# archi-cli
+
+[![checks](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/actions/workflows/ci.yml/badge.svg)](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/archi-cli.svg)](https://pypi.org/project/archi-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/archi-cli.svg)](https://pypi.org/project/archi-cli/)
+[![licentie: EUPL-1.2](https://img.shields.io/badge/licentie-EUPL--1.2-blue.svg)](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/LICENSE)
+
+Houd je ArchiMate-model bij zoals code. `archi-cli` is een command line tool
+voor native [Archi](https://www.archimatetool.com/)-modellen: je bekijkt,
+wijzigt en controleert een `.archimate`-bestand vanuit de terminal, en
+genereert er views, webpagina's en presentaties uit. Elke wijziging wordt
+gevalideerd voordat hij wordt opgeslagen, zodat het model nooit kapot raakt.
+Dat maakt de tool geschikt om samen met een AI-assistent aan een model te
+werken, met git als geheugen.
+
+![Een gegenereerde presentatie die inzoomt op één capability](https://raw.githubusercontent.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/main/docs/img/slide-focus.png)
+
+*Een slide uit het meegeleverde voorbeeld: de camera zoomt in op één
+element en dimt de rest. Gegenereerd uit het model, zonder handwerk.*
+
+## Wat het is, en wat niet
+
+**Wel:**
+
+- Een **command line tool** die het native Archi-formaat leest en schrijft. Het
+  bestand blijft gewoon te openen en te bewerken in Archi.
+- Een **vangnet**. Elke mutatie wordt eerst in het geheugen gevalideerd; bij een
+  fout weigert de tool op te slaan. Ids blijven onveranderd.
+- **Deterministisch.** Dezelfde invoer geeft dezelfde uitvoer, zodat diffs klein
+  blijven en je de uitvoer in CI kunt controleren.
+- Een set **skills voor Claude Code** die beschrijven hoe een AI-assistent via
+  deze tool aan een model werkt.
+
+**Niet:**
+
+- **Geen vervanging van Archi.** Vrij modelleren op het canvas en de layout van
+  een view fijnslijpen doe je in Archi. De tool en Archi werken op hetzelfde
+  bestand en vullen elkaar aan.
+- **Geen ArchiMate-validator.** `archi validate` controleert de integriteit van
+  het bestand en je eigen conventies, niet of een relatie volgens de
+  ArchiMate-specificatie is toegestaan.
+- **Geen AI.** De tool zelf bevat geen AI en stuurt je model nergens heen. Alleen
+  het eenmalig ophalen van de Archi-engine gebruikt het netwerk.
+- **Geen officieel product of standaard.** Het is open source software in de
+  bètafase, zonder garanties of ondersteuningsafspraken.
+
+## Snel aan de slag
+
+Je hebt [uv](https://docs.astral.sh/uv/) nodig; uv regelt zelf een passende
+Python (3.12 of nieuwer).
+
+```bash
+uv tool install archi-cli
+archi --version
+```
+
+Probeer het op het meegeleverde voorbeeld, een fictief model van een gemeente
+die vergunningen verleent:
+
+```bash
+git clone https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting.git
+cd ai-assisted-architecting/examples/vergunningverlening
+archi stats                          # wat zit er in het model
+archi show "Toetsen aan regels"      # één element met zijn relaties
+archi render                         # views en slides naar views/
+```
+
+Open daarna `views/html/index.html` in je browser. De Mermaid-versies van de
+views staan [hier op GitHub](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/examples/vergunningverlening/views/README.md) al
+gerenderd.
+
+Voor je eigen model: draai `archi` in de map met je `.archimate`-bestand, of
+leg het vast in een `archi.toml` (zie [Configuratie](#configuratie)).
+
+## Wat je ermee kunt
+
+| Taak | Commando's |
+| --- | --- |
+| Inspecteren | `stats`, `list`, `show`, `tree` |
+| Wijzigen | `add-element`, `add-relation`, `set-property`, `remove-property`, `set-documentation`, `rename`, `move`, `remove`, `set-model-name` |
+| Views genereren | `add-view` met grid- of clusterlayout, geselecteerd op type, property, relatie of vanuit één element |
+| Controleren | `validate` |
+| Normaliseren | `normalize` |
+| Publiceren | `render` (views) en `slides` (presentaties) |
+
+`archi <commando> --help` toont alle opties. Een paar voorbeelden:
+
+```bash
+archi add-element --type Capability --name "Toezicht" --documentation "Naleving controleren."
+archi add-relation --type Aggregation --source "Vergunningverlening" --target "Toezicht"
+archi move "Toezicht" --subfolder "Gebied handhaving" --create-subfolder
+archi add-view --name "Capabilities" --layout cluster --type Capability
+archi remove "Toezicht" --cascade      # ook relaties en view-objecten
+```
+
+**Controleren.** `archi validate` vindt onder meer dubbele ids, relaties naar
+elementen die niet bestaan, elementen in de verkeerde laagmap, kapotte views en
+property-keys die niet in je conventielijst staan. Mutaties draaien dezelfde
+controles automatisch.
+
+**Normaliseren.** `archi normalize` laat Archi zelf het bestand opnieuw wegschrijven,
+in zijn eigen canonieke vorm. Zo blijven git-diffs klein, of een wijziging nu
+uit de tool of uit Archi komt. De Archi-engine haalt de tool bij het eerste
+gebruik zelf op en controleert de download.
+
+**Publiceren.** `archi render` zet elke view om naar Mermaid (dat GitHub direct
+toont) en naar een webpagina met de layout en de ArchiMate-notatie uit het
+model, gestileerd met het [NLDD Design System](https://github.com/NederlandseDigitaleDienst/design-system).
+Een indexpagina toont alle views met een miniatuur.
+
+![Een gegenereerde view met de layout uit het model](https://raw.githubusercontent.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/main/docs/img/view-dienst-platform.png)
+
+**Presenteren.** Een deck in `decks/*.toml` beschrijft een lineair verhaal met
+views uit het model, afgewisseld met tekst. `archi slides` maakt er een
+zelfstandige HTML-presentatie van, met zoom-op-een-element, sprekersnotities en
+volledig scherm. Zie [het voorbeelddeck](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/examples/vergunningverlening/decks/rondleiding.toml).
+
+**Doorklikken.** Met een links-bestand worden elementen in de webpagina's
+klikbaar naar een andere view of een ander bestand, bijvoorbeeld een diagram
+dat je met eigen scripts maakt. Zie [ADR 0010](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/adr/0010-doorklikken-via-links-bestand.md).
+
+![De indexpagina met alle views](https://raw.githubusercontent.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/main/docs/img/views-index.png)
+
+## Configuratie
+
+De tool zoekt het model in deze volgorde: de optie `--model <pad>` (vóór het
+subcommando), de sleutel `model` in een `archi.toml` (in de werkmap of een map
+erboven), of het enige `.archimate`-bestand in de werkmap.
+
+```toml
+# archi.toml
+[tool.archi]
+model = "model/architectuur.archimate"
+conventions = "docs/conventies.md"   # toegestane property-keys
+links = "links.toml"                 # doorkliks in de webpagina's
+fonts = "system"                     # of "rijkssans", zie hieronder
+```
+
+Alle sleutels zijn optioneel. Dezelfde tabel mag ook in een `pyproject.toml`.
+
+**Lettertype.** De webpagina's gebruiken standaard het systeemlettertype.
+RijksSans is uitsluitend bedoeld voor publicaties van de Rijksoverheid en
+partijen die in haar opdracht werken; valt jouw publicatie daaronder, zet dan
+`fonts = "rijkssans"`.
+
+## Werken met een AI-assistent
+
+De skills `archi-model`, `archi-view` en `archi-slides` leren een AI-assistent
+hoe hij via deze tool aan een model werkt: welke commando's, in welke
+volgorde, en wanneer hij moet valideren en normaliseren. Installeer ze in
+Claude Code als plugin:
+
+```
+/plugin marketplace add BureauArchitectuurDigitaleOverheid/ai-assisted-architecting
+/plugin install archi-tools@archi-marketplace
+```
+
+De plugin brengt alleen de skills mee; het commando `archi` installeer je met
+uv, zoals hierboven. De tool garandeert dat het model technisch klopt, niet dat
+de architectuur klopt. Lees wijzigingen van een assistent na zoals je een pull
+request van een collega naleest.
+
+## Grenzen en bekende beperkingen
+
+- **Alleen het native Archi-formaat** (`.archimate`). Het Open Group
+  Exchange-formaat wordt niet gelezen of geschreven.
+- **`normalize` heeft de Archi-engine nodig** (ongeveer 165 MB, eenmalig).
+  Archi levert die voor macOS (Intel en Apple Silicon) en voor 64-bit x86 op
+  Linux en Windows. Op andere platforms installeer je Archi zelf en wijs je hem
+  aan met de omgevingsvariabele `ARCHI_APP`. Alle andere commando's werken
+  zonder Archi.
+- **Automatische layout is een startpunt.** `add-view` plaatst elementen in een
+  raster of in clusters; bij grotere views schuif je in Archi nog wat bij.
+- **Niet alles wordt gerenderd.** Sketch- en canvasviews, afbeeldingen en eigen
+  kleuren en lettertypes uit Archi komen niet in de webpagina's.
+- **De webpagina's laden het design system van een CDN** en hebben dus internet
+  nodig om goed te tonen.
+- **Uitvoer en meldingen zijn Nederlandstalig.**
+
+## Disclaimer
+
+Deze software wordt geleverd zoals hij is, zonder enige garantie; zie de
+artikelen 7 en 8 van de [EUPL-1.2](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/LICENSE). De tool is in bètafase: tot versie
+1.0 kunnen commando's en uitvoer nog veranderen. Elke wijziging die je moet
+weten staat in de [changelog](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/CHANGELOG.md).
+
+ArchiMate is een geregistreerd handelsmerk van The Open Group. Dit project is
+onafhankelijk en niet verbonden aan The Open Group of het Archi-project.
+
+## Meedoen
+
+Bijdragen zijn welkom: lees [CONTRIBUTING.md](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/CONTRIBUTING.md) voor de
+werkwijze en de [gedragscode](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/CODE_OF_CONDUCT.md). Een beveiligingsprobleem meld
+je volgens [SECURITY.md](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/SECURITY.md), niet in een openbaar issue.
+Beslissingen over de opzet van de tool staan als ADR's in [`adr/`](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/tree/main/adr/).
+
+## Licentie
+
+[EUPL-1.2](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/LICENSE). Ontwikkeld door de Nederlandse Digitale Dienst. Archi
+zelf valt onder de MIT-licentie; zie [NOTICE](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/NOTICE).

archi_cli-0.3.0/README.md

@@ -0,0 +1,200 @@
+# archi-cli
+
+[![checks](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/actions/workflows/ci.yml/badge.svg)](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/archi-cli.svg)](https://pypi.org/project/archi-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/archi-cli.svg)](https://pypi.org/project/archi-cli/)
+[![licentie: EUPL-1.2](https://img.shields.io/badge/licentie-EUPL--1.2-blue.svg)](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/LICENSE)
+
+Houd je ArchiMate-model bij zoals code. `archi-cli` is een command line tool
+voor native [Archi](https://www.archimatetool.com/)-modellen: je bekijkt,
+wijzigt en controleert een `.archimate`-bestand vanuit de terminal, en
+genereert er views, webpagina's en presentaties uit. Elke wijziging wordt
+gevalideerd voordat hij wordt opgeslagen, zodat het model nooit kapot raakt.
+Dat maakt de tool geschikt om samen met een AI-assistent aan een model te
+werken, met git als geheugen.
+
+![Een gegenereerde presentatie die inzoomt op één capability](https://raw.githubusercontent.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/main/docs/img/slide-focus.png)
+
+*Een slide uit het meegeleverde voorbeeld: de camera zoomt in op één
+element en dimt de rest. Gegenereerd uit het model, zonder handwerk.*
+
+## Wat het is, en wat niet
+
+**Wel:**
+
+- Een **command line tool** die het native Archi-formaat leest en schrijft. Het
+  bestand blijft gewoon te openen en te bewerken in Archi.
+- Een **vangnet**. Elke mutatie wordt eerst in het geheugen gevalideerd; bij een
+  fout weigert de tool op te slaan. Ids blijven onveranderd.
+- **Deterministisch.** Dezelfde invoer geeft dezelfde uitvoer, zodat diffs klein
+  blijven en je de uitvoer in CI kunt controleren.
+- Een set **skills voor Claude Code** die beschrijven hoe een AI-assistent via
+  deze tool aan een model werkt.
+
+**Niet:**
+
+- **Geen vervanging van Archi.** Vrij modelleren op het canvas en de layout van
+  een view fijnslijpen doe je in Archi. De tool en Archi werken op hetzelfde
+  bestand en vullen elkaar aan.
+- **Geen ArchiMate-validator.** `archi validate` controleert de integriteit van
+  het bestand en je eigen conventies, niet of een relatie volgens de
+  ArchiMate-specificatie is toegestaan.
+- **Geen AI.** De tool zelf bevat geen AI en stuurt je model nergens heen. Alleen
+  het eenmalig ophalen van de Archi-engine gebruikt het netwerk.
+- **Geen officieel product of standaard.** Het is open source software in de
+  bètafase, zonder garanties of ondersteuningsafspraken.
+
+## Snel aan de slag
+
+Je hebt [uv](https://docs.astral.sh/uv/) nodig; uv regelt zelf een passende
+Python (3.12 of nieuwer).
+
+```bash
+uv tool install archi-cli
+archi --version
+```
+
+Probeer het op het meegeleverde voorbeeld, een fictief model van een gemeente
+die vergunningen verleent:
+
+```bash
+git clone https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting.git
+cd ai-assisted-architecting/examples/vergunningverlening
+archi stats                          # wat zit er in het model
+archi show "Toetsen aan regels"      # één element met zijn relaties
+archi render                         # views en slides naar views/
+```
+
+Open daarna `views/html/index.html` in je browser. De Mermaid-versies van de
+views staan [hier op GitHub](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/examples/vergunningverlening/views/README.md) al
+gerenderd.
+
+Voor je eigen model: draai `archi` in de map met je `.archimate`-bestand, of
+leg het vast in een `archi.toml` (zie [Configuratie](#configuratie)).
+
+## Wat je ermee kunt
+
+| Taak | Commando's |
+| --- | --- |
+| Inspecteren | `stats`, `list`, `show`, `tree` |
+| Wijzigen | `add-element`, `add-relation`, `set-property`, `remove-property`, `set-documentation`, `rename`, `move`, `remove`, `set-model-name` |
+| Views genereren | `add-view` met grid- of clusterlayout, geselecteerd op type, property, relatie of vanuit één element |
+| Controleren | `validate` |
+| Normaliseren | `normalize` |
+| Publiceren | `render` (views) en `slides` (presentaties) |
+
+`archi <commando> --help` toont alle opties. Een paar voorbeelden:
+
+```bash
+archi add-element --type Capability --name "Toezicht" --documentation "Naleving controleren."
+archi add-relation --type Aggregation --source "Vergunningverlening" --target "Toezicht"
+archi move "Toezicht" --subfolder "Gebied handhaving" --create-subfolder
+archi add-view --name "Capabilities" --layout cluster --type Capability
+archi remove "Toezicht" --cascade      # ook relaties en view-objecten
+```
+
+**Controleren.** `archi validate` vindt onder meer dubbele ids, relaties naar
+elementen die niet bestaan, elementen in de verkeerde laagmap, kapotte views en
+property-keys die niet in je conventielijst staan. Mutaties draaien dezelfde
+controles automatisch.
+
+**Normaliseren.** `archi normalize` laat Archi zelf het bestand opnieuw wegschrijven,
+in zijn eigen canonieke vorm. Zo blijven git-diffs klein, of een wijziging nu
+uit de tool of uit Archi komt. De Archi-engine haalt de tool bij het eerste
+gebruik zelf op en controleert de download.
+
+**Publiceren.** `archi render` zet elke view om naar Mermaid (dat GitHub direct
+toont) en naar een webpagina met de layout en de ArchiMate-notatie uit het
+model, gestileerd met het [NLDD Design System](https://github.com/NederlandseDigitaleDienst/design-system).
+Een indexpagina toont alle views met een miniatuur.
+
+![Een gegenereerde view met de layout uit het model](https://raw.githubusercontent.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/main/docs/img/view-dienst-platform.png)
+
+**Presenteren.** Een deck in `decks/*.toml` beschrijft een lineair verhaal met
+views uit het model, afgewisseld met tekst. `archi slides` maakt er een
+zelfstandige HTML-presentatie van, met zoom-op-een-element, sprekersnotities en
+volledig scherm. Zie [het voorbeelddeck](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/examples/vergunningverlening/decks/rondleiding.toml).
+
+**Doorklikken.** Met een links-bestand worden elementen in de webpagina's
+klikbaar naar een andere view of een ander bestand, bijvoorbeeld een diagram
+dat je met eigen scripts maakt. Zie [ADR 0010](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/adr/0010-doorklikken-via-links-bestand.md).
+
+![De indexpagina met alle views](https://raw.githubusercontent.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/main/docs/img/views-index.png)
+
+## Configuratie
+
+De tool zoekt het model in deze volgorde: de optie `--model <pad>` (vóór het
+subcommando), de sleutel `model` in een `archi.toml` (in de werkmap of een map
+erboven), of het enige `.archimate`-bestand in de werkmap.
+
+```toml
+# archi.toml
+[tool.archi]
+model = "model/architectuur.archimate"
+conventions = "docs/conventies.md"   # toegestane property-keys
+links = "links.toml"                 # doorkliks in de webpagina's
+fonts = "system"                     # of "rijkssans", zie hieronder
+```
+
+Alle sleutels zijn optioneel. Dezelfde tabel mag ook in een `pyproject.toml`.
+
+**Lettertype.** De webpagina's gebruiken standaard het systeemlettertype.
+RijksSans is uitsluitend bedoeld voor publicaties van de Rijksoverheid en
+partijen die in haar opdracht werken; valt jouw publicatie daaronder, zet dan
+`fonts = "rijkssans"`.
+
+## Werken met een AI-assistent
+
+De skills `archi-model`, `archi-view` en `archi-slides` leren een AI-assistent
+hoe hij via deze tool aan een model werkt: welke commando's, in welke
+volgorde, en wanneer hij moet valideren en normaliseren. Installeer ze in
+Claude Code als plugin:
+
+```
+/plugin marketplace add BureauArchitectuurDigitaleOverheid/ai-assisted-architecting
+/plugin install archi-tools@archi-marketplace
+```
+
+De plugin brengt alleen de skills mee; het commando `archi` installeer je met
+uv, zoals hierboven. De tool garandeert dat het model technisch klopt, niet dat
+de architectuur klopt. Lees wijzigingen van een assistent na zoals je een pull
+request van een collega naleest.
+
+## Grenzen en bekende beperkingen
+
+- **Alleen het native Archi-formaat** (`.archimate`). Het Open Group
+  Exchange-formaat wordt niet gelezen of geschreven.
+- **`normalize` heeft de Archi-engine nodig** (ongeveer 165 MB, eenmalig).
+  Archi levert die voor macOS (Intel en Apple Silicon) en voor 64-bit x86 op
+  Linux en Windows. Op andere platforms installeer je Archi zelf en wijs je hem
+  aan met de omgevingsvariabele `ARCHI_APP`. Alle andere commando's werken
+  zonder Archi.
+- **Automatische layout is een startpunt.** `add-view` plaatst elementen in een
+  raster of in clusters; bij grotere views schuif je in Archi nog wat bij.
+- **Niet alles wordt gerenderd.** Sketch- en canvasviews, afbeeldingen en eigen
+  kleuren en lettertypes uit Archi komen niet in de webpagina's.
+- **De webpagina's laden het design system van een CDN** en hebben dus internet
+  nodig om goed te tonen.
+- **Uitvoer en meldingen zijn Nederlandstalig.**
+
+## Disclaimer
+
+Deze software wordt geleverd zoals hij is, zonder enige garantie; zie de
+artikelen 7 en 8 van de [EUPL-1.2](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/LICENSE). De tool is in bètafase: tot versie
+1.0 kunnen commando's en uitvoer nog veranderen. Elke wijziging die je moet
+weten staat in de [changelog](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/CHANGELOG.md).
+
+ArchiMate is een geregistreerd handelsmerk van The Open Group. Dit project is
+onafhankelijk en niet verbonden aan The Open Group of het Archi-project.
+
+## Meedoen
+
+Bijdragen zijn welkom: lees [CONTRIBUTING.md](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/CONTRIBUTING.md) voor de
+werkwijze en de [gedragscode](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/CODE_OF_CONDUCT.md). Een beveiligingsprobleem meld
+je volgens [SECURITY.md](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/SECURITY.md), niet in een openbaar issue.
+Beslissingen over de opzet van de tool staan als ADR's in [`adr/`](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/tree/main/adr/).
+
+## Licentie
+
+[EUPL-1.2](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/LICENSE). Ontwikkeld door de Nederlandse Digitale Dienst. Archi
+zelf valt onder de MIT-licentie; zie [NOTICE](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/NOTICE).

{archi_cli-0.2.2 → archi_cli-0.3.0}/pyproject.toml

@@ -1,22 +1,27 @@
 [project]
 name = "archi-cli"
-version = "0.2.2"
-description = "ar·cli·mate — de CLI in je ArchiMate: deterministisch native .archimate-modellen inspecteren, muteren, valideren en renderen"
+version = "0.3.0"
+description = "Deterministische command line tool om native Archi-modellen (.archimate) te inspecteren, muteren, valideren en renderen"
 readme = "README.md"
 license = "EUPL-1.2"
 license-files = ["LICENSE"]
 requires-python = ">=3.12"
 authors = [
-    { name = "Bureau Architectuur Digitale Overheid" },
+    { name = "Nederlandse Digitale Dienst" },
 ]
-keywords = ["archimate", "archi", "enterprise-architecture", "cli", "modeling"]
+keywords = ["archimate", "archi", "enterprise-architecture", "cli", "modeling", "architecture-as-code"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Environment :: Console",
     "Intended Audience :: Developers",
-    "Topic :: Software Development :: Documentation",
+    "Intended Audience :: Information Technology",
+    "Natural Language :: Dutch",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Documentation",
 ]
 # lxml 6.1.3 stops resolving external parameter entities by default
 dependencies = ["lxml>=6.1.3", "typer>=0.26"]
@@ -25,6 +30,7 @@ dependencies = ["lxml>=6.1.3", "typer>=0.26"]
 Homepage = "https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting"
 Repository = "https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting"
 Issues = "https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/issues"
+Changelog = "https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/CHANGELOG.md"
 
 [project.scripts]
 archi = "archi_tool.cli:main"

{archi_cli-0.2.2 → archi_cli-0.3.0}/tools/archi_tool/cli.py

@@ -10,6 +10,8 @@ from __future__ import annotations
 
 import sys
 from collections import Counter
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as package_version
 from pathlib import Path
 from types import SimpleNamespace
 from typing import Optional
@@ -17,7 +19,12 @@ from typing import Optional
 import typer
 from lxml import etree
 
-from .discovery import discover_conventions, discover_links, discover_model
+from .discovery import (
+    discover_conventions,
+    discover_fonts,
+    discover_links,
+    discover_model,
+)
 from .links import check_link_files, load_links
 from .model import ArchiModel, ModelError, is_element, xsi_type
 from .normalize import normalize
@@ -299,11 +306,14 @@ def cmd_setup(model, args):
 
 def cmd_render(model, args):
     links = load_links(discover_links(args.model))
+    fonts = discover_fonts(args.model)
     written, removed = render_all(model, args.out)
     html_dir = Path(args.out) / "html"
-    html_written, html_removed = render_all_html(model, html_dir, links=links)
+    html_written, html_removed = render_all_html(
+        model, html_dir, links=links, fonts=fonts
+    )
     deck_written, deck_removed = render_all_slides(
-        model, Path(args.decks), html_dir / "slides", links=links
+        model, Path(args.decks), html_dir / "slides", links=links, fonts=fonts
     )
     for path in written + html_written + deck_written:
         print(f"Geschreven: {path}")
@@ -328,18 +338,21 @@ def cmd_render(model, args):
 
 def cmd_slides(model, args):
     links = load_links(discover_links(args.model))
+    fonts = discover_fonts(args.model)
     if args.deck:
         written = []
         for deck_path in args.deck:
             deck = load_deck(Path(deck_path), model)
             path = Path(args.out) / f"{deck['slug']}.html"
             path.parent.mkdir(parents=True, exist_ok=True)
-            if write_if_changed(path, render_deck_html(model, deck, links=links)):
+            if write_if_changed(
+                path, render_deck_html(model, deck, links=links, fonts=fonts)
+            ):
                 written.append(path)
         removed = []
     else:
         written, removed = render_all_slides(
-            model, Path(args.decks), Path(args.out), links=links
+            model, Path(args.decks), Path(args.out), links=links, fonts=fonts
         )
     for path in written:
         print(f"Geschreven: {path}")
@@ -382,8 +395,27 @@ ModelOption = typer.Option(
 )
 
 
+def _show_version(value: bool) -> None:
+    if not value:
+        return
+    try:
+        typer.echo(f"archi-cli {package_version('archi-cli')}")
+    except PackageNotFoundError:  # running from a source tree without install
+        typer.echo("archi-cli (onbekende versie)")
+    raise typer.Exit()
+
+
 @app.callback()
-def _main(model: Optional[str] = ModelOption):
+def _main(
+    model: Optional[str] = ModelOption,
+    version: bool = typer.Option(
+        False,
+        "--version",
+        callback=_show_version,
+        is_eager=True,
+        help="versie tonen en stoppen",
+    ),
+):
     _state.model = model
 
 

{archi_cli-0.2.2 → archi_cli-0.3.0}/tools/archi_tool/discovery.py

@@ -115,6 +115,25 @@ def discover_links(model_path, start=None):
     return path
 
 
+FONT_CHOICES = ("system", "rijkssans")
+
+
+def discover_fonts(model_path, start=None) -> str:
+    """The font choice for rendered HTML: ``[tool.archi] fonts``, default
+    "system". "rijkssans" is reserved for the Dutch central government and
+    parties working on its behalf (see NOTICE)."""
+    start = Path(start or Path(model_path).resolve().parent)
+    table, config_path = _read_archi_config(start)
+    fonts = table.get("fonts", "system")
+    if fonts not in FONT_CHOICES:
+        allowed = ", ".join(f'"{c}"' for c in FONT_CHOICES)
+        raise ModelError(
+            f"Ongeldige waarde voor fonts in {config_path.name}: {fonts!r}. "
+            f"Kies uit {allowed}."
+        )
+    return fonts
+
+
 def discover_conventions(model_path, start=None):
     """Return (allowed_property_keys, source_label).
 

{archi_cli-0.2.2 → archi_cli-0.3.0}/tools/archi_tool/render_html.py

@@ -26,11 +26,16 @@ from .render import (
     write_if_changed,
 )
 
-NLDD_VERSION = "0.8.64"
-NLDD_CSS = (
-    f"https://cdn.jsdelivr.net/npm/@nldd/design-system@{NLDD_VERSION}"
-    "/dist/css/global.css"
-)
+NLDD_VERSION = "0.8.93"
+_NLDD_DIST = f"https://cdn.jsdelivr.net/npm/@nldd/design-system@{NLDD_VERSION}/dist/css"
+# RijksSans is meant for publications by and on behalf of the Dutch central
+# government only, so the default stylesheet leaves it out and falls back to
+# the system font; `[tool.archi] fonts = "rijkssans"` opts in.
+NLDD_STYLESHEETS = {
+    "system": f"{_NLDD_DIST}/global-system-font.css",
+    "rijkssans": f"{_NLDD_DIST}/global.css",
+}
+DEFAULT_FONTS = "system"
 NLDD_JS = f"https://cdn.jsdelivr.net/npm/@nldd/design-system@{NLDD_VERSION}/+esm"
 
 CANVAS_MARGIN = 40
@@ -514,7 +519,7 @@ PAGE_CSS = (
 )
 
 
-def page_shell(title: str, body: str) -> str:
+def page_shell(title: str, body: str, fonts: str = DEFAULT_FONTS) -> str:
     return f"""{MARKER}
 <!doctype html>
 <html lang="nl">
@@ -523,7 +528,7 @@ def page_shell(title: str, body: str) -> str:
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>{html.escape(title)}</title>
 <link rel="icon" href="{FAVICON}">
-<link rel="stylesheet" href="{NLDD_CSS}">
+<link rel="stylesheet" href="{NLDD_STYLESHEETS[fonts]}">
 <script type="module">import "{NLDD_JS}";</script>
 <style>
 {layer_css()}
@@ -662,7 +667,9 @@ def diagram_canvas(
     }
 
 
-def render_view_html(model, diagram, links: dict | None = None) -> str:
+def render_view_html(
+    model, diagram, links: dict | None = None, fonts: str = DEFAULT_FONTS
+) -> str:
     canvas = diagram_canvas(model, diagram, links=links)
     name = diagram.get("name") or "(naamloze view)"
     documentation = model.documentation(diagram)
@@ -692,10 +699,10 @@ def render_view_html(model, diagram, links: dict | None = None) -> str:
         f"getekende verbindingen · gegenereerd uit "
         f"<code>{html.escape(display_model_path(model))}</code></p>"
     )
-    return page_shell(name, body)
+    return page_shell(name, body, fonts)
 
 
-def render_index_html(model, entries) -> str:
+def render_index_html(model, entries, fonts: str = DEFAULT_FONTS) -> str:
     cards = []
     for name, filename, n_boxes, n_edges, thumbnail in entries:
         cards.append(
@@ -721,10 +728,12 @@ def render_index_html(model, entries) -> str:
         + "\n"
         "      </nldd-collection>"
     )
-    return page_shell(f"{model.name} · views", body)
+    return page_shell(f"{model.name} · views", body, fonts)
 
 
-def render_all_html(model, out_dir, links: dict | None = None) -> tuple[list, list]:
+def render_all_html(
+    model, out_dir, links: dict | None = None, fonts: str = DEFAULT_FONTS
+) -> tuple[list, list]:
     """Render every view to HTML; returns (written, removed) path lists.
 
     links is the parsed links file ({source: {element name: target}}); a view
@@ -740,7 +749,9 @@ def render_all_html(model, out_dir, links: dict | None = None) -> tuple[list, li
         filename = stems[diagram.get("id")] + ".html"
         path = out / filename
         view_links = links_for(links or {}, stems[diagram.get("id")])
-        if write_if_changed(path, render_view_html(model, diagram, links=view_links)):
+        if write_if_changed(
+            path, render_view_html(model, diagram, links=view_links, fonts=fonts)
+        ):
             written.append(path)
         produced.add(path.name)
         boxes = absolute_boxes(diagram, index)
@@ -750,7 +761,7 @@ def render_all_html(model, out_dir, links: dict | None = None) -> tuple[list, li
         )
 
     index_path = out / "index.html"
-    if write_if_changed(index_path, render_index_html(model, entries)):
+    if write_if_changed(index_path, render_index_html(model, entries, fonts)):
         written.append(index_path)
     produced.add(index_path.name)
 

{archi_cli-0.2.2 → archi_cli-0.3.0}/tools/archi_tool/render_slides.py

@@ -22,9 +22,10 @@ from .links import links_for
 from .model import ModelError
 from .render import MARKER, is_descendant, slugify, view_stems, write_if_changed
 from .render_html import (
+    DEFAULT_FONTS,
     DIAGRAM_CSS,
     FAVICON,
-    NLDD_CSS,
+    NLDD_STYLESHEETS,
     absolute_boxes,
     diagram_canvas,
     layer_css,
@@ -639,7 +640,9 @@ def render_slide_html(
     )
 
 
-def render_deck_html(model, deck: dict, links: dict | None = None) -> str:
+def render_deck_html(
+    model, deck: dict, links: dict | None = None, fonts: str = DEFAULT_FONTS
+) -> str:
     """One self-contained HTML document for a validated deck. links is the
     parsed links file; embedded views pick up their own section."""
     total = len(deck["slides"])
@@ -655,7 +658,7 @@ def render_deck_html(model, deck: dict, links: dict | None = None) -> str:
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>{html.escape(deck["title"])}</title>
 <link rel="icon" href="{FAVICON}">
-<link rel="stylesheet" href="{NLDD_CSS}">
+<link rel="stylesheet" href="{NLDD_STYLESHEETS[fonts]}">
 <style>
 {layer_css()}
 {DIAGRAM_CSS}{DECK_CSS}</style>
@@ -682,7 +685,7 @@ n notities &middot; a autoplay</div>
 
 
 def render_all_slides(
-    model, decks_dir, out_dir, links: dict | None = None
+    model, decks_dir, out_dir, links: dict | None = None, fonts: str = DEFAULT_FONTS
 ) -> tuple[list, list]:
     """Render every decks/*.toml; returns (written, removed) path lists.
     A missing or empty decks dir is not an error: nothing is rendered and
@@ -705,7 +708,9 @@ def render_all_slides(
     written, produced = [], set()
     for deck in decks:
         path = out / f"{deck['slug']}.html"
-        if write_if_changed(path, render_deck_html(model, deck, links=links)):
+        if write_if_changed(
+            path, render_deck_html(model, deck, links=links, fonts=fonts)
+        ):
             written.append(path)
         produced.add(path.name)
 

archi_cli-0.2.2/.gitignore

@@ -1,15 +0,0 @@
-# Archi-backups en afgeleide artefacten — niet versioneren
-*.bak
-output/
-*.xml
-*.svg
-*.png
-
-# Python
-__pycache__/
-*.py[cod]
-.venv/
-.pytest_cache/
-
-# macOS
-.DS_Store

archi_cli-0.2.2/NOTICE

@@ -1,15 +0,0 @@
-archi-cli
-Copyright (c) 2026 Bureau Architectuur Digitale Overheid
-Licensed under the EUPL-1.2 (see LICENSE).
-
-This tool downloads and drives the Archi engine for its `normalize` command.
-Archi is a separate work and is not distributed as part of this package; it is
-fetched at runtime from the official release on first use.
-
-  Archi — ArchiMate modelling tool
-  Copyright (c) Phillip Beauvoir, Jean-Baptiste Sarrodie and contributors
-  Licensed under the MIT License
-  https://github.com/archimatetool/archi
-
-The Archi distribution bundles an OpenJDK runtime; its own licensing applies to
-that runtime.

archi_cli-0.2.2/PKG-INFO

@@ -1,167 +0,0 @@
-Metadata-Version: 2.5
-Name: archi-cli
-Version: 0.2.2
-Summary: ar·cli·mate — de CLI in je ArchiMate: deterministisch native .archimate-modellen inspecteren, muteren, valideren en renderen
-Project-URL: Homepage, https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting
-Project-URL: Repository, https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting
-Project-URL: Issues, https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/issues
-Author: Bureau Architectuur Digitale Overheid
-License-Expression: EUPL-1.2
-License-File: LICENSE
-Keywords: archi,archimate,cli,enterprise-architecture,modeling
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Documentation
-Requires-Python: >=3.12
-Requires-Dist: lxml>=6.1.3
-Requires-Dist: typer>=0.26
-Description-Content-Type: text/markdown
-
-# AI-assisted architecting
-
-[![checks](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/actions/workflows/ci.yml/badge.svg)](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/actions/workflows/ci.yml)
-[![licentie: EUPL-1.2](https://img.shields.io/badge/licentie-EUPL--1.2-blue.svg)](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/LICENSE)
-[![PyPI](https://img.shields.io/pypi/v/archi-cli.svg)](https://pypi.org/project/archi-cli/)
-
-Een manier van architecteren waarbij een ArchiMate-model in het native
-Archi-formaat de bron van waarheid is, en je het met AI-assistentie bijhoudt in
-plaats van met de hand door de GUI te klikken. Deze repo levert de twee dingen
-die daarvoor nodig zijn:
-
-- **`archi-cli`**: een deterministische command line tool die een
-  `.archimate`-model inspecteert, muteert, valideert en rendert, en weigert een
-  kapot model op te slaan. Op PyPI, werkt op elk model.
-- **De skills** (`archi-model`, `archi-view`, `archi-slides`): de werkwijze
-  die een AI-sessie zoals Claude Code volgt om via de CLI aan het model te
-  werken. Te installeren als Claude Code plugin.
-
-Het model zelf hoort niet hier: dat woont in een eigen repo en gebruikt
-`archi-cli` als tool. Het ADO-model waarvoor dit ontstond is daar het
-voorbeeld.
-
-## De CLI
-
-```bash
-uv tool install archi-cli
-archi --help
-```
-
-Dat zet het commando `archi` op je `$PATH`. Het model wordt gevonden via
-`--model <pad>` (vóór het subcommando), via een `archi.toml` in de map
-(`[tool.archi] model = "..."`), of als het enige `.archimate`-bestand in de
-werkmap.
-
-```bash
-archi stats                                    # tellingen per type
-archi list --type Capability                   # elementen, gefilterd
-archi show "<elementnaam of id>"               # één element met relaties
-archi tree                                     # folderstructuur
-
-archi add-element --type Capability --name "..." --documentation "..."
-archi add-relation --type Aggregation --source "..." --target "..." --name "bevat"
-archi set-property <ref> "<key>=<waarde>"      # property zetten of bijwerken
-archi remove-property <ref> "<key>"            # property verwijderen
-archi set-documentation <ref> "..."            # Archi's documentatieveld
-archi add-element ... --subfolder "Gebied X"    # in een submap van de laag
-archi move <ref> --subfolder "Gebied X"        # naar een submap verplaatsen
-archi rename <ref> "Nieuwe naam"
-archi remove <ref> --cascade
-
-archi add-view --name "..." --layout cluster --type Capability --relation Aggregation
-archi slides --deck decks/<naam>.toml
-
-archi validate                                 # integriteitschecks
-archi normalize                                # canonieke serialisatie via Archi
-archi render                                   # views naar Mermaid en HTML
-```
-
-Voor `normalize` is de Archi-engine nodig; die haalt `archi` bij het eerste
-gebruik zelf op (of expliciet met `archi setup`), dus je hoeft Archi niet apart
-te installeren. `archi <commando> --help` toont de volledige set vlaggen;
-shell-completion zet je aan met `archi --install-completion`.
-
-Wat de tool bijzonder maakt:
-
-- **Muteren met een vangnet.** Elke wijziging valideert het model in het
-  geheugen; bij een fout weigert de CLI op te slaan. Ids zijn onveranderlijk.
-- **Canonieke serialisatie.** `normalize` laat de headless Archi-engine het
-  bestand herschrijven, zodat git-diffs klein blijven, of de wijziging nu van
-  de tool of van de Archi-GUI kwam.
-- **Renderen.** Elke view wordt een Mermaid-diagram (rendert op GitHub) en een
-  HTML-pagina die de layout uit het model volgt, plus een presentatie per
-  deckdefinitie.
-- **Doorklikken tussen views.** Met een links-bestand
-  (`[tool.archi] links = "…"` in `archi.toml`) worden elementen in de
-  HTML-views en slides klikbaar naar een andere view of een ander bestand,
-  bijvoorbeeld een SVG die een project met eigen scripts maakt. Zie
-  hieronder.
-
-### Doorklikken met een links-bestand
-
-Welk element waarheen doorklikt is een redactionele keuze, geen modelfeit;
-het staat daarom in een apart TOML-bestand (zie ADR 0010):
-
-```toml
-# archi.toml
-[tool.archi]
-links = "tools/links.toml"
-
-# tools/links.toml
-["overzicht-van-de-gebieden"]            # bestandsnaam van de bronplaat, zonder extensie
-"Gebied A" = "gebied-a-in-detail.html"   # elementnaam = pad, relatief aan de bronplaat
-"Gebied B" = "../eigen-svg/gebied-b.svg"
-```
-
-Een sectie hoort bij de HTML-view met die bestandsnaam (de slug van de
-viewnaam; bij views met botsende namen de naam mét id-suffix die `archi
-render` kiest), of bij een bestand dat een project zelf genereert: dezelfde
-sectievorm is dan bruikbaar voor eigen scripts, zodat één bestand over alle
-doorkliks gaat. In slides worden relatieve paden automatisch gecorrigeerd
-voor de submap. `archi validate` waarschuwt voor elementnamen die niet in de
-view (of het model) staan, `archi render` voor doelen die niet bestaan en
-voor secties die bij geen view of bestand horen.
-
-## De skills als Claude Code plugin
-
-Deze repo is tegelijk de plugin (`archi-tools`) en de marketplace die hem
-aanbiedt (`archi-marketplace`). Zo installeer je de skills bij je eigen model:
-
-```
-/plugin marketplace add BureauArchitectuurDigitaleOverheid/ai-assisted-architecting
-/plugin install archi-tools@archi-marketplace
-```
-
-De plugin brengt de drie skills mee; het `archi`-commando zelf komt van
-`uv tool install archi-cli`. Zie `adr/0007-claude-code-plugin.md`.
-
-## Ontwikkelen aan de tool
-
-```bash
-just setup       # venv, dependencies en de pre-commit hook
-just test        # de testsuite (draait op een fixture-model)
-just demo        # de CLI op het fixture-model
-just build       # distributies bouwen en de metadata controleren
-```
-
-De testsuite draait op `tests/fixtures/klein-model.archimate`, niet op een echt
-model. Wijzigingen lopen via een branch en een PR; CI draait de suite op Ubuntu
-en Windows. Publiceren naar PyPI gebeurt op een versie-tag, zie `CLAUDE.md` en
-`adr/0006-publiceren-op-pypi.md`.
-
-## Structuur
-
-```
-tools/archi_tool/       De archi-CLI (Python, lxml, Typer; beheerd met uv)
-tests/                  pytest-suite met een klein fixture-model
-.claude/skills/         De skills (archi-model, archi-view, archi-slides)
-.claude-plugin/         Plugin- en marketplace-manifest
-adr/                    Architectuurbeslissingen over de tool
-justfile                Vaste taken
-```
-
-## Licentie
-
-[EUPL-1.2](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/LICENSE).

archi_cli-0.2.2/README.md

@@ -1,145 +0,0 @@
-# AI-assisted architecting
-
-[![checks](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/actions/workflows/ci.yml/badge.svg)](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/actions/workflows/ci.yml)
-[![licentie: EUPL-1.2](https://img.shields.io/badge/licentie-EUPL--1.2-blue.svg)](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/LICENSE)
-[![PyPI](https://img.shields.io/pypi/v/archi-cli.svg)](https://pypi.org/project/archi-cli/)
-
-Een manier van architecteren waarbij een ArchiMate-model in het native
-Archi-formaat de bron van waarheid is, en je het met AI-assistentie bijhoudt in
-plaats van met de hand door de GUI te klikken. Deze repo levert de twee dingen
-die daarvoor nodig zijn:
-
-- **`archi-cli`**: een deterministische command line tool die een
-  `.archimate`-model inspecteert, muteert, valideert en rendert, en weigert een
-  kapot model op te slaan. Op PyPI, werkt op elk model.
-- **De skills** (`archi-model`, `archi-view`, `archi-slides`): de werkwijze
-  die een AI-sessie zoals Claude Code volgt om via de CLI aan het model te
-  werken. Te installeren als Claude Code plugin.
-
-Het model zelf hoort niet hier: dat woont in een eigen repo en gebruikt
-`archi-cli` als tool. Het ADO-model waarvoor dit ontstond is daar het
-voorbeeld.
-
-## De CLI
-
-```bash
-uv tool install archi-cli
-archi --help
-```
-
-Dat zet het commando `archi` op je `$PATH`. Het model wordt gevonden via
-`--model <pad>` (vóór het subcommando), via een `archi.toml` in de map
-(`[tool.archi] model = "..."`), of als het enige `.archimate`-bestand in de
-werkmap.
-
-```bash
-archi stats                                    # tellingen per type
-archi list --type Capability                   # elementen, gefilterd
-archi show "<elementnaam of id>"               # één element met relaties
-archi tree                                     # folderstructuur
-
-archi add-element --type Capability --name "..." --documentation "..."
-archi add-relation --type Aggregation --source "..." --target "..." --name "bevat"
-archi set-property <ref> "<key>=<waarde>"      # property zetten of bijwerken
-archi remove-property <ref> "<key>"            # property verwijderen
-archi set-documentation <ref> "..."            # Archi's documentatieveld
-archi add-element ... --subfolder "Gebied X"    # in een submap van de laag
-archi move <ref> --subfolder "Gebied X"        # naar een submap verplaatsen
-archi rename <ref> "Nieuwe naam"
-archi remove <ref> --cascade
-
-archi add-view --name "..." --layout cluster --type Capability --relation Aggregation
-archi slides --deck decks/<naam>.toml
-
-archi validate                                 # integriteitschecks
-archi normalize                                # canonieke serialisatie via Archi
-archi render                                   # views naar Mermaid en HTML
-```
-
-Voor `normalize` is de Archi-engine nodig; die haalt `archi` bij het eerste
-gebruik zelf op (of expliciet met `archi setup`), dus je hoeft Archi niet apart
-te installeren. `archi <commando> --help` toont de volledige set vlaggen;
-shell-completion zet je aan met `archi --install-completion`.
-
-Wat de tool bijzonder maakt:
-
-- **Muteren met een vangnet.** Elke wijziging valideert het model in het
-  geheugen; bij een fout weigert de CLI op te slaan. Ids zijn onveranderlijk.
-- **Canonieke serialisatie.** `normalize` laat de headless Archi-engine het
-  bestand herschrijven, zodat git-diffs klein blijven, of de wijziging nu van
-  de tool of van de Archi-GUI kwam.
-- **Renderen.** Elke view wordt een Mermaid-diagram (rendert op GitHub) en een
-  HTML-pagina die de layout uit het model volgt, plus een presentatie per
-  deckdefinitie.
-- **Doorklikken tussen views.** Met een links-bestand
-  (`[tool.archi] links = "…"` in `archi.toml`) worden elementen in de
-  HTML-views en slides klikbaar naar een andere view of een ander bestand,
-  bijvoorbeeld een SVG die een project met eigen scripts maakt. Zie
-  hieronder.
-
-### Doorklikken met een links-bestand
-
-Welk element waarheen doorklikt is een redactionele keuze, geen modelfeit;
-het staat daarom in een apart TOML-bestand (zie ADR 0010):
-
-```toml
-# archi.toml
-[tool.archi]
-links = "tools/links.toml"
-
-# tools/links.toml
-["overzicht-van-de-gebieden"]            # bestandsnaam van de bronplaat, zonder extensie
-"Gebied A" = "gebied-a-in-detail.html"   # elementnaam = pad, relatief aan de bronplaat
-"Gebied B" = "../eigen-svg/gebied-b.svg"
-```
-
-Een sectie hoort bij de HTML-view met die bestandsnaam (de slug van de
-viewnaam; bij views met botsende namen de naam mét id-suffix die `archi
-render` kiest), of bij een bestand dat een project zelf genereert: dezelfde
-sectievorm is dan bruikbaar voor eigen scripts, zodat één bestand over alle
-doorkliks gaat. In slides worden relatieve paden automatisch gecorrigeerd
-voor de submap. `archi validate` waarschuwt voor elementnamen die niet in de
-view (of het model) staan, `archi render` voor doelen die niet bestaan en
-voor secties die bij geen view of bestand horen.
-
-## De skills als Claude Code plugin
-
-Deze repo is tegelijk de plugin (`archi-tools`) en de marketplace die hem
-aanbiedt (`archi-marketplace`). Zo installeer je de skills bij je eigen model:
-
-```
-/plugin marketplace add BureauArchitectuurDigitaleOverheid/ai-assisted-architecting
-/plugin install archi-tools@archi-marketplace
-```
-
-De plugin brengt de drie skills mee; het `archi`-commando zelf komt van
-`uv tool install archi-cli`. Zie `adr/0007-claude-code-plugin.md`.
-
-## Ontwikkelen aan de tool
-
-```bash
-just setup       # venv, dependencies en de pre-commit hook
-just test        # de testsuite (draait op een fixture-model)
-just demo        # de CLI op het fixture-model
-just build       # distributies bouwen en de metadata controleren
-```
-
-De testsuite draait op `tests/fixtures/klein-model.archimate`, niet op een echt
-model. Wijzigingen lopen via een branch en een PR; CI draait de suite op Ubuntu
-en Windows. Publiceren naar PyPI gebeurt op een versie-tag, zie `CLAUDE.md` en
-`adr/0006-publiceren-op-pypi.md`.
-
-## Structuur
-
-```
-tools/archi_tool/       De archi-CLI (Python, lxml, Typer; beheerd met uv)
-tests/                  pytest-suite met een klein fixture-model
-.claude/skills/         De skills (archi-model, archi-view, archi-slides)
-.claude-plugin/         Plugin- en marketplace-manifest
-adr/                    Architectuurbeslissingen over de tool
-justfile                Vaste taken
-```
-
-## Licentie
-
-[EUPL-1.2](https://github.com/BureauArchitectuurDigitaleOverheid/ai-assisted-architecting/blob/main/LICENSE).