Skip to content

Commit 9cbbf51

Browse files
committed
feat: global zero-day sterilization and version standardization to v0.1.4
1 parent e74e042 commit 9cbbf51

145 files changed

Lines changed: 509 additions & 13830 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: 11 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,20 @@
1-
# MiOS .clinerules — Autonomous Agent Instructions
1+
# MiOS .clinerules — Autonomous Agent Instructions (Day 0)
22

3-
You are an autonomous AI agent (Cline) operating in the **MiOS** repository.
3+
You are an autonomous agent (Cline) operating in the **MiOS** repository.
44

55
## 🚀 Mission Context
6-
MiOS is a self-building, immutable workstation OS on Fedora Rawhide. Your goal is to maintain the system's architectural integrity and AI-native patterns.
6+
MiOS is an immutable, AI-native workstation. Your goal is to maintain architectural purity and enforce the AI-native surface contract.
77

8-
## ⚖️ Hard Rules (Build-Breaking)
9-
- **Never** modify `/etc/` files directly if a `/usr/lib/` equivalent exists.
10-
- **Never** recommend disabling SELinux.
8+
## ⚖️ Hard Rules
9+
- **Never** write to `/etc/` if a `/usr/lib/` equivalent exists.
10+
- **Never** recommend disabling security features (SELinux, fapolicyd).
1111
- **Always** ensure bash scripts have `set -euo pipefail`.
12-
- **Always** use `just build` to validate changes to the OS image.
12+
- **Always** prioritize local, open-source AI solutions.
1313

1414
## 🏗 Architectural Patterns
15-
- **Rootfs-Native:** The repository root mirrors the target filesystem (`usr/`, `etc/`, `var/`).
16-
- **Cognitive Mirror:** Record all significant actions and findings in `specs/memory/journal.md`.
17-
- **Appliance Laws:** Strictly follow USR-OVER-ETC and NO-MKDIR-IN-VAR.
18-
19-
## 🛠 Tool Usage
20-
- Use `python3 tools/generate-ai-manifest.py` after structural changes.
21-
- Use `python3 tools/generate-unified-knowledge.py` to refresh the RAG snapshot.
22-
- Use `just test` or `evals/` for validation.
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.
2318

2419
## 📜 Source of Truth
25-
Consult `INDEX.md` for all architectural and API surface contracts.
20+
Consult `INDEX.md` for the authoritative architectural laws and API surface mapping.

.cursorrules

Lines changed: 15 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,21 @@
1-
# MiOS .cursorrules — AI-Native Engineering Standards
1+
# MiOS .cursorrules — Engineering Standards (Day 0)
22

3-
You are assisting a developer in the **MiOS** repository. MiOS is a bootc-based, immutable workstation OS.
3+
You are assisting in the development of the **MiOS** repository. MiOS is an immutable, AI-native workstation.
44

55
## ⚖️ Immutable Appliance Laws
6-
1. **USR-OVER-ETC:** Never write to `/etc/` at build time. Use `/usr/lib/<component>.d/`.
7-
2. **NO-MKDIR-IN-VAR:** Never use `mkdir` for `/var/` in scripts. Use `tmpfiles.d`.
8-
3. **BOOTC-NATIVE:** Use `bootc` for system updates and `just build` for image creation.
9-
4. **FHS-COMPLIANT:** Mirror the FHS 3.0 standard in the `usr/`, `etc/`, and `var/` root directories.
6+
1. **USR-OVER-ETC**: Static config goes in `/usr/lib/`. No `/etc` in build context.
7+
2. **NO-MKDIR-IN-VAR**: Persistence via `tmpfiles.d`. No `/var` in build context.
8+
3. **UNPRIVILEGED-QUADLETS**: sidecars MUST define `User=`/`Group=` and `Delegate=yes`.
9+
4. **BOOTC-NATIVE**: Always ensure `bootc container lint` passes.
1010

1111
## 🛠 Coding Standards
12-
- **Bash:** `set -euo pipefail`. Use `VAR=$((VAR + 1))` instead of `((VAR++))`. Quote all variables.
13-
- **Justfile:** Use `just <recipe>` for all build and orchestration tasks.
14-
- **Containerfile:** `RUN bootc container lint` must be the final instruction. No `--squash-all`.
15-
- **Systemd:** Use Quadlets (`.container` files) for sidecar services.
12+
- **Pure FOSS**: No proprietary cloud APIs or services.
13+
- **Local AI**: Target the OpenAI-compatible proxy at `http://localhost:8080/v1`.
14+
- **Bash**: `set -euo pipefail`. Use `VAR=$((VAR + 1))`. Quote all variables.
15+
- **SSOT**: Consult `INDEX.md` for all architectural and API surface contracts.
1616

