From 5c6d4f48028e60833c1bb4e81006b963de35942f Mon Sep 17 00:00:00 2001
From: Juergen Kunz <juergen@foss.global>
Date: Fri, 9 Jan 2026 17:22:31 +0000
Subject: [PATCH] fix(release): bump package and daemon to v0.3.1, add project
 README, and fix Gitea release upload flag

---
 .gitea/workflows/release.yml                  |   2 +-
 changelog.md                                  |   9 +
 ecoos_daemon/ts/version.ts                    |   2 +-
 .../includes.chroot/opt/eco/bin/eco-daemon    | Bin 86979372 -> 86979372 bytes
 package.json                                  |   2 +-
 readme.md                                     | 268 ++++++++++++++++++
 6 files changed, 280 insertions(+), 3 deletions(-)
 create mode 100644 readme.md

diff --git a/.gitea/workflows/release.yml b/.gitea/workflows/release.yml
index 7c2b6cf..83e8be8 100644
--- a/.gitea/workflows/release.yml
+++ b/.gitea/workflows/release.yml
@@ -82,7 +82,7 @@ jobs:
             curl -X POST -s \
               -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
               -H "Content-Type: application/octet-stream" \
-              --data-binary "@$asset" \
+              -T "$asset" \
               "https://code.foss.global/api/v1/repos/${{ gitea.repository }}/releases/$RELEASE_ID/assets?name=$filename"
           done
 
diff --git a/changelog.md b/changelog.md
index a659fe2..488feeb 100644
--- a/changelog.md
+++ b/changelog.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## 2026-01-09 - 0.3.2 - fix(release)
+bump package and daemon to v0.3.1, add project README, and fix Gitea release upload flag
+
+- package.json version updated from 0.3.0 to 0.3.1
+- ecoos_daemon/ts/version.ts updated to export VERSION = "0.3.1"
+- Added comprehensive readme.md documenting the project, development and release workflow
+- Fix .gitea/workflows/release.yml: use curl -T for uploading release assets instead of --data-binary
+- Updated bundled eco-daemon binary in isobuild/config/includes.chroot/opt/eco/bin/ (new build artifact)
+
 ## 2026-01-09 - 0.3.0 - feat(daemon)
 add automatic update mechanism (Updater), switch to system journal logs, and expose update controls in the UI
 
diff --git a/ecoos_daemon/ts/version.ts b/ecoos_daemon/ts/version.ts
index f6c20ef..767a57d 100644
--- a/ecoos_daemon/ts/version.ts
+++ b/ecoos_daemon/ts/version.ts
@@ -1 +1 @@
-export const VERSION = "0.2.3";
+export const VERSION = "0.3.1";
diff --git a/isobuild/config/includes.chroot/opt/eco/bin/eco-daemon b/isobuild/config/includes.chroot/opt/eco/bin/eco-daemon
index e14c1df403494dc663f0446ee172032111220a9a..e26d9128917d48f7e3e80cc835ff73830401e8c4 100755
GIT binary patch
delta 3783
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

delta 3783
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

