XED /CCI — cBOX@ /Container Inventur

Read-Only-Tool für lokale Box-Klassen-Inventur. Drittes Mitglied der XED /CC-Suite neben ccc (Control) und cca (App-Installation).

100% Read-Only: cci verändert NIEMALS den Box-Zustand. Strukturelle Garantie via subprocess-Whitelist.

Was es macht (Phase 1, v0.0.9+)

cci typo3 liefert eine vollständige Inventur einer WordOps-LEMP-Ubuntu-LTS-Box mit TYPO3-Composer + optional Apache Solr — als Rich-Tabelle (Mensch) oder JSON (AI-Agent-Konsumtion).

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
• Sites — TYPO3-Sites pro Domain mit Pfaden + Versionen + Modus

Box-Klassen

Verb-basierte Subkommandos pro Box-Klasse:

Perspektivisch weitere Box-Klassen (cci wordpress, ...) als eigene Top-Level-Verben.

Installation

Empfohlen — auf einer cBOX (LXC) via firstboot.sh:

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:

pipx install xed-cci

Verwendung

# Komplette Inventur als Rich-Tabelle
cci typo3

# JSON für AI-Agent-Konsumtion
cci typo3 --format json

# Gefilterte Sektion
cci typo3 --section os
cci typo3 --section sites
cci typo3 --section stack
cci typo3 --section databases
cci typo3 --section cc-suite

# Output-Formate
cci typo3 --format oneliner              # 1-Zeile pipe-separated (Chat-Sharing)
cci typo3 --format text -o /tmp/inv.txt  # Plain multi-line in Datei

# Box-Klassen-Übersicht
cci --help

# Tool-Version
cci --version

Use-Case: AI-Agent-Konsultation

cci typo3 --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.

v0.0.10 BREAKING-Migration

• Site-Schema neu (JSON-Schema 0.0.2 → 0.0.3): report["sites"] ist jetzt list[SiteEntry] (Webroot-zentriert mit nested DomainInfo) statt list[AppInfo]. Multi-Webroot-Mapping (mehrere Domains teilen Webroot mit unterschiedlichen PHP-Versionen) wird natürlich erfasst.
• Werkzeug-First-Detection: wo site list + Nginx-Config-Parse als Primärquelle (autoritativ). Detection-Hierarchie pro Webroot: vendor-FS → composer.lock → composer.json (OR-Logic auf typo3/cms-*).
• Box-Klassen-Pre-Step: Hard-Gate vor Inventur (Ubuntu LTS 22.04/24.04
  • wo-CLI + nginx-wo-Build). Bei Mismatch Exit 2 mit Diagnostik.

v0.0.9 BREAKING-Migration (unverändert ab v0.0.10)

• Verb-Switch: cci inventory → cci typo3 (kein Deprecation-Alias).
• Section-Rename: --section apps → --section sites.

Siehe CHANGELOG.md für vollständige BREAKING-Liste + Migrations-Mapping.

Roadmap

• Phase 1 (jetzt): Python-CLI mit Box-Klassen-Subkommandos (cci typo3, perspektivisch cci wordpress u.a.), read-only, pipx-Distribution, ccc/cca-Pattern-Symmetrie.
• Phase 2 (Vision): DeltaChat-Bot-Daemon für dezentrale Box-Steuerung ohne offene Ports + TLS-Cert-Management.
• Phase 3 (Vision): cBOX@ /Monitor Master-Programm für Inventur- Aggregation über tausende cBOX@ /CUBE-Boxen.

Detaillierte Architektur-Entscheidungsfindung + Vision/Mission kommt zukünftig in das Github Wiki und/oder ins Collective-Context-Forum.

Lizenz

MIT