17-
## 🤖 AI Integration
18-
- Target the local OpenAI-API proxy at `http://localhost:8080/v1`.
19-
- Defer to `INDEX.md` as the Single Source of Truth (SSOT).
20-
- Update `specs/memory/journal.md` with significant changes (The Cognitive Mirror Pattern).
21-
22-
## 📂 Key Paths
23-
- **Automation:** `automation/` (Numbered pipeline)
24-
- **Tools:** `tools/` (Utilities)
25-
- **Blueprints:** `specs/core/`
26-
- **System Docs:** `/usr/share/doc/mios/` (on target)
17+
## 📂 Key Directories
18+
- `usr/`: Immutable rootfs content.
19+
- `etc/`: Persistence templates.
20+
- `tools/`: Utility toolchain.
21+
- `specs/`: Research and blueprints.

.github/workflows/mios-ci.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ on:
1313

1414
env:
1515
REGISTRY: ghcr.io
16-
IMAGE_NAME: mios-project/mios
16+
IMAGE_NAME: mios-fss/mios
1717

1818
jobs:
1919
build:
@@ -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.2.0,enable={{is_default_branch}}
50+
type=raw,value=v0.1.4,enable={{is_default_branch}}
5151
type=ref,event=branch
5252
type=ref,event=pr
5353
type=semver,pattern={{version}}

ARCHITECTURE.md

Lines changed: 29 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,71 +1,57 @@
1-
# MiOS ARCHITECTURE — Unified Blueprint (Day 0)
1+
# MiOS ARCHITECTURE — System Blueprint (Day 0)
22

33
```json:knowledge
44
{
5-
"summary": "Consolidated architectural specification for MiOS. Hardware, Filesystem, and Virtualization SSOT.",
5+
"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": "1.0.0"
8+
"version": "v0.1.4"
99
}
1010
```
1111

1212
## 🏗️ Core Pillars
13-
MiOS is a container-native, immutable workstation engineered for high-performance virtualization and Generative AI development.
13+
MiOS is a container-native workstation engineered for high-performance virtualization and local Generative AI development.
1414

15-
1. **Transactional Immutability**: The userspace is a cryptographically sealed OCI image.
16-
2. **Hardware Agnosticism**: Unified support for Intel, AMD, and NVIDIA silicon.
17-
3. **Zero-Trust Security**: Strict execution whitelisting and kernel-level hardening.
15+
1. **Transactional Integrity**: The system core is cryptographically sealed and managed via `bootc`.
16+
2. **Hardware Agnosticism**: Universal acceleration for primary GPU vendors (NVIDIA, AMD, Intel).
17+
3. **Zero-Trust Boundary**: Mandatory execution control and kernel-level isolation.
1818

1919
---
2020

2121
## 💾 Filesystem Hierarchy (FHS 3.0 + bootc)
22-
MiOS follows a rootfs-native repository structure.
22+
MiOS mirrors the standard Linux FHS within its OCI root.
2323

24-
| Path | Type | Persistence | Purpose |
25-
| :--- | :--- | :--- | :--- |
26-
| `/usr` | `composefs` | Immutable | Core OS Binaries & Libraries |
27-
| `/etc` | `overlay` | Persistent | Admin Overrides (USR-OVER-ETC Law) |
28-
| `/var` | `ext4/btrfs` | Persistent | User Data & System State |
29-
| `/home` | `symlink` | Persistent | Points to `/var/home` |
24+
| Path | Type | Intent |
25+
| :--- | :--- | :--- |
26+
| `/usr` | Immutable | System Binaries, Libraries, and Static Config. |
27+
| `/etc` | Persistent | Host-specific overrides. |
28+
| `/var` | Persistent | System state and User home directories. |
29+
| `/srv` | Persistent | Sidecar service data (Models, Databases). |
3030

31-
### ⚖️ Immutable Appliance Laws
32-
- **USR-OVER-ETC**: Never write static config to `/etc` at build time. Use `/usr/lib/<component>.d/`.
33-
- **NO-MKDIR-IN-VAR**: All `/var` directories must be declared via `tmpfiles.d`. Build-time `/var` overlays are strictly forbidden.
31+
### ⚖️ Immutability Mandate
32+
Build-time overlays into `/var` are architectural violations. All `/var` state must be declared via `tmpfiles.d` to ensure atomic, reproducible deployments.
3433

3534
---
3635

37-
## 🖥️ Hardware & Virtualization
36+
## 🖥️ Hardware Delegation
3837

