Metadata-Version: 2.4
Name: xed-cca
Version: 0.0.4
Summary: cBOX@ /Container App-Installation — App-Stack-Manager für LXC-Boxen (Pendant zu xed-ccc Container-Lifecycle). cBOX.at/YOU by XED.dev Tools via Collective Context (CC).
Project-URL: Homepage, https://cca.xed.dev
Project-URL: Repository, https://github.com/XED-dev/CCA
Project-URL: XED /Suite, https://xed.dev
Project-URL: XED /CCC, https://ccc.xed.dev
Project-URL: Issues, https://github.com/XED-dev/CCA/issues
Project-URL: Changelog, https://github.com/XED-dev/CCA/blob/main/CHANGELOG.md
Author-email: Collective Context <code@collective-context.org>
License: MIT
License-File: LICENSE
Keywords: app-installer,cbox,cca,cli,container,ghost,gnome,lxc,miab,proxmox,tui,wordops
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Console :: Curses
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.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.11
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'
Provides-Extra: tui
Requires-Dist: textual>=0.80; extra == 'tui'
Description-Content-Type: text/markdown

# XED /CCA — cBOX@ /Container App-Installation

> **Atomare App-Stack-Installation für LXC-Boxen** — Pendant zu
> [xed-ccc](https://github.com/XED-dev/CCC) (Container-Lifecycle).
>
> Status: **v0.0.1 Skelett** — Stubs mit Plan-Output, Apply-Implementation kommt cycle-für-cycle
> Lizenz: MIT
> Distribution: <https://pypi.org/project/xed-cca/> (geplant: <https://cca.xed.dev>)

---

## Architektur — zwei Tools, klare Trennung

| Tool | Verantwortung | Beispiele |
|---|---|---|
| **`ccc`** | Container-Lifecycle + Rollen-Kompositionen | `ccc create pmDESK` (komponiert: gnome + xrdp + SysOps-User) |
| **`cca`** | Atomare App-Stack-Installation | `cca install gnome`, `cca install ghost`, `cca install miab` |

`ccc`-Rollen rufen intern `cca`-Apps auf. Wer eine maßgeschneiderte Box
will, nutzt `cca` direkt. Wer eine vorgefertigte Rolle will, nutzt `ccc create`.

---

## Schnellstart

```bash
# Variante A — automatisch via firstboot.sh Phase 7 (xed-ccc + xed-cca beide):
bash <(curl -s https://ccc.xed.dev/firstboot.sh)

# Variante B — PyPI direkt:
pipx install xed-cca
```

## Verben (analog `apt`)

```bash
cca list                     # verfügbare Apps mit Status
cca install gnome            # App installieren
cca install ghost --dry-run  # nur Plan zeigen
cca menu                     # interaktive TUI (Stub, Textual kommt später)
cca --version
cca --help
```

## Apps-Roadmap (v0.0.1 Stubs)

| App | Beschreibung | Status |
|---|---|---|
| `gnome` | Vanilla Gnome Desktop (Debian: `gnome-core`, Ubuntu: `vanilla-gnome-desktop`) | Stub |
| `ghost` | Ghost Headless CMS / Blog-Engine (Node + DB + nginx) | Stub |
| `wordops` | LEMP-Stack-Manager (NGINX + PHP-FPM + MariaDB) | Stub |
| `miab` | Mail-in-a-Box (vollständiger Mail-Server-Stack) | Stub |

Geplant für künftige Sessions: `nextcloud`, `gitea`, `xrdp`, `nginx-rp`, weitere.

---

## Lizenz

MIT — siehe [LICENSE](LICENSE).