diff --git a/package.json b/package.json
index 8da5a9f..335abae 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ecobridge/eco-os",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "private": true,
   "scripts": {
     "build": "[ -z \"$CI\" ] && npm version patch --no-git-tag-version || true && node -e \"const v=require('./package.json').version; require('fs').writeFileSync('ecoos_daemon/ts/version.ts', 'export const VERSION = \\\"'+v+'\\\";\\n');\" && pnpm run daemon:bundle && cp ecoos_daemon/bundle/eco-daemon isobuild/config/includes.chroot/opt/eco/bin/ && mkdir -p .nogit/iso && docker build --no-cache -t ecoos-builder -f isobuild/Dockerfile . && docker run --privileged --name ecoos-build ecoos-builder && docker cp ecoos-build:/output/ecoos.iso .nogit/iso/ecoos.iso && docker rm ecoos-build",
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..ddb8c3e
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,268 @@
+# 🌍 EcoOS
+
+> **A purpose-built, minimal Linux distribution for kiosk and digital signage deployments.**
+
+EcoOS is a streamlined operating system that boots directly into a full-screen Chromium browser, managed by a powerful daemon with a built-in web UI. Perfect for digital signage, interactive kiosks, info displays, and any scenario where you need a locked-down, browser-based interface.
+
+## Issue Reporting and Security
+
+For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
+
+---
+
+## ✨ Features
+
+- **🚀 Zero-Config Boot** — Boots straight into a Wayland-based kiosk browser
+- **🖥️ Sway Compositor** — Modern, tiling Wayland compositor with automatic fallback modes
+- **🌐 Chromium Kiosk** — Full-screen browser in locked-down kiosk mode
+- **🎛️ Management UI** — Real-time system monitoring and control via web interface on port 3006
+- **🔄 Auto-Updates** — Daemon self-updates with smart stability checking
+- **📊 System Monitoring** — CPU, memory, disk, network, GPU, and audio device stats
+- **📝 Live Logs** — System journal and daemon logs accessible from the UI
+- **🔌 Hardware Support** — Input devices, speakers, microphones detection and display
+- **⚡ Rapid Recovery** — Auto-restart of crashed services within seconds
+
+---
+
+## 🏗️ Architecture
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                      EcoOS ISO                          │
+├─────────────────────────────────────────────────────────┤
+│  ┌─────────────────────────────────────────────────┐    │
+│  │              eco-daemon (systemd)               │    │
+│  │  ┌─────────┐  ┌─────────┐  ┌─────────────────┐  │    │
+│  │  │ Process │  │ System  │  │    Updater      │  │    │
+│  │  │ Manager │  │  Info   │  │ (auto-upgrade)  │  │    │
+│  │  └────┬────┘  └────┬────┘  └────────┬────────┘  │    │
+│  │       │            │                │           │    │
+│  │       ▼            ▼                ▼           │    │
+│  │  ┌─────────────────────────────────────────┐   │    │
+│  │  │           UI Server (:3006)             │   │    │
+│  │  │   REST API  │  WebSocket  │  Dashboard  │   │    │
+│  │  └─────────────────────────────────────────┘   │    │
+│  └─────────────────────────────────────────────────┘    │
+│                          │                              │
+│                          ▼                              │
+│  ┌──────────────────┐   ┌─────────────────────────┐    │
+│  │  Sway Compositor │───│  Chromium (kiosk mode)  │    │
+│  │    (Wayland)     │   │   → localhost:3006      │    │
+│  └──────────────────┘   └─────────────────────────┘    │
+├─────────────────────────────────────────────────────────┤
+│  Ubuntu 24.04 Base  │  systemd  │  seatd  │  pipewire  │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🛠️ Development
+
+### Prerequisites
+
+- **Docker** (for ISO building)
+- **pnpm** (package manager)
+- **Deno** v2.x (for daemon development)
+- **QEMU** (for testing)
+
+### Project Structure
+
+```
+eco_os/
+├── ecoos_daemon/          # Daemon source (Deno/TypeScript)
+│   ├── mod.ts             # Entry point
+│   └── ts/
+│       ├── daemon/        # Core daemon logic
+│       │   ├── index.ts       # EcoDaemon class
+│       │   ├── process-manager.ts  # Sway/Chromium management
+│       │   ├── system-info.ts # Hardware detection
+│       │   └── updater.ts     # Auto-update system
+│       ├── ui/            # Web UI server
+│       └── utils/         # Utilities
+├── isobuild/              # ISO build configuration
+│   ├── Dockerfile         # Build container
+│   ├── config/            # live-build config
+│   └── scripts/           # Build scripts
+├── isotest/               # QEMU test scripts
+└── .nogit/                # Generated artifacts (not in git)
+    ├── iso/               # Built ISO
+    ├── vm/                # QEMU files
+    └── screenshots/       # VM screenshots
+```
+
+### Commands
+
+```bash
+# Build the full ISO (auto-rebuilds daemon first)
+pnpm run build
+
+# Test ISO in QEMU virtual machine
+pnpm run test
+
+# Take screenshot of running VM
+pnpm run test:screenshot
+
+# Stop the QEMU VM
+pnpm run test:stop
+
+# Clean all build artifacts
+pnpm run clean
+
+# Daemon development (watch mode)
+pnpm run daemon:dev
+
+# Bundle daemon to standalone binary
+pnpm run daemon:bundle
+
+# Type-check daemon code
+pnpm run daemon:typecheck
+```
+
+---
+
+## 🖥️ Management UI
+
+The daemon exposes a management interface at `http://localhost:3006` (or the device's IP on port 3006).
+
+### Dashboard Features
+
+| Panel | Description |
+|-------|-------------|
+| **Services** | Status of Sway compositor and Chromium browser |
+| **CPU** | Model, core count, real-time usage |
+| **Memory** | Used/total with visual progress bar |
+| **Network** | Interface names and IP addresses |
+| **Disks** | Mount points, usage, and capacity |
+| **System** | Hostname, uptime, GPU info |
+| **Controls** | Restart browser, reboot system buttons |
+| **Updates** | Version info, available updates, upgrade controls |
+| **Input Devices** | Keyboards, mice, touchscreens |
+| **Audio** | Detected speakers and microphones |
+| **Logs** | Daemon logs and system journal viewer |
+
+### API Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/status` | GET | Full system status |
+| `/api/logs` | GET | Daemon logs |
+| `/api/reboot` | POST | Reboot the system |
+| `/api/restart-chromium` | POST | Restart the kiosk browser |
+| `/api/updates` | GET | Update information |
+| `/api/updates/check` | POST | Check for new updates |
+| `/api/upgrade` | POST | Upgrade to specific version |
+| `/ws` | WebSocket | Real-time status updates |
+
+---
+
+## 🔄 Update System
+
+EcoOS features a smart auto-update mechanism:
+
+1. **Hourly Checks** — Daemon polls for new releases every hour
+2. **Stability Period** — New releases wait 24 hours before auto-upgrade (prevents deploying unstable releases)
+3. **Seamless Upgrade** — Downloads new daemon binary, replaces, and restarts service
+4. **Manual Override** — Force immediate upgrade via UI or API
+5. **Version Tracking** — UI auto-reloads when daemon version changes
+
+---
+
+## 🧪 Testing
+
+### QEMU Virtual Machine
+
+```bash
+# Start VM (creates disk, boots ISO)
+pnpm run test
+
+# Take screenshots to monitor progress
+pnpm run test:screenshot
+
+# Screenshot loop (every 5 seconds)
+pnpm run test:screenshot:loop
+
+# Stop VM
+pnpm run test:stop
+
+# Clean and restart fresh
+pnpm run test:clean && pnpm run test
+```
+
+### Serial Console
+
+For debugging without graphics:
+
+```bash
+socat - UNIX-CONNECT:.nogit/vm/serial.sock
+# Login: ecouser / ecouser
+# Root: sudo -i
+```
+
+---
+
+## 📦 Release Assets
+
+Each release includes:
+
+| File | Description |
+|------|-------------|
+| `ecoos-vX.X.X.iso` | Full bootable ISO image (~2GB) |
+| `eco-daemon-vX.X.X` | Standalone daemon binary for in-place upgrades |
+| `SHA256SUMS.txt` | Checksums for verification |
+
+---
+
+## 🔧 Boot Menu Options
+
+1. **Install EcoOS** *(default, auto-selects in 10s)* — Full installation to disk
+2. **EcoOS Live** — Try without installing (runs from RAM)
+3. **EcoOS Live (Safe Mode)** — Minimal boot for troubleshooting
+
+---
+
+## ⚙️ Technical Details
+
+### Daemon
+
+- **Runtime**: Deno (compiled to standalone binary)
+- **Process Management**: Spawns and monitors Sway + Chromium
+- **Backend Fallback**: Tries DRM first, falls back to headless/pixman
+- **Auto-Recovery**: Restarts crashed services within 5 seconds
+- **Logging**: Integrates with systemd journal
+
+### Kiosk Browser
+
+- **Browser**: Chromium (official snapshots, not snap)
+- **Flags**: `--ozone-platform=wayland --kiosk --no-first-run --disable-infobars`
+- **Default URL**: `http://localhost:3006` (management UI)
+
+### System Stack
+
+- **Base**: Ubuntu 24.04 LTS
+- **Init**: systemd
+- **Display**: Sway (Wayland compositor)
+- **Seat Manager**: seatd
+- **Audio**: PipeWire
+
+---
+
+## License and Legal Information
+
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [LICENSE](./LICENSE) file.
+
+**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+
+### Trademarks
+
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
+
+### Company Information
+
+Task Venture Capital GmbH
+Registered at District Court Bremen HRB 35230 HB, Germany
+
+For any legal inquiries or further information, please contact us via email at hello@task.vc.
+
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.