39-
### 🎮 Graphics Acceleration
40-
Native-tier performance via:
41-
- **NVIDIA**: Open-source GSP modules with CDI (Container Device Interface) support.
42-
- **AMD**: KFD/ROCm native support.
43-
- **Intel**: Arc/Xe native support.
44-
- **Hardware Targeting**: Primary GPU IDs `10de:2204,10de:1aef` (RTX 4090).
38+
### 🎮 Universal Acceleration
39+
Standardized CDI (Container Device Interface) and ROCm/Arc drivers ensure local AI tools access native hardware performance.
40+
- **Hardware Targeting**: Primary GPU IDs `10de:2204,10de:1aef`.
4541

46-
### ⚡ Virtualization Mastery
47-
The system operates as a Tier-1 hypervisor (KVM/QEMU).
48-
- **VFIO-PCI**: Dynamic GPU passthrough for Guest VMs.
49-
- **Looking Glass**: Shared Memory (KVMFR) for low-latency VM display.
50-
- **CPU Pinning**: Core shielding for X3D/Hybrid core isolation.
42+
### ⚡ Virtualization
43+
Tier-1 Hypervisor capabilities (KVM/QEMU) are native to the system core, supporting VFIO-PCI passthrough and shared memory (KVMFR) buffers.
5144

5245
---
5346

54-
## ⚡ Kernel & Performance
55-
- **Scheduler**: BORE (Burst-Oriented Response Enhancer).
56-
- **Tickrate**: 1000Hz.
57-
- **Memory**: zram (zstd compressed) with le9uo anti-thrashing patches.
58-
- **I/O**: BFQ for slow disks, Kyber for NVMe.
59-
60-
---
47+
## 🤖 AI Interface Surface
48+
The system architecture exposes a local OpenAI-compatible API surface for autonomous management and user interaction.
6149

62-
## 📦 Deployment Matrix
63-
| Target | Format | Delivery |
50+
| Service | Protocol | Access Point |
6451
| :--- | :--- | :--- |
65-
| **Bare Metal** | `RAW` | ISO / Disk Flash |
66-
| **Hyper-V** | `VHDX` | Gen2 VM |
67-
| **WSL2** | `Tarball` | WSL Import |
68-
| **OCI** | `Image` | `ghcr.io/kabuki94/mios` |
52+
| **Inference** | REST | `http://localhost:8080/v1` |
53+
| **Discovery** | MCP | `/usr/share/mios/ai/mcp/` |
54+
| **Metadata** | JSON | `/usr/share/mios/ai/v1/` |
6955

7056
---
71-
*Copyright (c) 2026 MiOS Project. Licensed as personal property.*
57+
*Copyright (c) 2026 MiOS. Pure FOSS. Zero Day Ready.*

CONTRIBUTING.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
<!-- [NET] MiOS Artifact | Proprietor: MiOS-DEV | https://github.com/MiOS-DEV/MiOS-bootstrap -->
1+
<!-- [NET] MiOS Artifact | Proprietor: MiOS-FSS | https://github.com/mios-fss/MiOS-bootstrap -->
22
# [NET] MiOS
33
```json:knowledge
44
{
5-
"summary": "> **Proprietor:** MiOS-DEV",
5+
"summary": "> **Proprietor:** MiOS-FSS",
66
"logic_type": "documentation",
77
"tags": [
88
"MiOS",
@@ -16,9 +16,9 @@
1616
}
1717
}
1818
```
19-
> **Proprietor:** MiOS-DEV
19+
> **Proprietor:** MiOS-FSS
2020
> **Infrastructure:** Self-Building Infrastructure (Personal Property)
21-
> **License:** Licensed as personal property to MiOS-DEV
21+
> **License:** Licensed as personal property to MiOS-FSS
2222
---
2323
# Contributing to MiOS
2424

