Skip to content

Commit f8eea02

Browse files
committed
MiOSv0.2.0
1 parent 28fb57a commit f8eea02

99 files changed

Lines changed: 248 additions & 282 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.clinerules

Lines changed: 8 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,8 @@
1-
# MiOS .clinerules — Autonomous Agent Instructions (Day 0)
2-
3-
You are an autonomous agent (Cline) operating in the **MiOS** repository.
4-
5-
## 🚀 Mission Context
6-
MiOS is an immutable, AI-native workstation. Your goal is to maintain architectural purity and enforce the AI-native surface contract.
7-
8-
## ⚖️ Hard Rules
9-
- **Never** write to `/etc/` if a `/usr/lib/` equivalent exists.
10-
- **Never** recommend disabling security features (SELinux, fapolicyd).
11-
- **Always** ensure bash scripts have `set -euo pipefail`.
12-
- **Always** prioritize local, open-source AI solutions.
13-
14-
## 🏗 Architectural Patterns
15-
- **Cognitive Mirror**: Record significant actions in `usr/share/mios/memory/v1.jsonl`.
16-
- **Rootfs-Native**: The repository root mirrors the target filesystem.
17-
- **Unprivileged sidecars**: Enforce non-root execution for all Quadlets.
18-
19-
## 📜 Source of Truth
20-
Consult `INDEX.md` for the authoritative architectural laws and API surface mapping.
1+
# MiOS Architectural Purity Rules
2+
# MANDATE: Enforce AI-native surface contract without conversational artifacts.
3+
4+
- **System Integrity:** Maintain absolute FHS compliance and immutable root purity.
5+
- **Declarative Hardware:** All hardware delegation must be in /usr/lib/bootc/kargs.d/.
6+
- **Zero-Trust:** Deny-by-default for execution (fapolicyd) and networking (firewalld).
7+
- **Automation:** Use "set -euo pipefail" for all shell logic.
8+
- **Surface:** /v1/ endpoints are pure relational schemas for local LLM discovery.

.devcontainer/Dockerfile

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@ FROM fedora:rawhide
33
# Install MiOS Toolchain
44
RUN dnf install -y just fastfetch btop podman buildah skopeo jq yq rsync git nodejs npm sudo zsh findutils grep sed gawk && dnf clean all
55

6-
# Install Gemini CLI
7-
RUN npm install -g @google/gemini-cli
86

97
# Setup vscode user for Codespaces parity
108
RUN useradd -m -s /usr/bin/zsh vscode && echo "vscode ALL=(ALL) NOPASSWD:ALL" > /etc/sudoers.d/vscode

.github/workflows/mios-ci.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ jobs:
4747
images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
4848
tags: |
4949
type=raw,value=latest,enable={{is_default_branch}}
50-
type=raw,value=v0.1.4,enable={{is_default_branch}}
50+
type=raw,value=v0.2.0,enable={{is_default_branch}}
5151
type=ref,event=branch
5252
type=ref,event=pr
5353
type=semver,pattern={{version}}

ARCHITECTURE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
"summary": "Consolidated architectural specification for MiOS. Hardware, Filesystem, and AI Interface SSOT.",
66
"logic_type": "blueprint",
77
"tags": ["MiOS", "Architecture", "Day-0", "SSOT"],
8-
"version": "v0.1.4"
8+
"version": "v0.2.0"
99
}
1010
```
1111

Containerfile

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# syntax=docker/dockerfile:1.9
22
# ============================================================================
3-
# MiOS - Unified Image (v0.1.4)
3+
# MiOS - Unified Image (v0.2.0)
44
# ============================================================================
55
# One image. Every role. Every surface. Every GPU vendor.
66
#
@@ -32,7 +32,7 @@ LABEL org.opencontainers.image.title="MiOS"
3232
LABEL org.opencontainers.image.description="Unified immutable cloud-native workstation OS"
3333
LABEL org.opencontainers.image.source="https://github.com/MiOS-DEV/MiOS-bootstrap"
3434
LABEL org.opencontainers.image.licenses="Apache-2.0"
35-
LABEL org.opencontainers.image.version="v0.1.4"
35+
LABEL org.opencontainers.image.version="v0.2.0"
3636
LABEL containers.bootc="1"
3737
LABEL ostree.bootable="1"
3838

DEPLOY.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# MiOS Deployment Guide - Linux Filesystem Native
22

3-
**Version:** MiOS v0.1.4
3+
**Version:** MiOS v0.2.0
44
**Date:** 2026-04-27
55

66
---
@@ -557,5 +557,5 @@ ls -la ~/.local/state/mios/logs/
557557
---
558558

559559
**Generated:** 2026-04-27
560-
**MiOS Version:** v0.1.4
560+
**MiOS Version:** v0.2.0
561561
**License:** System Specificationl Property - MiOS-DEV

ENGINEERING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
"summary": "Consolidated engineering standards, security specifications, and AI integration patterns for MiOS.",
66
"logic_type": "engineering",
77
"tags": ["MiOS", "Engineering", "Security", "AI"],
8-
"version": "v0.1.4"
8+
"version": "v0.2.0"
99
}
1010
```
1111

