xed-cci 0.0.1__tar.gz

xed_cci-0.0.1/.gitignore

@@ -0,0 +1,27 @@
+# Python build/cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+build/
+dist/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+
+# pytest
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDE / OS
+.vscode/
+.idea/
+.DS_Store
+*.swp
+
+# uv
+.uv/

xed_cci-0.0.1/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+Alle bemerkenswerten Änderungen an `xed-cci` werden hier dokumentiert.
+
+Format folgt [Keep a Changelog](https://keepachangelog.com/de/1.1.0/),
+Versionierung folgt [Semantic Versioning](https://semver.org/lang/de/).
+
+## [0.0.1] — UNRELEASED
+
+### Hinzugefügt (CCI-SS1 — Skelett-Setup)
+
+- **CLI-Skelett** mit Typer-app + `--version`/`-V`-Flag + `--help`-Übersicht
+- **`cci inventory` als Stub-Verb** — Skelett-Form, eigentliche Implementation
+  folgt in SS5 (Composition + Rich + JSON-Output + `--section`-Filter)
+- **pyproject.toml** mit hatchling-Backend + dynamic version aus
+  `_version.py` + Stack-Konsistenz zu ccc/cca (Typer + Rich + psutil + pytest)
+- **Test-Skelett** mit 3 Smoke-Cases (--version, --help, inventory-Stub)
+
+### Architektur-Notizen
+
+- Phase 1: Python-CLI Read-Only-Klasse, Drei-Tool-Suite-Symmetrie zu ccc + cca
+- Phase 2 (DeltaChat-Bot) + Phase 3 (cBOX@ /Monitor) sind Vision/Mission,
+  NICHT in dieser Version umgesetzt — siehe `WHITEPAPER.md` für vollständige
+  Architektur-Entscheidungsfindung
+- Symmetrisches Layout: `docs/firstboot.sh` (Pages-Source), kein `scripts/`-
+  Pfad-Mapping (Lehre aus CCC-Layout-Refactor 2026-05-08)
+- Read-Only-Garantie strukturell via `safe_run.py` (kommt SS2)
+
+[0.0.1]: https://github.com/XED-dev/CCI/releases/tag/v0.0.1

xed_cci-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 XED /Code ❤️ recode@ /DAO 
+
+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.

xed_cci-0.0.1/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: xed-cci
+Version: 0.0.1
+Summary: cBOX@ /Container Inventur — Read-Only-Tool für lokale Box-Inventur (OS, CC-Suite, Stack, Datenbanken, Server-Apps). Drittes Mitglied der XED /CC-Suite neben ccc + cca. cBOX.at/YOU by XED.dev Tools via Collective Context (CC).
+Project-URL: Homepage, https://cci.xed.dev
+Project-URL: Repository, https://github.com/XED-dev/CCI
+Project-URL: XED /Suite, https://xed.dev
+Project-URL: Issues, https://github.com/XED-dev/CCI/issues
+Project-URL: Changelog, https://github.com/XED-dev/CCI/blob/main/CHANGELOG.md
+Author-email: Collective Context <code@collective-context.org>
+License: MIT
+License-File: LICENSE
+Keywords: cbox,cci,cli,container,debian,inventory,kaizen,lxc,monitoring,proxmox,read-only,ubuntu
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+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: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: psutil>=5.9
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# XED /CCI — cBOX@ /Container Inventur
+
+> Read-Only-Tool für lokale cBOX-Inventur. Drittes Mitglied der XED /CC-Suite
+> neben [ccc](../XED-CCC/) (Control) und [cca](../XED-CCA/) (App-Installation).
+
+**100% Read-Only:** cci verändert NIEMALS den Box-Zustand. Strukturelle
+Garantie via subprocess-Whitelist.
+
+## Was es macht (Phase 1)
+
+`cci inventory` liefert eine vollständige Inventur der lokalen Box als
+Rich-Tabelle (Mensch) oder JSON (AI-Agent).
+
+**Sektionen:**
+- **OS** — `/etc/os-release` + Kernel
+- **CC-Suite** — installed `xed-ccc` / `xed-cca` / `xed-cci`-Versionen
+- **Stack** — `python3` / `php` / `node` Versionen (wenn installiert)
+- **Databases** — `mysql` / `mariadb` / `postgres` Versionen + Service-Status
+- **Apps** — Server-Apps mit Pfaden + Versionen (v0.0.1: Typo3-Detection)
+
+## Installation
+
+**Empfohlen** — auf einer cBOX (LXC) via firstboot.sh:
+
+```bash
+bash <(curl -s https://cci.xed.dev/firstboot.sh)
+```
+
+Das Script installiert Python-Stack + pipx und holt `xed-cci` von PyPI.
+
+**Manuell** — wenn pipx schon vorhanden:
+
+```bash
+pipx install xed-cci
+```
+
+## Verwendung
+
+```bash
+# Komplette Inventur als Rich-Tabelle
+cci inventory
+
+# JSON für AI-Agent-Konsumtion
+cci inventory --format json
+
+# Gefilterte Sektion
+cci inventory --section os
+cci inventory --section apps
+cci inventory --section stack
+cci inventory --section databases
+cci inventory --section cc-suite
+
+# Verb-Übersicht
+cci --help
+
+# Tool-Version
+cci --version
+```
+
+## Use-Case: AI-Agent-Konsultation
+
+```bash
+cci inventory --format json > /tmp/box.json
+
+# Dann an AI-Agent (Claude Code, ChatGPT, etc.):
+# "Hier ist meine Box-Inventur. Passt diese Konfiguration für Typo3 v13?
+#  Welche Anpassungen sind nötig?"
+```
+
+Der AI-Agent sieht in einem strukturierten JSON-Block alle relevanten
+Box-Daten und kann fundierte Migrations-/Update-Empfehlungen geben.
+
+## Roadmap
+
+- **Phase 1 (jetzt):** Python-CLI mit `cci inventory`-Verb (read-only,
+  pipx-Distribution, ccc/cca-Pattern-Symmetrie). Erste App-Detection für
+  Typo3.
+- **Phase 2 (Vision):** DeltaChat-Bot-Daemon für dezentrale Box-Steuerung
+  ohne offene Ports + TLS-Cert-Management. Siehe
+  [WHITEPAPER.md §Phase 2](./WHITEPAPER.md#phase-2--deltachat-bot-daemon-visionmission-nicht-für-phase-1-umsetzen).
+- **Phase 3 (Vision):** cBOX@ /Monitor Master-Programm für Inventur-
+  Aggregation über tausende cBOX@ /CUBE-Boxen. Siehe
+  [WHITEPAPER.md §Phase 3](./WHITEPAPER.md#phase-3--cbox-monitor-visionmission-nicht-für-phase-12-umsetzen).
+
+Volle Architektur-Entscheidungsfindung + Vision/Mission siehe
+[WHITEPAPER.md](./WHITEPAPER.md).
+
+## Lizenz
+
+MIT

xed_cci-0.0.1/README.md

@@ -0,0 +1,90 @@
+# XED /CCI — cBOX@ /Container Inventur
+
+> Read-Only-Tool für lokale cBOX-Inventur. Drittes Mitglied der XED /CC-Suite
+> neben [ccc](../XED-CCC/) (Control) und [cca](../XED-CCA/) (App-Installation).
+
+**100% Read-Only:** cci verändert NIEMALS den Box-Zustand. Strukturelle
+Garantie via subprocess-Whitelist.
+
+## Was es macht (Phase 1)
+
+`cci inventory` liefert eine vollständige Inventur der lokalen Box als
+Rich-Tabelle (Mensch) oder JSON (AI-Agent).
+
+**Sektionen:**
+- **OS** — `/etc/os-release` + Kernel
+- **CC-Suite** — installed `xed-ccc` / `xed-cca` / `xed-cci`-Versionen
+- **Stack** — `python3` / `php` / `node` Versionen (wenn installiert)
+- **Databases** — `mysql` / `mariadb` / `postgres` Versionen + Service-Status
+- **Apps** — Server-Apps mit Pfaden + Versionen (v0.0.1: Typo3-Detection)
+
+## Installation
+
+**Empfohlen** — auf einer cBOX (LXC) via firstboot.sh:
+
+```bash
+bash <(curl -s https://cci.xed.dev/firstboot.sh)
+```
+
+Das Script installiert Python-Stack + pipx und holt `xed-cci` von PyPI.
+
+**Manuell** — wenn pipx schon vorhanden:
+
+```bash
+pipx install xed-cci
+```
+
+## Verwendung
+
+```bash
+# Komplette Inventur als Rich-Tabelle
+cci inventory
+
+# JSON für AI-Agent-Konsumtion
+cci inventory --format json
+
+# Gefilterte Sektion
+cci inventory --section os
+cci inventory --section apps
+cci inventory --section stack
+cci inventory --section databases
+cci inventory --section cc-suite
+
+# Verb-Übersicht
+cci --help
+
+# Tool-Version
+cci --version
+```
+
+## Use-Case: AI-Agent-Konsultation
+
+```bash
+cci inventory --format json > /tmp/box.json
+
+# Dann an AI-Agent (Claude Code, ChatGPT, etc.):
+# "Hier ist meine Box-Inventur. Passt diese Konfiguration für Typo3 v13?
+#  Welche Anpassungen sind nötig?"
+```
+
+Der AI-Agent sieht in einem strukturierten JSON-Block alle relevanten
+Box-Daten und kann fundierte Migrations-/Update-Empfehlungen geben.
+
+## Roadmap
+
+- **Phase 1 (jetzt):** Python-CLI mit `cci inventory`-Verb (read-only,
+  pipx-Distribution, ccc/cca-Pattern-Symmetrie). Erste App-Detection für
+  Typo3.
+- **Phase 2 (Vision):** DeltaChat-Bot-Daemon für dezentrale Box-Steuerung
+  ohne offene Ports + TLS-Cert-Management. Siehe
+  [WHITEPAPER.md §Phase 2](./WHITEPAPER.md#phase-2--deltachat-bot-daemon-visionmission-nicht-für-phase-1-umsetzen).
+- **Phase 3 (Vision):** cBOX@ /Monitor Master-Programm für Inventur-
+  Aggregation über tausende cBOX@ /CUBE-Boxen. Siehe
+  [WHITEPAPER.md §Phase 3](./WHITEPAPER.md#phase-3--cbox-monitor-visionmission-nicht-für-phase-12-umsetzen).
+
+Volle Architektur-Entscheidungsfindung + Vision/Mission siehe
+[WHITEPAPER.md](./WHITEPAPER.md).
+
+## Lizenz
+
+MIT

xed_cci-0.0.1/pyproject.toml

@@ -0,0 +1,80 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "xed-cci"
+dynamic = ["version"]
+description = "cBOX@ /Container Inventur — Read-Only-Tool für lokale Box-Inventur (OS, CC-Suite, Stack, Datenbanken, Server-Apps). Drittes Mitglied der XED /CC-Suite neben ccc + cca. cBOX.at/YOU by XED.dev Tools via Collective Context (CC)."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "Collective Context", email = "code@collective-context.org" },
+]
+keywords = [
+    "lxc",
+    "proxmox",
+    "container",
+    "inventory",
+    "read-only",
+    "cli",
+    "cci",
+    "cbox",
+    "debian",
+    "ubuntu",
+    "monitoring",
+    "kaizen",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Monitoring",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.12",
+    "rich>=13.7",
+    "psutil>=5.9",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+]
+
+[project.scripts]
+cci = "cci.cli:main"
+
+[project.urls]
+Homepage       = "https://cci.xed.dev"
+Repository     = "https://github.com/XED-dev/CCI"
+"XED /Suite"   = "https://xed.dev"
+Issues         = "https://github.com/XED-dev/CCI/issues"
+Changelog      = "https://github.com/XED-dev/CCI/blob/main/CHANGELOG.md"
+
+[tool.hatch.version]
+path = "src/cci/_version.py"
+pattern = '__version__ = "(?P<version>[^"]+)"'
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cci"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/cci",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "pyproject.toml",
+]

xed_cci-0.0.1/src/cci/__init__.py

@@ -0,0 +1,5 @@
+"""xed-cci — cBOX@ /Container Inventur (Read-Only)."""
+
+from cci._version import __version__
+
+__all__ = ["__version__"]

xed_cci-0.0.1/src/cci/_version.py

@@ -0,0 +1,2 @@
+"""Version of xed-cci — single source of truth for hatchling-build."""
+__version__ = "0.0.1"

xed_cci-0.0.1/src/cci/cli.py

@@ -0,0 +1,73 @@
+"""xed-cci CLI — Typer-basiertes Read-Only-Inventur-Tool.
+
+Designprinzipien (siehe WHITEPAPER §Vision + §Mission Statement):
+- 100% Read-Only: cci verändert NIEMALS den Box-Zustand
+- Stack-Konsistenz mit ccc + cca (Typer + Rich + pytest + pipx)
+- AI-Agent-Konsumtion via JSON-Output
+
+Phase-1-Verben (v0.0.1+):
+- inventory: komplette Box-Inventur (Rich-Tabelle oder JSON)
+
+Phase 2 (DeltaChat-Bot) + Phase 3 (cBOX@ /Monitor) sind Vision/Mission,
+NICHT in Phase 1 umgesetzt.
+"""
+
+from __future__ import annotations
+
+import sys
+from typing import Optional
+
+import typer
+from rich.console import Console
+
+from cci._version import __version__
+from cci.commands.inventory import inventory_command
+
+app = typer.Typer(
+    name="cci",
+    help="cBOX@ /Container Inventur — Read-Only-Tool für lokale Box-Inventur.\n\n"
+    "Liefert OS, CC-Suite-Versionen, Stacks, Datenbanken und Server-Apps\n"
+    "als Rich-Tabelle (Mensch) oder JSON (AI-Agent-Konsumtion).\n\n"
+    "100% Read-Only: cci verändert NIEMALS den Box-Zustand.\n\n"
+    "cBOX.at/YOU by XED.dev Tools via Collective Context (CC).",
+    no_args_is_help=True,
+    add_completion=False,
+)
+console = Console()
+
+
+def version_callback(value: bool) -> None:
+    if value:
+        console.print(f"xed-cci [bold]v{__version__}[/bold]")
+        raise typer.Exit()
+
+
+@app.callback()
+def main_callback(
+    version: Optional[bool] = typer.Option(
+        None,
+        "--version",
+        "-V",
+        help="Zeige Version und beende.",
+        callback=version_callback,
+        is_eager=True,
+    ),
+) -> None:
+    """xed-cci Top-Level-Callback. Lädt globale Optionen wie --version."""
+
+
+# inventory-Verb (SS5: Composition + Rich + JSON-Output + --section-Filter)
+app.command("inventory")(inventory_command)
+
+
+def main() -> None:
+    """Entry point für das `cci`-Script (siehe pyproject.toml [project.scripts])."""
+    try:
+        app()
+    except KeyboardInterrupt:
+        console.print("\n[red]Abgebrochen.[/red]")
+        sys.exit(130)
+
+
+if __name__ == "__main__":
+    main()

xed_cci-0.0.1/src/cci/commands/inventory.py

@@ -0,0 +1,221 @@
+"""inventory — cci inventory-Verb (Composition + Rich + JSON + --section).
+
+Composition über die fünf Inventur-Sektionen (os/cc-suite/stack/databases/
+apps). Output entweder Rich-Tabelle (Mensch) oder JSON (AI-Agent-Konsumtion).
+
+Senior-Pre-Hints H6-H11 (AI039 SS5 2026-05-08):
+- H6: InventoryReport TypedDict matcht WHITEPAPER §JSON-Schema 1:1
+- H7: Rich für Mensch / json.dumps für AI-Agent
+- H8: --section-Filter mit enum-Choices (os/cc-suite/stack/databases/apps/all)
+- H9: datetime.now(timezone.utc).isoformat — KEIN deprecated utcnow()
+- H10: socket.gethostname() — KEIN subprocess hostname
+- H11: _SCHEMA_VERSION als Konstante (Single-Source-of-Truth)
+
+Stdlib-Reflex maximiert: keine subprocess-Aufrufe in dieser Datei
+(Composition + Output-Rendering nur).
+"""
+
+from __future__ import annotations
+
+import json
+import socket
+from datetime import datetime, timezone
+from enum import Enum
+from typing import TypedDict
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from cci.system.inventory.apps import AppInfo, collect_apps_info
+from cci.system.inventory.cc_suite import CCSuiteInfo, collect_cc_suite_info
+from cci.system.inventory.databases import DatabaseInfo, collect_databases_info
+from cci.system.inventory.os import OSInfo, collect_os_info
+from cci.system.inventory.stack import StackInfo, collect_stack_info
+
+_SCHEMA_VERSION = "0.0.1"
+
+
+class InventoryReport(TypedDict):
+    """Vollständige Inventur-Composition matching WHITEPAPER §JSON-Schema."""
+
+    schema_version: str
+    timestamp: str
+    host: str
+    os: OSInfo
+    cc_suite: CCSuiteInfo
+    stack: StackInfo
+    databases: list[DatabaseInfo]
+    apps: list[AppInfo]
+
+
+class Section(str, Enum):
+    """Erlaubte --section-Werte (Typer-Choices)."""
+
+    ALL = "all"
+    OS = "os"
+    CC_SUITE = "cc-suite"
+    STACK = "stack"
+    DATABASES = "databases"
+    APPS = "apps"
+
+
+def _utc_timestamp() -> str:
+    """ISO-UTC-Zeitstempel mit 'Z'-Suffix (kompatibel zu audit_log-Format)."""
+    return (
+        datetime.now(timezone.utc)
+        .isoformat(timespec="seconds")
+        .replace("+00:00", "Z")
+    )
+
+
+def _build_report() -> InventoryReport:
+    """Baue komplette InventoryReport via Composition aller collect_X_info()."""
+    return InventoryReport(
+        schema_version=_SCHEMA_VERSION,
+        timestamp=_utc_timestamp(),
+        host=socket.gethostname(),
+        os=collect_os_info(),
+        cc_suite=collect_cc_suite_info(),
+        stack=collect_stack_info(),
+        databases=collect_databases_info(),
+        apps=collect_apps_info(),
+    )
+
+
+def _filter_report(report: InventoryReport, section: Section) -> dict:
+    """Filtere Report auf gewählte Sektion (alle wenn Section.ALL).
+
+    Returns dict statt InventoryReport weil bei Section-Filter die
+    TypedDict-Struktur verändert wird (nur Subkey).
+    """
+    if section is Section.ALL:
+        return dict(report)
+
+    # Schema-Header bleibt immer drin für Kontext, plus die gewählte Sektion
+    base = {
+        "schema_version": report["schema_version"],
+        "timestamp": report["timestamp"],
+        "host": report["host"],
+    }
+    section_key = section.value.replace("-", "_")  # 'cc-suite' -> 'cc_suite'
+    base[section_key] = report[section_key]  # type: ignore[literal-required]
+    return base
+
+
+def _render_rich(console: Console, report: InventoryReport, section: Section) -> None:
+    """Rich-Tabellen-Output für gewählte Sektion(en)."""
+    if section in (Section.ALL, Section.OS):
+        _render_os(console, report["os"])
+    if section in (Section.ALL, Section.CC_SUITE):
+        _render_cc_suite(console, report["cc_suite"])
+    if section in (Section.ALL, Section.STACK):
+        _render_stack(console, report["stack"])
+    if section in (Section.ALL, Section.DATABASES):
+        _render_databases(console, report["databases"])
+    if section in (Section.ALL, Section.APPS):
+        _render_apps(console, report["apps"])
+
+    if section is Section.ALL:
+        console.print(
+            f"[dim]Schema {report['schema_version']} · "
+            f"{report['timestamp']} · {report['host']}[/dim]"
+        )
+
+
+def _render_os(console: Console, os_info: OSInfo) -> None:
+    table = Table(title="OS", show_header=True, header_style="bold cyan")
+    table.add_column("Field")
+    table.add_column("Value")
+    for key in ("id", "version_id", "pretty_name", "kernel"):
+        table.add_row(key, os_info[key])  # type: ignore[literal-required]
+    console.print(table)
+
+
+def _render_cc_suite(console: Console, cc: CCSuiteInfo) -> None:
+    table = Table(title="CC-Suite", show_header=True, header_style="bold cyan")
+    table.add_column("Tool")
+    table.add_column("Version")
+    for tool in ("xed-ccc", "xed-cca", "xed-cci"):
+        table.add_row(tool, cc[tool])  # type: ignore[literal-required]
+    console.print(table)
+
+
+def _render_stack(console: Console, stack: StackInfo) -> None:
+    table = Table(title="Stack", show_header=True, header_style="bold cyan")
+    table.add_column("Language")
+    table.add_column("Version")
+    table.add_row("python3", stack["python3"])
+    table.add_row("php", stack["php"] or "[dim]not installed[/dim]")
+    table.add_row("node", stack["node"] or "[dim]not installed[/dim]")
+    console.print(table)
+
+
+def _render_databases(console: Console, dbs: list[DatabaseInfo]) -> None:
+    table = Table(title="Databases", show_header=True, header_style="bold cyan")
+    table.add_column("Engine")
+    table.add_column("Version")
+    table.add_column("Service Active", justify="center")
+    if not dbs:
+        table.add_row("[dim](none)[/dim]", "", "")
+    for db in dbs:
+        active = "[green]✓[/green]" if db["service_active"] else "[red]✗[/red]"
+        table.add_row(db["engine"], db["version"], active)
+    console.print(table)
+
+
+def _render_apps(console: Console, apps: list[AppInfo]) -> None:
+    table = Table(title="Server-Apps", show_header=True, header_style="bold cyan")
+    table.add_column("Name")
+    table.add_column("Version")
+    table.add_column("Path")
+    if not apps:
+        table.add_row("[dim](none)[/dim]", "", "")
+    for app in apps:
+        table.add_row(app["name"], app["version"], app["path"])
+    console.print(table)
+
+
+def inventory_command(
+    section: Section = typer.Option(
+        Section.ALL,
+        "--section",
+        case_sensitive=False,
+        help="Welche Sektion ausgeben (Default: alle).",
+    ),
+    output_format: str = typer.Option(
+        "rich",
+        "--format",
+        case_sensitive=False,
+        help="Output-Format: 'rich' (Tabellen für Mensch) oder 'json' (AI-Agent).",
+    ),
+) -> None:
+    """Box-Inventur als Rich-Tabelle oder JSON.
+
+    Sektionen: os, cc-suite, stack, databases, apps, all (Default).
+
+    Beispiele:
+        cci inventory
+        cci inventory --section os
+        cci inventory --format json > /tmp/box.json
+    """
+    report = _build_report()
+
+    fmt = output_format.lower()
+    if fmt == "json":
+        # JSON-Output via stdout, Rich-Console-Output deaktiviert um
+        # Format-Kontamination zu vermeiden (Senior-Pre-Hint H7/H8 STOPP-
+        # Kriterium: bei --format json darf KEIN Rich-Output dazwischen
+        # rutschen).
+        filtered = _filter_report(report, section)
+        print(json.dumps(filtered, indent=2))
+        return
+
+    if fmt == "rich":
+        console = Console()
+        _render_rich(console, report, section)
+        return
+
+    raise typer.BadParameter(
+        f"Unbekanntes Format: {output_format!r}. Erlaubt: 'rich' oder 'json'."
+    )