cell0-os 1.1.4 → 1.1.5

package/README.md

@@ -1,247 +1,86 @@
-# 🧬 Cell0-OS
+# Cell 0 OS — npm Global Install
 
-<p align="center">
-  <strong>The Sovereign Edge Operating System</strong><br>
-  <em>Self-governing. Self-improving. Post-quantum secure.</em>
-</p>
+OpenClaw-style npm installation for Cell 0 OS — the Sovereign Edge Operating System.
 
-<p align="center">
-  <img src="https://img.shields.io/badge/version-1.1.3-blue.svg" alt="Version">
-  <img src="https://img.shields.io/badge/license-GPL%20v3.0-green.svg" alt="License">
-  <img src="https://img.shields.io/badge/tests-passing-brightgreen.svg" alt="Tests">
-  <img src="https://img.shields.io/badge/docker-ready-2496ed.svg?logo=docker" alt="Docker">
-  <img src="https://img.shields.io/badge/kubernetes-ready-326CE5.svg?logo=kubernetes" alt="Kubernetes">
-</p>
-
-<p align="center">
-  <a href="https://kulluai.com">Website</a> •
-  <a href="#installation">Install</a> •
-  <a href="#features">Features</a> •
-  <a href="#channels">Channels</a> •
-  <a href="#security">Security</a> •
-  <a href="#contributing">Contribute</a>
-</p>
-
----
-
-## 🚀 Quick Start
-
-### npm (Recommended)
+## Quick Start
 
 ```bash
+# Install Node.js >= 22, then:
 npm install -g cell0-os@latest
-cell0 onboard --install-daemon
-cell0 gateway --port 18800
-```
-
-Visit http://localhost:18800 to access your Cell0 dashboard.
-
-### Docker Compose
-
-```bash
-git clone https://github.com/YigremTamiru/cell0-os.git
-cd cell0-os
-docker compose up -d
-```
-
-### Kubernetes
-
-```bash
-helm repo add cell0 https://charts.kulluai.com
-helm install cell0 cell0/cell0-os \
-  --namespace cell0-system \
-  --create-namespace
-```
-
----
-
-## ✨ What's New in v1.1.3
-
-### 🛡️ Security Fixes
-- ✅ **SQL Injection Prevention** - All queries parameterized
-- ✅ **Pickle RCE Fix** - Replaced with marshal+JSON serialization
-- ✅ **Path Traversal Fix** - Secure Path.resolve() validation
-- ✅ **npm Package Hardening** - Secure global installation
-
-### 📱 6 Channel Drivers
-- ✅ **Telegram** - Native bot API
-- ✅ **Discord** - Gateway integration
-- ✅ **WhatsApp Web** - QR-based pairing
-- ✅ **Slack** - Socket Mode + Events API
-- ✅ **Signal** - signal-cli REST bridge
-- ✅ **iMessage** - BlueBubbles integration
-
-### 🏭 Production Ready
-- ✅ **Kubernetes** - Full manifests + Helm charts
-- ✅ **Monitoring** - Prometheus + Grafana foundation
-- ✅ **API Auth** - JWT, API keys, OAuth2, mTLS
-- ✅ **Website** - https://kulluai.com live
-
----
-
-## 🔐 Security Architecture
-
-### Post-Quantum Cryptography (12 Layers)
-
-| Layer | Systems | Status |
-|-------|---------|--------|
-| **Classical** | AES-256-GCM, ChaCha20-Poly1305, SHA3-256/512 | ✅ |
-| **Modern** | Ed25519, X25519, BLS12-381 | ✅ |
-| **Post-Quantum** | CRYSTALS-Kyber-1024, CRYSTALS-Dilithium-5 | ✅ |
-| **Signatures** | SPHINCS+, FALCON-1024, XMSS | ✅ |
-| **Quantum** | BB84 QKD ready | ✅ |
-| **ZKP** | zk-STARK (transparent, post-quantum) | ✅ |
-
-### Sovereign Security Model
 
-- **Default-deny architecture** — Nothing runs without authorization
-- **Allowlist-only access** — Only your numbers: +905488899628, +905338224165
-- **12-layer cryptographic lock** — Quantum-resistant by design
-- **Local-first** — Your data never leaves your machine
-- **Capability-based security** — Fine-grained token access
-
----
-
-## 📱 Supported Channels
-
-| Channel | Mode | Features |
-|---------|------|----------|
-| Telegram | Native | Bots, groups, media |
-| Discord | Gateway | DMs, servers, threads |
-| WhatsApp | Web QR | QR pairing, no phone needed |
-| Slack | Socket+Events | Blocks, threads, files |
-| Signal | Bridge | Encrypted, groups |
-| iMessage | BlueBubbles | macOS integration |
+# Onboard and install daemon (macOS launchd / Linux systemd)
+cell0 onboard --install-daemon
 
-Enable channels:
-```bash
-CELL0_ENABLE_TELEGRAM=true
-CELL0_ENABLE_DISCORD=true
-CELL0_ENABLE_WHATSAPP=true
-CELL0_ENABLE_SLACK=true
-CELL0_ENABLE_SIGNAL=true
-CELL0_ENABLE_IMESSAGE=true
+# Or run gateway in foreground
+cell0 gateway --port 18800 --verbose
 ```
 