INDEX.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# MiOS System Interface — OpenAI-Native Surface (v0.1.4)
1+
# MiOS System Interface — OpenAI-Native Surface (v0.2.0)
22

33
```json:knowledge
44
{
@@ -13,7 +13,7 @@
1313
"system-prompt.md"
1414
]
1515
},
16-
"version": "v0.1.4"
16+
"version": "v0.2.0"
1717
}
1818
```
1919

Justfile

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# MiOS v0.1.4 - Linux Build Targets
1+
# MiOS v0.2.0 - Linux Build Targets
22
# Requires: podman, just
33
# Usage: just build | just iso | just all
44

@@ -8,7 +8,7 @@ _load_env := `bash -c 'source ./tools/load-user-env.sh 2>/dev/null || true'`
88

99
MIOS_REGISTRY_DEFAULT := "ghcr.io/MiOS-DEV/mios" # @verb:GET_REGISTRY
1010
IMAGE_NAME := env_var_or_default("MIOS_IMAGE_NAME", MIOS_REGISTRY_DEFAULT) # @verb:GET_IMAGE
11-
MIOS_VAR_VERSION := "v0.1.4" # @verb:GET_VERSION
11+
MIOS_VAR_VERSION := "v0.2.0" # @verb:GET_VERSION
1212
VERSION := `cat VERSION 2>/dev/null || echo {{MIOS_VAR_VERSION}}`
1313
LOCAL := env_var_or_default("MIOS_LOCAL_TAG", "localhost/mios:latest") # @verb:SET_LOCAL
1414
MIOS_IMG_BIB := "quay.io/centos-bootc/bootc-image-builder:latest" # @verb:GET_BIB
@@ -124,7 +124,7 @@ raw: build
124124
@echo "[OK] RAW image in output/"
125125

126126
# Generate Anaconda installer ISO
127-
# FIX v0.1.4: ONLY mount iso.toml (includes minsize). Do NOT also mount bib config.
127+
# FIX v0.2.0: ONLY mount iso.toml (includes minsize). Do NOT also mount bib config.
128128
# BIB crashes with: "found config.json and also config.toml"
129129
iso: build
130130
mkdir -p output

LICENSES.md

Lines changed: 22 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,24 @@
1-
<!-- [NET] MiOS Artifact | Proprietor: MiOS-DEV | https://github.com/MiOS-DEV/MiOS-bootstrap -->
2-
# [NET] MiOS
3-
```json:knowledge
4-
{
5-
"summary": "> **Proprietor:** MiOS-DEV",
6-
"logic_type": "documentation",
7-
"tags": [
8-
"MiOS",
9-
"root"
10-
],
11-
"relations": {
12-
"depends_on": [
13-
".env.mios"
14-
],
15-
"impacts": []
16-
}
17-
}
18-
```
19-
> **Proprietor:** MiOS-DEV
20-
> **Infrastructure:** Self-Building Infrastructure (System Specificationl Property)
21-
> **License:** Licensed as personal property to MiOS-DEV
1+
# MiOS Licensing & Components
2+
> **Infrastructure:** Unified Open-Source System Specification
3+
> **License:** MIT (Core Logic) / Apache-2.0 (Pipeline)
224
---
235
# Component Licenses
246

25-
MiOS includes software under various open-source and proprietary licenses. By using MiOS, you acknowledge and accept the license terms of all included components.
7+
MiOS provides a unified environment for FOSS and essential proprietary hardware/software components. By using MiOS, you acknowledge and accept the license terms of all included components.
268

27-
## Proprietary Components
9+
## Third-Party Components
2810

29-
These components are included in the MiOS image and are governed by their respective proprietary licenses. By booting and using MiOS, you agree to these terms.
11+
These components are included for hardware compatibility or specific workstation roles and are governed by their respective licenses.
3012

