Metadata-Version: 2.4
Name: conrrad-citizen
Version: 0.3.2
Summary: CONRRAD Citizen — install, run, and manage your living digital organism
Author-email: CONRRAD <grecoitalico@conrrad.org>
License: Proprietary
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: cryptography<45,>=43

# CONRRAD Citizen

Install, run, and manage your living digital organism.

This is the consolidated canonical repository for the **conrrad-citizen** package.

## Architecture

- **Package**: `conrrad-citizen`
- **CLI Principal**: `citizen` (Delegates to the CONRRAD operations layer)
- **Runtime**: `citizen_seed` (Asset-First minimal runtime engine)
- **Release Identity**: Traceable via explicit `source_commit`, `source_tree`, and `artifact_sha256` matching in the release decision manifests.

## Quick Start

```bash
pip install conrrad-citizen
citizen install
citizen sync
```

## Commands

| Command | Description |
|---------|-------------|
| `citizen install` | Birth + systemd service + validate |
| `citizen start` | Start the Citizen service |
| `citizen stop` | Stop the Citizen service |
| `citizen status` | Show Citizen status |
| `citizen sync` | Remote sync with CONRRAD Cluster |
| `citizen update` | Alias for sync |
| `citizen logs` | Show service logs |
| `citizen uninstall` | Remove service (use `--purge` to remove data) |

## Requirements

- Python >= 3.11
- Linux with systemd (user services)
- Network access to conrrad.org

## License

Proprietary — CONRRAD