----
-
-## 🖥️ Installation Experience
+## Commands
 
-### Interactive TUI
+| Command | Description |
+|---------|-------------|
+| `cell0 onboard [--install-daemon]` | Run onboarding wizard |
+| `cell0 gateway [--port 18800]` | Run gateway in foreground |
+| `cell0 status` | Check system status |
+| `cell0 start` | Start Cell 0 daemon |
+| `cell0 stop` | Stop Cell 0 daemon |
+| `cell0 configure` | Run configuration wizard |
+| `cell0 doctor` | Diagnose system issues |
+| `cell0 logs [--follow]` | View system logs |
+| `cell0 daemon <install\|uninstall\|status\|restart>` | Manage background daemon |
+| `cell0 message send --message "..."` | Send a message |
+| `cell0 agent --message "..."` | Talk to the assistant |
+| `cell0 chat` | Start interactive chat |
 
-Arrow-key navigation with questionary:
+## How It Works
 
-```bash
-$ cell0 onboard
-
-? Select LLM Provider: (Use arrow keys)
-❯ Moonshot (Kimi) 
-  OpenAI (GPT-4) 
-  Anthropic (Claude) 
-  Ollama (Local) 
-
-? Select Channels: (Press <space> to select)
-❯◉ Telegram
- ◉ Discord
- ◉ WhatsApp Web
- ◉ Slack
-```
+1. The `cell0` npm binary checks if Cell 0 is installed
+2. If not, it downloads and runs `https://kulluai.com/install.sh`
+3. Then it delegates all commands to the Python-based `cell0ctl` CLI
 
-### One-Line Install
+## Requirements
 
-```bash
-curl -fsSL https://kulluai.com/install.sh | bash
-```
+- **Node.js**: >= 22 (for the npm wrapper)
+- **Python**: >= 3.10 (for Cell 0 runtime)
+- **Git**: For cloning the repository
+- **bash**: For running the installer
 
----
+## Platform Support
 
-## 🏗️ Architecture
+- **macOS**: Uses `launchd` for daemon management
+- **Linux**: Uses `systemd --user` for daemon management
 
-### Core Components
+## First Run
 
-```
-┌─────────────────────────────────────────┐
-│           Cell0-OS v1.1.3               │
-├─────────────────────────────────────────┤
-│  Channels  │  Engine   │  Security      │
-│  ──────────┼───────────┼──────────────  │
-│  Telegram  │  MCIC     │  12-Layer Crypto│
-│  Discord   │  Kernel   │  Post-Quantum  │
-│  WhatsApp  │  COL      │  Sovereign     │
-│  Slack     │  Orch     │  Zero-Trust    │
-│  Signal    │           │                │
-│  iMessage  │           │                │
-└─────────────────────────────────────────┘
-```
+On first execution, Cell 0 will:
+1. Clone the repository to `~/cell0`
+2. Create a Python virtual environment at `~/.cell0/venv`
+3. Install all dependencies
+4. Run the configuration wizard
 
-### Kubernetes Deployment
-
-```yaml
-# Production-ready with HPA, PDB, backups
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: cell0-os
-spec:
-  replicas: 5
-  strategy:
-    rollingUpdate:
-      maxSurge: 25%
-      maxUnavailable: 10%
-```
+## Environment Variables
 
----
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `CELL0_HOME` | Installation directory | `~/cell0` |
+| `CELL0_STATE_DIR` | State/config directory | `~/.cell0` |
+| `CELL0_VENV` | Python virtualenv path | `~/.cell0/venv` |
+| `CELL0_BIN_DIR` | CLI binary location | `~/.local/bin` |
 
-## 📊 Monitoring & Observability
-
-- **Prometheus** metrics at `/metrics`
-- **Grafana** dashboards pre-configured
-- **Health checks** at `/api/health`
-- **Structured logging** with JSON format
-- **Distributed tracing** ready
-
----
-
-## 🛠️ Development
+## Development
 
 ```bash
-# Clone
+# Clone the repo
 git clone https://github.com/YigremTamiru/cell0-os.git
 cd cell0-os
 
-# Setup
-python3 -m venv venv
-source venv/bin/activate
-pip install -r requirements.txt
+# Link for local development
+npm link
 
-# Run
-cell0 gateway --port 18800 --verbose
+# Now you can test 'cell0' command locally
+cell0 status
 ```
 
----
-
-## 📚 Documentation
-
-- [Installation Guide](INSTALLATION_GUIDE.md)
-- [API Reference](docs/API_REFERENCE.md)
-- [Security Audit](SECURITY_AUDIT_REPORT.md)
-- [v1.2.0 Roadmap](ROADMAP_v1.2.0.md)
-
----
-
-## 🤝 Contributing
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
----
-
-## 📄 License
-
-GPL v3.0 — See [LICENSE](LICENSE)
-
----
+## License
 
-<p align="center">
-  <strong>The glass has melted. The water is warm.</strong><br>
-  <em>♾️🛡️💫</em>
-</p>
+GPL-3.0-only