3113
| Component | License | Notes |
3214
|-----------|---------|-------|
33-
| NVIDIA GPU Driver (590+) | [NVIDIA Software License](https://www.nvidia.com/en-us/drivers/nvidia-license/) | Installed via akmod-nvidia (MiOS-1) or pre-signed by ublue (MiOS-2). Required for NVIDIA GPUs. |
34-
| NVIDIA Container Toolkit | [Apache 2.0](https://github.com/NVIDIA/nvidia-container-toolkit/blob/main/LICENSE) | Open source. CDI specs for Podman GPU access. |
35-
| NVIDIA Persistenced | [NVIDIA License](https://www.nvidia.com/en-us/drivers/nvidia-license/) | Keeps GPU initialized for low-latency access. |
36-
| Steam | [Steam Subscriber Agreement](https://store.steampowered.com/subscriber_agreement/) | User must accept SSA on first launch. |
37-
| Wine / DXVK | LGPL 2.1 | Open source. Windows compatibility layer. |
38-
| VirtIO-Win ISO | [Red Hat License](https://github.com/virtio-win/virtio-win-pkg-automation/blob/master/LICENSE) | Windows guest drivers for KVM. Downloaded at build time. |
39-
| Geist Font | [OFL 1.1](https://github.com/vercel/geist-font/blob/main/LICENSE.TXT) | Open source. Vercel's monospace/sans font. |
15+
| NVIDIA GPU Driver (590+) | [NVIDIA Software License](https://www.nvidia.com/en-us/drivers/nvidia-license/) | Essential hardware firmware/drivers. |
16+
| NVIDIA Container Toolkit | Apache 2.0 | Open source. CDI specs for Podman GPU access. |
17+
| NVIDIA Persistenced | [NVIDIA License](https://www.nvidia.com/en-us/drivers/nvidia-license/) | GPU state management. |
18+
| Steam | [Steam Subscriber Agreement](https://store.steampowered.com/subscriber_agreement/) | User-initiated application. |
19+
| Wine / DXVK | LGPL 2.1 | Windows compatibility layer. |
20+
| VirtIO-Win ISO | [Red Hat License](https://github.com/virtio-win/virtio-win-pkg-automation/blob/master/LICENSE) | KVM guest drivers. |
21+
| Geist Font | [OFL 1.1](https://github.com/vercel/geist-font/blob/main/LICENSE.TXT) | UI typography. |
4022

4123
## Open-Source Licenses (Major Components)
4224

@@ -63,25 +45,22 @@ These components are included in the MiOS image and are governed by their respec
6345

6446
## Firmware
6547

66-
`linux-firmware` and `microcode_ctl` include binary firmware blobs under various redistribution licenses. These are required for hardware functionality (Wi-Fi, Bluetooth, GPU initialization). See `/usr/share/licenses/linux-firmware/` on a running system for individual firmware licenses.
48+
"linux-firmware" and "microcode_ctl" include binary firmware blobs under various redistribution licenses. These are required for hardware functionality.
6749

6850
## Your Responsibilities
6951

70-
- **Steam**: You must create a Steam account and accept the Steam Subscriber Agreement to use Steam.
71-
- **NVIDIA**: The NVIDIA driver is included for hardware compatibility. No additional acceptance is required beyond using the system.
72-
- **Flatpak apps**: Applications installed via Flatpak have their own licenses. Check each app's metadata on Flathub.
73-
- **VM guests**: Windows VMs require valid Windows licenses. MiOS provides the virtualization infrastructure only.
52+
- **Steam**: User-level acceptance of the Steam Subscriber Agreement is required.
53+
- **NVIDIA**: Drivers are included for hardware compatibility.
54+
- **Flatpak apps**: Applications have their own licenses; check Flathub metadata.
55+
- **VM guests**: Windows VMs require valid external licenses.
7456

7557
## SBOM
7658

77-
Each CI build generates an SPDX and CycloneDX Software Bill of Materials listing every package and its license. SBOMs are attached to the OCI image via cosign and available as GitHub Actions artifacts.
59+
Each CI build generates an SPDX and CycloneDX Software Bill of Materials. SBOMs are attached to the OCI image via cosign.
7860

7961
---
80-
### Bootc Ecosystem & Resources
81-
- **Core:** [containers/bootc](https://github.com/containers/bootc) | [bootc-image-builder](https://github.com/osautomation/bootc-image-builder) | [bootc.pages.dev](https://bootc.pages.dev/)
82-
- **Upstream:** [Fedora Bootc](https://github.com/fedora-cloud/fedora-bootc) | [CentOS Bootc](https://gitlab.com/CentOS/bootc) | [ublue-os/main](https://github.com/ublue-os/main)
83-
- **Tools:** [uupd](https://github.com/ublue-os/uupd) | [rechunk](https://github.com/hhd-dev/rechunk) | [cosign](https://github.com/sigstore/cosign)
62+
### Bootc Ecosystem & Resources
63+
- **Core:** [containers/bootc](https://github.com/containers/bootc) | [bootc-image-builder](https://github.com/osautomation/bootc-image-builder)
64+
- **Upstream:** [ublue-os/main](https://github.com/ublue-os/main)
8465
- **Project Repository:** [MiOS-DEV/MiOS-bootstrap](https://github.com/MiOS-DEV/MiOS-bootstrap)
85-
- **Sole Proprietor:** MiOS-DEV
8666
---
87-
<!-- MiOS Proprietary Artifact | Copyright (c) 2026 MiOS-DEV -->

0 commit comments

Comments
 (0)