XED /CCI cBOX@ /Container Inventur · Read-Only-Tool für lokale cBOX-Inventur

firstboot.sh v0.0.1 cci v0.0.1 MIT GitHub PyPI

100% Read-Only: cci verändert NIEMALS den Box-Zustand. Strukturelle Garantie via subprocess-Whitelist (ReadOnlyViolationError bei nicht-whitelisted Aufruf).

Schnellstart

In jeder frischen Debian/Ubuntu-LXC-Box als root:

# Pre-Step (minimal-LXC-Templates haben kein curl vorinstalliert):
apt update && apt install -y curl ca-certificates

# firstboot.sh ausführen (installiert pipx + xed-cci):
bash <(curl -s https://cci.xed.dev/firstboot.sh)

# Inventur ausführen:
cci inventory                  # Rich-Tabellen für Mensch
cci inventory --format json    # JSON für AI-Agent

Manuell (wenn pipx schon vorhanden):

pipx install xed-cci

Was `cci inventory` liefert

Sektion	Quelle	Inhalt
`os`	`/etc/os-release` + `os.uname()`	id, version_id, pretty_name, kernel
`cc-suite`	`pipx list --json`	xed-ccc / xed-cca / xed-cci-Versionen
`stack`	`sys.version_info` + `shutil.which`	python3 (immer) + php / node (Optional)
`databases`	`dpkg-query` + `systemctl is-active`	mysql / mariadb / postgresql + Service-Status
`apps`	`Path.glob` unter `/var/www/`	Server-Apps mit Versionen (v0.0.1: Typo3-Detection)

Verben

cci inventory                       # Komplette Inventur (Rich-Tabelle)
cci inventory --format json         # JSON für AI-Agent-Konsumtion
cci inventory --section os          # Nur OS-Sektion
cci inventory --section cc-suite    # Nur CC-Suite-Versionen
cci inventory --section stack       # Nur Programmier-Stacks
cci inventory --section databases   # Nur Datenbank-Engines
cci inventory --section apps        # Nur Server-Apps
cci --help                          # Verb-Übersicht
cci --version                       # Tool-Version

Use-Case: AI-Agent-Konsultation

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 — ohne dass DevOps die Daten manuell zusammensuchen muss.

Drei-Phasen-Plan

Phase	Inhalt	Status
1	Python-CLI Read-Only (`cci inventory`-Verb mit Rich + JSON)	v0.0.1 live
2	DeltaChat-Bot-Daemon (dezentrale Box-Steuerung ohne Ports/TLS)	Vision (geplant)
3	cBOX@ /Monitor (Master-Programm für 1000+ Boxen)	Vision (geplant)

Volle Architektur-Entscheidungsfindung + Vision/Mission siehe README und das Whitepaper im fb-data-Workspace-Repo.

Designprinzipien

100% Read-Only — strukturelle Garantie via subprocess-Whitelist + Lakmus-Test pro Helper
Stack-Konsistenz mit ccc + cca — Python + Typer + Rich + pytest + pipx
Stdlib-Idiomatik bevorzugt — platform.freedesktop_os_release, os.uname, sys.version_info, pathlib.Path wo möglich
JSON-Schema-Versionierung — Backward-Compat-Disziplin für AI-Agent-Konsumenten
AI-Agent-pflegbar — Python-Stack, ausgereifte Libraries, einheitliche Disziplinen