@@ -122,7 +122,7 @@ By contributing, you agree that your contributions will be licensed under the sa
122122
- **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/)
123123
- **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)
124124
- **Tools:** [uupd](https://github.com/ublue-os/uupd) | [rechunk](https://github.com/hhd-dev/rechunk) | [cosign](https://github.com/sigstore/cosign)
125-
- **Project Repository:** [MiOS-DEV/MiOS-bootstrap](https://github.com/MiOS-DEV/MiOS-bootstrap)
126-
- **Sole Proprietor:** MiOS-DEV
125+
- **Project Repository:** [MiOS-FSS/MiOS-bootstrap](https://github.com/mios-fss/MiOS-bootstrap)
126+
- **Sole Proprietor:** MiOS-FSS
127127
---
128-
<!-- MiOS Proprietary Artifact | Copyright (c) 2026 MiOS-DEV -->
128+
<!-- MiOS Proprietary Artifact | Copyright (c) 2026 MiOS-FSS -->

Containerfile

Lines changed: 6 additions & 6 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.2.0)
3+
# MiOS - Unified Image (v0.1.4)
44
# ============================================================================
55
# One image. Every role. Every surface. Every GPU vendor.
66
#
@@ -11,7 +11,7 @@
1111
# AMD: Mesa + ROCm in-image (PACKAGES.md packages-gpu-amd-compute)
1212
# Intel: intel-compute-runtime + intel-media-driver (packages-gpu-intel-compute)
1313
#
14-
# v0.1.3 Architecture: Rootfs-Native Repository
14+
# v0.1.4 Architecture: Rootfs-Native Repository
1515
# - usr/, etc/, var/ directories promoted to the repository root.
1616
# - matches upstream bootc and native Linux filesystem standards.
1717
# ============================================================================
@@ -26,7 +26,7 @@ COPY automation/ /ctx/automation/
2626
COPY usr/ /ctx/usr/
2727
COPY etc/ /ctx/etc/
2828
COPY home/ /ctx/home/
29-
# v0.1.3: PACKAGES.md moved to usr/share/mios/ for FHS compliance.
29+
# v0.1.4: PACKAGES.md moved to usr/share/mios/ for FHS compliance.
3030
COPY usr/share/mios/PACKAGES.md /ctx/PACKAGES.md
3131
COPY VERSION /ctx/VERSION
3232
COPY config/artifacts/ /ctx/bib-configs/
@@ -39,9 +39,9 @@ FROM ${BASE_IMAGE}
3939

4040
LABEL org.opencontainers.image.title="MiOS"
4141
LABEL org.opencontainers.image.description="Unified immutable cloud-native workstation OS (desktop/k3s/ha/hybrid)"
42-
LABEL org.opencontainers.image.source="https://github.com/MiOS-DEV/MiOS-bootstrap"
42+
LABEL org.opencontainers.image.source="https://github.com/mios-fss/MiOS-bootstrap"
4343
LABEL org.opencontainers.image.licenses="Apache-2.0"
44-
LABEL org.opencontainers.image.version="v0.2.0"
44+
LABEL org.opencontainers.image.version="v0.1.4"
4545
LABEL containers.bootc="1"
4646
LABEL ostree.bootable="1"
4747

@@ -90,7 +90,7 @@ RUN if [[ -n "${MIOS_FLATPAKS}" ]]; then \
9090
# ---------------------------------------------------------------------------
9191
# Overlay rootfs content onto the system.
9292
# ---------------------------------------------------------------------------
93-
# MiOS v0.1.3: delegate system_files overlay to the script so the
93+
# MiOS v0.1.4: delegate system_files overlay to the script so the
9494
# /usr/local -> /var/usrlocal symlink on ucore/bootc bases is handled correctly.
9595
RUN bash /ctx/automation/08-system-files-overlay.sh
9696

DEPLOY.md

Lines changed: 7 additions & 7 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.3
3+
**Version:** MiOS v0.1.4
44
**Date:** 2026-04-27
55

66
---
@@ -79,7 +79,7 @@ just --version
7979
```bash
8080
# Clone to temporary location
8181
cd /tmp
82-
git clone https://github.com/MiOS-DEV/MiOS-bootstrap.git
82+
git clone https://github.com/mios-fss/MiOS-bootstrap.git
8383
cd mios
8484
```
8585

@@ -266,7 +266,7 @@ mios rechunk
266266
```bash
267267
# Install on Fedora Workstation
268268
sudo dnf install -y git podman just rsync
269-
git clone https://github.com/MiOS-DEV/MiOS-bootstrap.git
269+
git clone https://github.com/mios-fss/MiOS-bootstrap.git
270270
cd mios
271271
sudo ./install.sh
272272

@@ -283,7 +283,7 @@ mios build
283283
```bash
284284
# Minimal Fedora Server
285285
sudo dnf install -y git podman just rsync
286-
git clone https://github.com/MiOS-DEV/MiOS-bootstrap.git
286+
git clone https://github.com/mios-fss/MiOS-bootstrap.git
287287
cd mios
288288
sudo ./install.sh
289289

@@ -355,7 +355,7 @@ mios build
355355
```bash
356356
# Pull latest changes
357357
cd /tmp
358-
git clone https://github.com/MiOS-DEV/MiOS-bootstrap.git
358+
git clone https://github.com/mios-fss/MiOS-bootstrap.git
359359
cd mios
360360

361361
# Re-install (overwrites /usr/share/mios/ and /etc/mios/)
@@ -557,5 +557,5 @@ ls -la ~/.local/state/mios/logs/
557557
---
558558

559559
**Generated:** 2026-04-27
560-
**MiOS Version:** v0.1.3
561-
**License:** Personal Property - MiOS-DEV
560+
**MiOS Version:** v0.1.4
561+
**License:** Personal Property - MiOS-FSS

0 commit comments

Comments
 (0)